Subject: Re: Docbook 5.x
To: pgsql-docs@postgresql.org
References: <57179283.6080704@purtz.de>
 <20160503193441.GA61759@alvherre.pgsql>
 <CAF4Au4zUVOuWjWc+B72yvvpVo=TJad6=x9chig7Ls9DNa7Kgrg@mail.gmail.com>
 <db902495-52f2-ee33-b229-5fe094cf4937@2ndquadrant.com>
 <572AD007.60900@gmail.com>
 <bcc78f65-ef7f-22ea-0d7a-a83b7b7538b6@2ndquadrant.com>
 <5752E599.2090505@gmail.com>
 <de53dbdf-a0f1-5673-bbee-ca4f3d75f278@2ndquadrant.com>
 <576d0623-a89c-b3de-e321-dc48a579ff1a@2ndquadrant.com>
 <eb1abd5e-4210-b5c5-522c-d15e4e62a09b@gmail.com>
 <b4f74ac9-09ba-d198-092b-e2bfbf1c0194@2ndquadrant.com>
 <4adecfc6-2f2e-2ff2-bfa3-58b7d397227b@gmail.com>
 <c7e45017-c918-d2ec-a7e5-f696e41c5314@gmail.com>
 <e4e972b8-425b-164b-031e-f6db2daef9d2@2ndquadrant.com>
 <8f227b2a-5093-8d99-85da-ea00e18343f6@gmail.com>
 <aab72af9-928c-e116-d342-804bf78911c6@gmail.com>
From: =?UTF-8?Q?J=c3=bcrgen_Purtz?= <juergen@purtz.de>
Message-ID: <542a25dc-d951-78de-45fa-ba0de06834fd@purtz.de>
Date: Wed, 16 Nov 2016 19:40:33 +0500
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:45.0) Gecko/20100101
 Thunderbird/45.4.0
MIME-Version: 1.0
In-Reply-To: <aab72af9-928c-e116-d342-804bf78911c6@gmail.com>
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 8bit
Precedence: bulk
Sender: pgsql-docs-owner@postgresql.org


> Hello Peter,
>
> I saw that you committed the patch to switch the html build to XSLT by 
> default.
> So It seems, now we can continue the move to XML.
> I'd suggest to move in several steps.
> Please see the attached scripts.
> The main script is 7_check_conversion.sh. It performs all the 
> conversion and checks whether the html output is the same.
> I suggest to split conversion in three commits.
> Commit#0 is for manual corrections - it replaces "<" with "&lt;" and 
> so on in some sgml's and it doesn't affect the build or outputs.
> It needed just for the next step - automatic conversion. These changes 
> to sgml's are countable and observable.
>
> Commit#1 performs conversion of all SGML's to make them compatible 
> with XML (as much as possible). (Thanks to Jurgen for his sgml2xml.pl 
> script.)
> These changes to sgml's are massive, but they are produced 
> automatically, so we need just to check the script and make sure that 
> the output is the same.
> After that commit we still can use SGML build.
>
> And the last commit, commit#2 is for switching to XML. At that point 
> doc/src/sgml renamed to doc/src/xml, build environment modified and 
> cleaned, but changes in sgml/xml are minimal, so we can observe and 
> check them.
>
> After the commit#2 we get all our docs in XML (DocBook 4.2) and can 
> build it just as we did with 'make html/man/...' before.
> Maybe the commit#2 should be applied later, but commits #0 and #1 are 
> not intrusive and can be applied anytime.
>
> Best regards,
> Alexander
>

Hello,

I greatly welcome the next steps toward XML.

In addition to the submitted scripts I want to point out that we will 
get validation error messages if the following three things coincide: a) 
Docbook 4.2, b) use of XInclude, c) a different directory (eg: 'ref'). 
The xi:base attribute (to specify a different directory) was introduced 
into the Docbook DTD with version 4.3. Older DTDs cannot use it without 
manual changes to the DTD, please see: 
http://www.sagehill.net/docbookxsl/ValidXinclude.html. To overcome this 
shortage I suggest the use of Docbook 4.3 (or 4.5) - as a separate 
commit or implicitly with commit #2. As far as I have seen, all 
converted documents validate against 4.5.

Kind regards
Jürgen Purtz


-- 
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs