Tinderbox v8 Icon

^include( item|group[, template] )^

Code Type: 

Code Scope of Action: 

Code First Added: 

Code Altered: 

 Data Include   [other codes of this type]

 group   [codes with similar scope]



^include( item|group )^

Includes a single item or group notes, using their default template(s), in the web page for the current note. The scope may also be set from an attribute holding a list of paths or a function returning such a list.

^include( item|group, template )^

Includes the item or group using the specified export template rather than each note(s)' default export template. for instance is a note is set to export a complete page, the default would be inappropriate where the note's output is to be used embedded in another page. In the later case, it is necessary to specify a template that simply returns inline content markup.

IMPORTANT: Tinderbox will not generate HTML links for internal links that point to notes that are only exported via the ^include method; consider linking to the note's (export) parent note instead.


A quoted string literal can be used with either a single item or a group (list):

^include("a note")^ 

^include("a note;another note")^ 

For simple expressions such as string concatenations, which are actually considered expressions, an additional ^value()^ wrapper is needed:

^include(^value("Some"+" note")^)^ --> include note "Some note"

If a stored attribute value is used, group assignments must be enclosed in a ^value()^ code whereas they are not needed for item assignments:


^include($MyString("Some note"))^ 


^include(^value($MyList("Another note"))^)^ 

Expressions must take a ^value()^ wrapper. The most common use with an expression is a find():

^include(^value(find(inside(Some note)))^)^ 


The optional second argument specifies the export template to use when including is evaluated. This permits parameterised constructions like the following:


A Tinderbox Reference File : Export Codes : Export Codes - Full Listing : ^include( item|group[, template] )^