Verwendung der mit Pybliographer mitgelieferten Skripte.
Zoltán Kóta
zoltank@gmail.com
Frédéric Gobry
frederic.gobry@epfl.ch

Creative Commons Share Alike 3.0

# Vorhandene Skripte

Einige Skripte werden bereits mit Pybliographer mitgeliefert, sowohl einfache Beispiele als auch nutzbare Werkzeuge. Sie sind recht knapp gehalten und sollten mit etwas Basiswissen in Python verständlich sein.

# pybcheck

          	Dieses Werkzeug überprüft anhand einer Liste von Dateien oder Ordnern, ob diese korrekt sind (Syntax, keine Einträge mit dem gleichen Schlüssel usw.).

Die Ausgabe können Sie direkt in den »Compile buffer« von Emacs weiterleiten und somit direkt zu den entdeckten Fehlern springen. Geben Sie hierzu M x compile ein, anschließend den Befehl pybcheck ihre_dateien und springen Sie mit der mittleren Maustaste direkt in die fehlerhafte Datei.

# pybcompact

    	Dieses Werkzeug entpackt die in einem LaTex-Dokument enthaltenen Zitate und erstellt eine BibTex-Datei, welche diese enthält.

Üblicherweise werden Bibliografien in einer oder mehreren großen BibTeX-Dateien gespeichert und bibtex entpackt die in einem LaTeX-Dokument verwendeten Einträge. Gelegentlich ist es aber bequemer, ein Komplettpaket zu erstellen, um es beispielsweise an Andere weiterzugeben oder zu speichern. Dieses Paket enthält dann auf das Wesentliche beschränkte minimalisierte BibTeX-Datei, welche exakt aus den in LaTeX verwendeten Einträgen besteht. Dieses Werkzeug tut genau das: Es liest eine LaTeX-Datei ein (.aux) und entpackt aus den angegebenen BibTex-Datenbanken die entsprechenden Einträge.

# pybconvert

    	Dieses Werkzeug wandelt ein Pybliographer-Format in ein anderes um.

Die grundlegende Syntax ist erfreulich einfach. Um beispielsweise Refer in BibTex umzuwandeln, führen Sie Folgendes aus:

    	bash$ pybconvert refer..bibtex toto.refer toto.bib

# pybformat

    	Dieses Skript erstellt eine Bibliografie gemäß einem angegebenen Stil und gibt diese in einem spezifischen Format (wie HTML, LaTeX usw.) aus, so wie sie in einem Dokument erscheinen sollte.

Die grundlegende Form des Befehls lautet:

    	bash$pybformat [Optionen] Datenbank...

Dieser Befehl ohne Optionen verwendet den Stil namens alpha zur Erstellung einer Bibliografie im Textformat. Zur Erstellung dieser Dokumente stehen verschiedene Optionen zur Verfügung:

--style=... oder -s ...: legt einen bibliografischen Stil fest. Dies kann ein vollständiger Pfad zu einer existierenden XML-Datei sein oder ein Name, nach dem an Standardorten gesucht wird. Vorgabe ist Alpha.

--format=... oder -f ...: legt ein Ausgabeformat fest (HTML, LaTeX, Raw, Text, Textau, Textnum). Vorgabe ist Text. Textau und Textnum sind leicht angepasste Versionen von Text. Siehe für weitere Details.)

--output=... oder -o ...: legt eine Namen für die Ausgabedatei fest. Vorgabe ist STDOUT.

--header=... oder -H ...: legt eine Datei fest, die der Ausgabedatei vorangestellt wird.

--footer=... oder -F ...: legt eine Datei fest, die der Ausgabedatei angehängt wird.

--list=output oder -l output: listet verfügbare Ausgabeformate auf

# pybtex

    	Dieses Werkzeug sucht nach Zitaten in einem LaTeX-Dokument und erstellt eine LaTeX-Bibliografiedatei.

Dieses Werkzeug liest eine LaTex-Datei (.aux), entpackt die korrespondierenden Einträge aus den angegebenen BibTex-Datenbanken und erstellt wiederum eine LaTex-Datei (.bbl).

Der Befehl folgt der Form

    	bash$ pybtex latexfile [bibtexfiles...]

# pybtext

    	Dieses Werkzeug verarbeitet eine Textdatei, welche Zitate enthält und hängt eine Bibliografie gemäß einem angegebenen Stil an.

Das Skript sucht nach Zitaten wie [key] or [key1,key2...] in einer Textdatei. Beispiel: »Dies ist ein Textfragment mit durch Pybliographer eingefügten Zitaten [AKM95,MPJ+03]«. Zunächst wird anhand der in einer Textdatei gefundenen Schlüssel eine Referenzliste erzeugt. Mit Hilfe eines entsprechenden Stils (siehe unten) werden die Datenbankschlüssel im Textkörper durch die vom Stilmodul erzeugten neuen Schlüssel ersetzt. Zum Schluss wird die Referenzliste an den Text angehängt, wodurch eine neue Datei entsteht.

Die Schlüssel der ausgewählten Einträge können durch Kopieren und Einfügen oder Ziehen und Ablegen direkt aus Pybliographer in einen Texteditor oder in ein Terminalfenster kopiert werden.

Die grundlegende Form des Befehls lautet:

    	bash$ pybtext [-o outputfile] [-s style] textfile bibfiles...

Dieser Befehl ohne Optionen verwendet den Stil namens Abbrev und textfile.pyb als Ausgabedatei der Verarbeitung. textfile ist der Name der zu verarbeitenden Datei und bibfiles bezeichnet eine oder mehrere bibliografische Datenbankdateien.

Es gibt drei verschiedene Stile, die für pybtext entworfen wurden. Durch abbrvbib werden Schlüssel generiert wie jene, die in der Datenbank definiert sind. Mit dem Stil abbrvau können Schlüssel des Typs »author-year« erzeugt werden, zum Beispiel »Jackson et al., 2004«. Mit abbrvnum erzeugt das Skript eine einfache nummerierte Liste. Für abbrvau und abbrvnum werden die Formate Textau bzw. Textnum benutzt. Es handelt sich dabei um einfache Anpassungen des Text-Formats, die für diese Stile optimiert sind. Durch die anderen Stile (Alpha, Abbrev or apa4e) wird der Textkörper selbst nicht verarbeitet, aber eine Referenzliste in einer zum verwendeten Stil korrespondierenden Form angehängt.