Todo · BHG-026
Working-site Booklets catalogue and detail pages
Goal
Build a Booklets section in bhgsite-working using the structured catalogue as the sole source of titles, paths and file/edition metadata. Create index + 39 detail pages with editorial write-ups and correctly targeted links.
Source
- Booklet working-site plan and artefact inventory.
- 21 Sep workshop meeting: booklet conversions on workshop first, Council/Visitor Centre before Preview/Real.
In scope
- Add Booklets to the common working-site navigation and homepage/process discovery as appropriate.
- Generate
/booklets/index.htmland/booklets/<slug>/index.htmlfor 39 items. Missing The Burra Institute has a truthful missing-source page. - Draft substantive, source-grounded descriptions (~100–200 words each) from the recovered booklets and track editorial review status.
- Provide links for responsive reader, PDF and Publisher originals; distinguish local preview links from deployed/public links.
- Show page-count/edition deviations and bibliographic credits only when verified.
Out of scope
- Responsive conversion (BHG-025/027).
- Uploading binaries and switching on public downloads (BHG-028).
- BHG-006 public history-site Publications navigation.
Acceptance criteria
- Catalogue and 39 detail pages generated from one structured inventory plus 39 editorial drafts.
- Routes and file-size/edition metadata derived from structured inventory. Actual reader/PDF/Publisher download links intentionally pending BHG-028.
- 39 source-grounded, unreviewed first-pass descriptions (including cautious placeholders for missing/image-heavy items) are stored in
booklet-descriptions.jsonand visibly marked draft. - Local check validates all 39 title routes and internal links; no inactive URLs presented as download links.
- Existing static generator builds, shared nav and homepage updated, desktop/mobile Chrome previews checked.
Stop and ask
Don't publish the booklets and binaries to the publicly reachable working URL as a side effect of implementing the local generator. Keep publication gated in BHG-028.
Completion notes
Completed locally 19 October 2026. Full report. Generator: bhgsite-working/scripts/booklets/site.py; automated link checker: scripts/booklets/check_site.py.
Release is not complete: BHG-026 builds pages and descriptions locally only. No online deployment, no public downloads, and no binaries added to Git. A fail-closed guard prevents normal publish_hou_site.py runs from exposing the draft catalogue before BHG-028 approval. BHG-027 will complete the modern readers; BHG-028 will upload/check the actual files and enable links.