The Tree of Widsdom

智慧の樹

TBX structure and exported directory structure

The isomorphism is only partial

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 exported directory structure of your blog.
The exported directory structure of your blog.

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 internal container structure of your TBX file. Note that there are only seven notes at root level.
The internal container structure of your TBX file. Note that there are only seven notes at root level.

The relation between the two can be neatly displayed in a table:

Table of correspondences
BoxPress noteExported file
BlogTopNoteindex.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
Blog404404.html
BlogHome[children included as teasers on home-page]
BlogArchivesArchives.html
BlogCategoriesCategories.html
CSSthe css folder
blog-mainblog-main.css
blog-extrablog-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.

  1. 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.)
  2. 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.
  3. The Prototypes container is now here in order to comply with the new automatic prototype generation in TinderboxSix. All your prototypes are here.
  4. 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.
  5. The UTILITY container note will not be exported. It contains agents, prototypes, code, and technical extras for your whole TBX.
  6. 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.
  7. 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
BlogTopNote and its contents. Never change these notes’ actual $Name. To set the name of BlogTopNote, use the Styles Dash. To set the name of BlogAboutNote, change its $DisplayExpression.
BlogTopNote and its contents. Never change these notes’ actual $Name. To set the name of BlogTopNote, use the Styles Dash. To set the name of BlogAboutNote, change its $DisplayExpression.

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

BlogTopNote → index.html and index/

Blog POSTS → Posts/

Blog PAGES → Pages.html and Pages/

BlogNavBar [diverted to navbar]

BlogAboutNote → About.html

Blog404 → 404.html

BlogHome [included in index.html]

BlogArchives → Archives.html

BlogCategories → Categories.html

TEMPLATES

BOILERPLATE

BoxPress special webpages

Important
The names of the BoxPress special webpages should never be changed. Their names are odd in order to keep them unique, for the sake of reference. Do not use these odd names for any of your own notes.

The Home webpage

The Pages webpage

The About webpage

The 404 webpage

The Archives webpage

The Categories webpage

Ordinary content webpages