Re: Docbook 5.x
От | Jürgen Purtz |
---|---|
Тема | Re: Docbook 5.x |
Дата | |
Msg-id | 5728F9CC.7050402@purtz.de обсуждение исходный текст |
Ответ на | Re: Docbook 5.x (Simon Riggs <simon@2ndQuadrant.com>) |
Список | pgsql-docs |
Hello,
the conversion of PostgreSQL documentation from Docbook 4.x to 5.x consists of the following steps:
the conversion of PostgreSQL documentation from Docbook 4.x to 5.x consists of the following steps:
- pure sgml --> xml conversion (done, Perl script)
- 4.x markup --> 5.x markup (done, Docbook standard migration script)
- post-processing of 5.x files (done, Perl: xi:include, entities, ...)
- generate the complete file postgres_all.xml with xmllint (done)
- generate online documentation (html, man, text)
- generate print documentation (rtf, pdf)
- adopt Makefile to the new situation
- a lot of unknown xref targets, as the target exists in a different file
- 4 remaining sgml-entities: standalone-xxx and include-xxx
- some markups, which are not valid in 5.x, mostly with <synopsis> and <function>. This must be resolved manually (5.x offers comprehensive possibilities for very detailed markups with <funcsynopsis> and <cmdsynopsis>)
- Is our file stylesheet.dsl written from scratch - or is it derived from any docbook 1/2/3/4.x generic stylesheet?
- Which person has developed this file?
- What is the role of the *.xsl files in the sgml-directory and how do they collaborate with stylesheet.dsl?
On 20.04.2016 20:41, Simon Riggs wrote:
On 20 April 2016 at 15:30, Jürgen Purtz <juergen@purtz.de> wrote:--What I have done so far is:
- Conversion of sgml files to valid xml syntax with a perl skript. I failed to use 'osx' or 'spam'.
- Conversion of these xml files to Docbook5.x format using xsltproc and Docbooks xslt-migration skripts.
- Creation of html files using xsltproc and Docbooks xslt skripts.
- Creation of fo files using xsltproc and Docbooks xslt skripts.
- Creation of pdf files using fop.
- The conversions needs less than 10 minutes on a Intel i5 processor.
So you believe you have/can convert between the two formats accurately, so we can change things in a single commit?What verification is offered? Possible?And that is ready to go now? Will you post your perl script, or the patch? Other projects use the same file formats, e.g. Slony, XL etcIf an automatic migration is possible do we need to change at all?Simon Riggs http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
В списке pgsql-docs по дате отправления: