Converting your document

The configuration file that you have just created on the authoring station will serve as the new XSLT style sheet for your DocBook document. So basically everything you have to do is to instruct your XSLT processor to convert your DocBook 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. Annotate's CGI part expects them in the directory you configured as its document root there. If your web server is the same machine as your authoring station, you only have to move the result files to the appropriate directory, for example:

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.