Datatable issues when using RTD Theme

[twodrops]

Some points were reported as part of this issue
#271 (comment)

When using Datatables with RTD,

• The head columns don't have the same width as the content columns.
• When scrolling head and content is not align.

[danwos]

The read_the_docs theme related issues really drive me crazy :/
This theme is doing so much voodoo, that it is hard or even impossible to provide workarounds for it.

So rtd is wrapping each table in an extra div with class wy-table-responsive (via online javascript manipulation!).
Then some values for div.wy-table-responsive get set via css and I have the feeling also via js.

When I deactivate the rtd js file theme.js for the documentation, all looks good.

So it's impossible to define something on css level, if it gets overwritten by js code later.

I will need to discuss this issue with the rtd-developers and maybe discuss a common way of how a table (created by extension) can be exclude from this kind of handling.

[danwos]

Created bug report: readthedocs/sphinx_rtd_theme#1179

[twodrops]

Perfect bug report. Thanks!!

[danwos]

Same problem for the Sphinx Material theme.
But the reason and a solution would look completely different:
Bug issue: bashtage/sphinx-material#119

[danwos]

PR is out for RTD: readthedocs/sphinx_rtd_theme#1218

[danwos]

PR on RTD side is on hold and shall be merged with release 1.1. Currently 1.0 gets prepared, so this may take a while 😞 .

In the meantime, this fork contains the change and can be installed by hand to get it working:
https://github.com/useblocks/sphinx_rtd_theme/tree/danwos/wy-table-exclude

[twodrops]

#304 is fixed as part of this. The problem mentioned in the description of this issue is still there. Therefore, it can be reopened I guess.