Re: ITP: docbook-website -- DocBook XML Website

[Mark Johnson <mark@phy.duke.edu>]

Adam Di Carlo writes:
> Mark Johnson <mark@phy.duke.edu> writes:
> 
> > The Website Doctype contains an XML DTD & XSL stylesheets for building
> > web sites.
> 
> BTW, what are the (preferred, in Debian) sequence of commands to build
> the XML document into HTML ?  

There aren't any. Yet.

> Is this toolchain yet in the system?

No. But I do know what works. 

Here's one setup: 

1. A java2 jre

2. An XSLT processor (Saxon; Norm is dumping XT support.)

3. Additional classes to provide catalog support.

4. Wrapper scripts for easy processing

 
As proof-of-concept, I kludged together a package containing
#2-#4. It's named "docbook-saxon-xsl". Someone should test it so they
see how the pieces are put together. Here's how:

* add "deb http://dulug.duke.edu/~mark/debian ./" to sources.list

* apt-get install docbook-website docbook-saxon-xsl (+see Note)

* cp -r /usr/share/doc/docbook-website/example ./

* cd example

* website2html website.xml

(+Note: docbook-saxon-xsl depends on j2re1.3, which is 13MB. If you
  already have a java2 jre, install the "recommends" version in
  "http://dulug.duke.edu/~mark/debian/old/";)

Package Composition:
The docbook-saxon-xsl package puts three jars in /usr/share/java:

 - crimson.jar (sun's parser)
 - kozek.jar (catalog classes--extensions to Norm's classes)
 - saxon602.jar (XSLT processor)

and has a bash wrapper script, "saxchunk"

This should probably be split into 3 or 4 packages:
-lib-saxon-java
-lib-crimson-java
-lib-kozek-java
-docbook-xsl-tools

(I made a similar package based on XT, called docbook-xsl-tools.)

For the DocBook XML stuff to be out-of-the-box useful, somebody's
gotta make these kinds of packages. Suggestions?

my $0.02,
Mark
> 
> -- 
> .....Adam Di Carlo....adam@onShore.com.....<URL:http://www.onShore.com/>