docbook2htmlbook

This script converts DocBook XML to HTMLBook.

It's written in XSLT 2.0, so you'll need to run it with an XSLT 2.0 processor.

Running the Script

Run these commands to output the HTMLBook:

java -jar saxon-he-12.5.jar -s:book.xml -o:book.xml -catalog:dtd_catalog.xml unwrapblocks.xsl java -jar saxon-he-12.5.jar -s:book.xml -o:book.xml -catalog:dtd_catalog.xml docbook2htmlbook.xsl

If you're starting with DocBook 5, run the DB 5 to DB 4 converter first:

java -jar saxon-h1-12.5.jar -s:book.xml -o:book.xml -catalog:dtd_catalog.xml db5to4.xsl java -jar saxon-h1-12.5.jar -s:book.xml -o:book.xml -catalog:dtd_catalog.xml unwrapblocks.xsl java -jar saxon-h1-12.5.jar -s:book.xml -o:book.html -catalog:dtd_catalog.xml docbook2htmlbook.xsl

NOTE: Because the external DTD hosted at oasis-open.org is not always reliably available, please use the -catalog: option, referencing the included catalog file that points to a local copy of the DTD.

Optional parameters

• Output xref label text by running conversion with parameter xref_label set to true. For example: java -jar saxon9he.jar -s book.xml -o book.asc docbook2htmlbook.xsl xref_label=true

Validating the Output

You can validate the output against the HTMLBook Schema, found here.