From: Peter Eisentraut <peter_e@gmx.net>
To: pgsql-docs <pgsql-docs@postgresql.org>
Subject: moving documentation to XML
Date: Tue, 21 May 2013 23:38:01 -0400
Message-ID: <519C3D99.9000304@gmx.net> (raw)
List-Unsubscribe: <mailto:majordomo@postgresql.org?body=unsub%20pgsql-docs>
For 9.4, I would like to tackle moving our documentation to a DocBook
XML source format and tool chain. The issues surrounding that have been
summarized on this wiki page:
<https://wiki.postgresql.org/wiki/Switching_PostgreSQL_documentation_from_SGML_to_XML;.
Most of these points have become no-brainers by now. The one remaining
major issue is that the XSLT HTML build is very very slow compared to
what we currently have. So the first step will be to address that. I
have a few ideas that I'll try, and I might also solicit some help from
DocBook-related forums. Anyone who wants to help, it's very easy to get
started. In doc/src/sgml, run
make html
vs
make xslthtml
and make the latter as fast as the former. Currently, I'm timing this
at about 1 minute versus about 11 minutes, which is clearly unacceptable.
If or when that gets fixed, the next steps would be
- use XSLT as primary method for building HTML (dump DSSSL style sheets)
- use FOP as primary method for building PDF (additional issues to solve
there)
- convert source to XML
--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs
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: pgsql-docs@postgresql.org
Cc: peter_e@gmx.net
Subject: Re: moving documentation to XML
In-Reply-To: <519C3D99.9000304@gmx.net>
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
This inbox is served by DDX for PostgreSQL; see mirroring instructions
for how to clone and mirror all data and code used for this inbox