(((meta (@ (content . "Supported values for metadata key ''read-only''") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #meta #reference #zettel #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001012921200") (name . "back"))) (meta (@ (content . "00001006020000 00001010070300 00001012921200") (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 . "00001004011400 00001006020000 00001006030500 00001010040100 00001010070300 00001014000000") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20211124132040") (name . "modified"))) (meta (@ (content . "20211124132040") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "A zettel can be marked as read-only, if it contains a metadata value for key" " " (a (@ (href . "00001006020000#read-only")) (kbd "read-only")) "." " " "If user authentication is " (a (@ (href . "00001010040100")) "enabled") ", it is possible to allow some users to change the zettel," " " "depending on their " (a (@ (href . "00001010070300")) "user role") "." " " "Otherwise, the read-only mark is just a binary value.") (h2 (@ (id . "no-authentication")) "No authentication") (p "If there is no metadata value for key " (kbd "read-only") " or if its " (a (@ (href . "00001006030500")) "boolean value") " " "is interpreted as " (@L (@H "&ldquo;") "false" (@H "&rdquo;")) ", anybody can modify the zettel.") (p "If the metadata value is something else (the value " (@L (@H "&ldquo;") "true" (@H "&rdquo;")) " is recommended)," " " "the user cannot modify the zettel through the " (a (@ (href . "00001014000000")) "web user interface") "." " " "However, if the zettel is stored as a file in a " (a (@ (href . "00001004011400")) "directory box") "," " " "the zettel could be modified using an external editor.") (h2 (@ (id . "authentication-enabled")) "Authentication enabled") (p "If there is no metadata value for key " (kbd "read-only") " or if its " (a (@ (href . "00001006030500")) "boolean value") " " "is interpreted as " (@L (@H "&ldquo;") "false" (@H "&rdquo;")) ", anybody can modify the zettel.") (p "If the metadata value is the same as an explicit " (a (@ (href . "00001010070300")) "user role") "," " " "users with that role (or a role with lower rights) are not allowed to modify the zettel.") (dl (dt (@L (@H "&ldquo;") "reader" (@H "&rdquo;"))) (dd (p "Neither an unauthenticated user nor a user with role " (@L (@H "&ldquo;") "reader" (@H "&rdquo;")) " is allowed to modify the zettel." " " "Users with role " (@L (@H "&ldquo;") "writer" (@H "&rdquo;")) " or the owner itself still can modify the zettel.")) (dt (@L (@H "&ldquo;") "writer" (@H "&rdquo;"))) (dd (p "Neither an unauthenticated user, nor users with roles " (@L (@H "&ldquo;") "reader" (@H "&rdquo;")) " or " (@L (@H "&ldquo;") "writer" (@H "&rdquo;")) " are allowed to modify the zettel." " " "Only the owner of the Zettelstore can modify the zettel."))) (p "If the metadata value is something else (one of the values " (@L (@H "&ldquo;") "true" (@H "&rdquo;")) " or " (@L (@H "&ldquo;") "owner" (@H "&rdquo;")) " is recommended)," " " "no user is allowed modify the zettel through the " (a (@ (href . "00001014000000")) "web user interface") "." " " "However, if the zettel is accessible as a file in a " (a (@ (href . "00001004011400")) "directory box") "," " " "the zettel could be modified using an external editor." " " "Typically the owner of a Zettelstore have such an access."))