On Aug 21, 10:03 pm, "Edward K. Ream" <[email protected]> wrote:
> The present, possibly-soon-to-be-altered outline structure is:
>
> - @thin screen-shots.txt
> - @rst html/slides.html
> - @slideshow installation
> - slide 1
> - slide 2
> etc.
> - @slideshow what is leo
> - slide 1
> etc.
Good things happened as soon as I started to make things work.
1. The simplest thing that could possibly work **for the user** is to
have the rst3 command handle @slides nodes as well. I made some easy
alterations to processTopTree and processTree to do this. The *big*
advantage of doing this is that the code searches for @slides nodes in
the selected tree exactly like it searches for @rst nodes. This
resolves a big set of issues that were swirling around.
In other words, the create-slides command is now subsumed into the
rst3 command.
2. As soon as I ran the prototype (write_slides just inits and then
prints the file name), I saw a problem with the organization above.
The @slides nodes are descendants of the @rst node, so everything just
gets put in html/slides.html.txt, which is not what we want. Thus,
the tree must be organized like this:
- @thin screen-shots.txt
- @rst html/slides.html
- @slideshow installation
- slide 1
- slide 2
- @slideshow what is leo
- slide 1
That is, the @slideshow nodes must not be children of the @rst node.
3. Speaking of the simplest thing that could possibly work, I realized
this morning that having the create-slides (aka rst3) command alter
toctree directives is too complicated. Instead, we'll either live
with the warnings generated by make html, or write_slides will alter
the make files (or call sphinx-build directly). The point is that we
never want to mess with sources. It's much cleaner conceptually to
mess with builds downstream.
So this is excellent progress. I hope to create my first slide show
later today.
Edward
--
You received this message because you are subscribed to the Google Groups
"leo-editor" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to
[email protected].
For more options, visit this group at
http://groups.google.com/group/leo-editor?hl=en.
