thgtoa/docs/changelog/index.md

title, description, schema

title	description	schema
Release Notes	Release Notes	@context @type @id name url logo sameAs https://schema.org Organization https://www.anonymousplanet.org/ Anonymous Planet https://www.anonymousplanet.org/authors/ ../media/profile.png https://github.com/Anon-Planet https://opencollective.com/anonymousplanetorg https://mastodon.social/@anonymousplanet

Release Notes

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

Unreleased

!!! Note "Added"

- This changelog page
- Add ways to verify the files

!!! Note "Changed"

- Refactored GitHub Actions workflow **Build PDF** (`scripts\build_guide_pdf.py`): now builds both light and dark mode PDFs
- Restored previous VT scans

!!! Note "Fixed"

- `docs/about/index.md`: replace broken reference-style internal links
- `docs/guide/index.md`: Appendix A6: comment out deprecated ODT information because we don't and probably won't use it in the future

!!! Note "Feature"

- Updated `scripts/build_guide_pdf.py` to use `--print-to-pdf` instead of `--save-as` for PDF generation
- Added a new `--dark-mode` flag to generate dark mode PDFs. Save your eyes - you only get one pair.

v1.2.1

!!! Note "Added"

- GitHub Actions workflow **Build 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`.

!!! Note "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 PDF** GitHub Actions workflow and the `guide-pdf` artifact.

!!! Note "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.

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