Re: DocBook

[Michael Mueller <mmueller@ss7box.com>]

On Monday 24 February 2003 18:28, Mike M wrote:
> On Monday 24 February 2003 15:45, David Z Maze wrote:
> > Mike M <linux-support@earthlink.net> writes:
> > > I want to restart my DocBook efforts.  I have SGML source and want
> > > to produce HTML and PDF docs
> > >
> > > Should I start by installing these packages: docbook, docbook-dsssl?
> >
> > That's probably a good start; you also need a DSSSL processor (jade
> > and jadetex seem to be ~canonical).  Then you can run
> >
> >   jade -t tex foo.sgml   # foo.sgml + foo.dsl -> foo.tex
> >   jadetex foo            # foo.tex -> foo.dvi
> >   dvips foo -o           # foo.dvi -> foo.ps
> >   pdfjadetex foo         # foo.tex -> foo.pdf
>
> Thanks.
>
> > Alternatively, if you're in an XML world, you can use an XSLT
> > processor (like xsltproc) and libfop-java to get PDF out.  But that
> > has Java dependencies, is strictly XML, and the Debian dependencies
> > never seemed quite right to me.
>
> I'm interested in XML but I want to tackle that as a "part 2" effort.

Maybe this will turn up on a Google for "docbook debian".

Here's what worked for me on Debian 3.0:

as root:
apt-get install docbook
apt-get install docbook-dsssl
apt-get install sp
apt-get install openjade

as user:
$ export SGML_CATALOG_FILES=\
"/usr/share/sgml/OpenJade/catalog:/usr/share/sgml/entities/sgml-iso-entities-8879.1986/catalog"

$ openjade \
-d /usr/share/sgml/docbook/stylesheet/dsssl/modular/html/docbook.dsl \
-t sgml \
test.sgml

Where test.sgml is a simple sgml source file taken from here:
http://www-106.ibm.com/developerworks/library/l-docbk.html#h5

TDG gave excellent clues about where to find the style sheets. 
http://www.oasis-open.org/docbook/documentation/reference/html/appa.html

I got the style sheets (docbook-dsssl) directly from Sourceforge and unpacked 
them in my user dir.  Then I became aware of what apt-get install 
docbook-dsssl had done (duh).
http://sourceforge.net/projects/docbook/

TDG was pretty good about mentioning that I needed to define the environment 
variable SGML_CATALOG_FILES.  I used trial/error method to find the catalogs 
that helped.

I am now able to regenerate my DocBook source into HTML.  SGML, XML, and 
DSSSL are now FM instead of PFM.
-- 
Mike Mueller