All the templates used to export this file to HTML are stored in the aTbRef TBX file inside the top level container called "TEMPLATES".
Original HTML4 templates
Originally, the site exported all content via 4 templates:
- basic: the default & used for most pages.
- basic_grabs: for pages with portrait oriented images.
- basic_menu_bars: originally for menubars and then all pages with landscape oriented images.
- basic_change: only used for change log agent pages.
In turn these used/included:
- basic_child_item: used for the Basic Comparison Operator listings and some deprecated listings.
- basic_item_attribute: used for a Displayed Attribute like table for notes about attributes.
- basic_item_code: used for a Displayed Attribute like table for notes about action codes.
- basic_item_operator: used for a Displayed Attribute like table for notes about action codes.
- change_item: used for change log items.
The HTML sitemap uses:
- sitemap: the 'envelope'.
- sitemap_titles: the iterating 'letter' template.
The XML sitemap uses:
- xml_sitemap: the 'envelope'.
- xml_sitemap_item: the iterating 'letter' template.
The Atom feed uses:
- news_atom: the 'envelope'.
- newsitem_atom: the iterating 'letter' template.
The RSS feed uses:
- news_rss: the 'envelope'.
- newsitem_rss: the iterating 'letter' template.
The version checker uses: version-check.
The build-version check uses: version-build-check.
The CSS styles page uses: body_text_only.
The image zipper uses: zipper-images-code.
The TBX zipper uses: zipper-code.
The BOILERPLATE includes all use: body_text_only.
A 'redirect' template is included for later use when the current baseline is superseded, diverting users to what will be the new URL.
A few other basic templates are also included for general test/admin purposes.
HTML5 Templates
In Feb 2013, the templates were updated top use an HTML5 DOCTYPE and to lose all the old tables. The first method duplicated a number of templates and includes (those with a 5 prefix or suffix). As a result of this it became apparent that the 4 main templates could be merged into one, using more conditional compilation. Thus all the main content individual pages are created by: 5-basic_all.
A boolean $WebImageLandscape indicates whether the image should be be placed above/before text, or (for most, portrait oriented, images) are floated right in the main text. As the preferences section uses aliases for the Doc-level preference notes, but needs different screen grabs, $WebImageA holds the alternate image and another conditional is used to figure this out.
Old templates are now marked off with a strike-through in the TBX to help clarify those still in use.
Shortly after the move to HTML5, it was discovered that the ^similarTo^ links did not evaluate correctly when placed in an include. The first 5-basic_all was thus saved as an archive copy (named5-basic_all (changes for similarTo links)) and 5-basic_all was updated to place the ^similarTo^ code back in a main template. As a result the on/off boolean attribute for the old include was moved into the main template: this allows suppression of the similar-to links and a circa 20-fold increase in the time taken to export (useful when testing!).
As it happens, the need for boilerplate includes becomes less with the move to one main template, although it does segment out the code slightly, making it easier to find the right part for re-editing. So, for now most of the includes remain.
The 5-basic_all template contains 4 booleans to turn off features that slow export or require web (WAN) access:
- $UseGoogleTracking. Omits host domain Google Analytics tracking. Needs web access and not pertinent if run locally.
- $UseGoogleTranslate. If false, the template omits the Google Translate widget (top right of page) which loads from the web.
- $UseSimilarTo. If false export is much faster (as explained above).
- $UseGoogleIndexing. If false this omits the Google-based site search which requires web access.