|
Size: 400
Comment:
|
Size: 1726
Comment: More official way, described at ASPN.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| ReStructuredText is a complete rewrite of StructuredText by David Goodger. | #pragma section-numbers off = ReStructuredText (reST) = ReStructuredText is a complete rewrite of StructuredText by David Goodger. It is distributed as part of DocUtils. [http://docutils.sourceforge.net/ (project page)] [http://sourceforge.net/project/showfiles.php?group_id=38414 (download)] |
| Line 5: | Line 11: |
| * [http://docutils.sourceforge.net/spec/rst/introduction.html An Introduction to ReStructuredText] * [http://docutils.sourceforge.net/docs/rst/quickstart.html A ReStructuredText Primer] * [http://docutils.sourceforge.net/spec/rst/reStructuredText.html ReStructuredText Markup Specification] |
* [http://docutils.sourceforge.net/spec/rst/introduction.html An Introduction to ReStructuredText] - goals & history * [http://docutils.sourceforge.net/docs/rst/quickstart.html A ReStructuredText Primer] - how to write reST text * [http://docutils.sourceforge.net/spec/rst/reStructuredText.html ReStructuredText Markup Specification] - details on writing reST text * [http://www.ocf.berkeley.edu/~bac/rest_tutorial.html Brett Cannon's PyCon Tutorial] {i} MoinMoin contains an (incomplete) bridge to the docutils's parser, you can try this by using "#format rst" as the first line of a wiki page. See MoinMoin:RestSample for an example. This of course only works when you use the current CVS version, and when docutils is installed. == Reading reST, Writing HTML == There's surprisingly little on the web and in the documentation about how to read reST, and output HTML. IanBicking has contributed this code, which reads a source text (in reST), and writes HTML: {{{ #!python html = docutils.core.publish_string( source=text, writer_name='html') html = html[html.find('<body>')+6:html.find('</body>')].strip() }}} "It may feel wrong, but it works, and works reliably." There's a more "official" way, that feels less dirty, [http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/193890 described at ASPN.] == Discussion == (none) |
ReStructuredText (reST)
ReStructuredText is a complete rewrite of StructuredText by David Goodger.
It is distributed as part of DocUtils. [http://docutils.sourceforge.net/ (project page)] [http://sourceforge.net/project/showfiles.php?group_id=38414 (download)]
More information:
[http://docutils.sourceforge.net/spec/rst/introduction.html An Introduction to ReStructuredText] - goals & history
[http://docutils.sourceforge.net/docs/rst/quickstart.html A ReStructuredText Primer] - how to write reST text
[http://docutils.sourceforge.net/spec/rst/reStructuredText.html ReStructuredText Markup Specification] - details on writing reST text
[http://www.ocf.berkeley.edu/~bac/rest_tutorial.html Brett Cannon's PyCon Tutorial]
MoinMoin contains an (incomplete) bridge to the docutils's parser, you can try this by using "#format rst" as the first line of a wiki page. See RestSample for an example. This of course only works when you use the current CVS version, and when docutils is installed.
Reading reST, Writing HTML
There's surprisingly little on the web and in the documentation about how to read reST, and output HTML.
IanBicking has contributed this code, which reads a source text (in reST), and writes HTML:
"It may feel wrong, but it works, and works reliably."
There's a more "official" way, that feels less dirty, [http://aspn.activestate.com/ASPN/Cookbook/Python/Recipe/193890 described at ASPN.]
Discussion
- (none)