On Tue, Nov 5, 2013 at 4:14 PM, wgw <[email protected]> wrote: > > Leo has a forest of settings, which makes it flexible, but also makes it > hard to get all Leo's ducks in a row. >
It's really not that hard. Your personal settings go in myLeoSettings.leo. If those suffice for all your rst3 needs, then put them there. More commonly, all the @rst nodes in a single .leo file will use the same settings. In that case, it's good style to put them in the startup node. I recommend using @ @rst-options only for overrides for particular @rst trees. This may require some technical vocabulary to explain things. > Not likely to help, imo. Everyone, including me, would have to learn and remember the new terms! > > I did get the intermediate files to work, by adding to the @rst node: > > > > @ @rst-options > write_intermediate_file = True > @c > > And in myLeoSettings, under @settings (though I'm not sure that changed > anything): > > .. RST > ... @bool rst3_call_docutils = True > ... > > @bool rst3_write_intermediate_file = True > ... @string rst3_write_intermediate_extension = .txt > Using @ @rst-options is bad style unless the options actually override a setting. In your case, just put the setting in the @setting tree. It is sometimes unclear to me when @something should/can go in the headline > or the body. > > @file: always in the headline > @c: always in the body > @bool: either? > @bool: always in headline. > > I'm guessing that you mean literally anywhere in @settings node here: > > Put the rst3_call_docutils setting in the @settings tree in the .leo file > containing the @rst node. This setting determines whether to use plain rST > markup or full sphinx markup. To use plain reStructuredText markup: > > @bool rst3_call_docutils = True > > Correct. The @bool node can be any descendant of the @settings node. A rule of thumb: typically when people speak of an @x node, it implies that the headline starts with @x. Otherwise, if a node contains an @x directive in the body pane, people will say something like, "a node containing an @x directive". 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.
