Getting to grips with docbook

Jonathan Belson jon at witchspace.com
Sun Sep 23 20:13:23 BST 2001


Hiya


I've spent a couple of hours trying to get the hang of
DocBook but I haven't had much success.  I've checked
out the fdp-primer, the oreilly docbook manual and a
few online resources but I have yet to find a simple
example I can actually get to work (ie. convert into
other formats).

I found this piece off the 'net:

/home/jon/docs# cat test.sgml
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN">
 <book>
   <bookinfo>
     <title>An Example DocBook Document.</title>
   </bookinfo>
   <chapter>
     <title>First Chapter</title>
      <para>
        This is the first chapter of my new policy manual.
      </para>
     <sect1>
       <title>Which policy</title>
        <para>
         This is the first section in my new policy manual.
 </para>
      </sect1>
   </chapter>
 </book>


I try on convert it to rtf as suggested by the
dsssl-docbook-modular-1.71 installer and get the
following splurge:

/home/jon/docs# jade -t rtf -d $DBPATH/html/docbook.dsl  test.sgml
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:54:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-amsa.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:61:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-amsb.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:68:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-amsc.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:75:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-amsn.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:82:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-amso.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:89:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-amsr.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:96:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-box.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:103:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-cyr1.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:110:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-cyr2.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:117:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-dia.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:124:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-grk1.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:131:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-grk2.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:138:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-grk3.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:145:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-grk4.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:152:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-lat1.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:159:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-lat2.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:166:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-num.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:173:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-pub.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/4.1/dbcent.mod:180:0:E: cannot open
"/usr/local/share/sgml/docbook/4.1/iso-tech.gml" (No such file or
directory)
jade:/usr/local/share/sgml/docbook/dsssl/modular/html/../common/dbl1no.dsl:3:0:E:
cannot open "/usr/local/share/sgml/docbook/4.1/iso-lat1.gml" (No such
file or directory)
jade:/usr/local/share/sgml/docbook/dsssl/modular/html/../common/dbl1ro.dsl:3:0:E:
cannot open "/usr/local/share/sgml/docbook/4.1/iso-lat1.gml" (No such
file or directory)
jade:/usr/local/share/sgml/docbook/dsssl/modular/html/../common/dbl1ro.dsl:5:0:E:
cannot open "/usr/local/share/sgml/docbook/4.1/iso-lat2.gml" (No such
file or directory)
jade:/usr/local/share/sgml/docbook/dsssl/modular/html/../common/dbl1ru.dsl:3:0:E:
cannot open "/usr/local/share/sgml/docbook/4.1/iso-cyr1.gml" (No such
file or directory)
jade:/usr/local/share/sgml/docbook/dsssl/modular/html/../common/dbl1sl.dsl:3:0:E:
cannot open "/usr/local/share/sgml/docbook/4.1/iso-lat2.gml" (No such
file or directory)
jade:/usr/local/share/sgml/docbook/dsssl/modular/html/../common/dbl1sr.dsl:3:0:E:
cannot open "/usr/local/share/sgml/docbook/4.1/iso-lat2.gml" (No such
file or directory)


To save me more stress, can some kind soul point me
to a simple 'hello world' type example of DocBook
file with instructions on how to convert it into eg.
html?

Thanks,


--
C-YA
Jon

<http://www.witchspace.com>




More information about the Ukfreebsd mailing list