This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon

Notes as 'item' objects in action code

The term 'item' is not a Tinderbox definition but is useful in the context of discussing action code and documenting action code usage.

A single note 'item' can be referenced as:

Strings are always quoted, whereas references are not, e.g. "Some note" vs $MyString. The string parts of expressions are quoted as in normal action code.

The overall point is that whether using a string literal value (i.e. just stating a name) or using a code expression, the outcome must evaluate to provide Tinderbox with a reference to a single note.

Complex expressions may require use of parentheses and/or use of eval() to help Tinderbox understand the order of evaluation and to deal with encapsulated evaluations.

If the argument supplied evaluates to a title rather than a path, and the title is not unique across the whole current TBX document, Tinderbox will use just the first of the matching notes as defined by their $OutlineOrder.


Possible relevant notes (via "Similar Notes" feature):


A Tinderbox Reference File : Objects & Concepts : Notes as 'item' objects in action code