I want to write a reference manual for a project, and I want to make it available both online as a HTML one-page-per-chapter manual (optionally single-monolithic-page would be nice as well) and as PDF version.
Prime examples:
- The Gentoo Handbook (html one page per chapter, html monolithic)
- Netty’s user guide (html one page per chapter, html monolithic, pdf)
- Spring’s reference docs (html, pdf)
What can I use to achieve this?
It’s docbook + maven plugins (maven-jdocbook-plugin).
This pom contains a sample on how to produce what I intended in the first place.
The results can be found here.
There’s also an alternative (still using docbook and maven), docbkx-tools.