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 0D39B8E12; Tue, 16 Jun 2026 09:36:54 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 993) id C913F8DAF; Tue, 16 Jun 2026 09:36:51 +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-mta190.mxroute.com (mail-108-mta190.mxroute.com [136.175.108.190]) by atuin.qyliss.net (Postfix) with ESMTPS id 513098D7C for ; Tue, 16 Jun 2026 09:36:50 +0000 (UTC) Received: from filter006.mxroute.com ([136.175.111.3] filter006.mxroute.com) (Authenticated sender: mN4UYu2MZsgR) by mail-108-mta190.mxroute.com (ZoneMTA) with ESMTPSA id 19ecfca54e400067f7.001 for (version=TLSv1.3 cipher=TLS_AES_256_GCM_SHA384); Tue, 16 Jun 2026 09:36:44 +0000 X-Zone-Loop: aa02c47588e133fd33cf5472c4b4dade38392969a185 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=K3CYPZnmNNg3Z8BcWtd8fDIuqFgrOay19emM0yfpNFY=; b=Y+a9lInhnJ3i9Novhx/9RNBoKE qPhf51cuWTDRY3nqln9yehBYZzlvUgB8S/9/WQwcxfUQUTTEXAUtTyPSBKAaux3wGAWq7RB+DqlpN iBA2aM72wPli6XNmAIoG9iWkA27ZHib57DFkss4+61C25AUIZtH0fVT6+7DvqSl5Ft0IuZ0vvO0NC 5H6Ly9Tw6VIq3GjOE4AujpBuCYk5h6Vaf8pgejyYXv8hOScXbCPbdgNtspwSQr4f7yhxVzNy/Obbi aSyVg8tGtBp/+ivgQWcLhU7IYJ3hCGxgoDzRlvarcRPrujYGYyfivCKRSSCcO/EAPvrYljveeFLxU 6yXTrv9Q==; From: Valentin Gagarin To: devel@spectrum-os.org Subject: [PATCH v3 3/3] Documentation: uniform navigation across all pages Date: Tue, 16 Jun 2026 11:35:23 +0200 Message-ID: <20260616093527.388679-4-valentin@gagarin.work> In-Reply-To: <20260616093527.388679-1-valentin@gagarin.work> References: <20260608164938.290202-1-valentin@gagarin.work> <20260616093527.388679-1-valentin@gagarin.work> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Authenticated-Id: valentin@gagarin.work Message-ID-Hash: 2Z5AZV6BL3NUCO6FLEBFLW7F7L5X2GDJ X-Message-ID-Hash: 2Z5AZV6BL3NUCO6FLEBFLW7F7L5X2GDJ 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: - Render breadcrumb navigation for all pages - Use common page layout for hard-coded HTML pages - Sort hard-coded HTML into sitemap - Show link to source in the footer Signed-off-by: Valentin Gagarin --- Documentation/_includes/breadcrumb.html | 21 ++++++++++ .../{footer_custom.html => footer.html} | 16 ++++---- Documentation/_includes/sitemap.html | 7 +++- Documentation/_layouts/page.html | 15 +++---- Documentation/bibliography.html | 38 +++--------------- Documentation/contributing.html | 38 +++--------------- Documentation/design.html | 38 +++--------------- Documentation/doc/index.adoc | 3 +- Documentation/impressum.html | 35 +++-------------- Documentation/index.html | 33 +++------------- Documentation/logo/index.html | 38 +++--------------- Documentation/motivation.html | 38 +++--------------- .../software/cloud-hypervisor/index.html | 39 ++----------------- Documentation/software/index.html | 38 +++--------------- Documentation/style.css | 4 ++ 15 files changed, 92 insertions(+), 309 deletions(-) create mode 100644 Documentation/_includes/breadcrumb.html rename Documentation/_includes/{footer_custom.html => footer.html} (72%) diff --git a/Documentation/_includes/breadcrumb.html b/Documentation/_includes/breadcrumb.html new file mode 100644 index 0000000..3b93128 --- /dev/null +++ b/Documentation/_includes/breadcrumb.html @@ -0,0 +1,21 @@ +{% comment %} +SPDX-License-Identifier: GPL-3.0-or-later +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 72% rename from Documentation/_includes/footer_custom.html rename to Documentation/_includes/footer.html index ab55e04..d0e2c0b 100644 --- a/Documentation/_includes/footer_custom.html +++ b/Documentation/_includes/footer.html @@ -3,19 +3,19 @@ SPDX-FileCopyrightText: 2020 Alyssa Ross SPDX-License-Identifier: CC-BY-SA-4.0 OR GFDL-1.3-no-invariants-or-later {% endcomment %}

