"aTbRef" is a reference file to some of Tinderbox's objects and functions; it is written by a longtime user of Tinderbox as a public service. It includes changes from v8.0.0 up to and including v8.9.2b496 (11 Feb 2021). This web resource of circa 1,800 webpages is created from some 2,438 discrete notes and a further 2,308 aliases within the source Tinderbox document. The overall number of notes, agents, adornments and aliases in the document is over 7,000 items. The document contains over 4,000 internal links.
A Change Log section lists significant per-release changes since v8.0.0b360 (12 Apr 2019), that being the baseline version for this re-release of aTbRef. Those users who always update to the current version can generally just ignore the text's references to version numbers (apart from checking the most recent changes) whereas users of older versions can easily see whether their installed version includes certain improvements or not. Some legacy syntax is no longer documented. Those needing to use legacy syntax should refer to older versions of aTbRef. Release dates of versions prior to the current baseline are listed here.
- What's new in v8
- Basic Configuration & Concepts
- User Interface Basics
- Using Tinderbox
- Coding in Tinderbox
- Under The Hood
The HTML pages include a Google search box in the footer. Note that if using a local copy you must be online to use the search; Google will search the online pages—that might possibly be more recent than your own—and the search result links will likewise be to the online pages. If you have downloaded the TBX source, simply use Tinderbox's own Find tool to look for things.
If reading the TBX source file, ignore the UTILS section which contains agents, prototypes, etc., used to create and maintain this file.
Not all Tinderbox users are English speakers so to try and help with that all pages now include an in-page Google Translate feature (below). The feature offers automatic translation of page content into any of the languages supported by the Translate service. Doubtless the translation it is not fluent but it may help non-English speakers get more out of this resource.
By design aTbRef is a document intended to be exported to HTML and the TBX of this file includes the necessary templates to enable that process.
REMARKS AND CAVEATS
This file is supposed to go along with the existing manual & release notes (available via the app's Help menu) as well as the Tinderbox forum. It is therefore incomplete regarding the global Tinderbox culture. Its main aim is to serve as an "on the go" (online) as well as a personal (TBX file) reference to Tinderbox use. Tinderbox's author Mark Bernstein has also written a book, The Tinderbox Way, that discusses some of the design ideas encapsulated in Tinderbox as well as some practical examples as to usage.
If you are using the source TBX file version of aTbRef, bear in mind nearly all of the caret (^) symbols will be written doubled in order that they do not get interpreted as export codes when outputting the HTML pages. A further benefit from using—or just viewing—the source TBX is that is contains all the export templates needed to produce this site and which can be instructive if learning the HTML export aspects of Tinderbox.
This file is shared "as is", the author will not be held responsible for its content; it may be used/republished under a Creative Commons Licence.