Document markup and improve choice tags

This commit is contained in:
2026-05-17 15:52:41 +02:00
parent c2fb27b6b8
commit 2c54498ee2
52 changed files with 3485 additions and 377 deletions
+5 -2
View File
@@ -7,7 +7,8 @@ Image block markup:
```text
#image[image-name.jpg](landscape)
#image[image-name.jpg](portrait)
#image[image-name.jpg](portrait pause=2)
#image[image-name.jpg](square lead=1.5)
```
Sizes:
@@ -16,7 +17,9 @@ Sizes:
- `portrait`: 16:9, half page width, height snapped to whole line heights, with following prose flowing beside it.
- `square`: 1:1, centered, near full page width, height snapped to whole line heights.
Image markup is parsed and queued by the story markup system, but final image rendering is still future work. Keep assets ready for that renderer by using browser-friendly formats such as `.jpg`, `.png`, `.webp`, or `.avif`.
Images are inserted as story blocks, saved in browser history, restored on load/history scrolling, and revealed after the page scrolls to their line-snapped position. Optional `pause=`, `delay=`, `lead=`, or bare seconds such as `2s` delay the next spoken paragraph; the pause is skippable and does not block background TTS preparation.
Use browser-friendly formats such as `.jpg`, `.png`, `.webp`, or `.avif`.
Use file names that are stable and story-facing, for example `mansion-door-rain.webp` rather than temporary export names.