This version is out of date, covering development from v5.0.0 to v5.12.2. It is maintained here only for inbound reference links from elsewhere.

Jump to the current version of aTbRef.

Tinderbox Icon


Attribute Data Type: 

Attribute Default Value: 

Attribute Group: 

Attribute Purpose: 

Attribute Inherited from Preferences?   

Attribute Read-Only? 

Attribute Intrinsic? 

Attribute First Added: 

Attribute Altered: 

 boolean   [other boolean-type attributes]


 HTML   [other HTML Group attributes]

 HTML export scope




 Already in v5.0.0


An attribute controlling export of the current note's children.

The interpretation of $HTMLDontExport and $HTMLExportChildren has been simplified. These attributes are most often controlled in the HTML View, through the check-box items Export and Export Children.

If Export As Page is checked, Tinderbox will create an HTML file for the note. If it is not checked, no file will be created. The note's contents might appear on another HTML page, of course, by being ^include^-d by name or as one of another node's ^descendants^.

If Export Children is checked, Tinderbox will attempt to export the node's children (if any). Each child, of course, may have an Export As Page attribute.

Both Export Children and Export as Page are consulted when exporting, and the two settings are completely independent. We can export a page but not its children; we can export the children but not export any HTML for a note, or we can create both an HTML page and a directory of child pages.

Remember that if this attribute is false, Tinderbox never even examines the child notes when exporting to HTML. So individual child notes may have $HTMLDontExport set either true or false, and will not be exported in either case.

The easiest way to set this attribute is with the "Export children as pages" checkbox on the HTML view window for the note.

Some existing Tinderbox documents might generate some extra files or directories, because these settings formerly interacted in a complex way. The new rules are much simpler to understand, and are much more consistent.

Tinderbox doesn't create links to notes where any ancestor has $HTMLExportChildren set to false. The same holds for creating links to notes whose $HTMLDontExport value is false.

Possible relevant notes (via "Similar Notes" feature):

A Tinderbox Reference File : Attributes : System Attribute List : HTMLExportChildren