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 8C6718D92; Sun, 31 May 2026 11:10:58 +0000 (UTC) Received: by atuin.qyliss.net (Postfix, from userid 993) id 72DBF8D8D; Sun, 31 May 2026 11:10:56 +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.1 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,DMARC_MISSING,SPF_HELO_PASS autolearn=unavailable autolearn_force=no version=4.0.1 Received: from fhigh-a8-smtp.messagingengine.com (fhigh-a8-smtp.messagingengine.com [103.168.172.159]) by atuin.qyliss.net (Postfix) with ESMTPS id F0EDE8D8A for ; Sun, 31 May 2026 11:10:53 +0000 (UTC) Received: from phl-compute-10.internal (phl-compute-10.internal [10.202.2.50]) by mailfhigh.phl.internal (Postfix) with ESMTP id 4ABA01400036; Sun, 31 May 2026 07:10:52 -0400 (EDT) Received: from phl-frontend-04 ([10.202.2.163]) by phl-compute-10.internal (MEProxy); Sun, 31 May 2026 07:10:52 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=alyssa.is; h=cc :cc:content-type:content-type:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:subject :subject:to:to; s=fm2; t=1780225852; x=1780312252; bh=iO0IAnYlDU LWUh5KO1lH29lA/y/HqwpoPXYuOXKRt8c=; b=uhAz494QEMZ5kDn4HLldQ+4DCu MJJOW5o6BkhVsXqQLj2CzaFqKhxsFnxbytYh6XMLnmlqtTcBtkdjC/5pGEN/+3Sh kEbslNg9l8nb5MbPxBtnalFkbvxiYYzHAdzzwGwG07vKYd69/PB+/SnaOhHnJHiy 3mYnPYaOt+FGbPxaSKm1J5BBIM6zoYSYT1mod+2yC7HZ7xFA/+5GlKAPNCYSByoY 8z6llpeON3+2fKAmp5IikFyoAMlc7puD3qLOKVrfU7wVcroo+f/dzsmkB1K8TKJx zby3KUoSEPWNZYlLkKJiK0eKd6EgCzW3L86TFv/F3QxSCDJo/8w5Y218wSQw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm3; t= 1780225852; x=1780312252; bh=iO0IAnYlDULWUh5KO1lH29lA/y/HqwpoPXY uOXKRt8c=; b=GIlNTwt7VHzI5GWHAUUtLTFFmT/omjyo4YMUlKLQEzKRYUQV9dW XswC0stG+TGEb0pGlYD1tqsJYwC93KnI0wB7C0484HOlWGPjPccUJk2auGLSqOsr aUXIw67ap3M2E0nNcDy4bn901NQH9SSs997rpXVkCAfWRwuMidbxGWlZB4Ym/jG3 hhpDRbJd8KVL47hdTMXhKhYFykHlCGAzHtf0z5rf6+ridNYpoJE0JPUbSYvfryTp vBaVYHzsDy1kzH3Qitn3P2+iby1rbe6r4Nj3WZ3Il/FFD87Elx0oVM+rWJgGYWqp LY/jN/9/H2CUCKTPP9JLggX8sCXJ2q0s7Ww== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: dmFkZTEhaYT5UOneJJcnwDr7hGrJllywLxL99hs7oPwGvVOYCVVxGzV+T8h6RlGfwnM+LP 3JvOT+meFccJhgoPdvKEfHw+nAEe1SfGfLRFywUB9QgriHkZi/AlHjSVvPlWT4ndZoNClO PsGQGifYjLjcK9ckJKhx4kHmOUarOm55iA2vkWel1+WbtQtdVVlus5CWvv3h4EGj6cHEXU jobOXQChviqSyl9cokCuNh2YooYAaLp/TDPACeE3yLQ5TU/uIq2MIgsmxdig5jDNh+W6ZF ssusdq8PTKJOqOhezvkX+VncuE3l9V7ysUeT1IaC0skgdj0wvGrt96lZSCplXctZcCl5nS Vp+vzCR1g2t7tbl5BQbayXwQnKsorCjnBY4sIG2SDFDrovhbI2U9gQRuw0RuYWHMlRBYRD kR2sD+IeYDAFzzQJyT9Ppmou6XOsN0VBJgtU3UHEHKfdEENuurpflw3CT8PWn91eJXXPXZ YPLGmwY4WPCe3DwiUE9GE7OPe9OsvTo5c9ZLuxLEyAZT2wNtFn5dSRUz8Hc+AOP+MSoGRg fCR6WeCO5k/bflHHxfh8bLnEHyQOgycrLcCOWnagjYPwtHat3IIG3BuERE+3dWzM7CJZGx XJQ/PeZ6cu/3+iaj5eX+Gy/w9INDMo2rizPU3Fe7DsEpZYQGHecY6sCUDS2Q X-ME-Proxy: Feedback-ID: i12284293:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Sun, 31 May 2026 07:10:51 -0400 (EDT) Received: by fw12.qyliss.net (Postfix, from userid 1000) id 827AAB2CC5A9; Sun, 31 May 2026 13:10:48 +0200 (CEST) From: Alyssa Ross To: Valentin Gagarin Subject: Re: [PATCH v1] Documentation: render the whole site through Jekyll In-Reply-To: <20260528090513.105612-1-valentin@gagarin.work> References: <20260528090513.105612-1-valentin@gagarin.work> Date: Sun, 31 May 2026 13:10:46 +0200 Message-ID: <87ldczal6x.fsf@alyssa.is> MIME-Version: 1.0 Content-Type: multipart/signed; boundary="=-=-="; micalg=pgp-sha512; protocol="application/pgp-signature" Message-ID-Hash: OY5KQM2PYQYGHNX2F7SANHD3HFQVURYE X-Message-ID-Hash: OY5KQM2PYQYGHNX2F7SANHD3HFQVURYE X-MailFrom: hi@alyssa.is 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: devel@spectrum-os.org 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: --=-=-= Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Valentin Gagarin writes: > With the website merged in, there's no longer a reason to handle the > landing pages and the documentation through separate pipelines. > > Also reinstate the relevant parts of the www README for the static > pages for the time being, and update the license informaton accordingly. > > To keep behavior as it is and the diff minimal, patch the documentation > site header to point to the documentation instead of the toplevel. Needs a Signed-off-by. (You can just reply with it.) > diff --git a/Documentation/README b/Documentation/README > index 85673f0..8c7af40 100644 > --- a/Documentation/README > +++ b/Documentation/README > @@ -1,2 +1,32 @@ > +These files contain the static portion of the website accessible at > +. CGit, Mailman, etc, are run seperately. This seems to have been taken from a pre-ee934976 ("README: fix spelling") commit =E2=80=94 release/checks/codespell.nix fails with this applied. I can naturally fix this up myself when applying. Aside from that: Reviewed-by: Alyssa Ross Tested-by: Alyssa Ross I'll prepare the corresponding change to the server config. > + > +If you would like to contribute to the Spectrum operating system itself,= please > +refer to the contributing.html file. > + > If you'd like to contribute to the documentation, > see building-documentation.adoc for how to get started. > + > +Design tweaks, content updates, fixes (both factual and grammatical), > +and new content for the Spectrum website are all welcomed. > + > +Try to keep lines at around 70 characters, HTML out of the way as much > +as possible while still being valid (did you know

