Xavier Hanin wrote:
On 11/15/06, Gilles Scokart <[EMAIL PROTECTED]> wrote:
There is also the apt format
(http://maven.apache.org/guides/mini/guide-apt-format.html). Which are
simple text wiki like, that you can store in your repository (allowing to
send path).
I like this kind of format, very easy to write with a plain text editor.
What I don't like is to need to launch and wait for the generation.
Another "smart ASCII" format is reStructuredText_. It has the ability
to be rendered into HTML for on-line viewing and to LaTeX for printing
or PDF. It has more features than ``apt`` and, in my opinion, a more
readable syntax. In fact I have written this email using reStructuredText.
The reference implementation is done in python, but there appears to be
a java implementation: jrst_. I have not used the java implementation,
so I don't know how good it is. In my experience the translation to
HTML is very quick and maybe a CGI or mod_python script could be written
for on-the-fly conversion.
.. _reStructuredText: http://docutils.sourceforge.net/rst.html
.. _jrst: http://jrst.labs.libre-entreprise.org/
