This version is out of date, covering development from v8.0.0 to v8.x.x. 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 v8 Icon

^descendants( [template][,N] )^


Code Type: 

Code Scope of Action: 

Code First Added: 

Code Altered: 

 Data Include   [other codes of this type]

 item   [codes with similar scope]

 Baseline

 format"


^descendants^

Tells Tinderbox to include the descendants of the current note (or agent) in the current web page using their default template file.

^descendants( template )^

Tells Tinderbox to include the descendants of the current note (or agent) in the current Web page using the specified template file.

^descendants( template,N )^

Tells Tinderbox to include only the first N descendants of the current note (or agent) with the specified template file. If N is used without a template, a comma must be placed before N. In finding N matches, the first branch is to its tip, then all siblings then recursing up branch #1's sub-branches before starting branch #2.

To export immediate children but not the children's descendants, see ^children( template )^. This replaces the old usage of ^children^.

^descendants^ evaluates its template argument, allowing agents and containers to use expressions like

^descendants(^value($MyTemplate)^)^

The HTMLDontExport settings of children are respected.