((META (EMPTY-STRING title "Zettelmarkup: Evaluation Blocks") (WORD role "manual") (TAG-SET tags ("#manual" "#zettelmarkup" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001007030000" "00001007031400" "00001007800000" "00001012920513")) (ZID-SET backward ("00001007030000" "00001007031400" "00001007800000" "00001012920513")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20220310184916") (ZID-SET forward ("00001007050000" "00001008000000" "00001008050000" "00001012920516")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20230109105402") (TIMESTAMP published "20230109105402") (WORD visibility "public")) (BLOCK (PARA (TEXT "Evaluation blocks are used to enter text that could be evaluated by either Zettelstore or external software.") (SOFT) (TEXT "They begin with at least three tilde characters (") (FORMAT-QUOTE () (LITERAL-INPUT () "~")) (TEXT ", U+007E) at the first position of a line.")) (PARA (TEXT "You can add some ") (LINK-ZETTEL () "00001007050000" (TEXT "attributes")) (TEXT " on the beginning line of a verbatim block, following the initiating characters.") (SOFT) (TEXT "The evaluation block supports the default attribute") (ENDNOTE () (TEXT "Depending on the syntax value.")) (TEXT ": when given, all spaces in the text are rendered in HTML as open box characters (U+2423).") (SOFT) (TEXT "If you want to give only one attribute and this attribute is the generic attribute, you can omit the most of the attribute syntax and just specify the value.") (SOFT) (TEXT "It will be interpreted as a ") (LINK-ZETTEL () "00001008000000" (TEXT "syntax")) (TEXT " value to evaluate its content.") (SOFT) (TEXT "Not all syntax values are supported by Zettelstore.") (ENDNOTE () (TEXT "Currently just ") (FORMAT-QUOTE () (LINK-ZETTEL () "00001008050000" (TEXT "draw"))) (TEXT ".")) (SOFT) (TEXT "The main reason for an evaluation block is to be used with external software via the ") (LINK-ZETTEL () "00001012920516" (TEXT "sz encoding")) (TEXT ".")) (PARA (TEXT "Any other character in this line will be ignored")) (PARA (TEXT "Text following the beginning line will not 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 some tilde characters in the text that should not be interpreted.")) (PARA (TEXT "For example:")) (VERBATIM-CODE (("" . "zmk")) "~~~~\n~~~\n~~~~") (PARA (TEXT "will be rendered in HTML as:")) (REGION-BLOCK (("" . "example")) ((VERBATIM-EVAL () "~~~"))) (VERBATIM-CODE (("" . "zmk")) "~~~{-}\nThis is some\ntext with no \n real sense.\n~~~~") (PARA (TEXT "will be rendered as:")) (REGION-BLOCK (("" . "example")) ((VERBATIM-EVAL (("-" . "")) "This is some\ntext with no \n real sense."))) (VERBATIM-CODE (("" . "zmk")) "~~~draw\n+---+ +---+\n| A | --> | B |\n+---+ +---+\n~~~") (PARA (TEXT "will be rendered as:")) (REGION-BLOCK (("" . "example")) ((BLOB () "svg" "<svg class=\"zs-draw\" width=\"160\" height=\"80\" version=\"1.1\" xmlns=\"http://www.w3.org/2000/svg\" xmlns:xlink=\"http://www.w3.org/1999/xlink\"><marker id=\"Pointer\" viewBox=\"0 0 10 10\" refX=\"5\" refY=\"5\" markerUnits=\"strokeWidth\" markerWidth=\"5\" markerHeight=\"10\" orient=\"auto\"><path d=\"M 0 0 L 10 5 L 0 10 z\" /></marker><g id=\"closed\" stroke=\"#000\" stroke-width=\"2\" fill=\"none\"><path id=\"closed0\" d=\"M 5 10 L 15 10 L 25 10 L 35 10 L 45 10 L 45 30 L 45 50 L 35 50 L 25 50 L 15 50 L 5 50 L 5 30 Z\" /><path id=\"closed1\" d=\"M 105 10 L 115 10 L 125 10 L 135 10 L 145 10 L 145 30 L 145 50 L 135 50 L 125 50 L 115 50 L 105 50 L 105 30 Z\" /></g><g id=\"lines\" stroke=\"#000\" stroke-width=\"2\" fill=\"none\"><path id=\"open2\" marker-end=\"url(#Pointer)\" d=\"M 65 30 L 75 30 L 85 30 \" /></g><g id=\"text\" stroke=\"none\" style=\"font-family:monospace;font-size:15px\"><text id=\"obj3\" x=\"22.5\" y=\"35\">A</text><text id=\"obj4\" x=\"122.5\" y=\"35\">B</text></g></svg>")))))