DocBook is an
XML/SGML vocabulary particularly well suited to books and papers about
computer hardware and software. xsltproc and libxslt are not specifically dependant on DocBook, but since
a lot of people use xsltproc and libxml2 for DocBook formatting, here are a
few pointers and information which may be helpful: Do not use the --docbook option of xsltproc to process XML DocBook
documents, this option is only intended to provide some (limited) support of
the SGML version of DocBook. Points which are not DocBook specific but still worth mentionning
again: - if you think DocBook processing time is too slow, make sure you have
XML Catalogs pointing to a local installation of the DTD of DocBook.
Check the XML Catalog page
to understand more on this subject.
- before processing a new document, use the command
xmllint --valid --noout path_to_document
to make sure that your input is valid DocBook. And fixes the errors
before processing further. Note that XSLT processing may work correctly
with some forms of validity errors left, but in general it can give
troubles on output.
Daniel Veillard |