(((meta (@ (content . "Zettelmarkup: Region Blocks") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #zettelmarkup #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001007030000 00001007040100 00001007800000 00001012920513") (name . "back"))) (meta (@ (content . "00001007030000 00001007040100 00001007800000 00001012920513") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20210126175322") (name . "created"))) (meta (@ (content . "00001007030100 00001007040000 00001007050000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20220323190829") (name . "modified"))) (meta (@ (content . "20220323190829") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "Region blocks does not directly have a visual representation." " " "They just group a range of lines." " " "You can use region blocks to enter " (a (@ (href . "00001007050000")) "attributes") " that apply only to this range of lines." " " "One example is to enter a multi-line warning that should be visible.") (p "This kind of line-range block begins with at least three colon characters (" (@L (@H "&ldquo;") (kbd ":") (@H "&rdquo;")) ", U+003A) at the first position of a line" (sup (@ (id . "fnref:1")) (a (@ (class . "zs-noteref") (href . "#fn:1") (role . "doc-noteref")) "1")) "." " " "You can add some " (a (@ (href . "00001007050000")) "attributes") " on the beginning line of a region block, following the initiating characters." " " "The region block does not support the default attribute, but it supports the generic attribute." " " "Some generic attributes, like " (code "=note") ", " (code "=warning") " will be rendered special." " " "All other generic attributes are used as a CSS class definition." " " "Attributes are interpreted on HTML rendering." " " "Any other character in this line will be ignored.") (p "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." " " "This allows to enter a region block within a region block." " " "At the ending line, you can enter some " (a (@ (href . "00001007040000")) "inline elements") " after the colon characters." " " "These will interpreted as some attribution text.") (p "For example:") (pre (code (@ (class . "language-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")) (p "will be rendered in HTML as:") (div (@ (class . "example")) (div (@ (style . "color:green")) (p "A region block with" " " " an embedded region block") (div (@ (style . "color:black")) (p "Embedded" " " "  region" " " "block") (cite "Embedded Author")) (cite "Region Author"))) (p "An example for a warning region block:") (pre (code (@ (class . "language-zmk")) ":::warning\nDo not copy from the Internet, know your sponsors.\n:::")) (p "will be rendered as:") (div (@ (class . "example")) (div (@ (class . "warning")) (p "Do not copy from the Internet, know your sponsors."))) (p "Generic attributes that are result in a special HTML rendering are:") (ul (li "example") (li "note") (li "tip") (li "important") (li "caution") (li "warning")) (p "All other generic attribute values are rendered as a CSS class:") (pre (code (@ (class . "language-zmk")) ":::abc\ndef\n:::")) (p "is rendered as") (div (@ (class . "example")) (div (@ (class . "abc")) (p "def"))))