| Use the DTD in devref-xml.20070412, this goes for all the source 
| documents, I will try to make this more explicit on the template 
| information page. Thanks for the feedback.

The DTD to use depends on which vocabulary the document uses, in this
document the 4.4 DTD was used (included in the tarball) because Docbook5 was
still in beta at the time. Since the DTDs are freely distributable it is a
good practice to keep the DTD you validated the source document against with
the document source, since docbook is not forward compatible across major
releases (obsolete tags get removed, etc).

...
| >    I'm thinking that the DevRef makefile needs to be 
| updated to track
| >    the current structure of the docbook package(s).  But 
| I'd like some
| >    confirmation that I'm on the right track before I spend 
| more time on
| >    this.  And which package should it be: docbook5-xsl or 
| docbook-xsl?

I can't find anything that says what the differences are, my guess is that
either should work.

The directory structure I had was set up like this:

docbook4.4/XSL/docbook/...    -- contents of docbook-xsl-1.70 tarball were
located here
docbook4.4/DTD/...            -- contents of DTD package from docbook web
site were here (docbookx.dtd was taken from here)
docbook4.4/XML/...            -- docbook 4.4 XML files
...

A bit customized for my preferences. :)

You'll need to hack up the Makefile to point to wherever the *xsl files are
after you unpack them. In the tarball they are under docbook-xsl-1.72.0/html
so if you unpack that under ~/docbook the Makefile would end up looking like
this:

DOCBOOK=/home/elowe/docbook/docbook-xsl-1.72.0
XSLT_DB2HTML=$(DOCBOOK)/html/docbook.xsl
XSLT_DB2IDXHTML=$(DOCBOOK)/html/chunk.xsl
...

- Eric

Reply via email to