1DOCBOOK2GJOTS(1)            General Commands Manual           DOCBOOK2GJOTS(1)
2
3
4

NAME

6       docbook2gjots - Convert a DOCBOOK file to gjots format (on stdout)
7

SYNOPSIS

9       docbook2gjots [ DOCBOOK-file ]
10

DESCRIPTION

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

AUTHOR

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

SEE ALSO

58       gjots(1), gjots2html(1), gjots2docbook(1)
59
60
61
62                                                              DOCBOOK2GJOTS(1)
Impressum