kernel/linux.git/Documentation/sphinx-static/custom.css, branch v6.6.132Linux kernel stable tree (mirror)https://git.radix-linux.su/kernel/linux.git/atom?h=v6.6.1322023-02-08T20:28:27+00:00docs: Add more information to the HTML sidebar2023-02-08T20:28:27+00:00Jonathan Corbetcorbet@lwn.net2023-01-20T00:03:05+00:00urn:sha1:c404f5d4f0993e9d75a4de5a91280e9cb2419281
Add a new sidebar template that creates a more RTD-like "fisheye" view of
the current place in the document hierarchy. It is far from ideal, but
some readers may find it better for navigating through the documentation as
a whole.
Add some CSS trickery as well to make the table of contents less intrusive
when viewing the pages on a small screen.
Reviewed-by: Akira Yokosawa <akiyks@gmail.com>
Reviewed-by: David Gow <davidgow@google.com
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
docs: Don't wire font sizes for HTML output2022-11-01T21:59:40+00:00Jonathan Corbetcorbet@lwn.net2022-10-31T16:48:19+00:00urn:sha1:bd5d1cc8ffd7ab83a409a203c1892b6216258d88
The alabaster theme likes to provide explicit sizes for fonts, which
overrides the users's own browser settings and is guaranteed to displease
folks. Set the font size to "inherit" so that the users browser settings
control the font size they get. We can use the font_size configuration
option for the main body font (changing the size I'd already put there),
but the sidebar size can only be set via custom CSS.
Reported-by: Bagas Sanjaya <bagasdotme@gmail.com>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
docs: improve the HTML formatting of kerneldoc comments2022-10-18T22:29:29+00:00Jonathan Corbetcorbet@lwn.net2022-09-30T17:52:09+00:00urn:sha1:eaf710ceb5ae284778a87c0d0f2348c19e3e4751
Make a few changes to cause functions documented by kerneldoc to stand out
better in the rendered documentation. Specifically, change kernel-doc to
put the description section into a ".. container::" section, then add a bit
of CSS to indent that section relative to the function prototype (or struct
or enum definition). Tweak a few other CSS parameters while in the
neighborhood to improve the formatting.
Acked-by: Mauro Carvalho Chehab <mchehab@kernel.org>
Signed-off-by: Jonathan Corbet <corbet@lwn.net>
docs: tweak some Alabaster style parameters2022-10-13T17:14:31+00:00Jonathan Corbetcorbet@lwn.net2022-09-26T23:48:59+00:00urn:sha1:2056b920c615566084cd9aa105b54b62a516161e
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>