# Referencer-Handbuch V1.1.6

Referencer ist ein Werkzeug, das Ihnen bei der Verwaltung Ihrer Dokumentensammlung hilft und aus Ihren Dokumenten eine Bibliografie erstellt.

2008
John Spray
2008
Mario Blättermann (mariobl@gnome.org)
Referencer-Entwickler-Team

Das vorliegende Dokument kann gemäß den Bedingungen der GNU General Public License (GPL), Version 2 kopiert, verteilt und/oder modifiziert werden. Eine Kopie der GPL finden Sie unter diesem Link oder in der mit diesem Handbuch gelieferten Datei COPYING.

John
Spray

    	    jcspray@icculus.org

Referencer-Handbuch V 1.1.6
22. Oktober 2008

John Spray

This manual describes version 1.1.6 of Referencer.

## Rückmeldungen

Um Fehler zu melden oder einen Vorschlag zur Anwendung Referencer oder zu diesem Handbuch zu machen, besuchen Sie bitte die Referencer-Website.

## Einführung

Referencer ist ein Werkzeug, das Ihnen bei der Verwaltung Ihrer Dokumentensammlung hilft und aus Ihren Dokumenten eine Bibliografie erstellt. Es wurde für die Anforderungen des Wissenschaftlers und Forschers entwickelt, wobei »Dokument« sich auf »Papier« im Allgemeinen bezieht, obgleich Referencer mit allen von BibTex verarbeitbaren Dokumenten umgehen kann.

## Erste Schritte

### Referencer starten

Sie können Referencer auf folgende Arten starten:

Menü Anwendungen

  Wählen Sie Büroanwendungen Referencer.

Befehlszeile

  Um Referencer aus einer Befehlszeile zu starten, geben Sie folgenden Befehl ein und drücken dann die Eingabetaste:

  `referencer`

### Beim Start von Referencer

Wenn Sie Referencer starten, wird folgendes Fenster angezeigt.

#### Referencer-Startfenster

Shows Referencer main window.

Das Referencer-Fenster enthält folgende Elemente:

Menüleiste

  Die Menüs in der Menüleiste enthalten alle Befehle, die Sie zum Arbeiten mit Dateien in Referencer benötigen.

Werkzeugleiste

  Die Werkzeugleiste ermöglicht Ihnen den schnellen Zugriff auf häufig benutzte Menüeinträge.

Dokumentenliste

  Die Dokumentenliste zeigt eine Liste der Dokumente der Bibliothek an, in welcher Sie gegenwärtig arbeiten. Die Anzeige ist entweder in der Listenansicht oder in der Symbolansicht möglich.

Markenleiste

  Die Markenleiste stellt eine Liste von Marken bereit, die zu Dokumenten hinzugefügt werden können, und zwar in Form von Knöpfen zum Hinzufügen und Entfernen von Marken. Die Dokumentenliste kann anhand bestimmter Marken gefiltert werden, indem Sie die entsprechenden Marken in der Markenleiste auswählen.

## Benutzung

Das grundlegende Anwendungsgebiet von Referencer ist das Bearbeiten von Dokumenten und bibliografischen Daten (Bibliotheken). Allerdings bietet die Anwendung auch einige zeitsparende Funktionen. Die wichtigste davon ist das automatische Ergänzen bibliografischer Informationen (Metadaten) für einige Dokumenttypen.

Wenn Sie eine PDF-Datei zu Ihrer Referencer-Bibliothek hinzufügen, wird diese Datei automatisch nach Schlüsseln wie dem DOI-Code oder arXiv-Kennungen durchsucht. Falls eines davon gefunden wird, benutzt Referencer Ihre Internetverbindung, um die Metadaten für dieses Dokument zu holen.

Falls Sie bereits über eine Sammlung bereits heruntergeladener PDF-Dateien oder Papiere verfügen, erspart Ihnen dies eine Menge Tipparbeit!

Referencer benutzt auch seine Kenntnisse im Umgang mit Papieren zur Bereitstellung praktischer Funktionen wie dem Öffnen einer mit dem Artikel verbundenen Website, oder dem Öffnen des Dokuments selbst. Zusätzlich können Sie zur Kategorisierung der Dokumente Marken hinzufügen. Dadurch lässt sich die Dokumentenbibliothek leichter durchsuchen, indem sie anhand der Marken gefiltert wird.

Referencer ist extrem benutzerfreundlich angelegt, aber um Ihnen den Einstieg so unkompliziert wie möglich zu gestalten, beschreiben die folgenden Unterabschnitte, wie Sie Referencer benutzen.

### Verwendung von Referencer mit BibTex

