This version is out of date, covering development from v9.5.0 to v9.7.3. 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 v9 Icon

Exported files and changes to file naming

From v9.5.0, Tinderbox relaxes historic constraints on exported file names. The default replacement character in export file names, $HTMLExportFileNameSpacer, becomes a space " " character rather than an underscore (_) character.

The default value of $HTMLFileNameMaxLength becomes 100 characters, up from 8 characters in Tinderbox v1 and 24 characters in v3.0.5.

Experiments with supporting more punctuation characters showed that between restrictions for OS filenames, URIs, URLs, web servers, browsers, etc., there is no clear rule for what is punctuation that is is safe to use when exporting a Tinderbox note title as a filename. For instance, a colon is allowed in a URL, but not in a macOS filename. Thus, allowing punctuation characters other than a forward slash period and tilde (/.~) are allowed in export filenames proved to cause problems at OS and web level.

Punctuation—with the exception of "-" (hyphen) and "_" (underscore)—is replaced with $HTMLExportFileNameSpacer. Runs of punctuation characters are reduced to a single occurrence of $HTMLExportFileNameSpacer. If the filename begins or ends with punctuation, the punctuation is ignored.

Effect of changes on pre-existing Tinderbox documents export

Note that these changes to attribute default do not affect setting is pre-existing documents, where the new values must be set manually is so desired.