public inbox for [email protected]
help / color / mirror / Atom feedFrom: Karel Zak <[email protected]>
To: pgsql-hackers <[email protected]>
Subject: XML Docbook
Date: Fri, 14 Nov 2003 09:26:19 +0100
Message-ID: <[email protected]> (raw)
Hi,
what use pure XML Docbook (non-SGML) for 7.5 PostgreSQL docs?
XML advantage:
- more clean and simple conversion into printable
formats by FO (Formatting Objects),
- needn't huge TeX stuff (!),
- Java based XSLT/FO processors like FOP (support PDF, PCL, PS, SVG, Print,
AWT, MIF and TXT),
- conversion to HTML/MAN/etc by xsltproc,
- XML based reference docs is usable for example in clients programs as
standard help, because integrate XML parser into program is more simple and
usual than SGML parser.
I think the current docs build system is usable for normal user only if he wants
to generate HTML docs, but for example it's useless if he wants PDF output...
For example you can compare our current doc/src/sgml/Makefile with following
code for XML conversion:
pdf:
fop -xsl /path/to/stylesheet/xsl/fo/docbook.xsl -xml book.xml -pdf book.pdf
ps:
fop -xsl /path/to/stylesheet/xsl/fo/docbook.xsl -xml book.xml -ps book.ps
html:
xsltproc -o htmldir/ /path/to/stylesheet/html/chunk.xsl book.xml
man:
xsltproc /path/to/stylesheet/manpages/docbook.xsl ref.xml
Comments?
Karel
--
Karel Zak <[email protected]>
http://home.zf.jcu.cz/~zakkr/
view thread (10+ 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]
Subject: Re: XML Docbook
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