Referencer lädt nicht nur BibTex-Dateien und bearbeitet diese, sondern verwaltet seine eigene Dokumentenbibliothek. Wenn Sie Ihre Bibliothek in einem LaTex-Dokument verwenden wollen, können Sie durch Referencer eine BibTex-Datei erzeugen lassen. Wählen Sie hierzu Bibliothek BibTex exportieren. Standardmäßig schließt dies alle Dokumente in Ihrer Bibliothek ein. Falls Sie nur einige Dokumente exportieren wollen, können Sie das Feld Auswahl: im Exportdialog verwenden, um den Export auf bestimmte Dokumente zu beschränken. Um immer wiederkehrendes Exportieren nach Änderungen zu vermeiden, können Sie Referencer anweisen, nach jeder Änderung die BibTex-Datei neu zu speichern. Wählen Sie hierzu Bibliothek BibTex-Datei verwalten

Referencer wandelt automatisch spezielle Zeichen (z.B. `ß`) in die LaTex-Entsprechungen um (im genannten Fall `\ss`). Abhängig von dem in Ihren Arbeiten verwendeten BibTex-Stil könnte sich die Großschreibung im Text der LaTex-Ausgabe von der in Ihrer Referencer-Bibliothek unterscheiden, weil das den Veröffentlichern ermöglicht, ihre eigenen Großschreibungs-Schemen durchzusetzen. Falls Sie die Großschreibung in Ihren Arbeiten exakt so erhalten möchten wie in Ihrer Bibliothek, dann können Sie dazu die Option Großschreibung schützen im BibTex-Exportdialog verwenden.

Falls sie bereits über eine BibTex-Datei verfügen, können Sie diese durch Referencer importieren lassen. Wählen Sie Bibliothek Importieren... aus der Menüleiste.

Das Importieren und anschließende Exportieren als BibTex-Datei garantiert (oder beabsichtigt) nicht, dass Sie exakt die gleiche Datei erhalten wie vor dem Import: Referencer ist kein BibTex-Editor!

Informationen wie die Dateinamen der Dokumente und die Markierungen sind in den BibTex-Dateien nicht enthalten. Sie sollten stets Ihre Referencer-Bibliotheksdatei als maßgebende Kopie verwenden.

### Hinzufügen von Dokumenten

#### Hinzufügen von Dokumenten nach Datei oder Ordner

Wählen Sie Dokumente Datei hinzufügen… aus der Menüleiste.

Falls Sie Referencer über vorhandene Dokumentdateien in Kenntnis setzen wollen, können Sie eine oder mehrere Dateien oder auch einen ganzen Ordner hinzufügen. Wählen Sie Dokumente Ordner hinzufügen …, und Referencer erstellt Einträge für jede Datei. PDF-Dateien werden gelesen, und Referencer tut sein bestes, um die Metadaten für Sie hinzuzufügen.

Wenn Sie einen Ordner oder Dateien hinzufügen, werden Objekte namens ».svn«, »CVS«, Dateien mit den Erweiterungen ».bib« oder ».reflib» sowie Dateien, deren Namen mit ».« beginnen, automatisch übersprungen. Diese Dateien können jedoch individuell hinzugefügt werden.

#### Hinzufügen von Dokumenten anhand des DOI-Codes

Wählen Sie Dokumente Dokument mit DOI hinzufügen… aus der Menüleiste.

Falls Sie über den DOI-Code für ein Papier verfügen, können Sie sich die Mühe der Eingabe der Metadaten ersparen, indem Sie Referencer anhand des DOI-Codes für Sie nach den Metadaten suchen lassen.

#### Manuelles Hinzufügen von Dokumenten

Wählen Sie Dokumente Leere Referenz hinzufügen… aus der Menüleiste.

Nicht zuletzt stellt Referencer auch eine einfache Oberfläche für das manuelle Erzeugen eines Dokuments und die Eingabe der Metadaten bereit. Ein Dokument ohne Informationen wird erzeugt und ein Eigenschaftsdialog geöffnet, in dem Sie einen Namen für das Dokument und einige Metadaten eingeben können.

#### Hinzufügen von Dokumenten aus einer BibTeX/EndNote/Refer-Datei

Wählen Sie Bibliothek Importieren… aus der Menüleiste.

Ihre vorhandenen Bibliografie-Dateien und auch Schnipsel aus Websites können importiert werden. Die Objekte aus solchen Dateien werden geladen und zur gegenwärtig geöffneten Bibliothek hinzugefügt.

#### Hinzufügen von Dokumenten mittels Kopieren und Einfügen

Choose Edit Paste BibTex from the menubar.

