isa/mutter
1
0
Fork 0
mirror of https://github.com/brl/mutter.git synced 2024-12-26 21:02:14 +00:00
Code Issues Packages Projects Releases Wiki Activity
4691878a76
mutter/doc/cookbook/Makefile.am

184 lines
6.1 KiB
Makefile
Raw Normal View History

build: Update the remote publish path for the cookbook
2010-09-21 11:02:41 +00:00
include $(top_srcdir)/build/autotools/Makefile.am.silent
cookbook: Add example code The cookbook should also include fully functional code examples. We can even XInclude them into the docbook XML itself. The examples should be built with the coobook, so that we can always make sure they are up to date.
2010-07-18 09:53:06 +00:00
SUBDIRS = examples
cookbook: Split the cookbook chapters Use separate files, to avoid making the XML too big and uneditable. This breaks the PDF build.
2010-07-01 10:29:46 +00:00
NULL =
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
HTML_DIR = $(datadir)/gtk-doc/html
TARGET_DIR = $(HTML_DIR)/clutter-cookbook
cookbook: Split the cookbook chapters Use separate files, to avoid making the XML too big and uneditable. This breaks the PDF build.
2010-07-01 10:29:46 +00:00
XML_FILES = \
build: Fix distcheck in the cookbook Someday, somebody will have to explain to me how not touching anything for a whole release cycle ends up breaking the build. Adding the top_srcdir/doc/cookbook path to the includes fixes the distcheck.
2012-10-17 08:37:50 +00:00
$(top_srcdir)/doc/cookbook/actors.xml \
$(top_srcdir)/doc/cookbook/animations.xml \
$(top_srcdir)/doc/cookbook/events.xml \
$(top_srcdir)/doc/cookbook/introduction.xml \
$(top_srcdir)/doc/cookbook/text.xml \
$(top_srcdir)/doc/cookbook/textures.xml \
$(top_srcdir)/doc/cookbook/layouts.xml \
$(top_srcdir)/doc/cookbook/script.xml \
$(top_srcdir)/doc/cookbook/effects.xml \
cookbook: Split the cookbook chapters Use separate files, to avoid making the XML too big and uneditable. This breaks the PDF build.
2010-07-01 10:29:46 +00:00
$(NULL)
cookbook: Clean up build Create two HTML versions of the cookbook: • single page • multiple pages Use the online version of the DocBook XHTML XSL, and disable the PDF generation until we can restore it.
2010-07-01 11:17:01 +00:00
XSLTOPTS = \
--stringparam html.stylesheet style.css \
--stringparam chapter.autolabel 1 \
--stringparam appendix.autolabel 1 \
--stringparam section.autolabel 1 \
--stringparam gtkdoc.bookname "clutter-cookbook" \
--stringparam gtkdoc.version @CLUTTER_API_VERSION@ \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
--stringparam callout.graphics 0 \
cookbook: Clean up build Create two HTML versions of the cookbook: • single page • multiple pages Use the online version of the DocBook XHTML XSL, and disable the PDF generation until we can restore it.
2010-07-01 11:17:01 +00:00
--path $(top_srcdir)/doc/common \
build: Fix distcheck in the cookbook Someday, somebody will have to explain to me how not touching anything for a whole release cycle ends up breaking the build. Adding the top_srcdir/doc/cookbook path to the includes fixes the distcheck.
2012-10-17 08:37:50 +00:00
--path $(top_srcdir)/doc/cookbook \
cookbook: Clean up build Create two HTML versions of the cookbook: • single page • multiple pages Use the online version of the DocBook XHTML XSL, and disable the PDF generation until we can restore it.
2010-07-01 11:17:01 +00:00
--xinclude
XSL_BASE_URI = http://docbook.sourceforge.net/release/xsl/current
XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
HTML_FILES = $(top_builddir)/doc/cookbook/html/*.html
CSS_FILES = $(top_builddir)/doc/cookbook/html/*.css
cookbook: Add a missing image to the list
2010-07-16 16:20:38 +00:00
IMAGE_FILES = \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
$(srcdir)/images/clutter-logo.png \
docs: Add recipe about implementing a ClutterEffect Add a recipe showing how to implement two simple effects, based on ClutterEffect: an always gray background, and a border with configurable width and color. Also explains the necessity to queue a redraw on the associated actor if the effect's properties change, and shows how to implement that. The example gives the GObject code for both effects, as well as an example application showing how to use them. The example also demonstrates how to disable/enable an effect, making the border round an actor togglable.
2011-03-16 17:44:44 +00:00
$(srcdir)/images/effects-basic.png \
$(srcdir)/images/effects-basic-background.png \
docs: Add effects chapter, with introduction and first recipe Add an effects chapter which gives a broad overview of the abstract classes in the effects API, plus a short example of how to apply one of the stock Clutter effects (ClutterColorizeEffect). The recipe explains how to create a custom ClutterDeformEffect to produce a page fold (code based on ClutterPageTurnEffect). The example code includes the effect class plus a small application to apply it to a texture.
2011-02-21 16:43:34 +00:00
$(srcdir)/images/effects-built-in.png \
$(srcdir)/images/effects-custom-deform.png \
$(srcdir)/images/effects-custom-deform-back-material.png \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
$(srcdir)/images/textures-reflection.png \
$(srcdir)/images/actors-opacity.png \
$(srcdir)/images/actors-opacity-container-affects-opacity.png \
$(srcdir)/images/text-shadow.png \
$(srcdir)/images/textures-sub-texture.png \
$(srcdir)/images/layouts-stacking-diff-actor-sizes.png \
$(srcdir)/images/events-pointer-motion-stacking.png \
$(srcdir)/images/layouts-bind-constraint-stage.png \
cookbook: Add a missing image to the list
2010-07-16 16:20:38 +00:00
$(NULL)
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
cookbook: Added recipe for fading actors in/out Added a recipe showing how to fade actors in/out by animating their opacity property, using both implicit animations and ClutterState.
2010-07-16 11:34:44 +00:00
VIDEO_FILES = \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
$(srcdir)/videos/animations-fading-out.ogv \
$(srcdir)/videos/animations-fading-in-then-out.ogv \
docs: Add recipe for animating an actor on a curved path Show how to animate an actor using a ClutterPathConstraint. This demonstrates how to get effects similar to ClutterPathBehaviour with the modern animation APIs. Includes 3 examples: 1) Simple ClutterPathConstraint used with implicit animations 2) ClutterPathConstraint used to simulate circular animation, using ClutterAnimator 3) Creating simple curved path animations with non-linear easing
2011-02-08 14:37:59 +00:00
$(srcdir)/videos/animations-path.ogv \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
$(srcdir)/videos/animations-rotating-x-minus-45.ogv \
$(srcdir)/videos/animations-rotating-y-45.ogv \
$(srcdir)/videos/animations-rotating-z-90.ogv \
$(srcdir)/videos/animations-rotating-x-minus-180-with-y-minus-96.ogv \
$(srcdir)/videos/animations-rotating-x-minus-180-with-z-minus-96.ogv \
$(srcdir)/videos/animations-rotating-x-centered.ogv \
$(srcdir)/videos/animations-rotating-y-centered.ogv \
$(srcdir)/videos/animations-rotating-z-centered.ogv \
$(srcdir)/videos/animations-rotating-container-reverses-direction.ogv \
docs: Add effects chapter, with introduction and first recipe Add an effects chapter which gives a broad overview of the abstract classes in the effects API, plus a short example of how to apply one of the stock Clutter effects (ClutterColorizeEffect). The recipe explains how to create a custom ClutterDeformEffect to produce a page fold (code based on ClutterPageTurnEffect). The example code includes the effect class plus a small application to apply it to a texture.
2011-02-21 16:43:34 +00:00
$(srcdir)/videos/effects-custom-deform.ogv \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
$(srcdir)/videos/textures-split-go.ogv \
$(srcdir)/videos/events-mouse-scroll.ogv \
$(srcdir)/videos/textures-crossfade-two-textures.ogv \
$(srcdir)/videos/animations-complex.ogv \
$(srcdir)/videos/animations-reuse.ogv \
$(srcdir)/videos/animations-moving-anchors.ogv \
$(srcdir)/videos/animations-moving-depth.ogv \
$(srcdir)/videos/animations-looping.ogv \
cookbook: Added recipe for fading actors in/out Added a recipe showing how to fade actors in/out by animating their opacity property, using both implicit animations and ClutterState.
2010-07-16 11:34:44 +00:00
$(NULL)
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
cookbook: Added support for inline video Amended Makefile to copy content of videos directory into installation directories. Also copies videos and images into the html/ directory during the build, so that the built cookbook can be viewed locally (for testing without having to install). Added an XSLT template to transform Docbook <inlinemediaobject> elements into HTML 5 <video> elements, with a fallback to link to the video displayed for browsers without HTML 5 support. Added note to "Contributing" appendix explaining how to put video into a recipe.
2010-07-15 12:27:02 +00:00
EXTRA_DIST = \
clutter-cookbook.xml.in \
cookbook: Add the source XML files as dependencies in the Makefile rules The generated cookbook files (either HTML or PDF) do not only depend on clutter-cookbok.xml but also on all the chapters that compose the cookbook. Add this dependency to the Makefile rules to have make rebuild the book when a chapter changes. Since XML_FILES is now the list of source files, move recipe-template.xml to EXTRA_DIST.
2010-08-03 20:02:23 +00:00
recipe-template.xml \
cookbook: Added support for inline video Amended Makefile to copy content of videos directory into installation directories. Also copies videos and images into the html/ directory during the build, so that the built cookbook can be viewed locally (for testing without having to install). Added an XSLT template to transform Docbook <inlinemediaobject> elements into HTML 5 <video> elements, with a fallback to link to the video displayed for browsers without HTML 5 support. Added note to "Contributing" appendix explaining how to put video into a recipe.
2010-07-15 12:27:02 +00:00
$(IMAGE_FILES) \
$(XML_FILES) \
$(VIDEO_FILES)
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
CLEANFILES = \
pdf-build.stamp \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
html-build.stamp \
clutter-cookbook.html
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
cookbook: Add the source XML files as dependencies in the Makefile rules The generated cookbook files (either HTML or PDF) do not only depend on clutter-cookbok.xml but also on all the chapters that compose the cookbook. Add this dependency to the Makefile rules to have make rebuild the book when a chapter changes. Since XML_FILES is now the list of source files, move recipe-template.xml to EXTRA_DIST.
2010-08-03 20:02:23 +00:00
pdf-build.stamp: clutter-cookbook.xml $(XML_FILES)
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
SP_ENCODING=XML SP_CHARSET_FIXED=YES \
build: Distcheck fixes
2010-06-30 10:55:52 +00:00
$(JW) -b pdf $(top_builddir)/doc/cookbook/clutter-cookbook.xml \
&& mv -f clutter-cookbook.pdf clutter-cookbook-@CLUTTER_API_VERSION@.pdf \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
&& echo timestamp > $(@F)
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
cookbook: Add the source XML files as dependencies in the Makefile rules The generated cookbook files (either HTML or PDF) do not only depend on clutter-cookbok.xml but also on all the chapters that compose the cookbook. Add this dependency to the Makefile rules to have make rebuild the book when a chapter changes. Since XML_FILES is now the list of source files, move recipe-template.xml to EXTRA_DIST.
2010-08-03 20:02:23 +00:00
html-build.stamp: clutter-cookbook.xml $(XML_FILES)
cookbook: Added support for inline video Amended Makefile to copy content of videos directory into installation directories. Also copies videos and images into the html/ directory during the build, so that the built cookbook can be viewed locally (for testing without having to install). Added an XSLT template to transform Docbook <inlinemediaobject> elements into HTML 5 <video> elements, with a fallback to link to the video displayed for browsers without HTML 5 support. Added note to "Contributing" appendix explaining how to put video into a recipe.
2010-07-15 12:27:02 +00:00
if [ ! -d html ] ; then mkdir html ; fi && \
if [ ! -d html/images ] ; then mkdir html/images ; fi && \
if [ ! -d html/videos ] ; then mkdir html/videos ; fi && \
cookbook: Add example code The cookbook should also include fully functional code examples. We can even XInclude them into the docbook XML itself. The examples should be built with the coobook, so that we can always make sure they are up to date.
2010-07-18 09:53:06 +00:00
if [ ! -d html/examples ] ; then mkdir html/examples ; fi && \
cookbook: Clean up build Create two HTML versions of the cookbook: • single page • multiple pages Use the online version of the DocBook XHTML XSL, and disable the PDF generation until we can restore it.
2010-07-01 11:17:01 +00:00
$(XSLTPROC) $(XSLTOPTS) -o clutter-cookbook.html $(XSL_XHTML_URI) $(top_builddir)/doc/cookbook/clutter-cookbook.xml && \
cookbook: Added support for inline video Amended Makefile to copy content of videos directory into installation directories. Also copies videos and images into the html/ directory during the build, so that the built cookbook can be viewed locally (for testing without having to install). Added an XSLT template to transform Docbook <inlinemediaobject> elements into HTML 5 <video> elements, with a fallback to link to the video displayed for browsers without HTML 5 support. Added note to "Contributing" appendix explaining how to put video into a recipe.
2010-07-15 12:27:02 +00:00
$(XSLTPROC) $(XSLTOPTS) -o html/ cookbook.xsl $(top_builddir)/doc/cookbook/clutter-cookbook.xml && \
cp $(top_srcdir)/doc/common/style.css html/ && \
if [[ "$(VIDEO_FILES)" != "" ]] ; then \
for file in `ls $(VIDEO_FILES)`; do \
cp $$file html/videos/ ; \
done \
fi && \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
cp $(top_srcdir)/doc/cookbook/images/* html/images/ && \
cp $(top_srcdir)/doc/cookbook/examples/*.c html/examples/ && \
cookbook: Clean up build Create two HTML versions of the cookbook: • single page • multiple pages Use the online version of the DocBook XHTML XSL, and disable the PDF generation until we can restore it.
2010-07-01 11:17:01 +00:00
echo timestamp > $(@F)
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
docs: Clean up the additional documentation build • Make the manual a DevHelp book • Make the generation of PDFs of the cookbook and the manual optional • Consequently, make the hard dependency on jw optional • Clean up the checks and build for the additional documentation
2009-09-03 12:04:59 +00:00
if ENABLE_PDFS
cookbook: Clean up build Create two HTML versions of the cookbook: • single page • multiple pages Use the online version of the DocBook XHTML XSL, and disable the PDF generation until we can restore it.
2010-07-01 11:17:01 +00:00
#pdf_target = pdf-build.stamp
pdf_target =
docs: Clean up the additional documentation build • Make the manual a DevHelp book • Make the generation of PDFs of the cookbook and the manual optional • Consequently, make the hard dependency on jw optional • Clean up the checks and build for the additional documentation
2009-09-03 12:04:59 +00:00
else
pdf_target =
endif
if ENABLE_DOCS
all-local: html-build.stamp $(pdf_target)
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
else
all-local:
endif
clean-local:
docs: Clean up the additional documentation build • Make the manual a DevHelp book • Make the generation of PDFs of the cookbook and the manual optional • Consequently, make the hard dependency on jw optional • Clean up the checks and build for the additional documentation
2009-09-03 12:04:59 +00:00
@rm -rf html ; \
rm -f *.pdf ; \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
rm -f *.stamp
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
uninstall-local:
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
@rm -rf $(DESTDIR)$(TARGET_DIR)
@rm -f $(DESTDIR)$(TARGET_DIR)/clutter-cookbook.devhelp
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
install-data-local:
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
installfiles=`echo $(top_builddir)/doc/cookbook/html/*`; \
if test "$$installfiles" = '$(top_builddir)/doc/cookbook/html/*'; \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
then echo '-- Nothing to install' ; \
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
else \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) ; \
cookbook: Fix build so CSS files get installed I had changed the build so CSS files get put into the HTML build directory; but done it in such a way that they were then being ignored during install. Fixed this.
2010-07-06 15:22:47 +00:00
for file in `ls $(HTML_FILES) $(CSS_FILES)`; do \
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
if [ -f $$file ]; then \
basefile=`echo $$file | sed -e 's,^.*/,,'`; \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
$(INSTALL_DATA) $$file $(DESTDIR)$(TARGET_DIR)/$$basefile; \
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
fi \
done; \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
fi; \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
if [ -d $(top_srcdir)/doc/cookbook/images ]; \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
then \
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)/images ; \
build: Distcheck fixes
2010-06-30 10:55:52 +00:00
for file in `ls $(IMAGE_FILES)`; do \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
if [ -f $$file ]; \
then \
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
basefile=`echo $$file | sed -e 's,^.*/,,'`; \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
$(INSTALL_DATA) $$file $(DESTDIR)$(TARGET_DIR)/images/$$basefile; \
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
fi \
done; \
[cookbook] Build the Cookbook as a devhelp document Instead of creating stand-alone HTML files, use XSLT to transform the DocBook into a DevHelp file, so that we can read the Cookbook inside DevHelp -- just like the API reference.
2009-09-02 17:11:06 +00:00
fi; \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
if [ -d $(top_srcdir)/doc/cookbook/videos ]; \
cookbook: Added support for inline video Amended Makefile to copy content of videos directory into installation directories. Also copies videos and images into the html/ directory during the build, so that the built cookbook can be viewed locally (for testing without having to install). Added an XSLT template to transform Docbook <inlinemediaobject> elements into HTML 5 <video> elements, with a fallback to link to the video displayed for browsers without HTML 5 support. Added note to "Contributing" appendix explaining how to put video into a recipe.
2010-07-15 12:27:02 +00:00
then \
$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR)/videos ; \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
for file in `ls $(VIDEO_FILES)`; do \
if [ -f $$file ]; \
then \
basefile=`echo $$file | sed -e 's,^.*/,,'`; \
$(INSTALL_DATA) $$file $(DESTDIR)$(TARGET_DIR)/videos/$$basefile; \
fi \
done; \
cookbook: Added support for inline video Amended Makefile to copy content of videos directory into installation directories. Also copies videos and images into the html/ directory during the build, so that the built cookbook can be viewed locally (for testing without having to install). Added an XSLT template to transform Docbook <inlinemediaobject> elements into HTML 5 <video> elements, with a fallback to link to the video displayed for browsers without HTML 5 support. Added note to "Contributing" appendix explaining how to put video into a recipe.
2010-07-15 12:27:02 +00:00
fi; \
build: Fixes to pass distcheck Try to make the cookbook pass the distcheck phase, so that we can run distcheck with --enable-docs, and make sure that a tarballed clutter release can actually build the cookbook.
2011-02-01 14:33:29 +00:00
$(INSTALL_DATA) $(top_builddir)/doc/cookbook/html/clutter-cookbook.devhelp $(DESTDIR)$(TARGET_DIR)/clutter-cookbook.devhelp
Add the Clutter Cookbook to the build The "Clutter Cookbook" is a document designed to contain solutions to common problems applications developers might encounter when using Clutter. It is meant as a companion to the API reference but it requires knowledge of the Clutter API and framework.
2008-12-11 16:57:46 +00:00
.PHONY : doc
build: Rule for quick publishing of the cookbook Just call `make publish`.
2010-08-14 07:53:18 +00:00
COOKBOOK_BASE_PATH = /home/clutter/web/docs.clutter-project.org/docs/clutter-cookbook
build: Update the remote publish path for the cookbook
2010-09-21 11:02:41 +00:00
COOKBOOK_VERSION = $(CLUTTER_API_VERSION)
build: Rule for quick publishing of the cookbook Just call `make publish`.
2010-08-14 07:53:18 +00:00
COOKBOOK_PATH = $(COOKBOOK_BASE_PATH)/$(COOKBOOK_VERSION)
publish: html-build.stamp
build: Update the remote publish path for the cookbook
2010-09-21 11:02:41 +00:00
$(QUIET_CP)scp -r html/* clutter@clutter-project.org:$(COOKBOOK_PATH)
build: Rule for quick publishing of the cookbook Just call `make publish`.
2010-08-14 07:53:18 +00:00
.PHONY : publish
Reference in New Issue Copy Permalink