gjots2docbook converts a gjotsfile into
DOCBOOK XML. gjots2docbook uses awk(1) to
perform the conversion. gjots2docbook does not create them
so the first element in the file should contain any
<bookinfo> or <artheader> element. Similarly,
<bibliographic> elements are not created. In fact the output
is very simplistic with item titles in the gjotsfile being
is very simplistic with item titles in the gjotsfile being
converted to chapter or section headings in DOCBOOK. There is no
reason why your gjotsfile should not contain valid DOCBOOK XML -
and that is why the -e and -p options are provided. If the file
does not start with <?xml ...> then appropriate lines will be
added as follows:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE doc_type PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN">
If properly installed, the docbook utilities can then be
used to create HTML, man, ps, pdf etc files eg:
It may be necessary to fine-tune the docbook formatting
to access all features.
OPTIONS
-a
makes a DOCBOOK article
-b
makes a DOCBOOK book
-e
don't encode special characters eg < -> <
-p
don't change blank lines to </para><para> markers
-P
first section is a preface rather than a chapter (book
only)
AUTHOR
Written by Bob Hepple <bhepple@freeshell.org>
http://bhepple.freeshell.org/gjots
COPYRIGHT
Copyright (c) 2002 Robert Hepple
This is free software; see the source for copying condiÂ
tions. There is NO warranty; not even for MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.