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: 

 number   [other number-type attributes]


 HTML   [other HTML Group attributes]

 HTML exported file configuration




 Already in v5.0.0


Specifies the maximum number of characters allowed in exported filenames (default is 24).

Originally, in early versions the default was 8 and is not updated by opening the TBX in newer versions. For TBXs with the old default is can be useful to set a figure greater than 8 to decrease the chance of name clashes amidst exported files.

The maximum value supported is 31 [sic], where this is the total of HTMLFileNameMaxLength, the period and the length of $HTMLExportExtension; e.g "myname" + "." + "html". As the latter defaults to '.html' - 5 characters, the maximum possible length is 26 characters. Using a 4 character length extension like '.htm' will raise the effective limit to 27 characters.

It appears Tinderbox (as at v5.0.0) was still using old pre-OS 10 filename limits - since changed (see below). This should allow 32 characters, but using 27+'.html' results in pages with a 'h#0' extension that are effectively unusable as web pages. Using 28 or greater results in no export at all.

The default value is 24. Note that the default for $HTMLFilenameLowerCase also changes to false. In older TBXs created with the original default value, if you try a ';' reset of the value, it sets the old default of 8.

From v5.9.2, the maximum supported length - including the extension - increased to 128 characters. Previously, setting the value to 28 or more results in a silent failure with no export occurring and no warning to the user. Given the later it is not clear whether the 'legacy' limit of 31 is deliberate or whether something else in the app's export system can't cope with long filenames.

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

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