Files

inventory69 015b90d56e 🐛 v1.2.1: Markdown Initial Export Bugfix + URL Normalization + GitHub Workflow Fix

## 🐛 Fixed
- Initial Markdown export: Existing notes now exported when Desktop Integration activated
- Markdown directory structure: Files now land correctly in /notes-md/
- JSON URL normalization: Smart detection for both Root-URL and /notes-URL
- GitHub release notes: Fixed language order (DE primary, EN collapsible) and emoji

## ✨ Improved
- Settings UI: Example URL shows /notes instead of /webdav
- Server config: Enter only base URL (app adds /notes/ and /notes-md/ automatically)
- Flexible URL input: Both http://server/ and http://server/notes/ work
- Changelogs: Shortened for F-Droid 500 char limit

## 🔧 Technical
- getNotesUrl() helper with smart /notes/ detection
- getMarkdownUrl() simplified to use getNotesUrl()
- All JSON operations updated to use normalized URLs
- exportAllNotesToMarkdown() with progress callback
- Workflow: Swapped CHANGELOG_DE/EN, replaced broken emoji with 🌍

versionCode: 6
versionName: 1.2.1

2026-01-05 11:46:25 +01:00

12 KiB

Raw Blame History

Desktop-Integration 🖥️

🌍 Languages: Deutsch · English

Bearbeite deine Notizen mit jedem Markdown-Editor auf dem Desktop

📋 Übersicht

Die Desktop-Integration ermöglicht dir, Notizen auf dem PC/Mac zu bearbeiten:

📝 Jeder Markdown-Editor funktioniert
🔄 Automatische Synchronisation über WebDAV
💾 Dual-Format: JSON (Master) + Markdown (Mirror)
⚡ Last-Write-Wins Konfliktauflösung

🎯 Warum Markdown?

Dual-Format Architektur

┌─────────────────────────────────────┐
│         Android App                 │
│                                     │
│  ┌──────────┐      ┌─────────────┐ │
│  │   JSON   │ ──→  │  Markdown   │ │
│  │ (Master) │      │  (Mirror)   │ │
│  └──────────┘      └─────────────┘ │
└────────┬────────────────┬───────────┘
         │                │
         ↓                ↓
    WebDAV Server
         │                │
    ┌────┴────┐      ┌────┴──────┐
    │ /notes/ │      │ /notes-md/│
    │ *.json  │      │ *.md      │
    └─────────┘      └───────────┘
         ↑                ↑
         │                │
    ┌────┴────────────────┴───────────┐
    │      Desktop Editor              │
    │  (VS Code, Typora, etc.)         │
    └──────────────────────────────────┘

Vorteile

JSON (Master):

✅ Zuverlässig und schnell
✅ Strukturierte Daten (IDs, Timestamps)
✅ Primärer Sync-Mechanismus
✅ Immer aktiv

Markdown (Mirror):

✅ Menschenlesbar
✅ Desktop-Editor kompatibel
✅ Syntax-Highlighting
✅ Optional aktivierbar

🚀 Schnellstart

1. Erste Synchronisation

Wichtig: Führe ZUERST einen Sync durch, bevor du Desktop-Integration aktivierst!

App einrichten (siehe QUICKSTART.md)
Server-Verbindung testen
Erste Notiz erstellen
Synchronisieren (Pull-to-Refresh oder Auto-Sync)
✅ Server erstellt automatisch /notes/ und /notes-md/ Ordner

2. Desktop-Integration aktivieren

Einstellungen → Desktop-Integration
Toggle aktivieren
Initial Export startet - Zeigt Progress (X/Y)
✅ Alle bestehenden Notizen werden als .md exportiert

3. WebDAV als Netzlaufwerk mounten

Windows

1. Explorer öffnen
2. Rechtsklick auf "Dieser PC"
3. "Netzlaufwerk verbinden"
4. URL eingeben: http://DEIN-SERVER:8080/notes-md/
5. Benutzername: noteuser
6. Passwort: (dein WebDAV-Passwort)
7. Laufwerksbuchstabe: Z:\ (oder beliebig)
8. Fertig!

Zugriff: Z:\ im Explorer

macOS

