- documentation should be written in an easy format(xml, wiki-style)
- the generation step to be automatic and in simple way configurable (to allow through simple configuration a degree of customization for the generated html)
- the generated documentation must be html
I am currently looking for a solution to generate the documentation for some of my projects. My requirements are quite simple:
3 comments:
I use JSPWiki and export pages to HTML using Hula. Then I use an Ant's "get" task to download all my project's documentation.
http://raibledesigns.com/page/rd?anchor=export_jspwiki_pages_to_html
Codehaus use Atlassian's (free to open-source) Confluence tool (wiki/blog) and have scripts that publish pages from it.
Involves a fair amount of setup to get it all going I suspect. I think the scripts are called Confluenza, but unsure.
Hen
Check out the apache forrest project
http://forrest.apache.org/
Apache Forrest is an XML standards-oriented documentation framework based upon Apache Cocoon, providing XSLT stylesheets and schemas, images and other resources. Forrest uses these to render the source content into a website via command-line, robot, or dynamic application.
Post a Comment