BoxPress Construction and Quick Start


Writing is input in one of two main ready-made sections. One is for continuous writings that you collect inside containers, which are presented in the (optional) Sidebar. These side-bar containers are called Categories by default, but this is easily replaced (it is the $bpNavName of your @Categories agent). These are called POSTS. Their child granularity is continuous—that is, they are seamlessly integrated. An expanded view of your Categories (or whatever you name it when making, say, your TinderPoint Presentation).

The other is for modular writing projects, where children appear as SmartButtons beneath the body text. These are called PAGES. All PAGES are collected in a built-in webpage called Pages, which is included in the NavBar.


A SmartButton is the BoxPress alternative to the traditional link. A SmartButton is a button that changes its appearance according to the child note’s prototype and attributes.

The typical way of listing subsequent sections of a webpage is to place a list of links at the bottom. But Tinderbox is Tinderbox—a world wherein notes are structs of variables that can be weblinks, dates, images, links to other notes, and anything else that can be tied to a variable (i.e., anything).

Granularity Options

Both POSTs and PAGEs include an optional Table of Contents key attribute ($blogTOC) that takes a number for its argument. It is set to zero, but you can change it—per prototype or per note.

POSTS compile seamlessly and PAGES are granular by default. But this is easily changed via popup menu. Simply click on the $blogExpOpt line in your Key Attributes table and make your choice:

  • Select NOCOMPILE for SmartButtons
  • Select COMPILE for seamless collation.

Actually, $blogExpOpt also contains many other export options—28 in all.

$blogExpOpt is a set type attribute. Yes, it’s really true. Export options can be combined. For example, to export the children as numbered buttons inside the POST domain, which is seamless by default, you would use NOCOMPILE and NUM.

In fact, seamless collation and SmartButtons are only two of six granularity options:

  •  COMPILE — Includes children in seamless compilation; if NUM is added, with decimal-justified numbering. Headings are set in Styles Dash.
  •  BLOCKS — Seamless inclusion of children, but with borders and modified headings and image-placement layout.
  •  COLUMNS — Includes children as columns.
  •  TABLE — Includes children as table rows.
  •  NOCOMPILE — Includes children as SmartButtons.

Export Options

Now that you understand the notion of export option, I can mention that there are other types of export option besides Granularity. There are seven types in total:

Routing options—Divert or conceal the note as a whole in its various incarnations. E.g., make a bonafide footnote note, or omit the note from the Table of Contents, or omit the image in its SmartButton.

Width options—Maximize Text Area width or spotlight your Imagemap.

Navbar options—Create dropdowns, separators, download buttons, and bookmark links.

Page element options—Toggle title, date, featured image, Table of Contents, Buttontops, and incoming Basic Links.

Child inclusion and suppression—Suppress all children, or force their export as SmartButtons (i.e., even when they’ve already exported as subsections).

Granularity options—Append children as seamless, bounded, auto-balanced columns, table rows, or SmartButtons.

Export numbering—Numbering the children.

Popup Options

Those are the export options. But BoxPress includes other Key Attribute popup menus as well:

  •  Background options — Let you set every aspect of the webpage background.
  •  Frame options — Let you add, remove, and modify webpage’s Frame amenities. Frame amenities are the navigational and decorative elements on the perimeter of the webpage. Toggling these elements will determine what kind of hypermedia machine you are exporting. For example, a TinderPoint Presentation would do well to remove the Banner, Sidebar, and Footer from all non-special pages. While an academic essay should do without all frame amenities.
  •  Undertitle options — BoxPress comes with six readymade Research Prototypes: person_note, article_note, book_note, quote_note, quote_ana_note, and event_note. Exporting a research note will add a convenient Undertitle to all Webpages, Subsections, and SmartPanels. This Undertitle is composed of key attributes, such as $Author, $blogDirector, $Journal, and very advanced SmartDate information. These can be added and subtracted via the $blogUnderOpt popup menu.

Welcome: Here is your path

Now you have a taste of how things work. For more information, visit the following:

  • To unzip and export the empty skeleton (and a few demo notes) visit BoxPress Setup. Look at the two containers with the green arrows: LinkMap: Protos Wild and MapMaker: Prototypes_wild. Do you see how the former uses the map information contained in the latter? It is by setting two attributes.
  • To see what you can do by way of a dissection of the exported webpage, visit BoxPress: Dissection of Powers.
  • For a list of Agents, Stamps, Macros, Popup options, User Templates, Teaser Settings, Exploiting Rich Text, Date Formats, and Display Expression code, visit BoxPress Reference.
  • For an index of Agents, Display Expressions, Export Options, Frame Options, Macros, Prototypes, Stamps, and User Templates, visit BoxPress Indices.
  • For BoxPress videos and tutorials, visit BoxPress Videos and Tutorials.
  • So see samples of the various Popup Options, Macros, and Prototype export schemes, visit PAGE Export Samples.
  • To experience using Tinderbox Map Views as an HTML Imagemap, visit ye olde LinkMap and FillMap Samples.