Some refinement of XSLT processing: The result now looks just about as good

petere · petere · commit b89744198e4c · 2004-01-15T23:51:32.000Z
as the result of the SGML-based tool chain.
diff --git a/doc/src/sgml/Makefile b/doc/src/sgml/Makefile
@@ -2,7 +2,7 @@
 #
 # PostgreSQL documentation makefile
 #
-# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.63 2004/01/13 18:45:19 petere Exp $
+# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.64 2004/01/15 23:51:32 petere Exp $
 #
 #----------------------------------------------------------------------------
 
@@ -205,10 +205,13 @@ OSX = osx # (may be called sx or sgml2xml on some systems)
 XSLTPROC = xsltproc
 
 postgres.xml: postgres.sgml $(GENERATED_SGML)
-	$(OSX) -x lower $< >$@
+	$(OSX) -x lower $< | \
+	  sed -e 's/\[\(lt\|gt\|amp\|nbsp\|copy\|quot\|ouml\|uuml\|egrave\) *\]/\&\1;/g' \
+	      -e '1a\' -e '<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">' \
+	  >$@
 
 testxml: stylesheet.xsl postgres.xml
-	$(XSLTPROC) $^
+	$(XSLTPROC) $(XSLTPROCFLAGS) --stringparam pg.version '$(VERSION)' $^
 
 
 ##
diff --git a/doc/src/sgml/stylesheet.xsl b/doc/src/sgml/stylesheet.xsl
@@ -4,30 +4,48 @@
                 xmlns="http://www.w3.org/TR/xhtml1/transitional"
                 exclude-result-prefixes="#default">
 
-<xsl:import href="http://docbook.sourceforge.net/release/xsl/snapshot/html/chunk.xsl"/>
+<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/xhtml/chunk.xsl"/>
 
 <!-- Parameters -->
 
-<xsl:param name="autotoc.label.separator" select="'. '"/>
+<xsl:param name="pg.fast" select="'0'"/>
+
+<!--
+<xsl:param name="draft.mode">
+  <xsl:choose>
+    <xsl:when test="contains($pg.version, 'devel')">yes</xsl:when>
+    <xsl:otherwise>no</xsl:otherwise>
+  </xsl:choose>
+</xsl:param>
+-->
+
+<xsl:param name="show.comments">
+  <xsl:choose>
+    <xsl:when test="contains($pg.version, 'devel')">1</xsl:when>
+    <xsl:otherwise>0</xsl:otherwise>
+  </xsl:choose>
+</xsl:param>
+
+
 <xsl:param name="callout.graphics" select="'0'"></xsl:param>
-<xsl:param name="toc.section.depth">3</xsl:param>
+<xsl:param name="toc.section.depth">2</xsl:param>
 <xsl:param name="linenumbering.extension" select="'0'"></xsl:param>
-<xsl:param name="preface.autolabel" select="1"></xsl:param>
-<xsl:param name="section.autolabel" select="1"></xsl:param>
-<xsl:param name="section.label.includes.component.label" select="1"></xsl:param>
+<xsl:param name="generate.index" select="1 - $pg.fast"></xsl:param>
+<xsl:param name="preface.autolabel" select="1 - $pg.fast"></xsl:param>
+<xsl:param name="section.autolabel" select="1 - $pg.fast"></xsl:param>
+<xsl:param name="section.label.includes.component.label" select="1 - $pg.fast"></xsl:param>
 <xsl:param name="html.stylesheet" select="'stylesheet.css'"></xsl:param>
 <xsl:param name="use.id.as.filename" select="'1'"></xsl:param>
 <xsl:param name="make.valid.html" select="1"></xsl:param>
-<xsl:param name="generate.id.attributes" select="0"></xsl:param> <!-- ? -->
+<xsl:param name="generate.id.attributes" select="1"></xsl:param>
 <xsl:param name="generate.legalnotice.link" select="1"></xsl:param>
+<xsl:param name="refentry.xref.manvolnum" select="0"/>
 <xsl:param name="link.mailto.url">pgsql-docs@postgresql.org</xsl:param>
 <xsl:param name="formal.procedures" select="0"></xsl:param>
 <xsl:param name="punct.honorific" select="''"></xsl:param>
-<xsl:param name="chunker.output.doctype-public" select="''"/> <!-- ? -->
-<xsl:param name="chunker.output.indent" select="'no'"/> <!-- ? --> 
-<xsl:param name="chunker.output.omit-xml-declaration" select="'no'"/>
-<xsl:param name="html.extra.head.links" select="0"></xsl:param>
-<xsl:param name="chunk.quietly" select="0"></xsl:param>
+<xsl:param name="chunker.output.indent" select="'yes'"/>
+<xsl:param name="chunk.quietly" select="1"></xsl:param>
+
 
 <!-- Change display of some elements -->
 
@@ -67,4 +85,24 @@
   <xsl:call-template name="inline.boldseq"/>
 </xsl:template>
 
+
+<!-- Special support for Tcl synopses -->
+
+<xsl:template match="optional[@role='tcl']">
+  ?<xsl:call-template name="inline.charseq"/>?
+</xsl:template>
+
+
+<!--
+  Format multiple terms in varlistentry vertically, instead
+  of comma-separated.
+ -->
+
+<xsl:template match="varlistentry/term[position()!=last()]">
+  <span class="term">
+    <xsl:call-template name="anchor"/>
+    <xsl:apply-templates/>
+  </span><br/>
+</xsl:template>
+
 </xsl:stylesheet>

Original file line number	Diff line number	Diff line change
`@@ -2,7 +2,7 @@`
`2`	`2`	`#`
`3`	`3`	`# PostgreSQL documentation makefile`
`4`	`4`	`#`
`5`		`-# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.63 2004/01/13 18:45:19 petere Exp $`
	`5`	`+# $PostgreSQL: pgsql/doc/src/sgml/Makefile,v 1.64 2004/01/15 23:51:32 petere Exp $`
`6`	`6`	`#`
`7`	`7`	`#----------------------------------------------------------------------------`
`8`	`8`
`@@ -205,10 +205,13 @@ OSX = osx # (may be called sx or sgml2xml on some systems)`
`205`	`205`	`XSLTPROC = xsltproc`
`206`	`206`
`207`	`207`	`postgres.xml: postgres.sgml $(GENERATED_SGML)`
`208`		`- $(OSX) -x lower $< >$@`
	`208`	`+ $(OSX) -x lower $< \| \`
	`209`	`+ sed -e 's/\[\(lt\\|gt\\|amp\\|nbsp\\|copy\\|quot\\|ouml\\|uuml\\|egrave\) *\]/\&\1;/g' \`
	`210`	`+ -e '1a\' -e '<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">' \`
	`211`	`+ >$@`
`209`	`212`
`210`	`213`	`testxml: stylesheet.xsl postgres.xml`
`211`		`- $(XSLTPROC) $^`
	`214`	`+ $(XSLTPROC) $(XSLTPROCFLAGS) --stringparam pg.version '$(VERSION)' $^`
`212`	`215`
`213`	`216`
`214`	`217`	`##`