Chapter 4. Converting The Source

Once the DocBook-XML document has been written (at least in a first draft) it usually should be converted to some destination format. There are many ways to do this but in the scope of this document it will be accomplished by using the DocBook-toys.

There are (currently) some destination formats where the conversion does not succeed. Even in those cases that do lead to a successfully converted document some error messages from jade may be shown in the respective command line window. At the moment I don't know how to get rid of them and further investigation should be done.

Note: From SuSE Release 8.1 on the docbook-toys are capable of using openjade instead of jade_dsl (openjade will be the future). There are some improvements over jade_dsl, e.g. the bookmarks in PDF documents now work.

To use openjade it's only necessary to set the command line option "-o" when using the docbook-toys commands, e.g.

db2pdf -o db_primer.xml.

In the following examples it is assumed to convert an XML-file called first_try_book.xml to various destination formats.