patches and low-level development discussion
 help / color / mirror / code / Atom feed
From: Valentin Gagarin <valentin@gagarin.work>
To: devel@spectrum-os.org
Cc: Valentin Gagarin <valentin@gagarin.work>
Subject: [PATCH v2] Documentation: add logo to site header
Date: Fri, 15 May 2026 19:56:49 +0200	[thread overview]
Message-ID: <20260515175649.35166-1-valentin@gagarin.work> (raw)
In-Reply-To: <20260514192145.15648-1-valentin@gagarin.work>

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.

[title template]: https://github.com/just-the-docs/just-the-docs/blob/f43d7cfc4b1e18a97e6d6d20b88f1aaeda0e7196/_includes/title.html

Signed-off-by: Valentin Gagarin <valentin@gagarin.work>
---
 Documentation/_config.yml              |  3 ++-
 Documentation/_includes/title.html     |  6 ++++++
 Documentation/_sass/custom/custom.scss | 13 +++++++++++++
 3 files changed, 21 insertions(+), 1 deletion(-)
 create mode 100644 Documentation/_includes/title.html

diff --git a/Documentation/_config.yml b/Documentation/_config.yml
index 90018ba..192633b 100644
--- a/Documentation/_config.yml
+++ b/Documentation/_config.yml
@@ -1,7 +1,8 @@
 # SPDX-License-Identifier: CC0-1.0
 # SPDX-FileCopyrightText: 2022 Alyssa Ross <hi@alyssa.is>
 ---
-title: Spectrum Docs
+title: Spectrum OS 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..36a4017
--- /dev/null
+++ b/Documentation/_includes/title.html
@@ -0,0 +1,6 @@
+{% if site.logo %}
+  <div class="site-logo" role="img" aria-label="{{ site.title }}"></div>
+{% endif %}
+{% if site.title %}
+  {{ site.title }}
+{% endif %}
diff --git a/Documentation/_sass/custom/custom.scss b/Documentation/_sass/custom/custom.scss
index fd5a676..75e3f16 100644
--- a/Documentation/_sass/custom/custom.scss
+++ b/Documentation/_sass/custom/custom.scss
@@ -20,3 +20,16 @@
 		margin-left: 2ch;
 	}
 }
+
+.site-logo {
+  width: 3rem;
+}
+
+@media (min-width: 50rem) {
+  .site-logo {
+    width: 5.5rem;
+  }
+  .site-title {
+    font-size: 1.25rem !important;
+  }
+}
-- 
2.51.2


  reply	other threads:[~2026-05-15 17:57 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2026-05-14 19:21 [PATCH] Documentation: add logo to site header Valentin Gagarin
2026-05-15 17:56 ` Valentin Gagarin [this message]
2026-05-18  6:40   ` [PATCH v2] " Alyssa Ross
2026-05-18 21:04   ` [PATCH v3] " Valentin Gagarin
2026-05-20  8:57     ` [PATCH v4] " Valentin Gagarin

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=20260515175649.35166-1-valentin@gagarin.work \
    --to=valentin@gagarin.work \
    --cc=devel@spectrum-os.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://spectrum-os.org/git/crosvm
	https://spectrum-os.org/git/doc
	https://spectrum-os.org/git/mktuntap
	https://spectrum-os.org/git/nixpkgs
	https://spectrum-os.org/git/spectrum
	https://spectrum-os.org/git/ucspi-vsock
	https://spectrum-os.org/git/www

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).