Le 07/02/2011 19:21, Frank Lanitz a écrit :
As an occasional Asciidoc contributor I hate to say this but...
Perhaps the project should stick to one markup language? Geany's documentation is done in reST, a part of Python's docutils which is used to produce the Python docs. (see http://docs.python.org/documenting/index.html ). reST is a "lightweight markup language" quite similar to Asciidoc and as you can see from the Geany help file produces HTML (and others too IIRC).
That's the one I was trying to think of! Thanks, Lex, for reminding me. I included AsciiDoc only as an example. I don't want to complicate things too much so would be happy to use reST. I currently use AsciiDoc for other projects but I see no reason to try to force it upon other people when a similar tool is already in use and doing its job well.
OK. Let's give ReST a try. I guess we will need to have a makefile which is generating the output we need. Who likes to do this? Also I think this should be done after volume 1 has been send to public.
I can probably handle this if needed :)