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 2BE058C73; Tue, 16 Jun 2026 09:36:05 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 993) id 571B18C5A; Tue, 16 Jun 2026 09:36:02 +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=CONTENT_AFTER_HTML,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-mta132.mxroute.com (mail-108-mta132.mxroute.com [136.175.108.132]) by atuin.qyliss.net (Postfix) with ESMTPS id EEDD08C59 for ; Tue, 16 Jun 2026 09:35:59 +0000 (UTC) Received: from filter006.mxroute.com ([136.175.111.3] filter006.mxroute.com) (Authenticated sender: mN4UYu2MZsgR) by mail-108-mta132.mxroute.com (ZoneMTA) with ESMTPSA id 19ecfc9969200067f7.001 for (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Tue, 16 Jun 2026 09:35:55 +0000 X-Zone-Loop: 8ed70d099f060a0d0c98049355f3408de6603daea04e 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:Content-Type:MIME-Version: References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To: 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=k9xjK8urvb7QQL3OWY9pJvcGgYx9Qn2g3ZAl2eKdqmM=; b=nBW8Tjsl/QMXsR3Nt2AOZjnImB Z367VUkqVK6TO8m3q8KXTUxhGk4V21H/hcepcabzmrjysww8RZ2zs2XMaZO7hJv82z8CsmVuhKa3U AZyE3r0yUlTq8eLIA2igk7XF52I3ttmdOZyVeqUFBn2nVrCIPuqqmm0D6lzhqDVt9h3gEE3IT7BN+ kaWIfNOnNhH9lMs6b3m05rHCVcFJ8QTWIzPMbmFi5Ss+EwKIsfpbhBA+EMMd9bY7M0dgkXAIkQMBA pLr6vRM3dQ41adIMEXHiD5JCYmDYXu7dR5y+VEUlKyz8KP0zCxEtTBaF4EDJAdvyhB8GBtUzYJEFL EC1OAGOA==; From: Valentin Gagarin To: devel@spectrum-os.org Subject: [PATCH v3 0/3] Documentation: render all pages in one style Date: Tue, 16 Jun 2026 11:35:20 +0200 Message-ID: <20260616093527.388679-1-valentin@gagarin.work> In-Reply-To: <20260608164938.290202-1-valentin@gagarin.work> References: <20260608164938.290202-1-valentin@gagarin.work> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Authenticated-Id: valentin@gagarin.work Message-ID-Hash: IXHULRAQSM6X3G5YHHFOKMKLRG6XQ6KX X-Message-ID-Hash: IXHULRAQSM6X3G5YHHFOKMKLRG6XQ6KX X-MailFrom: valentin@gagarin.work X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; 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; emergency; member-moderation; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header CC: Valentin Gagarin X-Mailman-Version: 3.3.10 Precedence: list List-Id: Patches and low-level development discussion Archived-At: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: After some out-of-band discussion I decided to make the navigation structure more literal. That has the advantage of being slightly less source code and slightly smaller output, but more importantly it seems to degrade more gracefully and less noisily for limited clients, such as screen readers and text browsers. Since the overall change is really large and the changes may be hard to spot, here's the diff against v2. diff --git a/Documentation/_includes/breadcrumb.html b/Documentation/_includes/breadcrumb.html index f759807..3b93128 100644 --- a/Documentation/_includes/breadcrumb.html +++ b/Documentation/_includes/breadcrumb.html @@ -4,20 +4,18 @@ SPDX-FileCopyrightText: 2026 Valentin Gagarin {% endcomment %} {%- unless page.url == '/' -%} {%- endunless -%} diff --git a/Documentation/_includes/footer_custom.html b/Documentation/_includes/footer.html similarity index 82% rename from Documentation/_includes/footer_custom.html rename to Documentation/_includes/footer.html index db29f82..d0e2c0b 100644 --- a/Documentation/_includes/footer_custom.html +++ b/Documentation/_includes/footer.html @@ -3,18 +3,19 @@ SPDX-FileCopyrightText: 2020 Alyssa Ross SPDX-License-Identifier: CC-BY-SA-4.0 OR GFDL-1.3-no-invariants-or-later {% endcomment %}

-Permission is granted to copy, distribute and/or modify this +Permission is granted to copy, distribute and/or modify this document under either the terms of the Creative Commons Attribution-ShareAlike 4.0 International License, or the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no -Front-Cover Texts, and no Back-Cover Texts. +Front-Cover Texts, and no Back-Cover Texts. -

+

diff --git a/Documentation/_includes/sitemap.html b/Documentation/_includes/sitemap.html index 51c5bb0..26e96ec 100644 --- a/Documentation/_includes/sitemap.html +++ b/Documentation/_includes/sitemap.html @@ -33,7 +33,9 @@ which we assume if it is constructed by a directory and contains an index file. `assign` is page-global. A recursive include below may have overwritten `prefix`. {%- endcomment %} {%- assign prefix = include.prefix | default: default_root -%} - {%- assign suffix = p.url | remove_first: prefix -%} + {%- assign url_start = p.url | slice: 0, prefix.size -%} + {%- if url_start == prefix -%} + {%- assign suffix = p.url | slice: prefix.size, p.url.size -%} {%- assign without_slashes = suffix | replace: "/", "" -%} {%- assign slashes = suffix.size | minus: without_slashes.size -%} {%- assign is_index = false -%} @@ -51,6 +53,7 @@ which we assume if it is constructed by a directory and contains an index file. {%- endif -%} {%- endif -%} + {%- endif -%} {%- endfor -%} {%- endcapture -%} {%- assign trimmed = inner | strip -%} diff --git a/Documentation/_layouts/page.html b/Documentation/_layouts/page.html index f2cf0f6..4eba50d 100644 --- a/Documentation/_layouts/page.html +++ b/Documentation/_layouts/page.html @@ -24,5 +24,5 @@ SPDX-FileCopyrightText: 2026 Valentin Gagarin {{ content }} -{% include footer_custom.html %} +{% include footer.html %} diff --git a/Documentation/contributing.html b/Documentation/contributing.html index 6e5fc00..9bb21d8 100644 --- a/Documentation/contributing.html +++ b/Documentation/contributing.html @@ -22,8 +22,8 @@ If you're interested in contributing code to Spectrum, you can find the source repositories online. -If you've made changes you'd like to be included -in the official Spectrum distribution, please send patches to the +If you've made changes you'd like to be included in the official +Spectrum distribution, please send patches to the spectrum-devel mailing list (devel@spectrum-os.org). diff --git a/Documentation/style.css b/Documentation/style.css index 44060b3..ae617c5 100644 --- a/Documentation/style.css +++ b/Documentation/style.css @@ -26,16 +26,8 @@ var { background: yellow; } -nav[aria-label="Breadcrumb"] ol { - list-style: none; - padding: 0; - display: flex; - flex-wrap: wrap; -} - -nav[aria-label="Breadcrumb"] li + li::before { - content: "/"; - padding: 0 0.5em; +footer { + font-size: small; } :root { -- 2.54.0