summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMarkus Heiser <markus.heiser@darmarIT.de>2016-07-03 05:09:32 -0300
committerMauro Carvalho Chehab <mchehab@s-opensource.com>2016-07-05 14:39:51 -0300
commit9abaf979abb2845b2292d96401986b4845c51b9d (patch)
tree752427487bd8ee0500d953210662bcbd493218f6
parent5d55cd2ee7a869bbe2d2f9d9bd496b630cd1c847 (diff)
doc-rst: customize RTD theme, table & full width
The default table layout of the RTD theme does not fit for vast tables, like the ones we have in the linux_tv project. This has been discussed on the ML [1]. The RTD theme is a two column layout, with a navigation column on the left and a content column on the right: content column RTD theme's default is 800px as max width for the content, but we have tables with tons of columns, which need the full width of the view-port (BTW: *full width* is what DocBook's HTML is). table - sequences of whitespace should collapse into a single whitespace. - make the overflow auto (scrollbar if needed) - align caption "left" ("center" is unsuitable on vast tables) [1] http://article.gmane.org/gmane.linux.kernel/2216509 Signed-off-by: Markus Heiser <markus.heiser@darmarIT.de>
-rw-r--r--Documentation/sphinx-static/theme_overrides.css21
1 files changed, 20 insertions, 1 deletions
diff --git a/Documentation/sphinx-static/theme_overrides.css b/Documentation/sphinx-static/theme_overrides.css
index 4d670dbf7ffa..ea06799214fd 100644
--- a/Documentation/sphinx-static/theme_overrides.css
+++ b/Documentation/sphinx-static/theme_overrides.css
@@ -1,9 +1,28 @@
/* -*- coding: utf-8; mode: css -*-
*
- * Sphinx HTML theme customization
+ * Sphinx HTML theme customization: read the doc
*
*/
@media screen {
+ /* content column
+ *
+ * RTD theme's default is 800px as max width for the content, but we have
+ * tables with tons of columns, which need the full width of the view-port.
+ */
+
+ .wy-nav-content{max-width: none; }
+
+ /* table:
+ *
+ * - Sequences of whitespace should collapse into a single whitespace.
+ * - make the overflow auto (scrollbar if needed)
+ * - align caption "left" ("center" is unsuitable on vast tables)
+ */
+
+ .wy-table-responsive table td { white-space: normal; }
+ .wy-table-responsive { overflow: auto; }
+ .rst-content table.docutils caption { text-align: left; font-size: 100%; }
+
}