(((meta (@ (content . "Configure the running Zettelstore") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#configuration #manual #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001004000000 00001004010000 00001005000000 00001005090000 00001006020100 00001006055000 00001007031110 00001007040324 00001008010000 00001012080500 00001017000000 00001018000000") (name . "back"))) (meta (@ (content . "00001004000000 00001004010000 00001004020200 00001005000000 00001005090000 00001006020000 00001006020100 00001006055000 00001007031110 00001007040324 00001008010000 00001010040200 00001010070200 00001012080500 00001017000000 00001018000000") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20210126175322") (name . "created"))) (meta (@ (content . "00000000000100 00001004020200 00001006020000 00001006030500 00001010040100 00001010040200 00001010070200 00001012000000 00001014000000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20231126180829") (name . "modified"))) (meta (@ (content . "20231126180829") (name . "published"))) (meta (@ (content . "false") (name . "show-back-links"))) (meta (@ (content . "public") (name . "visibility")))) (p "You" " " "can" " " "configure" " " "a" " " "running" " " "Zettelstore" " " "by" " " "modifying" " " "the" " " "special" " " "zettel" " " "with" " " "the" " " "ID" " " (a (@ (href . "00000000000100")) "00000000000100") "." " " "This" " " "zettel" " " "is" " " "called" " " (em "configuration" " " "zettel") "." " " "The" " " "following" " " "metadata" " " "keys" " " "change" " " "the" " " "appearance" " " "/" " " "behavior" " " "of" " " "Zettelstore." " " "Some" " " "of" " " "them" " " "can" " " "be" " " "overwritten" " " "in" " " "an" " " (a (@ (href . "00001010040200")) "user" " " "zettel") "," " " "a" " " "subset" " " "of" " " "those" " " "may" " " "be" " " "overwritten" " " "in" " " "zettel" " " "that" " " "is" " " "currently" " " "used." " " "See" " " "the" " " "full" " " "list" " " "of" " " (a (@ (href . "00001004020200")) "metadata" " " "that" " " "may" " " "be" " " "overwritten") ".") (dl (dt (a (@ (id . "default-copyright")) (kbd "default-copyright"))) (dd (p "Copyright" " " "value" " " "to" " " "be" " " "used" " " "when" " " "rendering" " " "content." " " "Can" " " "be" " " "overwritten" " " "in" " " "a" " " "zettel" " " "with" " " (a (@ (href . "00001006020000")) "meta" " " "key") " " (kbd "copyright") ".") (p "Default:" " " "(the" " " "empty" " " "string).")) (dt (a (@ (id . "default-license")) (kbd "default-license"))) (dd (p "License" " " "value" " " "to" " " "be" " " "used" " " "when" " " "rendering" " " "content." " " "Can" " " "be" " " "overwritten" " " "in" " " "a" " " "zettel" " " "with" " " (a (@ (href . "00001006020000")) "meta" " " "key") " " (kbd "license") ".") (p "Default:" " " "(the" " " "empty" " " "string).")) (dt (a (@ (id . "default-visibility")) (kbd "default-visibility"))) (dd (p "Visibility" " " "to" " " "be" " " "used," " " "if" " " "zettel" " " "does" " " "not" " " "specify" " " "a" " " "value" " " "for" " " "the" " " (a (@ (href . "00001006020000#visibility")) (kbd "visibility")) " " "metadata" " " "key.") (p "Default:" " " (@L (@H "&ldquo;") "login" (@H "&rdquo;")) ".")) (dt (a (@ (id . "expert-mode")) (kbd "expert-mode"))) (dd (p "If" " " "set" " " "to" " " "a" " " (a (@ (href . "00001006030500")) "boolean" " " "true" " " "value") "," " " "all" " " "zettel" " " "with" " " (a (@ (href . "00001010070200")) "visibility" " " (@L (@H "&ldquo;") "expert" (@H "&rdquo;"))) " " "will" " " "be" " " "shown" " " "(to" " " "the" " " "owner," " " "if" " " (a (@ (href . "00001010040100")) "authentication" " " "is" " " "enabled") ";" " " "to" " " "all," " " "otherwise)." " " "This" " " "affects" " " "most" " " "computed" " " "zettel.") (p "Default:" " " (@L (@H "&ldquo;") "False" (@H "&rdquo;")) ".")) (dt (a (@ (id . "footer-zettel")) (kbd "footer-zettel"))) (dd (p "Identifier" " " "of" " " "a" " " "zettel" " " "that" " " "is" " " "rendered" " " "as" " " "HTML" " " "and" " " "will" " " "be" " " "placed" " " "as" " " "the" " " "footer" " " "of" " " "every" " " "zettel" " " "in" " " "the" " " (a (@ (href . "00001014000000")) "web" " " "user" " " "interface") "." " " "Zettel" " " "content," " " "delivered" " " "via" " " "the" " " (a (@ (href . "00001012000000")) "API") " " "as" " " "symbolic" " " "expressions," " " "etc." " " "is" " " "not" " " "affected." " " "If" " " "the" " " "zettel" " " "identifier" " " "is" " " "invalid" " " "or" " " "references" " " "a" " " "zettel" " " "that" " " "could" " " "not" " " "be" " " "read" " " "(possibly" " " "because" " " "of" " " "a" " " "limited" " " (a (@ (href . "00001010070200")) "visibility" " " "setting") ")," " " "nothing" " " "is" " " "written" " " "as" " " "the" " " "footer.") (p "May" " " "be" " " (a (@ (href . "00001004020200")) "overwritten") " " "in" " " "a" " " "user" " " "zettel.") (p "Default:" " " "(an" " " "invalid" " " "zettel" " " "identifier)")) (dt (a (@ (id . "home-zettel")) (kbd "home-zettel"))) (dd (p "Specifies" " " "the" " " "identifier" " " "of" " " "the" " " "zettel," " " "that" " " "should" " " "be" " " "presented" " " "for" " " "the" " " "default" " " "view" " " "/" " " "home" " " "view." " " "If" " " "not" " " "given" " " "or" " " "if" " " "the" " " "identifier" " " "does" " " "not" " " "identify" " " "a" " " "zettel," " " "the" " " "zettel" " " "with" " " "the" " " "identifier" " " (kbd "00010000000000") " " "is" " " "shown.") (p "May" " " "be" " " (a (@ (href . "00001004020200")) "overwritten") " " "in" " " "a" " " "user" " " "zettel.")) (dt (a (@ (id . "lang")) (kbd "lang"))) (dd (p "Language" " " "to" " " "be" " " "used" " " "when" " " "displaying" " " "content.") (p "Default:" " " (@L (@H "&ldquo;") "en" (@H "&rdquo;")) ".") (p "This" " " "value" " " "is" " " "used" " " "as" " " "a" " " "default" " " "value," " " "if" " " "it" " " "is" " " "not" " " "set" " " "in" " " "an" " " "user's" " " "zettel" " " "or" " " "in" " " "a" " " "zettel." " " "It" " " "is" " " "also" " " "used" " " "to" " " "specify" " " "the" " " "language" " " "for" " " "all" " " "non-zettel" " " "content," " " "e.g." " " "lists" " " "or" " " "search" " " "results.") (p "Use" " " "values" " " "according" " " "to" " " "the" " " "language" " " "definition" " " "of" " " (a (@ (class . "external") (href . "https://tools.ietf.org/html/rfc5646")) "RFC-5646") ".")) (dt (a (@ (id . "max-transclusions")) (kbd "max-transclusions"))) (dd (p "Maximum" " " "number" " " "of" " " "indirect" " " "transclusion." " " "This" " " "is" " " "used" " " "to" " " "avoid" " " "an" " " "exploding" " " (@L (@H "&ldquo;") "transclusion" " " "bomb" (@H "&rdquo;")) "," " " "a" " " "form" " " "of" " " "a" " " (a (@ (class . "external") (href . "https://en.wikipedia.org/wiki/Billion_laughs_attack")) "billion" " " "laughs" " " "attack") ".") (p "Default:" " " (@L (@H "&ldquo;") "1024" (@H "&rdquo;")) ".")) (dt (a (@ (id . "show-back-links")) (kbd "show-back-links")) "," " " (a (@ (id . "show-folge-links")) (kbd "show-folge-links")) "," " " (a (@ (id . "show-subordinate-links")) (kbd "show-subordinate-links")) "," " " (a (@ (id . "show-successor-links")) (kbd "show-successor-links"))) (dd (p "When" " " "displaying" " " "a" " " "zettel" " " "in" " " "the" " " "web" " " "user" " " "interface," " " "references" " " "to" " " "other" " " "zettel" " " "are" " " "normally" " " "shown" " " "below" " " "the" " " "content" " " "of" " " "the" " " "zettel." " " "This" " " "affects" " " "the" " " "metadata" " " "keys" " " (a (@ (href . "00001006020000#back")) (kbd "back")) "," " " (a (@ (href . "00001006020000#folge")) (kbd "folge")) "," " " (a (@ (href . "00001006020000#subordinates")) (kbd "subordinates")) "," " " "and" " " (a (@ (href . "00001006020000#successors")) (kbd "successors")) ".") (p "These" " " "configuration" " " "keys" " " "may" " " "be" " " "used" " " "to" " " "show," " " "not" " " "to" " " "show," " " "or" " " "to" " " "close" " " "the" " " "list" " " "of" " " "referenced" " " "zettel.") (p "Allowed" " " "values" " " "are:" " " (@L (@H "&ldquo;") "false" (@H "&rdquo;")) " " "(will" " " "not" " " "show" " " "the" " " "list)," " " (@L (@H "&ldquo;") "close" (@H "&rdquo;")) " " "(will" " " "show" " " "the" " " "list" " " "closed)," " " "and" " " (@L (@H "&ldquo;") "open" (@H "&rdquo;")) " " "/" " " (@L (@H "&ldquo;" "&rdquo;")) " " "(will" " " "show" " " "the" " " "list).") (p "Default:" " " (@L (@H "&ldquo;" "&rdquo;")) ".") (p "May" " " "be" " " (a (@ (href . "00001004020200")) "overwritten") " " "in" " " "a" " " "user" " " "zettel," " " "so" " " "that" " " "setting" " " "will" " " "only" " " "affect" " " "the" " " "given" " " "user." " " "Alternatively," " " "it" " " "may" " " "be" " " "overwritten" " " "in" " " "a" " " "zettel," " " "so" " " "that" " " "that" " " "the" " " "setting" " " "will" " " "affect" " " "only" " " "the" " " "given" " " "zettel.") (p "This" " " "zettel" " " "is" " " "an" " " "example" " " "of" " " "a" " " "zettel" " " "that" " " "sets" " " (kbd "show-back-links") " " "to" " " (@L (@H "&ldquo;") "false" (@H "&rdquo;")) ".")) (dt (a (@ (id . "site-name")) (kbd "site-name"))) (dd (p "Name" " " "of" " " "the" " " "Zettelstore" " " "instance." " " "Will" " " "be" " " "used" " " "when" " " "displaying" " " "some" " " "lists.") (p "Default:" " " (@L (@H "&ldquo;") "Zettelstore" (@H "&rdquo;")) ".")) (dt (a (@ (id . "yaml-header")) (kbd "yaml-header"))) (dd (p "If" " " (a (@ (href . "00001006030500")) "true") "," " " "metadata" " " "and" " " "content" " " "will" " " "be" " " "separated" " " "by" " " (kbd "---\\n") " " "instead" " " "of" " " "an" " " "empty" " " "line" " " "(" (kbd "\\n\\n") ").") (p "Default:" " " (@L (@H "&ldquo;") "False" (@H "&rdquo;")) ".") (p "You" " " "will" " " "probably" " " "use" " " "this" " " "key," " " "if" " " "you" " " "are" " " "working" " " "with" " " "another" " " "software" " " "processing" " " (a (@ (class . "external") (href . "https://daringfireball.net/projects/markdown/")) "Markdown") " " "that" " " "uses" " " "a" " " "subset" " " "of" " " (a (@ (class . "external") (href . "https://yaml.org/")) "YAML") " " "to" " " "specify" " " "metadata.")) (dt (a (@ (id . "zettel-file-syntax")) (kbd "zettel-file-syntax"))) (dd (p "If" " " "you" " " "create" " " "a" " " "new" " " "zettel" " " "with" " " "a" " " "syntax" " " "different" " " "to" " " (@L (@H "&ldquo;") "zmk" (@H "&rdquo;")) "," " " "Zettelstore" " " "will" " " "store" " " "the" " " "zettel" " " "as" " " "two" " " "files:" " " "one" " " "for" " " "the" " " "metadata" " " "(file" " " "without" " " "a" " " "filename" " " "extension)" " " "and" " " "another" " " "for" " " "the" " " "content" " " "(file" " " "extension" " " "based" " " "on" " " "the" " " "syntax" " " "value)." " " "If" " " "you" " " "want" " " "to" " " "specify" " " "alternative" " " "syntax" " " "values," " " "for" " " "which" " " "you" " " "want" " " "new" " " "zettel" " " "to" " " "be" " " "stored" " " "in" " " "one" " " "file" " " "(file" " " "extension" " " (kbd ".zettel") ")," " " "you" " " "can" " " "use" " " "this" " " "key." " " "All" " " "values" " " "are" " " "case-insensitive," " " "duplicate" " " "values" " " "are" " " "removed.") (p "For" " " "example," " " "you" " " "could" " " "use" " " "this" " " "key" " " "if" " " "you're" " " "working" " " "with" " " "Markdown" " " "syntax" " " "and" " " "you" " " "want" " " "to" " " "store" " " "metadata" " " "and" " " "content" " " "in" " " "one" " " (kbd ".zettel") " " "file.") (p "If" " " (kbd "yaml-header") " " "evaluates" " " "to" " " "true," " " "a" " " "zettel" " " "is" " " "always" " " "stored" " " "in" " " "one" " " (kbd ".zettel") " " "file."))))