I'm in the progress of implementing a built-in help system based on QtHelp into my application. Since QtHelp is based on Qt's help collection files, I need to produce a set of HTML pages.
Since I won't be writing the documentation alone (a few of my colleagues will write, too), I am looking for the best way to produce these files.
We are internally using a Wiki, and I know that the documentation should be written in some kind of markup language instead of giving all authors a WYSIWYG HTML editor.
So my question is, are there tools out there which help with the process of generating documentation that can be exported as a set of HTML files, and possibly, as PDFs, too?.
Thanks in advance!
I'm already using Doxygen for C++ documentation generation. But I'm not exactly looking for an API-Documentation generator, but something like LaTeX, which allows you to format the documentation contents like a markup document (much like a Wiki).
I hate to answer my own questions, but we eventually decided to settle for LaTeX.
In the past we used a Wiki (MediaWiki and DokuWiki) for documentation, but that proved to be problematic as soon as you wanted to print or ship the documentation in a decently formatted form (PDF guide for instance).
LaTeX is not much more complex compared to a Wiki markup language, but produces beautiful PDF files, and there are also a series of LaTeX-to-HTML compilers, which produce decent HTML documentation with graphics, Tables Of Contents and clickable links and sections.