reStructuredText Nested Markup
I use reStructuredText for both this blog and the MetaBrite DevBlog. This blog is built with Acrylamid, while the MetaBrite blog is built with Nikola.
Yesterday I used a link (~/.pgpass) that styled the link as an inline literal; i.e., in the code font. ReStructuredText doesn’t support nested markup, but you can pull it together with a two-step substitution reference:
Here you have |optparse.OptionParser|_. .. |optparse.OptionParser| replace:: ``optparse.OptionParser`` documentation .. _optparse.OptionParser: http://docs.python.org/library/optparse.html
This is tedious as you have to create a pair of directives for every such link that you wish to style.
Nested inline markup has been on the todo list for 15 years—it ain’t happening.
blog comments powered by Disqus