[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: FAQ format
From: |
Thomas Weber |
Subject: |
Re: FAQ format |
Date: |
Thu, 26 Mar 2009 23:22:17 +0100 |
User-agent: |
Mutt/1.5.18 (2008-05-17) |
On Wed, Mar 25, 2009 at 02:12:11PM -0400, John W. Eaton wrote:
> Having it as an HTML document might be OK too, as it would look better
> on the web, but I find editing HTML to be relatively unpleasant.
>
> Comments?
Are you aware of ReStructuredText?
http://docutils.sourceforge.net/rst.html
Pure ASCII, Emacs mode available and both HTML and LaTeX can be
generated from it.
Debian package is 'python-docutils'.
Example for an .rst file and the resulting HTML output:
http://tw-math.de/~weber/using-debbugs.rst
http://tw-math.de/~weber/using-debbugs.html
I'd say that the FAQ as text/.rst document shipped in the source tarball
is sufficient, though. Otherwise, we'll add a dependency on doctuils for
building Octave.
Thomas