Obsidian-Plugin-Leitfaden (Beta)

Ähnlich wie die VS Code-Erweiterung bietet unser Obsidian-Plugin kontextsensitive OCR, was durch die nahtlose Integration zwischen der WriteTex-App und Obsidian eine genauere Leistung ermöglicht.

WARNUNG: DAS PLUGIN BEFINDET SICH IN DER INTENSIVEN ENTWICKLUNG UND BIETET KEINERLEI GEWÄHRLEISTUNG. DIE NUTZUNG ERFOLGT AUF EIGENE GEFAHR. SIEHE LIZENZ. Derzeit müssen Sie über eine funktionierende API-Konfiguration eines Drittanbieters (z. B. OpenAI) verfügen, um das Plugin zu verwenden.

Funktionen

• Begleiter für die WriteTex-App: Verbindet die mobile WriteTex-App nahtlos mit Ihrem Obsidian-Editor auf dem Desktop.
• Kontextbewusstsein: Sendet automatisch den Text um Ihren Cursor an die KI, was die Genauigkeit verbessert, indem der Stil und die Variablen Ihres aktuellen Dokuments verstanden werden.
• Direktes Einfügen: Der generierte Code wird sofort an Ihrem Cursor eingefügt.

Installation

1. Laden Sie das neueste Release von unserem GitHub-Repository herunter.
2. Legen Sie main.js und manifest.json in das Plugin-Verzeichnis Ihres Vaults: <VAULT>/.obsidian/plugins/writetex-obsidian/.
3. Öffnen Sie die Obsidian-Einstellungen -> Community-Plugins und aktivieren Sie WriteTex.

Sie müssen die Desktop-Version von WriteTex nicht installieren, um das Obsidian-Plugin zu verwenden. Es wird nur die mobile App auf Ihrem iPad/Tablet benötigt.

Konfiguration

Dieser Teil ähnelt der Einrichtung auf anderen Plattformen. Ein einfaches Beispiel ist unten dargestellt:

Einstellung	Wert
API-Endpunkt	https://api.openai.com/v1
Modell	gpt-5
API-Schlüssel	sk-...

Benutzerdefinierte Anweisungen (Custom Instructions)
Einige zusätzliche Eingabeaufforderungen, um das KI-Modell zu steuern. Sie können beispielsweise hinzufügen: „Verwenden Sie \mathbb{i} für die imaginäre Einheit.“

Verwendung

1. Server starten:

   • Der Server startet automatisch, wenn Obsidian geladen wird.
   • Überprüfen Sie die Statusleiste unten rechts: Dort sollte „WriteTex: On“ stehen.
   • Wenn dort „Off“ steht, öffnen Sie die Befehlspalette (Cmd/Ctrl + P) und führen Sie „WriteTex: Start Server“ aus.

2. Client verbinden (z. B. iOS-App):

   • Öffnen Sie die WriteTex-App auf Ihrem Telefon.
   • Stellen Sie sicher, dass sich Ihr Telefon und Ihr Computer im gleichen WLAN-Netzwerk befinden.
   • Die App sollte automatisch „WriteTex Obsidian @ [IhrHostname]“ finden.
   • Wenn die automatische Suche fehlschlägt, geben Sie die IP-Adresse Ihres Computers manuell ein.

Für andere Plattformen (Windows, Android, MacOS) folgen Sie dem Leitfaden unter VS Code.

3. Handgeschriebene Formel mit WriteTex einfügen:
   • Platzieren Sie Ihren Cursor in einer Obsidian-Notiz an der Stelle, an der der Code erscheinen soll.
   • Verwenden Sie die mobile App, um eine mathematische Formel zu schreiben.
   • Das Plugin empfängt das Bild, analysiert es im Kontext Ihrer aktuellen Notiz und fügt das LaTeX/Markdown-Ergebnis direkt in Ihren Editor ein.

Fehlerbehebung

• Server startet nicht: Überprüfen Sie, ob Port 50905 von einer anderen Anwendung verwendet wird. Wenn Sie den WriteTex-Server in der VS Code-Erweiterung aktiviert haben, deaktivieren Sie ihn bitte, bevor Sie Obsidian starten.
• Mobile App kann keine Verbindung herstellen:
  • Stellen Sie sicher, dass beide Geräte im gleichen WLAN sind.
  • Überprüfen Sie die Firewall-Einstellungen Ihres Computers, um eingehende Verbindungen auf Port 50905 zuzulassen.
  • Einige Schul- oder Unternehmensnetzwerke blockieren möglicherweise Verbindungen zwischen Geräten. In diesem Fall können Sie versuchen, ein VPN oder einen Hotspot zu verwenden.
• „Unauthorized“-Fehler: Stellen Sie sicher, dass die Client-App den API-Schlüssel writetex sendet.