1. Finder öffnen
2. Menü "Gehe zu" → "Mit Server verbinden" (⌘K)
3. Server-Adresse: http://DEIN-SERVER:8080/notes-md/
4. Verbinden
5. Benutzername: noteuser
6. Passwort: (dein WebDAV-Passwort)
7. Fertig!

Zugriff: Finder → Netzwerk → notes-md

Linux (GNOME)

1. Files / Nautilus öffnen
2. "Andere Orte"
3. "Mit Server verbinden"
4. Server-Adresse: dav://DEIN-SERVER:8080/notes-md/
5. Benutzername: noteuser
6. Passwort: (dein WebDAV-Passwort)
7. Fertig!

Zugriff: /run/user/1000/gvfs/dav:host=...

Linux (davfs2 - permanent)

# Installation
sudo apt install davfs2

# Mount-Point erstellen
sudo mkdir -p /mnt/notes-md

# Einmalig mounten
sudo mount -t davfs http://DEIN-SERVER:8080/notes-md/ /mnt/notes-md

# Permanent in /etc/fstab
echo "http://DEIN-SERVER:8080/notes-md/ /mnt/notes-md davfs rw,user,noauto 0 0" | sudo tee -a /etc/fstab

Zugriff: /mnt/notes-md/

📝 Markdown-Editoren

Empfohlene Editoren

1. VS Code ⭐ Empfohlen

Vorteile:

✅ Kostenlos & Open Source
✅ Markdown-Preview (Ctrl+Shift+V)
✅ Syntax-Highlighting
✅ Git-Integration
✅ Erweiterungen (Spell Check, etc.)

Setup:

1. VS Code installieren
2. WebDAV-Laufwerk mounten
3. Ordner öffnen: Z:\notes-md\ (Windows) oder /mnt/notes-md (Linux)
4. Fertig! Markdown-Dateien bearbeiten

Extensions (optional):

Markdown All in One - Shortcuts & Preview
Markdown Preview Enhanced - Bessere Preview
Code Spell Checker - Rechtschreibprüfung

2. Typora

Vorteile:

✅ WYSIWYG Markdown-Editor
✅ Minimalistisches Design
✅ Live-Preview
⚠️ Kostenpflichtig (~15€)

Setup:

1. Typora installieren
2. WebDAV mounten
3. Ordner in Typora öffnen
4. Notizen bearbeiten

3. Notepad++

Vorteile:

✅ Leichtgewichtig
✅ Schnell
✅ Syntax-Highlighting
⚠️ Keine Markdown-Preview

Setup:

1. Notepad++ installieren
2. WebDAV mounten
3. Dateien direkt öffnen

4. Obsidian

Vorteile:

✅ Zweite Gehirn-Philosophie
✅ Graph-View für Verlinkungen
✅ Viele Plugins
⚠️ Sync-Konflikte möglich (2 Master)

Setup:

1. Obsidian installieren
2. WebDAV als Vault öffnen
3. Vorsicht: Obsidian erstellt eigene Metadaten!

⚠️ Nicht empfohlen: Kann Frontmatter verändern

📄 Markdown-Dateiformat

Struktur

Jede Notiz wird als .md Datei mit YAML-Frontmatter exportiert:

---
id: abc-123-def-456
created: 2026-01-05T14:30:22Z
updated: 2026-01-05T14:30:22Z
tags: []
---

# Notiz-Titel

Notiz-Inhalt hier...

Frontmatter-Felder

Feld	Typ	Beschreibung	Pflicht
`id`	UUID	Eindeutige Notiz-ID	✅ Ja
`created`	ISO8601	Erstellungsdatum	✅ Ja
`updated`	ISO8601	Änderungsdatum	✅ Ja
`tags`	Array	Tags (zukünftig)	❌ Nein

Dateinamen

Sanitization-Regeln:

Titel: "Meine Einkaufsliste 🛒"
→ Dateiname: "Meine_Einkaufsliste.md"

Entfernt werden:
- Emojis: 🛒 → entfernt
- Sonderzeichen: / \ : * ? " < > | → entfernt
- Mehrfache Leerzeichen → einzelnes Leerzeichen
- Leerzeichen → Unterstrich _

Beispiele:

"Meeting Notes 2026" → "Meeting_Notes_2026.md"
"To-Do: Projekt" → "To-Do_Projekt.md"
"Urlaub ☀️" → "Urlaub.md"

