Erstellen einer Bibliographie mit BibTeX und BibDesk

Einführung

Für kürzere Dokumente reicht die thebibliography Umgebung für ein Literaturverzeichnis. Diese Funktionalität wird im Tutorial (Kapitel «Bibliographie») vorgestellt.

Bei längeren Dokumenten ist es komfortabler mit BibTeX zu arbeiten. Dabei werden die Literaturangaben in einer Art Datenbank verwaltet. Das hat unter anderem den Vorteil, dass die gleichen Literaturangaben für mehrere Dokumente nur einmal erfasst werden müssen.

Hier wird BibDesk für die Datenbank-Verwaltung vorgestellt, es gibt aber auch andere Möglichkeiten (beispielsweise EndNote). Mit den Literaturangaben in der Datenbank (.bib-Dokument) werden dann von BibTeX die Literaturverweise in das LaTeX-Dokument (genauer das .aux Dokument) eingefügt.

BibDesk

BibDesk ist ein Open Source (kostenlos) Programm das zur Verwaltung der Literatur-Datenbank verwendet werden kann. Hier wird nur eine Grundfunktion gezeigt, das Programm leistet noch einiges mehr. Weitere Informationen sind im Dokument README-BibDesk… im BibDesk Ordner zu finden.

Download und Installation

Von http://bibdesk.sourceforge.net/ aus dem Link auf die Download-Page folgen. Dann das ….dmg.gz Disk Image (komprimiert) herunterladen. Im Normalfall wird nach dem Download automatisch StuffIt Expander aufgerufen um das Disk Image (….dmg) zu dekomprimieren und anschliessend mit Disk Copy gemountet (als Volume auf den Schreibtisch gebracht). Falls das nicht automatisch abläuft: beide Hilfsprogramme (StuffIt Expander und Disk Copy) finden sich im Ordner /Programme/Dienstprogramme (oder /Applications/Utilities) und es reicht ein Drag-n-Drop (ziehen und loslassen) des Dokuments auf das entsprechende Programm. Das gemountete Disk Image kann bei gedrückter alt-Taste einfach im Finder in den Ordner /Programme (oder einen beliebigen anderen Ort) kopiert werden. Damit wäre BibDesk installiert.

Einen Datenbank erstellen

Beispiel eines Eintrags in BibDesk.

Beim Öffnen von BibDesk sollte automatisch eine neue Datenbank erstellt werden. Wenn nicht kann via Menü File → New Bibliography eine erstellt werden. Mit Klick auf New in der Symbolleiste wird ein neuer Eintrag erstellt. Ausgefüllt kann das wie im obigen Beispiel (Abbildung) aussehen. Welche Attribute angegeben werden müssen ist vom Dokument-Typ (Buch, Paper, URL, etc.) und eventuellen Vorgaben abhängig. Der TeX cite key wird im LaTeX-Dokument für den \cite{} Befehl benötigt.

Tipp: BibTeX ändert standardmässig die Gross-/Kleinschreibung beim Titel (alles ausser dem ersten Wort wird klein geschrieben). Um das zu verhindern kann der Titel in geschweifte Klammern gesetzt werden.

Den Eintrag und die Datenbank sichern. Im Beispiel wird die Datenbank unter dem Namen cite-beispiel (der Suffix .bib sollte automatisch angehängt werden) gesichert.

Einfügen des Literaturverzeichnisses

Folgend ein kleines Beispiel-Dokument:

\documentclass[pdftex,a4paper]{scrreprt} \usepackage[ngerman]{babel} \usepackage[applemac]{inputenc} \begin{document} Diese Aussage stammt aus einer Quelle und sollte daher mit einem Literaturverweis versehen werden.\cite{isfrs03} \appendix \bibliographystyle{plain} \bibliography{cite-beispiel} \end{document}

Die verwendeten Befehle:

\cite{}

Mit diesem Befehl wird der Literaturverweis eingefügt. Argument in den geschweiften Klammern ist der TeX cite key des entsprechenden Datenbank-Eintrags.

\appendix

Dieser Befehl ist nicht wirklich notwenig. Die Nummerierungen werden zurückgesetzt und einem Anhang entsprechend weitergeführt.

\bibliography{}

In den geschweiften Klammern wird das mit BibDesk erstellte .bib-Dokument (ohne den Suffix .bib) angegeben. Es können auch mehrere Datenbank-Dokumente angegeben werden (mit Komma getrennt).

\bibliographystyle{}

Mit diesem Befehl wird bestimmt, wie das Literaturverzeichnis formatiert wird und wie die Bezüge im Text aussehen. Einige der häufig verwendeten Styles:

plain

Das Literaturverzeichnis wird nach den Autorennamen alphabetisch sortiert. Als Kennzeichen werden fortlaufende Nummern verwendet.

unsrt

Unterscheidet sich in der Sortierung des Literaturverzeichnisses von plain: Die Einträge werden nach dem vorkommen im Text sortiert.

alpha

Unterscheidet sich durch die Kennzeichen von plain: Statt fortlaufenden Nummern wird eine Kombination aus Abkürzung des Autorennamen und Jahreszahl verwendet

Daneben werden standardmässig noch weitere Styles installiert (innerhalb der teTeX-Installation in texmf/bibtex/bst/) und es können auch weitere Styles heruntergeladen werden (ftp://mirror.switch.ch/mirror/tex/biblio/bibtex/contrib/).

Setzen des Dokuments

Auswahl von BibTeX in TeXShop.

Für das vollständige Setzen eines Eingabe-Dokuments mit einem BibTeX-Literaturverzeichnis sind folgende Schritte notwendig:

1. Normales Setzen (erstellen des PDFs aus dem Eingabe-Dokument).
2. Dann (wie in der obigen Abbildung gezeigt) BibTeX auswählen und wieder setzen. Beim verwendeten Beispiel sieht die Ausgabe im console Fenster folgendermassen aus:

   This is BibTeX, Version 0.99c (Web2C 7.4.5)
   The top-level auxiliary file: beispieldokument.aux
   The style file: plain.bst
   Database file #1: cite-beispiel.bib

3. Setzen (wieder als LaTeX)
4. Nochmals setzen. Das resultierende PDF-Dokument dann alle Verweisen und das Literaturverzeichnis enthalten.

Natürlich ist das Prozedere nur notwendig wenn man das vollständige Dokument erhalten will, also typischerweise wenn man einen Bericht fertig hat.