can > +self-close?), and CSS to a minimum. We want to optimise for the > +website being as nice as possible to navigate in a text editor, to > +encourage people to edit and improve the website. > + > +For any changes that are likely to be copyrightable (i.e. those that > +involve any amount of creative input from you), please add an > +SPDX-FileCopyrightText header to the file so we can keep track of > +copyright holders. Every file should already have at least one > +example of these that you can use as a template. If you'd rather not > +list your email address in the copyright notice, it's fine to omit > +that. I assume this will be deduplicated/moved into some more generic > diff --git a/Documentation/_config.yml b/Documentation/_config.yml > index 277992d..df84cb5 100644 > --- a/Documentation/_config.yml > +++ b/Documentation/_config.yml > @@ -2,7 +2,7 @@ > # SPDX-FileCopyrightText: 2022 Alyssa Ross > --- > title: Spectrum documentation > -logo: "https://spectrum-os.org/logo/logo_html.svg" > +logo: /logo/logo_html.svg > theme: just-the-docs > aux_links: > Home: The Home link, and some others in the Documentation tree, could also be made non-absolute now I think. I can do that once this is applied. > diff --git a/Documentation/_plugins/site_title_link.rb b/Documentation/_p= lugins/site_title_link.rb > new file mode 100644 > index 0000000..4095701 > --- /dev/null > +++ b/Documentation/_plugins/site_title_link.rb > @@ -0,0 +1,10 @@ > +# SPDX-License-Identifier: EUPL-1.2+ > +# SPDX-FileCopyrightText: 2026 Valentin Gagarin > + > +# Just the Docs hardcodes the site header link to `/`. > +# https://github.com/just-the-docs/just-the-docs/blob/v0.10.1/_includes/= components/sidebar.html#L14 > +# Make it point to the docs root, not the top-level site. > +Jekyll::Hooks.register [:pages, :documents], :post_render do |item| > + item.output.sub!(' + ' +end Clever. --=-=-= Content-Type: application/pgp-signature; name="signature.asc" -----BEGIN PGP SIGNATURE----- iHUEARYKAB0WIQQGoGac7QfI+H5ZtFCZddwkt31pFQUCahwXNwAKCRCZddwkt31p FQR5AP4pGWveHtOAz53HDbsarqx15myt9+lIgnnO0sEP2cTFxQEAxvLv44pyu2UT EBzrY/+vOGYrWlwnOtdJa9mSf/SGHgE= =7fKT -----END PGP SIGNATURE----- --=-=-=--