Fix markdown table rendering in C++ docs

This reverts commit 0bb904e10a and
re-introduces the markdown table support extension. The resulting table
by default is too wide in the "responsive" read-the-docs theme, but with
a CSS tweak it becomes readable.

Markdown tables are much easier to deal with and this way we can also
include references within the tables.
This commit is contained in:
Simon Hausmann 2020-09-02 16:47:42 +02:00
parent 1cf6d81169
commit fd9aea97eb
5 changed files with 35 additions and 40 deletions

View file

@ -30,7 +30,7 @@ release = '0.0.1'
# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = ["breathe", "recommonmark", "exhale"]
extensions = ["breathe", "recommonmark", "exhale", "sphinx_markdown_tables"]
breathe_projects = {
"SixtyFPS": "./docs/xml"
@ -67,4 +67,7 @@ html_theme = 'sphinx_rtd_theme'
# Add any paths that contain custom static files (such as style sheets) here,
# relative to this directory. They are copied after the builtin static files,
# so a file named "default.css" will overwrite the builtin "default.css".
#html_static_path = ['_static']
html_static_path = ['_static']
def setup(app):
app.add_css_file('theme_tweak.css')