Commit Graph

7 Commits

Author SHA1 Message Date
Quentin Schulz
d4a59548be bitbake: docs: static: theme_overrides.css: fix responsive design on <640px screens
From experience the body takes the whole space anyway and the text stays
within the screen boundaries by default, no need to make the min-width
640px then.

(Bitbake rev: d52190ea426d961f609c657dcb403baf59352969)

Signed-off-by: Quentin Schulz <foss@0leil.net>
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-10-06 13:52:25 +01:00
Richard Purdie
9236e24105 bitbake: sphinx: theme_override: Use bold for emphasis text
This more closely matches the original docbook style and is appropriate
given the way the manual uses this element.

(Bitbake rev: a0f37789493aeb1cd5e82c17459bfa4cf6c0ecd6)

Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-09-16 18:14:08 +01:00
Nicolas Dechesne
4369b5986e bitbake: sphinx: theme_override: properly set font for verbatim text
The 'verbatim' text was rendered with Courier font in DocBook
(e.g. when using the <filename> tag). With DocBook we are using the
``FOO`` notation which ends up in a <pre> class in the HTML
output. Configure the theme CSS to use Courier, to preserve the look
and feel of the original docs.

(Bitbake rev: cbc5ca48c7e79c47f055a47f8f9aa480490dd00f)

Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-09-16 18:14:08 +01:00
Nicolas Dechesne
c6225653e0 bitbake: sphinx: remove leading '/'
When switching back and forth between between regular and mega manual
an extra '/' keeps being added to the URL.

Reported-by: Quentin Schulz <quentin.schulz@streamunlimited.com>
(Bitbake rev: 08b1ae2350694e22883e07605a28a10c05f62cda)

Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-09-16 18:14:08 +01:00
Nicolas Dechesne
277e99f7c6 bitbake: sphinx: update style for important, caution and warnings
The initial theme override covers for tip and and note only.

(Bitbake rev: 99ba6fe98b9c7c4dbe70dce63c478c167c10d91a)

Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-09-16 18:14:08 +01:00
Richard Purdie
caf24e8ddd bitbake: sphinx: Enhance the sphinx experience/nagivation with:
* Remove the pointless looking parts of breadcrumb navigtation
* Add a document type switcher to the breadcrumb navigation
* Add a version selection switch to the breadcrumb navigation

(Bitbake rev: cb19159cf8972713a2063387849804c5cea72d24)

Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-09-16 18:14:08 +01:00
Nicolas Dechesne
623ea7f3fe bitbake: sphinx: override theme CSS
It is possible to override CSS settings from the theme, by providing
custom snippets of CSS stylesheet. Support for that is added in
conf.py file.

Most of the CSS customization is inherited from the DocBook CSS style.

(Bitbake rev: fa304c0129538d7a0b7a3922cd1fde2e242d6cab)

Signed-off-by: Nicolas Dechesne <nicolas.dechesne@linaro.org>
Signed-off-by: Richard Purdie <richard.purdie@linuxfoundation.org>
2020-09-16 18:14:07 +01:00