Creating a new tree in your forest is as simple as adding a .tree
file to the trees
folder. Because it is hard to manually choose the next incremental tree address, Forester provides a command to do this automatically:
forester new forest.toml --dest=trees
In return, Forester should output the location of the new tree, e.g. trees/0002.tree
. If we look at the contents of this new file, we will see that it is empty except for metadata assigning a date to the tree:
You may prefer to use randomised addresses over sequential addresses; this can be particularly useful if multiple people are contributing to a forest. In that case, pass the --random
option to forester new
.
Most trees should have a annotation; this date is meant to be the date of the tree's creation; you can have more than one date, if you like to keep track of when a tree has been updated. You should proceed by adding further metadata: the title and the author; for the latter, you will use the address of your personal biographical tree.
Tree titles should be given in lower case (except for proper names, etc.); these titles will be rendered by Forester in sentence case. A tree can have as many declarations as it has authors; these will be rendered in their order of appearance.
Now you can begin to populate the tree with its content, written in the Forester markup language. Think carefully about keeping each tree relatively independent and atomic.