Skip to content

fix(gallery): render inline code in callouts; add the asset-sheet gate to the example prompt - #422

Merged
TMHSDigital merged 1 commit into
mainfrom
fix/gallery-inline-code
Oct 5, 2026
Merged

TMHSDigital merged 1 commit into
mainfrom
fix/gallery-inline-code

Conversation

@TMHSDigital

Copy link
Copy Markdown
Owner

Closes #368. Items 1 and 3 are here; item 2, the showcase/README.md path-filter claim, was fixed in #413.

Changes

  • scripts/build_gallery.py:
    • new inline_code(): escapes, then renders backtick spans as <code>, mirroring scripts/site/build_site.py. Unbalanced backticks stay literal;
    • used for teaches and witnessesFix on cards, related cards and detail pages;
    • check_alts() rejects a backtick in alt, an attribute where <code> can't exist and the backtick would be read aloud.
  • docs/new-example-prompt.md: a new "Asset-sheet gate" paragraph. It covers when the gate applies, the scripts/asset_sheet.py command, the SELECT row it needs, the commit location, the verdict rule, and the gallery_asset_quality.py floors (exit 11). Membership stays canonical in CLAUDE.md.

Evidence (generated HTML read, per CLAUDE.md)

  • After python scripts/build_gallery.py, only two pages change: docs/gallery/index.html and docs/gallery/parent-inverse-orrery/index.html. Both now contain Bare <code>.parent =</code> really does teleport the child.
  • grep -c 'Bare \' docs/gallery/index.htmlgives 0. No othergallery.json` entry contains a backtick, so no other page changed.
  • python tests/check_site_links.py: 135 pages, 0 failures.

🤖 Generated with Claude Code

…e to the example prompt

The parent-inverse-orrery witness callout showed raw markdown
("Bare `.parent =` ...") because build_gallery.py only html-escaped the
teaches and witnessesFix text. Both now render backtick spans as <code>,
like the landing page's inline_code; alt text, an attribute that cannot
carry markup, now fails the build if it contains a backtick.

docs/new-example-prompt.md covered the contact-sheet gate but never the
asset-sheet gate CLAUDE.md requires for asset-type examples (three of the
pinned asset references are examples). It now describes the gate, the
SELECT row it needs, and the asset-quality floors.

Closes #368

Signed-off-by: TMHSDigital <154358121+TMHSDigital@users.noreply.github.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Oct 5, 2026
@TMHSDigital

Copy link
Copy Markdown
Owner Author

CI evidence before merge: all checks pass ( 13 pass ). Blender Smoke on PR head: Blender 5.2.2 LTS / Blender 4.5.14 LTS. Summaries (happy path; falsifiers) per leg: 141 passed, 3 skipped, 0 failed;136 passed, 6 skipped, 0 failed;143 passed, 1 skipped, 0 failed;142 passed, 0 skipped, 0 failed;

@TMHSDigital
TMHSDigital merged commit ca5fd97 into main Oct 5, 2026
13 checks passed
@TMHSDigital
TMHSDigital deleted the fix/gallery-inline-code branch October 5, 2026 00:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: small drift — new-example-prompt omits the asset-sheet gate; showcase/README claims smoke has no path filter; raw backticks in a gallery callout

1 participant