This version is out of date, covering development from v9.0.0 to v9.3.0. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox v9 Icon

^ancestors( [start, list-item-prefix, list-item-suffix, end ])^

Code Type: 

Code Scope of Action: 

Code First Added: 

Code Altered: 

 Creation of Links   [other codes of this type]

 item   [codes with similar scope]



^ancestors([ "start", "list-item-prefix", "list-item-suffix", "end"] )^

returns links to all of the ancestors of this note (if any). Unlike the pre-v.4.6 format of links in a single line, with colons between the elements, this defaults to an HTML unordered list like other list-generating codes.

If the optional start, list-item-prefix, list-item-suffix, end parameters are omitted then the default values of <ul>, <li>, </li>, </ul> are used.

This allows you to format the group of links as an HTML list or table in the exact format you want, where "start" is quote-enclosed text that will be inserted before all of the links, "end" is text that will be inserted after all of the links, "list-item-prefix" is text that will be inserted before each link, and "list-item-suffix" is text that will be inserted after each link. See more on altering list type or other HTML output.

If "Hierarchical lists" in the HTML pane of the preferences is unchecked, this will not work.

Mark-up (export code) elements embedded in ^ancestors^ are evaluated.

To get the pre-v.4.6 format use:

^ancestors("",""," : ","")^ 

Exported links use the CSS class and target based on their underlying Tinderbox link values, if one is specified; the link type value is not picked up as a class name.

Aliases export as discrete notes (if the alias' container is set to ExportChildren) with content of the original but was any contextual hierarchical inks appropriate to the aliases' location. The ^ancestors^ for an alias also export as the ancestors of the alias, not the ancestors of the source note.

Any ancestor set to $HTMLDontExport=true is skipped.

Item objects source and destination may be used in expressions to indicate from where data used within the expression's arguments is drawn.

The export is relative to current rather than this, facilitating work with included files.

A Tinderbox Reference File : Export Codes : Export Codes - Full Listing : ^ancestors( [start, list-item-prefix, list-item-suffix, end ])^