Richard Jones' Log: Bruce: how to proceed?
As previously hinted Bruce, the Presentation Tool may now display presentations authored in ReStructuredText. I've had a chance to do some more work on it lately, and need to take a step back and think about what I'm trying to do :)
The ReST capabilities currently available are:
- Sections denote pages (just like all the other ReST presentation tools),
- Lists are handled (some features missing). A lot of inline markup is handled. Images are handled, both inline and stand-alone.
- The stylesheet and other configuration may be changed on the fly with ".. config::" directives.
- The background decoration* may be specified with a ".. decoration::" directive.
*: the decoration stuff is new as of very recently too. Currently it controls the background colour, but also allows rendering of quads (with colour gradient if you like) and images in the background. There's still much to do like scaling the decoration layer to the screen size, and adding more toys to decorate with like lines and possibly splines. Not sure how far to take it.
Missing from the ReST side though is:
- Pages without titles (this would require some sort of "page" directive to indicate a new page has begun).
- Other page types like the Python interpreter, Python code and Video.
- Handling notes and running-sheet HTML generation sensibly.
- Allowing custom page types, perhaps through ".. custom:: <module name>"
Those things aren't insurmountable. I'm becoming increasibly convinced that ReST is a better way to go than the custom markup format, but I'm having trouble with the final decision to give up on the old format.
Of course maintaining two parsers is ... silly.
I'm pretty sure I've made my decision, but thought I'd throw this post out anyway in case anyone had any thoughts or encouragement...