((META (EMPTY-STRING title "Encoding of Sz Reference Values") (WORD role "manual") (TAG-SET tags ("#api" "#manual" "#reference" "#zettelstore")) (WORD syntax "zmk") (ZID-SET back ("00001012931400")) (ZID-SET backward ("00001012931400" "00001012931600")) (NUMBER box-number "1") (STRING copyright "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (TIMESTAMP created "20230405123046") (ZID-SET forward ("00001012931600")) (WORD lang "en") (EMPTY-STRING license "EUPL-1.2-or-later") (TIMESTAMP modified "20240122094720") (TIMESTAMP published "20240122094720") (WORD visibility "public")) (BLOCK (PARA (TEXT "A reference is encoded as the actual reference value, and a symbol describing the state of that actual reference value.")) (REGION-BLOCK (("" . "syntax")) ((PARA (FORMAT-EMPH () (TEXT "Reference")) (TEXT " ") (FORMAT-STRONG () (TEXT "=")) (TEXT " ") (LITERAL-INPUT () "(") (TEXT " ") (FORMAT-EMPH () (TEXT "ReferenceState")) (TEXT " String ") (LITERAL-INPUT () ")") (TEXT ".")))) (PARA (TEXT "The string contains the actual reference value.")) (REGION-BLOCK (("" . "syntax")) ((PARA (FORMAT-EMPH () (TEXT "ReferenceState")) (TEXT " ") (FORMAT-STRONG () (TEXT "=")) (TEXT " ") (LITERAL-INPUT () "INVALID") (TEXT " ") (FORMAT-STRONG () (TEXT "|")) (TEXT " ") (LITERAL-INPUT () "ZETTEL") (TEXT " ") (FORMAT-STRONG () (TEXT "|")) (TEXT " ") (LITERAL-INPUT () "SELF") (TEXT " ") (FORMAT-STRONG () (TEXT "|")) (TEXT " ") (LITERAL-INPUT () "FOUND") (TEXT " ") (FORMAT-STRONG () (TEXT "|")) (TEXT " ") (LITERAL-INPUT () "BROKEN") (TEXT " ") (FORMAT-STRONG () (TEXT "|")) (TEXT " ") (LITERAL-INPUT () "HOSTED") (TEXT " ") (FORMAT-STRONG () (TEXT "|")) (TEXT " ") (LITERAL-INPUT () "BASED") (TEXT " ") (FORMAT-STRONG () (TEXT "|")) (TEXT " ") (LITERAL-INPUT () "QUERY") (TEXT " ") (FORMAT-STRONG () (TEXT "|")) (TEXT " ") (LITERAL-INPUT () "EXTERNAL") (TEXT ".")))) (PARA (TEXT "The meaning of the state symbols corresponds to that of the symbols used for the description of ") (LINK-ZETTEL () "00001012931600#link" (TEXT "link references")) (TEXT ".")) (DESCRIPTION ((LITERAL-INPUT () "INVALID")) (BLOCK (BLOCK (PARA (TEXT "The reference value is invalid.")))) ((LITERAL-INPUT () "ZETTEL")) (BLOCK (BLOCK (PARA (TEXT "The reference value is a reference to a zettel.") (SOFT) (TEXT "This value is only possible before evaluating the zettel.")))) ((LITERAL-INPUT () "SELF")) (BLOCK (BLOCK (PARA (TEXT "The reference value is a reference to the same zettel, to a specific mark.")))) ((LITERAL-INPUT () "FOUND")) (BLOCK (BLOCK (PARA (TEXT "The reference value is a valid reference to an existing zettel.") (SOFT) (TEXT "This value is only possible after evaluating the zettel.")))) ((LITERAL-INPUT () "BROKEN")) (BLOCK (BLOCK (PARA (TEXT "The reference value is a valid reference to an missing zettel.") (SOFT) (TEXT "This value is only possible after evaluating the zettel.")))) ((LITERAL-INPUT () "HOSTED")) (BLOCK (BLOCK (PARA (TEXT "The reference value starts with one slash character, denoting an absolute local reference.")))) ((LITERAL-INPUT () "BASED")) (BLOCK (BLOCK (PARA (TEXT "The reference value starts with two slash characters, denoting a local reference interpreted relative to the Zettelstore base URL.")))) ((LITERAL-INPUT () "QUERY")) (BLOCK (BLOCK (PARA (TEXT "The reference value contains a query expression.")))) ((LITERAL-INPUT () "EXTERNAL")) (BLOCK (BLOCK (PARA (TEXT "The reference value contains a full URL, referencing a resource outside of the Zettelstore server.")))))))