The Tree of Widsdom

智慧の樹

Tutorial: How to export a POST


A POST is a piece of writing that is dated and contained inside a category. A POST is compiled during export—the title and text of its descendants are appended to it according to their outline order.

Click on the Blog POSTS tab in your Content Window. Find the demo category named [Sample Category]. The fact that it is in square brackets means that it is a demo note that you can delete.

Click the triangle to the left of [Sample Category] to see its children. Notice that its export badge is a down-arrow. This means that its children will export but it will not. Consequently, if you export now, this note will be invisible to users of your website. This is intentional—the children are accessed by links and frames on the MapSelf website for demo purposes.

But now we want it to export—and thereby appear in your Categories Sidebar and Categories webpage. So after you delete the brackets, select it and run the stamp so that it becomes a green disk (meaning that both self and children are set to export).

This category will now appear on your Categories page and right sidebar.
This category will now appear on your Categories page and right sidebar.

Now hoist your Outline View to the level of the Sample Category container note by double-clicking on its document-shaped note icon:

Hoisted so that the post container note is on top.
Hoisted so that the post container note is on top.

To expand the sub-posts and sub-sub-posts inside a container, we should option-click on the triangle to the left of it. But this only works when the container is already collapsed, so click and then option-click on the triangle to the left of Sample Category.

Option-click an <i>already collapsed</i> triangle to reveal descendants all the way down.
Option-click an already collapsed triangle to reveal descendants all the way down.

Now, to preview the export of your post, click the Preview Tab in the Text Pane Selector:

A little preview of your exported webpage.
A little preview of your exported webpage.

You can see that the heading backgrounds are colored according to your Colors Dash settings. You can toggle these by unchecking the checkbox on the Colors: ON/OFF widget.

To get a fuller view, pull out the left edge of the window a bit and then hit ⌘4 to maximize the Text Pane (and thereby the preview):

Widening the window will bring the right sidebar into view.
Widening the window will bring the right sidebar into view.

To have a POST export like a PAGE, so that sub-posts receive their own export, use the NOCOMPILE export option by adding the string NOCOMPILE to the key attribute $blogExpOpt.

To make your own POST:

  1. Make a new note inside of Blog Posts—your first category note. Give it a name.
  2. Make a new note inside the category note you just made—your first post. Give it a name and write it. When you are done, check the tick-box next to $blogReady. ($blogReady is a key attribute. If it’s not visible at the top of the window, run the stamp and it will appear.)
  3. Export your blog by running File > Export > as HTML. Select BoxPressExport as your export folder. Click Export.
  4. Go the the Finder and open index.html, and you will be viewing your new home page!