v2.0.9: Migration-Guide Obsidian -> Mind-o-Mat
- docs/MIGRATION.md: vollstaendiger Migrations-Leitfaden - 9 Schritte: Vault-Struktur, Naming, Frontmatter, Tags, Plugins, Tool, QMD, Index, PWA - PowerShell-Skripte fuer Ordner-Anlage, Naming-Normalisierung, Tag-Migration - Vergleich Obsidian-Workflow vs. Mind-o-Mat-Workflow - Was nicht funktioniert (Sync, Publish, Excalidraw, etc.) - Haeufige Probleme + Loesungen - Rueckkehr zu Obsidian moeglich Verifiziert: Markdown ist valides CommonMark, keine gebrochenen Links
This commit is contained in:
Jannik committed
1 parent
9d70cc615e
commit
6ce8649877
1 file changed
+248
@@ -0,0 +1,248 @@
|
||||
# Migration-Guide: Obsidian → Mind-o-Mat
|
||||
|
||||
Dieser Guide erklärt, wie du von einem bestehenden Obsidian-Vault zu Mind-o-Mat wechselst.
|
||||
|
||||
## Überblick
|
||||
|
||||
Mind-o-Mat ist **kein Obsidian-Klon**, sondern eine eigenständige Implementation mit:
|
||||
- Eigenem Markdown-Format (kompatibel, aber mit eigenen Konventionen)
|
||||
- Eigener PWA statt Obsidian-App
|
||||
- Eigenem Wiki-System statt Obsidian-Plugins
|
||||
- Eigener Cluster-Logik statt Obsidian-Tags
|
||||
|
||||
**Du behältst:** deine Markdown-Dateien, deine Ordnerstruktur, deine Grundkonzepte.
|
||||
**Du wechselst:** vom Obsidian-Editor zur PWA, vom Plugin-System zu eingebauten Befehlen.
|
||||
|
||||
## Schritt 1: Vault-Struktur anpassen
|
||||
|
||||
Obsidian verwendet typischerweise diese Struktur:
|
||||
|
||||
```
|
||||
MeinVault/
|
||||
├── .obsidian/ # Obsidian-Konfiguration
|
||||
├── Daily Notes/ # Tagesnotizen
|
||||
├── Projekte/
|
||||
├── Templates/
|
||||
└── ...
|
||||
```
|
||||
|
||||
Mind-o-Mat erwartet diese Struktur:
|
||||
|
||||
```
|
||||
MeinVault/
|
||||
├── 00_Inbox/ # Eingangskorb
|
||||
├── 01_Daily/ # Tagesnotizen
|
||||
├── 10_Wiki/Seiten/ # Wiki-Themenseiten
|
||||
├── 20_Projekte/
|
||||
├── 90_Templates/
|
||||
└── 99_System/ # System-Dateien
|
||||
```
|
||||
|
||||
**Skript für die Migration:**
|
||||
|
||||
```bash
|
||||
# In deinem Obsidian-Vault-Verzeichnis (PowerShell)
|
||||
$vault = "C:\Pfad\Zu\MeinemVault"
|
||||
|
||||
# Ordner umbenennen oder neu anlegen
|
||||
New-Item -ItemType Directory -Path "$vault\00_Inbox" -Force
|
||||
New-Item -ItemType Directory -Path "$vault\01_Daily" -Force
|
||||
New-Item -ItemType Directory -Path "$vault\10_Wiki\Seiten" -Force
|
||||
New-Item -ItemType Directory -Path "$vault\20_Projekte" -Force
|
||||
New-Item -ItemType Directory -Path "$vault\90_Templates" -Force
|
||||
New-Item -ItemType Directory -Path "$vault\99_System" -Force
|
||||
```
|
||||
|
||||
## Schritt 2: Notiz-Konventionen angleichen
|
||||
|
||||
Mind-o-Mat verwendet strengere Konventionen als Obsidian:
|
||||
|
||||
### Datei-Naming
|
||||
- **Obsidian:** Beliebige Namen, mit oder ohne Datum
|
||||
- **Mind-o-Mat:**
|
||||
- Dailies: `YYYY-MM-DD.md` (Obsidian: `2024-01-15.md` ✓ OK)
|
||||
- Wiki: `Pascal_Snake_Case.md` (Obsidian: `Mein Wiki.md` → umbenennen)
|
||||
- Inbox: `YYYY-MM-DD_Titel.md`
|
||||
- Sonderzeichen: nur `[a-zA-Z0-9_]` und `-` für Datums-Trennzeichen
|
||||
|
||||
**Skript zum Umbenennen** (PowerShell):
|
||||
|
||||
```powershell
|
||||
Get-ChildItem -Recurse -Filter "*.md" | ForEach-Object {
|
||||
$newName = $_.Name -replace '[^\w\-]', '_' -replace '\s+', '_'
|
||||
if ($_.Name -ne $newName) {
|
||||
Rename-Item $_.FullName $newName
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Frontmatter
|
||||
- **Obsidian:** Optional, oft ohne `---` am Ende
|
||||
- **Mind-o-Mat:** Pflicht-Frontmatter mit allen Feldern
|
||||
|
||||
```yaml
|
||||
---
|
||||
title: <Anzeigename>
|
||||
created: YYYY-MM-DD
|
||||
aktualisiert: YYYY-MM-DD # automatisch durch Ingest/Indexer
|
||||
type: <inbox|daily|wiki|project>
|
||||
status: <neu|aktuell|konflikt|entwurf|archiv>
|
||||
---
|
||||
```
|
||||
|
||||
**Wichtig:** Mind-o-Mat verwendet deutsche Keys (`aktualisiert`, nicht `updated`).
|
||||
|
||||
### Wikilinks
|
||||
- **Obsidian:** `[[Datei]]` oder `[[Datei|Anzeige]]` — kompatibel mit Mind-o-Mat ✓
|
||||
- **Mind-o-Mat:** Erkennt beide Formate
|
||||
|
||||
## Schritt 3: Tags und Cluster
|
||||
|
||||
Obsidian verwendet `#tags`, Mind-o-Mat ebenfalls — aber:
|
||||
- Mind-o-Mat unterstützt nur **eine Ebene** Hierarchie: `#kategorie/thema`
|
||||
- Mehr-Ebenen-Tags wie `#projekt/arbeit/2024` werden zu `#projekt/arbeit_2024` normalisiert
|
||||
|
||||
```bash
|
||||
# Migration: Tags mit > 1 Ebene umschreiben
|
||||
Get-ChildItem -Recurse -Filter "*.md" | ForEach-Object {
|
||||
$content = Get-Content $_.FullName -Raw
|
||||
$content = $content -replace '#(\w+)/(\w+)/(\w+)', '#$1_$2_$3'
|
||||
Set-Content $_.FullName $content -NoNewline
|
||||
}
|
||||
```
|
||||
|
||||
## Schritt 4: Obsidian-Plugins abschalten
|
||||
|
||||
Mind-o-Mat hat eigene Mechanismen für:
|
||||
- **Graph View** → Webapp Tab 1 (Cytoscape)
|
||||
- **Daily Notes** → `01_Daily/` + Ingest
|
||||
- **Backlinks** → landkarte.json (mit `--vault` Argument)
|
||||
- **Tags** → unterstützt, aber mit Hierarchie-Constraint
|
||||
- **Templates** → `90_Templates/` + Konventionen
|
||||
|
||||
Plugins wie Dataview, Templater, Excalidraw sind **nicht kompatibel**. Sie können Schaden anrichten, weil sie das Frontmatter-Format verändern könnten.
|
||||
|
||||
**Vor der Migration:**
|
||||
1. Obsidian öffnen
|
||||
2. Settings → Community Plugins → **alle deaktivieren**
|
||||
3. Optional: `.obsidian/` Ordner löschen (oder behalten, er wird ignoriert)
|
||||
|
||||
## Schritt 5: Tool installieren und Vault initialisieren
|
||||
|
||||
```bash
|
||||
# Tool global installieren
|
||||
cd C:\GitHub\Mind-o-Mat
|
||||
npm install
|
||||
npm run build
|
||||
npm link
|
||||
|
||||
# Vault initialisieren
|
||||
mindomat init-vault C:\Pfad\Zu\MeinemVault --remote https://git.example.com/Dein-Name/MeinVault.git
|
||||
```
|
||||
|
||||
Das `init-vault`-Skript erstellt:
|
||||
- 12 Standard-Ordner
|
||||
- `99_System/Konfig.md` mit Defaults
|
||||
- `README.md`
|
||||
- `CLAUDE.md`-Template
|
||||
- 2 Demo-Notizen
|
||||
- `.gitignore`
|
||||
- git init + gitea-Remote
|
||||
|
||||
**Achtung:** `init-vault` erstellt Ordner neu. Wenn dein Vault schon die richtigen Ordner hat, ist das idempotent. Sonst sichere vorher.
|
||||
|
||||
## Schritt 6: QMD einrichten
|
||||
|
||||
```bash
|
||||
cd C:\Pfad\Zu\MeinemVault
|
||||
|
||||
# QMD global installieren
|
||||
npm install -g @tobilu/qmd
|
||||
|
||||
# Collections anlegen
|
||||
qmd collection add 00_Inbox --name inbox
|
||||
qmd collection add 01_Daily --name daily
|
||||
qmd collection add 10_Wiki --name wiki
|
||||
qmd collection add 20_Projekte --name projekte
|
||||
|
||||
# Embeddings generieren (~2 GB Download, einmalig)
|
||||
qmd embed
|
||||
```
|
||||
|
||||
## Schritt 7: Erste Indexierung
|
||||
|
||||
```bash
|
||||
# Erstellt landkarte.json + 99_System/Index.md + 10_Wiki/Index.md
|
||||
mindomat index
|
||||
```
|
||||
|
||||
## Schritt 8: PWA öffnen
|
||||
|
||||
```bash
|
||||
cd C:\GitHub\Mind-o-Mat\webapp
|
||||
npm install
|
||||
npm run dev
|
||||
```
|
||||
|
||||
Browser öffnet `http://localhost:5173`. Erste Schritte:
|
||||
- Vault-Pfad setzen: in `.env` oder direkt beim Aufruf
|
||||
- Tabs ausprobieren: Graph, Cluster-Karte, Radial
|
||||
- Klick auf Notiz öffnet den PWA-Editor (Tiptap)
|
||||
- Sync-Button ruft `mindomat sync` auf
|
||||
|
||||
## Schritt 9: Workflow-Anpassung
|
||||
|
||||
### Obsidian-Workflow
|
||||
1. Notiz in Obsidian öffnen
|
||||
2. Schreiben
|
||||
3. Speichern (automatisch)
|
||||
4. Obsidian-Plugins verarbeiten (Dataview, etc.)
|
||||
|
||||
### Mind-o-Mat-Workflow
|
||||
1. Notiz in `00_Inbox/` ablegen (manuell oder via Editor)
|
||||
2. `mindomat ingest` läuft (manuell oder via Watch-Mode)
|
||||
3. LLM pflegt Wiki (oder macht Notiz zu Wiki)
|
||||
4. `mindomat index` aktualisiert Landkarte
|
||||
5. Webapp zeigt aktualisierten Graph
|
||||
6. `mindomat sync` pusht zu gitea
|
||||
|
||||
**Im Vergleich:** Obsidian ist WYSIWYG, Mind-o-Mat ist Pipeline-basiert. Mehr Kontrolle, mehr Schritte.
|
||||
|
||||
## Was NICHT funktioniert
|
||||
|
||||
- **Obsidian-Sync** über Cloud → wird durch gitea-Sync ersetzt
|
||||
- **Obsidian Publish** → keine direkte Entsprechung (PWA ist lokal)
|
||||
- **Excalidraw, Kanban, etc.** → nicht unterstützt (Markdown-only)
|
||||
- **Daily Note automatisch erstellen** → nicht in PWA, manuell oder via `mindomat ingest --note ...`
|
||||
|
||||
## Häufige Probleme
|
||||
|
||||
### "Meine alten Notizen werden nicht gefunden"
|
||||
- Dateinamen mit Sonderzeichen: `mindomat index` zeigt sie als `unknown`-Typ
|
||||
- Lösung: Skript zum Umbenennen (siehe Schritt 2)
|
||||
|
||||
### "Wikilinks sind rot"
|
||||
- Zieldatei fehlt oder hat falschen Namen
|
||||
- Lösung: `99_System/Index.md` zeigt verwaiste Links
|
||||
|
||||
### "Inbox wird nicht verarbeitet"
|
||||
- Datei hat kein Frontmatter
|
||||
- Lösung: `mindomat ingest --mock` zeigt, was die Pipeline macht
|
||||
|
||||
### "Graph ist leer"
|
||||
- `mindomat index` wurde nicht ausgeführt
|
||||
- Lösung: einmal laufen lassen
|
||||
|
||||
## Rückkehr zu Obsidian?
|
||||
|
||||
Wenn du zurück willst, ist das einfach:
|
||||
- Obsidian öffnen, Vault-Ordner wählen
|
||||
- Obsidian liest Markdown-Dateien direkt
|
||||
- Aber: Mind-o-Mat-spezifische Frontmatter-Felder werden ignoriert (kein Schaden)
|
||||
|
||||
## Weitere Hilfe
|
||||
|
||||
- `10_Wiki/SPEC.md` — vollständige Spezifikation
|
||||
- `10_Wiki/Plan.md` — Roadmap mit allen 20 Aufgaben
|
||||
- `README.md` — Install-Anleitung
|
||||
- GitHub Issues — für Bug-Reports und Feature-Wünsche
|
||||
Reference in new issue
Block a user