public inbox for [email protected]  

help / color / mirror / Atom feed

From: Jürgen Purtz <[email protected]>
To: [email protected]
Subject: Re: Docbook 5.x
Date: Wed, 16 Nov 2016 19:40:33 +0500
Message-ID: <[email protected]> (raw)
In-Reply-To: <[email protected]>
References: <[email protected]>
	<[email protected]>
	<CAF4Au4zUVOuWjWc+B72yvvpVo=TJad6=x9chig7Ls9DNa7Kgrg@mail.gmail.com>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
	<[email protected]>
List-Unsubscribe: <mailto:[email protected]?body=unsub%20pgsql-docs>


> 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 ([email protected])
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs

view thread (86+ messages)  latest in thread

reply

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Reply to all the recipients using the --to and --cc options:
  reply via email

  To: [email protected]
  Cc: [email protected]
  Subject: Re: Docbook 5.x
  In-Reply-To: <[email protected]>

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

This inbox is served by agora; see mirroring instructions
for how to clone and mirror all data and code used for this inbox