From: <tra...@su...> - 2010-06-17 13:19:11
|
Hey all, I'm developing a rather large set of information on web authoring and programming in python. http://www.subspacefield.org/~travis/python_web_authoring_programming.html I'm just not getting started working with reST; it's a bit difficult to pick up at first, but I can see it does quite a bit more than markdown, the other LWML I worked with. (In particular, Markdown won't actually create a full HTML document, can't do xrefs, can't to ToC, etc.) If any of you could help me figure out the gaps in this page, I'd appreciate it: http://www.subspacefield.org/~travis/python_web_authoring_ubuntu.html Comments on ALL pages quite welcome. -- A Weapon of Mass Construction My emails do not have attachments; it's a digital signature that your mail program doesn't understand. | http://www.subspacefield.org/~travis/ If you are a spammer, please email jo...@su... to get blacklisted. |
From: <tra...@su...> - 2010-06-17 13:43:58
|
On Thu, Jun 17, 2010 at 06:02:51AM -0700, tra...@su... wrote: > I'm just not getting started working with reST; it's a bit difficult string.replace(last_line, 'not', 'now') -- A Weapon of Mass Construction My emails do not have attachments; it's a digital signature that your mail program doesn't understand. | http://www.subspacefield.org/~travis/ If you are a spammer, please email jo...@su... to get blacklisted. |
From: Ben F. <ben...@be...> - 2010-06-17 14:28:50
|
tra...@su... writes: > If any of you could help me figure out the gaps in this page, I'd > appreciate it: > > http://www.subspacefield.org/~travis/python_web_authoring_ubuntu.html For several releases, both Debian and Ubuntu have recommended ‘aptitude’ as the primary command-line tool for managing packages. So your examples should be:: sudo aptitude install emacs-goodies-el and so on. For Emacs, there's no need to install anything to get reST support; the default installation of Emacs in Debian and Ubuntu comes with ‘rst-mode’ already available. So: M-x rst-mode will work out of the box. You might want to show how an existing document (e.g. one with a filename that doesn't necessarily indicate any particular markup language) can include editor hints for what mode to use. I use something like the following comment block at the end of all my reST documents:: .. Local variables: coding: utf-8 mode: text mode: rst End: vim: fileencoding=utf-8 filetype=rst : The comment block is preceded by a U+000C FORM FEED character; a whitespace character that indicates a “page break”. It is useful for navigating, and for clearly delimiting the trailing comment block from the rest of the document. The two “mode” settings are there so that, if the document ends up on a Emacs instance which doesn't have ‘rst-mode’, it will at least work in text mode (instead of falling back to Fundamental mode). The Vim modeline needs to be last, since Vim doesn't search many lines backward from the end. You can probably construct a similar no-op Markdown block with equivalent editor hints. -- \ “We must respect the other fellow's religion, but only in the | `\ sense and to the extent that we respect his theory that his | _o__) wife is beautiful and his children smart.” —Henry L. Mencken | Ben Finney |