Add glossary hover presentation

2026-05-19 07:34:52 +02:00
parent 751ac5f62b
commit 121b174f2c
19 changed files with 2356 additions and 1912 deletions
@@ -31,6 +31,17 @@ Bare flags are accepted as tags with no value:
 #optional
 ```

+## Right-Page Glossary Notes
+
+Glossary notes are story tags scoped to the paragraph/block they belong to. They affect only the right-page story rendering, never choice text or command history.
+
+```ink
+The conductor points toward Eibenreith.
+#gloss[Eibenreith](A fictional alpine town in the Kaiserpunk setting.)
+```
+
+The bracket value is the visible term to find. The parenthesized value is the note shown on hover/focus. The renderer marks every matching instance of the term in the same right-page block. The tag is not displayed and is not sent to TTS. Avoid raw Ink control characters in the explanation; `|`, `{`, and `}` must be escaped in Ink as `\|`, `\{`, and `\}` if they are needed literally.
+
 ## Choice Metadata

 Choice tags are placed on the Ink choice they belong to: