WORK-422
ID:WORK-422Status:done

Image-scheme authoring docs

Document the image-src scheme sugar for content authors, and the data:svg caveat.

Priority:lowComplexity:simpleMilestone:v0.22.0Source:SPEC-106
claude/spec-106-image-src-schemes View source

Criteria completion

Criteria completion: 2 of 2 (100%) checked; tracking started on Jun 13, no incremental history yet0%25%50%75%100%Jun 13Jun 15

Tracking started Jun 13 — check back for trends.

Relationships

Implements 1
Related 3
Branches 2
claude/spec-106-image-src-schemes current done
claude/spec-image-src-scheme-sugar pendingmain done
History 2
  1. 3358f53
    Created (done)by bjornolofandersson
  2. 8bc0dca
    Content editedby Claude
    plan: break SPEC-106 into WORK-418..422 under v0.22.0

Acceptance Criteria

  • Authoring docs cover ![alt](icon:<name>) and ![alt](placeholder:<shape>) — available schemes, the shape list, and accessibility (alt).
  • A note documents that raw data:image/svg+xml srcs are rejected by the parser (markdown-it validateLink) — use placeholder:/icon: or a non-SVG image.

Dependencies

  • Requires WORK-419 + WORK-420 (the schemes to document).

References

  • SPEC-106 · site/content/extend/ authoring docs.

Resolution

Completed: 2026-06-13

Branch: claude/spec-106-image-src-schemes

What was done

  • Added site/content/runes/image-schemes.md — a content-authoring guide covering both schemes: the placeholder:<shape> table of shapes (with aspects + use), determinism/theme-awareness, the icon:<name> inline shorthand (cross-linked to the icon rune), accessibility (alt → label; empty alt → decorative), and a "note on data:image/svg+xml" explaining the parser rejection and the supported alternatives.
  • Added an "Inline shorthand (icon:)" section to site/content/runes/icon.md with a rendered {% preview %} example, linking to the new page.
  • Registered image-schemes in the runes nav (site/content/runes/_layout.md, Content group).

Notes

  • Doc examples use icons that exist in Lumina's set (star, mail, book-open) — github isn't in the curated ~80, which would have triggered the unknown-name fallback in the live preview.