This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: How to process a DocBook file on Debian? (fwd)
- From: Michael Schuerig <schuerig at acm dot org>
- To: Tom Peters <tom at tompth dot xs4all dot nl>,docbook-apps <docbook-apps at lists dot oasis-open dot org>
- Date: Mon, 23 Dec 2002 01:27:40 +0100
- Subject: Re: DOCBOOK-APPS: How to process a DocBook file on Debian? (fwd)
- Organization: -
- References: <Pine.LNX.4.44.0212190011210.13249-100000@tompth.localdomain.fake>
On Thursday 19 December 2002 00:11, Tom Peters wrote:
> Does anyone know a specific HOWTO deal with DocBook/XML on Debian
> Linux? The Oasis and docbook.org have plenty on how to write a
> docbook file, but are scarce on how to process it. There are plenty
> of references saying "use OpenJade" or whatever, but it is a
> nightmare of stuff that can't be found or can't be validated. I need
> something more specific. I want the thing printed, through RTF or
> PDF, using whatever stylesheets that work out of the Debian box.
> Note: I used to have it working with DocBook/SGMl about 2 years ago,
> but some of the tools have disappeared since so my makefile doesn't
> work anymore. So:
> - what tools do I need in what order?
> - what envars should I set and what should they contain?
> - what are the stylesheets and how do I get the tools to find them?
> Thanx,
I'm using docbook-website with xsltproc to build my web site.
$xsltproc stylesheet.xsl -nonet -catalogs dbfile.xml > dbfile.html
Debian keeps a centralized catalog, xsltproc finds it if the appropriate
env variable is set:
SGML_CATALOG_FILES=/etc/sgml/catalog
I set it in /etc/environment, but you may as well do it in the startup
file of your shell (then you also need to export it).
Recommended packages: xsltproc, docbook-xml, docbook-xsl, docbook-doc,
docbook-website, docbook-defguide
AFAIK, there's no direct and easy way to get a printable representation
of a docbook file. You can use xsl-stylesheets to generate FO output
and process that in turn with fop (package lib-fop-java).
Alternatively, there's the package docbook-utils that contains
converters from docbook to pdf, ps, rtf and various other formats.
docbook-utils uses dsssl-stylesheets, though, so I can't say if this is
of help to you. I have tried neither and can't say if/how they work.
Michael
--
Michael Schuerig If at first you don't succeed...
mailto:schuerig@acm.org try, try again.
http://www.schuerig.de/michael/ --Jerome Morrow, "Gattaca"