On Tue, Oct 29, 2013 at 2:50 AM, Matt Wilkie <[email protected]> wrote:
> 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 (?) > Thanks for these comments. I think it best not to mention those delimiters in the tutorial: they slow and confuse the exposition. They are an advanced feature--Leo's docs don't use them. ((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.)) > Don't worry about it :-) Steve thinks the new rst3 tutorial is worse than the old, so I am looking at it with fresh eyes. We'll get it right soon, with everyone's help. 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.
