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