🔄 Synchronisation

Workflow: Android → Desktop

Notiz in App erstellen/bearbeiten
Sync ausführen (Auto oder manuell)
JSON wird hochgeladen (/notes/abc-123.json)
Markdown wird exportiert (/notes-md/Notiz_Titel.md) (nur wenn Desktop-Integration AN)
Desktop-Editor zeigt Änderungen (nach Refresh)

Workflow: Desktop → Android

Markdown-Datei bearbeiten (im gemounteten Ordner)
Speichern - Datei liegt sofort auf Server
In App: Markdown-Import ausführen
- Einstellungen → "Import Markdown Changes"
- Oder: Auto-Import bei jedem Sync (zukünftig)
App übernimmt Änderungen (wenn Desktop-Version neuer)

Konfliktauflösung: Last-Write-Wins

Regel: Neueste Version (nach updated Timestamp) gewinnt

Beispiel:

App-Version:     updated: 2026-01-05 14:00
Desktop-Version: updated: 2026-01-05 14:30
→ Desktop gewinnt (neuerer Timestamp)

Automatisch:

✅ Beim Markdown-Import
✅ Beim JSON-Sync
⚠️ Keine Merge-Konflikte - nur komplettes Überschreiben

⚙️ Einstellungen

Desktop-Integration Toggle

Einstellungen → Desktop-Integration

AN (aktiviert):

✅ Neue Notizen → automatisch als .md exportiert
✅ Aktualisierte Notizen → .md Update
✅ Gelöschte Notizen → .md bleibt (zukünftig: auch löschen)

AUS (deaktiviert):

❌ Kein Markdown-Export
✅ JSON-Sync läuft normal weiter
✅ Bestehende .md Dateien bleiben erhalten

Initial Export

Was passiert beim Aktivieren:

Alle bestehenden Notizen werden gescannt
Progress-Dialog zeigt Fortschritt (z.B. "23/42")
Jede Notiz wird als .md exportiert
Bei Fehlern: Einzelne Notiz wird übersprungen
Erfolgsmeldung mit Anzahl exportierter Notizen

Zeit: ~1-2 Sekunden pro 50 Notizen

🛠️ Erweiterte Nutzung

Manuelle Markdown-Erstellung

Du kannst .md Dateien manuell erstellen:

---
id: 00000000-0000-0000-0000-000000000001
created: 2026-01-05T12:00:00Z
updated: 2026-01-05T12:00:00Z
---

# Neue Desktop-Notiz

Inhalt hier...

⚠️ Wichtig:

id muss gültige UUID sein (z.B. mit uuidgen.io)
Timestamps in ISO8601-Format
Frontmatter mit --- umschließen

Bulk-Operations

Mehrere Notizen auf einmal bearbeiten:

WebDAV mounten
Alle .md Dateien in VS Code öffnen
Suchen & Ersetzen über alle Dateien (Ctrl+Shift+H)
Speichern
In App: "Import Markdown Changes"

Scripting

Beispiel: Alle Notizen nach Datum sortieren

#!/bin/bash
cd /mnt/notes-md/

# Alle .md Dateien nach Update-Datum sortieren
for file in *.md; do
  updated=$(grep "^updated:" "$file" | cut -d' ' -f2)
  echo "$updated $file"
done | sort

❌ Fehlerbehebung

"404 Not Found" beim WebDAV-Mount

Ursache: /notes-md/ Ordner existiert nicht

Lösung:

Erste Sync durchführen - Ordner wird automatisch erstellt

ODER: Manuell erstellen via Terminal:

curl -X MKCOL -u noteuser:password http://server:8080/notes-md/

Markdown-Dateien erscheinen nicht

Ursache: Desktop-Integration nicht aktiviert

Lösung:

Einstellungen → "Desktop-Integration" AN
Warten auf Initial Export
WebDAV-Ordner refreshen

Änderungen vom Desktop erscheinen nicht in App

Ursache: Markdown-Import nicht ausgeführt

Lösung:

Einstellungen → "Import Markdown Changes"
ODER: Auto-Sync abwarten (zukünftiges Feature)

"Frontmatter fehlt" Fehler

