docs: tweak some Alabaster style parameters

This is just the beginning: tighten up the layout a bit to improve the
information density in the browser.  Also reconfigure the page width in
terms of character units (em) rather than pixels, making it more
display-independent.  To that end, add a custom.css file to
tweak Alabaster CSS settings.

Acked-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
This commit is contained in:
Jonathan Corbet 2022-09-26 17:48:59 -06:00
parent d5389d3145
commit 2056b920c6
2 changed files with 17 additions and 0 deletions

View File

@ -345,6 +345,9 @@ if html_theme == 'classic':
else:
html_theme_options = {
'description': get_cline_version(),
'font_size': '10pt',
'page_width': '65em',
'sidebar_width': '15em',
}
sys.stderr.write("Using %s theme\n" % html_theme)

View File

@ -0,0 +1,14 @@
/* SPDX-License-Identifier: GPL-2.0 */
/*
* CSS tweaks for the Alabaster theme
*/
/* Shrink the headers a bit */
div.body h1 { font-size: 180%; }
div.body h2 { font-size: 150%; }
div.body h3 { font-size: 130%; }
/* Tighten up the layout slightly */
div.body { padding: 0 15px 0 10px; }
div.document { margin: 20px 10px 0 10px; }
div.sphinxsidebarwrapper { padding: 1em 0.4em; }