((META (EMPTY-STRING title "Zettelmarkup: Inline-Structured Elements") (WORD role "manual") (TAG-SET tags ("#manual" "#zettelmarkup" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001006020000" "00001007000000" "00001007010000" "00001007030000" "00001007030100" "00001007030200" "00001007030300" "00001007030400" "00001007030600" "00001007030700" "00001007030800" "00001007031000" "00001007031110" "00001007040310" "00001007040324" "00001007040340" "00001007040350" "00001007800000" "00001007903000" "00001007990000" "00001012931000")) (ZID-SET backward ("00001006020000" "00001007000000" "00001007010000" "00001007030000" "00001007030100" "00001007030200" "00001007030300" "00001007030400" "00001007030600" "00001007030700" "00001007030800" "00001007031000" "00001007031110" "00001007040310" "00001007040324" "00001007040340" "00001007040350" "00001007050000" "00001007800000" "00001007903000" "00001007990000" "00001012931000")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20210126175322") (ZID-SET forward ("00001007040100" "00001007040200" "00001007040300" "00001007040330" "00001007050000")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20220920143243") (TIMESTAMP published "20220920143243") (WORD visibility "public")) (BLOCK (PARA (TEXT "Most characters you type is concerned with inline-structured elements.") (SOFT) (TEXT "The content of a zettel contains is many cases just ordinary text, lightly formatted.") (SOFT) (TEXT "Inline-structured elements allow to format your text and add some helpful links or images.") (SOFT) (TEXT "Sometimes, you want to enter characters that have no representation on your keyboard.")) (DESCRIPTION ((TEXT "Text formatting")) (BLOCK (BLOCK (PARA (TEXT "Every ") (LINK-ZETTEL () "00001007040100" (TEXT "text formatting")) (TEXT " element begins with two same characters at the beginning.") (SOFT) (TEXT "It lasts until the same two characters occurred the second time.") (SOFT) (TEXT "Some of these elements explicitly support ") (LINK-ZETTEL () "00001007050000" (TEXT "attributes")) (TEXT ".")))) ((TEXT "Literal-like formatting")) (BLOCK (BLOCK (PARA (TEXT "Sometime you want to enter the text as it is."))) (BLOCK (PARA (TEXT "This is the core motivation of ") (LINK-ZETTEL () "00001007040200" (TEXT "literal-like formatting")) (TEXT ".")))) ((TEXT "Reference-like text")) (BLOCK (BLOCK (PARA (TEXT "You can reference other zettel and (external) material within one zettel.") (SOFT) (TEXT "This kind of reference may be a link, or an images that is display inline when the zettel is rendered.") (SOFT) (TEXT "Footnotes sometimes factor out some useful text that hinders the flow of reading text.") (SOFT) (TEXT "Internal marks allow to reference something within a zettel.") (SOFT) (TEXT "An important aspect of all knowledge work is to reference others work, e.g. with citation keys.") (SOFT) (TEXT "All these elements can be subsumed under ") (LINK-ZETTEL () "00001007040300" (TEXT "reference-like text")) (TEXT "."))))) (HEADING 1 () "other-inline-elements" "other-inline-elements" (TEXT "Other inline elements")) (HEADING 2 () "comment" "comment" (TEXT "Comment")) (PARA (TEXT "A comment begins with two consecutive percent sign characters (") (FORMAT-QUOTE () (LITERAL-INPUT () "%")) (TEXT ", U+0025).") (SOFT) (TEXT "It ends at the end of the line where it begins.")) (HEADING 2 () "backslash" "backslash" (TEXT "Backslash")) (PARA (TEXT "The backslash character (") (FORMAT-QUOTE () (LITERAL-INPUT () "\\")) (TEXT ", U+005C) gives the next character another meaning.")) (UNORDERED (INLINE (TEXT "If a space character follows, it is converted in a non-breaking space (U+00A0).")) (INLINE (TEXT "If a line ending follows the backslash character, the line break is converted from a ") (FORMAT-EMPH () (TEXT "soft break")) (TEXT " into a ") (FORMAT-EMPH () (TEXT "hard break")) (TEXT ".")) (INLINE (TEXT "Every other character is taken as itself, but without the interpretation of a Zettelmarkup element.") (SOFT) (TEXT "For example, if you want to enter a ") (FORMAT-QUOTE () (LITERAL-INPUT () "]")) (TEXT " into a ") (LINK-ZETTEL () "00001007040330" (TEXT "footnote text")) (TEXT ", you should escape it with a backslash."))) (HEADING 2 () "entities-more" "entities-more" (TEXT "Entities & more")) (PARA (TEXT "Sometimes it is not easy to enter special characters.") (SOFT) (TEXT "If you know the Unicode code point of that character, or its name according to the ") (LINK-EXTERNAL () "https://html.spec.whatwg.org/multipage/named-characters.html" (TEXT "HTML standard")) (TEXT ", you can enter it by number or by name.")) (PARA (TEXT "Regardless which method you use, an entity always begins with an ampersand character (") (FORMAT-QUOTE () (LITERAL-INPUT () "&")) (TEXT ", U+0026) and ends with a semicolon character (") (FORMAT-QUOTE () (LITERAL-INPUT () ";")) (TEXT ", U+003B).") (SOFT) (TEXT "If you know the HTML name of the character you want to enter, put it between these two character.") (SOFT) (TEXT "Example: ") (LITERAL-CODE () "&amp;") (TEXT " is rendered as ") (FORMAT-SPAN (("" . "example")) (TEXT "&")) (TEXT ".")) (PARA (TEXT "If you want to enter its numeric code point, a number sign character must follow the ampersand character, followed by digits to base 10.") (SOFT) (TEXT "Example: ") (LITERAL-CODE () "&#38;") (TEXT " is rendered in HTML as ") (FORMAT-SPAN (("" . "example")) (TEXT "&")) (TEXT ".")) (PARA (TEXT "You also can enter its numeric code point as a hex number, if you put the letter ") (FORMAT-QUOTE () (TEXT "x")) (TEXT " after the numeric sign character.") (SOFT) (TEXT "Example: ") (LITERAL-CODE () "&#x26;") (TEXT " is rendered in HTML as ") (FORMAT-SPAN (("" . "example")) (TEXT "&")) (TEXT ".")) (PARA (TEXT "According to the ") (LINK-EXTERNAL () "https://html.spec.whatwg.org/multipage/syntax.html#character-references" (TEXT "HTML Standard")) (TEXT ", some numeric code points are not allowed.") (SOFT) (TEXT "These are all code point below the numeric value 32 (decimal) or 0x20 (hex) and all code points for ") (LINK-EXTERNAL () "https://infra.spec.whatwg.org/#noncharacter" (TEXT "noncharacter")) (TEXT " values.")) (PARA (TEXT "Since some Unicode character are used quite often, a special notation is introduced for them:")) (UNORDERED (INLINE (TEXT "Two consecutive hyphen-minus characters result in an ") (FORMAT-EMPH () (TEXT "en-dash")) (TEXT " character.") (SOFT) (TEXT "It is typically used in numeric ranges.") (SOFT) (LITERAL-CODE () "pages 4--7") (TEXT " will be rendered in HTML as: ") (FORMAT-SPAN (("" . "example")) (TEXT "pages 4–7")) (TEXT ".") (SOFT) (TEXT "Alternative specifications are: ") (LITERAL-CODE () "&ndash;") (TEXT ", ") (LITERAL-CODE () "&x8211") (TEXT ", and ") (LITERAL-CODE () "&#x2013") (TEXT ".")))))