Astrologue-Website

Astrologue website

The Astrologue operating system's website — a fusion of the two designs kept in this repository: the layout and craft of the AI-generated proposal, re-themed as a medieval sky almanac around the real branding, photography, and voice of the original site.

Structure

index.html              home page
developer/              Developer section: index.html (catalogue) + one
                        documentation page per library (11 projects)
assets/css/style.css    shared design system (light + dark via prefers-color-scheme)
assets/img/             logo (light/dark), Milky Way hero, star and people photography
assets/fonts/           self-hosted fonts (woff2, latin subset) + SIL Open Font License texts
check.py                site checker: python3 check.py . (links, assets, no external refs)
tools/qa-crawl.py       serves the site and crawls every subresource, asserting
                        every request stays on 127.0.0.1 (no CDN, no external fonts)
tools/qa-consistency.py programmatic 13-page audit: masthead/footer identity,
                        aria-current placement, head meta set, pager chain,
                        breadcrumbs, root-relative links, a11y spot checks
tools/qa-pages.py       headless-Chromium render sweep (overflow, broken images,
                        light/dark body colour flip, sticky ToC) via CDP
LICENSE                 GPL-3.0-or-later (full text)
Original/               reference design — the original live site (do not edit)
Proposed/               reference design — the AI-generated proposal (do not edit)

Original/ and Proposed/ are kept for reference only; the site lives at the repository root.

Deploy

There is no build step. Copy (or serve) the repository root:

rsync -av --exclude Original --exclude Proposed ./ user@host:/srv/www/astrologue/

Any static file server will do. The site makes zero external requests — fonts are local, images are local — so it works offline and on community networks as-is. All links are page-relative, so the tree can be deployed at any URL path (document root or a subdirectory) without modification.

Conventions

• Hand-written HTML and CSS, one shared stylesheet, no JavaScript.
• Light and dark schemes are automatic (prefers-color-scheme); the logo swaps variants with the scheme.
• Content is honest by rule: no invented releases, dates, hashes, or news. News is an explicit empty state until there is news; download rows are commented templates until there are artifacts.
• Fonts are subset with pyftsubset from the OFL upstreams (Cinzel and EB Garamond); keep the licence files beside them.

Licence

The site is free software: GPL-3.0-or-later (see LICENSE). Fonts are redistributed under the SIL Open Font License 1.1 (see assets/fonts/).