doc-rst: customize RTD theme, table & full width
authorMarkus Heiser <markus.heiser@darmarIT.de>
Sun, 3 Jul 2016 08:09:32 +0000 (05:09 -0300)
committerMauro Carvalho Chehab <mchehab@s-opensource.com>
Tue, 5 Jul 2016 17:39:51 +0000 (14:39 -0300)
commit9abaf979abb2845b2292d96401986b4845c51b9d
tree752427487bd8ee0500d953210662bcbd493218f6
parent5d55cd2ee7a869bbe2d2f9d9bd496b630cd1c847
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>
Documentation/sphinx-static/theme_overrides.css