rdelaage
/
postgresql
mirror of https://git.postgresql.org/git/postgresql.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

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: Álvaro Herrera <alvherre@2ndquadrant.com>
This commit is contained in:
Peter Eisentraut 2013-09-11 10:20:27 -04:00
parent 709170b790
commit a5963efa8f
4 changed files with 27 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
doc/src/sgml/Makefile
View File

@ -268,12 +268,24 @@ xslthtml-stamp: stylesheet.xsl postgres.xml
htmlhelp: stylesheet-hh.xsl postgres.xml
$(XSLTPROC) $(XSLTPROCFLAGS) $^
%-A4.fo: stylesheet-fo.xsl %.xml
%-A4.fo.tmp: stylesheet-fo.xsl %.xml
$(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 $@ $^
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
postgres.epub: postgres.xml
$(DBTOEPUB) $<
@ -391,7 +403,7 @@ clean:
# index
rm -f HTML.index $(GENERATED_SGML)
# 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
rm -f postgres.epub
# Texinfo

24
doc/src/sgml/geqo.sgml
View File

@ -1,30 +1,6 @@
<!-- doc/src/sgml/geqo.sgml -->
<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>
<para>

7
doc/src/sgml/nls.sgml
View File

@ -1,13 +1,6 @@
<!-- doc/src/sgml/nls.sgml -->
<chapter id="nls">
<chapterinfo>
<author>
<firstname>Peter</firstname>
<surname>Eisentraut</surname>
</author>
</chapterinfo>
<title>Native Language Support</title>
<sect1 id="nls-translator">

12
doc/src/sgml/stylesheet-fo.xsl
View File

@ -6,6 +6,18 @@
<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/fo/docbook.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 -->
<xsl:template match="command">