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,6 +7,7 @@ Use a sound effect story tag:

 ```text
 #sfx[squeaky-door.ogg]
+#sfx[church-bells.ogg](max=8 fade fade-duration=2)
 The old door opens into the dark.
 ```

@@ -16,6 +17,15 @@ Supported browser-friendly formats are recommended: `.ogg`, `.mp3`, and `.wav`.

 Sound effect loudness is controlled by the master volume and sound effects volume sliders in the options menu.

+Supported timing/end options:
+
+- `max=`, `duration=`, `max-duration=`, `limit=`, `stop-after=`: stop after this many seconds.
+- `fade-after=`: fade after this many seconds.
+- bare seconds such as `4s`: shorthand for a maximum duration.
+- `fade`, `fadeout`, `fade-out`, or `mode=fade`: fade out when the limit is reached.
+- `stop`, `cut`, `halt`, or `mode=stop`: stop immediately when the limit is reached.
+- `fade-duration=` or `fade-time=`: fade length in seconds.
+
 Document third-party source and license information here or next to the file.

 Current assets: