Maintaining multiple forms of user guide for a Java application [closed]

Closed. This question is seeking recommendations for books, tools, software libraries, and more. It does not meet Stack Overflow guidelines. It is not currently accepting answers.

---

开发者_Python百科

We don’t allow questions seeking recommendations for books, tools, software libraries, and more. You can edit the question so it can be answered with facts and citations.

Closed 5 years ago.

Improve this question

I have a user guide for my application that I would like to provide both an HTML verson and a PDF version (and possible some other indexed version for a Java help). Are there any tools, preferably for maven that I could integrate into my build cycle that will convert from HTML to PDF? Currently I have a word doc format that I manually convert to PDF (and no HTML version available), which is prone to errors and really just a pain.

---

Well, after a short search, I went on http://www.xhtml2pdf.com/ and if you have your HTML, it does the trick.

However, I prefer using a wiki for documentation. It has all advantages, since it can be edited in parallel, in multiple languages, and a lot of them have both static HTML export and PDF export. I should recommend you Dokuwiki (and you can find your plugins at http://www.dokuwiki.org/plugins) because it's really easy to install and administrate, but you can also use any other one that have PDF and HTML export.

---

You might use a tool like DocBook and write the documentation in a scripting language (XML in their case). Then use the tool to transform the source to the target formats, e.g. HTML and PDF.