A Tinderbox document has two basic kinds of structure: one is the structure formed by links between notes. The other is the hierarchical structure of the document. A Tinderbox note can contain other notes, which can contain other notes, and so on. The notes can thought of this as chapters containing sections containing divisions; or topics containing subtopics; or in any way that fits the user's workflow.
Several terms are used to describe relationships within a hierarchy:
- parent: the item one level up.
- siblings: items that have the same parent.
- child: an item one level down. In Tinderbox, when a note contains other notes, those notes are its children.
- descendant: a child, or a child of a child, and so on.
- ancestor: a parent, or a parent of a parent, and so on.
- grandparent: specifically the parent of a note's parent.
- root: the item that has no parent. In a Tinderbox document, the document as a whole is the root: it contains the top-level notes, and nothing contains it.
- cover: the top level note. If more than one root-level note, the cover it the oldest sibling.
There are several group terms to describe Tinderbox notes:
- all: all notes in the current TBX file.
- ancestor: all ancestors.
- child: all children.
- descendant: all descendants - i.e. all children and their children.
- sibling: all siblings.
[Last updated: 1 Dec 2008]
Licensed under Creative Commons
Attribution-Noncommercial-Share Alike 3.0 License
[See aTbRef CC licence Attribution/Waiver info info]