9b41d51231
Some checks failed
Auto-update PR branches / Update open PR branches (push) Has been cancelled
CI / Frontend Static Quality Checks (push) Has been cancelled
CI / Frontend Tests & Coverage (push) Has been cancelled
CI / Rust Tests & Quality Checks (push) Has been cancelled
CI / Linux build verification (push) Has been cancelled
Deploy docs / Build VitePress site (push) Has been cancelled
Release (Alpha) / Compute alpha version (push) Has been cancelled
Deploy docs / Deploy to GitHub Pages (push) Has been cancelled
Release (Alpha) / Build release artifacts (push) Has been cancelled
Release (Alpha) / GitHub Release (alpha) (push) Has been cancelled
Release (Alpha) / Update docs and release pages (push) Has been cancelled
Source snapshot: 514ab1975951d94342ea38e64101d5a0f1c51c77
33 lines
1.4 KiB
Markdown
33 lines
1.4 KiB
Markdown
# Relationships
|
|
|
|
Relationships make a vault feel like a graph instead of a pile of documents.
|
|
|
|
## Relationship Fields
|
|
|
|
Any frontmatter field containing wikilinks can become a relationship. Relationship fields can point to one note or to an array of notes.
|
|
|
|
```yaml
|
|
belongs_to:
|
|
- "[[product-work]]"
|
|
related_to:
|
|
- "[[documentation]]"
|
|
- "[[editor-research]]"
|
|
blocked_by:
|
|
- "[[release-process]]"
|
|
- "[[sync-conflicts]]"
|
|
```
|
|
|
|
Tolaria supports default relationship fields out of the box: `belongs_to`, `has`, and `related_to`. It also detects custom relationship fields dynamically when they contain wikilinks.
|
|
|
|
Default relationships have automatically computed inverses. If a note says it `belongs_to` a project, the project can show that note under its inverse `has` relationship without you writing the reverse link by hand. `related_to` works as a lateral relationship in both directions.
|
|
|
|
These outgoing and inverse relationships appear in the Properties panel and in Neighborhood mode, where the note list becomes a graph view around the selected note.
|
|
|
|
## Body Links Versus Relationship Fields
|
|
|
|
Use body links when the relationship appears naturally in writing. Use frontmatter relationships when the connection is important enough to show in navigation, filters, Neighborhood mode, or the Properties panel.
|
|
|
|
## Backlinks
|
|
|
|
Tolaria can show incoming links and inverse relationships, making it easier to navigate from a note to the rest of its context.
|