Documentation Tools
The Water-Powered Documentation Tools ("doctools") is a collection of Makefiles, XSLT stylesheets, and resources (images, CSS, JavaScript) intended to aid in generation and transformation of XML-based documentation for human consumption.
The Documentation Tools currently contain Makefiles supporting the transformation of Docbook documents to the standard Water-Powered XHTML and PDF output styles, as well as generating PureDocs API documentation from a source tree. A neutral default output styling is in the works.
Current focus is on a redesign for ModularDoctools. See the proposal below for details:
Doctools provides the following components:
- A build system for orchestrating builds of documentation bases.
- Sanitization of some of Docbook's less sensible default outputs.
- Outputs to various formats (Most notably PDF, XHTML and roff)
- A mechanism for user-defined DocumentThemes
- Extensions to docbook source - for example, InterdocumentLinks.
See InstallingDoctools for the process of installation.
Development
The Documentation Tools are under active development. The tools below can be used to view the development process, or get involved.
Source Code
The source code can be checked out from Subversion anonymously using the following command:
svn co http://svn.water-powered.com/doctools/trunk doctools
Browse the source code repository, and all previous revisions.
Browse the timeline of development, including source and ticket changes.
Issue Tracker
Browse and view known issues, including bug reports and patch submissions.
Create a new ticket for bugs or patches.