Guizang Presentation Engine
Use this copy as a specialized design/runtime engine. Preserve its AGPL-3.0 license and do not use it as the native editable PPTX renderer.
Route
- Choose
assets/template-swiss.htmlfor Swiss requests; chooseassets/template.htmlfor editorial/e-ink requests. - Load only the active design authority:
- Swiss:
references/layouts-swiss.md,references/themes-swiss.md, andreferences/swiss-layout-lock.md. - Editorial:
references/layouts.md,references/themes.md, andreferences/components.md.
- Swiss:
- Load
references/image-prompts.mdonly when the deck needs generated imagery. - Load
references/presenter-mode.mdonly when presenter/rehearsal/timer/pointer/annotation behavior is requested. - Read
references/upstream-skill.mdonly when the concise route above does not cover an upstream-specific workflow detail.
Construction contract
- Keep every slide on a 16:9 stage and assign a registered semantic layout.
- Bind local imagery to an explicit
data-image-slotand generate to that slot ratio. - Preserve the presenter CSS/JavaScript boundary markers in both templates.
- Keep speaker-note IDs aligned with slide IDs.
- Do not flatten Guizang design rules into a generic card grid.
- When native editable PPTX is also required, contribute design and presenter semantics while another engine performs native rendering.
Validation
Run the relevant commands from this engine directory:
node scripts/check-presenter-runtime-sync.mjs
node scripts/validate-presenter-mode.mjs <deck.html>
node scripts/validate-swiss-deck.mjs <deck.html>
Treat skipped Playwright measurements as PARTIAL, not PASS. Validate a generated deck or a registered fixture; the upstream blank Swiss template is not itself a passing locked-layout deck.
Recovery
- Missing Playwright: keep static validation, report rendered inspection as partial, and use the configured browser runtime when available.
- Overflow/collision: repair the owning layout and revalidate; do not delete content reflexively.
- Image failure: use another provider or a deliberate typographic/no-image layout.
- Presenter drift: repair the optimized copy, then rerun the byte-sync check.