-Source code for this page - -

-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. -

-Sitemap +

diff --git a/Documentation/_includes/sitemap.html b/Documentation/_includes/sitemap.html index 723bdb3..26e96ec 100644 --- a/Documentation/_includes/sitemap.html +++ b/Documentation/_includes/sitemap.html @@ -18,6 +18,10 @@ which we assume if it is constructed by a directory and contains an index file. {%- assign candidates = site.html_pages | where_exp: "p", "p.url contains prefix" | where_exp: "p", "p.url != prefix" -%} + {%- if prefix == default_root -%} + {%- assign list_with_root_page = site.html_pages | where: "url", prefix -%} + {%- assign candidates = list_with_root_page | concat: candidates -%} + {%- endif -%} {%- comment %} Ordered pages first, ascending. The rest after, in URL order, so output is deterministic. {%- endcomment %} @@ -35,9 +39,10 @@ which we assume if it is constructed by a directory and contains an index file. {%- assign without_slashes = suffix | replace: "/", "" -%} {%- assign slashes = suffix.size | minus: without_slashes.size -%} {%- assign is_index = false -%} - {%- if p.name == "index.adoc" -%}{%- assign is_index = true -%}{%- endif -%} + {%- if p.name == "index.adoc" or p.name == "index.html" -%}{%- assign is_index = true -%}{%- endif -%} {%- assign is_page = false -%} {%- if is_index == false and slashes == 0 -%}{%- assign is_page = true -%}{%- endif -%} + {%- if is_index and suffix == "" -%}{%- assign is_page = true -%}{%- endif -%} {%- assign is_section = false -%} {%- if is_index and slashes == 1 -%}{%- assign is_section = true -%}{%- endif -%} {%- if is_page or is_section %} diff --git a/Documentation/_layouts/page.html b/Documentation/_layouts/page.html index cb1bb7b..4eba50d 100644 --- a/Documentation/_layouts/page.html +++ b/Documentation/_layouts/page.html @@ -3,7 +3,7 @@ SPDX-License-Identifier: GPL-3.0-or-later SPDX-FileCopyrightText: 2026 Valentin Gagarin {% endcomment %} - + @@ -17,15 +17,12 @@ SPDX-FileCopyrightText: 2026 Valentin Gagarin - +{% include breadcrumb.html %} + +{% assign ext = page.path | split: "." | last %} +{% if ext == "html" and page.no_heading != true %}

{{ page.title }}

{% endif %} {{ content }} -{% include footer_custom.html %} +{% include footer.html %} diff --git a/Documentation/bibliography.html b/Documentation/bibliography.html index f9a8efd..175115a 100644 --- a/Documentation/bibliography.html +++ b/Documentation/bibliography.html @@ -1,26 +1,11 @@ - +--- +layout: page +title: Bibliography +nav_order: 200 +--- - - - - - - - - - - -Spectrum Bibliography - - - - - -

Bibliography

