>
> |
DSSL Faq: http://www.miwie.org/docbook-dsssl-faq.html
DocBook Faw: http://www.dpawson.co.uk/docbook/
- Q: How to cross link documents (link between HTML files for example)?
http://www.dpawson.co.uk/docbook/styling/linking.html
- Q: How to convert DocBook XML to HTML, PostScript, PDF, RTF?
A: Method 1: the XSL way
You need to install:
For generating HTML, this is enough. Just use the XSL stylesheet that transforms DocBook XML to HTML.
If you need to generate PDF, you'll have to use the XSL stylesheet that transforms DocBook XML to FO (Formatting Objects: an abstract, standardized, XML based, document formatting language). Then you'll need a FO processor that transforms FOs to a typesetting language such as TeX or RTF or to a page description language such as PostScript or PDF.
Our advice: PROS:
- This is the way of the future. It is not a good idea to invest on DSSSL.
CONS:
- Very tedious to install.
- The generated output is not good looking enough, except when using RenderX's XEP.
- DocBook is so huge that it is difficult to come up with really satisfactory XSL stylesheets even when you are an ace like Norman Walsh.
Method 2: the DSSSL way
You need to install:
Our advice: PROS:
- More mature than the XSL way. The generated output is generally better looking than what can be accomplished by the XSL tools.
- Not too tedious to install on Linux if you have a distribution such as the SuSE 7.2 which includes all the tools mentioned above.
CONS:
- Picky about the document encoding. If you need accented letters, do not forget to check the option ISO-8859-1 in the XXE Options dialog box!
- It is not a good idea to invest on DSSSL. XSL is the way of the future.
- The generated output is not good looking enough. (We have been told that the LDP http://www.linuxdoc.org/ DSSSL customized stylesheet, ldp.dsl, gives a better looking output).
- DocBook is so huge that it is difficult to come up with really satisfactory DSSSL stylesheets even when you are an ace like Norman Walsh.
-- PatrickHartling - 13 Oct 2004
|