PDA

View Full Version : Documenting for QTextBrowser



elcuco
8th July 2007, 19:45
I remember some time ago a few folks were asking about the documentation tool to be used for Qt4 applications. While doxygen kicks ass, QTextBrowser cannot handle those files (since they include refernces to external css files).

I found out this nice little tool called asciidoc (http://www.methods.co.nz/asciidoc/) which can be used for documentation. The HTML created by that tool is QTextBrowser friendly, and the input is a simple text file. See the online site for examples (the main page is written using asciidoc, pretty cool IMHO).

wysota
9th July 2007, 16:38
I use doxygen + a xslt processor for generating nice html files.

elcuco
9th July 2007, 16:54
...? can you explain?

I think that a simple perl magic would "inline" the css in to the HTML and thus make it more QTextBrowser friendly.

Can you share the XSLT commands...?

wysota
10th July 2007, 00:30
I think that a simple perl magic would "inline" the css in to the HTML and thus make it more QTextBrowser friendly.
I want the output to look different from what Doxygen generates. A snippet attached.


Can you share the XSLT commands...?
I'll think of that when it's mature enough :)