 |
PandoCitPandoc-Zitate in Obsidian |
Entwickelt von l'Atelier — Buchherstellung und Forschungswerkzeuge (EHESS)
🇫🇷 Français · 🇬🇧 English · 🇩🇪 Deutsch · 🇪🇸 Español
|
PandoCitPandoc-Zitate in Obsidian |
Entwickelt von l'Atelier — Buchherstellung und Forschungswerkzeuge (EHESS)
🇫🇷 Français · 🇬🇧 English · 🇩🇪 Deutsch · 🇪🇸 Español
| 
|
---
## 📖 Überblick
Zeigt in der Seitenleiste eine formatierte Referenzliste für jeden Pandoc-Zitierschlüssel (`[@schlüssel]`) in der aktiven Notiz.
## ⬇️ Installation über BRAT (1 Klick)
1. 🔌 **BRAT** installieren: [Obsidian — BRAT](https://obsidian.md/plugins?search=BRAT#)
2. ➕ Dieses Repository mit *„Add Beta plugin“* hinzufügen:
`https://github.com/Atelier-Recherche/pandocit`
> 💡 Unsere Plugins können noch auf die Validierung im Obsidian-Katalog warten; mit BRAT können Sie sie sofort testen. Siehe auch 🌐 [l'Atelier](https://atelier.atechnologie.fr/).
## ⚙️ Funktionsweise
- 🦀 Das Plugin nutzt **Pandoc 3.9 WebAssembly** (`pandoc.wasm`), um Bibliographie-Dateien (BibTeX usw.) in CSL JSON zu konvertieren. **Keine systemweite Pandoc-Installation nötig.**
- 📱 Kompatibel mit **Obsidian Desktop** (Windows, macOS, Linux) **und Mobil** (Android, iOS): dasselbe Plugin auf Computer, Smartphone und Tablet.
## 🔧 Konfiguration
1. **📚 Bibliographie**
Pfad zur Bibliographie-Datei (Pandoc-kompatibel: `.bib`, CSL-`.json` usw.).
- 🖥️ **Desktop**: Dateiauswahl oder absoluter / vault-relativer Pfad.
- 📱 **Mobil**: nur **vault-relativer** Pfad (z. B. `refs/bibliographie.bib`). Der Dateidialog ist nur auf dem Desktop verfügbar.
2. **🎨 Zitierstil (CSL)** *(optional)*
Integrierte Liste oder `.csl`-Datei (Pfad oder URL), ggf. per Frontmatter überschreibbar (`bibliography`, `csl`, `lang` usw.).
3. **📋 Referenzpanel**
Befehlspalette: **„PandoCit : Show reference list“** (Bezeichnung je nach Obsidian-Oberflächensprache).
4. **🌐 Plugin-Sprache** *(optional)*
In den Plugin-Einstellungen: Sprache der Beschriftungen (Einstellungen, Eintragseditor, eigene Seitenleiste).
## 📚 Zotero (optional)
### 🔗 Better BibTeX / lokaler Feed
Die Integration mit **Better BibTeX** und dem lokalen Netzwerk eignet sich vor allem für **Obsidian Desktop**. Auf Mobilgeräten lieber eine Bibliographie-Datei im Vault.
### ☁️ Zotero Web API
Nach Aktivierung in den Einstellungen:
- 🔑 **API-Schlüssel** und **persönliche** oder **Gruppen**-Bibliothek (numerische ID).
- 👥 **Gruppenbibliotheken zusammenführen**: Gruppen-IDs + **Gruppen laden** oder **eigene Anzeigenamen** (eine Zeile pro ID + Bezeichnung).
- 🔄 **Bidirektionale Synchronisation** (Zotero-API-Modell).
- 📤 Optionaler **BibTeX-Export** in eine `.bib`-Datei im Vault (für Pandoc, LaTeX, Typst).
Die Daten werden als JSON im Plugin-Ordner gespeichert; **keine lokale Zotero-Node-Installation** — Offline-Nutzung des Vaults nach der Synchronisation möglich.
### 🌳 Panel „Bibliothek“
Befehl: **„Open library panel“** / **„Bibliotheksbereich öffnen“**.
**Baumansicht** (Sammlungen, nicht eingeordnete Einträge, einzelne Anhänge, Papierkorb). Filter, Bearbeitung der Einträge (inkl. Zotero-HTML-Notizen), **PDF-/Datei**-Anhänge in der Zeile.
- **▸ Unterbaum standardmäßig eingeklappt**: Chevron in der Anhangsleiste zum Ein- und Ausklappen der Kinder.
- **🏷️ Typ-Badges** (Buch, Zeitschriftenartikel …) folgen der **Plugin-Oberflächensprache**, sofern unterstützt.
Befehl **„Sync Zotero library (Web API)“** zum Aktualisieren nach der ersten Synchronisation.
## 💻 Entwicklung und Build
Voraussetzungen: [Node.js](https://nodejs.org/) und [Yarn](https://yarnpkg.com/).
```bash
yarn install
yarn build
```
Erzeugt `main.js` im Projektroot. Zum Testen im Vault nach `.obsidian/plugins/