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 <no@anonymousplanet.net>
This commit is contained in:
nopeitsnothing
2026-07-12 03:39:18 -04:00
parent 40e88da30a
commit 11510a863b
12 changed files with 79 additions and 22 deletions
+1
View File
@@ -2,6 +2,7 @@
title: "Anonymous Planet" title: "Anonymous Planet"
description: "We are the maintainers of the Hitchhiker's Guide and the PSA Matrix space." description: "We are the maintainers of the Hitchhiker's Guide and the PSA Matrix space."
hide: hide:
- navigation
- toc - toc
schema: schema:
"@context": https://schema.org "@context": https://schema.org
+14 -12
View File
@@ -1,6 +1,8 @@
--- ---
title: "Changelog" title: "Changelog"
description: "Release notes for the Hitchhiker's Guide to Online Anonymity." description: "Release notes for the Hitchhiker's Guide to Online Anonymity."
hide:
- navigation
schema: schema:
"@context": https://schema.org "@context": https://schema.org
"@type": Organization "@type": Organization
@@ -32,35 +34,35 @@ schema:
## [v1.2.6-pre1] ## [v1.2.6-pre1]
!!! Note "Meta" !!! abstract "Meta"
- Various website improvements (CSS) - Various website improvements (CSS)
!!! Note "Changed" !!! info "Changed"
- Adjust keyring path use the new relative path: pgp/anonymousplanet.asc - 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: use a fpr match to lock a specific key
- 02-sign.yml: quick mkdir -p repo/export before copying files to the dir - 02-sign.yml: quick mkdir -p repo/export before copying files to the dir
- Moved the Acknowledgements section to the bottom - Moved the Acknowledgements section to the bottom
!!! Note "Added" !!! tip "Added"
- COM Class Identifiers (CLSID/GUID) (NEW) - COM Class Identifiers (CLSID/GUID) (NEW)
- Windows Global Device Identifier (GDID) (NEW) - Windows Global Device Identifier (GDID) (NEW)
- USB bus telemetry (device enumeration history) (NEW) - USB bus telemetry (device enumeration history) (NEW)
!!! Note "Improved" !!! info "Improved"
- Glossary (`docs/includes/glossary.md`) and removed inline expansions where applicable - Glossary (`docs/includes/glossary.md`) and removed inline expansions where applicable
## [v1.2.5] ## [v1.2.5]
!!! Note "Meta" !!! abstract "Meta"
- Website theme customization - Website theme customization
- License change to accomodate our fiscal host Open Source Collective - 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 - 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 - 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 - Added comprehensive upgrade path guidance with backup procedures
- Updated 196! Wikipedia reference links throughout the entire guide - 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 - 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 - Upgrade path documented: Whonix 17 to 18 with automated release-upgrade support
- Detailed Qubes OS compatibility notes for both Whonix versions - 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) - You can now get the Anonymous Planet PGP keyring from the site (copy/paste or download)
!!! Note "Improved" !!! info "Improved"
- Virtualbox hardening section reorganized - Virtualbox hardening section reorganized
- AppArmor configuration guidance added where applicable (Whonix 18.x) - AppArmor configuration guidance added where applicable (Whonix 18.x)
@@ -91,11 +93,11 @@ schema:
## [v1.2.4] ## [v1.2.4]
!!! Note "Meta" !!! abstract "Meta"
- Rename workflows (GH - now we can know the order) - Rename workflows (GH - now we can know the order)
!!! Note "Changed" !!! info "Changed"
- Change the repo URL for our tor mirror - Change the repo URL for our tor mirror
- Fix recommended reading admonition - 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. 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. - **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`: - **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. 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. - `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. - 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.
+1
View File
@@ -3,6 +3,7 @@ title: "Content Contributions"
description: "How to contribute to the Hitchhiker's Guide — building, signing, releasing, and writing." description: "How to contribute to the Hitchhiker's Guide — building, signing, releasing, and writing."
hide: hide:
- toc - toc
- navigation
schema: schema:
"@context": https://schema.org "@context": https://schema.org
"@type": Organization "@type": Organization
+1
View File
@@ -3,6 +3,7 @@ title: "A Constitution"
description: "The rules, values, and principles governing the Anonymous Planet initiative and PSA community." description: "The rules, values, and principles governing the Anonymous Planet initiative and PSA community."
hide: hide:
- toc - toc
- navigation
--- ---
<div class="hero-block"> <div class="hero-block">
+1 -1
View File
@@ -2,7 +2,7 @@
title: Contribute & Donate title: Contribute & Donate
description: "Support the Anonymous Planet project through crypto donations or content contributions. No fiat. No tracking. No profit." description: "Support the Anonymous Planet project through crypto donations or content contributions. No fiat. No tracking. No profit."
hide: hide:
- toc - navigation
--- ---
<div class="hero-block"> <div class="hero-block">
+2
View File
@@ -1,6 +1,8 @@
--- ---
title: "The Hitchhiker's Guide" title: "The Hitchhiker's Guide"
description: We are the maintainers of the Hitchhiker's Guide and the PSA Matrix space. description: We are the maintainers of the Hitchhiker's Guide and the PSA Matrix space.
hide:
- navigation
schema: schema:
"@context": https://schema.org "@context": https://schema.org
"@type": Organization "@type": Organization
+1
View File
@@ -3,6 +3,7 @@ title: "Mirrors"
description: "Every place you can read or download the Hitchhiker's Guide." description: "Every place you can read or download the Hitchhiker's Guide."
hide: hide:
- toc - toc
- navigation
schema: schema:
"@context": https://schema.org "@context": https://schema.org
"@type": Organization "@type": Organization
+1 -1
View File
@@ -2,7 +2,7 @@
title: "PGP" title: "PGP"
description: "Import our GPG keys to verify our releases and signed content." description: "Import our GPG keys to verify our releases and signed content."
hide: hide:
- toc - navigation
schema: schema:
"@context": https://schema.org "@context": https://schema.org
"@type": Organization "@type": Organization
+44 -4
View File
@@ -36,6 +36,24 @@
font-weight: 600; 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--active,
.md-nav__link[aria-current] { .md-nav__link[aria-current] {
color: var(--accent-green) !important; color: var(--accent-green) !important;
@@ -90,8 +108,30 @@
border-top: 1px solid var(--border-color); border-top: 1px solid var(--border-color);
} }
@media screen and (min-width: 76.25em) { .md-top {
.md-main__inner { background-color: var(--bg-card) !important;
flex-direction: row-reverse; 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;
}
+1 -1
View File
@@ -2,7 +2,7 @@
title: "Verify" title: "Verify"
description: "Verify the authenticity and integrity of Anonymous Planet releases." description: "Verify the authenticity and integrity of Anonymous Planet releases."
hide: hide:
- toc - navigation
schema: schema:
"@context": https://schema.org "@context": https://schema.org
"@type": Organization "@type": Organization
-1
View File
@@ -24,7 +24,6 @@ theme:
- navigation.tabs - navigation.tabs
- navigation.sections - navigation.sections
- navigation.path - navigation.path
- toc.integrate
- navigation.top - navigation.top
- search.suggest - search.suggest
- search.highlight - search.highlight
+12 -2
View File
@@ -143,8 +143,18 @@ def categorise(messages: list[str]) -> dict[str, list[str]]:
return buckets 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: 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: for item in items:
lines.append(f" - {item}") lines.append(f" - {item}")
lines.append("") 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: def build_entry(version: str, buckets: dict[str, list[str]], sha: str) -> str:
date = datetime.now(timezone.utc).strftime("%Y-%m-%d") date = datetime.now(timezone.utc).strftime("%Y-%m-%d")
lines = [f"## [{version}]", ""] lines = [f"## [{version}]", ""]
lines.append('!!! Note "Meta"') lines.append('!!! abstract "Meta"')
lines.append("") lines.append("")
lines.append(f" - Released {date} from [`{sha[:7]}`](https://github.com/Anon-Planet/thgtoa/commit/{sha})") lines.append(f" - Released {date} from [`{sha[:7]}`](https://github.com/Anon-Planet/thgtoa/commit/{sha})")
lines.append("") lines.append("")