((p "The " (a (@ (href . "00001006020000#role")) (kbd "role") " key") " defines what kind of zettel you are writing." " " "You are free to define your own roles." " " "It is allowed to set an empty value or to omit the role.") (p "Some roles are defined for technical reasons:") (dl (dt (a (@ (id . "configuration")) (kbd "configuration"))) (dd (p "A zettel that contains some configuration data / information for the Zettelstore." " " "Most prominent is " (a (@ (href . "00000000000100")) "00000000000100") ", as described in " (a (@ (href . "00001004020000")) "00001004020000") ".")) (dt (a (@ (id . "manual")) (kbd "manual"))) (dd (p "All zettel that document the inner workings of the Zettelstore software." " " "This role is only used in this specific Zettelstore.")) (dt (a (@ (id . "role")) (kbd "role"))) (dd (p "A zettel with the role " (@L (@H "“") "role" (@H "”")) " and a title, which names a " (a (@ (href . "00001006020000#role")) "role") ", is treated as a " (em "role zettel") "." " " "Basically, role zettel describe the role, and form a hierarchiy of meta-roles.")) (dt (a (@ (id . "tag")) (kbd "tag"))) (dd (p "A zettel with the role " (@L (@H "“") "tag" (@H "”")) " and a title, which names a " (a (@ (href . "00001006020000#tags")) "tag") ", is treated as a " (em "tag zettel") "." " " "Basically, tag zettel describe the tag, and form a hierarchiy of meta-tags.")) (dt (a (@ (id . "zettel")) (kbd "zettel"))) (dd (p "A zettel that contains your own thoughts." " " "The real reason to use this software."))) (p "If you adhere to the process outlined by Niklas Luhmann, a zettel could have one of the following three roles:") (dl (dt (a (@ (id . "note")) (kbd "note"))) (dd (p "A small note, to remember something." " " "Notes are not real zettel, they just help to create a real zettel." " " "Think of them as Post-it notes.")) (dt (a (@ (id . "literature")) (kbd "literature"))) (dd (p "Contains some remarks about a book, a paper, a web page, etc." " " "You should add a citation key for citing it.")) (dt (kbd "zettel")) (dd (p "(as described above)"))) (p "However, you are free to define additional roles, e.g. " (kbd "material") " for literature that is web-based only, " (kbd "slide") " for presentation slides, " (kbd "paper") " for the text of a scientific paper, " (kbd "project") " to define a project, ..."))