Document markup and improve choice tags

2026-05-17 15:52:41 +02:00
parent c2fb27b6b8
commit 2c54498ee2
52 changed files with 3485 additions and 377 deletions
@@ -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.