TBX structure and exported directory structure
The exported file structure
Here is what the exported file structure of your BoxPress blog will look like:
BoxPressExport/ css/ fonts/ img/ index/ About/ Pages/ Posts/ 404.html About.html Archives.html Categories.html Pages.html js/ index.html
The TBX note structure
While the corresponding structure inside your BoxPress TBX looks like this:
BlogTopNote Blog PAGES/ Blog POSTS/ BlogNavBar/ BlogAboutNote/ Blog404 BlogHome BlogArchives BlogCategories Dashboard TEMPLATES BOILERPLATE CSS Prototypes Adornments UTILITY ALL_NOTES Simplenote
The relation between the two can be neatly displayed in a table:
BoxPress note | Exported file |
---|---|
BlogTopNote | index.html and the index folder |
Blog PAGES/ | Pages.html and the Pages folder |
Blog POSTS/ | the Posts folder |
BlogNavBar/ | [children included as navbar buttons] |
BlogAboutNote/ | About.html |
Blog404 | 404.html |
BlogHome | [children included as teasers on home-page] |
BlogArchives | Archives.html |
BlogCategories | Categories.html |
CSS | the css folder |
blog-main | blog-main.css |
blog-extra | blog-extra.css |
The seven topmost (root) notes
There are seven topmost notes in your BoxPress TBX root: BlogTopNote, CSS, BOILERPLATE, UTILITY, Prototypes, ALL_NOTES, and Simplenote.
- The BlogTopNote container note will be exported as index.html in the root of your export folder and will serve as your landing or home page. It will be the typical blog front page—i.e., it will display truncated excerpts of the six (or n) most recent posts. Since BlogTopNote contains other notes, it will also export as a folder (named index). The index folder will hold all of your webpages. Note that BlogTopNote will change its display name after you set things up in the Styles Dash. (For a detailed analysis, see below: A closer look inside blogTopNote.)
- The CSS note will export as the css folder (renamed to lowercase) in the root of your export folder. Don’t worry if a folder called css already exists, exporting will merely add to the files already there.
- The Prototypes container is now here in order to comply with the new automatic prototype generation in TinderboxSix. All your prototypes are here.
- The Adornments container gives adornments their own container. Why? Because it takes a ridiculous amount of time for Tinderbox to load prototypes into Map View, and you can only modify adornments in Map View.
- The UTILITY container note will not be exported. It contains agents, prototypes, code, and technical extras for your whole TBX.
- The research/sandbox area in BoxPress is called ALL_NOTES. Inside are massively large categories—projects, to-do lists, yogurt fermentation timelines, my 5 year plan, my inbox, etc. It also contains collections of quotations. Nothing inside the ALL_NOTES container will be exported. It’s a place to put all of your contentful writing. When you write anything, it goes here first. When a note (or note bundle) is ready for exporting, move it inside a category note and check its
$blogReady
attribute. - Finally, there is Simplenote. A note with this name is required if your TBX is to sync with Simplenote, the free mobile writing app. This lets you add notes from your phone so you can graph your workout progress. It’s a great feature so I included it.
The badges you see here automatically update via an agent. These are the only notes whose badges are used up. Because seeing export structure alongside the names here gives you insight into the form of the website.
A closer look inside blogTopNote
The topmost BlogTopNote note contains seven notes and three agents:
BlogTopNote/ Blog PAGES Blog POSTS BlogNAVBAR BlogAboutNote Blog404 BlogHome BlogArchives BlogCategories Dashboard TEMPLATES BOILERPLATE
The notes that are not exported are Blog NAVBAR, @Home, Dashboard, TEMPLATES, and BOILERPLATE.
The other notes do get exported—to produce index.html along with the index folder and its contents:
index Pages/ Posts/ 404.html About.html Archives.html Categories.html Pages.html