(((meta (@ (content . "Zettelmarkup: Query Transclusion") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #search #zettelmarkup #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001007031100") (name . "back"))) (meta (@ (content . "00001006020000 00001007031100 00001012051400") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20220809132350") (name . "created"))) (meta (@ (content . "00001006020000 00001006034000 00001006035500 00001007040310 00001007700000 00001012051400") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20240219161800") (name . "modified"))) (meta (@ (content . "20240219161800") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "A" " " "query" " " "transclusion" " " "is" " " "specified" " " "by" " " "the" " " "following" " " "sequence," " " "starting" " " "at" " " "the" " " "first" " " "position" " " "in" " " "a" " " "line:" " " (kbd "{{{query:query-expression}}}") "." " " "The" " " "line" " " "must" " " "literally" " " "start" " " "with" " " "the" " " "sequence" " " (kbd "{{{query:") "." " " "Everything" " " "after" " " "this" " " "prefix" " " "is" " " "interpreted" " " "as" " " "a" " " (a (@ (href . "00001007700000")) "query" " " "expression") ".") (p "When" " " "evaluated," " " "the" " " "query" " " "expression" " " "is" " " "evaluated," " " "often" " " "resulting" " " "in" " " "a" " " "list" " " "of" " " (a (@ (href . "00001007040310")) "links") " " "to" " " "zettel," " " "matching" " " "the" " " "query" " " "expression." " " "The" " " "result" " " "replaces" " " "the" " " "query" " " "transclusion" " " "element.") (p "For" " " "example," " " "to" " " "include" " " "the" " " "list" " " "of" " " "all" " " "zettel" " " "with" " " "the" " " (a (@ (href . "00001006020000#tags")) "tags") " " (@L (@H "&ldquo;") "#search" (@H "&rdquo;")) "," " " "ordered" " " "by" " " "title" " " "specify" " " "the" " " "following" " " "query" " " "transclude" " " "element:") (pre (code (@ (class . "language-zmk")) "{{{query:tags:#search ORDER title}}}")) (p "This" " " "will" " " "result" " " "in:") (div (@ (class . "example")) (@@ "transclude" QUERY "->" "tags:#search ORDER title")) (p "For" " " "example," " " "this" " " "allows" " " "to" " " "create" " " "a" " " "dynamic" " " "list" " " "of" " " "zettel" " " "inside" " " "a" " " "zettel," " " "maybe" " " "to" " " "provide" " " "some" " " "introductory" " " "text" " " "followed" " " "by" " " "a" " " "list" " " "of" " " "child" " " "zettel.") (p "The" " " "query" " " "will" " " "deliver" " " "only" " " "those" " " "zettel," " " "which" " " "the" " " "current" " " "user" " " "is" " " "allowed" " " "to" " " "read.") (p "In" " " "the" " " "above" " " "example," " " "the" " " "action" " " "list" " " "is" " " "empty." " " "This" " " "leads" " " "to" " " "the" " " "described" " " "list" " " "of" " " "zettel.") (p "The" " " "following" " " "actions" " " "are" " " "supported," " " "parameter" " " "and" " " "aggregate" " " "actions:") (dl (dt (kbd "N") " " "(or" " " "any" " " "word" " " "that" " " "starts" " " "with" " " (@L (@H "&ldquo;") (kbd "N") (@H "&rdquo;")) " " "(parameter)") (dd (p "The" " " "resulting" " " "list" " " "will" " " "be" " " "a" " " "numbered" " " "list.")) (dt (kbd "MINn") " " "(parameter)") (dd (p "Emit" " " "only" " " "those" " " "values" " " "with" " " "at" " " "least" " " (em "n") " " "aggregated" " " "values." " " (em "n") " " "must" " " "be" " " "a" " " "positive" " " "integer," " " (kbd "MIN") " " "must" " " "be" " " "given" " " "in" " " "upper-case" " " "letters.")) (dt (kbd "MAXn") " " "(parameter)") (dd (p "Emit" " " "only" " " "those" " " "values" " " "with" " " "at" " " "most" " " (em "n") " " "aggregated" " " "values." " " (em "n") " " "must" " " "be" " " "a" " " "positive" " " "integer," " " (kbd "MAX") " " "must" " " "be" " " "given" " " "in" " " "upper-case" " " "letters.")) (dt (kbd "TITLE") " " "(parameter)") (dd (p "All" " " "words" " " "following" " " (kbd "TITLE") " " "are" " " "joined" " " "together" " " "to" " " "form" " " "a" " " "title." " " "It" " " "is" " " "used" " " "for" " " "the" " " (kbd "ATOM") " " "and" " " (kbd "RSS") " " "action.")) (dt (kbd "ATOM") " " "(aggregate)") (dd (p "Transform" " " "the" " " "zettel" " " "list" " " "into" " " "an" " " (a (@ (class . "external") (href . "https://www.rfc-editor.org/rfc/rfc4287")) "Atom" " " "1.0") "-conformant" " " "document" " " "/" " " "feed." " " "The" " " "document" " " "is" " " "embedded" " " "into" " " "the" " " "referencing" " " "zettel.")) (dt (kbd "RSS") " " "(aggregate)") (dd (p "Transform" " " "the" " " "zettel" " " "list" " " "into" " " "a" " " (a (@ (class . "external") (href . "https://www.rssboard.org/rss-specification")) "RSS" " " "2.0") "-conformant" " " "document" " " "/" " " "feed." " " "The" " " "document" " " "is" " " "embedded" " " "into" " " "the" " " "referencing" " " "zettel.")) (dt (kbd "KEYS") " " "(aggregate)") (dd (p "Emit" " " "a" " " "list" " " "of" " " "all" " " "metadata" " " "keys," " " "together" " " "with" " " "the" " " "number" " " "of" " " "zettel" " " "having" " " "the" " " "key.")) (dt (kbd "REDIRECT") "," " " (kbd "REINDEX") " " "(aggregate)") (dd (p "Will" " " "be" " " "ignored." " " "These" " " "actions" " " "may" " " "have" " " "been" " " "copied" " " "from" " " "an" " " "existing" " " (a (@ (href . "00001012051400")) "API" " " "query" " " "call") " " "(or" " " "from" " " "a" " " "WebUI" " " "query)," " " "but" " " "are" " " "here" " " "superfluous" " " "(and" " " "possibly" " " "harmful).")) (dt "Any" " " (a (@ (href . "00001006020000")) "metadata" " " "key") " " "of" " " "type" " " (a (@ (href . "00001006035500")) "Word") " " "or" " " "of" " " "type" " " (a (@ (href . "00001006034000")) "TagSet") " " "(aggregates)") (dd (p "Emit" " " "an" " " "aggregate" " " "of" " " "the" " " "given" " " "metadata" " " "key." " " "The" " " "key" " " "can" " " "be" " " "given" " " "in" " " "any" " " "letter" " " "case" (sup (@ (id . "fnref:1")) (a (@ (class . "zs-noteref") (href . "#fn:1") (role . "doc-noteref")) "1")) "."))) (p "To" " " "allow" " " "some" " " "kind" " " "of" " " "backward" " " "compatibility," " " "an" " " "action" " " "written" " " "in" " " "uppercase" " " "letters" " " "that" " " "leads" " " "to" " " "an" " " "empty" " " "result" " " "list," " " "will" " " "be" " " "ignored." " " "In" " " "this" " " "case" " " "the" " " "list" " " "of" " " "selected" " " "zettel" " " "is" " " "returned.") (p "Example:") (pre (code (@ (class . "language-zmk")) "{{{query:tags:#search | tags}}}")) (p "This" " " "is" " " "a" " " "tag" " " "cloud" " " "of" " " "all" " " "tags" " " "that" " " "are" " " "used" " " "together" " " "with" " " "the" " " "tag" " " "#search:") (div (@ (class . "example")) (@@ "transclude" QUERY "->" "tags:#search | tags")))