From 11510a863b4f387547afc0122da3bbf2aa780db5 Mon Sep 17 00:00:00 2001 From: nopeitsnothing Date: Sun, 12 Jul 2026 01:24:42 -0400 Subject: [PATCH] fix(css): oops, flat ToC rendering Adjusted a few ToC and navigation settings to fix flat rendering. Also removed `toc.integrate` Fixed margin-left Altered changelog admonition types Fixed admonition title rendering bug (overlap) Signed-off-by: nopeitsnothing --- docs/about/index.md | 1 + docs/changelog/index.md | 26 +++++++++--------- docs/code/index.md | 1 + docs/constitution/index.md | 1 + docs/contribute/index.md | 2 +- docs/guide/index.md | 2 ++ docs/mirrors/index.md | 1 + docs/pgp/index.md | 2 +- docs/stylesheets/navigation.css | 48 ++++++++++++++++++++++++++++++--- docs/verify/index.md | 2 +- mkdocs.yml | 1 - scripts/update_changelog.py | 14 ++++++++-- 12 files changed, 79 insertions(+), 22 deletions(-) diff --git a/docs/about/index.md b/docs/about/index.md index abdd6fd..e24ee0b 100644 --- a/docs/about/index.md +++ b/docs/about/index.md @@ -2,6 +2,7 @@ title: "Anonymous Planet" description: "We are the maintainers of the Hitchhiker's Guide and the PSA Matrix space." hide: + - navigation - toc schema: "@context": https://schema.org diff --git a/docs/changelog/index.md b/docs/changelog/index.md index 7a9751e..47fd45e 100644 --- a/docs/changelog/index.md +++ b/docs/changelog/index.md @@ -1,6 +1,8 @@ --- title: "Changelog" description: "Release notes for the Hitchhiker's Guide to Online Anonymity." +hide: + - navigation schema: "@context": https://schema.org "@type": Organization @@ -32,35 +34,35 @@ schema: ## [v1.2.6-pre1] -!!! Note "Meta" +!!! abstract "Meta" - Various website improvements (CSS) -!!! Note "Changed" +!!! info "Changed" - Adjust keyring path use the new relative path: pgp/anonymousplanet.asc - 02-sign.yml: use a fpr match to lock a specific key - 02-sign.yml: quick mkdir -p repo/export before copying files to the dir - Moved the Acknowledgements section to the bottom -!!! Note "Added" +!!! tip "Added" - COM Class Identifiers (CLSID/GUID) (NEW) - Windows Global Device Identifier (GDID) (NEW) - USB bus telemetry (device enumeration history) (NEW) -!!! Note "Improved" +!!! info "Improved" - Glossary (`docs/includes/glossary.md`) and removed inline expansions where applicable ## [v1.2.5] -!!! Note "Meta" +!!! abstract "Meta" - Website theme customization - License change to accomodate our fiscal host Open Source Collective -!!! Note "Changed" +!!! info "Changed" - Comprehensive updates throughout the guide reflecting the transition to Whonix 18.x as the newest version - Replaced outdated Whonix.org wiki docs links with GitHub releases mirror and Archive.org backups @@ -74,14 +76,14 @@ schema: - Added comprehensive upgrade path guidance with backup procedures - Updated 196! Wikipedia reference links throughout the entire guide -!!! Note "Added" +!!! tip "Added" - All Whonix.org/wiki links now have Archive.org mirror backups for availability - Upgrade path documented: Whonix 17 to 18 with automated release-upgrade support - Detailed Qubes OS compatibility notes for both Whonix versions - You can now get the Anonymous Planet PGP keyring from the site (copy/paste or download) -!!! Note "Improved" +!!! info "Improved" - Virtualbox hardening section reorganized - AppArmor configuration guidance added where applicable (Whonix 18.x) @@ -91,11 +93,11 @@ schema: ## [v1.2.4] -!!! Note "Meta" +!!! abstract "Meta" - Rename workflows (GH - now we can know the order) -!!! Note "Changed" +!!! info "Changed" - Change the repo URL for our tor mirror - Fix recommended reading admonition @@ -115,7 +117,7 @@ schema: CI/CD pipeline split into independent stages, dark PDF quality improved, release signing automated, and the changelog now updates itself on every build. Skipping v1.2.2 which was a placeholder and contained broken Python unsuitable for a tag/release. -???+ tip "Added" +!!! tip "Added" - **Dark mode PDF** (`scripts/convert.py`): pixel-level converter replaces the broken `--prefers-color-scheme=dark` Chromium flag. Produces a 200 DPI hacker-themed PDF (`#1f1f31` background, `#e0e0e0` text, `#5e8bde` links) with batched page processing to avoid OOM on large documents. - **Three independent CI workflows** replacing the old monolithic `build-sign-release.yml`: @@ -151,7 +153,7 @@ CI/CD pipeline split into independent stages, dark PDF quality improved, release First automated PDF build and the start of the CI pipeline. -???+ tip "Added" +!!! tip "Added" - `scripts/build_guide_pdf.py`: builds the MkDocs site and renders the full guide to a single PDF via headless Chromium (Chrome or Edge). Supports `--dark`, `--light`, and `--both` modes. - GitHub Actions workflow that installs Chromium, runs the build script, and uploads `export/thgtoa.pdf` as an artifact on every push to `main` or manual dispatch. diff --git a/docs/code/index.md b/docs/code/index.md index 8bba5ac..17bdab9 100644 --- a/docs/code/index.md +++ b/docs/code/index.md @@ -3,6 +3,7 @@ title: "Content Contributions" description: "How to contribute to the Hitchhiker's Guide — building, signing, releasing, and writing." hide: - toc + - navigation schema: "@context": https://schema.org "@type": Organization diff --git a/docs/constitution/index.md b/docs/constitution/index.md index c2095e1..139650b 100644 --- a/docs/constitution/index.md +++ b/docs/constitution/index.md @@ -3,6 +3,7 @@ title: "A Constitution" description: "The rules, values, and principles governing the Anonymous Planet initiative and PSA community." hide: - toc + - navigation ---
diff --git a/docs/contribute/index.md b/docs/contribute/index.md index eb4ec58..8f52317 100644 --- a/docs/contribute/index.md +++ b/docs/contribute/index.md @@ -2,7 +2,7 @@ title: Contribute & Donate description: "Support the Anonymous Planet project through crypto donations or content contributions. No fiat. No tracking. No profit." hide: - - toc + - navigation ---
diff --git a/docs/guide/index.md b/docs/guide/index.md index 731adec..cfb9495 100644 --- a/docs/guide/index.md +++ b/docs/guide/index.md @@ -1,6 +1,8 @@ --- title: "The Hitchhiker's Guide" description: We are the maintainers of the Hitchhiker's Guide and the PSA Matrix space. +hide: + - navigation schema: "@context": https://schema.org "@type": Organization diff --git a/docs/mirrors/index.md b/docs/mirrors/index.md index 93d30fd..16ddab3 100644 --- a/docs/mirrors/index.md +++ b/docs/mirrors/index.md @@ -3,6 +3,7 @@ title: "Mirrors" description: "Every place you can read or download the Hitchhiker's Guide." hide: - toc + - navigation schema: "@context": https://schema.org "@type": Organization diff --git a/docs/pgp/index.md b/docs/pgp/index.md index 1bd3795..c1603fc 100644 --- a/docs/pgp/index.md +++ b/docs/pgp/index.md @@ -2,7 +2,7 @@ title: "PGP" description: "Import our GPG keys to verify our releases and signed content." hide: - - toc + - navigation schema: "@context": https://schema.org "@type": Organization diff --git a/docs/stylesheets/navigation.css b/docs/stylesheets/navigation.css index d867b03..098f8ba 100644 --- a/docs/stylesheets/navigation.css +++ b/docs/stylesheets/navigation.css @@ -36,6 +36,24 @@ font-weight: 600; } +/* Secondary TOC: restore depth differentiation the global .md-nav__link override removed */ +.md-nav--secondary .md-nav__item .md-nav__link { + padding-left: 0.6rem; + opacity: 0.85; +} + +.md-nav--secondary .md-nav__item .md-nav__item .md-nav__link { + padding-left: 1.2rem; + font-size: 0.55rem; + opacity: 0.7; +} + +.md-nav--secondary .md-nav__item .md-nav__item .md-nav__item .md-nav__link { + padding-left: 1.8rem; + font-size: 0.52rem; + opacity: 0.6; +} + .md-nav__link--active, .md-nav__link[aria-current] { color: var(--accent-green) !important; @@ -90,8 +108,30 @@ border-top: 1px solid var(--border-color); } -@media screen and (min-width: 76.25em) { - .md-main__inner { - flex-direction: row-reverse; - } +.md-top { + background-color: var(--bg-card) !important; + color: var(--crt-green) !important; + border: 1px solid var(--border-color) !important; + left: 50% !important; + margin-left: 0 !important; + transform: translate(-50%, 0) !important; } + +.md-top svg, +.md-top .md-icon { + fill: var(--crt-green) !important; + color: var(--crt-green) !important; +} + +.md-top:hover { + background-color: var(--bg-card) !important; + color: var(--accent-green) !important; + border-color: var(--accent-green) !important; +} + +.md-top:hover svg, +.md-top:hover .md-icon { + fill: var(--accent-green) !important; + color: var(--accent-green) !important; +} + diff --git a/docs/verify/index.md b/docs/verify/index.md index 91bd13d..6553fb4 100644 --- a/docs/verify/index.md +++ b/docs/verify/index.md @@ -2,7 +2,7 @@ title: "Verify" description: "Verify the authenticity and integrity of Anonymous Planet releases." hide: - - toc + - navigation schema: "@context": https://schema.org "@type": Organization diff --git a/mkdocs.yml b/mkdocs.yml index fce513f..2625f50 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -24,7 +24,6 @@ theme: - navigation.tabs - navigation.sections - navigation.path - - toc.integrate - navigation.top - search.suggest - search.highlight diff --git a/scripts/update_changelog.py b/scripts/update_changelog.py index 7a209de..d4cd5b5 100644 --- a/scripts/update_changelog.py +++ b/scripts/update_changelog.py @@ -143,8 +143,18 @@ def categorise(messages: list[str]) -> dict[str, list[str]]: return buckets +# Distinct admonition type per bucket so icons/colors differ (not all blue "note") +ADMONITION_TYPE: dict[str, str] = { + "Meta": "abstract", + "Added": "tip", + "Changed": "info", + "Fixed": "success", +} + + def format_admonition(bucket: str, items: list[str]) -> str: - lines = [f'!!! Note "{bucket}"', ""] + adm_type = ADMONITION_TYPE.get(bucket, "note") + lines = [f'!!! {adm_type} "{bucket}"', ""] for item in items: lines.append(f" - {item}") lines.append("") @@ -154,7 +164,7 @@ def format_admonition(bucket: str, items: list[str]) -> str: def build_entry(version: str, buckets: dict[str, list[str]], sha: str) -> str: date = datetime.now(timezone.utc).strftime("%Y-%m-%d") lines = [f"## [{version}]", ""] - lines.append('!!! Note "Meta"') + lines.append('!!! abstract "Meta"') lines.append("") lines.append(f" - Released {date} from [`{sha[:7]}`](https://github.com/Anon-Planet/thgtoa/commit/{sha})") lines.append("")