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

NAME

6       gjots2docbook - Convert a gjotsfile to DOCBOOK (on stdout)
7

SYNOPSIS

9       gjots2docbook -a|-b [ -e ] [ -P ] [ -p ] [ gjotsfile ]
10

DESCRIPTION

12       gjots2docbook converts a gjotsfile into DOCBOOK XML.
13
14       gjots2docbook uses awk(1) to perform the conversion.
15
16       gjots2docbook  does  not  create  them so the first element in the file
17       should contain any <bookinfo> or <artheader> element. Similarly,  <bib‐
18       liographic>  elements  are not created. In fact the output is very sim‐
19       plistic with item titles in the gjotsfile being converted to chapter or
20       section  headings  in  DOCBOOK.  There  is no reason why your gjotsfile
21       should not contain valid DOCBOOK XML - and that is why the  -e  and  -p
22       options are provided.
23
24       If  the file does not start with <?xml ...> then appropriate lines will
25       be added as follows:
26
27              <?xml version="1.0" encoding="UTF-8"?>
28              <!DOCTYPE doc_type PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN">
29
30       If properly installed, the docbook utilities can then be used to create
31       HTML, man, ps, pdf etc files eg:
32
33              gjots2docbook -b ~/.gjotsfile >gjotsfile.xml
34              docbook2pdf gjotsfile.xml
35
36       It  may  be necessary to fine-tune the docbook formatting to access all
37       features.
38

OPTIONS

40       -a     makes a DOCBOOK article
41
42       -b     makes a DOCBOOK book
43
44       -e     don't encode special characters eg < -> &lt;
45
46       -p     don't change blank lines to </para><para> markers
47
48       -P     first section is a preface rather than a chapter (book only)
49

AUTHOR

51       Written by Bob Hepple <bhepple@freeshell.org>
52
53       http://bhepple.freeshell.org/gjots
54

56       Copyright (c) 2002 Robert Hepple
57       This  is  free software; see the source for copying condi tions.  There
58       is  NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICU‐
59       LAR PURPOSE.
60

SEE ALSO

62       gjots(1), gjots2html(1), docbook2gjots(1)
63
64
65
66                                                              GJOTS2DOCBOOK(1)
Impressum