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