(BLOCK (PARA (TEXT "There are some reasons to mark text that should be rendered as uninterpreted:")) (UNORDERED (INLINE (TEXT "Mark text as literal, sometimes as part of a program.")) (INLINE (TEXT "Mark text as input you give into a computer via a keyboard.")) (INLINE (TEXT "Mark text as output from some computer, e.g. shown at the command line."))) (HEADING 1 () "literal-text" "literal-text" (TEXT "Literal text")) (PARA (TEXT "Literal text somehow relates to ") (LINK-ZETTEL () "00001007030500" (TEXT "verbatim blocks")) (TEXT ": their content should not be interpreted further, but may be rendered special.") (SOFT) (TEXT "It is specified by two grave accent characters (") (FORMAT-QUOTE () (LITERAL-INPUT () "`")) (TEXT ", U+0060), followed by the text, followed by again two grave accent characters, optionally followed by an ") (LINK-ZETTEL () "00001007050000" (TEXT "attribute")) (TEXT " specification.") (SOFT) (TEXT "Similar to the verbatim block, the literal element allows also a modifier letter grave accent (") (FORMAT-QUOTE () (LITERAL-INPUT () "ˋ")) (TEXT ", U+02CB) as an alternative to the grave accent character") (ENDNOTE () (TEXT "On some devices, such as an iPhone / iPad, a grave accent character is harder to enter and is often confused with a modifier letter grave accent.")) (TEXT ".") (SOFT) (TEXT "However, all four characters must be the same.")) (PARA (TEXT "The literal element supports the default attribute: when given, all spaces in the text are rendered in HTML as open box characters (U+2423).") (SOFT) (TEXT "The use of a generic attribute allows to specify a (") (LINK-ZETTEL () "00001007050200" (TEXT "programming")) (TEXT ") language that controls syntax coloring when rendered in HTML.")) (PARA (TEXT "If you want to specify a grave accent character in the text, either use modifier grave accent characters as delimiters for the element, or put a backslash character before the grave accent character you want to use inside the element.") (SOFT) (TEXT "If you want to enter a backslash character, you need to enter two of these.")) (PARA (TEXT "Examples:")) (UNORDERED (INLINE (LITERAL-CODE () "``abc def``") (TEXT " is rendered in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-CODE () "abc def")) (TEXT ".")) (INLINE (LITERAL-CODE () "``abc def``{-}") (TEXT " is rendered in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-CODE (("-" . "")) "abc def")) (TEXT ".")) (INLINE (LITERAL-CODE () "``abc\\`def``") (TEXT " is rendered in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-CODE () "abc`def")) (TEXT ".")) (INLINE (LITERAL-CODE () "``abc\\\\def``") (TEXT " is rendered in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-CODE () "abc\\def")) (TEXT "."))) (HEADING 1 () "computer-input" "computer-input" (TEXT "Computer input")) (PARA (TEXT "To mark text as input into a computer program, delimit your text with two apostrophe characters (") (FORMAT-QUOTE () (LITERAL-INPUT () "'")) (TEXT ", U+0027) on each side.")) (PARA (TEXT "Example:")) (UNORDERED (INLINE (LITERAL-CODE () "''STRG-C''") (TEXT " renders in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-INPUT () "STRG-C")) (TEXT ".")) (INLINE (LITERAL-CODE () "''STRG C''{-}") (TEXT " renders in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-INPUT (("-" . "")) "STRG C")) (TEXT "."))) (PARA (TEXT "Attributes can be specified, the default attribute has the same semantic as for literal text.")) (HEADING 1 () "computer-output" "computer-output" (TEXT "Computer output")) (PARA (TEXT "To mark text as output from a computer program, delimit your text with two equal sign characters (") (FORMAT-QUOTE () (LITERAL-INPUT () "=")) (TEXT ", U+003D) on each side.")) (PARA (TEXT "Examples:")) (UNORDERED (INLINE (LITERAL-CODE () "==The result is: 42==") (TEXT " renders in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-OUTPUT () "The result is: 42")) (TEXT ".")) (INLINE (LITERAL-CODE () "==The result is: 42=={-}") (TEXT " renders in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-OUTPUT (("-" . "")) "The result is: 42")) (TEXT "."))) (PARA (TEXT "Attributes can be specified, the default attribute has the same semantic as for literal text.")) (HEADING 1 () "inline-zettel-snippet" "inline-zettel-snippet" (TEXT "Inline-zettel snippet")) (PARA (TEXT "To specify an inline snippet in a different ") (LINK-ZETTEL () "00001008000000" (TEXT "syntax")) (TEXT ", delimit your text with two at-sign characters (") (FORMAT-QUOTE () (LITERAL-INPUT () "@")) (TEXT ", U+0040) on each side.")) (PARA (TEXT "You can add some ") (LINK-ZETTEL () "00001007050000" (TEXT "attributes")) (TEXT " immediate after the two closing at-sign characters to specify the syntax to use.") (SOFT) (TEXT "Either use the attribute key ") (FORMAT-QUOTE () (TEXT "syntax")) (TEXT " or use the generic attribute to specify the syntax value.") (SOFT) (TEXT "If no value is provided, ") (FORMAT-QUOTE () (LINK-ZETTEL () "00001008000000#text" (TEXT "text"))) (TEXT " is assumed.")) (PARA (TEXT "Examples:")) (UNORDERED (INLINE (LITERAL-CODE () "A @@-->@@ B") (TEXT " renders in HTML as ") (FORMAT-SPAN (("" . "example")) (TEXT "A ") (LITERAL-CODE (("" . "text")) "-->") (TEXT " B")) (TEXT ".")) (INLINE (LITERAL-CODE () "@@<small>@@{=html}Small@@</small>@@{=html}") (TEXT " renders in HTML as ") (FORMAT-SPAN (("" . "example")) (LITERAL-HTML () "<small>") (TEXT "Small") (LITERAL-HTML () "</small>")) (TEXT "."))) (PARA (TEXT "To some degree, an inline-zettel snippet is the ") (LITERAL-HTML () "<small>") (TEXT "smaller") (LITERAL-HTML () "</small>") (TEXT " sibling of the ") (LINK-ZETTEL () "00001007031200" (TEXT "inline-zettel block")) (TEXT ".") (SOFT) (TEXT "For HTML syntax, the same rules apply.")) (HEADING 1 () "math-mode-tex-input" "math-mode-tex-input" (TEXT "Math mode / ") (LITERAL-MATH () "\\TeX") (TEXT " input")) (PARA (TEXT "This allows to enter text, that is typically interpreted by ") (LITERAL-MATH () "\\TeX") (TEXT " or similar software.") (SOFT) (TEXT "The main difference to all other literal-like formatting above is that the backslash character (") (FORMAT-QUOTE () (LITERAL-INPUT () "\\")) (TEXT ", U+005C) has no special meaning.") (SOFT) (TEXT "Therefore it is well suited the enter text with a lot of backslash characters.")) (PARA (TEXT "Math mode text is delimited with two dollar signs (") (FORMAT-QUOTE () (LITERAL-INPUT () "$")) (TEXT ", U+0024) on each side.")) (PARA (TEXT "You can add some ") (LINK-ZETTEL () "00001007050000" (TEXT "attributes")) (TEXT " immediate after the two closing at-sign characters to specify the syntax to use.") (SOFT) (TEXT "Either use the attribute key ") (FORMAT-QUOTE () (TEXT "syntax")) (TEXT " or use the generic attribute to specify the syntax value.") (SOFT) (TEXT "If no syntax value is provided, math mode text roughly corresponds to literal text.")) (PARA (TEXT "Currently, Zettelstore does not support any syntax.") (SOFT) (TEXT "This will probably change.") (SOFT) (TEXT "However, external software might support specific syntax value, like ") (FORMAT-QUOTE () (TEXT "tex")) (TEXT ", ") (FORMAT-QUOTE () (TEXT "latex")) (TEXT ", ") (FORMAT-QUOTE () (TEXT "mathjax")) (TEXT ", ") (FORMAT-QUOTE () (TEXT "itex")) (TEXT ", or ") (FORMAT-QUOTE () (TEXT "webtex")) (TEXT ".") (SOFT) (TEXT "Even an empty syntax value might be supported.")) (PARA (TEXT "Example:")) (UNORDERED (INLINE (LITERAL-CODE () "Happy $$\\TeX$$!") (TEXT "is rendered as ") (FORMAT-SPAN (("" . "example")) (TEXT "Happy ") (LITERAL-MATH () "\\TeX") (TEXT "!")))))