Attached is my attempt to create a reference prototype .leo file and .html output from following the tutorial. I wasn't completely successful. I've not used rst in Leo before this evening. I spent an hour and change to get this far.
Two things tripped me up the most: - the per-node rst settings don't seem to work. I have an @settings node in the .leo file which says to use docutils, which I then try to switch to sphinx mode for the @rst note. This fails. - the `@ ... @c` comment delimiters don't work at all like I expected. Maybe because I think I know how they work already, from my experience with Leo and python and dos batch code. Newbies should have a better a time of it (?) ((I'm just sharing my experience, not complaining. Writing good docs when you know the material inside and out and your readers don't is damned hard.)) On Mon, Oct 28, 2013 at 5:51 AM, Edward K. Ream <[email protected]> wrote: > The proposed final drafts of the rst3 docs are now on Leo's web site: > > - Tutorial: http://leoeditor.com/tutorial-rst3.html > - Command reference: http://leoeditor.com/rstplugin3.html > > Please review them carefully and report any problems immediately. Thanks. > > I plan no further work on Leo's docs for b1, apart from release notes, etc. > > Edward > > -- > You received this message because you are subscribed to the Google Groups > "leo-editor" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected]. > To post to this group, send email to [email protected]. > Visit this group at http://groups.google.com/group/leo-editor. > For more options, visit https://groups.google.com/groups/opt_out. > -- You received this message because you are subscribed to the Google Groups "leo-editor" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. Visit this group at http://groups.google.com/group/leo-editor. For more options, visit https://groups.google.com/groups/opt_out.
.. rst3: filename: ~/war-and-peace.html
#############
War and Peace
#############
@ Introduction.
(a comment, the lines between ``@`` and ``@c`` will not appear in the output
html file)
*...except that they do!* That's 2 for 2, clearly I don't understand how these
work.
by Leo Tolstoy/Tolstoi
BOOK ONE: 1805
Chapter I
+++++++++
"Well, Prince, so Genoa and Lucca are now just family estates of the
Buonapartes. But I warn you, if you don't tell me that this means war,
if you still try to defend the infamies and horrors perpetrated by
that Antichrist--I really believe he is Antichrist--I will have
nothing more to do with you and you are no longer my friend, no longer
my 'faithful slave,' as you call yourself! But how do you do? I see
I have frightened you--sit down and tell me all the news."
It was in July, 1805, and the speaker was the well-known Anna
Pavlovna Scherer, maid of honor and favorite of the Empress Marya
Fedorovna. With these words she greeted Prince Vasili Kuragin, a man
of high rank and importance, who was the first to arrive at her
reception. Anna Pavlovna had had a cough for some days. She was, as
she said, suffering from la grippe; grippe being then a new word in
St. Petersburg, used only by the elite.
...
.. and now we skip to the end of last chapter,
.. while demonstrating use of an organizer node,
.. (a node whose name does not appear in the output document)
.. While **finally** understanding that one needs to use
.. rst's ``..`` comment prefix and not Leo's ``@...@c``!
.. (at the expense of losing syntax highlighting)
In the first case it was necessary to renounce the consciousness
of an unreal immobility in space and to recognize a motion we did
not feel; in the present case it is similarly necessary to renounce
a freedom that does not exist, and to recognize a dependence of
which we are not conscious.
--- The End ---
.. Adapted from http://www.gutenberg.org/files/2600/old/wrnpc12.txt
Title: War and Peace
War and Peace
@ Introduction. (a comment, the lines between @ and @c will not appear in the output html file) ...except that they do! That's 2 for 2, clearly I don't understand how these work.
by Leo Tolstoy/Tolstoi
BOOK ONE: 1805
Chapter I
"Well, Prince, so Genoa and Lucca are now just family estates of the Buonapartes. But I warn you, if you don't tell me that this means war, if you still try to defend the infamies and horrors perpetrated by that Antichrist--I really believe he is Antichrist--I will have nothing more to do with you and you are no longer my friend, no longer my 'faithful slave,' as you call yourself! But how do you do? I see I have frightened you--sit down and tell me all the news."
It was in July, 1805, and the speaker was the well-known Anna Pavlovna Scherer, maid of honor and favorite of the Empress Marya Fedorovna. With these words she greeted Prince Vasili Kuragin, a man of high rank and importance, who was the first to arrive at her reception. Anna Pavlovna had had a cough for some days. She was, as she said, suffering from la grippe; grippe being then a new word in St. Petersburg, used only by the elite.
...
In the first case it was necessary to renounce the consciousness of an unreal immobility in space and to recognize a motion we did not feel; in the present case it is similarly necessary to renounce a freedom that does not exist, and to recognize a dependence of which we are not conscious.
--- The End ---
rst-tutorial.leo
Description: Binary data
