Converting your document

The configuration file that you have just created will serve as the new style sheet for your DocBook document. So basically everything you have to do is to instruct your XSLT processor to convert your document using this new style sheet. 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. If your web server is the same machine as your authoring station, you only have to move the result files to the appropriate directory, e.g.

mv *.html /usr/local/share/annotate

Note

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