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

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

returns links to all of the ancestors of this note (if any); formatted in a single line, with colons between the elements.

To v2.4.1:

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

From v2.5.0

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

Allows you to format the group of links as an HTML list or table in the exact format you want, where "start" is 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.

Previous to Tinderbox 2.5.0, the arguments to export list elements were enclosed in quotes

^ancestors("<ul>", "<li>", .....

These quotes are now optional and may be omitted, except where the mark-up itself includes characters (e.g. commas) that would confuse the parser.

In Tinderbox 2.5.0, the quotation marks that were formerly mandatory were prohibited: if they appeared, Tinderbox would include them in the mark-up elements.

Tinderbox 3.0.0 now strips quotation marks enclosing arguments, when they occur. Mark-up elements embedded in ^ancestors^ are now evaluated.

From v3.5.0 this code exports CSS class and target based on their underlying Tinderbox link values.

As Tinderbox 3.6 exports aliases in situ, as distinct from their source note (if the alias' container is set to ExportChildren), v3.6.1 ensures ^ancestors^ for an alias now exports the ancestors of the alias, not the ancestors of the source note.

From v4.0.0, any ancestor set to HTMLDontExport=true is skipped.

From v4.0.0, new item objects source and destination may be used to indicate from where data used within the arguments is drawn.

Licensed under Creative Commons Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]