docbook

[Marcel Kunath]

There is a lot of stuff out there but there isn't a great introduction on how
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>
       <para>
       This is a paragraph in the test chapter. It is unremarkable in
       every regard. This is a paragraph in the test chapter. It is
       unremarkable in every regard. This is a paragraph in the test
       chapter. It is unremarkable in every regard.
       </para>
       <para>
       <emphasis role=bold>This</emphasis> paragraph contains
       <emphasis>some <emphasis>emphasized</emphasis> text</emphasis>
       and a <superscript>super</superscript>script
       and a <subscript>sub</subscript>script.
       </para>
       <para>
       This is a paragraph in the test chapter. It is unremarkable in
       every regard. This is a paragraph in the test chapter. It is
       unremarkable in every regard. This is a paragraph in the test
       chapter. It is unremarkable in every regard.
       </para>
       </chapter>

I do:

nsgmls -sv -c /usr/share/sgml/CATALOG.docbk31 test.sgm
nsgmls:I: SP version "1.3.4"
nsgmls:/usr/share/sgml/CATALOG.docbk31:24:0:W: DTDDECL catalog entries are
not supported

What is this error message?

Then I do this:

jade -t sgml -d
/usr/share/sgml/Norman_Walsh/document/DocBook_HTML_Stylesheet -i html
test.sgm

and it just starts racing error output.


mk

> >
Tools you need:
> > * DocBook DTDs (v4.1 is newest) http://www.oasis-open.org/docbook/docbook/
> * Norm Walsh's DocBook DSSSLs  http://nwalsh.com/docbook/
> * SGMLTools-Lite http://sourceforge.net/projects/sgmltools-lite/
> SGMLTools-Lite will depend upon Python, as well as a few other helper
> programs.
>
>
> The DTDs define the official tags for DocBook.  You can add tags, but
> then it won't be DocBook.  Norm Walsh's DocBook DSSSL provides nice
> looking default appearances for the tags, as well as some ability to
> configure the actions.  DSSSL files are written in Scheme, so you can
> do just about anything with them.  SGMLTools-Lite (make sure to get at
> least v2) is the tool that binds everything together.  It takes your
> sgml file, the dtd, and the dsssl and produces the final output.
>
>
> On Sun, Feb 25, 2001 at 09:35:37AM -0500, Marcel Kunath wrote:
> > I listened in on Ed's docbook experience and was curious so I did
> > some searching and reading myself. Ed basically announced it as easy
> > to use simple to set up tool. What tools do I exactly need and does
> > it really keep me from having to code any structures/stiles or tags?
> >
>
> --
>      Dan Nguyen     |  It was the best of times, it was the worst
>   nguyend7@msu.edu  |  of times, it was the age of wisdom, it was
>    dnn@debian.org   |  the age of foolishness.  -Charles Dickens
> _______________________________________________
> 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

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