BibTeX-Bereiniger & Prüfer

So verwenden Sie den BibTeX-Bereiniger

1. 1. Fügen Sie Ihre .bib-Datei ein oder laden Sie sie. Das Tool liest die gesamte Datei so, wie BibTeX selbst sie liest: @string-Makros, #-Verkettungen, @preamble, @comment, verschachtelte geschweifte Klammern und Notizen zwischen den Einträgen.
2. 2. Wählen Sie die Bereinigung. Jede Option ist standardmäßig aktiv, außer dem Schutz der Großbuchstaben und der Sortierung. Schalten Sie aus, was unverändert bleiben soll. Das Ergebnis aktualisiert sich, wenn Sie die Optionen ändern.
3. 3. Lesen Sie die Probleme. Fehler und Warnungen werden mit Zeile und Zitierschlüssel aufgelistet, von einer fehlenden Zeitschrift bis zu einem Schlüssel, der zweimal verwendet wird.
4. 4. Prüfen Sie die Änderungen und laden Sie herunter. Jede Änderung wird nach Eintrag und Feld mit dem Wert vorher und nachher protokolliert. Das Ergebnis wird als cleaned.bib heruntergeladen.

Was der Prüfer kontrolliert

Klassisches BibTeX definiert vierzehn Eintragstypen und die Felder, die jeder davon braucht. Der Prüfer wendet diese Tabelle an – aus Oren Patashniks BibTeXing, der Dokumentation, die mit BibTeX mitgeliefert wird – und akzeptiert die Feldnamen von biblatex für dieselben Daten. So zählen journaltitle, date und institution einer Abschlussarbeit als ihre klassischen Entsprechungen.

Der Prüfer markiert außerdem einen Schlüssel, der zweimal verwendet wird (BibTeX behält nur den ersten Eintrag), Schlüssel, die sich nur in der Großschreibung unterscheiden, und Schlüssel mit einem Leerzeichen oder einem anderen Zeichen, das BibTeX im Schlüssel nicht lesen kann. Er meldet dieselbe DOI in zwei Einträgen, denselben Titel und dasselbe Jahr in zwei Einträgen, ein Feld, das zweimal angegeben ist, ein Makro, das verwendet, aber nie mit @string definiert wurde, und ein Jahr, das nicht vierstellig ist. Ein Eintrag, den das Tool nicht zu Ende lesen kann – ein fehlendes Komma, eine unausgeglichene Klammer –, wird mit seiner Zeilennummer gemeldet und unverändert belassen, sodass die Bereinigung niemals Text löscht.

Was die Bereinigung ändert

• Eintragstypen und Feldnamen in Kleinschreibung: @ARTICLE wird zu @article, Author zu author.
• Leerraum: Zeilenumbrüche und Folgen von Leerzeichen innerhalb eines Werts werden zu einzelnen Leerzeichen zusammengezogen.
• Begrenzer: Angeführte Werte werden in geschweifte Klammern gesetzt, die ein verirrtes Anführungszeichen im Titel überstehen.
• Seitenbereiche mit dem doppelten Bindestrich, den LaTeX als Halbgeviertstrich ausgibt: 16569-16572 wird zu 16569--16572.
• Monate als BibTeX-Makros, jan bis dec, ohne geschweifte Klammern, damit jeder Stil sie ausschreiben oder abkürzen kann.
• Leere Felder wie note = {} werden entfernt.
• DOIs verlieren das Präfix https://doi.org/. Stile, die die DOI ausgeben, fügen ihr eigenes hinzu.
• Großbuchstaben in Titeln (optional): geschweifte Klammern um Akronyme und Wörter mit gemischter Schreibweise – {DNA}, {mRNA}, {iPhone} – oder um jedes großgeschriebene Wort nach dem ersten, damit Stile, die Titel in Satzschreibweise setzen, sie nicht kleinschreiben können.
• Feldreihenfolge: Autor, Titel, Journal oder Buchtitel, Band, Nummer, Seiten, Jahr, Monat, Verlag, dann Kennungen; oder alphabetisch; oder wie zuvor belassen.
• Sortierung (optional): nach Schlüssel, erstem Autor oder Jahr. @string-Definitionen bleiben oben, weil ein Makro definiert sein muss, bevor ein Eintrag es verwendet.

@ARTICLE{hirsch2005,
  Author = {Hirsch, J. E.},
  title = "An index to quantify an individual's scientific research output",
  journal = {Proceedings of the National Academy of Sciences},
  year = 2005, month = {November},
  pages = {16569-16572},
  note = {}
}

