From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from atuin.qyliss.net (localhost [IPv6:::1]) by atuin.qyliss.net (Postfix) with ESMTP id 5ED7CA535; Wed, 27 May 2026 11:24:40 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 993) id CFF2CA513; Wed, 27 May 2026 11:24:37 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 4.0.1 (2024-03-26) on atuin.qyliss.net X-Spam-Level: X-Spam-Status: No, score=0.4 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DMARC_MISSING,FROM_SUSPICIOUS_NTLD,SPF_HELO_NONE, T_PDS_OTHER_BAD_TLD autolearn=no autolearn_force=no version=4.0.1 Received: from mail-108-mta219.mxroute.com (mail-108-mta219.mxroute.com [136.175.108.219]) by atuin.qyliss.net (Postfix) with ESMTPS id 9A17AA490 for ; Wed, 27 May 2026 11:24:35 +0000 (UTC) Received: from filter006.mxroute.com ([136.175.111.3] filter006.mxroute.com) (Authenticated sender: mN4UYu2MZsgR) by mail-108-mta219.mxroute.com (ZoneMTA) with ESMTPSA id 19e692dcbb900067f7.001 for (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Wed, 27 May 2026 11:24:29 +0000 X-Zone-Loop: d36bff84de5249d81343135bfce57e5eeee252375ca4 X-Originating-IP: [136.175.111.3] DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gagarin.work; s=x; h=Content-Transfer-Encoding:MIME-Version:References: In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:Resent-Date:Resent-From:Resent-Sender: Resent-To:Resent-Cc:Resent-Message-ID:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=vd95uFtGNFl2LlAMsC3EIfDTT/oSYPkCVA09d9R1Gzs=; b=ZES76wu6WNgqoMVyyWcjbDOK2C /S24ztOBiTBIs7ijsj3TY7Ouho+u2vAKtJconZYvRuvUmGIhZMZ/D/kiCOQNWMFdRleIi6qXQAESh dCvWiFHyzK1gfpE+RmdEa0u9KAsXVbO1fpvNCewYnpQlVi1pWtOKB6xt0kLW1cHQScdZP0u6z1HOV uCRUtC3Yh595qYrkhQGdaswzYf/5j48F8a931psvt3TQzLRGcgSI2R3xI4ECtTru8oXFAcWEkbIuo rk2yE5sCpclT91zncBzz05Ys9Dp+63F445Y8FyTzlNWzXmiI8EG0nLcOuBP7zQCo2Ahxqr9jhdicf StqhVTxg==; From: Valentin Gagarin To: devel@spectrum-os.org Subject: [PATCH v5] Documentation: add logo to site header Date: Wed, 27 May 2026 13:24:08 +0200 Message-ID: <20260527112408.14580-1-valentin@gagarin.work> In-Reply-To: <20260520085723.135653-1-valentin@gagarin.work> References: <20260520085723.135653-1-valentin@gagarin.work> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Authenticated-Id: valentin@gagarin.work Message-ID-Hash: 26GZN2Q7XYL4WWOCEOYESFHMISFEUBWU X-Message-ID-Hash: 26GZN2Q7XYL4WWOCEOYESFHMISFEUBWU X-MailFrom: valentin@gagarin.work X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-devel.spectrum-os.org-0; header-match-devel.spectrum-os.org-1; header-match-devel.spectrum-os.org-2; header-match-devel.spectrum-os.org-3; header-match-devel.spectrum-os.org-4; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Valentin Gagarin X-Mailman-Version: 3.3.9 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: Also spell out the title. The stylesheet adjustment makes the logo align properly with the longer title text for different display widths. Override the title template to show both the title text and the logo. Signed-off-by: Valentin Gagarin --- Documentation/_config.yml | 3 ++- Documentation/_includes/title.html | 13 +++++++++++++ Documentation/_sass/custom/custom.scss | 23 ++++++++++++++++++++++- 3 files changed, 37 insertions(+), 2 deletions(-) create mode 100644 Documentation/_includes/title.html diff --git a/Documentation/_config.yml b/Documentation/_config.yml index 90018ba..dbc4f7a 100644 --- a/Documentation/_config.yml +++ b/Documentation/_config.yml @@ -1,7 +1,8 @@ # SPDX-License-Identifier: CC0-1.0 # SPDX-FileCopyrightText: 2022 Alyssa Ross --- -title: Spectrum Docs +title: Spectrum documentation +logo: "https://spectrum-os.org/logo/logo_html.svg" theme: just-the-docs aux_links: Home: diff --git a/Documentation/_includes/title.html b/Documentation/_includes/title.html new file mode 100644 index 0000000..90ef71b --- /dev/null +++ b/Documentation/_includes/title.html @@ -0,0 +1,13 @@ +{% comment %} +SPDX-License-Identifier: MIT +SPDX-FileCopyrightText: 2016 Patrick Marsceill +SPDX-FileCopyrightText: 2026 Valentin Gagarin + +Override of: https://github.com/just-the-docs/just-the-docs/blob/v0.10.1/_includes/title.html +{% endcomment %} +{% if site.logo %} + +{% endif %} +{% if site.title %} + {{ site.title }} +{% endif %} diff --git a/Documentation/_sass/custom/custom.scss b/Documentation/_sass/custom/custom.scss index fd5a676..48b1d41 100644 --- a/Documentation/_sass/custom/custom.scss +++ b/Documentation/_sass/custom/custom.scss @@ -1,5 +1,6 @@ -// SPDX-FileCopyrightText: 2022 Alyssa Ross // SPDX-License-Identifier: MIT +// SPDX-FileCopyrightText: 2022 Alyssa Ross +// SPDX-FileCopyrightText: 2026 Valentin Gagarin .main-content { // Just the Docs puts titles next to definitions, rather than on @@ -20,3 +21,23 @@ margin-left: 2ch; } } + +// Make the logo and title fit the site header. +.site-header { + .site-logo { + width: 3rem; + } + + // Just the Docs displays a sidebar at the "medium size" `md` breakpoint and above. + // Use the upstream `mq` media query mixin to target that breakpoint. + // https://just-the-docs.com/docs/utilities/responsive-modifiers/ + // https://github.com/just-the-docs/just-the-docs/blob/v0.10.1/_sass/support/mixins/_layout.scss#L3-L8 + @include mq(md) { + .site-logo { + width: 5.5rem; + } + .site-title { + font-size: 1.25rem !important; + } + } +} -- 2.51.2