Differences

This shows you the differences between two versions of the page.

--- contributing [2025/03/04 13:33] – [Contributing] finished sentence karelkubicek
+++ contributing [2026/08/21 14:50] (current) – Boxes: <wrap> renders a span, use uppercase <WRAP>; one box per list, not per bullet karel.kubicek.claude
@@ Line 81: / Line 81: @@
 print('Hello world!')
 </file>
+=== Boxes ===
+Notes, warnings and open-question boxes use the **uppercase** ''<nowiki><WRAP></nowiki>'' tag, which renders a ''<nowiki><div></nowiki>'':
+  <WRAP todo>
+  Paragraphs, lists and tables can all go inside a box like this.
+  </WRAP>
+The lowercase ''<nowiki><wrap></nowiki>'' renders a ''<nowiki><span></nowiki>'' instead. A span cannot contain block content, so a lowercase box holding more than a few words of running text is silently mangled — the page renders wrong without any error. **Always use uppercase.** If a box holds a bullet list, put the whole list inside one box rather than opening a box per bullet.
 === Figures ===