Re: [DOCS] Docbook 5.x - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: [DOCS] Docbook 5.x
Date
Msg-id 90b1cc0c-eb1d-65ec-5fd9-8e2d0b707584@2ndquadrant.com
Whole thread Raw
In response to Re: [DOCS] Docbook 5.x  (Alexander Lakhin <exclusion@gmail.com>)
Responses Re: [DOCS] Docbook 5.x  (Alexander Lakhin <exclusion@gmail.com>)
List pgsql-docs
On 11/25/17 00:50, Alexander Lakhin wrote:
> Please, consider applying the attached patch. It produces the same
> INSTALL and is much better in the following aspects.
> 
> 1. All the INSTALL content is placed in two files (installation.sgml and
> installation-single.xsl) instead of three (installation.sgml,
> standalone-install.xml, standalone-profile.xsl).
> 2. There are no unreadable and untranslatable (in context) constructions
> such as
> <xsl:template match="xref[@linkend='plpython-python23']">
>   <xsl:text>the
> </xsl:text><application>PL/Python</application><xsl:text>
> documentation</xsl:text>
> </xsl:template>
> (Sometimes translators need to replace larger fragments.)
> 3. It uses only XSLT (which we use already), no xi:include.
> 4. It doesn't generate complete postgres.sgml to process only the
> installation section.

What is the standalonetext attribute?  I don't see that in the DTD.
Wouldn't that fail validation?

Also, the makefile fragments need to be written differently.  You can't
use pipes; that would not catch any errors.

-- 
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


pgsql-docs by date:

Previous
From: Michael Paquier
Date:
Subject: Re: libpq options
Next
From: Alexander Lakhin
Date:
Subject: Re: [DOCS] Docbook 5.x