Ursache: .md Datei ohne gültiges YAML-Frontmatter

Lösung:

Datei in Editor öffnen

Frontmatter am Anfang hinzufügen:

---
id: NEUE-UUID-HIER
created: 2026-01-05T12:00:00Z
updated: 2026-01-05T12:00:00Z
---

Speichern und erneut importieren

🔒 Sicherheit & Best Practices

Do's ✅

✅ Backup vor Bulk-Edits - Lokales Backup erstellen
✅ Ein Editor zur Zeit - Nicht parallel in App UND Desktop bearbeiten
✅ Sync abwarten - Vor Desktop-Bearbeitung Sync durchführen
✅ Frontmatter respektieren - Nicht manuell ändern (außer du weißt was du tust)

Don'ts ❌

❌ Parallel bearbeiten - App und Desktop gleichzeitig → Konflikte
❌ Frontmatter löschen - Notiz kann nicht mehr importiert werden
❌ IDs ändern - Notiz wird als neue erkannt
❌ Timestamps manipulieren - Konfliktauflösung funktioniert nicht

Empfohlener Workflow

1. Sync in App (Pull-to-Refresh)
2. Desktop öffnen
3. Änderungen machen
4. Speichern
5. In App: "Import Markdown Changes"
6. Überprüfen
7. Weiteren Sync durchführen

📊 Vergleich: JSON vs Markdown

Aspekt	JSON	Markdown
Format	Strukturiert	Fließtext
Lesbarkeit (Mensch)	⚠️ Mittel	✅ Gut
Lesbarkeit (Maschine)	✅ Perfekt	⚠️ Parsing nötig
Metadata	Native	Frontmatter
Editoren	Code-Editoren	Alle Text-Editoren
Sync-Geschwindigkeit	✅ Schnell	⚠️ Langsamer
Zuverlässigkeit	✅ 100%	⚠️ Frontmatter-Fehler möglich
Mobile-First	✅ Ja	❌ Nein
Desktop-First	❌ Nein	✅ Ja

Fazit: Beide Formate nutzen = Beste Erfahrung auf beiden Plattformen!

🔮 Zukünftige Features

Geplant für v1.3.0+:

⏳ Auto-Markdown-Import - Bei jedem Sync automatisch
⏳ Bidirektionaler Sync - Ohne manuellen Import
⏳ Markdown-Vorschau - In der App
⏳ Konflikts-UI - Bei gleichzeitigen Änderungen
⏳ Tags in Frontmatter - Synchronisiert mit App
⏳ Attachments - Bilder/Dateien in Markdown

📚 Siehe auch:

QUICKSTART.md - App-Einrichtung
FEATURES.md - Vollständige Feature-Liste
BACKUP.md - Backup & Wiederherstellung

Letzte Aktualisierung: v1.2.1 (2026-01-05)

12 KiB Raw Blame History

Desktop-Integration 🖥️

📋 Übersicht

🎯 Warum Markdown?

Dual-Format Architektur

Vorteile

🚀 Schnellstart

1. Erste Synchronisation

2. Desktop-Integration aktivieren

3. WebDAV als Netzlaufwerk mounten

Windows

macOS

Linux (GNOME)

Linux (davfs2 - permanent)

📝 Markdown-Editoren

Empfohlene Editoren

1. VS Code ⭐ Empfohlen

2. Typora

3. Notepad++

4. Obsidian

📄 Markdown-Dateiformat

Struktur

Frontmatter-Felder

Dateinamen

🔄 Synchronisation

Workflow: Android → Desktop

Workflow: Desktop → Android

Konfliktauflösung: Last-Write-Wins

⚙️ Einstellungen

Desktop-Integration Toggle

Initial Export

🛠️ Erweiterte Nutzung

Manuelle Markdown-Erstellung

Bulk-Operations

Scripting

❌ Fehlerbehebung

"404 Not Found" beim WebDAV-Mount

Markdown-Dateien erscheinen nicht

Änderungen vom Desktop erscheinen nicht in App

"Frontmatter fehlt" Fehler

🔒 Sicherheit & Best Practices

Do's ✅

Don'ts ❌

Empfohlener Workflow

📊 Vergleich: JSON vs Markdown

🔮 Zukünftige Features

12 KiB

Raw Blame History