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.
Converting to HTML
Enter db2html first_try_book.xml on the command line. Upon successful completion a directory first_try_book is created that contains the results of the conversion process.
Note: To allow for stable bookmarking in the resulting HTML-document please see the note in the Section called Reference in Chapter 3.
Converting to PDF
Enter db2pdf first_try_book.xml on the command line. Upon successful completion a file first_try_book.pdf is created that can be viewed and printed using acroread.
Converting to PS
Enter db2ps first_try_book.xml on the command line. Upon successful completion a file first_try_book.ps is created that can be viewed and printed using gv.
Warning |
Importing graphics into PS does only work with EPS-format. |
Converting to DVI
Enter db2dvi first_try_book.xml on the command line. Upon successful completion a file first_try_book.dvi is created that can be viewed and printed using xdvi.
Warning |
Importing graphics into DVI does only work with EPS-format and the table of contents is a bit messed up with undelines. |
Converting to TeX
Enter db2tex first_try_book.xml on the command line. Upon successful completion a file first_try_book.tex is created that could be further edited for improved layout. Nevertheless that is absolutely not recommended. Edit the XML source only.
Converting to RTF
To get a document in RTF format would be nice to have a way to M$-Word (for those who want that). However it doesn't work at the moment. Conversion only renders lots of errors. Further investigation is necessary here.
Converting to MIF
Same as RTF. Doesn't work at the moment.