(BLOCK (PARA (TEXT "Region blocks does not directly have a visual representation.") (SOFT) (TEXT "They just group a range of lines.") (SOFT) (TEXT "You can use region blocks to enter ") (LINK-ZETTEL () "00001007050000" (TEXT "attributes")) (TEXT " that apply only to this range of lines.") (SOFT) (TEXT "One example is to enter a multi-line warning that should be visible.")) (PARA (TEXT "This kind of line-range block begins with at least three colon characters (") (FORMAT-QUOTE () (LITERAL-INPUT () ":")) (TEXT ", U+003A) at the first position of a line") (ENDNOTE () (TEXT "Since a ") (LINK-ZETTEL () "00001007030100" (TEXT "description text")) (TEXT " only use exactly one colon character at the first position of a line, there is no possible ambiguity between these elements.")) (TEXT ".") (SOFT) (TEXT "You can add some ") (LINK-ZETTEL () "00001007050000" (TEXT "attributes")) (TEXT " on the beginning line of a region block, following the initiating characters.") (SOFT) (TEXT "The region block does not support the default attribute, but it supports the generic attribute.") (SOFT) (TEXT "Some generic attributes, like ") (LITERAL-CODE () "=note") (TEXT ", ") (LITERAL-CODE () "=warning") (TEXT " will be rendered special.") (SOFT) (TEXT "All other generic attributes are used as a CSS class definition.") (SOFT) (TEXT "Attributes are interpreted on HTML rendering.") (SOFT) (TEXT "Any other character in this line will be ignored.")) (PARA (TEXT "Text following the beginning line will be interpreted, until a line begins with at least the same number of the same characters given at the beginning line.") (SOFT) (TEXT "This allows to enter a region block within a region block.") (SOFT) (TEXT "At the ending line, you can enter some ") (LINK-ZETTEL () "00001007040000" (TEXT "inline elements")) (TEXT " after the colon characters.") (SOFT) (TEXT "These will interpreted as some attribution text.")) (PARA (TEXT "For example:")) (VERBATIM-CODE (("" . "zmk")) "::::{style=color:green}\nA region block with\n an embedded region block\n:::{style=color:black}\nEmbedded\n  region\nblock\n::: Embedded Author\n:::: Region Author") (PARA (TEXT "will be rendered in HTML as:")) (REGION-BLOCK (("" . "example")) ((REGION-BLOCK (("style" . "color:green")) ((PARA (TEXT "A region block with") (SOFT) (TEXT " an embedded region block")) (REGION-BLOCK (("style" . "color:black")) ((PARA (TEXT "Embedded") (SOFT) (TEXT "  region") (SOFT) (TEXT "block"))) (TEXT "Embedded Author"))) (TEXT "Region Author")))) (PARA (TEXT "An example for a warning region block:")) (VERBATIM-CODE (("" . "zmk")) ":::warning\nDo not copy from the Internet, know your sponsors.\n:::") (PARA (TEXT "will be rendered as:")) (REGION-BLOCK (("" . "example")) ((REGION-BLOCK (("" . "warning")) ((PARA (TEXT "Do not copy from the Internet, know your sponsors.")))))) (PARA (TEXT "Generic attributes that are result in a special HTML rendering are:")) (UNORDERED (INLINE (TEXT "example")) (INLINE (TEXT "note")) (INLINE (TEXT "tip")) (INLINE (TEXT "important")) (INLINE (TEXT "caution")) (INLINE (TEXT "warning"))) (PARA (TEXT "All other generic attribute values are rendered as a CSS class:")) (VERBATIM-CODE (("" . "zmk")) ":::abc\ndef\n:::") (PARA (TEXT "is rendered as")) (REGION-BLOCK (("" . "example")) ((REGION-BLOCK (("" . "abc")) ((PARA (TEXT "def")))))))