(((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 . "20241118175216") (name . "modified"))) (meta (@ (content . "20241118175216") (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 (@ (href . "https://tools.ietf.org/html/rfc5646") (rel . "external")) "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 (@ (href . "https://en.wikipedia.org/wiki/Billion_laughs_attack") (rel . "external")) "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-sequel-links")) (kbd "show-sequel-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#sequel")) (kbd "sequel")) ", and  " (a (@ (href . "00001006020000#prequel")) (kbd "prequel")) ".") (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 (@ (href . "https://daringfireball.net/projects/markdown/") (rel . "external")) "Markdown") " that uses a subset of " (a (@ (href . "https://yaml.org/") (rel . "external")) "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."))))