mirror of
https://github.com/postgres/postgres.git
synced 2025-05-12 16:21:30 +03:00
684cf76b83
Previously, we created a variant of the installation instructions for producing the plain-text INSTALL file by marking up certain parts of installation.sgml using SGML parameterized marked sections. Marked sections will not work anymore in XML, so before we can convert the documentation to XML, we need a new approach. DocBook provides a "profiling" feature that allows selecting content based on attributes, which would work here. But it imposes a noticeable overhead when building the full documentation and causes complications when building some output formats, and given that we recently spent a fair amount of effort optimizing the documentation build time, it seems sad to have to accept that. So as an alternative, (1) we create our own mini-profiling layer that adjusts just the text we want, and (2) assemble the pieces of content that we want in the INSTALL file using XInclude. That way, there is no overhead when building the full documentation and most of the "ugly" stuff in installation.sgml can be removed and dealt with out of line.
82 lines
2.3 KiB
XML
82 lines
2.3 KiB
XML
<?xml version='1.0'?>
|
|
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
|
version="1.0">
|
|
|
|
<!--
|
|
This is a preprocessing layer to convert the installation instructions into a
|
|
variant without links and references to the main documentation.
|
|
|
|
- To omit something in the stand-alone INSTALL file, give the element a
|
|
condition="standalone-ignore" attribute.
|
|
|
|
- If there is no element that exactly covers what you want to change, wrap it
|
|
in a <phrase> element, which otherwise does nothing.
|
|
|
|
- Otherwise, write a custom rule below.
|
|
-->
|
|
|
|
<xsl:output
|
|
doctype-public="-//OASIS//DTD DocBook XML V4.2//EN"
|
|
doctype-system="http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"/>
|
|
|
|
<!-- copy everything by default -->
|
|
|
|
<xsl:template match="@*|node()">
|
|
<xsl:copy>
|
|
<xsl:apply-templates select="@*|node()" />
|
|
</xsl:copy>
|
|
</xsl:template>
|
|
|
|
<!-- particular conversions -->
|
|
|
|
<xsl:template match="*[@condition='standalone-ignore']">
|
|
</xsl:template>
|
|
|
|
<xsl:template match="phrase/text()['chapter']">
|
|
<xsl:text>document</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="phrase[@id='install-ldap-links']">
|
|
<xsl:text>the documentation about client authentication and libpq</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='docguide-toolsets']">
|
|
<xsl:text>the main documentation's appendix on documentation</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='dynamic-trace']">
|
|
<xsl:text>the documentation</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='install-windows']">
|
|
<xsl:text>the documentation</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='pgcrypto']">
|
|
<xsl:text>pgcrypto</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='plpython-python23']">
|
|
<xsl:text>the </xsl:text><application>PL/Python</application><xsl:text> documentation</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='regress']">
|
|
<xsl:text>the file </xsl:text>
|
|
<filename>src/test/regress/README</filename>
|
|
<xsl:text> and the documentation</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='upgrading']">
|
|
<xsl:text>the documentation</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='uuid-ossp']">
|
|
<xsl:text>uuid-ossp</xsl:text>
|
|
</xsl:template>
|
|
|
|
<xsl:template match="xref[@linkend='xml2']">
|
|
<xsl:text>xml2</xsl:text>
|
|
</xsl:template>
|
|
|
|
</xsl:stylesheet>
|