File: README

package info (click to toggle)
debiandoc2dbxml 0.2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k, lenny
  • size: 104 kB
  • ctags: 12
  • sloc: xml: 386; sh: 218; makefile: 66
file content (44 lines) | stat: -rw-r--r-- 1,406 bytes parent folder | download | duplicates (2)
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