The Tree of Widsdom

智慧の樹

Managing all webpage elements

A “vertical index” of style and export control

Table of Contents

What better way to present the BoxPress export options than through a vertical dissection of the typical exported webpage?

Below is a dissection of your exported webpage where controllable sections are listed in their actual vertical order. Lines in [square brackets] are parts that are either (1) optional or (2) can be switched off.

Here is a synopsis to more closely show the schematic intent of the order:

Options that are “prior” to the post
Sidebar Control
Navbar Control
Banner Control
[Title and Subtitle Control]
[Date Control]
[Image Control]
[Audio]
[Table of Contents]
[Text Area]
[Related Links]
[Footer]

Export options that are “prior to” the post

These are export options that determine how the webpage as a whole is exported.

Checkbox
$blogReady

Permits export of this note

Scope:   self

$blogExpOpt
EXPORTALL

Exports all descendants of a topmost container

Scope:   all descendants of Blog POSTS and Blog PAGES

$blogExpOpt
OWNPAGE

Forces note to export as its own webpage

Scope:   self (sub-posts only)

$blogExpOpt
FOOTNOTE

Exports note as footnote

Scope:   self (sub-posts only)

$blogExpOpt
NOTOC

Suppresses note’s inclusion in (ancestor’s) Table of Contents

Scope:   self (as sub-post only)

$blogExpOpt
SKIP

Full suppression (both export and inclusion in Table of Contents)

Scope:   self (sub-posts only)

$blogExpOpt
IMAGEONLY

Suppresses text in teaser

Scope:   self (as teaser)

$blogExpOpt
NOSBIMAGE

Suppresses featured image from SmartButton

Scope:   self

Things that are the same or different for every page

Webpage elements can be classified into two types:

  1. Things that are the same for every page
  2. Things that (can) change on every page

Things that are the same for every page include all the elements controlled in the Styles Dash. The exceptions are (1) the webpage background color (set in Body Widget), and (2) the Main Text card color, opacity, border, and shadow (set in PostBody Widget).

Things that (can) change on every page include:

  1. Things that can be toggled or modified by export options
  2. The presence of citation information for Research Prototypes
  3. The written content in the Text Area
  4. The background options for the webpage (color, texture, image)
  5. The background options for the Main Text card (color)

[Styling the webpage background]

Sidebar Control

Navbar Control

To add additional buttons to your navbar, simply paste an alias inside Blog NAVBAR. To remove a button, delete its alias inside Blog NAVBAR.

Styling

Populating the navbar

Banner Control

[Title and Subtitle Control]

If $DEExport is set to true, post and sub-post titles will export as their $DisplayExpression; otherwise, as their $Name.

To add a subtitle to your post, enter it into the $blogSubtitle key attribute. (If you don’t see it, just run the stamp.)

Styling

$DisplayName, $Name, or empty

[Date Control]

The date associated with a POST or PAGE is its creation date, stored in $Created. If the associated date is important and you want to enter the original time the idea occurred to you, you can enter it manually as $StartDate. The date that gets exported is $blogDate. $blogDate is calculated by an agent, and is equal to $Created unless $StartDate has been set.

Setting the displayed date manually
Do not set $blogDate manually, set $StartDate instead.
  • A POST will automatically show its created date automatically. To suppress this, use the NODATE export option.
  • A PAGE will not automatically show its created date. To force the date to show, use the DATED export option.

Your category notes sort their children by $blogDate.

Dating your posts

Styling: format and color

Forcing or suppressing export

[Image Control]

Your webpage will have a featured image only if $blogMapGraffle, $blogMapJPG, or $blogImage are set.

$blogExpOpt
NOIMAGE

Suppresses featured image from post

Scope:   self

[Audio]

Your webpage will have a featured audio player only if $blogAudio is set.

[Table of Contents]

Your webpage will have a Table of Contents only if (1) there are children, and (2) $blogTOC is non-zero. The value of $blogTOC determines the depth your Table of Contents expresses.

Adding a Table of Contents

$blogTOC
[outline depth]

Adds a Table of Contents

Scope:   self

[Text Area]

Besides simply typed text, there are other ways of presenting central body content.

For an exhaustive treatment of how to enter every kind of content, see here.

[Undertitle options for Research Prototypes]

[Child Inclusion Control]

[Styling the Text Area]

[Related Links]

[Footer]