((p "This" " " "page" " " "lists" " " "some" " " "problems" " " "and" " " "their" " " "solutions" " " "that" " " "may" " " "occur" " " "when" " " "using" " " "your" " " "Zettelstore.") (h2 (@ (id . "installation")) "Installation") (ul (li (p (strong "Problem:") " " "When" " " "you" " " "double-click" " " "on" " " "the" " " "Zettelstore" " " "executable" " " "icon," " " "macOS" " " "complains" " " "that" " " "Zettelstore" " " "is" " " "an" " " "application" " " "from" " " "an" " " "unknown" " " "developer." " " "Therefore," " " "it" " " "will" " " "not" " " "start" " " "Zettelstore.") (ul (li (strong "Solution:") " " "Press" " " "the" " " (kbd "Ctrl") " " "key" " " "while" " " "opening" " " "the" " " "context" " " "menu" " " "of" " " "the" " " "Zettelstore" " " "executable" " " "with" " " "a" " " "right-click." " " "A" " " "dialog" " " "is" " " "then" " " "opened" " " "where" " " "you" " " "can" " " "acknowledge" " " "that" " " "you" " " "understand" " " "the" " " "possible" " " "risks" " " "when" " " "you" " " "start" " " "Zettelstore." " " "This" " " "dialog" " " "is" " " "only" " " "resented" " " "once" " " "for" " " "a" " " "given" " " "Zettelstore" " " "executable."))) (li (p (strong "Problem:") " " "When" " " "you" " " "double-click" " " "on" " " "the" " " "Zettelstore" " " "executable" " " "icon," " " "Windows" " " "complains" " " "that" " " "Zettelstore" " " "is" " " "an" " " "application" " " "from" " " "an" " " "unknown" " " "developer.") (ul (li (strong "Solution:") " " "Windows" " " "displays" " " "a" " " "dialog" " " "where" " " "you" " " "can" " " "acknowledge" " " "possible" " " "risks" " " "and" " " "allows" " " "to" " " "start" " " "Zettelstore.")))) (h2 (@ (id . "authentication")) "Authentication") (ul (li (p (strong "Problem:") " " (a (@ (href . "00001010040100")) "Authentication" " " "is" " " "enabled") " " "for" " " "a" " " "local" " " "running" " " "Zettelstore" " " "and" " " "there" " " "is" " " "a" " " "valid" " " (a (@ (href . "00001010040200")) "user" " " "zettel") " " "for" " " "the" " " "owner." " " "But" " " "entering" " " "user" " " "name" " " "and" " " "password" " " "at" " " "the" " " (a (@ (href . "00001014000000")) "web" " " "user" " " "interface") " " "seems" " " "to" " " "be" " " "ignored," " " "while" " " "entering" " " "a" " " "wrong" " " "password" " " "will" " " "result" " " "in" " " "an" " " "error" " " "message.") (ul (li (strong "Explanation:") " " "A" " " "local" " " "running" " " "Zettelstore" " " "typically" " " "means," " " "that" " " "you" " " "are" " " "accessing" " " "the" " " "Zettelstore" " " "using" " " "an" " " "URL" " " "with" " " "schema" " " (kbd "http://") "," " " "and" " " "not" " " (kbd "https://") "," " " "for" " " "example" " " (kbd "http://localhost:23123") "." " " "The" " " "difference" " " "between" " " "these" " " "two" " " "is" " " "the" " " "missing" " " "encryption" " " "of" " " "user" " " "name" " " "/" " " "password" " " "and" " " "for" " " "the" " " "answer" " " "of" " " "the" " " "Zettelstore" " " "if" " " "you" " " "use" " " "the" " " (kbd "http://") " " "schema." " " "To" " " "be" " " "secure" " " "by" " " "default," " " "the" " " "Zettelstore" " " "will" " " "not" " " "work" " " "in" " " "an" " " "insecure" " " "environment.") (li (strong "Solution" " " "1:") " " "If" " " "you" " " "are" " " "sure" " " "that" " " "your" " " "communication" " " "medium" " " "is" " " "safe," " " "even" " " "if" " " "you" " " "use" " " "the" " " (kbd "http://") " " "schema" " " "(for" " " "example," " " "you" " " "are" " " "running" " " "the" " " "Zettelstore" " " "on" " " "the" " " "same" " " "computer" " " "you" " " "are" " " "working" " " "on," " " "or" " " "if" " " "the" " " "Zettelstore" " " "is" " " "running" " " "on" " " "a" " " "computer" " " "in" " " "your" " " "protected" " " "local" " " "network)," " " "then" " " "you" " " "could" " " "add" " " "the" " " "entry" " " (kbd "insecure-cookie: true") " " "in" " " "you" " " (a (@ (href . "00001004010000#insecure-cookie")) "startup" " " "configuration") " " "file.") (li (strong "Solution" " " "2:") " " "If" " " "you" " " "are" " " "not" " " "sure" " " "about" " " "the" " " "security" " " "of" " " "your" " " "communication" " " "medium" " " "(for" " " "example," " " "if" " " "unknown" " " "persons" " " "might" " " "use" " " "your" " " "local" " " "network)," " " "then" " " "you" " " "should" " " "run" " " "an" " " (a (@ (href . "00001010090100")) "external" " " "server") " " "in" " " "front" " " "of" " " "your" " " "Zettelstore" " " "to" " " "enable" " " "the" " " "use" " " "of" " " "the" " " (kbd "https://") " " "schema.")))) (h2 (@ (id . "working-with-zettel-files")) "Working" " " "with" " " "Zettel" " " "Files") (ul (li (p (strong "Problem:") " " "When" " " "you" " " "delete" " " "a" " " "zettel" " " "file" " " "by" " " "removing" " " "it" " " "from" " " "the" " " (@L (@H "&ldquo;") "disk" (@H "&rdquo;")) "," " " "e.g." " " "by" " " "dropping" " " "it" " " "into" " " "the" " " "trash" " " "folder," " " "by" " " "dragging" " " "into" " " "another" " " "folder," " " "or" " " "by" " " "removing" " " "it" " " "from" " " "the" " " "command" " " "line," " " "Zettelstore" " " "sometimes" " " "did" " " "not" " " "detect" " " "that" " " "change." " " "If" " " "you" " " "access" " " "the" " " "zettel" " " "via" " " "Zettelstore," " " "an" " " "error" " " "is" " " "reported.") (ul (li (strong "Explanation:") " " "Sometimes," " " "the" " " "operating" " " "system" " " "does" " " "not" " " "tell" " " "Zettelstore" " " "about" " " "the" " " "removed" " " "zettel." " " "This" " " "occurs" " " "mostly" " " "under" " " "MacOS.") (li (strong "Solution" " " "1:") " " "If" " " "you" " " "are" " " "running" " " "Zettelstore" " " "in" " " (a (@ (href . "00001004051100")) (@L (@H "&ldquo;") "simple-mode" (@H "&rdquo;"))) " " "or" " " "if" " " "you" " " "have" " " "enabled" " " (a (@ (href . "00001004020000#expert-mode")) (kbd "expert-mode")) "," " " "you" " " "are" " " "allowed" " " "to" " " "refresh" " " "the" " " "internal" " " "data" " " "by" " " "selecting" " " (@L (@H "&ldquo;") "Refresh" (@H "&rdquo;")) " " "in" " " "the" " " "Web" " " "User" " " "Interface" " " "(you" " " "find" " " "it" " " "in" " " "the" " " "menu" " " (@L (@H "&ldquo;") "Lists" (@H "&rdquo;")) ").") (li (strong "Solution" " " "2:") " " "There" " " "is" " " "an" " " (a (@ (href . "00001012080500")) "API") " " "call" " " "to" " " "make" " " "Zettelstore" " " "aware" " " "of" " " "this" " " "change.") (li (strong "Solution" " " "3:") " " "If" " " "you" " " "have" " " "an" " " "enabled" " " (a (@ (href . "00001004100000")) "Administrator" " " "Console") " " "you" " " "can" " " "use" " " "the" " " "command" " " (a (@ (href . "00001004101000#refresh")) (kbd "refresh")) " " "to" " " "make" " " "your" " " "changes" " " "visible.") (li (strong "Solution" " " "4:") " " "You" " " "configure" " " "the" " " "zettel" " " "box" " " "as" " " (a (@ (href . "00001004011400")) (@L (@H "&ldquo;") "simple" (@H "&rdquo;"))) ".")))) (h2 (@ (id . "html-content-is-not-shown")) "HTML" " " "content" " " "is" " " "not" " " "shown") (ul (li (p (strong "Problem:") " " "You" " " "have" " " "entered" " " "some" " " "HTML" " " "code" " " "as" " " "content" " " "for" " " "your" " " "Zettelstore," " " "but" " " "this" " " "content" " " "is" " " "not" " " "shown" " " "on" " " "the" " " "Web" " " "User" " " "Interface.") (p "You" " " "may" " " "have" " " "entered" " " "a" " " "Zettel" " " "with" " " "syntax" " " (a (@ (href . "00001008000000#html")) (@L (@H "&ldquo;") "html" (@H "&rdquo;"))) "," " " "or" " " "you" " " "have" " " "used" " " "an" " " (a (@ (href . "00001007031200")) "inline-zettel" " " "block") " " "with" " " "syntax" " " (@L (@H "&ldquo;") "html" (@H "&rdquo;")) "," " " "or" " " "you" " " "entered" " " "a" " " "Zettel" " " "with" " " "syntax" " " (a (@ (href . "00001008000000#markdown")) (@L (@H "&ldquo;") "markdown" (@H "&rdquo;"))) " " "(or" " " (@L (@H "&ldquo;") "md" (@H "&rdquo;")) ")" " " "and" " " "used" " " "some" " " "HTML" " " "code" " " "fragments.") (ul (li (p (strong "Explanation:") " " "Working" " " "with" " " "HTML" " " "code" " " "from" " " "unknown" " " "sources" " " "may" " " "lead" " " "so" " " "severe" " " "security" " " "problems." " " "The" " " "HTML" " " "code" " " "may" " " "force" " " "web" " " "browsers" " " "to" " " "load" " " "more" " " "content" " " "from" " " "external" " " "server," " " "it" " " "may" " " "contain" " " "malicious" " " "JavaScript" " " "code," " " "it" " " "may" " " "reference" " " "to" " " "CSS" " " "artifacts" " " "that" " " "itself" " " "load" " " "from" " " "external" " " "servers" " " "and" " " "may" " " "contains" " " "malicious" " " "software." " " "Zettelstore" " " "tries" " " "to" " " "do" " " "its" " " "best" " " "to" " " "ignore" " " "problematic" " " "HTML" " " "code," " " "but" " " "it" " " "may" " " "fail." " " "Either" " " "because" " " "of" " " "unknown" " " "bugs" " " "or" " " "because" " " "of" " " "yet" " " "unknown" " " "changes" " " "in" " " "the" " " "future.") (p "Zettelstore" " " "sets" " " "a" " " "restrictive" " " (a (@ (class . "external") (href . "https://www.w3.org/TR/CSP/")) "Content" " " "Security" " " "Policy") "," " " "but" " " "this" " " "depends" " " "on" " " "web" " " "browsers" " " "to" " " "implement" " " "them" " " "correctly" " " "and" " " "on" " " "users" " " "to" " " "not" " " "disable" " " "it." " " "Zettelstore" " " "will" " " "not" " " "display" " " "any" " " "HTML" " " "code," " " "which" " " "contains" " " "a" " " (code "<script>>") " " "or" " " "an" " " (code "<iframe>") " " "tag." " " "But" " " "attackers" " " "may" " " "find" " " "other" " " "ways" " " "to" " " "deploy" " " "their" " " "malicious" " " "code.") (p "Therefore," " " "Zettelstore" " " "disallows" " " "any" " " "HTML" " " "content" " " "as" " " "a" " " "default." " " "If" " " "you" " " "know" " " "what" " " "you" " " "are" " " "doing," " " "e.g." " " "because" " " "you" " " "will" " " "never" " " "copy" " " "HTML" " " "code" " " "you" " " "do" " " "not" " " "understand," " " "you" " " "can" " " "relax" " " "this" " " "default.")) (li (p (strong "Solution" " " "1:") " " "If" " " "you" " " "want" " " "zettel" " " "with" " " "syntax" " " (@L (@H "&ldquo;") "html" (@H "&rdquo;")) " " "not" " " "to" " " "be" " " "ignored," " " "you" " " "set" " " "the" " " "startup" " " "configuration" " " "key" " " (a (@ (href . "00001004010000#insecure-html")) (kbd "insecure-html")) " " "to" " " "the" " " "value" " " (@L (@H "&ldquo;") "html" (@H "&rdquo;")) ".")) (li (p (strong "Solution" " " "2:") " " "If" " " "you" " " "want" " " "zettel" " " "with" " " "syntax" " " (@L (@H "&ldquo;") "html" (@H "&rdquo;")) " " "not" " " "to" " " "be" " " "ignored," " " (strong "and") " " "want" " " "to" " " "allow" " " "HTML" " " "in" " " "Markdown," " " "you" " " "set" " " "the" " " "startup" " " "configuration" " " "key" " " (a (@ (href . "00001004010000#insecure-html")) (kbd "insecure-html")) " " "to" " " "the" " " "value" " " (@L (@H "&ldquo;") "markdown" (@H "&rdquo;")) ".")) (li (p (strong "Solution" " " "3:") " " "If" " " "you" " " "want" " " "zettel" " " "with" " " "syntax" " " (@L (@H "&ldquo;") "html" (@H "&rdquo;")) " " "not" " " "to" " " "be" " " "ignored," " " (strong "and") " " "want" " " "to" " " "allow" " " "HTML" " " "in" " " "Markdown," " " (strong "and") " " "want" " " "to" " " "use" " " "HTML" " " "code" " " "within" " " "Zettelmarkup," " " "you" " " "set" " " "the" " " "startup" " " "configuration" " " "key" " " (a (@ (href . "00001004010000#insecure-html")) (kbd "insecure-html")) " " "to" " " "the" " " "value" " " (@L (@H "&ldquo;") "zettelmarkup" (@H "&rdquo;")) "."))))))