docbook

Marcel Kunath kunathma@pilot.msu.edu
Sat, 10 Mar 2001 20:50:37 -0500 (EST)


Nevewrmind, I think.

Seems like SuSe put the tools somewhere else or I just didn't find them until
now.

docbook-tools. They are in /usr/bin/db2*

mk

>
> I am still struggling on this. I just want a test case going but I can't make
> it happen.
>
> sgml2html test.sgm
> Processing file test.sgm
> /usr/bin/nsgmls:<OSFD>0:1:54:W: cannot generate system identifier for public
> text "-//OASIS//DTD DocBook V3.1//EN"
> /usr/bin/nsgmls:<OSFD>0:1:54:E: reference to entity "BOOK" for which no system

> identifier could be generated
> /usr/bin/nsgmls:<OSFD>0:1:0: entity was defined here
> /usr/bin/nsgmls:<OSFD>0:1:54:E: DTD did not contain element declaration for
> document type name
> /usr/bin/nsgmls:<OSFD>0:2:5:E: element "BOOK" undefined
> /usr/bin/nsgmls:<OSFD>0:3:6:E: element "TITLE" undefined
> /usr/bin/nsgmls:<OSFD>0:4:12:E: element "TITLEABBREV" undefined
> /usr/bin/nsgmls:<OSFD>0:5:9:E: element "BOOKINFO" undefined
> /usr/bin/nsgmls:<OSFD>0:6:12:E: element "LEGALNOTICE" undefined
> /usr/bin/nsgmls:<OSFD>0:6:18:E: element "PARA" undefined
> /usr/bin/nsgmls:<OSFD>0:7:7:E: element "AUTHOR" undefined
> /usr/bin/nsgmls:<OSFD>0:7:18:E: element "FIRSTNAME" undefined
> /usr/bin/nsgmls:<OSFD>0:7:36:E: element "SURNAME" undefined
> /usr/bin/nsgmls:<OSFD>0:9:11:E: element "DEDICATION" undefined
> /usr/bin/nsgmls:<OSFD>0:10:5:E: element "PARA" undefined
> /usr/bin/nsgmls:<OSFD>0:14:8:E: element "PREFACE" undefined
> /usr/bin/nsgmls:<OSFD>0:14:15:E: element "TITLE" undefined
> /usr/bin/nsgmls:<OSFD>0:15:5:E: element "PARA" undefined
> /usr/bin/nsgmls:<OSFD>0:19:8:E: element "CHAPTER" undefined
> /usr/bin/nsgmls:<OSFD>0:19:15:E: element "TITLE" undefined
> /usr/bin/nsgmls:<OSFD>0:20:5:E: element "PARA" undefined
> /usr/bin/nsgmls:<OSFD>0:24:9:E: element "APPENDIX" undefined
> /usr/bin/nsgmls:<OSFD>0:24:16:E: element "TITLE" undefined
> /usr/bin/nsgmls:<OSFD>0:25:5:E: element "PARA" undefined
> /usr/bin/sgmlsasp: can't open `/usr/lib/sgml-tools/dist/book/html/mapping': No

> such file or directory
>
>
> Content of file:
>
> <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
> <book>
> <title>An Example Book</title>
> <titleabbrev>Example</titleabbrev>
> <bookinfo>
> <legalnotice><para>No notice is required.</para></legalnotice>
> <author><firstname>Norman</><surname>Walsh</></author>
> </bookinfo>
> <dedication>
> <para>
> This book is dedicated to you.
> </para>
> </dedication>
> <preface><title>Forword</title>
> <para>
> Some content is always required.
> </para>
> </preface>
> <chapter><title>Required Chapter</title>
> <para>
> At least one chapter, reference, part, or article is required in a book.
> </para>
> </chapter>
> <appendix><title>Optional Appendix</title>
> <para>
> Appendixes are optional.
> </para>
> </appendix>
> </book>
>
>
>
> Then I found this thread:
>
> http://linuxchix.devin.com/techwriters/1999-Sep/0053.html
>
> But that doesn'
> t work for me either. It keeps telling me stuff is undefined.
>
> For docbook being used for documentation it sure has a lack of hands on
> examples of how to use it right. =)
>
> mk
>
> > > On Wed, Mar 07, 2001 at 12:39:42PM -0500,
> Marcel Kunath wrote:
> > > There is a lot of stuff out there but there isn't a great introduction on
ho
> w
> > > to use docbook properly. I read the o'reilly book but even its examples
> > > wouldn't work for me. if anybody can point me to some simple examples whic
h
> > > work I'd appreciate it.
> > >
> > > Ok I got file with this in it:
> > >
> > > <!DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V3.1//EN">
> > >        <chapter><title>Test Chapter</title>
> >
> > I don't think "chapter" is a valid DocBook DOCTYPE.  IIRC, you have
> > a choice of "book" or "article".  If you want to separate chapters
> > into their own files, you have to include them in the book/article
> > somehow, but you can't have the <!DOCTYPE> line in there.
> >
> > For example, here's part of one of my SGML files:
> >
> > <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
> > <!ENTITY overview SYSTEM "overview.sgml">
> > <!ENTITY hardware SYSTEM "hardware.sgml">
> > ]>
> >
> > <book>
> >
> > <!-- stuff in here removed -->
> >
> > &overview;
> > &hardware;
> >
> > </book>
> >
> > There are a couple of ways to include files, this just happens to
> > be the one I chose at the time for reasons I have forgotten.
> > Basically you create an ENTITY called overview, which exists in
> > the SYSTEM as a file called "overview.sgml".  You include that
> > entity with &overview; in the body of your SGML doc.
> >
> > The first line of "overview.sgml" is "<chapter>" and the file ends
> > with "</chapter>".
> >
> > --
> > Edward Glowacki            glowack2@msu.edu
> > Michigan State University
> > _______________________________________________
> > linux-user mailing list
> > linux-user@egr.msu.edu
> > http://www.egr.msu.edu/mailman/listinfo/linux-user
> >
>
>
> --
> Marcel Kunath
>
> *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
>
>  Montie House Network            Greater Lansing Linux Users Group
>   http://www.montiehouse.com      http://www.gllug.org
>
> *-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*
>


--
Marcel Kunath

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*

 Montie House Network            Greater Lansing Linux Users Group
  http://www.montiehouse.com      http://www.gllug.org

*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*