Skip to content

Editing sourcedoc.xml files

ghalliday edited this page Aug 4, 2011 · 3 revisions

This is the batch file I use for compiling sourcedoc.xml into HTML for checking:

libxslt\bin\xsltproc.exe  --novalid --nonet --xinclude c:\docbook\xsl\html\chunk.xsl %1

To select the output directory include -o \dummyfile e.g.,

-o c:\build\docbook\dummy

You need to get hold of the following (or equivalent) to run xsltproc:

  • docbook-xsl-1.76.1.zip

  • iconv-1.9.2.win32.zip

  • libxml2-2.7.7.win32.zip

  • libxslt-1.1.26.win32.zip

  • zlib-1.2.5.win32.zip

You should be able to get them from http://sourceforge.net/projects/docbook/files/ and ftp://xmlsoft.org/libxml2/win32/

There are some instructions at http://www.iamcal.com/docbook-to-html/ that may be useful.

To resolve the problems with the DTD do the following:

Download docbook-xml-4.3.zip

Edit the catalog.xml file in your docbook-xsl-1.76.1 directory to include the following lines:

<rewriteURI uriStartString="http://www.oasis-open.org/docbook/xml/4.3/" rewritePrefix="file:///<path-to-dtd>/"/>
<rewriteSystem systemIdStartString="http://www.oasis-open.org/docbook/xml/4.3/" rewritePrefix="file:///<path-to-dtd>/"/>

Set the XML_CATALOG_FILES environment variable to point at the catalog file. E.g.,

XML_CATALOG_FILES=c:\docbook\docbook-xsl-1.76.1\catalog.xml