docbook

[Marcel Kunath]

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

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