X-Original-To: pgsql-hackers-postgresql.org@localhost.postgresql.org Received: from localhost (unknown [200.46.204.2]) by svr1.postgresql.org (Postfix) with ESMTP id 2CBCDD1B4F9 for ; Fri, 14 Nov 2003 08:27:03 +0000 (GMT) Received: from svr1.postgresql.org ([200.46.204.71]) by localhost (neptune.hub.org [200.46.204.2]) (amavisd-new, port 10024) with ESMTP id 38130-05 for ; Fri, 14 Nov 2003 04:26:33 -0400 (AST) Received: from ara.zf.jcu.cz (ara.zf.jcu.cz [160.217.161.4]) by svr1.postgresql.org (Postfix) with ESMTP id 52AD1D1B4E4 for ; Fri, 14 Nov 2003 04:26:30 -0400 (AST) Received: by ara.zf.jcu.cz (Postfix, from userid 5770) id 028F7985B; Fri, 14 Nov 2003 09:26:20 +0100 (CET) Date: Fri, 14 Nov 2003 09:26:19 +0100 From: Karel Zak To: pgsql-hackers Subject: XML Docbook Message-ID: <20031114082619.GA25147@zf.jcu.cz> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.28i X-Virus-Scanned: by amavisd-new at postgresql.org X-Archive-Number: 200311/753 X-Sequence-Number: 47041 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 http://home.zf.jcu.cz/~zakkr/