Grundbegriffe

Apparat kennt nur wenige grundlegende Begriffe. Wer sie einmal verstanden hat, versteht auch den Rest.

Entität

Eine Entität ist eine einzelne Informations­einheit — eine Person, eine Organisation, ein Projekt, ein Gedanke, ein Dokument. Technisch ist eine Entität eine Markdown-Datei mit einem kleinen YAML-Kopf darüber. Der Kopf trägt die strukturierte Information (Typ, Datum, Tags, Beziehungen), der Textteil darunter den Fließtext.

Eine Entität anlegen

Drei grundsätzlich verschiedene Formen, wie Inhalt in einen Vault kommt — eine Notiz, die aus sich selbst lebt; eine Notiz mit Dateien als Beilage; ein Verweis auf etwas Externes. Welcher Anlage-Weg passt, hängt vom Inhalt ab, nicht vom Werkzeug; Kommandozeile und Web-Oberfläche erzeugen identische Ergebnisse im Vault.

Vault

Ein Vault ist ein eigenständiger Wissensraum — ein Verzeichnis mit Notizen zu einem Thema. Du kannst beliebig viele Vaults parallel führen (z.B. privat, arbeit, recherche). Jeder Vault hat seinen eigenen Graph und seine eigenen Indizes. Vaults können sich gegenseitig verlinken, bleiben aber voneinander unabhängig.

Tags und Typen

Typen sind Kategorien — person, organization, concept, book. Konvention: englisch, klein­geschrieben, Singular. Sie werden nicht vorgegeben, sondern entstehen beim Benutzen. Tags sind freie Schlagworte und folgen deiner Inhalts­sprache. Beide lassen sich für Suche und Filterung verwenden.

Ähnlichkeit

Apparat verwendet das Wort ähnlich an mehreren Stellen — Suche, NER-Vorschläge, Konsolidierung. Dahinter stehen acht verschiedene Verfahren mit unterschiedlichen Stärken. Die zentrale Übersicht erklärt, welches wann greift, und warum die Schwellwerte stehen, wo sie stehen.

Beziehung

Verbindungen zwischen Entitäten. Entweder explizit im YAML-Kopf als Mapping mit target-NanoID, oder implizit durch Links im Fließtext. Gesetzt und entfernt wird per entity link und entity unlink.

Asset

Binärdateien — Fotos, Audio-Aufnahmen, PDFs, Videos — die zu einer Entität gehören. Assets liegen im Verzeichnis assets/ innerhalb des Vaults und werden von Entitäten über ihr representations-Feld referenziert. Einer Entität können mehrere Assets zugeordnet sein; ein Asset kann umgekehrt auch Repräsentation mehrerer Entitäten sein.

Konsolidierung

Der Mechanismus, der dir beim Eingeben von Typen und Tags verhindert, dass du aus Versehen parallele Varianten anlegst (person vs. Person vs. personen vs. persons). Apparat erkennt ähnliche Eingaben und schlägt dir die bestehende Schreibweise vor — ohne dich zur Übernahme zu zwingen.