Bug 423496: Compile the documentation with xmlto + dblatex instead of openjade

r=glob a=LpSolit

4 files changed, 83 insertions, 0 deletions

diff --git a/docs/xsl/bugzilla-docs.xsl b/docs/xsl/bugzilla-docs.xsl
new file mode 100644
index 000000000..48678294b
--- /dev/null
+++ b/docs/xsl/bugzilla-docs.xsl
@@ -0,0 +1,29 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <!-- Nicer Filenames -->
+    <xsl:param name="use.id.as.filename" select="1"/>
+
+    <!-- Label sections if they aren't automatically labeled -->
+    <xsl:param name="section.autolabel" select="1"/>
+    <xsl:param name="section.label.includes.component.label" select="1"/>
+
+    <!-- Table of Contents Depth -->
+    <xsl:param name="toc.section.depth">2</xsl:param>
+    <xsl:param name="generate.section.toc.level" select="0"/>
+
+    <!-- Show titles of next/previous page -->
+    <xsl:param name="navig.showtitles">1</xsl:param>
+
+    <!-- Tidy up the HTML a bit... -->
+    <xsl:param name="html.cleanup" select="1"/>
+    <xsl:param name="make.valid.html" select="1"/>
+    <xsl:param name="html.stylesheet">../../style.css</xsl:param>
+    <xsl:param name="highlight.source" select="1"/>
+
+    <!-- Use Graphics, specify their Path and Extension -->
+    <xsl:param name="admon.graphics" select="1"/>
+    <xsl:param name="admon.graphics.path">../images/</xsl:param>
+    <xsl:param name="admon.graphics.extension">.gif</xsl:param>
+    <xsl:param name="admon.textlabel" select="0"/>
+    <xsl:param name="admon.style">margin-left: 1em; margin-right: 1em</xsl:param>
+</xsl:stylesheet>
diff --git a/docs/xsl/chunks.xsl b/docs/xsl/chunks.xsl
new file mode 100644
index 000000000..17b964908
--- /dev/null
+++ b/docs/xsl/chunks.xsl
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <!-- Include default bugzilla XSL -->
+    <xsl:include href="bugzilla-docs.xsl"/>
+    <!-- Set Chunk Specific XSL Params -->
+    <xsl:param name="chunker.output.doctype-public">-//W3C//DTD HTML 4.01 Transitional//EN</xsl:param>
+    <xsl:param name="chunker.output.doctype-system">http://www.w3.org/TR/html4/loose.dtd</xsl:param>
+    <xsl:param name="chunk.section.depth" select="1"/>
+    <xsl:param name="chunk.first.sections" select="1"/>
+    <xsl:param name="chunker.output.encoding" select="UTF-8"/>
+    <xsl:param name="chunk.quietly" select="1"/>
+</xsl:stylesheet>
diff --git a/docs/xsl/nochunks.xsl b/docs/xsl/nochunks.xsl
new file mode 100644
index 000000000..12d901653
--- /dev/null
+++ b/docs/xsl/nochunks.xsl
@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
+    <xsl:output method="html" encoding="UTF-8" indent="no"/>
+    <!-- Include default bugzilla XSL -->
+    <xsl:include href="bugzilla-docs.xsl"/>
+    <!-- No other params necessary -->
+</xsl:stylesheet>
diff --git a/docs/xsl/pdf.xsl b/docs/xsl/pdf.xsl
new file mode 100644
index 000000000..312b36612
--- /dev/null
+++ b/docs/xsl/pdf.xsl
@@ -0,0 +1,35 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
+                xmlns:fo="http://www.w3.org/1999/XSL/Format"
+                version="1.0">
+    <!-- Some layout parameters -->
+    <xsl:param name="generate.index" select="0"/>
+    <xsl:param name="doc.collab.show" select="0"/>
+    <xsl:param name="latex.output.revhistory" select="0"/>
+    <xsl:param name="doc.lot.show"></xsl:param>
+    <xsl:param name="latex.encoding">utf8</xsl:param>
+    <xsl:param name="imagedata.default.scale">pagebound</xsl:param>
+    <xsl:param name="latex.hyperparam">colorlinks,linkcolor=blue,urlcolor=blue</xsl:param>
+
+    <!-- Show <ulink>s as footnotes -->
+    <xsl:param name="ulink.footnotes" select="1"/>
+    <xsl:param name="ulink.show" select="1"/>
+
+    <!-- Don't use Graphics -->
+    <xsl:param name="admon.graphics" select="0"/>
+    <xsl:param name="callout.graphics" select="0"/>
+
+    <!-- Make pdflatex shut up about <prompt> and <command> within <programlisting>, -->
+    <!-- see http://dblatex.sourceforge.net/doc/manual/sec-verbatim.html             -->
+    <xsl:template match="prompt|command" mode="latex.programlisting">
+        <xsl:param name="co-tagin" select="'&lt;:'"/>
+        <xsl:param name="rnode" select="/"/>
+        <xsl:param name="probe" select="0"/>
+
+        <xsl:call-template name="verbatim.boldseq">
+            <xsl:with-param name="co-tagin" select="$co-tagin"/>
+            <xsl:with-param name="rnode" select="$rnode"/>
+            <xsl:with-param name="probe" select="$probe"/>
+        </xsl:call-template>
+    </xsl:template>
+</xsl:stylesheet>