(((meta (@ (content . "Zettelmarkup: Inline-Zettel Block") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #zettelmarkup #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001007040200 00001007800000 00001018000000") (name . "back"))) (meta (@ (content . "00001007030000 00001007040200 00001007800000 00001018000000") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20220201142439") (name . "created"))) (meta (@ (content . "00001004010000 00001007030000 00001007050000 00001008000000 00001008010500") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20221018121251") (name . "modified"))) (meta (@ (content . "20221018121251") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "An inline-zettel block allows to specify some content with another syntax without creating a new zettel." " " "This is useful, for example, if you want to embed some " (a (@ (href . "00001008010500")) "Markdown") " content, because you are too lazy to translate Markdown into Zettelmarkup." " " "Another example is to specify HTML code to use it for some kind of web front-end framework.") (p "As all other " (a (@ (href . "00001007030000#line-range-blocks")) "line-range blocks") ", an inline-zettel block begins with at least three identical characters, starting at the first position of a line." " " "For inline-zettel blocks, the at-sign character (" (@L (@H "&ldquo;") (kbd "@") (@H "&rdquo;")) ", U+0040) is used.") (p "You can add some " (a (@ (href . "00001007050000")) "attributes") " on the beginning line of a verbatim block, following the initiating characters." " " "The inline-zettel block uses the attribute key " (@L (@H "&ldquo;") "syntax" (@H "&rdquo;")) " to specify the " (a (@ (href . "00001008000000")) "syntax") " of the inline-zettel." " " "Alternatively, you can use the generic attribute to specify the syntax value." " " "If no value is provided, " (@L (@H "&ldquo;") (a (@ (href . "00001008000000#text")) "text") (@H "&rdquo;")) " is assumed.") (p "Any other character in this first line will be ignored.") (p "Text following the beginning line will not be interpreted, until a line begins with at least the same number of the same at-sign characters given at the beginning line." " " "This allows to enter some at-sign characters in the text that should not be interpreted at this level.") (p "Some examples:") (pre (code (@ (class . "language-zmk")) "@@@markdown\nA link to [this](00001007031200) zettel.\n@@@")) (p "will be rendered as:") (div (@ (class . "example")) (p "A link to " (a (@ (href . "00001007031200")) "this") " zettel.")) (p "If you have set " (a (@ (href . "00001004010000#insecure-html")) (kbd "insecure-html")) " to the value " (@L (@H "&ldquo;") "zettelmarkup" (@H "&rdquo;")) ", the following markup is not ignored:") (pre (code (@ (class . "language-zmk")) "@@@html\n<h1>H1 Heading</h1>\nAlea iacta est\n@@@")) (p "will render a section heading of level 1, which is not allowed within Zettelmarkup:") (div (@ (class . "example")) (@H "<h1>H1 Heading</h1>\nAlea iacta est")) (div (@ (class . "note")) (p "Please note: some HTML code will not be fully rendered because of possible security implications." " " "This include HTML lines that contain a " (kbd "<script>") " tag or an " (kbd "<iframe>") " tag.")) (p "Of course, you do not need to switch the syntax and you are allowed to nest inline-zettel blocks:") (pre (code (@ (class . "language-zmk")) "@@@@zmk\n1st level inline\n@@@zmk\n2nd level inline\n\nTransclusion of zettel to enable authentication:\n{{{00001010040100}}}\n@@@\n@@@@")) (p "will result in the following HTML output:") (div (@ (class . "example")) (p "1st level inline") (p "2nd level inline") (p "Transclusion of zettel to enable authentication:") (p "To enable authentication, you must create a zettel that stores " (a (@ (href . "00001010040200")) "authentication data") " for the owner." " " "Then you must reference this zettel within the " (a (@ (href . "00001004010000#owner")) "startup configuration") " under the key " (kbd "owner") "." " " "Once the startup configuration contains a valid " (a (@ (href . "00001006050000")) "zettel identifier") " under that key, authentication is enabled.") (p "Please note that you must also set key " (kbd "secret") " of the " (a (@ (href . "00001004010000#secret")) "startup configuration") " to some random string data (minimum length is 16 bytes) to secure the data exchanged with a client system.")))