Commit a5963efa authored by Peter Eisentraut's avatar Peter Eisentraut

doc: Improve setup for documentation building with FOP

Add a makefile rule for building PDFs with FOP.  Two new build targets
in doc/src/sgml are postgres-A4-fop.pdf and postgres-US-fop.pdf.

Run .fo output through xmllint for reformatting, so that errors are
easier to find.  (The default output has hardly any line breaks, so you
might be looking for an error in column 20000.)

Set some XSLT parameters to optimize for building with FOP.

Remove some redundant or somewhat useless chapterinfo/author
information, because it renders strangely with the FO stylesheet.
Reviewed-by: default avatarÁlvaro Herrera <alvherre@2ndquadrant.com>
parent 709170b7
...@@ -268,12 +268,24 @@ xslthtml-stamp: stylesheet.xsl postgres.xml ...@@ -268,12 +268,24 @@ xslthtml-stamp: stylesheet.xsl postgres.xml
htmlhelp: stylesheet-hh.xsl postgres.xml htmlhelp: stylesheet-hh.xsl postgres.xml
$(XSLTPROC) $(XSLTPROCFLAGS) $^ $(XSLTPROC) $(XSLTPROCFLAGS) $^
%-A4.fo: stylesheet-fo.xsl %.xml %-A4.fo.tmp: stylesheet-fo.xsl %.xml
$(XSLTPROC) $(XSLTPROCFLAGS) --stringparam paper.type A4 -o $@ $^ $(XSLTPROC) $(XSLTPROCFLAGS) --stringparam paper.type A4 -o $@ $^
%-US.fo: stylesheet-fo.xsl %.xml %-US.fo.tmp: stylesheet-fo.xsl %.xml
$(XSLTPROC) $(XSLTPROCFLAGS) --stringparam paper.type USletter -o $@ $^ $(XSLTPROC) $(XSLTPROCFLAGS) --stringparam paper.type USletter -o $@ $^
FOP = fop
XMLLINT = xmllint
# reformat FO output so that locations of errors are easier to find
%.fo: %.fo.tmp
$(XMLLINT) --format --output $@ $^
.SECONDARY: postgres-A4.fo postgres-US.fo
%-fop.pdf: %.fo
$(FOP) -fo $< -pdf $@
epub: postgres.epub epub: postgres.epub
postgres.epub: postgres.xml postgres.epub: postgres.xml
$(DBTOEPUB) $< $(DBTOEPUB) $<
...@@ -391,7 +403,7 @@ clean: ...@@ -391,7 +403,7 @@ clean:
# index # index
rm -f HTML.index $(GENERATED_SGML) rm -f HTML.index $(GENERATED_SGML)
# XSLT # XSLT
rm -f postgres.xml postgres.xmltmp htmlhelp.hhp toc.hhc index.hhk *.fo rm -f postgres.xml postgres.xmltmp htmlhelp.hhp toc.hhc index.hhk *.fo *.fo.tmp
# EPUB # EPUB
rm -f postgres.epub rm -f postgres.epub
# Texinfo # Texinfo
......
<!-- doc/src/sgml/geqo.sgml --> <!-- doc/src/sgml/geqo.sgml -->
<chapter id="geqo"> <chapter id="geqo">
<chapterinfo>
<author>
<firstname>Martin</firstname>
<surname>Utesch</surname>
<affiliation>
<orgname>
University of Mining and Technology
</orgname>
<orgdiv>
Institute of Automatic Control
</orgdiv>
<address>
<city>
Freiberg
</city>
<country>
Germany
</country>
</address>
</affiliation>
</author>
<date>1997-10-02</date>
</chapterinfo>
<title>Genetic Query Optimizer</title> <title>Genetic Query Optimizer</title>
<para> <para>
......
<!-- doc/src/sgml/nls.sgml --> <!-- doc/src/sgml/nls.sgml -->
<chapter id="nls"> <chapter id="nls">
<chapterinfo>
<author>
<firstname>Peter</firstname>
<surname>Eisentraut</surname>
</author>
</chapterinfo>
<title>Native Language Support</title> <title>Native Language Support</title>
<sect1 id="nls-translator"> <sect1 id="nls-translator">
......
...@@ -6,6 +6,18 @@ ...@@ -6,6 +6,18 @@
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/> <xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.xsl"/>
<xsl:include href="stylesheet-common.xsl" /> <xsl:include href="stylesheet-common.xsl" />
<xsl:param name="fop1.extensions" select="1"></xsl:param>
<xsl:param name="tablecolumns.extension" select="0"></xsl:param>
<xsl:param name="toc.max.depth">3</xsl:param>
<xsl:param name="ulink.footnotes" select="1"></xsl:param>
<xsl:param name="use.extensions" select="1"></xsl:param>
<xsl:param name="variablelist.as.blocks" select="1"></xsl:param>
<xsl:attribute-set name="monospace.verbatim.properties"
use-attribute-sets="verbatim.properties monospace.properties">
<xsl:attribute name="wrap-option">wrap</xsl:attribute>
</xsl:attribute-set>
<!-- Change display of some elements --> <!-- Change display of some elements -->
<xsl:template match="command"> <xsl:template match="command">
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment