Links between entries
Entries point at each other in four ways. None of them moves an entry out of its collection.
The four ways
| Link | Means | Example | Shows on |
|---|---|---|---|
| Parent | “This sits inside that.” One at most. | “Bench press 3×8” sits inside “Push day” | the child’s breadcrumb; the parent’s Children list |
| Children | A property that lists the entries inside this one, with their own columns. | Push day → Sets: Bench press, Dips | the parent |
| Relation | “This is linked to that,” between collections, with no ownership. | The book “Dune” → Author: Frank Herbert | both entries |
| Mention | An @-name inside your writing. | Diary, 19 Oct: “Finished @Dune today” | the writing, and “Mentioned in” on Dune |
Parent and Children
A Parent puts an entry inside another one. The sets of a workout, the ingredients of a recipe and the notes inside a note all use it. See Notes and the tree.
A parent lists its children only through a Children property on its collection. The property says which collection the children come from and which columns they show. Each set still shows in the Sets collection too.
Relations are two-sided
A Relation is one link, shown on both entries. Dune shows Author: Frank Herbert, and
Frank Herbert shows Books: Dune, Children of Dune. Change either side and both change.
- A Relation can hold one entry or many. A book can have two authors.
- Deleting an author never deletes the book.
- The second side is on by default. You can hide it on one side. Example: Flour in Foods is used by thousands of meals, so you hide that long list on Flour.
Mentions
Type @ in any Block page to mention an entry. The mentioned
entry shows “Mentioned in: Diary, 19 Oct”. Nothing moves.
- “Mentioned in” shows at once, as soon as the page saves your mention. Remove the mention and it goes.
- A page that mentions itself, and a page in the Trash, are not listed.
When a thing seems to belong in two places
Use a Relation plus a child. “Flour” as a food is one entry in Foods that many recipes point to. “Flour 200 g” is a line inside one recipe: its Parent is Pancakes, and it has a Relation to Foods / Flour.