6490e5c759
Niveus is the interface language the project uses from here on -- this site
first, applications after it. Rebuilding the site on it is what proves the
system is one, rather than a folder of CSS with a README.
**`style.css` is gone.** 21 KB that transcribed include/theme.h by hand:
palette, type scale, shadows, spacing, every component. The intent was right --
"a site describing an operating system should look like the operating system"
-- and the mechanism was a copy, which means two files that have to be kept in
step by remembering to. What replaced it is `app.css`, which is layout and
nothing else, and one declaration in each page:
:root { --nv-brand: #7C5CFF; }
That is SCH_ACCENT. Niveus derives the accent and its states, the link colour,
the focus ring, the tint in the greys and how far the status colours lean, for
light and dark both. One number to keep true instead of forty.
**The site is now adaptive.** Dark by default, because the OS is dark, with a
Light/Dark/Auto group in the bar that is real. The choice is kept in
localStorage and re-applied by an inline script before first paint, so the page
never renders in one appearance and corrects itself while you watch.
**PSOGM keeps its one purple, and now says so structurally.** #4B1D9A is
spelled the way Niveus spells a subtree with its own colour -- `data-nv-brand`
with its own `--nv-brand` on that section -- so every role inside re-derives
from it rather than being painted on. Still exactly one place, which is what
branding/README.md asks for.
Content is unchanged; what changed is what it is made of. Cards are `.nv-card`,
tags are `.nv-badge`, the support table is `.nv-table`, the crash section is a
`.nv-bed`, and the docs reader's two rails are `.nv-nav--vertical` with the
current document marked by `aria-current` rather than a class of our own.
`docs.js` emits `.nv-table` and `.nv-code`, so a change to the system reaches
the documentation too.
Three things were found by looking at it in a browser rather than by reading
it, and all three are the same mistake: **a `.nv-card` carries no padding of
its own -- its parts do.** The stat tiles, the "One ISO, one stick" band and
the card headers were all built from bare children, so numbers ran to the card
edge, the USB mark hung off it, and a title and its badge sat at opposite ends
of a row meant for a title and a trailing slot. Where the component had a right
way to say it, the markup now says it that way; where it did not -- a tile has
no parts -- `app.css` supplies the padding and says why.
Checked: every nv- class used across the three pages and docs.js exists in the
CSS, every token referenced by app.css is defined, and app.css contains no hex
value at all. Niveus's own tools/check.py passes.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
104 lines
3.9 KiB
HTML
104 lines
3.9 KiB
HTML
<!DOCTYPE html>
|
|
<html lang="en" data-theme="dark">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<meta name="viewport" content="width=device-width, initial-scale=1">
|
|
<title>Docs — SchOS</title>
|
|
<meta name="description" content="The SchOS documentation: architecture, guides, plans and the history of the bugs worth remembering.">
|
|
<link rel="icon" href="Assets/shift.svg" type="image/svg+xml">
|
|
|
|
<link rel="stylesheet" href="niveus/dist/niveus.css">
|
|
<script src="niveus/niveus/niveus.js" defer></script>
|
|
<link rel="stylesheet" href="app.css">
|
|
|
|
<script>
|
|
try {
|
|
var saved = localStorage.getItem("schos-theme");
|
|
if (saved === "system") document.documentElement.removeAttribute("data-theme");
|
|
else if (saved) document.documentElement.setAttribute("data-theme", saved);
|
|
} catch (e) { /* storage unavailable — keep the default */ }
|
|
</script>
|
|
|
|
<style>
|
|
:root { --nv-brand: #7C5CFF; }
|
|
</style>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<nav class="nv-nav" aria-label="Main" style="--nv-selection-name: nv-schos-nav">
|
|
<a class="nv-nav__brand" href="index.html">
|
|
<img class="nv-nav__icon" src="Assets/shift.svg" alt="">
|
|
SchOS
|
|
</a>
|
|
|
|
<ul class="nv-nav__list">
|
|
<li><a class="nv-nav__item" href="index.html">Home</a></li>
|
|
<li><a class="nv-nav__item" href="download.html">Download</a></li>
|
|
<li><a class="nv-nav__item" href="docs.html" aria-current="page">Docs</a></li>
|
|
</ul>
|
|
|
|
<span class="nv-nav__spacer"></span>
|
|
|
|
<a class="pride" href="#pride-note"
|
|
title="SchOS stands with the LGBTQIAP+ community — every month of the year">
|
|
<img src="Assets/pride.svg" alt="Progress Pride flag">
|
|
</a>
|
|
|
|
<div class="nv-button-group appearance" role="group" aria-label="Appearance">
|
|
<button class="nv-button nv-button--sm" data-nv-theme="light" aria-pressed="false">Light</button>
|
|
<button class="nv-button nv-button--sm" data-nv-theme="dark" aria-pressed="true">Dark</button>
|
|
<button class="nv-button nv-button--sm" data-nv-theme="system" aria-pressed="false">Auto</button>
|
|
</div>
|
|
</nav>
|
|
|
|
<!-- Index, document, contents. Three columns that become one on a narrow
|
|
screen, in that order, because that is their order of importance when
|
|
there is only room for the middle one. -->
|
|
<div class="docshell">
|
|
<aside class="docshell__aside" aria-label="Documentation index">
|
|
<nav class="nv-nav nv-nav--vertical nv-nav--static docnav" id="docnav"
|
|
style="--nv-selection-name: nv-docs-index"></nav>
|
|
</aside>
|
|
|
|
<main class="docshell__main">
|
|
<article class="nv-prose doc" id="doc" aria-live="polite">
|
|
<p class="nv-text-tertiary">Loading…</p>
|
|
</article>
|
|
</main>
|
|
|
|
<aside class="docshell__rail" aria-label="On this page">
|
|
<nav class="nv-nav nv-nav--vertical nv-nav--static docnav" id="toc"
|
|
style="--nv-selection-name: nv-docs-toc" hidden></nav>
|
|
</aside>
|
|
</div>
|
|
|
|
<footer class="shell site-footer">
|
|
<div class="nv-divider"></div>
|
|
<div class="site-footer__row">
|
|
<span class="nv-body">SchOS — kernel <b>SchIFT</b>, filesystem <b>SchFS</b>.</span>
|
|
<span class="nv-code nv-text-tertiary">Apache-2.0, with the xv6-derived core under MIT.</span>
|
|
</div>
|
|
|
|
<p class="nv-body nv-text-secondary pride-note" id="pride-note">
|
|
<img src="Assets/pride.svg" alt="">
|
|
Built by, and for, people of every orientation and gender identity.
|
|
The flag stays up all year.
|
|
</p>
|
|
|
|
<p class="nv-body nv-text-secondary nv-prose" id="ai-note">
|
|
<b class="nv-text-primary">On AI.</b>
|
|
Parts of SchOS were written with AI assistance, and that is not the measure
|
|
of anything. A project is good when the people building it understand what
|
|
was built, and bad when nobody does — whoever, or whatever, typed it. Vibe
|
|
your way through and you get something no one can fix. Stay in the loop and
|
|
you get a system you can explain line by line. The bug writeups in
|
|
<a href="docs.html?doc=history/kernel.md">history/</a> are where that gets
|
|
checked, including the wrong turns.
|
|
</p>
|
|
</footer>
|
|
|
|
<script src="docs.js"></script>
|
|
<script src="app.js"></script>
|
|
</body>
|
|
</html>
|