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.

api/sixtyfps-cpp/docs/Pipfile

@@ -11,6 +11,7 @@ breathe = "*"
 sphinx-rtd-theme = "*"
 exhale = "*"
 recommonmark = "*"
+sphinx-markdown-tables = "*"
 
 [requires]
 python_version = "3.8"

api/sixtyfps-cpp/docs/conf.py

@@ -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')

api/sixtyfps-cpp/docs/theme_tweak.css

@@ -0,0 +1,9 @@
+.wy-table-responsive table td, .wy-table-responsive table th {
+    white-space: normal;
+}
+
+.wy-table-responsive {
+    margin-bottom: 24px;
+    max-width: 100%;
+    overflow: visible;
+}