phingofficial/phing — pull request #94 by johan162 (2012-02-19 08:37:05+00:00)
Title: Docbook5 branch

Hi Michiel,

The DocBook5 branch is now ready to merge (should you want to). In this branch I have also updated the core documentation where it was out of date (for example the description on how to get source from subversion). In addition I have added a few bits of information in a couple of places. Most notable information and guidelines for how to manage the docbook manual (and what rules should be adhered).

The status of the branch is in summary:

* All changes are located to under the "docs/docbook5" directory.
* The entire manual is converted together with a number of clean-ups to make it consistent among all task descriptions.
* Customized XSL stylesheets to create (X)HTML (both single file and chunked), PDF and EPub is included. In addition there are also targets to create versions of the PDF and HTML manual with syntax highlight used for all code examples.
* The documentation adds some new sections on how to work with the DocBook sources and the pre-requisite to render the output.

I have not yet included a build target for Webhelp since my judgement is that we need the imminent new release of the DocBook stylesheets (1.77.0) to make life easier. For the proof-of-concept I used a snapshot from the official DocBook repository.

Not sure how you want to take it from here but I'm willing to take on the responsibility to maintain the docbook5 documentation and keep on improving the look&feel of the manual.

I would probably also recommend deleting the 3 year old previous docbook branch since that is completely dead, based on the old 4.5 DocBook as well as the no-longer maintained DTD stylesheets. In addition it only has the bibliography included.

What remains:
* If you want to include this in future versions the docbook rendering must somehow be included in the release process and a decision made on what should be the default output format.

So what do you think?

Cheers
Johan