mirror of
https://github.com/postgres/postgres.git
synced 2025-07-15 19:21:59 +03:00
5869aef9a1
Commit b0f0a9432d backpatched some code from upstream DocBook XSL to
our customization layer. It turned out that this failed to work with
anything but the latest DocBook XSL upstream version (1.79.*), because
the backpatched code references an XSLT parameter (autolink.index.see)
that is not defined in earlier versions (because the feature it is
used for did not exist yet).
There is no way in XSLT to test whether a parameter is declared before
the stylesheet processor tries and fails to access it. So the
possibilities to fix this would be to either remove the code that uses
the parameter (and thus give up on the feature it is used for) or
declare the parameter in our customization layer. The latter seems
easier, and with a few more lines of code we can backport the entire
autolink.index.see feature, so let's do that. (If we didn't, then
with older stylesheets the parameter will appear as on, but it won't
actually do anything, because of the way the stylesheets are laid out,
so it's less confusing to just make it work.)
With this, the documentation build should work again with docbook-xsl
versions 1.77.*, 1.78.*, and 1.79.* (which already worked before).
Version 1.76.1 already didn't work before all this, so was not
considered here.
Reported-by: Peter Smith <smithpb2250@gmail.com>
Discussion: https://www.postgresql.org/message-id/flat/9077b779-a9f8-09c8-6e85-da1ebfba15af@eisentraut.org
135 lines
4.0 KiB
XML
135 lines
4.0 KiB
XML
<?xml version="1.0" encoding="utf-8"?>
|
|
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
|
version="1.0">
|
|
|
|
<!--
|
|
This file contains XSLT stylesheet customizations that are common to
|
|
all output formats (HTML, XSL-FO, man, etc.).
|
|
-->
|
|
|
|
<xsl:include href="stylesheet-speedup-common.xsl" />
|
|
|
|
<!-- Parameters -->
|
|
|
|
<!--
|
|
<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="glossentry.show.acronym">yes</xsl:param>
|
|
<xsl:param name="toc.section.depth">2</xsl:param>
|
|
<xsl:param name="linenumbering.extension" select="'0'"></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="refentry.generate.name" select="0"></xsl:param>
|
|
<xsl:param name="refentry.generate.title" select="1"></xsl:param>
|
|
<xsl:param name="refentry.xref.manvolnum" select="0"/>
|
|
<xsl:param name="formal.procedures" select="0"></xsl:param>
|
|
<xsl:param name="generate.consistent.ids" select="1"/>
|
|
<xsl:param name="punct.honorific" select="''"></xsl:param>
|
|
<xsl:param name="variablelist.term.break.after">1</xsl:param>
|
|
<xsl:param name="variablelist.term.separator"></xsl:param>
|
|
<xsl:param name="xref.with.number.and.title" select="0"></xsl:param>
|
|
|
|
<!--
|
|
This is the default setting, but putting it here makes sure the variable
|
|
exists even with older (<1.79) stylesheet versions, because it is used in
|
|
our customization layer.
|
|
-->
|
|
<xsl:param name="autolink.index.see" select="1"/>
|
|
|
|
|
|
<!-- Change display of some elements -->
|
|
|
|
<xsl:template match="productname">
|
|
<xsl:call-template name="inline.charseq"/>
|
|
</xsl:template>
|
|
|
|
<!-- Render <returnvalue> with a right arrow then the type name -->
|
|
<!-- Avoid adding unnecessary white space in this template! -->
|
|
<xsl:template match="returnvalue">→ <xsl:call-template name="inline.monoseq"/></xsl:template>
|
|
|
|
<xsl:template match="structfield">
|
|
<xsl:call-template name="inline.monoseq"/>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="structname">
|
|
<xsl:call-template name="inline.monoseq"/>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="symbol">
|
|
<xsl:call-template name="inline.monoseq"/>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="systemitem">
|
|
<xsl:call-template name="inline.charseq"/>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="token">
|
|
<xsl:call-template name="inline.monoseq"/>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="type">
|
|
<xsl:call-template name="inline.monoseq"/>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="programlisting/emphasis">
|
|
<xsl:call-template name="inline.boldseq"/>
|
|
</xsl:template>
|
|
|
|
|
|
<!-- Special support for Tcl synopses -->
|
|
|
|
<xsl:template match="optional[@role='tcl']">
|
|
<xsl:text>?</xsl:text>
|
|
<xsl:call-template name="inline.charseq"/>
|
|
<xsl:text>?</xsl:text>
|
|
</xsl:template>
|
|
|
|
|
|
<!-- Support for generating xref link text to additional elements -->
|
|
|
|
<xsl:template match="command" mode="xref-to">
|
|
<xsl:apply-templates select="." mode="xref"/>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="function" mode="xref-to">
|
|
<xsl:apply-templates select="." mode="xref"/>
|
|
</xsl:template>
|
|
|
|
|
|
<!--
|
|
Support for copying images to the output directory, so the output is self
|
|
contained.
|
|
-->
|
|
<xsl:template name="write-image">
|
|
<xsl:variable name="input_filename">
|
|
<xsl:value-of select="imagedata/@fileref"/>
|
|
</xsl:variable>
|
|
|
|
<!-- references images directly, without images/ -->
|
|
<xsl:variable name="output_filename">
|
|
<xsl:value-of select="concat($chunk.base.dir, substring-after($input_filename, '/'))"/>
|
|
</xsl:variable>
|
|
|
|
<xsl:call-template name="write.chunk">
|
|
<xsl:with-param name="filename" select="$output_filename"/>
|
|
<xsl:with-param name="content" select="document($input_filename)"/>
|
|
</xsl:call-template>
|
|
</xsl:template>
|
|
|
|
|
|
</xsl:stylesheet>
|