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("")