willkg / douglas

DEAD PROJECT: File based static rendering blog system
Other
2 stars 3 forks source link

add helpful directives to rst_parser #30

Open willkg opened 10 years ago

willkg commented 10 years ago

There are a handful of helpful things I'd like the rst_parser to do:

Probably want to crib what we can from Sphinx and use code-block and literal-include for syntax highlighting, something like versionchanged for update notes, and

Might be interesting to use :ref: for links to other blog entries. I'm not sure what the ref would be, though--the blog entry title? the path?

Would be good to look at other systems and crib blog-related syntax from them, too. Also, we should document all the syntax. Maybe do something like the reST quickstart primer nixing things no one will ever use and adding our Douglas-specific syntax.