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.

.gitignore

@@ -38,6 +38,7 @@ depcomp
 /doc/cookbook/html
 /doc/cookbook/*.stamp
 /doc/cookbook/clutter-cookbook.xml
+/doc/cookbook/clutter-cookbook.html
 /doc/manual/*.pdf
 /doc/manual/html
 /doc/manual/*.stamp

doc/cookbook/Makefile.am

@@ -12,6 +12,19 @@ XML_FILES = \
 	textures.xml		\
 	$(NULL)
 
+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@ 	\
+	--path $(top_srcdir)/doc/common				\
+	--xinclude
+
+XSL_BASE_URI  = http://docbook.sourceforge.net/release/xsl/current
+XSL_XHTML_URI = $(XSL_BASE_URI)/xhtml/docbook.xsl
+
 HTML_FILES = html/*.html
 IMAGE_FILES = images/clutter-logo.png
 
@@ -28,18 +41,13 @@ pdf-build.stamp: clutter-cookbook.xml
 	&& echo timestamp > $(@F)
 
 html-build.stamp: clutter-cookbook.xml
-	$(mkinstalldirs) html \
+	$(XSLTPROC) $(XSLTOPTS) -o clutter-cookbook.html $(XSL_XHTML_URI) $(top_builddir)/doc/cookbook/clutter-cookbook.xml && \
-	&& $(XSLTPROC) --nonet --xinclude -o ./html/ \
+	$(XSLTPROC) $(XSLTOPTS) -o html/ ref-html-style.xsl $(top_builddir)/doc/cookbook/clutter-cookbook.xml && \
-		--path $(top_srcdir)/doc/common \
+	echo timestamp > $(@F)
-		--path . \
-		--stringparam gtkdoc.bookname "clutter-cookbook" \
-		--stringparam gtkdoc.version @CLUTTER_API_VERSION@ \
-		ref-html-style.xsl \
-	$(top_builddir)/doc/cookbook/clutter-cookbook.xml \
-	&& echo timestamp > $(@F)
 
 if ENABLE_PDFS
-pdf_target = pdf-build.stamp
+#pdf_target = pdf-build.stamp
+pdf_target =
 else
 pdf_target =
 endif