From patchwork Thu Oct 29 12:58:50 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 102386 Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc01-g2.11295.1793278747222525734 for ; Thu, 29 Oct 2026 05:59:08 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=Jt2TMlEN; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id CAE69C49F44 for ; Thu, 29 Oct 2026 13:00:06 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 75AA660360 for ; Thu, 29 Oct 2026 12:59:04 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id D21FE103290E8; Thu, 29 Oct 2026 13:58:59 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1793278740; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=q5Y/BCQGrmmgs1/b2EEY88RLDB0vB66Rkul+StR38LM=; b=Jt2TMlENofan8wE/8UWRUt+24Plbr8kUq1mbspn9J+ff7CiJxoMT0wZ58iBWUOy6xM8b9v O4nD9P5PYmzxYcNIOktlx6U4GExR5mA1wI8vBOOe9rXVhzOQTWIy1Kjjx8kQLx0N6dJNOT I/1Sd+r2kSF9GgyeBlx7rDIlXZ4jwD4SeGzDMyfGC69RgYVXq91ApHXC1vceGmiYWkHhbr 0V7GziykfdWeekn7pLiSDhJFtmugU2RKxiD5zcp1ZhQ/YwH3IzndI5ggUSqYKnuW+fPOyQ zUpsPPqoflyW9oBLEOQHXs57mvOIVssw1UKOKfGhmKCgtRdaqdECPQkp965Qkw== From: Antonin Godard Date: Thu, 29 Oct 2026 13:58:50 +0100 Subject: [PATCH 1/2] theme_overrides.css: rework admonition colors MIME-Version: 1.0 Message-Id: <20261029-admonitions-styling-v1-1-8990714284a1@bootlin.com> References: <20261029-admonitions-styling-v1-0-8990714284a1@bootlin.com> In-Reply-To: <20261029-admonitions-styling-v1-0-8990714284a1@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.17-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=3102; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=S+c6bxUgWunYxPbHlgOyTKz75ORh+jzNr32JnitXV+0=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBq40MMJAlOY+bLcUIubmanOYvRFh6b6SH3Ywwmz R3qGb+Y0GSJAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCauNDDAAKCRDRgEFAKaOo Nhx+EAC7u5TO0l4yL/MYjRVA20/PYq83lY38EwjAzhG3v0j1vlCIUFVURzwE+FkOblRkxxxO292 AqbgaSFOr1TPX5MKYCF6IBzkz6eF/wTA5Vr3d5G9s0IezUpyBNd5g3a5Ggunam9iWZ8q+ODkbKV 8L6J5a6yI+hgMGr9vsfI44CYHOCBMpB4FzUnoZ6LHEa5JT0FPP6v7uS23FvZDN2dvr5nAoamjkp obb9yoeCek4XR49y9tiDkFNwWCWs4EWGyaQeRNtZGRDltXsdL89zeiy0mMwBJZJBdYC03TKbEDe iXF7cCPMfgmrzIXJRooSWMyfzpq7FWcfc7vXPazkedDfajcY/7Z2TOxGOib9SNiD6H7xScSMRA3 93QMh40sL3jdbE0LxzLTytnIM+VtF08hSsoBilp5IL83AmRLin4TfnkVc4AdHZC1Ia/oBGyCp4T dRFKU5LT43H804fGGvKazCbLuhDKXgdMkT/VZ9cG6LyoglAIB0/a9M9/wYpVUBlWoHGCZ+AVoTE BsvdmRkTvdrpDem3NJ1l8MK6BjqnrQZiKbtpiw9VaKs0PCJ8HI/L3BoGlKX5ZD1/k8c6IY7LESC hONkdWque3/JbxkpRg4iDdMCNIMajBRUcy56IBAmRF8vL0Exmq/8FwOk7Iju6uapxrK9ucMOoLK VCK4g4hq7ZVb/bg== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by lin-tor-korg-lkml-alma10-1 with HTTPS for ; Thu, 29 Oct 2026 12:59:14 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10741 All our current admonition are shown with the same colors: grey background, blue title. Change the warning, attention, caution, and important to have a light yellow background, yellow title. Change the danger and error admonitions to have a light red background, red title. Increase the spacing above the titles from 6px to 12px, so that left/right and top/bottom spacing are all even, which renders better since we do not have a different color for the title background. Signed-off-by: Antonin Godard --- documentation/sphinx-static/theme_overrides.css | 45 +++++++++++++++++++------ 1 file changed, 35 insertions(+), 10 deletions(-) diff --git a/documentation/sphinx-static/theme_overrides.css b/documentation/sphinx-static/theme_overrides.css index 3823db820..81915b19c 100644 --- a/documentation/sphinx-static/theme_overrides.css +++ b/documentation/sphinx-static/theme_overrides.css @@ -163,27 +163,52 @@ section#welcome-to-the-yocto-project-documentation p.caption { color: inherit; } - /* Admonition should be gray, not blue or green */ + /* Normal admonitions should be gray, not blue or green */ + .rst-content .hint .admonition-title, .rst-content .note .admonition-title, .rst-content .tip .admonition-title, - .rst-content .warning .admonition-title, - .rst-content .caution .admonition-title, - .rst-content .admonition-tying-it-together .admonition-title, - .rst-content .important .admonition-title { + .rst-content .admonition-tying-it-together .admonition-title { background: #f0f0f2; color: #00557D; - + padding: 12px 12px; } + .rst-content .hint, .rst-content .note, .rst-content .tip, - .rst-content .important, - .rst-content .warning, - .rst-content .admonition-tying-it-together, - .rst-content .caution { + .rst-content .admonition-tying-it-together { background: #f0f0f2; } + /* For other admonitions, make the title background color the same as the + * admonitions' content, to be consistent with our note and tip admonitions. */ + .rst-content .attention .admonition-title, + .rst-content .caution .admonition-title, + .rst-content .important .admonition-title, + .rst-content .warning .admonition-title { + background: #fff6e5; + color: #b37400; + padding: 12px 12px; + } + + .rst-content .attention, + .rst-content .caution, + .rst-content .important, + .rst-content .warning { + background: #fff6e5; + } + + .rst-content .danger .admonition-title, + .rst-content .error .admonition-title { + background: #fdf3f2; + color: #8d2f26; + padding: 12px 12px; + } + .rst-content .danger, + .rst-content .error { + background: #fdf3f2; + } + /* Remove the icon in front of note/tip element, and before the logo */ .icon-home:before, .rst-content .admonition-title:before { display: none From patchwork Thu Oct 29 12:58:51 2026 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Antonin Godard X-Patchwork-Id: 102385 Received: from smtpout-04.galae.net (smtpout-04.galae.net [185.171.202.116]) by mx.groups.io with SMTP id smtpd.msgproc02-g2.11258.1793278750900389056 for ; Thu, 29 Oct 2026 05:59:11 -0700 Authentication-Results: mx.groups.io; dkim=pass header.i=@bootlin.com header.s=dkim header.b=wwRaHOWN; spf=pass (domain: bootlin.com, ip: 185.171.202.116, mailfrom: antonin.godard@bootlin.com) Received: from smtpout-01.galae.net (smtpout-01.galae.net [212.83.139.233]) by smtpout-04.galae.net (Postfix) with ESMTPS id 98D4CC49F43 for ; Thu, 29 Oct 2026 13:00:11 +0000 (UTC) Received: from mail.galae.net (mail.galae.net [212.83.136.155]) by smtpout-01.galae.net (Postfix) with ESMTPS id 42CF560360 for ; Thu, 29 Oct 2026 12:59:09 +0000 (UTC) Received: from [127.0.0.1] (localhost [127.0.0.1]) by localhost (Mailerdaemon) with ESMTPSA id 58342103290E0; Thu, 29 Oct 2026 13:59:04 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bootlin.com; s=dkim; t=1793278744; h=from:subject:date:message-id:to:cc:mime-version:content-type: content-transfer-encoding:in-reply-to:references; bh=uDXMySxk2aJ+lodNQWxmx/4T2MUO/mSuSIOVPt5jApY=; b=wwRaHOWNxaWTHt5CDcIWWR8/m6kiPr/mL3wd+5JqQeA3PirrzalIZ22J9e2jmFhzH/A501 qyzX2prmVRdrqSC9y2cx4Jnmyv3AU4VXpb6AAMRWwKkg//DDPqR34c77PLMi4S8I2cD3Ly d37mb1Bzw6JfWhoDro+eRilxkX2N8hY+fYppl4/pruLJtMhtP0HR8pzGEii0wGeJiJf5gV bp8+uZJC4xe2Wp19mPPRxZNw2fXiH3Ft1fvq/k/W/O5cDSEw33ptvXtAunYw9fJPwpdueN Yq4zn71I5CleMUk3v8syZ9xvz6eLRYv8H4u5XXM2XS2B9ydSHKO488fxGtowyg== From: Antonin Godard Date: Thu, 29 Oct 2026 13:58:51 +0100 Subject: [PATCH 2/2] standards.md: update our admonitions encouraged usage MIME-Version: 1.0 Message-Id: <20261029-admonitions-styling-v1-2-8990714284a1@bootlin.com> References: <20261029-admonitions-styling-v1-0-8990714284a1@bootlin.com> In-Reply-To: <20261029-admonitions-styling-v1-0-8990714284a1@bootlin.com> To: docs@lists.yoctoproject.org Cc: Thomas Petazzoni , Antonin Godard X-Mailer: b4 0.17-dev X-Developer-Signature: v=1; a=openpgp-sha256; l=1487; i=antonin.godard@bootlin.com; h=from:subject:message-id; bh=lPKoYVF555KAyEc2kPFrv1RYfuMhuRVkqxlsLxSMOtw=; b=owEBbQKS/ZANAwAKAdGAQUApo6g2AcsmYgBq40MMMjPP9+icWUFkvWFaZJ+JRWrTcKI7E1x0S WMZ/mjQVa+JAjMEAAEKAB0WIQSGSHJRiN1AG7mg0//RgEFAKaOoNgUCauNDDAAKCRDRgEFAKaOo NuBoD/9QgoPmvHJnLcKIBeA1zStpAF6Rg1tFWrYJSpv9lrYfjawdAuABzlpLrj9USGHcWxalItf yOojuZMiW4rW2LXuWA/HxKRcxZW9yF14ocvurAtFKME13DLp33nhByrF8oqN7+StrCKn8piwMcB HmXu4lGE9ll571dgG+cTNkrVQJIO24FYTjQthsOPJ+aOEu8Li89lE5B93y1MOparK982vu+cXP+ qEl6Fw3qhYL78Ubij2TLTB5B+aOMp4QgP4KUI1uKCRer193FJ7TSLwNq1umUjV7AFXbG10oiEww tKMzbx9rGnbeD33hsUSFrdUFQbtDdZ9J/dsn/s3No+BfTS6hxdqDHdxWURc/P8/GyUOXFF8d/le NJeswIs2qLB1C+pgC7MSoMvn1gjmWwFCdWdfuTRdqsHJy228L3fT8DyrFkfqrl3J9AOzJHC0jjU +/YTT2nFqbk8YN9ypn9G12Ci9UxtV0iPx/zTDCDjHf4l7Jb4XIV5e+beiw3JVDJb26Z6045JgB6 AKVx409Pufszi3fYWBi1MhrPjmmBOaysH0GhHK8nrtGu5vCeswTXD2X5T/7KlkRo6cDgmfDmFGg TqWKOHnd2KQb76PQfrBAAB+ZvnYCFtIsVMFNv443lVCyr9zr2L1Q2M7+wKtl2eX3O0Bv1P/Rskl aflft8JDZIPep/w== X-Developer-Key: i=antonin.godard@bootlin.com; a=openpgp; fpr=8648725188DD401BB9A0D3FFD180414029A3A836 X-Last-TLS-Session-Version: TLSv1.3 List-Id: X-Webhook-Received: from 45-33-107-173.ip.linodeusercontent.com [45.33.107.173] by lin-tor-korg-lkml-alma10-1 with HTTPS for ; Thu, 29 Oct 2026 12:59:14 -0000 X-Groupsio-URL: https://lists.yoctoproject.org/g/docs/message/10742 The previous commit sets the coloring for all Sphinx admonitions so that they are consistent. This means we no longer need to limit the ones we can use. Remove this limitations from the standards. Signed-off-by: Antonin Godard --- documentation/standards.md | 9 +++------ 1 file changed, 3 insertions(+), 6 deletions(-) diff --git a/documentation/standards.md b/documentation/standards.md index 30d48a5bb..496a1f003 100644 --- a/documentation/standards.md +++ b/documentation/standards.md @@ -111,8 +111,9 @@ glossary before or in the same patch it is used, so that `:term:` can be used. ### Admonitions -Sphinx has predefined admonitions that can be used to highlight a bit of text or -add a side-note to the documentation. For example: +Sphinx has predefined [admonitions](https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#directives) +that can be used to highlight a bit of text or add a side-note to the +documentation. For example: ```rst .. note:: @@ -120,10 +121,6 @@ add a side-note to the documentation. For example: This is a note admonition. ``` -We try to limit our usage of these admonitions to `note` and `warning`, as the -Sphinx documentation [warns](https://www.sphinx-doc.org/en/master/usage/restructuredtext/basics.html#directives) -that most themes only style these two admonitions. - ## ReStructured Text Syntax standards ### doc directive