[Doc-SIG] directive for flexible literate programming support?
Frank Siebenlist
franks at mcs.anl.gov
Tue Dec 9 13:11:53 EST 2003
I'm currently using rst to write haskell literate programs.
The haskell interpreter will recognize the text as code if a line starts with a ">".
To set the code apart, I use "Literal Blocks" for the code snippets.
Unfortunately, a literate block has to be indented, which doesn't work well with
the interpreter. So I use a one line script to change the " >" into ">" to get
rid of the space in the first column, before feeding it to the interpreter.
This is not convenient and not very elegant...
Are there maybe other existing ways to make this easier?
If not, one option could be to introduce a directive that would specify how to
recognize literate blocks, like:
.. literate-block :: ">"
which would indicate that for rest of this file, a literate block could also be
identified with a block where the lines start with ">" besides the normal
whitespace indentation.
Thanks, Frank.
--
Frank Siebenlist franks at mcs.anl.gov
The Globus Alliance - Argonne National Laboratory
More information about the Doc-SIG
mailing list