The explanations for @rst-no-head and @rst-ignore and @rst-ignore-tree should come before their use in the "Write Your Document" section.
This tutorial would benefit from an example toolchain for a writer. How to actually get an html file that can be loaded into a word processor to output an .odt or .docx file for example. For most of the purposes that a programmer would use rst, ie. documentation or a web page, the tutorial goes far enough. But for those who have different output goals, highlighting the flexibility that Leo with rst should be a primary goal. There are literally hundreds of writers in the world for every programmer. If you want Leo to become popular, this is a critical understanding. IMHO. Chris On Tue, Oct 29, 2013 at 8:47 AM, Chris George <[email protected]> wrote: > Sorry, found another instance of the same thing. I am sure that this is > perfectly clear to someone who has experience with Leo, but it is still > unclear to me. > > Is "all other nodes" all other nodes? Or is it all other @rst nodes that > are not @rst-no-head or @rst-ignore nodes? > > - Use @rst-no-head nodes to add text without creating a new rST > section. > - Use @rst-ignore nodes and @rst-ignore-tree trees to comment out text. > - All other nodes create sections, subsections, etc. > > Chris > > > On Tue, Oct 29, 2013 at 8:42 AM, Chris George <[email protected]>wrote: > >> >> The following section was unclear to me. Is the "new outline node" also >> an @rst node? And if so is it the one referred to in #2? Right now it >> appears that the section title will come from the original @rst node and >> apply to all non-rst nodes under it. >> >> To create a new section, subsection, in the output file: >> >> 1. Create a new outline node, as some descendant of the @rst node. >> 2. *The @rst node’s headline becomes the section’s title*. >> 3. Type the contents of the section in the body text of the node. >> >> Chris >> >> >> On Tue, Oct 29, 2013 at 8:34 AM, Fidel N <[email protected]> wrote: >> >>> Perhaps here: >>> >>> @rst ../myDocument.html >>> @rst html/myDocument.html >>> @rst ../docs/html/myDocument.html >>> @rst ~/docs/myDocument.html #This will create /be in a >>> folder relative to the folder that contains your leo file. >>> >>> >>> After each type, it could do a #This will create /be in a folder >>> relative to the folder that contains your leo file. >>> Since thats aimed at non programmers, the ".." being a relative path >>> might not be understandable for some. >>> >>> On Tuesday, October 29, 2013 4:04:19 PM UTC+1, Edward K. Ream wrote: >>>> >>>> The tutorial is at >>>> http://leoeditor.com/tutorial-**rst3.html<http://leoeditor.com/tutorial-rst3.html> >>>> >>>> It would be very helpful if those with little or no experience with >>>> Leo's rst3 command try to follow the tutorial and report any problems, >>>> roadblocks or confusions here. Thanks! >>>> >>>> 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.
