Hi dom4j team,

I fixed one ugly issue on our TODO list concering our cookbook. 
James suggested to used a better styling template like Apache Avalon
offers. But I realized that we use the docbook XSL Files incorreclty.
The current version should style the xml cookbook without problems.

I fixed the use of Saxon in build.xml and added some new featueres:

* adding a Cascading Style Sheet that fits the cookbook view to the CI of
the project page (includes highlighted source code which improves the
readability of the html output)

* added FOP styling

* added automatic PDF and PostScript creating using Apaches FOP Processor

The result of the transformation is now:

* html
* pdf
* ps
* fo

I don't added xhtml output right now, because my current browser handles it
as xml :(.
But if you would prefer xhtml output I will add. Please tell me.

Usage
=====

To get the cookbook style just type:

build(.bat) doc-cookbook  on Win32 Systems

and

build.(sh) doc-cookbook on Unix/Linux Systems.

Problems
=======

Apache FOP needs a LOT of jar files. To get the FOP Transformation working I
added them to CVS into the lib directory. I think lib/tools would be a
better place. If you think that to, please tell me. But we have to fix the *.sh
and *.bat files because ant needs the fop.jar and its libs into classpath (I
used the inbuild fop ant task in order to simplify the usage).

Apache FOP don't supports the complete FO Spec form W3C. Therefore the
process puts out a lot of warning messages. Unfortuantly, this will lead to a
unpretty style of some source code samples. If someone have any tips to improve
the ouput, please tell me. :)

Hava nice time

Toby

PS: If you have any problems in using the doc-cookbook target of your
buildfile please tell me.


-- 
GMX - Die Kommunikationsplattform im Internet.
http://www.gmx.net


_______________________________________________
dom4j-dev mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/dom4j-dev

Reply via email to