Skip to content

Publish current site and bilingual books after CI - #8

Merged
ancongui merged 3 commits into
mainfrom
fix/publish-books-and-pages
Sep 27, 2026
Merged

ancongui merged 3 commits into
mainfrom
fix/publish-books-and-pages

Conversation

@ancongui

@ancongui ancongui commented Sep 27, 2026 •

Copy link
Copy Markdown
Contributor

The public Pages site still showed the pre-restructure installation, and generated books had not been rebuilt. CI now validates and builds both English and Spanish PDF/EPUB editions with MkDocs, makes the downloads discoverable from the site and READMEs, and deploys the site only after every main CI gate succeeds. Superseded main runs skip deployment so an older build cannot roll the site back.

The release workflow uses the same build action to attach books, checksums and their source commit record to future releases. Remaining separate-component installation prose in the manuscripts is corrected. The print stylesheet now wraps long type names inside tables, and a PDF content-stream check rejects off-page text in both full PDFs. The check rejects the original Linux artifacts and passes all 1,105 pages of the corrected local builds. Generated files stay outside Git; Pages uses GitHub Actions instead of the legacy gh-pages branch.

Validation: strict MkDocs build, both PDF/EPUB builds, 17 book pipeline tests (including partially and wholly off-page text fixtures), all 588 PHP listings with provenance, 44 documentation/release/navigation tests (398 assertions), Bash syntax and Actionlint workflow validation. Full PHP matrix and browser checks run on this PR. Pages repository/environment configuration and a live download/hash check follow the green merge.

@ancongui
ancongui merged commit ac03345 into main Sep 27, 2026
12 of 14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant