public inbox for [email protected]  

help / color / mirror / Atom feed

From: Alexander Law <[email protected]>
To: Peter Eisentraut <[email protected]>
To: [email protected]
To: Alvaro Herrera <[email protected]>
To: Alexander Lakhin <[email protected]>
Cc: Jürgen Purtz <[email protected]>
Cc: [email protected]
Subject: Re: Docbook 5.x
Date: Wed, 16 Nov 2016 14:30:32 +0300
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]>
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



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


Attachments:

  [application/x-bzip] pg-doc.check.tar.bz2 (20.7K, 2-pg-doc.check.tar.bz2)
  download

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], [email protected], [email protected], [email protected], [email protected], [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