This version is out of date, covering development from v9.0.0 to v9.3.0. It is maintained here only for inbound reference links from elsewhere. It is no longer actively updated.

Jump to the current version of aTbRef

Tinderbox v9 Icon

Explode pop-over

Explode pop-over

This dialog is called from the Note menu. It allows you to split a large text file into several smaller text notes and to specify both where Tinderbox should make the divisions and how the notes should be titled.

The choices for splitting content are:

  • Break at paragraphs. Breaks each paragraph into a new note (default option).
  • Delimiter. Break on a delimiter. A box for entering the delimiter and the delete delimiter tick-box are hidden when this option is not selected.
    • Custom delimiter string: see below.
    • Delete delimiter. Only available if the 'Delimiter' option is set (default = not ticked). Tick this to remove the specified delimiter from the new exploded notes. When the delimiter is a complete line/paragraph, ensure the string used includes the line return character at the end or some output notes will have text starting with a blank line. Tinderbox remembers the last-used custom delimiter until the end of the current session
  • Title. This controls what text is placed into the title of each newly split note. Text is still truncated with an ellipsis if greater than c.512 characters (in older version pre-v5 it was c.64 characters). Within this overall limit, the title can based on sentences or paragraphs in the exploded note's $Text. A 'sentence' is delimited by a terminating period, exclamation mark or question mark. A paragraph is delimited by a line return (line break).
    • first sentence. Only the first sentence forms the new title.
    • first two sentences. Only the two sentences form the new title.
    • first paragraph. Only the first paragraph is used for the new title.
  • [Text options]:
    • Remove title from text. If selected the text used for the above choice is deleted from the new note's body text.
    • Omit text. This results in only a $Name being set for new notes and no $Text.
  • Action. Allows a simple action to be inserted that is applied to each newly exploded note by setting an $OnAdd for the 'exploded notes' container created by the process. It is useful for tasks like applying a prototype to all new exploded notes.
  • Example. Gives a preview of the $Text of the first exploded note. A control below the preview allows cycling through a preview of successive exploded notes.
  • Explode button. Click to start the Explode process using the choices set above. The Return key (↩) will also start the Explode process.

See Exploding Notes for more detail of the overall process and options available.

A Tinderbox Reference File : Dialogs : Explode pop-over