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

Referencing root-level items

Generally, when referring to a given item (note/container/agent/adornment), it suffices to simply use the item's name. So, for a container called "Examples", the following work as long as the item is note at root level:

inside("Examples") 

$MyString=$MyString("Examples") 

If more than one item matches "Examples" then the first such match, by $OutlineOrder, will be used. However, if we want to match an item a root-level it is necessary to insert a single forward slash before the item name:

inside("/Examples") 

$MyString=$MyString("/Examples") 

Another way to remember this 'rule' is:

This limitation doesn't apply when searching based on the string value if item's title. These work for either root level or below it:

$Name=="Examples" 

if($Name=="Examples"){… 

$Name.contains("Examples") 

More on paths in Tinderbox.


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


A Tinderbox Reference File : Agent Queries : Referencing root-level items