Man Linux: Main Page and Category List

NAME

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

SYNOPSIS

       docbook2gjots [ DOCBOOK-file ]

DESCRIPTION

       docbook2gjots converts a DOCBOOK XML file into gjots format.

       docbook2gjots uses gawk(1) to perform the conversion.

       <preface>,  <chapter>, <section>, <sect1>, <sect2>, <sect3> and <sect4>
       tags are used to define NewEntry and NewFolder boundaries. They  should
       definitely have <title> tags.

       This  is  a  quick  and  dirty  hack  using  gawk(1) and does no formal
       checking of XML or SGML syntax nor does it validate against the DOCBOOK
       DTD.  Consequently,  if the syntax of the file is broken the conversion
       will probably fail.

       It is intended that a round-trip can be made so that  gjots(1)  can  be
       used  as  a  tool  at  all  stages of DOCBOOK production - mainly as an
       outline processor to help the author organise and order  the  work.   A
       document  may  well  start its life in gjots(1) as the initial thoughts
       are marshalled. As the document  forms  up,  it  can  be  converted  to
       DOCBOOK  with  the following command which automatically adds tags such
       as <?xml...>, <para> etc:

              gjots2docbook -b file.gjots >file.xml
              docbook2pdf file.xml

       Or, starting with an existing DOCBOOK file:

              docbook2gjots file.xml >file.gjots

       In the latter case, the document will already have  a  lot  of  DOCBOOK
       tags so to convert back to docbook, add the -e and -p options:

              gjots2docbook -b -p -e file.gjots >file.xml
              docbook2pdf file.xml

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 conditions.  There
       is  NO  warranty;  not  even  for  MERCHANTABILITY  or  FITNESS  FOR  A
       PARTICULAR PURPOSE.

SEE ALSO

       gjots(1), gjots2html(1), gjots2docbook(1)