@article{hirsch2005,
  author  = {Hirsch, J. E.},
  title   = {An index to quantify an individual's scientific research output},
  journal = {Proceedings of the National Academy of Sciences},
  pages   = {16569--16572},
  year    = 2005,
  month   = nov
}

Das Änderungsprotokoll für diesen Eintrag hat sieben Zeilen: Der Typ wird klein geschrieben, Author in author umbenannt, der Titel in geschweifte Klammern gesetzt, November in das Makro nov umgewandelt, der Seitenbereich mit dem doppelten Bindestrich versehen, das leere note entfernt und die Felder in die richtige Reihenfolge gebracht. Das Jahr bleibt eine nackte Zahl, die BibTeX akzeptiert.

BibTeX oder biblatex?

Dieselbe .bib-Datei kann zwei Systeme speisen. Klassisches BibTeX mit Stilen wie plain oder der .bst-Datei einer Zeitschrift kennt die vierzehn Standardtypen und ignoriert unbekannte Felder stillschweigend. biblatex, verarbeitet mit biber, ergänzt Typen wie @online, @report und @thesis sowie Felder wie journaltitle, date, location, urldate und eprint. Außerdem liest es akzentuierte Buchstaben direkt, statt LaTeX-Akzentbefehle zu brauchen. Der Prüfer warnt, wenn ein Eintrag einen Typ nur aus biblatex verwendet – ein klassischer Stil fällt dann mit einer Warnung auf @misc zurück. Er meldet aber nie einen biblatex-Feldnamen als fehlendes Feld.

Häufig gestellte Fragen

Wie prüfe ich eine BibTeX-Datei auf Fehler?

Fügen Sie sie in das Feld oben ein oder laden Sie die .bib-Datei. Der Prüfer listet jedes Problem mit Zeilennummer und Zitierschlüssel auf: Einträge, die nicht gelesen werden können, fehlende Pflichtfelder, doppelte Schlüssel, wiederholte DOIs oder Titel, nicht definierte Makros und Jahreszahlen, die nicht vierstellig sind. Beheben Sie die Fehler zuerst, denn sie führen dazu, dass BibTeX warnt oder eine Quelle verwirft.

Was bedeutet die Meldung „I'm skipping whatever remains of this entry“?

BibTeX gibt einen Eintrag auf, den es nicht lesen kann – meist wegen eines fehlenden Kommas zwischen zwei Feldern, einer unausgeglichenen Klammer oder eines Anführungszeichens in einem angeführten Wert. Der Bereiniger meldet dieselben Einträge als Lesefehler mit Zeilennummern und belässt sie unverändert in der Ausgabe, damit Sie sie direkt reparieren können.

Sollte man in BibTeX „--“ für Seitenbereiche verwenden?

Ja. BibTeX gibt das Feld pages an LaTeX weiter, wo „--“ einen Halbgeviertstrich druckt, das korrekte Zeichen für einen Bereich. Viele Standardstile machen einen einzelnen Bindestrich selbst zu „--“, aber nicht jeder Stil tut das. Deshalb ist „--“ in der Datei die sichere Wahl, und der Bereiniger erledigt das für Sie.

Warum macht BibTeX meinen Titel klein, und wie verhindere ich das?

Viele Stile setzen Artikeltitel in Satzschreibweise und machen jeden Buchstaben klein, der nicht durch geschweifte Klammern geschützt ist, sodass aus DNA dna wird. Ein Wort in geschweifte Klammern zu setzen – {DNA} – schützt es. Die Option zum Schutz der Großbuchstaben im Bereiniger setzt diese Klammern um Akronyme und Wörter mit gemischter Schreibweise oder um jedes großgeschriebene Wort nach dem ersten, wenn Ihre Titel voller Eigennamen sind.

Sind doppelte Zitierschlüssel ein Problem?

Ja. BibTeX verwendet den ersten Eintrag mit einem Schlüssel und ignoriert den Rest, sodass eine Zitierung stillschweigend auf das falsche Werk zeigen kann. Schlüssel, die sich nur in der Großschreibung unterscheiden, werden ebenfalls markiert: BibTeX warnt davor, und biber behandelt sie als zwei Schlüssel. Dieselbe Zitierung kann sich mit jedem anders verhalten.

Wird meine .bib-Datei hochgeladen?

Nein. Die Datei wird vollständig in Ihrem Browser gelesen und bereinigt. Nichts wird an einen Server gesendet, und die bereinigte Kopie entsteht auf Ihrem eigenen Gerät, wenn Sie sie herunterladen.