1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44
|
The Debian Package debiandoc2dbxml
----------------------------------
The script "debiandoc2dbxml" translates a sgml file written according
to the debiandoc dtd to an xml file following the docbook-xml dtd
(docbook/dtd/xml/4.2/docbookx.dtd)
You need sgml2xml, part of package sp, and xsltproc, which is now a
package in itself.
The files are:
debiandoc-tidy
debiandoc2dbxml
debiandoc-xml.dtd
book.xml
split.xml
dd2xml.html
catalog
README (this file).
How to use these scripts ?
You must first "normalize" the main sgml file and every file that it loads
(but not sgml files referenced by entities); you can do:
debiandoc-tidy [options] file.sgml
The main option, -e, sets the coding system if needed.
Then you can choose the book element with the -b option
or the article element with the -a option.
When the main sgml file declares an internal subset of the dtd, you must
use the -s option on the command line:
"debiandoc2dbxml -b -s file.sgml" gives you "file.xml" that you can
print with jade and jadetex.
When you choose the -S option, the script creates "main.xml" and
xml files from each bookinfo, chapter and appendix.
Some human polishing remains to be done to get a correctly printed text.
See /usr/share/doc/debiandoc2dbxml/dd2xml.html.
See the manpages debiandoc2dbxml (1) and debiandoc-tidy (1).
Philippe Batailler
<philippe.batailler@free.fr>, Mon, 7 Apr 2003 00:45:56 +0200
|