Um bequem Referenzen aus dem Web oder Referenzen aus einer vorhandenen BibTex-Datei zu importieren, können Sie diese einfach kopieren und in Referencer einfügen. Diese Referenzen werden auf die gleiche Weise hinzugefügt, als wären sie aus einer Datei importiert worden.

### Verwendung verschiedener Dokumenttypen und -felder

Die Benutzeroberfläche von Referencer ist für den Umgang mit wissenschaftlichen Papieren optimiert. Daher ist der vorgegebene Dokumenttyp »Article« und Felder wie Title, Authors, Journal und Volume werden angezeigt. Andere Dokumenttypen können im Eigenschaftsdialog gewählt werden. Um diesen zu öffnen, wählen Sie Dokumente Eigenschaften aus der Menüleiste.

Falls nicht der von Ihnen gewünschte BibTex-Typ angezeigt wird, geben Sie ihn einfach ein und er wird unverändert beim Exportieren Ihrer BibTex-Datei übernommen. Einige Dokumenttypen erfordern zusätzliche Metadatenfelder, beispielsweise sollten »Book«-Dokumente über ein »Editor«-Feld verfügen. Diese können Sie durch Ausklappen des Abschnitts Zusätzliche Felder im Eigenschaftsdialog und Anklicken des Symbols Neu hinzufügen. Um Daten in das neue Feld einzugeben, wählen Sie es aus und klicken Sie auf das Symbol Bearbeiten.

## Markieren und Suchen

Das Markieren ermöglicht Ihnen die Kategorisierung Ihrer Dokumente. Im Gegensatz zur traditionellen hierarchischen Ordnerstruktur erlaubt ein auf Markierungen basierendes System, ein Dokument mehreren einander überlappenden Kategorien zuzuordnen. Beispielsweise verfügen Sie über Marken wie »Physik« und »Biologie« sowie eine weitere namens »Wichtige Papiere«. Falls es sich dabei um Ordner handelt, müssen Sie willkürlich festlegen, wo Sie ein Papier einordnen wollen. Hier jedoch können Sie sowohl »Physik« als auch »Wichtige Papiere« verwenden, und wenn die Wichtigkeit nicht mehr gegeben ist, dann entfernen Sie einfach die Marke »Wichtige Papiere«.

Sobald Sie durch Marken Marke erzeugen … eine Marke erzeugt haben, erscheint in der unteren Hälfte der Markenleiste ein Kontrollkästchen. Die Markenleiste können Sie aktivieren oder deaktivieren, indem Sie die Option Ansicht Markenleiste anzeigen wählen. Nach der Auswahl eines oder mehrerer Dokumente setzen oder entfernen Sie eine Marke, indem Sie in das Kontrollkästchen klicken.

Wenn Sie einige Dokumente markiert haben, möchten Sie vielleicht die Ansicht nach Marken filtern. Klicken Sie dazu auf eine Marke in der Liste in der oberen Hälfte der Markenleiste. Um mehrere Marken auszuwählen, halten Sie dazu die Strg-Taste gedrückt.

Als Ergänzung des Marken-Systems wird oberhalb der Dokumentenansicht ein Suchfeld angezeigt. Wenn Sie hier Text eingeben, werden nur Dokumente angezeigt, die diesen Text enthalten. Die Suche berücksichtigt nur die Felder Title, Authors und Key des Dokuments.

## Plugins

Zusätzliche Funktionalität kann Referencer mit Hilfe der vielseitigen Skriptsprache Python verliehen werden. Seit Version 1.1 werden zwei Arten von Plugins unterstützt: Metadata fetcher-Plugins und Document action-Plugins. Das erstere ist ein Skript, das nach Metadaten des DOI-Codes in einer Internet-Datenbank sucht, das letztere dient zur Bearbeitung der Metadaten eines vorhandenen Dokuments auf verschiedene Weise.

Interessierte Entwickler sollten den Referencer-Quellcode herunterladen. Im Ordner plugins/ befinden sich Beispiele sowie in plugins/README eine Kurzanleitung.

## Info zu Referencer

Referencer und dieses Handbuch wurden von John Spray (jcspray@icculus.org) geschrieben. Einige Beiträge zu diesem Handbuch kamen von Mario Blättermann (mario.blaettermann@t-online.de. Weitere Informationen über Referencer sowie die aktuellste Dokumentation finden Sie auf der Projekt-Website.

Dieses Programm ist freie Software. Sie können es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht, weitergeben und/oder modifizieren, entweder gemäß Version 2 der Lizenz oder (nach Ihrer Option) jeder späteren Version. Eine Kopie dieser Lizenz ist in dieser Dokumentation enthalten, eine weitere in der Datei COPYING, die im Quellcode dieses Programms enthalten ist.