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

^children( [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"


^children^

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

^children( template )^

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

^children( template,N )^

Tells Tinderbox to include only the first N immediate children 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.

This replaces the now deprecated ^justChildren( template )^. The original ^children^ function was replaced by ^descendants^.

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

^children(^value($MyTemplate)^)^

The HTMLDontExport settings of children are respected.

IMPORTANT: If you build templates where the exported (HTML) documents where one document includes content from child/other Tinderbox notes, links to the included content from other documents will not get created. Tinderbox is not able to convert those links to #in-page-addresses within the overall target document. The same limitation applies to ^include()^.