(((meta (@ (content . "Zettelmarkup: Links") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #zettelmarkup #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001006020000 00001007010000 00001007031100 00001007031140 00001007040300 00001007040320 00001007040324 00001007040350 00001007906000 00001007990000") (name . "back"))) (meta (@ (content . "00001006020000 00001007010000 00001007031100 00001007031140 00001007040300 00001007040320 00001007040324 00001007040350 00001007906000 00001007990000") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20210810155955") (name . "created"))) (meta (@ (content . "00001004010000 00001006050000 00001007040000 00001007700000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20221024173849") (name . "modified"))) (meta (@ (content . "20221024173849") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "There are two kinds of links, regardless of links to (internal) other zettel or to (external) material." " " "Both kinds begin with two consecutive left square bracket characters (" (@L (@H "&ldquo;") (kbd "[") (@H "&rdquo;")) ", U+005B) and ends with two consecutive right square bracket characters (" (@L (@H "&ldquo;") (kbd "]") (@H "&rdquo;")) ", U+005D)." " " "If the content starts with more than two left square bracket characters, all but the last two will be treated as text.") (p "The first form provides some text plus the link specification, delimited by a vertical bar character (" (@L (@H "&ldquo;") (kbd "|") (@H "&rdquo;")) ", U+007C): " (code "[[text|linkspecification]]") "." " " "The text is a sequence of " (a (@ (href . "00001007040000")) "inline elements") "." " " "However, it should not contain links itself.") (p "The second form just provides a link specification between the square brackets." " " "Its text is derived from the link specification, e.g. by interpreting the link specification as text: " (code "[[linkspecification]]") ".") (h2 (@ (id . "link-specifications")) "Link specifications") (p "The link specification for another zettel within the same Zettelstore is just the " (a (@ (href . "00001006050000")) "zettel identifier") "." " " "To reference some content within a zettel, you can append a number sign character (" (@L (@H "&ldquo;") (kbd "#") (@H "&rdquo;")) ", U+0023) and the name of the mark to the zettel identifier." " " "The resulting reference is called " (@L (@H "&ldquo;") "zettel reference" (@H "&rdquo;")) ".") (p "If the link specification begins with the string " (kbd "query:") ", the text following this string will be interpreted as a " (a (@ (href . "00001007700000")) "query expression") "." " " "The resulting reference is called " (@L (@H "&ldquo;") "query reference" (@H "&rdquo;")) "." " " "When this type of references is rendered, it will typically reference a list of all zettel that fulfills the query expression.") (p "A link specification starting with one slash character (" (@L (@H "&ldquo;") (kbd "/") (@H "&rdquo;")) ", U+002F), or one or two full stop characters (" (@L (@H "&ldquo;") (kbd ".") (@H "&rdquo;")) ", U+002E) followed by a slash character," " " "will be interpreted as a local reference, called " (em "hosted reference") "." " " "Such references will be interpreted relative to the web server hosting the Zettelstore.") (p "If a link specification begins with two slash characters (called " (em "based reference") "), it will be interpreted relative to the value of " (a (@ (href . "00001004010000#url-prefix")) (kbd "url-prefix")) ".") (p "To specify some material outside the Zettelstore, just use an normal Uniform Resource Identifier (URI) as defined by " (a (@ (href . "https://tools.ietf.org/html/rfc3986") (rel . "external")) "RFC 3986") ".") (h2 (@ (id . "other-topics")) "Other topics") (p "If the link references another zettel, and this zettel is not readable for the current user, because of a missing access rights, then only the associated text is presented."))