1DOCBOOK2GJOTS(1) General Commands Manual DOCBOOK2GJOTS(1)
2
3
4
6 docbook2gjots - Convert a DOCBOOK file to gjots format (on stdout)
7
9 docbook2gjots [ DOCBOOK-file ]
10
12 docbook2gjots converts a DOCBOOK XML file into gjots format.
13
14 docbook2gjots uses gawk(1) to perform the conversion.
15
16 <preface>, <chapter>, <section>, <sect1>, <sect2>, <sect3> and <sect4>
17 tags are used to define NewEntry and NewFolder boundaries. They should
18 definitely have <title> tags.
19
20 This is a quick and dirty hack using gawk(1) and does no formal check‐
21 ing of XML or SGML syntax nor does it validate against the DOCBOOK DTD.
22 Consequently, if the syntax of the file is broken the conversion will
23 probably fail.
24
25 It is intended that a round-trip can be made so that gjots(1) can be
26 used as a tool at all stages of DOCBOOK production - mainly as an out‐
27 line processor to help the author organise and order the work. A docu‐
28 ment may well start its life in gjots(1) as the initial thoughts are
29 marshalled. As the document forms up, it can be converted to DOCBOOK
30 with the following command which automatically adds tags such as
31 <?xml...>, <para> etc:
32
33 gjots2docbook -b file.gjots >file.xml
34 docbook2pdf file.xml
35
36 Or, starting with an existing DOCBOOK file:
37
38 docbook2gjots file.xml >file.gjots
39
40 In the latter case, the document will already have a lot of DOCBOOK
41 tags so to convert back to docbook, add the -e and -p options:
42
43 gjots2docbook -b -p -e file.gjots >file.xml
44 docbook2pdf file.xml
45
47 Written by Bob Hepple <bhepple@freeshell.org>
48
49 http://bhepple.freeshell.org/gjots
50
52 Copyright (c) 2002 Robert Hepple
53 This is free software; see the source for copying condi tions. There
54 is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICU‐
55 LAR PURPOSE.
56
58 gjots(1), gjots2html(1), gjots2docbook(1)
59
60
61
62 DOCBOOK2GJOTS(1)