Converting your document

The configuration file that you have just created will serve as the new stylesheet for your DocBook document. So basically everything you have to do is to instruct your XSLT processor to convert your document using this new stylesheet. Here are some examples how to do this:

Example 1.2. Converting a document with xsltproc

xsltproc /usr/local/etc/annotate.conf example.xml

Example 1.3. Converting a document with Saxon

java -jar saxon.jar /usr/local/etc/annotate.conf example.xml

Note

The file saxon.jar must be in your CLASSPATH.

The output of the XSLT processor is one or several HTML files, depending on whether you chose to produce chunked output or not. These HTML files now have to be moved to the web server. The CGI part expects them in the directory you configured as the document root.

Note

Although the concept is the same, the DocumentRoot of Annotate is probably a different directory than the DocumentRoot of your web server.