Files
thgtoa/CHANGELOG.md
T
nopeitsnothing 206a6ff6b7 Refactor PDF build in CI, add dark mode PDF (pt 4)
Refactored GitHub Actions workflow **Build guide PDF**
(`scripts\build_guide_pdf.py`): now builds both light and dark mode PDFs
(`export/thgtoa.pdf` and `export/thgtoa-dark.pdf` respectively).

Signed-off-by: nopeitsnothing <no@anonymousplanet.org>
2026-04-14 03:22:13 -04:00

2.3 KiB

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

Changed

  • Refactored GitHub Actions workflow Build guide PDF (scripts\build_guide_pdf.py): now builds both light and dark mode PDFs (export/thgtoa.pdf and export/thgtoa-dark.pdf respectively).

1.2.1 - 2026-04-11

Added

  • GitHub Actions workflow Build guide PDF (.github/workflows/build-pdf.yml): installs Chromium on ubuntu-latest, runs scripts/build_guide_pdf.py, uploads export/guide.pdf as the guide-pdf artifact. Runs on workflow_dispatch, on pushes to main that touch docs or build inputs, and on matching pull requests.

  • scripts/build_guide_pdf.py to build the MkDocs site and render the guide to a single PDF (export/guide.pdf by default) using a Chromium-based browser (Chrome or Edge) headless print-to-PDF.

  • docs/stylesheets/extra.css and extra_css in mkdocs.yml for shared site styling.

  • This CHANGELOG.md.

Changed

  • README.md “Ways to read or export the guide”: hosted link, local mkdocs serve, PDF build via the script, ODT note, raw Markdown link.
  • Guide landing layout: wrap the opening block in docs/guide/index.md with a guide-intro-lead container so the logo and first sections share one layout context for web and print.
  • .gitignore to exclude local build outputs export/, site/, and _site_test/.
  • scripts/build_guide_pdf.py: when the CI environment variable is set, pass Chromium flags (--no-sandbox, --disable-setuid-sandbox, --disable-dev-shm-usage) so headless print works on typical CI images.
  • README.md: note the Build guide PDF GitHub Actions workflow and the guide-pdf artifact.

Fixed

  • docs/guide/index.md: replace broken reference-style internal links ([label][label:]) with working same-page fragment links to the correct headings; correct the mismatched “Real-Name System” cross-reference; fix a broken footnote marker on the “free (unallocated) space of your hard drive” list item.