Pandoc CSL-Zitierstile im Browser konfigurieren: APA, Chicago, Vancouver
Pandoc verwandelt ein Dokument voller nackter Zitierschlüssel in eine fertige Arbeit mit formatierten Zitaten im Text und einem Literaturverzeichnis. Die Maschinerie dahinter ist citeproc, inzwischen fest in pandoc eingebaut, und die Stile, denen es folgt, sind in CSL geschrieben, der Citation Style Language. Beide verhalten sich identisch, egal ob pandoc auf der Kommandozeile läuft oder als WebAssembly kompiliert in einem Browser-Tab.
Diese Anleitung behandelt, was CSL ist und wo Sie Stildateien bekommen, wie Sie ein BibTeX-Literaturverzeichnis so vorbereiten, dass citeproc zuverlässig damit arbeitet, was sich bei APA, Chicago und Vancouver für denselben Input tatsächlich ändert und welche Fehler literale Zitierschlüssel im fertigen Text hinterlassen.
Was CSL ist
CSL steht für Citation Style Language, ein XML-Format, das exakt beschreibt, wie ein Zitat und ein Literaturverzeichniseintrag aussehen sollen: wo das Jahr steht, ob Titel kursiv gesetzt werden, wie Seitenbereiche zusammengezogen werden. Jeder große Stil existiert als CSL-Datei, und allein das Zotero Style Repository beherbergt Tausende davon, von APA und Chicago bis zu den Hausstilen einzelner Fachzeitschriften.
Weil der Stil in einer Datei lebt und nicht im Code, bedeutet ein Wechsel der Konventionen, die Datei zu tauschen statt das Dokument zu bearbeiten. Zeitschriften, die ein bestimmtes Format vorschreiben, nennen es meist beim Namen, und die passende CSL-Datei lässt sich ohne eigene Konfiguration aus dem Repository herunterladen.
Wie citeproc ein Zitat auflöst
Im Quelldokument werden Zitate inline mit dem At-Zeichen geschrieben. Ein Schlüssel in eckigen Klammern wird zum Klammerzitat, während ein direkt im Satz verwendeter Schlüssel zu einem narrativen Zitat wird, bei dem der Autorenname Teil des Fließtexts ist. Seiten- und Kapitelangaben reisen mit dem Schlüssel, sodass sie innerhalb der Klammern mitgeführt werden.
Beim Konvertieren liest citeproc jeden Schlüssel, schlägt ihn in der Bibliographiedatei nach und übergibt den aufgelösten Eintrag zur Formatierung an den CSL-Stil. Derselbe Durchlauf sammelt alle zitierten Einträge und hängt am Ende des Dokuments ein Literaturverzeichnis an – oder dort, wo ein Block mit der ID refs die Stelle markiert. Schlüssel sind von Ihnen gewählte Etiketten und erscheinen nie in der Ausgabe, es sei denn, etwas ist schiefgegangen.
Die Stildatei besorgen
Das Zotero Style Repository ermöglicht die Suche nach Verlag oder Stichwort und den Download einer .csl-Datei mit einem Klick. Lesen Sie Stilnamen genau: Chicago gibt es als note-bibliography-Variante, die Fußnoten erzeugt, und als author-date-Variante, die Klammerzitate erzeugt – und das sind zwei verschiedene Dateien.
Wenn eine Zeitschrift nur Formatierungsanweisungen statt einer Datei veröffentlicht, suchen Sie zuerst im Repository nach dem Zeitschriftennamen. Es erfasst Tausende von Zeitschriften, und eine gepflegte Datei schlägt eine handbearbeitete. Findet sich nichts, ist der nächstliegende übergeordnete Stil für Entwürfe meist akzeptabel.
Die .bib-Datei vorbereiten
Die Bibliographiedatei bildet Schlüssel auf Metadaten ab. Im BibTeX-Format beginnt jeder Eintrag mit einem Typ wie article, book oder inproceedings, gefolgt von einem von Ihnen erfundenen Schlüssel, dann Felder wie author, title, year, journal und DOI. Der Schlüssel ist das, was Sie im Text tippen, also schlägt kurz und einprägsam lang und präzise, und ein stabiles Schema aus Autor, Jahr und einem Wort hält Entwürfe auch Jahre später lesbar.
Die Vollständigkeit der Felder zeigt sich direkt in der Ausgabe. Ein fehlendes Jahr hinterlässt eine leere Stelle in einem APA-Zitat, und ein fehlender DOI lässt den Link verschwinden, dem Leser folgen würden. Eigennamen in doppelten geschweiften Klammern im title-Feld schützen ihre Großschreibung, weil BibTeX Titel sonst den Stilregeln zuliebe kleinschreiben kann.
Ein Input, drei Ausgaben
Nehmen Sie eine einzige Zeile mit einem Schlüssel in Klammern und einem narrativen Schlüssel. Unter APA, einem author-date-Stil, wird das Klammerzitat zu Name und Jahr in Klammern, das narrative zum Autor gefolgt vom Jahr in Klammern, und das Literaturverzeichnis wird alphabetisch sortiert mit hängendem Einzug. Unter Chicago note-bibliography werden dieselben Zitate zu nummerierten Fußnoten, bei der ersten Nennung vollständig, danach gekürzt.
Unter Vancouver, in der Medizin üblich, werden Zitate zu fortlaufenden Nummern in eckigen Klammern, geordnet nach dem ersten Auftreten statt alphabetisch. In allen drei Fällen ändert sich an Ihrem Text nichts: Schlüssel, Datei und Dokument bleiben identisch, nur die CSL-Datei wird getauscht – das ist der ganze Sinn des Formats und der Grund, es früh einzurichten.
Zitate im Browser verarbeiten
Auf dieser Website akzeptieren die Pro-Zitatoptionen zwei Uploads: eine .bib-Datei mit den Referenzen und eine .csl-Datei mit dem gewählten Stil. Alles läuft im Browser-Worker, wo citeproc Teil derselben Pandoc-Engine ist, die die Konvertierung durchführt – Schlüssel werden also exakt wie auf der Kommandozeile aufgelöst.
Der Arbeitsablauf ist kurz: Schreiben Sie das Dokument wie gewohnt mit At-Schlüsseln, halten Sie eine .bib-Datei pro Projekt bereit, legen Sie die Stildatei bei, die die Zielzeitschrift verlangt, und konvertieren Sie. Ein späterer Zeitschriftenwechsel bedeutet dann, eine andere .csl-Datei hochzuladen, statt irgendein Zitat neu zu schreiben.
Häufige Fehler und Lösungen
Der häufigste Fehler ist ein Schlüsselmismatch: Der Text zitiert einen Schlüssel, den die .bib-Datei nicht definiert, und pandoc lässt den rohen Klammerausdruck in der Ausgabe stehen, während es eine Warnung über die fehlende Referenz protokolliert. Prüfen Sie die Schreibweise des Schlüssels und ob wirklich die gewünschte Datei hochgeladen wurde.
Probleme mit der Groß- und Kleinschreibung gehen auf das title-Feld zurück, wo Akronyme und Eigennamen kleingeschrieben ankommen, wenn der Stil es verlangt; der Schutz durch doppelte geschweifte Klammern in der .bib-Datei existiert genau dafür. Fehlende Felder zeigen sich als Leerstellen oder unvollständige Zitate – eine Stichprobe bei einem gerenderten Literaturverzeichniseintrag fängt die meisten Probleme vor der Einreichung ab.
Browser-Ausgabe versus Kommandozeile
Weil die Browser-Version dieselbe citeproc-Implementierung in derselben Pandoc-Engine ausführt, kommen formatierte Zitate und Literaturverzeichnis bei gleichen Eingaben und Versionen identisch heraus wie auf der Kommandozeile. Es gibt keinen vereinfachten Formatierer dazwischen.
Diese Gleichwertigkeit macht den Browser zu einem legitimen Ort, um einen Einreichungsentwurf vorzubereiten: Stil anwenden, gerenderte Referenzen prüfen und Gutachtern ein Dokument übergeben, dessen Zitate bereits zur Zielzeitschrift passen. Der Konverter auf dieser Website hält die Verarbeitung von .bib und .csl in Ihrem Browser, sodass auch unveröffentlichte Manuskripte auf Ihrem Rechner bleiben.