3. Silly Things
Inability to natively produce combined boldface and italic. This capability is mentioned early in documentation for other markup translators. I am guessing that the docutils parser does not know how to nest — perhaps not a recursive-descent parser, or the lexer is not well-enough defined to do this. This can be worked around by doing some hoop-jumping with custom roles like this:
.. role:: bi :class: bi
And then define that class in
_static/custom.csslike this:span.bi { font-weight: bold; font-style: italic; }
Then in
conf.py:html_css_files = [ 'css/custom.css' ]
or
# Introduce custom.css. def setup(app): app.add_css_file('custom.css') print("Adding custom.css to output....")
See Comparison with Markdown for full CSS and custom-role file content for a workaround.
This same inability to nest also causes it to miss LINK references inside a boldface or italic block.
This MIGHT also be true for LINK targets, and possibly other markup.