If you'd like to find out when new links are posted, subscribe to the cgit @@ -137,16 +122,3 @@ atom feed for this page.

  • cloud-hypervisor - -

    -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. - -

    -Impressum diff --git a/Documentation/contributing.html b/Documentation/contributing.html index ea85499..9bb21d8 100644 --- a/Documentation/contributing.html +++ b/Documentation/contributing.html @@ -1,26 +1,11 @@ - +--- +layout: page +title: Contributing to Spectrum +nav_order: 10 +--- - - - - - - - - - - -Contributing to Spectrum - - - -

    - -

    Contributing to Spectrum

    Thank you so much for your interest in contributing to Spectrum. @@ -104,16 +89,3 @@ on spectrum-disc or in real time on Matrix or IRC. - -

    -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. - -

    -Impressum diff --git a/Documentation/design.html b/Documentation/design.html index 51e0b77..0aa8762 100644 --- a/Documentation/design.html +++ b/Documentation/design.html @@ -1,26 +1,11 @@ - +--- +layout: page +title: Design +nav_order: 2 +--- - - - - - - - - - - -Spectrum Design - - - -

    - -

    Spectrum Design

    Spectrum will, for now, be a Linux-based system, with packages from @@ -96,16 +81,3 @@ diverse range of hardware, to verify that the images correspond to the source code, and are free of tampering. Work like Trustix will be important to reaching this goal. - -

    -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. - -

    -Impressum diff --git a/Documentation/doc/index.adoc b/Documentation/doc/index.adoc index a24d85f..81b2a18 100644 --- a/Documentation/doc/index.adoc +++ b/Documentation/doc/index.adoc @@ -1,5 +1,6 @@ -= Spectrum Documentation += Documentation :page-liquid: +:page-nav_order: 100 // SPDX-FileCopyrightText: 2022 Alyssa Ross // SPDX-FileCopyrightText: 2022 Unikie diff --git a/Documentation/impressum.html b/Documentation/impressum.html index b4806fe..416ce67 100644 --- a/Documentation/impressum.html +++ b/Documentation/impressum.html @@ -1,26 +1,11 @@ - +--- +layout: page +title: Impressum +lang: de +--- - - - - - - - - - - -Impressum - - - -

    - -

    Impressum

    @@ -32,13 +17,3 @@

    hi@alyssa.is

    - -

    -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. diff --git a/Documentation/index.html b/Documentation/index.html index 51685dd..6d6faf7 100644 --- a/Documentation/index.html +++ b/Documentation/index.html @@ -1,20 +1,12 @@ - +--- +layout: page +title: Spectrum, a step towards usable secure computing +no_heading: true +nav_order: 0 +--- - - - - - - - - - - -Spectrum, a step towards usable secure computing - - @@ -95,16 +87,3 @@ initiative by the Digital Single Market of the European Commission.

  • Upstream bug/patch tracking - -

    -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. - -

    -Impressum diff --git a/Documentation/logo/index.html b/Documentation/logo/index.html index 2354062..fbab443 100644 --- a/Documentation/logo/index.html +++ b/Documentation/logo/index.html @@ -1,26 +1,11 @@ - +--- +layout: page +title: Logo +nav_order: 1002 +--- - - - - - - - - - - -Spectrum logo - - - -

    - -

    Logo

    @@ -48,16 +33,3 @@ Mesh Gradients.

  • logo_mesh.svg (for Inkscape) - -

    -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. - -

    -Impressum diff --git a/Documentation/motivation.html b/Documentation/motivation.html index 4cbe5b0..e144251 100644 --- a/Documentation/motivation.html +++ b/Documentation/motivation.html @@ -1,26 +1,11 @@ - +--- +layout: page +title: Motivation for Spectrum +nav_order: 1 +--- - - - - - - - - - - -Motivation for Spectrum - - - -

    - -

    Motivation for Spectrum

    Existing attempts to improve on the security of Unix-like operating @@ -122,16 +107,3 @@ major security issue.

    The last release of SubgraphOS was an alpha in 2017. - -

    -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. - -

    -Impressum diff --git a/Documentation/software/cloud-hypervisor/index.html b/Documentation/software/cloud-hypervisor/index.html index 1845068..9b4315c 100644 --- a/Documentation/software/cloud-hypervisor/index.html +++ b/Documentation/software/cloud-hypervisor/index.html @@ -1,26 +1,10 @@ - +--- +layout: page +title: Cloud Hypervisor with virtio-gpu support +--- - - - - - - - - - - -Cloud Hypervisor with virtio-gpu support - - - -

    - -

    Cloud Hypervisor with virtio-gpu support

    This is a patchset for Cloud @@ -162,18 +146,3 @@ the discuss@spectrum-os.org list, or ask in the Spectrum Matrix chat. - -

    - -

    -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. - -

    -Impressum diff --git a/Documentation/software/index.html b/Documentation/software/index.html index 2a8a852..8b95c2d 100644 --- a/Documentation/software/index.html +++ b/Documentation/software/index.html @@ -1,41 +1,13 @@ - +--- +layout: page +title: Spectrum software +nav_order: 3 +--- - - - - - - - - - - -Spectrum software - - - -

    - -

    Spectrum software

    - -

    -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. - -

    -Impressum diff --git a/Documentation/style.css b/Documentation/style.css index f8cb9da..ae617c5 100644 --- a/Documentation/style.css +++ b/Documentation/style.css @@ -26,6 +26,10 @@ var { background: yellow; } +footer { + font-size: small; +} + :root { --bg: Canvas; --code-bg: whitesmoke; -- 2.54.0