Tinderbox supplies a number of 'designator' terms, use of which instead of a note's $Name or path which may infer an individual note, or in a few cases a group of notes. Item designators are generally hierarchical in their references.
There are also separate series of designators designed to help date creation/calculation and the polarity of links.
Most item and group designators can use paths to refer to data from a different note from the current context. This makes them even more flexible in use - the section on paths for more detail.
Designators are generally used with attribute value references ($Name(parent)
), as action or export code parameters (linkTo(grandparent)
, linkFrom(grandparent(original))
). In some cases cases they are specific to certain operators, as with links() and the link direction designators.
Designators ignore map adornments.
In action code, designators used as path proxies - e.g. $Name(parent) - may safely be quoted. Historically, path arguments weren't quoted but in v5 there has been a move to explicitly quoting all string values.
Designators are listed via their scope: