| From: | Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com> |
|---|---|
| To: | Alexander Lakhin <exclusion(at)gmail(dot)com>, Jürgen Purtz <juergen(at)purtz(dot)de> |
| Cc: | pgsql-docs(at)postgresql(dot)org, Tom Lane <tgl(at)sss(dot)pgh(dot)pa(dot)us> |
| Subject: | Re: [DOCS] Docbook 5.x |
| Date: | 2017-11-28 16:02:14 |
| Message-ID: | 90b1cc0c-eb1d-65ec-5fd9-8e2d0b707584@2ndquadrant.com |
| Views: | Raw Message | Whole Thread | Download mbox | Resend email |
| Thread: | |
| Lists: | 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[(at)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
| From | Date | Subject | |
|---|---|---|---|
| Next Message | Alexander Lakhin | 2017-11-28 16:55:11 | Re: [DOCS] Docbook 5.x |
| Previous Message | Michael Paquier | 2017-11-28 08:21:37 | Re: libpq options |