Re: Docbook 5.x

From: Alexander Lakhin <exclusion(at)gmail(dot)com>
To: Peter Eisentraut <peter(dot)eisentraut(at)2ndquadrant(dot)com>, Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Docbook 5.x
Date: 2017-11-16 06:00:28
Message-ID: 4317d27a-9f9c-dfeb-2758-446243c66ddf@gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Hello Peter,

16.11.2017 00:06, Peter Eisentraut wrote:
> Here is the final patch set for the conversion.
Great!

I have some questions.
1. Can you share the exact scripts you use to generate 0002?
(We transform the documentation to xml since 9.6 on-fly so it would be
nice to adjust our scripts for previous versions too.)
2. Will you rename *.sgml to *.xml and move src/sgml to src/xml?
3. And I still think that hard-coding references and replacements in the
standalone-profile is not good. Are you going to apply less hackish
approach?
(See
https://www.postgresql.org/message-id/b4fd6932-8d44-3210-48ab-bbc393bf9a23%40gmail.com
, patches/xml/installation.patch and patches/xml/installation-single.xsl)
4. BTW, when making postgres-A4.pdf, I get
[WARN] FOUserAgent - Destination: Unresolved ID reference
"ecpg-type-timestamp-date" found.
It can be fixed by moving the id from the title tag to sect4:
-    <sect4>
-     <title id="ecpg-type-timestamp-date">timestamp, date</title>
+    <sect4 id="ecpg-type-timestamp-date">
+     <title>timestamp, date</title>
I wonder, what were the reasons to set id for the title tag?

Best regards,
------
Alexander Lakhin
Postgres Professional: http://www.postgrespro.com
The Russian Postgres Company

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Peter Eisentraut 2017-11-18 17:24:38 Re: Docbook 5.x
Previous Message Magnus Hagander 2017-11-10 14:55:29 Re: pg_replication_slots page links