Tables don't scale

[dotnetjunkie]

When building tables using RST, the table isn't automatically kept 100% with its table cells auto-scaling. Instead, all the content of the cell is placed on the same line, causing the table to become horizontal scrollable. This might make sense in some environments with small displays, but it even happens when viewing content on a 4k screen.

This seems to be javascript behavior; when javascript is disabled, the tables get formatted correctly. Also, when removing the 'wy-table-responsive' class from the table's surrounding

block, tables get formatted correctly as well. Tables also get formatted correctly in the PDF.

I experienced this problem while writing documentation for the simpleinjector.readthedocs.org project, but you can also see this behavior with other projects, such as the table on this project's page.

This problem makes it practically impossible to use tables in the documentation, which is a severe limitation for our project. Sometimes, tables are the only way to properly format parts of the text.

Can this be fixed, or otherwise, are there ways for me around this limitation, or is it possible for me to tune the output of tables for my project only?

[agjohnson]

For now, I'd use a custom stylesheet: readthedocs/sphinx_rtd_theme#117 (comment)

This was a design decision for the theme around table wrapping, though I agree that the experience around wide tables on large displays is generally poor.

[stsewd]

Closing in favor of readthedocs/sphinx_rtd_theme#117