I tried to demo some of the **interpreted text role** effects found in using
nim's rst2html
nim rst2html sample.rst
Run
Here is the sample.rst
.. contents::
Sample Interpreted Text Roles
=============================
Ordinary reference `Subheading A`_
gives ``<a class="reference external" href="#subheading-a">``
Note that according to the TOC, the href should be
``"#a-major-heading-subheading-a">``
Use id role `Subheading A`:id:
gives ``<span class="id">Subheading A</span>``
Use id argument `Subheading A`:id-abc:
gives ``<cite>Subheading A</cite>:id-abc:``
Use idx role `Subheading A`:idx:
gives ``<span id="subheading-a_1">Subheading A</span>``
Use idw role `Subheading A`:idw:
gives ``<span class="idw">Subheading A</span>``
A Major Heading
===============
Highly important stuffA
Subheading A
------------
Detailed stuff
Run
Are the docutils directives and interpreted text roles as actually implemented
in nim documented anywhere? The above shows behavior I did not find in
[[http://docutils.sourceforge.net/docs/ref/rst/roles.html](http://docutils.sourceforge.net/docs/ref/rst/roles.html)]
If I could just get the correct **Subheading A** href to show, I would be very
happy.
