Your company here — click to reach over 10,000 unique daily visitors

gjots2docbook - Man Page

Convert a gjotsfile to DOCBOOK (on stdout)


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


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 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:

gjots2docbook -b ~/.gjotsfile >gjotsfile.xml
docbook2pdf gjotsfile.xml

It may be necessary to fine-tune the docbook formatting to access all features.



makes a DOCBOOK article


makes a DOCBOOK book


don't encode special characters eg < -> &lt;


don't change blank lines to </para><para> markers


first section is a preface rather than a chapter (book only)


Written by Bob Hepple <bhepple@freeshell.org>


See Also

gjots(1), gjots2html(1), docbook2gjots(1)

Referenced By

docbook2gjots(1), gjots2(1), gjots2html(1).