Allow specific deactivation of table handling

docs/changelog.rst

@@ -108,6 +108,7 @@ Fixes
 * Fix ``<pre>`` overflow (#1220)
 * Fix literal/ref style inside ``<dl>`` (#1088)
 
+
 Other Changes
 -------------
 

docs/contributing.rst

@@ -239,3 +239,16 @@ To release a new version of the theme, core team will take the following steps:
 
 .. _PEP440: https://www.python.org/dev/peps/pep-0440/
 .. _semantic versioning: http://semver.org/
+
+
+Table handling
+==============
+The theme wraps tables into a ``div.wy-table-responsive`` container, to easily make tables responsive.
+
+If this behavior is not needed for some specific tables, the class name ``rtd-exclude-wy-table`` must be set
+for the table. This may be important especially for other Sphinx extensions, which create and configure tables
+for their use case on their own.
+
+
+
+

src/theme.js

@@ -99,7 +99,7 @@ function ThemeNav () {
             })
 
         // Make tables responsive
-        $("table.docutils:not(.field-list,.footnote,.citation)")
+        $("table.docutils:not(.field-list,.footnote,.citation,.rtd-exclude-wy-table)")
             .wrap("<div class='wy-table-responsive'></div>");
 
         // Add extra class to responsive tables that contain