(((meta (@ (content . "Encoding of Sz Block Elements") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#api #manual #reference #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001012931000") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20230403161803") (name . "created"))) (meta (@ (content . "00001012931000 00001012931400 00001012931600 00001012931900") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20240123120132") (name . "modified"))) (meta (@ (content . "20240123120132") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (h2 (@ (id . "para")) (kbd "PARA")) (div (@ (class . "syntax")) (p (em "Paragraph") " " (strong "=") " " (kbd "(PARA") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "A paragraph is just a list of inline elements.") (h2 (@ (id . "heading")) (kbd "HEADING")) (div (@ (class . "syntax")) (p (em "Heading") " " (strong "=") " " (kbd "(HEADING") " Number " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " String" (sub "1") " String" (sub "2") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "A heading consists of a number, which specifies its level (1 – 5), its optional attributes." " " "The first string is a " (@L (@H "&ldquo;") "slug" (@H "&rdquo;")) " of the heading text, i.e. transformed it to lower case, replaced space character with minus sign, and some more." " " "The second string is the slug, but made unique for the whole zettel." " " "Then the heading text follows as a sequence of inline elements.") (h2 (@ (id . "thematic")) (kbd "THEMATIC")) (div (@ (class . "syntax")) (p (em "Thematic") " " (strong "=") " " (kbd "(THEMATIC") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " " (kbd ")") ".")) (h2 (@ (id . "ordered-unordered-quotation")) (kbd "ORDERED") ", " (kbd "UNORDERED") ", " (kbd "QUOTATION")) (p "These three symbols are specifying different kinds of lists / enumerations: an ordered list, an unordered list, and a quotation list." " " "Their structure is the same.") (div (@ (class . "syntax")) (p (em "OrderedList") " " (strong "=") " " (kbd "(ORDERED") " " (em "ListElement") " … " (kbd ")") ".") (p (em "UnorderedList") " " (strong "=") " " (kbd "(UNORDERED") " " (em "ListElement") " … " (kbd ")") ".") (p (em "QuotationList") " " (strong "=") " " (kbd "(QUOTATION") " " (em "ListElement") " … " (kbd ")") ".")) (div (@ (class . "syntax")) (p (em "ListElement") " " (strong "=") " " (a (@ (href . "00001012931000#block")) (em "Block")) " " (strong "|") " " (a (@ (href . "00001012931000#inline")) (em "Inline")) ".")) (p "A list element is either a block or an inline." " " "If it is a block, it may contain a nested list.") (h2 (@ (id . "description")) (kbd "DESCRIPTION")) (div (@ (class . "syntax")) (p (em "Description") " " (strong "=") " " (kbd "(DESCRIPTION") " " (em "DescriptionTerm") " " (em "DescriptionValues") " " (em "DescriptionTerm") " " (em "DescriptionValues") " … " (kbd ")") ".")) (p "A description is a sequence of one ore more terms and values.") (div (@ (class . "syntax")) (p (em "DescriptionTerm") " " (strong "=") " " (kbd "(") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "A description term is just an inline-structured value.") (div (@ (class . "syntax")) (p (em "DescriptionValues") " " (strong "=") " " (kbd "(BLOCK") " " (a (@ (href . "00001012931000#block")) (em "Block")) " … " (kbd ")") ".")) (p "Description values are sequences of blocks.") (h2 (@ (id . "table")) (kbd "TABLE")) (div (@ (class . "syntax")) (p (em "Table") " " (strong "=") " " (kbd "(TABLE") " " (em "TableHeader") " " (em "TableRow") " … " (kbd ")") ".")) (p "A table is a table header and a sequence of table rows.") (div (@ (class . "syntax")) (p (em "TableHeader") " " (strong "=") " " (kbd "()") " " (strong "|") " " (kbd "(") " " (em "TableCell") " … " (kbd ")") ".")) (p "A table header is either the empty list or a list of table cells.") (div (@ (class . "syntax")) (p (em "TableRow") " " (strong "=") " " (kbd "(") " " (em "TableCell") " … " (kbd ")") ".")) (p "A table row is a list of table cells.") (h2 (@ (id . "cell-cell")) (kbd "CELL") ", " (kbd "CELL-*")) (p "There are four kinds of table cells, one for each possible cell alignment." " " "The structure is the same for all kind.") (div (@ (class . "syntax")) (p (em "TableCell") " " (strong "=") " " (em "DefaultCell") " " (strong "|") " " (em "CenterCell") " " (strong "|") " " (em "LeftCell") " " (strong "|") " " (em "RightCell") ".")) (div (@ (class . "syntax")) (p (em "DefaultCell") " " (strong "=") " " (kbd "(CELL") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "The cell content, specified by the sequence of inline elements, used the default alignment.") (div (@ (class . "syntax")) (p (em "CenterCell") " " (strong "=") " " (kbd "(CELL-CENTER") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "The cell content, specified by the sequence of inline elements, is centered aligned.") (div (@ (class . "syntax")) (p (em "LeftCell") " " (strong "=") " " (kbd "(CELL-LEFT") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "The cell content, specified by the sequence of inline elements, is left aligned.") (div (@ (class . "syntax")) (p (em "RightCell") " " (strong "=") " " (kbd "(CELL-RIGHT") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "The cell content, specified by the sequence of inline elements, is right aligned.") (h2 (@ (id . "region")) (kbd "REGION-*")) (p "The following lists specifies different kinds of regions." " " "A region treat a sequence of block elements to be belonging together in certain ways." " " "The have a similar structure.") (div (@ (class . "syntax")) (p (em "BlockRegion") " " (strong "=") " " (kbd "(REGION-BLOCK") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " " (kbd "(") " " (a (@ (href . "00001012931400")) (em "BlockElement")) " … " (kbd ")") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "A block region just treats the block to belong in an unspecified way." " " "Typically, the reason is given in the attributes." " " "The inline describes the block.") (div (@ (class . "syntax")) (p (em "QuoteRegion") " " (strong "=") " " (kbd "(REGION-QUOTE") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " " (kbd "(") " " (a (@ (href . "00001012931400")) (em "BlockElement")) " … " (kbd ")") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "A block region just treats the block to contain a longer quotation." " " "Attributes may further specify the quotation." " " "The inline typically describes author / source of the quotation.") (div (@ (class . "syntax")) (p (em "VerseRegion") " " (strong "=") " " (kbd "(REGION-VERSE") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " " (kbd "(") " " (a (@ (href . "00001012931400")) (em "BlockElement")) " … " (kbd ")") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") ".")) (p "A block region just treats the block to contain a verse." " " "Soft line break are transformed into hard line breaks to save the structure of the verse / poem." " " "Attributes may further specify something." " " "The inline typically describes author / source of the verse.") (h2 (@ (id . "verbatim")) (kbd "VERBATIM-*")) (p "The following lists specifies some literal text of more than one line." " " "The structure is always the same, the initial symbol denotes the actual usage." " " "The content is encoded as a string, most likely to contain control characters that signals the end of a line.") (div (@ (class . "syntax")) (p (em "CommentVerbatim") " " (strong "=") " " (kbd "(VERBATIM-COMMENT") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " String " (kbd ")") ".")) (p "The string contains text that should be treated as an internal comment not to be interpreted further.") (div (@ (class . "syntax")) (p (em "EvalVerbatim") " " (strong "=") " " (kbd "(VERBATIM-EVAL") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " String " (kbd ")") ".")) (p "The string contains text that should be evaluated by an (external) software to produce some derived content.") (div (@ (class . "syntax")) (p (em "HTMLVerbatim") " " (strong "=") " " (kbd "(VERBATIM-HTML") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " String " (kbd ")") ".")) (p "The string contains HTML code.") (div (@ (class . "syntax")) (p (em "MathVerbatim") " " (strong "=") " " (kbd "(VERBATIM-MATH") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " String " (kbd ")") ".")) (p "The string contains text that should be treated as special code to be interpreted as mathematical formulas.") (div (@ (class . "syntax")) (p (em "CodeVerbatim") " " (strong "=") " " (kbd "(VERBATIM-CODE") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " String " (kbd ")") ".")) (p "The string contains text that should be treated as (executable) code.") (div (@ (class . "syntax")) (p (em "ZettelVerbatim") " " (strong "=") " " (kbd "(VERBATIM-ZETTEL") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " String " (kbd ")") ".")) (p "The string contains text that should be treated as (nested) zettel content.") (h2 (@ (id . "blob")) (kbd "BLOB")) (div (@ (class . "syntax")) (p (em "BLOB") " " (strong "=") " " (kbd "(BLOB") " " (kbd "(") " " (a (@ (href . "00001012931600")) (em "InlineElement")) " … " (kbd ")") " String" (sub "1") " String" (sub "2") " " (kbd ")") ".")) (p "A BLOB contains an image in block mode." " " "The inline elements states some description." " " "The first string contains the syntax of the image." " " "The second string contains the actual image." " " "If the syntax is " (@L (@H "&ldquo;") "SVG" (@H "&rdquo;")) ", then the second string contains the SVG code." " " "Otherwise the (binary) image data is encoded with base64.") (h2 (@ (id . "transclude")) (kbd "TRANSCLUDE")) (div (@ (class . "syntax")) (p (em "Transclude") " " (strong "=") " " (kbd "(TRANSCLUDE") " " (a (@ (href . "00001012931000#attribute")) (em "Attributes")) " " (a (@ (href . "00001012931900")) (em "Reference")) " " (kbd ")") ".")) (p "A transclude list only occurs for a parsed zettel, but not for a evaluated zettel." " " "Evaluating a zettel also means that all transclusions are resolved.") (p (em "Reference") " denotes the zettel to be transcluded."))