docs: add local examples gallery on GitHub Pages#23
Merged
Conversation
Stand up Pages for this repo (no site existed) following the fleet entry pattern: site.json + pages.yml that builds the shared landing page (docs/index.html via Developer-Tools-Directory's build_site.py). Add a this-repo-local examples gallery that rides alongside it: - examples/gallery.json: forward-compatible source of truth (per-entry name/dir/teaches/witnessesFix/hero/preview). When the fleet template gains examples support, it reads this same file and the local page is retired -- a lift-and-shift, not a rewrite. - scripts/build_gallery.py: stdlib-only generator -> docs/gallery/index.html. - docs/gallery/index.html + docs/gallery/assets/*-hero.webp: the standalone gallery and its web-optimized heroes (1280px WebP, 6-14 KB each), rendered on Blender 5.1 and asserted non-black. The fleet build only writes docs/index.html + docs/fonts/ + docs/assets/, so it never clobbers docs/gallery/. pages.yml regenerates the gallery before upload so the committed page can't drift from gallery.json. Cross-linking the generated landing page -> gallery needs a template edit (the Option-2 fleet change), so the README links to the live gallery instead and the gallery links back to the landing page. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Signed-off-by: fOuttaMyPaint <TMhospitalitystrategies@gmail.com>
github-actions
Bot
added
documentation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Phase 2 of the local-gallery series — Option-1 (this-repo-local) gallery, built Option-2-ready. docs/ci only, no release expected.
Phase 1 findings (read-only)
pages.yml/docs//site.json), but Pages is already configuredbuild_type: workflow— no manual settings step needed.build_site.py) writes onlydocs/index.htmland rmtree-replacesdocs/fonts/+docs/assets/; it never touches anything else underdocs/. →docs/gallery/is safe.site.jsonlinks). That template change is the Option-2 fleet item. Flagged; README links to the live gallery instead, and the gallery links back to the landing page.What ships
site.json+.github/workflows/pages.yml— stands up Pages; builds the fleet landing page and the local gallery into onedocs/artifact.examples/gallery.json— forward-compatible source of truth (per-entry name/dir/teaches/witnessesFix/hero/preview). Option-2 migration is lift-and-shift onto the shared template.scripts/build_gallery.py— stdlib-only generator →docs/gallery/index.html(CI regenerates it before upload so it can't drift).docs/gallery/index.html+ 3 heroesdocs/gallery/assets/*-hero.webp(1280px WebP, 6–14 KB; rendered on Blender 5.1, asserted non-black).Notes / verification
site.json(title + all 12 skill cards rendered) — confirms CI build.pages.ymldeploys on push to main (not on PR), so the live URL is verified after merge.🤖 Generated with Claude Code