3 % - Wiki-Seiten 'Searching with regular expressions' und 'Translating JabRef' übersetzen und einbinden
4 % - [2.4 beta] Plugin.html ergänzen
5 % - [2.4 beta?] SQLExport.html ergänzen
7 \documentclass[10pt,normalheadings,ngerman]{scrartcl}
8 \usepackage[T1]{fontenc}
9 \usepackage[latin1]{inputenc}
11 \setcounter{secnumdepth}{2}
12 \setcounter{tocdepth}{4}
15 %%%%% author, version of file %%%%%
16 \newcommand{\versiondate}{in Bearb.}%11.\,12.\,2007
17 \def\FileAuthor{Dominik Waßenhoven}
18 \def\FileTitle{\jabrefversion{} Benutzerhandbuch}
20 %%%%% Page Dimensions %%%%%
22 \geometry{verbose,a5paper,tmargin=2cm,bmargin=2cm,lmargin=1cm,rmargin=1cm}
26 \usepackage{longtable}
35 %%%%% LyX command %%%%%
36 \providecommand{\LyX}{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@\xspace}
42 %backgroundcolor=\color{pyellow},
44 basicstyle=\ttfamily,%\small,
45 commentstyle=\color{red},
46 keywordstyle=, % LaTeX-Befehle werden nicht fett dargestellt
47 numbers=none,%left/right
48 %numberstyle=\tiny\lnstyle,
50 %numberblanklines=false,
55 escapeinside={(*}{*)},
56 belowskip=\medskipamount,
57 prebreak=\mbox{$\hookleftarrow$}% "geklaut" vom scrguide (KOMA-Script)
60 %%%%% Environment "revhist" (for revision history) %%%%%
61 \newenvironment{revhist}[1]
63 \list{--}{\setlength\itemsep{0pt}\setlength{\parsep}{0pt}}}
66 %%%%% PDF 1.2 for Acrobat 3 onwards %%%%%
67 \pdfoptionpdfminorversion 2
70 \usepackage[dvipsnames]{xcolor}
71 \definecolor{dkblue}{rgb}{0,0.1,0.5} % dark blue
72 \definecolor{dkred}{rgb}{0.66,0.04,0.04} % dark red
73 \definecolor{pyellow}{rgb}{1,0.97,0.75} % pale yellow
75 %%%%% New commands %%%%%
77 \DeclareRobustCommand{\jabref}{%
78 \texorpdfstring{% TeX string
79 \raisebox{-.32ex}{\color{dkred}J}\kern-.06em%
80 \hbox{$\m@th$% %% force math size calculations
81 \csname S@\f@size\endcsname
83 \math@fontsfalse\selectfont
84 \color{orange}A\kern-.025emB}\-%
85 \hbox{\kern-.06em\-R\hspace{-.08em}%
86 \raisebox{.16ex}{$\m@th$% %% force math size calculations
87 \csname S@\f@size\endcsname
89 \math@fontsfalse\selectfont
90 E\kern-.025emF}}\xspace}%
91 {JabRef\xspace}% PDF string
95 \newcommand{\versionnr}{\texorpdfstring{2.3.1}{2.3.1}} %
96 %%% JabRef logo with version nr
97 \newcommand{\jabrefversion}{\jabref~\versionnr}
99 \newcommand{\bibtex}{\texorpdfstring{Bib\kern-.125em\TeX\xspace}{BibTeX}}
100 %%% for Menu references
101 \newcommand{\menu}[1]{\texorpdfstring{{\color{dkred}\textit{#1}}}{#1}}
103 \newcommand{\msep}{{\color{dkred}\textit{\guilsinglright}}\xspace}
104 %%% yellow box with dark blue text
105 \newcommand{\tip}[2][Tipp: ]{%
107 \colorbox{pyellow}{\parbox{0.85\textwidth}{%
108 \color{dkblue}\textit{#1}#2}}%
112 \newcommand{\verfasser}[1]{%
114 \colorbox{pyellow}{\parbox{0.7\textwidth}{%
115 \color{dkblue}\textit{Dieser Abschnitt stammt von #1}}}%
121 \newcommand{\faq}[2]{\refstepcounter{faq}%
122 \medskip\noindent\colorbox{pyellow}{\parbox{0.9\textwidth}{%
123 \hangpara{0.11\textwidth}{1}%
124 \color{dkblue}Frage \thefaq: \textit{#1}}}\par\smallskip%
125 \begin{hangparas}{0.11\textwidth}{0}%
130 %%% for CTAN references
131 \newcommand{\ctan}[1]{%
132 {\textsc{ctan}: \color{dkred}#1}%
136 \usepackage{scrpage2}
137 \pagestyle{scrheadings}
138 \ihead{\FileTitle{} (\versiondate{})}
144 \automark[section]{section}
148 \addtokomafont{sectioning}{\rmfamily} % Headings with serifs
149 \renewcommand{\headfont}{\normalfont\itshape} % Headlines italic, not slanted ***
150 \usepackage[scaled=.83]{beramono}
152 %%%%% Other stuff %%%%%
153 \deffootnote{1.5em}{1em}{\makebox[1.5em][l]{\thefootnotemark}}
154 %\usepackage{microtype} % micro typography
156 %%%%% Mini TOCs %%%%%
158 \mtcsetrules{secttoc}{off}
159 %\mtcsetdepth{secttoc}{3}
160 \mtcsetfont{secttoc}{subsection}{}
161 %\mtcsettitle{secttoc}{In diesem Abschnitt}
162 %\mtcsettitlefont{secttoc}{\itshape}
167 %%%%% Bibliography %%%%%
174 \renewcommand{\biblnfont}{} % Autoren-Nachnamen (Standard: fett)
175 \renewcommand{\bibfnfont}{} % Autoren-Vornamen (Standard: fett)
176 \renewcommand{\bibelnfont}{} % Hrsg-Nachnamen (Standard: fett)
177 \renewcommand{\bibefnfont}{} % Hrsg-Vornamen (Standard: fett)
178 \renewcommand{\bibtfont}{\textit} % Titel (Bücher)
179 \renewcommand{\bibbtfont}{\textit} % Titel (Sammelwerke)
180 \renewcommand{\bibjtfont}{\textit} % Titel (Zeitschriften)
181 \renewcommand{\bibpldelim}{(} % runde Klammern bei...
182 \renewcommand{\bibprdelim}{)} % ...Zeitschriften (Jahr)
183 \renewcommand{\ajtsep}{} % kein Komma nach Zs-Titeln
184 \renewcommand{\biburlprefix}{\jblangle\textsc{url: }} % Klammer und Text vor einer URL (Standard: "URL: ")
186 \renewcommand{\bib@heading}{\addsec{Kommentiertes Literaturverzeichnis}}
189 \usepackage{hyperref}
196 pdftitle={JabRef \versionnr{} Benutzerhandbuch},%
197 pdfsubject={Einführung in die Benutzung von JabRef},%
198 pdfkeywords = {BibTeX, Bibliographie, Literaturverwaltung},%
199 pdfauthor={\FileAuthor},%
202 bookmarksopenlevel=1,%
211 For-mat-erken-nung% verhindert Trennung "Formater-kennung"
217 %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%%
220 \subject{\includegraphics[scale=.5]{../../images/JabRef-icon-48}}
223 \title{\jabrefversion{}\\
227 \author{Dominik Waßenhoven\\
228 {\normalsize (\href{mailto:domwass@users.sourceforge.net}{domwass@users.sourceforge.net})}}
231 \date{\small \versiondate}
236 \jabref ist eine grafische Java-Anwendung zur Bearbeitung von \bibtex{}-Dateien
237 (.bib). Mit \jabref können Literaturangaben in Gruppen organisiert
238 und mit einem einfachen Klick die Ansicht auf eine einzelne Gruppe,
239 eine Schnittmenge von Gruppen oder die Gesamtmenge mehrerer Gruppen
240 eingegrenzt werden. \jabref kann Literaturangaben sortieren (für
241 alle Standard-\bibtex{}-Felder) und automatisch \bibtex{}-Keys erzeugen.
242 Auch Links zu PDF-Dateien oder Webseiten können mit \jabref einfach
245 \jabref kann verschiedene Dateiformate importieren und exportieren,
246 außerdem können die Exportfilter angepasst werden. \jabref kann
247 auch von der Kommandozeile gestartet werden, um von einem Importformat
248 in ein Exportformat zu konvertieren, ohne die grafische Benutzeroberfläche
253 \begin{center}{\scriptsize Copyright \textcopyright{} 2005--2007, Dominik
256 {\scriptsize Der Inhalt dieses Handbuchs wird unter den Bedingungen der Creative Commons Public License ">Namensnennung"=NichtKommerziell"=Weitergabe unter gleichen Bedingungen 2.0 Deutschland"< zur Verfügung gestellt. Um den Lizenzvertrag anzusehen, gehen Sie bitte zu \href{http://creativecommons.org/licenses/by-nc-sa/2.0/de/}{http://creativecommons.org\slash{}licenses\slash{}by-nc-sa\slash{}2.0\slash{}de\slash{}} oder schicken einen Brief an Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA. \par}\end{spacing}
259 \thispagestyle{empty}
263 \faketableofcontents{}
270 \subsection{Über dieses Handbuch}\label{subsec:about}
272 Dieses Handbuch will eine kurze Einführung zu den nützlichsten Funktionen
273 von \jabref bieten, ohne dabei eine erschöpfende Beschreibung aller
274 Funktionalitäten dieser Software zu liefern. \emph{}\jabref ist
275 das Ergebnis der Verschmelzung von \emph{BibKeeper} und \emph{JBibtexManager}.
276 Weitere Informationen gibt es im Programm selbst unter \menu{Hilfe} \msep{} \menu{Inhalt}
277 sowie im Internet unter \url{http://jabref.sourceforge.net}. Wer dann immer noch keine Antwort auf seine Frage oder keine Lösung zu seinem Problem hat, kann über die Foren oder die Mailingliste auf der Projektseite bei Sourceforge weitere Hilfe bekommen (siehe dazu den Abschnitt \nameref{sec:faq}).
279 Die Anleitungen basieren auf den Hilfeseiten des Programms. Da dieses
280 Handbuch und die Hilfeseiten unabhängig voneinander gepflegt und aktualisiert
281 werden, müssen die Beschreibungen jedoch nicht immer übereinstimmen.
282 Im Zweifel sind die Hilfeseiten des Programms aktueller als die hier
283 vorgelegte Beschreibung.
285 Am Anfang jedes Abschnitts sollte~(!) zunächst stehen, wie man zur
286 entsprechenden Funktion gelangt (d.\,h. über welches Menü und mit
287 welchem Tastenkürzel). Menü-Einträge werden in einer kursiven, dunkelroten
288 Schrift dargestellt (Beispiel: \menu{Menü} \msep{} \menu{Untermenü}).
289 Besondere Hinweise und Tipps werden in einem gelb hinterlegten Kasten
290 mit dunkelblauer Schrift dargestellt. Hyperlinks sind ebenfalls dunkelblau
291 und anklickbar~-- das gilt sowohl für die Navigation innerhalb des
292 Dokuments als auch für Links ins Internet.
294 Wenn Ihnen in diesem Handbuch Fehler auf"|fallen oder wenn Sie Anregungen zum Handbuch haben, würde ich mich über eine kurze Nachricht per \href{mailto:domwass@users.sourceforge.net}{E-Mail} freuen. Über den Stand und die einzelnen Versionen dieses Handbuchs gibt der Abschnitt ">\nameref{RevisionHistory}"< Auskunft.
296 \subsection{Einführung in \bibtex{}}
298 \label{BibtexHelp}\tip[]{\jabref hilft Ihnen bei der Arbeit mit
299 Ihren \bibtex{}-Dateien, aber es müssen dennoch Regeln beachtet werden,
300 wenn Sie Ihre Einträge bearbeiten. Nur so kann sichergestellt werden,
301 dass \bibtex{} Ihre Datei richtig verarbeiten kann.}
303 \noindent Im Folgenden können nur einige allgemeine Hinweise gegeben werden. Ausführlichere Einführungen und weitere Erläuterungen zu \bibtex{} finden Sie bei den im \hyperlink{bibliography}{kommentierten Literaturverzeichnis} aufgeführten Beiträgen.
305 \subsubsection{\bibtex{}-Eintragstypen}
306 \label{Eintragstypen}
307 Je nachdem, ob sie ein Buch, einen Zeitschriftenartikel, einen Sammelband oder ein anderes Dokument referenzieren möchten, hält \bibtex{} unterschiedliche Eintragstypen bereit. Hier folgt eine kurze Aufstellung der meist gebrauchten Eintragstypen.\footnote{Vgl. \cite[12--17]{Markey2005}; \cite[7--9]{btxdoc}.} Manche Paktete (wie ">jurabib"<) stellen weitere Eintragstypen zur Verfügung, die Sie natürlich auch in \jabref verwenden können (mehr dazu im Abschnitt \nameref{CustomEntriesHelp}). Für die Verwendung dieser spezifischen Typen schauen Sie bitte in die jeweilige Dokumentation.
310 \item \emph{@article}\\
311 Ein Artikel in einer Zeitschrift.
313 Ein Buch, von einem Verlag veröffentlicht.
314 \item \emph{@booklet}\\
315 Ein gedrucktes und gebundenes Buch ohne Verlag.
316 \item \emph{@conference}\\
317 Siehe \emph{@inproceedings}
318 \item \emph{@inbook}\\
319 Ein Teil eines Buches, z.\,B. ein Kapitel oder Abschnitt.
320 \item \emph{@incollection}\\
321 Ein Beitrag aus einem Buch, z.\,B. einem Sammelband.
322 \item \emph{@inproceedings}\\
323 Ein Artikel aus einem Tagungsbericht, der nicht zwangsläufig in einem Verlag erschienen ist.
324 \item \emph{@manual}\\
325 Eine Dokumentation oder ein Handbuch.
326 \item \emph{@mastersthesis}\\
327 Eine Diplom-/Magisterarbeit.
329 Dieser Typ kann benutzt werden, wenn nichts anderes passt.
330 \item \emph{@phdthesis}\\
331 Eine (unveröffentlichte) Dissertation.
332 \item \emph{@proceedings}\\
334 \item \emph{@techreport}\\
335 Von einer Universität oder Institution (normalerweise in einer Reihe) veröffentlichter Bericht.
336 \item \emph{@unpublished}\\
337 Ein Dokument mit Autor und Titel, unveröffentlicht.
340 \subsubsection{\bibtex{}-Felder}
342 Es gibt viele unterschiedliche Felder in \bibtex{} und einige zusätzliche Felder, die Sie in \jabref einsetzen können.
343 Grundsätzlich können Sie \LaTeX{}-Befehle in Feldern, die Text beinhalten, einsetzen. \bibtex{} wird Ihr Literaturverzeichnis automatisch formatieren und je nach \bibtex{} style (Stildatei .bst) Großbuchstaben verkleinern. Um sicherzustellen, dass Anfangsbuchstaben groß bleiben, müssen Sie die Wörter in geschweifte Klammern einschließen, wie im Wort \{Belgien\}.\footnote{Die meisten deutschen \bibtex{}-Stile behalten die Großbuchstaben ohnehin bei.}
345 Hinweise zu einigen Feldtypen:
347 \item \emph{Bibtexkey}\\
348 Eine eindeutige Bezeichnung, um sich in \LaTeX{}-Dokumenten auf den Eintrag beziehen zu können. Beachten Sie, dass der Bibtexkey genau mit dem Verweis im \LaTeX{}-Dokument übereinstimmen muss (auch die Groß-/Kleinschreibung).
349 \item \emph{address}\\
350 Der Ort des \emph{Verlags} oder einer anderen Institution.
351 \item \emph{annote}\\
353 Dieses Feld wird von den Standard-Bibliographiestilen nicht verwendet, kann aber bei einigen Stilen benutzt werden, um eine kommentierte Literaturliste zu erstellen.
354 \item \emph{author}\\
355 Dieses Feld sollte alle Autoren Ihres Eintrags enthalten. Die Namen werden durch das Wort \texttt{and} getrennt, auch wenn es mehr als zwei Autoren gibt. Jeder Name kann in zwei gleichwertigen Formen notiert werden:
357 \item Donald E. Knuth \emph{oder} Knuth, Donald E.
358 \item Eddie van Halen \emph{oder} van Halen, Eddie
360 Die zweite Form sollte für Autoren mit zwei oder mehr Nachnamen benutzt werden, um zwischen dem mittleren und dem Nachnamen zu unterscheiden.
361 \item \emph{booktitle}\\
362 Der Titel eines Buches, aus dem ein Teil zitiert wird. Falls Sie ein Buch zitieren wollen, nehmen Sie für den Titel stattdessen das \texttt{title}-Feld.
363 \item \emph{chapter}\\
364 Eine Kapitelnummer (oder Abschnittsnummer oder sonstige Nummer).
365 \item \emph{crossref}\\
366 Der \texttt{key} eines Eintrags, auf den ein Querverweis gesetzt wird. Damit lassen sich beispielsweise die Daten eines Sammelbandes in einem Eintrag für einen Aufsatztitel wiederverwenden, ohne sie bei jedem Aufsatztitel explizit einzutragen. Die Funktionalität von \texttt{crossref} ist jedoch nicht in jedem Fall praktikabel.
367 \item \emph{edition}\\
368 Die Auflage eines Buchs, z.\,B. \texttt{Zweite}. Die Ordnungszahl sollte mit einem Großbuchstaben beginnen; sie wird von den Standardstilen gegebenenfalls in Kleinbuchstaben umgewandelt. Manche Stile verlangen hier eine Ziffer.
369 \item \emph{editor}\\
370 Dieses Feld ist analog zu dem \emph{author}-Feld.
371 Falls zusätzlich ein \texttt{author}-Feld angegeben wird, bezeichnet das \texttt{editor}-Feld den Herausgeber des Buches oder des Sammelbandes, in dem die referenzierte Literatur erschienen ist.
372 \item \emph{howpublished}\\
373 Die Art, wie ein Werk veröffentlicht wurde (meist außerhalb eines Verlags). Das erste Wort sollte mit einem Großbuchstaben beginnen.
374 \item \emph{institution}\\
375 Die fördernde Institutions eines technischen Reports.
376 \item \emph{journal}\\
377 Der Name einer Zeitschrift.
378 Mit Hilfe von ">Strings"< können Zeitschriftentitel abgekürzt werden. Zum Erstellen eines solchen Strings können Sie den \nameref{StringEditorHelp} benutzen oder die Funktionalität zur \nameref{JournalAbbreviations} %Abkürzung von Zeitschriftentiteln
381 Dieses Feld wird zur Sortierung, zur Erstellung von Labels (falls kein \texttt{author} vorhanden ist) und für Querverweise (\texttt{crossref}) verwendet. Verwechseln Sie dieses Feld nicht mit dem \texttt{Bibtexkey}, der für die \texttt{\textbackslash cite}-Kommandos gebraucht wird und am Anfang jedes Eintrags erscheint (im \bibtex{}"=Quelltext).
383 Der Monat, in dem ein Werk veröffentlicht oder geschrieben wurde. Benutzen Sie am besten die englischen Abkürzungen (jan, feb, mar, apr, may, jun, jul, aug, sep, oct, nov, dec).
385 Zusätzliche Infromationen. Das erste Wort sollte mit einem Großbuchstaben beginnen.
386 \item \emph{number}\\
387 Die Nummer einer Zeitschrift, eines technischen Reports oder eines Bandes innerhalb einer Reihe (\texttt{series}). Zeitschriften haben oft eine Band- und Heftzählung, der Band entspricht dem \texttt{volume}-, das Heft dem \texttt{number}-Eintrag.
388 \item \emph{organization}\\
389 Die Organisation, die einen Konferenzband fördert.
391 Die Seitenzahl(en) oder der Seitenzahlbereich, z.\,B. \texttt{42-111} oder \texttt{7,41,73-97} or \texttt{43+} (das \texttt{+} deutet auf folgende Seiten, die nicht einen einfachen Bereich umfassen).
392 Ein einfacher Bindestrich (wie in \texttt{7-33}) wird in einen doppelten Bindestrich (\texttt{-{-}}) verwandelt, der in der Ausgabe als bis-Strich erscheint (also 7--33).
393 \item \emph{publisher}\\
394 Der Name des Verlags.
395 \item \emph{school}\\
396 Der Name einer Universität, an der eine Abschlussarbeit~-- z.\,B. eine Dissertation (\texttt{phdthesis}) oder Magisterarbeit (\texttt{mastersthesis})~-- geschrieben wurde.
397 \item \emph{series}\\
398 Der Name einer Reihe, in der ein Buch erschienen ist.
399 Falls die Bücher einer Reihe nummeriert sind, wird die entsprechende Nummer im Feld \texttt{number} angegeben.
401 Der Titel des Werkes. Die Groß- und Kleinschreibung kann von den Bibliographiestilen und der benutzten Sprache abhängig sein (wobei sie mit deutschen Bibliographiestilen beibehalten wird). Worte, die auch bei Verwendung englischer Bibliographiestile groß geschrieben werden sollen, müssen in geschweifte Klammern eingefasst werden (z.\,B. \texttt{A \{German\} title}).
403 Der Typ eines technischen Reports, z.\,B. ">Research Note"<. Bei \emph{jurabib} wird dieses Feld auch für den Typ einer Abschlussarbeit verwendet.
404 \item \emph{volume}\\
405 Der Band (Jahrgang) einer Zeitschrift oder der Band eines Buches in einem mehrbändigen Werk.
407 Das Jahr der Veröffentlichung (oder bei einem unveröffentlichten Werk das Jahr, in dem es geschrieben wurde). Normalerweise sollte im \texttt{year}-Feld nur eine vierstellige Zahl stehen, z.\,B. \texttt{1984}. Die Standardstile können aber auch mit \texttt{year}-Einträgen umgehen, deren letzte vier Zeichen (ausgenommen Satzzeichen) Ziffern sind, beispielsweise \texttt{(um 1984)}.
408 Dieses Feld wird für die meisten Eintragstypen benötigt.
411 \subsubsection{Weitere Felder}
413 Bibliographie-Stile für \bibtex{} wurden von vielen Leuten entwickelt,
414 und einige haben weitere Felder erstellt. Es folgt eine kleine Auswahl.
416 Feldnamen, die mit einem Stern* versehen sind, werden nicht direkt von \jabref unterstützt, können aber eingebunden werden (mehr dazu im Abschnitt \nameref{CustomEntriesHelp}).
419 \item \emph{affiliation*}\\
420 Die Zugehörigkeit eines Autors.
421 \item \emph{abstract}\\
422 Die Zusammenfassung eines Werks.
423 \item \emph{contents*}\\
424 Ein Inhaltsverzeichnis.
425 \item \emph{copyright*}\\
426 Copyright-Informationen.
428 Der \emph{Digital Object Identifier} ist eine permanente Kennung von Dokumenten.
430 Der EID \emph{(Electronic identifier)} wird für elektronische Zeitschriften benutzt, die auch im Druck erscheinen. Mit dieser Nummer, die die Seitenzahlen ersetzt, lässt sich der Artikel in der gedruckten Ausgabe finden. Der EID wird manchmal auch \emph{citation number} genannt.
432 Die Internationale Standardbuchnummer.
434 Die Internationale Standardseriennummer (für Zeitschriften).
435 \item \emph{keywords}\\
436 Stichworte~-- sie können in \jabref gut zum Gruppieren verwendet werden.
437 \item \emph{language*}\\
438 Die Sprache des Werks.
439 \item \emph{location*}\\
440 Der Ort, der mit einem Werk in Verbindung steht, z.\,B. die Stadt, in der eine Konferenz stattgefunden hat.
442 Die \emph{Library of Congress Call Number}. Das Feld kann auch \texttt{lib-congress} heißen.
443 \item \emph{mrnumber*}\\
444 Die \emph{Mathematical Reviews}-Nummer.
445 \item \emph{price*}\\
448 Die physische Größe eines Dokuments.
450 Der \emph{Uniform Resource Locator} (URL, ">einheitlicher Quellenanzeiger"<), der auf eine Webseite im Internet verweist.
451 \item \emph{urldate}\\
452 Das Datum, an dem eine Webseite zuletzt besucht wurde.
457 \section{Installation}
460 \subsection{System-Voraussetzungen}
461 \label{subsec:System-Voraussetzungen}
462 \jabref ist in Java programmiert und somit betriebssystemunabhängig,
463 kann prinzipiell also unter Windows, Mac OS X, Linux und anderen UNIX-Systemen
464 betrieben werden. Voraussetzung ist allerdings, dass die \emph{Java
465 Virtual Machine} mindestens in der Version~1.5 installiert ist.\footnote{Bis zur Version 2.2 von \jabref reichte Java~1.4.2 aus.}
466 Sie ist kostenlos und kann unter \url{http://java.sun.com/} heruntergeladen
467 werden. Im Normalfall sollte das \emph{Java Runtime Environment} (JRE) ausreichen;
468 nur wenn Sie \jabref kompilieren möchten, benötigen Sie das \emph{Java
469 Development Kit} (JDK).
475 \subsubsection{Installer (msi)}
477 \jabref gibt es im Windows Installer-Format (\texttt{.msi}). Ein
478 Doppelklick auf die MSI-Datei installiert \jabref und fügt dem
479 Startmenü eine Verknüpfung hinzu. Falls Java nicht installiert ist,
480 wird eine Warnmeldung ausgegeben.%
481 \footnote{Die Windows-Installation wurde von Dale Visser erstellt, der dazu
482 die folgenden \emph{Open-Source-Tools} benutzt hat: JSmooth, ein \texttt{.exe}
483 wrapper für Java-Anwendungen (\url{http://jsmooth.sf.net/}); Wix,
484 ein Tool zum Kompilieren von MSI-Dateien aus einer XML-Spezifikation
485 (\url{http://wix.sf.net/}).%
489 \subsubsection{Batch-Datei (jar)}
491 Wenn Sie die ausführbare jar-Datei (\texttt{.jar}) heruntergeladen
492 haben, probieren Sie zunächst, ob ein Doppelklick darauf das Programm
493 startet~-- dies funktioniert zumindest auf einigen Systemen. Falls
494 \jabref nicht direkt startet (Windows also nicht weiß, was es mit
495 einer jar-Datei anfangen soll), fahren Sie folgendermaßen fort:
497 Erstellen Sie in dem Ordner, in dem Sie die Datei \emph{JabRef.jar}
498 abgelegt haben, eine Batch-Datei mit dem Namen \emph{jabref-start.bat}.
499 Diese Datei soll nur eine Zeile enthalten:
502 start javaw -jar JabRef.jar
504 Mit einem Doppelklick auf die Batch-Datei starten Sie \jabref.
507 \subsection{Starten von der Kommandozeile}\label{subsec:Starten-Kommandozeile}
510 \item mit dem \emph{Java Runtime Environment}:
512 jre -new -jar <Pfad zur jar-Datei>
516 jrew -new -jar <Pfad zur jar-Datei>
518 \item mit dem \emph{Java Development Kit}:
520 java -jar <Pfad zur jar-Datei>
523 Es wird empfohlen, \jabref mit Java 1.5 zu benutzen und die Option \lstinline{-Dswing.aatext=true}
524 vor der Option \lstinline{-jar} einfügen, um das Benutzen von Anti-Alias-Schriften
525 im Programm zu ermöglichen.
527 Die jar-Datei, die \jabref enthält, kann entpackt werden mit den
530 jar xf <Pfad zur jar-Datei>
534 jar xf <Pfad zur jar-Datei> <Liste der Dateien, die entpackt werden sollen>
536 Das Entpacken der jar-Datei ist nicht notwendig, um das Programm zu
539 Weitere Hinweise zur Installation finden Sie in der Datei INSTALL
540 (zum Kompilieren aus den \emph{sourcen}) und auf der \href{http://jabref.sourceforge.net}{\jabref-Homepage}.
548 \noindent \label{JabRefHelp}\jabref ist ein Programm zur Verwaltung von
549 \bibtex{}-Dateien. Es benutzt kein eigenes Dateiformat, d.\,h. dass
550 Sie Ihre Dateien direkt im \bibtex{}-Format (Dateiendung \texttt{.bib})
551 laden und speichern. Sie können aber auch bibliographische Datenbanken
552 anderer Formate in \jabref importieren.
554 \jabref unterstützt Sortier- und Suchfunktionen, um einen Überblick
555 über den Inhalt Ihrer Datei zu bekommen. Sie können der Datei ganz
556 einfach neue Einträge hinzufügen, ohne sich daran erinnern zu müssen,
557 welche Informationen benötigt werden. Außerdem kann \jabref \bibtex{}-Keys
558 automatisch generieren. \jabref ist sehr nützlich, wenn Sie \bibtex{}
559 oder CiteMaker verwenden, kann aber auch für diejenigen sinnvoll sein,
560 die andere Bibliographie-Systeme benutzen oder schlicht und einfach
561 ihre Literaturquellen organisieren wollen.
563 \subsection{Das Hauptfenster}
565 \tip[]{Die meisten Menüfunktionen, auf die im Folgenden hingewiesen
566 wird, haben Tastenkürzel, und viele Funktionen können über die Werk\-zeug\-leiste
568 \label{BaseFrameHelp}Im Hauptfenster, in dem Sie mit Ihrer Datei
569 arbeiten, befindet sich unter der Menüleiste und der Werkzeugleiste
570 die Tableiste mit Tabs (Reitern) für jede Ihrer geöffneten Dateien.
571 Wenn Sie einen dieser Tabs anklicken, erscheint eine Tabelle, die
572 alle Datensätze und einige der Datenfelder auf"|listet.
574 Mit einem Doppelklick auf eine Tabellenzeile können Sie den Inhalt bearbeiten (der \nameref{EntryEditorHelp} wird geöffnet). Sie können mit den Pfeiltasten innerhalb der Tabelle navigieren. Wenn Sie einen Buchstaben drücken, springen Sie zu dem ersten Eintrag, der mit diesem Buchstaben beginnt (abhängig von der Spalte, nach der Sie die Tabelle sortiert haben).
576 Die Sortierung der Tabelle erfolgt nach einem Feld Ihrer Wahl. Sie können das Standardverhalten unter \menu{Optionen \msep{} Einstellungen \msep{} Tabellenansicht} angeben. Um die Sortierreihenfolge schnell zu ändern, klicken Sie einfach auf die Kopfzeile einer Spalte; damit haben Sie das primäre Sortierkriterium definiert. Klicken Sie erneut auf den Spaltenkopf, um die Sortierrichtung umzukehren. Ein weiterer Klick sorgt dafür, dass die Spalte nicht mehr zur Sortierung herangezogen wird. Halten Sie die STRG-Taste beim Klicken auf einen Spaltenknopf gedrückt, um eine zweite Spalte als sekundäres Sortierkriterium festzulegen. Sie können beliebig viele Spalten zur Sortierung heranziehen.
578 Welche Felder (Spalten) in der Tabelle angezeigt werden sollen, können
579 Sie im \menu{Einstellungs}-Dialog auswählen. Auch die Breite der
580 Tabellenspalten kann eingestellt werden, indem man die Trennlinie
581 zwischen den Spaltenköpfen anklickt und nach links oder rechts verschiebt.
582 Im \menu{Einstellungs}-Dialog können Sie festlegen, ob die Tabelle
583 an die Bildschirmgröße angepasst werden soll oder nicht. Aktivieren
584 Sie diese Funktion, um sicherzustellen, dass Sie die gesamte Tabelle
585 sehen können. Deaktivieren Sie diese Funktion, wenn mehr Informationen
586 dargestellt werden sollen.
588 Die Farbanzeige kann ebenfalls im \menu{Einstellungs}-Dialog ein-
589 und ausgeschaltet werden. Die Farbanzeige illustriert, ob Ihre Daten
590 vollständig sind, indem sie die Zellen wie folgt darstellt:
593 \item Eine \colorbox{red}{\textcolor{white}{rote}} Zelle in der linken Spalte kennzeichnet
594 einen unvollständigen Eintrag.
595 \item Eine \colorbox{yellow}{gelbe} Zelle in der linken Spalte kennzeichnet
596 einen Eintrag, der nicht alle benötigten Felder selbst enthält, der
597 aber einen Querverweis enthält.
598 \item Eine \colorbox{blue}{\textcolor{white}{blaue}} Zelle kennzeichnet ein benötigtes Feld.
599 \item Eine \colorbox{green}{grüne} Zelle kennzeichnet ein optionales Feld.
600 \item Eine farblose (weiße) Zelle kennzeichnet ein Feld, das von \bibtex{}
601 für diesen Eintragstyp nicht benutzt wird. Das Feld kann selbstverständlich
602 in \jabref bearbeitet werden.
605 \subsubsection{Einen neuen Eintrag hinzufügen}
607 Es gibt verschiedene Möglichkeiten, einen neuen Eintrag hinzuzufügen.
608 Im Menü \menu{BibTeX} führt ein Klick auf \menu{Neuer Eintrag} zu
609 einem Dialog, in dem Sie den Eintragstyp aus einer Liste wählen können.
610 Um diesen Dialog zu umgehen, gibt es auch eigene Menüpunkte für jeden
611 Eintragstyp und außerdem Tastenkürzel für die gängigsten Typen.
613 Wenn ein Eintrag hinzugefügt wird, wird standardmäßig ein Editor für
614 den Eintrag geöffnet. Sie können dieses Verhalten im \menu{Einstellungs}-Dialog
617 \tip[]{Wir empfehlen, sich die Tastenkürzel für die Eintragstypen
618 einzuprägen, die Sie am häufigsten benutzen, z.\,B. STRG-SHIFT-A
619 für einen Zeitschriftenaufsatz \emph{(article)}.}
622 \subsubsection{Einen Eintrag bearbeiten}
624 Um den \nameref{EntryEditorHelp} zur Bearbeitung
625 eines existierenden Eintrags zu öffnen, klicken Sie einfach doppelt
626 auf die entsprechende Zeile oder markieren den Eintrag
627 und drücken auf ENTER.
630 \subsubsection{Einen \bibtex{}-String in einem Feld verwenden}
632 In \jabref schreiben Sie den Inhalt aller Felder so, wie Sie es
633 in einem Texteditor machen würden, mit einer Ausnahme: um einen String
634 (eine Art Abkürzung) zu verwenden, umschließen Sie den Namen des Strings
635 mit je einem \#, z.\,B.
640 was interpretiert wird als String mit dem Namen \texttt{jan} gefolgt
641 von \texttt{1997}. Vergleichen Sie dazu auch die Hinweise zum \nameref{StringEditorHelp}.
644 \subsection{Eintrags"=Editor}
646 \label{EntryEditorHelp}
649 \emph{Geöffnet wird der Eintrags"=Editor im Hauptfenster durch einen
650 Doppelklick auf die linke Spalte eines Eintrags oder durch
651 Drücken auf ENTER. Der Eintrags-Editor wird geschlossen, indem man
654 Im Eintrags-Editor können Sie alle relevanten Informationen eines
655 Eintrags festlegen. Der Editor überprüft den Eintragstyp und zeigt
656 alle benötigten und optionalen Felder für den Gebrauch mit \bibtex{}
657 an. Darüber hinaus gibt es einige Felder, die \emph{Allgemeine Felder}
658 genannt werden und für alle Eintragstypen gelten.
660 Sie können die Felder, die für die einzelnen Eintragstypen als benötigt
661 und optional angesehen werden, und auch die Allgemeinen Felder anpassen.
662 Näheres dazu erfahren Sie im Abschnitt \nameref{CustomEntriesHelp}.
664 \subsubsection{Die Panels des Eintrags-Editors}
666 Der Eintrags-Editor besteht in der Standardeinstellung aus fünf Panels:
667 \emph{Benötigte Felder}, \emph{Optionale Felder}, \emph{General},
668 \emph{Abstract} und \emph{\bibtex{}"=Quelltext}, wobei \emph{General}
669 und \emph{Abstract} vom Benutzer angepasst werden können (siehe dazu
670 Abschnitt~\ref{GeneralFields}). In den ersten drei Panels können
671 Sie mit TAB und SHIFT-TAB zwischen den einzelnen Feldern hin- und
672 herwechseln. Zu einem anderen Panel gelangen Sie, indem Sie auf die
673 Tabs klicken. Mit den folgenden Tastaturkürzeln können Sie ebenfalls
674 zwischen den Panels navigieren:
677 \item STRG-TAB oder STRG-+ wechselt zum Panel rechts vom aktuellen Panel,
678 \item STRG-SHIFT-TAB oder STRG-{-} (MINUS) wechselt dementsprechend zum
679 Panel links vom aktuellen Panel.
681 Außerdem können Sie zum nächsten oder vorherigen Eintrag wechseln,
682 indem Sie >>STRG-SHIFT-$\downarrow$<< bzw. >>STRG-SHIFT-$\uparrow$<<
683 oder die Pfeil-Buttons in der linken Toolbar drücken.
685 Das Panel \emph{\bibtex{}"=Quelltext} zeigt, wie der Eintrag aussehen
686 wird, wenn die Datei im \texttt{bib}-Format gespeichert wird. Wenn
687 Sie wollen, können Sie den \bibtex{}"=Quelltext direkt bearbeiten.
688 Sobald Sie zu einem anderen Panel wechseln, STRG-S drücken oder den
689 Eintrags-Editor schließen, wird \jabref versuchen, den Inhalt des
690 Quelltext"=Panels zu analysieren. Falls dabei Probleme auftreten, werden
691 Sie benachrichtigt und erhalten die Möglichkeit, den Eintrag noch
692 einmal zu überarbeiten oder den vorherigen Inhalt wiederherzustellen. (Nähere
693 Einzelheiten dazu finden Sie im Abschnitt \nameref{subsub:feldkonsistenz}.)
694 Wenn in den \menu{Einstellungen} (unter \menu{Allgemein}) die Option
695 \menu{Quelltext standardmäßig anzeigen} gewählt wurde, wird das Quelltext"=Panel
696 beim Öffnen des Eintrags-Editors als erstes angezeigt. Wenn Sie lieber
697 den Quelltext bearbeiten als die anderen Panels zu benutzen, sollten
698 Sie diese Option wählen.
700 \tip{Wenn Ihre Datei Felder enthält, die \jabref nicht kennt,
701 erscheinen diese im Quelltext"=Panel.}
703 \tip[Und noch ein Tipp: ]{Die \emph{PDF-} und \emph{URL}-Felder unterstützen
704 Drag \& Drop. Sie können z.\,B. ein URL aus Ihrem Browser dort einfügen.}
707 \subsubsection{Überprüfung der Feldkonsistenz}
708 \label{subsub:feldkonsistenz}
709 Wenn der Inhalt eines Feldes geändert wird, überprüft \jabref,
710 ob der neue Inhalt akzeptiert werden kann. Bei Feldern, die von \bibtex{}
711 genutzt werden, wird der Inhalt zum einen auf die richtige Klammerung
712 mit geschweiften Klammern, aber auch auf die Benutzung des Zeichens
713 \texttt{\#} hin überprüft. Das >>hash<<-Symbol (im Deutschen oft
714 >>Doppelkreuz<< oder >>Raute<< genannt) darf \emph{nur} paarweise
715 benutzt werden, um damit den Namen eines \bibtex{}-Strings einzuschließen.
716 Beachten Sie, dass \jabref nicht überprüft, ob der angeführte String
717 tatsächlich vorhanden ist, da der \bibtex{}-Stil, den Sie benutzen,
718 eine beliebige Anzahl von Strings definieren kann, die \jabref nicht
721 Falls die Inhalte nicht akzeptabel sind, wird das Feld mit roter Farbe
722 hinterlegt, was auf einen Fehler hindeutet. In diesem Fall werden
723 die Änderungen nicht gespeichert.
726 \subsection{Integritätsprüfung}
729 \emph{Erreichbar über das Menü \menu{Extras \msep{} Datenbank durchsuchen
730 \msep{} Überprüfung der Integrität}.}
732 Mit dieser Funktion überprüft \jabref alle Einträge auf deren Gültigkeit
733 und versucht Fehler aufzudecken. Mit dem \menu{Überprüfen}-Button
734 kann der Vorgang gestartet werden. Es wird eine Liste mit Hinweisen
735 (Info-Icon) und möglichen Fehlern (Ausrufezeichen-Icon) sowie dem
736 entsprechenden \bibtex{}-Key erstellt. Wenn Sie einen Hinweis auswählen,
737 erscheint der Inhalt des Feldes, das beanstandet wird. Sie können
738 nun den Feldinhalt verändern und die Veränderungen mit Klick auf die
739 Schaltfläche \menu{Übernehmen} speichern.
742 \subsection{\bibtex{}-Keys}
744 Damit man sich in einem \LaTeX{}-Dokument auf einen Literaturverweis
745 beziehen kann, braucht man einen eindeutigen \bibtex{}-Key. Eindeutig
746 heißt, dass er nur einmal vergeben sein darf. Es wird nach Groß"~
747 und Kleinschreibung unterschieden, \texttt{Yared1998} ist also nicht
748 identisch mit \texttt{yared1998}. \jabref bietet einige Möglichkeiten,
749 um auch bei größeren Datenbanken den Überblick über die \bibtex{}-Keys
752 \tip{Falls Sie in einem \LaTeX{}-Dokument mehrere \bibtex{}-Dateien
753 einbinden, müssen Sie selbst darauf achten, dass in den unterschiedlichen
754 Dateien nicht mehrmals derselbe \bibtex{}-Key vergeben ist. Nutzen
755 Sie deshalb am besten die Funktion \menu{Extras} \msep{} \menu{Neue Teildatei aus AUX-Datei}.}
756 Der einfachste Weg, einen eindeutigen \bibtex{}-Key zu bekommen, ist
757 das automatische Erzeugen, das Sie mit der Tastenkombination STRG-G
758 oder mit dem Zauberstab-Button im Eintrags-Editor veranlassen können.
759 Falls Sie sich nicht im Eintrags-Editor befinden, werden mit Hilfe
760 von STRG-G oder dem Zauberstab-Button aus der Menüleiste für alle
761 Einträge der Datei \bibtex{}-Keys erzeugt. Falls dabei Keys überschrieben
762 werden, gibt \jabref eine Warnmeldung aus.
764 Wie die \bibtex{}-Keys aussehen, die \jabref automatisch generiert,
765 und wie Sie dieses Aussehen verändern können, erfahren Sie im Abschnitt~\ref{LabelPatterns} \nameref{LabelPatterns}.
768 \subsection{Suchfunktionen}
772 \emph{STRG-F öffnet oder aktiviert den Suchdialog.
773 Drückt man mehrmals auf STRG-F, so werden die verschiedenen Suchmodi
774 ausgewählt. STRG-SHIFT-F öffnet oder aktiviert den Suchdialog
775 und wählt gleichzeitig die direkte Suche aus. Bei der direkten Suche
776 springt man mit STRG-F oder STRG-SHIFT-F zum nächsten Treffer.}
779 \subsubsection{Direkte Suche}
781 Bei der direkten Suche sucht \jabref unmittelbar, wenn Sie einen
782 Buchstaben eingeben. Die Statuszeile informiert Sie über den Sucherfolg.
783 Mit STRG-F oder STRG-SHIFT-F wird zum nächsten Vorkommen des aktuellen
784 Suchbegriffs gesprungen. Falls es keine weiteren Vorkommen gibt, informiert
785 die Statuszeile darüber. Bei erneuter Wiederholung startet die Suche
786 vom Anfang der Datei. Die Suchreihenfolge richtet sich nach der aktuellen
787 Sortierung Ihrer Datei. Um die direkte Suche zu verlassen, drücken
788 Sie ESC oder klicken Sie auf \menu{Zurücksetzen}.
791 \subsubsection{Normale Suche}
793 Hierbei sucht das Programm nach allen Vorkommen der Wörter ihres Suchausdrucks, sobald Sie ENTER drücken. Nur Einträge, die alle Wörter enthalten, gelten als Treffer. Um nach festen Ausdrücken zu suchen, müssen Sie die Wörter in doppelte Anführungszeichen einfassen. Zum Beispiel findet die Suchanfrage \texttt{progress \textquotedbl marine acquaculture\textquotedbl} Einträge, die sowohl das wort ">progress"< als auch den Ausdruck ">marine acquaculture"< aufweisen. Alle Einträge, die keine Treffer sind, werden entweder ausgeblendet, so dass nur die Treffer sichtbar sind (Suchmodus \menu{Filter}), oder sie werden grau dargestellt, während die Treffer oben angezeigt werden (Suchmodus \menu{Oben einsortieren}). Um die Trefferanzeige zu beenden, drücken Sie ESC oder klicken auf die Schaltfläche \menu{Zurücksetzen} im Suchen-Dialog.
795 \subsubsection{Suchoptionen}
797 Der \menu{Einstellungen}-Button im Suchdialog öffnet ein Menü, in
798 dem man mehrere Optionen (de)aktivieren kann: das Beachten von Groß-
799 und Kleinschreibung, das Nutzen regulärer Ausdrücke (siehe dazu den Abschnitt ">\nameref{search-regular-expressions}"<) sowie das Auswählen
802 \tip{Suchen Sie mit der Option \menu{Treffer auswählen} und drücken
803 anschließend STRG-M, so haben Sie alle Treffer markiert (vgl. Abschnitt ">\nameref{MarkingHelp}"<) und können z.\,B. eine weitere Suche durchführen,
804 ohne die bisherigen Ergebnisse zu >>verlieren<<.}
806 \subsubsection{Feldbezeichner und logische Operatoren}
807 \label{SearchHelp_advanced}
809 \tip[Achtung! ]{Die folgenden Hinweise gelten nicht für die direkte Suche.}
810 Um nur einige bestimmte Felder zu durchsuchen
811 und\slash{}oder logische Operatoren im Suchbegriff zu benutzen, wird
812 eine spezielle Syntax zur Verfügung gestellt. Um beispielsweise nach
813 Einträgen mit dem Autor >>Miller<< zu suchen, geben Sie
818 in das Suchfeld ein. Falls der Suchbegriff Leerzeichen enthält, schließen
819 Sie ihn in Anführungszeichen ein. Benutzen Sie \emph{nie} Leerzeichen
820 in dem Feldbezeichner. Mehrere Feldbezeichner werden durch >>|<<
821 voneinander getrennt. Um beispielsweise nach Einträgen über Karl den
822 Großen zu suchen, geben Sie Folgendes ein:
825 title|keywords = "Karl der Große"
827 Sie können die logischen Operatoren AND, OR und NOT sowie Klammern
831 (author = miller OR title|keywords = "Karl der Große") AND NOT author = brown
833 \ldots{} sucht beispielsweise nach Einträgen, in denen entweder der
834 Autor >>Miller<< heißt oder im \emph{title}- oder \emph{keywords}-Feld
835 der Begriff >>Karl der Große<< steht; gleichzeitig werden die Einträge
836 mit dem Autor >>Brown<< nicht angezeigt.
838 Das \texttt{=}-Zeichen ist eigentlich eine Abkürzung für >>enthält<<
839 \emph{(contains)}. Wenn man nach genauen Treffern suchen möchte, muss
840 man \texttt{==} oder \texttt{matches} (>>übereinstimmen<<) eingeben.
841 \texttt{!=} sucht nach Einträgen, bei denen der Suchbegriff \emph{nicht}
842 enthalten ist. Um nach Einträgen eines bestimmten Typs zu suchen,
843 gibt es ein Pseudofeld namens \emph{entrytype}:
848 \ldots{} findet Einträge, deren Typ (wie in der Spalte \emph{Entrytype}
849 dargestellt) das Wort >>thesis<< enthält (z.\,B. >>phdthesis<<
850 und >>mastersthesis<<). Ebenso erlaubt das Pseudofeld \emph{bibtexkey}
851 die Suche nach \bibtex{}-Keys, z.\,B.:
854 bibtexkey = miller2005
857 \subsubsection{Suche mit regulären Ausdrücken}
858 \label{search-regular-expressions}
859 \verfasser{Pedro J. Aphalo, zuerst veröffentlicht im \jabref{}-Wiki in englischer Sprache}
861 \paragraph{Hintergrund}
862 Reguläre Ausdrücke (kurz ">regex"< für engl. ">regular expressions"<) definieren eine Sprache zum Spezifizieren von passendem Text, zum Beispiel bei Suchanfragen. \jabref{} nutzt reguläre Ausdrücke, wie sie in Java definiert sind. Eine Dokumentation dazu findet sich unter \href{http://java.sun.com/j2se/1.4.2/docs/api/java/util/regex/Pattern.html}{http://java.sun.com\slash{}j2se\slash{}1.4.2\slash{}docs\slash{}api\slash{}java\slash{}util\slash{}regex\slash{}Pattern.html}.
864 \tip[]{Die folgenden Beispiele sind alle in Kleinbuchstaben, damit werden aber auch Großbuchstaben oder gemischte Varianten gefunden.}
866 \paragraph{Suche nach Einträgen mit leerem oder fehlendem Feld}
867 \tip[]{\texttt{.} bezeichnet irgendein Zeichen
869 \texttt{+} heißt ein- oder mehrmals}
874 \paragraph{Wortgrenzen beachten}
875 \tip[]{\texttt{\textbackslash b} bezeichnet eine Wortgrenze
877 \texttt{\textbackslash B} heißt: keine Wortgrenze}
881 findet ">uv"<, aber nicht ">lluvia"< (es findet allerdings ">uv-b"<)
885 findet ">black"<, aber weder ">blackwell"< noch ">blacker"<
889 \end{lstlisting} findet ">john black"< nicht,
892 \end{lstlisting} hingegen schon
897 findet ">blackwell"< und ">blacker"<, aber nicht ">black"<
899 \paragraph{Suche mit optionaler Schreibweise}
901 \tip[]{\texttt{?} bezeichnet keine oder eine Kopie des vorhergehenden Buchstaben
903 \texttt{{n,m}} heißt mindestens n, aber nicht mehr als m Kopien des vorhergehenden Buchstaben
905 \texttt{[ ]} definiert eine Buchstabengruppe}
910 findet ">neighbour"< und ">neighbor"<, aber auch ">neighbours"< und ">neighbors"<, ">neighbouring"< und ">neighboring"< etc.
913 title = neighbou?rs?\b
915 findet ">neighbour"< und ">neighbor"<, auch ">neighbours"< und ">neighbors"< , aber weder ">neighbouring"< noch ">neighboring"<.
920 findet ">sanchez"< und ">sánchez"<
923 abstract = model{1,2}ing
925 findet ">modeling"< und ">modelling"<
928 abstract = modell?ing
930 findet ebenfalls ">modeling"< und ">modelling"<
932 \paragraph{Das Problem von Anführungszeichen (\texorpdfstring{\texttt{"}}{"}) in Suchausdrücken}
933 Sind reguläre Ausdrücke ausgeschaltet, findet
936 \end{lstlisting} nichts, auch wenn der Name in der Datenbank vorkommt. Ebensowenig wird bei aktivierten regulären Ausdrücken
938 author = \{\\\"O\}quist
939 \end{lstlisting} irgendetwas finden.
942 author = \{\\\x22O\}quist
944 funktioniert bei aktivierten regulären Ausdrücken für ">\texttt{\{\textbackslash "{}O\}quist}"<, weil \lstinline{\"} nicht als Aufhebung von \lstinline{"} wirkt, \lstinline{\x22} aber schon (also das Zeichen hexadezimal 22 in der ASCII-Tabelle).
949 funktioniert mit ausgeschalteten regulären Ausdrücken und
952 author = Bolh\{\\`a\}r
954 funktioniert mit aktivierten regulären Ausdrücken.
956 Einfache Anführungszeichen (\texttt{'}) funktionieren ebenfalls.
958 Es gibt also anscheinend eine Einschränkung, wie \lstinline{"} in der Eingabe behandelt wird, aber Sie können stattdessen \lstinline{\x22} nutzen, um dieses Problem zu umgehen. (Das Zeichen \lstinline{"} hat eine spezielle Bedeutung: es wird benutzt, um mehrere Wörter zu einer Phrase zu gruppieren, die exakt gefunden werden soll.)
962 Mit Gruppen können Sie Ihre \bibtex{}-Datei in einer Baumstruktur
963 anordnen, vergleichbar mit einer Dateistruktur in Ordnern und Unterordnern.
964 Die beiden Hauptunterschiede sind:
967 \item Während eine Datei auf einer Festplatte immer in genau einem Ordner
968 abgelegt ist, kann ein Literatureintrag in \jabref mehreren Gruppen
970 \item Gruppen benutzen bestimmte Kriterien, um ihren Inhalt dynamisch zu
971 bestimmen. Neue Einträge, die den Kriterien einer Gruppe entsprechen,
972 gehören automatisch zu dieser Gruppe. Diese Funktionalität gibt es
973 nicht in üblichen Dateisystemen, wohl aber in einigen E-Mail-Programmen
974 (z.\,B. Thunderbird und Opera).
976 Wenn Sie eine Gruppe auswählen, werden die Einträge dieser Gruppe
977 angezeigt. Wenn Sie mehrere Gruppen auswählen, werden entweder die
978 Einträge angezeigt, die in einer der Gruppen sind (Vereinigung), oder
979 solche, die in allen Gruppen vorhanden sind (Schnittmenge)~-- das
980 hängt von Ihren Einstellungen ab. All dies wird im Folgenden detailliert
983 Gruppendefinitionen sind dateispezifisch; sie werden als \texttt{@COMMENT}-Block
984 in der \texttt{bib}-Datei gespeichert und von allen Benutzern gemeinsam
985 benutzt. (Künftige Versionen von \jabref werden möglicherweise
986 benutzerabhängige Gruppen unterstützen.)
989 \subsubsection{Die Gruppenansicht}
991 \emph{Die Gruppenansicht wird im linken Bereich des Bildschirms angezeigt.
992 Sie kann mit der Tastenkombination STRG-SHIFT-G oder dem Gruppen-Button
993 in der Toolbar ein- und ausgeblendet werden. Die Gruppenansicht verfügt
994 über mehrere Schaltflächen, aber die meisten Funktionen werden über
995 das Kontextmenü angesteuert (also mit der rechten Maustaste). Drag\,\&\,Drop
996 wird ebenfalls unterstützt.}
1000 \subsubsection{Einige kurze Beispiele}
1002 Sie möchten vielleicht~\ldots{}
1005 \item [\ldots]\textbf{einfach nur eine Gruppe anlegen und ihr einige Einträge
1009 Vergewissern Sie sich, dass die Gruppenansicht eingeschaltet ist.
1010 Drücken Sie auf den Button \menu{Neue Gruppe}, geben einen Namen
1011 für die Gruppe ein und drücken \menu{OK}. Sie können alle Einstellungen
1012 auf ihren Standardwerten belassen. Jetzt wählen Sie die Einträge aus,
1013 die der Gruppe zugeordnet werden sollen, und ziehen diese mit der
1014 Maus auf die Gruppe oder wählen \menu{Zu Gruppe hinzufügen} aus dem
1015 Kontextmenü. Jetzt können Sie die Gruppe anklicken, um sich ihren
1016 Inhalt anzeigen zu lassen (das sollten die Einträge sein, die Sie
1017 gerade hinzugefügt haben).
1019 \item [\ldots]\textbf{das Feld} \textbf{\emph{keywords}} \textbf{benutzen,
1020 um die Einträge zu gruppieren}
1023 Stellen Sie sicher, dass die Gruppenansicht aktiviert ist. Drücken
1024 Sie auf den Button \menu{Neue Gruppe}, geben einen Namen für die
1025 Gruppe ein und wählen die Option \menu{Dynamisches Gruppieren der Einträge anhand eines Stichworts in einem Feld}.
1026 Geben Sie das Stichwort, nach dem gesucht werden soll, ein und drücken
1027 \menu{OK}. Jetzt können Sie die Gruppe anklicken, um sich ihren Inhalt
1028 anzeigen zu lassen (das sollten alle Einträge sein, deren \emph{keywords}-Feld
1029 das Stichwort enthält, das Sie angegeben haben).
1031 \item [\ldots]\textbf{einen frei wählbaren Suchausdruck verwenden, um eine
1032 Gruppe zu definieren}
1035 Stellen Sie sicher, dass die Gruppenansicht aktiviert ist. Drücken
1036 Sie auf den Button \menu{Neue Gruppe}, geben einen Namen für die
1037 Gruppe ein und wählen die Option \menu{Dynamisches Gruppieren der Einträge anhand eines beliebigen Suchausdrucks}.
1038 Geben Sie \texttt{author=smith} als Suchausdruck ein (ersetzen Sie
1039 \texttt{smith} mit einem Namen, der wirklich in Ihrer Datei vorkommt)
1040 und klicken \menu{OK}. Jetzt können Sie die Gruppe anklicken, um
1041 sich ihren Inhalt anzeigen zu lassen (das sollten alle Einträge sein,
1042 deren \emph{author}-Feld den Namen beinhaltet, den Sie angegeben haben).
1044 \item [\ldots]\textbf{mehrere Gruppen kombinieren }
1047 Erstellen sie zwei unterschiedliche Gruppen (z.\,B. so wie oben beschrieben).
1048 Klicken Sie auf den Button \menu{Einstellungen} in der Gruppenansicht
1049 und wählen \menu{Vereinigung}. Jetzt wählen Sie beide Gruppen aus
1050 (dazu klicken Sie auf eine Gruppe und anschließend bei gedrückter
1051 STRG-Taste auf die andere Gruppe). Sie sollten jetzt alle Einträge
1052 sehen, die in einer der beiden Gruppen aufgeführt sind. Klicken Sie
1053 noch einmal auf \menu{Einstellungen} und wählen \menu{Schnittmenge}
1054 aus. Nun sollten Sie nur die Einträge sehen, die in beiden Gruppen
1055 enthalten sind (das können auch keine sein, oder aber genau dieselben
1056 Einträge wie zuvor, sofern beide Gruppen dieselben Einträge enthalten).
1058 \item [\ldots]\textbf{sehen, welche Gruppen sich überschneiden}
1061 Mit \jabref können Sie ganz einfach herausfinden, welche Gruppen
1062 sich mit den aktuell ausgewählten Gruppen überschneiden (d.\,h. welche
1063 Gruppen zumindest einen Eintrag enthalten, der auch in der aktuell
1064 ausgewählten Gruppe ist). Klicken Sie auf \menu{Einstellungen} und
1065 aktivieren die Option \menu{Sich überschneidende Gruppen markieren}.
1066 Wählen Sie dann eine Gruppe, die sich mit anderen überschneidet. Diese
1067 anderen Gruppen sollten nun markiert sein.
1071 \subsubsection{Arten von Gruppen}
1073 In \jabref gibt es vier verschiedene Arten von Gruppen:
1076 \item Die Gruppe \emph{Alle Einträge}, die~-- wie der Name vermuten lässt~--
1077 alle Einträge beinhaltet, ist immer vorhanden und kann weder verändert
1078 noch gelöscht werden.
1079 \item \emph{Statische Gruppen} verhalten sich wie Ordner auf einer Festplatte
1080 und beinhalten nur die Einträge, die Sie ihnen explizit zuweisen.
1081 \item \emph{Dynamische Gruppen basierend auf einem Stichwort} beinhalten
1082 Einträge, die in einem bestimmten \bibtex{}-Feld (z.\,B. \emph{keywords})
1083 ein bestimmtes Stichwort (z.\,B. \emph{elektrisch}) aufweisen. Diese
1084 Methode benötigt kein manuelles Zuweisen der Einträge, sondern nutzt
1085 die bereits in der Datei vorhandenen Informationen. Wenn alle Einträge
1086 in Ihrer Datenbank passende Stichwörter haben, könnte diese Art von
1087 Gruppe die beste Wahl für Sie sein.
1088 \item \emph{Dynamische Gruppen basierend auf einer freien Suche} beinhalten
1089 Einträge, die mit einem bestimmten Suchausdruck übereinstimmen. Dabei
1090 wird dieselbe Syntax verwendet wie beim Suchen (siehe Abschnitt~\ref{SearchHelp}).
1091 Diese Syntax (die auf S.\,\pageref{SearchHelp_advanced} genauer
1092 beschrieben wird) unterstützt logische Operatoren (AND, OR, NOT) und
1093 erlaubt es, in einem oder mehreren \bibtex{}-Feldern zu suchen. Dadurch
1094 ist eine flexiblere Definition von Gruppen möglich als mit einer Stichwortsuche
1095 (z.\,B. \texttt{author=smith AND title=elektrisch}).
1097 Jede Gruppe, die Sie erstellen, ist von einer der drei letztgenannten
1098 Arten. Der Dialog \menu{Gruppe bearbeiten}, der mit einem Doppelklick
1099 auf eine Gruppe aufgerufen wird, zeigt eine kurze Beschreibung der
1100 ausgewählten Gruppe.
1103 \subsubsection{Gruppenstrukturen, Erstellen und Löschen von Gruppen}
1105 Die Gruppen sind~-- vergleichbar mit Datei-Ordnern~-- in einer Baumansicht
1106 strukturiert, in der die Gruppe \emph{Alle Einträge} das Stammelement
1107 ist. Mit einem Rechtsklick auf eine Gruppe können Sie dem Baum eine
1108 neue Gruppe hinzufügen, entweder auf derselben Ebene wie die ausgewählte
1109 Gruppe oder als ihre Untergruppe. Der Button \menu{Neue Gruppe} erzeugt
1110 eine neue Untergruppe der Gruppe \emph{Alle Einträge}, egal ob Sie
1111 gerade Gruppen ausgewählt haben oder nicht. Im Kontextmenü können
1112 Sie auch Gruppen und\slash{}oder Untergruppen löschen, Untergruppen
1113 alphabetisch sortieren oder Gruppen an eine andere Stelle des Baums
1114 verschieben. Letzteres können Sie auch mit Drag\,\&\,Drop machen,
1115 allerdings mit der Einschränkung, dass bei Drag\,\&\,Drop die Reihenfolge
1116 der Untergruppen einer Gruppe nicht verändert werden kann.
1118 Die Funktionen \menu{Rückgängig} und \menu{Wiederholen} werden für
1119 alle Bearbeitungsschritte unterstützt.
1122 \paragraph{Statische Gruppen}
1124 Statische Gruppen werden nur durch manuelles Zuweisen von Einträgen
1125 >>gefüttert<<. Nachdem Sie eine statische Gruppe erstellt haben,
1126 wählen Sie die Einträge aus, die Sie ihr zuweisen wollen, und nutzen
1127 entweder Drag\,\&\,Drop oder das Kontextmenü in der Tabelle, um
1128 die Zuweisung durchzuführen. Um Einträge aus einer Gruppe zu entfernen,
1129 wählen Sie sie aus und benutzen das Kontextmenü in der Tabelle. Es
1130 können keine weiteren Optionen angegeben werden.
1132 Diese Methode des Gruppierens setzt voraus, dass alle Einträge einen
1133 eindeutigen \bibtex{}-Key haben. Im Falle von fehlenden oder doppelten
1134 \bibtex{}-Keys kann das Zuweisen der betreffenden Einträge in künftigen
1135 Sitzungen nicht korrekt wiederhergestellt werden.
1138 \paragraph{Dynamische Gruppen}
1140 Der Inhalt einer dynamischen Gruppe wird von einer logischen Bedingung
1141 bestimmt. Nur Einträge, die dieser Bedingung entsprechen, gehören
1142 zu dieser Gruppe. Diese Methode nutzt die bereits in der Datei vorhandenen
1143 Informationen und wird aktualisiert, sobald Sie Veränderungen in der
1144 Datei vornehmen. Es gibt zwei mögliche Arten von Bedingungen:
1147 \item Ein Feld nach einem Stichwort durchsuchen
1150 Diese Methode gruppiert Einträge, bei denen ein bestimmtes \bibtex{}-Feld
1151 (z.\,B. \emph{keywords}) einen bestimmten Suchausdruck (z.\,B. \emph{elektrisch})
1152 enthält. Damit dies funktioniert, muss das Feld, nach dem sortiert
1153 wird, natürlich in jedem Eintrag vorhanden und sein Inhalt fehlerfrei
1154 sein. Das obige Beispiel würde alle Einträge zu einer Gruppe zusammenfassen,
1155 die sich auf etwas Elektrisches beziehen. Benutzt man das Feld \emph{author},
1156 kann man sich Einträge eines bestimmten Autors gruppieren lassen,
1157 usw. Die Suche ist als reine Textsuche oder mit einem regulären Ausdruck
1158 möglich. Im ersten Fall erlaubt \jabref das manuelle Zuweisen zu
1159 und Entfernen aus einer Gruppe; dazu fügt \jabref den Suchausdruck
1160 dem entsprechenden Feld zu bzw. entfernt ihn daraus. Das macht nur
1161 für das Feld \emph{keywords} oder für selbstdefinierte Felder Sinn,
1162 aber offensichtlich nicht für Felder wie \emph{author} oder \emph{year}.
1164 \item Einen freien Suchausdruck verwenden
1167 Diese Vorgehensweise ist ganz ähnlich wie die eben beschriebene, aber
1168 statt nur ein Feld nach einem Suchausdruck zu durchsuchen, kann hierbei
1169 die Syntax der Suche (siehe S.\,\pageref{SearchHelp_advanced}) angewendet
1170 werden, die logische Operatoren (AND, OR, NOT) und die Suche in mehreren
1171 Feldern gleichzeitig unterstützt. So fasst z.\,B. die Suchanfrage
1172 \texttt{keywords=Regression AND NOT keywords=linear} Einträge, die
1173 sich mit nicht-linearer Regression beschäftigen, zu einer Gruppe zusammen.
1176 In der Gruppenansicht werden dynamische Gruppen standardmäßig \emph{kursiv}
1177 dargestellt. Dies kann unter \menu{Optionen} \msep{} \menu{Einstellungen}
1178 \msep{} \menu{Gruppen} abgestellt werden.
1181 \paragraph{Hierarchischer Kontext}
1183 Standardmäßig ist eine Gruppe \emph{unabhängig} von ihrer Position
1184 im Gruppenbaum. Ist eine Gruppe ausgewählt, wird nur der Inhalt dieser
1185 Gruppe angezeigt. Es ist jedoch~-- besonders beim Verwenden dynamischer
1186 Gruppen~-- oft nützlich, eine Untergruppe zu erstellen, die \emph{ihre
1187 Obergruppe einbezieht}. Wenn diese Untergruppe ausgewählt wird, werden alle Einträge dieser
1188 Gruppe und ihrer Obergruppe angezeigt. Erstellen Sie z.\,B. eine
1189 Obergrupe, die Einträge mit dem Stichwort \emph{Verteilung} enthält,
1190 sowie eine einbeziehende Untergruppe mit Einträgen, die das Stichwort
1191 \emph{Gauß} enthalten. Wenn Sie nun die Untergruppe auswählen, werden
1192 alle Einträge angezeigt, die beiden Bedingungen entsprechen, also
1193 alle, die mit Gauß'scher Verteilung zu tun haben. Indem Sie nun eine
1194 weitere Untergruppe für \emph{Laplace} anlegen, die dieselbe Obergruppe
1195 einbezieht, können Sie die Gruppierung einfach erweitern. Im Gruppenbaum
1196 haben solche Gruppen, die ihre Obergruppen einbeziehen, ein spezielles
1197 Icon. (Dieses Verhalten kann in den Einstellungen abgestellt werden.)
1199 Das logische Gegenstück zu einer solchen einbeziehenden Untergruppe
1200 ist eine Gruppe, die \emph{ihre Untergruppen berücksichtigt}.
1201 Wird sie ausgewählt, werden nicht nur die Einträge dieser Gruppe,
1202 sondern auch diejenigen aller Untergruppen angezeigt. Im Gruppenbaum
1203 hat auch diese Art von Gruppen ein spezielles Icon. (Dieses Verhalten
1204 kann in den Einstellungen abgestellt werden.)
1207 \subsubsection{Einträge einer Gruppe anzeigen, mehrere Gruppen kombinieren}
1209 Wenn Sie eine Gruppe auswählen, werden die Einträge, die dieser Gruppe
1210 zugeordnet sind, hervorgehoben und~-- je nach Einstellung (die mit
1211 einem Klick auf den \menu{Einstellungen}-Button vorgenommen werden
1212 kann)~-- an den Anfang der Tabelle verschoben und\slash{}oder ausgewählt.
1213 Diese Optionen entsprechen denen für die normale Suche (siehe Abschnitt~\ref{SearchHelp}).
1215 Wenn Sie meherere Gruppen auswählen (indem Sie die STRG-Taste gedrückt
1216 halten und mehrere Gruppen anklicken), wird~-- je nach Einstellung~--
1217 entweder die Vereinigung oder die Schnittmenge ihrer Inhalte angezeigt.
1218 Damit können mehrere Bedingungen schnell miteinander kombiniert werden.
1219 Ein Beispiel: Wenn Sie eine statische Gruppe namens \emph{Sehr wichtig}
1220 haben, in der alle sehr wichtigen Einträge sind, können Sie sich die
1221 sehr wichtigen Einträge jeder anderen Gruppe anzeigen lassen, indem
1222 Sie beide Gruppen auswählen (dazu muss \menu{Schnittmenge} in den
1223 Einstellungen aktiviert sein).
1226 \subsubsection{Gruppen und Suche}
1228 Wenn der Inhalt einer oder mehrerer Gruppen angezeigt wird, können
1229 Sie eine Suche innerhalb dieser Einträge durchführen. Benutzen Sie
1230 dazu die normalen Suchfunktionen (siehe Abschnitt~\ref{SearchHelp}).
1233 \subsubsection{Sich überschneidende Gruppen markieren}
1235 Der \menu{Einstellungen}-Button bietet eine Option zum Markieren
1236 von sich überschneidenden Gruppen. Wenn diese Option aktiviert ist
1237 und Sie eine (oder mehrere) Gruppe(n) auswählen, werden alle Gruppen
1238 markiert, die mindestens einen Eintrag enthalten, der auch der ausgewählten
1239 Gruppe zugeordnet ist. Damit können Sie schnell Überschneidungen zwischen
1240 den Einträgen verschiedener Gruppen erkennen. Sie könnten beispielsweise
1241 eine Gruppe mit dem Namen \emph{lesen} erstellen, die alle Einträge
1242 enthält, die sie lesen wollen. Sobald Sie nun eine Gruppe auswählen,
1243 wird die Gruppe \emph{lesen} markiert, sofern die ausgewählte Gruppe
1244 Einträge enthält, die Sie noch lesen wollten.
1247 \subsubsection{Erweiterte Funktionen}
1249 Wenn Sie sich mit dem oben beschriebenen Gruppenkonzept vertraut gemacht
1250 haben, könnten die folgenden erweiterten Funktionen nützlich sein.
1253 \paragraph{Dynamische Gruppen automatisch erstellen}
1255 Mit einem Klick auf den Button \menu{Automatisch Gruppen für die Datei anlegen}
1256 können Sie ganz schnell passende Gruppen für Ihre Datei erzeugen.
1257 Diese Funktion sammelt alle Wörter eines bestimmten Felds Ihrer Wahl
1258 und erstellt eine Gruppe für jedes Wort. Das ist zum Beispiel nützlich,
1259 wenn Ihre Datei geeignete Stichworte für alle Einträge enthält. Mit
1260 dem automatischen Erstellen von Gruppen basierend auf dem Feld \emph{keywords}
1261 können Sie also ohne großen Aufwand ein Grundgerüst von Gruppen anlegen.
1263 Sie können auch Zeichen angeben, die ignoriert werden sollen, z.\,B.
1264 Kommas, die zwischen einzelnen Stichworten stehen. Diese werden als
1265 Worttrenner behandelt und nicht als Teile des Wortes selbst. Dieser
1266 Schritt ist wichtig, damit kombinierte Stichworte wie etwa \emph{Gauß'sche
1267 Verteilung} als semantische Einheit interpretiert werden können. (Sie
1268 können diese Option allerdings nicht verwenden, um ganze Wörter zu
1269 ignorieren. Sie müssen stattdessen die Gruppen, die Sie nicht wollen,
1270 nach dem automatischen Erstellen von Hand löschen.)
1273 \paragraph{Ansicht aktualisieren}
1275 Der \menu{Aktualisieren}-Button in der Gruppenansicht aktualisiert
1276 die Tabelle in Bezug auf die aktuell ausgewählten Gruppen. Normalerweise
1277 erfolgt dies automatisch, aber in seltenen Fällen (z.\,B. nach einem
1278 Rückgängig- oder Wiederholen"=Vorgang, der mit Gruppen zusammenhängt)
1279 ist ein händisches Aktualisieren nötig.
1282 \paragraph{Einbeziehende Unter- und Obergruppen mischen}
1284 Ist eine einbeziehende Gruppe die Untergruppe von einer Gruppe,
1285 die ihre Untergruppen berücksichtigt~-- hat sie also sozusagen Geschwister~--,
1286 dann werden diese Geschwister ignoriert,
1287 sobald die einbeziehende Gruppe ausgewählt wird.
1290 \subsection{Markieren von Einträgen}
1294 \emph{Mit der Tastenkombination STRG-M können
1295 Sie Einträge markieren und diese Markierung mit STRG-SHIFT-M wieder
1296 aufheben. Diese Aktionen sind auch im Menü \menu{Bearbeiten} zu finden.}
1298 Das Markieren ist nicht dasselbe wie das Auswählen eines Eintrags.
1299 Markierte Einträge verhalten sich in zweierlei Hinsicht anders als
1300 die restlichen Einträge:
1303 \item Markierte Einträge werden immer mit einem gelben Hintergrund in der
1305 \item Markierte Einträge werden an den Anfang der Eintragsliste verschoben,
1306 falls Ihre Tabelle nicht nach Gruppen oder aufgrund einer Suche sortiert
1309 Wenn Sie Ihre Datei speichern, werden die Markierungen beibehalten.
1310 Das Markieren von Einträgen ist z.\,B. nützlich, wenn Sie verschiedene
1311 Suchvorgänge durchführen wollen, ohne das erste Suchergebnis zu verlieren,
1312 oder wenn Sie sich merken wollen, welche Artikel oder Bücher Sie noch
1313 einmal genauer ansehen müssen.
1316 \subsection{String"=Editor}
1317 \label{StringEditorHelp}
1320 \emph{Zugriff über das Menü \menu{BibTeX}} \msep{} \emph{\menu{Strings bearbeiten}
1321 oder durch Klick auf die Schaltfläche \menu{Strings bearbeiten}.}
1323 \emph{Strings} sind das \bibtex{}-Äquivalent zu Konstanten in einer
1324 Programmiersprache. Jeder String wird durch einen eindeutigen \emph{Namen}
1325 und einen \emph{Inhalt} festgelegt. Der Name kann an anderer Stelle
1326 in der Datei benutzt werden, um den Inhalt wiederzugeben.
1328 Ein Beispiel: Wenn viele Einträge aus einer Zeitschrift stammen, deren
1329 Abkürzung schwer zu behalten ist, wie etwa >>J. Theor. Biol.<< (Journal
1330 of Theroretical Biology), könnte ein String mit dem Namen >>JTB<<
1331 angelegt werden, um den Namen der Zeitschrift zu repräsentieren. Statt
1332 nun in jedem Eintrag den exakten Namen der Zeitschrift einzutragen,
1333 genügt die Zeichenfolge \texttt{\#JTB\#} im Feld \emph{journal}, und
1334 es ist sichergestellt, dass der Name jedesmal in identischer Schreibweise
1337 Der Verweis auf einen String kann an jeder Stelle eines Feldes erscheinen,
1338 wobei der Name des Strings immer von einem Paar \texttt{\#}-Zeichen
1339 eingeschlossen werden muss. Diese Syntax gilt nur für \jabref und
1340 weicht ein wenig von der \bibtex{}-Syntax ab, die erzeugt wird, wenn
1341 Sie Ihre Datei speichern. Strings können für alle Standard-\bibtex{}-Felder verwendet werden.
1342 Unter \menu{Optionen \msep{} Einstellungen \msep{} Allgemein} können Sie im Bereich \menu{Datei} festlegen, ob Strings auch in Nicht-Standard-Feldern benutzt werden dürfen. In diesem Fall können Sie Felder bestimmen, die von der Auflösung der Strings ausgenommen werden; hierbei wird empfohlen, das Feld \texttt{url} und andere Felder anzugeben, die das Zeichen \texttt{\#} enthalten können und die von \bibtex\slash\LaTeX{} verarbeitet werden können.
1344 In derselben Weise kann man auch im Inhalt eines Strings auf einen
1345 anderen String verweisen, vorausgesetzt, dass der String, auf den
1346 verwiesen wird, bereits \emph{vorher} definiert ist.
1348 Während die Reihenfolge der Strings in Ihrer \bibtex{}-Datei in einigen
1349 Fällen wichtig ist, brauchen Sie sich bei der Benutzung von \jabref
1350 darüber keine Gedanken zu machen. Die Strings werden in alphabetischer
1351 Reihenfolge im String-Editor aufgelistet und in derselben Reihenfolge
1352 gespeichert, außer wenn eine andere Reihenfolge von \bibtex{} verlangt
1355 \subsection{Abkürzung von Zeitschriftentiteln}
1356 \label{JournalAbbreviations}
1358 \emph{Diese Funktion kann unter \menu{Optionen \msep{} Abkürzungen der Zeitschriften verwalten} eingestellt werden.}
1360 \jabref kann automatisch zwischen Zeitschriftentiteln in abgekürzter und ausführlicher Form hin- und herschalten, sofern die Titel in einer Ihrer Zeitschriftenlisten enthalten ist. Sie können mehrere dieser Listen benutzen, die Sie als externe Textdateien anlegen.
1362 \subsubsection{Benutzungshinweise}
1364 Die Abkürzung von Zeitschriftentiteln können Sie vom Eintragseditor oder vom Menü \menu{Extras} aus ein- und ausschalten. Im Eintragseditor benutzen Sie dazu den Button \menu{Abkürzung an-/abschalten} neben dem \emph{Journal}-Feld. Es wird zwischen drei Modi hin- und hergeschaltet:
1366 \item Kompletter Name, z.\,B. ">Aquacultural Engineering"<
1367 \item \caps{ISO}-Abkürzung, z.\,B. ">Aquacult. Eng."<
1368 \item \caps{MEDLINE}-Abkürzung, z.\,B. ">Aquacult Eng"<
1370 Falls der Zeitschriftentitel sich nicht in Ihren Zeitschriftenlisten findet, wird das Feld nicht verändert.
1372 Um die Zeitschriftentitel mehrerer Einträge auf einmal zu konvertieren, können Sie eine beliebige Anzahl von Einträgen auswählen und im Menü \menu{Extras} einen der Einträge \menu{Zeitschriftentitel abkürzen (ISO)}, \menu{Zeitschriftentitel abkürzen (MEDLINE)} und \menu{Abkürzung der Zeitschriften aufheben} wählen.
1373 Diese drei Aktionen sorgen dafür, dass bei allen ausgewählten Einträgen die Zeitschriftentitel, die in den Zeitschriftenlisten gefunden werden konnten, abgekürzt oder komplett ausgeschrieben werden.
1375 \subsubsection{Zeitschriftenlisten verwalten}
1377 Sie können mehrere Zeitschriftenlisten als externe Textdateien benutzen, die mit \jabref verlinkt sind. Die primäre Liste kann in \jabref selbst verwaltet werden.
1379 \paragraph{Ihre persönliche Zeitschriften-Abkürzungsliste}
1381 Ihre persönliche Liste verwalten Sie im oberen Teil des Dialogs \menu{Abkürzung der Zeitschriftentitel}.
1382 Wählen Sie \menu{Neue Datei} und geben einen Dateinamen ein oder klicken auf den \menu{Durchsuchen}-Button. Wenn Sie bereits eine Datei haben, die Sie als Grundlage nehmen wollen, wählen Sie stattdessen \menu{Bestehende Datei} und benutzen den \menu{Durchsuchen}-Button zum Auswählen dieser Datei. Die Tabelle zeigt dann den Inhalt der Liste, die Sie ausgewählt haben.
1384 Sie können mit Hilfe der \menu{+} und \menu{--} Buttons an der rechten Seite Einträge hinzufügen oder entfernen. Für jeden Eintrag müssen Sie den vollständigen Zeitschriftentitel und die ISO-Abkürzung angeben (z.\,B. ">Aquacultural Engineering"< und ">Aquacult. Eng."<). Mit einem Doppelklick auf die Tabellenzeile können Sie die Einträge bearbeiten.
1386 Sobald Sie auf \menu{OK} klicken (oder wenn Sie eine bestehende Datei ausgewält haben), enthält die Tabelle mindestens eine Zeile. Der Tabelleninhalt wird in die ausgewählte Datei geschrieben und die Zeitschriftenliste von \jabref wird aktualisiert.
1388 \paragraph{Externe Zeitschriftenlisten}
1390 Zusätzlich zu Ihrer persönlichen Liste können Sie mehrere externe Listen verlinken. Diese Verknüpfungen werden im unteren Teil des Dialogs \menu{Abkürzung der Zeitschriftentitel} verwaltet. Externe Listen sind den persönlichen Listen ähnlich~-- der einzige Unterschied ist, dass Sie nicht mit \jabref selbst verwaltet werden können.
1392 Um eine externe Liste hinzuzufügen, klicken Sie zunächst auf den \menu{+} Knopf, falls nötig (das fügt eine weitere Zeile hinzu). Dann benutzen Sie entweder den \menu{Durchsuchen}- oder den \menu{Herunterladen}-Button.
1394 \item Mit dem \menu{Durchsuchen}-Knopf können Sie eine auf Ihrem Computer bestehende Datei auswählen.
1395 \item Mit dem \menu{Herunterladen}-Knopf können Sie eine Liste aus dem Internet herunterladen, indem Sie einen URL angeben. Die Datei wird auf Ihrem Computer gespeichert und mit \jabref verlinkt.
1396 Der URL ist standardmäßig die Adresse einer Zeitschriftenliste auf der \jabref-Homepage. Diese Liste ist unvollständig, wird in Zukunft aber ausgebaut.
1398 Jeder Eintrag in Ihrer persönlichen Liste überschreibt einen Eintrag mit demselben vollständigen Zeitschriftentitel in einer Ihrer externen Listen. In ähnlicher Weise werden die externen Listen in der Reihenfolge, wie sie aufgelistet werden, abgearbeitet.
1400 \subsection{Wortauswahl verwalten}
1402 \label{ContentSelectorHelp}Diese Funktion ermöglicht es, eine Auswahl
1403 von oft benutzten Wörtern oder Phrasen zu speichern. In der Standardeinstellung
1404 ist sie für die Felder \emph{journal}, \emph{keywords} und \emph{publisher}
1405 aktiviert, aber Sie können die Funktion auch in anderen Feldern verwenden,
1406 indem Sie diese Felder im oberen Teil des Dialogs \menu{Extras} \msep{}
1407 \menu{Wortauswahl verwalten} hinzufügen.
1409 Die Wortauswahl gilt nur für die jeweilige Datei und wird daher zusammen
1410 mit den Literaturangaben in der \bibtex{}-Datei gespeichert. Jedes
1411 Feld mit Wortauswahl erhält im Eintrags-Editor einen gesonderten Bereich
1412 mit einer Auswahlliste und der Schaltfläche \menu{Verwalten}. Wenn
1413 Sie die Auswahlliste mit der Maus anklicken, erscheint eine Liste
1414 der für dieses Feld verfügbaren Wörter. Sobald Sie auf das gewünschte
1415 Wort klicken, wird es in das entsprechende Feld geschrieben.
1417 Um ein neues Wort hinzuzufügen, schreiben Sie es einfach in das Auswahlfeld
1418 (über der Schaltfläche \menu{Verwalten}) und drücken ENTER. Im Dialog
1419 \menu{Verwalten} können Sie hinzugefügte Wörter auch wieder löschen.
1424 \subsubsection{Import-Kontrollfenster}
1426 \label{ImportInspectionDialog}Beim Importieren neuer Einträge aus
1427 einem unterstützten Format oder beim Herunterladen von Einträgen aus
1428 dem Internet werden diese Einträge zunächst im Import-Kontrollfenster
1429 gezeigt. Zu diesem Zeitpunkt wurden noch keine Einträge zu einer geöffneten
1432 Im Kontrollfenster können Sie Einträge entfernen, die nicht übernommen
1433 werden sollen, und einige einfache Arbeiten durchführen wie etwa das
1434 Generieren von \bibtex{}-Keys für die Einträge oder das Zuordnen von
1435 Einträgen zu Gruppen. Wenn Sie in eine bestehende Datei importieren,
1436 ist es oftmals leichter, diese Arbeiten durchzuführen, bevor die neuen
1437 Einträge zwischen die bereits bestehenden sortiert wurden.
1439 \subsubsection[EndNote -> \jabref]{EndNote $\to$~\jabref}\label{subsubsec:endnote-jabref}
1441 EndNote hat einen Export-Stil \bibtex{}, der allerdings nicht alle
1442 Eintragstypen und Felder von \bibtex{} und auch nicht die zusätzlich
1443 von \jabref genutzten Allgemeinen Felder (\emph{pdf}, \emph{owner},
1444 \emph{key} usw.) unterstützt. Falls Sie diese Felder nutzen wollen,
1445 verwenden Sie die EndNote Extras (\menu{Extras \msep{} EndNote Filter-Set entpacken}), extrahieren die Zip-Datei,
1446 die dabei erstellt wird und folgen den Anweisungen in der Datei \texttt{readme.txt}.
1449 \subsubsection[\jabref -> EndNote]{\jabref $\to$~EndNote}
1450 \label{EndnoteFilters}
1453 \emph{\jabref kann Dateien so exportieren,
1454 dass EndNote sie lesen kann. Um diese Funktion zu nutzen, wählen Sie
1455 \menu{Datei \msep{} Exportieren}, dann bei \emph{Dateityp} \menu{Endnote} und
1456 geben den Namen der Export"=Datei an.}
1458 Der Standard"=Importfilter von EndNote kann nicht richtig mit mehreren
1459 Autoren oder Editoren umgehen. Es gibt zwei Möglichkeiten, um diese
1460 Schwierigkeit zu umgehen:
1463 \item Benutzen Sie den eingebauten Filter und bessern Sie die Datei später
1466 Um die Datei in EndNote zu öffnen, erstellen Sie eine neue Datei oder
1467 öffnen eine bestehende Datei in EndNote. Dann wählen Sie \menu{Datei}
1468 \msep{} \menu{Importieren}, klicken mit der Maus auf \menu{Datei wählen},
1469 wählen die aus \jabref exportierte Datei aus und drücken auf \menu{Auswählen}.
1470 Anschließend drücken Sie auf \menu{Import Optionen} und wählen \menu{EndNote Import}.
1471 Mit einem Klick auf \menu{Importieren} starten Sie den Importvorgang.
1472 Anschließend gehen Sie zum Menüpunkt \menu{Bearbeiten} \msep{} \menu{Text ändern}
1473 und ändern \emph{Any Field} in \emph{Author}. Geben Sie \lstinline{_and_}
1474 in das Suchfeld ein (die Unterstriche stehen für Leerzeichen) sowie ein RETURN-Zeichen
1475 in das Feld \emph{Ändern} (Option-Return unter Mac OS X, STRG-Return unter
1476 Windows XP). Dann klicken Sie auf \menu{Ändern}. Wiederholen Sie
1477 das Ganze für das Feld \emph{Secondary Author} (Zweiter Autor).
1479 \item Installieren Sie den \emph{EndNote Import from JabRef Filter}.
1481 Folgen Sie den Anweisungen im Abschnitt \nameref{EndNote_erweitert}. Um die Datei in
1482 EndNote zu öffnen, erstellen Sie eine neue Datei oder öffnen eine
1483 bestehende Datei in EndNote. Dann wählen Sie \menu{Datei} \msep{}
1484 \menu{Importieren}, klicken auf \menu{Datei wählen}, wählen die
1485 exportierte Datei aus und drücken auf \menu{Auswählen}. Anschließend
1486 drücken Sie auf \menu{Import Optionen} und wählen \menu{EndNote Import from JabRef}.
1487 (Falls dieser Eintrag nicht erscheint, wählen Sie \menu{Weitere Filter}.
1488 Wenn er dann immer noch nicht erscheint, wurde der Filter nicht korrekt
1489 installiert.) Klicken Sie schließlich auf \menu{Importieren}, um
1490 den Importvorgang zu starten.
1493 Der EndNote Exportfilter ordnet \bibtex{}-Eintragstypen folgenden
1494 EndNote-Re\-fe\-renz\-ty\-pen zu:
1497 \begin{center}\begin{tabular}{ll}
1498 \textbf{\bibtex{}-Eintragstyp}&
1499 \textbf{Endnote-Referenztyp}\tabularnewline
1501 Generic\tabularnewline
1503 Manuscript\tabularnewline
1505 Computer Program\tabularnewline
1507 Journal Article\tabularnewline
1511 Personal Communication\tabularnewline
1512 inbook, incollection&
1513 Book Section\tabularnewline
1515 Conference Proceedings\tabularnewline
1517 Report\tabularnewline
1518 mastersthesis, phdthesis~&
1519 Thesis\tabularnewline
1520 \end{tabular} \end{center}
1523 \noindent In der Standardeinstellung geht der Exportfilter davon aus,
1524 dass Einträge in den Feldern \emph{author} oder \emph{editor}, die
1525 geklammert sind, mehrere Autoren enthalten und ersetzt die Klammern
1526 durch ein angehängtes Komma. Dadurch werden Einträge, die \LaTeX{}-Befehle
1527 mit Klammern enthalten, als Eintrag mit mehreren Autoren gewertet
1528 und demzufolge unpassend formatiert.
1530 \subsubsection{Erweiterte Benutzung: EndNote Extras}
1532 \label{EndNote_erweitert}Einige Felder, die von \bibtex{} genutzt
1533 werden, gehören nicht zu EndNotes vorgegebenen Referenztypen. Während
1534 der Import in \jabref und der Export nach \jabref ohne ein Ändern
1535 der Referenztypen funktioniert, werden die Feldnamen in EndNote nicht
1536 korrekt dargestellt (z.\,B. wird das PDF-Feld \emph{Custom 1} heißen
1537 statt \emph{pdf}). Darüber hinaus können diese Felder bei neuen Einträgen
1538 in EndNote nicht genutzt werden, weil sie nicht im Eintragsdialog
1539 erscheinen. Der vorgegebene Importfilter von EndNote kann darüberhinaus
1540 das Feld \emph{author} nicht richtig analysieren. Der \emph{EndNote
1541 Import from JabRef Filter} kann dies. Außerdem erkennt dieser Filter
1542 ein Feld \texttt{endnotereftype}, das die vorgegebene Zuordnung überschreibt.
1543 Um den Filter zu installieren, nutzen Sie die EndNote Extras
1544 (\menu{Extras \msep{} EndNote Filter-Set entpacken})
1545 und entpacken die Zip-Datei, die dabei erstellt wird. Dann folgen
1546 Sie den Angaben in der Datei \texttt{readme.txt}.
1548 \subsubsection{\jabref-Bibliographien in OpenOffice.org benutzen}
1550 \jabref kann Ihre Datei sowohl in das OpenOffice.org 1.1 \texttt{.sxc}"=Tabellenkalkulationsformat als auch in das OpenDocument \texttt{.ods}"=Tabellenkalkulationsformat, das von OpenOffice.org 2.0 benutzt wird, exportieren.
1552 In beiden Fällen besteht die exportierte Tabelle aus einem Arbeitsblatt, das die Einträge in Reihen
1553 und die unterschiedlichen Felder in Spalten enthält. Die Reihenfolge und Benennung der Spalten ist kompatibel
1554 zu den Literaturverzeichnis-Funktionen von OpenOffice.org (OOo 1.1: \texttt{.sxc}, OOo 2.0: \texttt{.ods}).
1556 \paragraph{Die exportierte Datei als Bibliographiedatenbank in OpenOffice 2.0 (oder neuer) benutzen}
1557 Gehen Sie folgendermaßen vor, um eine Tabelle, die von \jabref exportiert wurde, als Bibliographiedatenbank in OpenOffice.org zu benutzen:
1560 \item Exportieren Sie Ihre Datenbank in das \texttt{.ods} -Format.
1561 \item Starten Sie OpenOffice.org.
1562 \item Wählen Sie \menu{Extras} \msep{} \menu{Optionen} \msep{} \menu{OpenOffice.org Base} \msep{} \menu{Datenbanken}.
1563 \item Bearbeiten Sie die \emph{Bibliography}-Datenbank und ändern ihren Namen z.\,B. in \emph{Bibliographie-alt}.
1564 \item Schließen Sie das Fenster \menu{Optionen} und gehen Sie zu \menu{Datei} \msep{} \menu{Neu} \msep{} \menu{Datenbank}.
1565 \item Dann wählen Sie \menu{Verbindung zu einer bestehenden Datenbank herstellen}, nehmen \menu{Tabellendokument} als
1566 Datenbanktyp und wählen die \texttt{.ods}-Datei, die Sie exportiert haben.
1567 \item Klicken Sie auf \menu{Fertig stellen} und wählen den Namen \emph{Bibliography} im Speicherdialog.
1569 Anschließend wählen Sie \menu{Extras} \msep{} \menu{Literaturdatenbank}. Ihre Datenbank sollte nun angezeigt werden.
1571 \paragraph{Eine exportierte Datei als Datenbank in OpenOffice 1.1.x benutzen}
1574 \item Exportieren Sie Ihre Datei in das \texttt{.sxc}-Format.
1575 \item Starten Sie OpenOffice.org.
1576 \item Wählen Sie \menu{Extras} \msep{} \menu{Datenquellen}.
1577 \item Wählen Sie die \emph{Bibliography}-Datei und ändern ihren Namen beispielsweise in \emph{Bibliographie-alt}.
1578 \item Drücken Sie \menu{Anwenden}.
1579 \item Klicken Sie \menu{Neue Datenquelle}. Ein neuer Eintrag erscheint. Ändern Sie den Namen zu \emph{Bibliography}.
1580 \item Ändern Sie den \menu{Dateityp} zu \menu{Tabelle}. Klicken Sie den \menu{\ldots}-Button in der Zeile \menu{Datenquellen URL}. Wählen Sie die \texttt{.sxc}-Datei, die Sie exportiert haben.
1581 \item Klicken Sie auf \menu{OK}, um das Fenster \menu{Datenquellen} zu schließen.
1583 Anschließend wählen Sie \menu{Extras} \msep{} \menu{Literaturdatenbank}.
1584 Ihre Datenbank sollte nun angezeigt werden.
1586 \subsubsection{Klartext-Import}
1589 \emph{Sie können aus einfachen Text-Dateien oder der Zwischenablage
1590 einen Importvorgang starten, indem Sie \menu{BibTeX}} \msep{} \emph{\menu{Neuer Eintrag aus Klartext}
1591 oder die Tastenkombination STRG-SHIFT-N wählen.}
1593 Dieser Dialog ermöglicht das schnelle Einfügen von Einträgen aus normalem
1594 Text. Wählen Sie zunächst aus, welcher Eintragstyp erstellt werden
1595 soll. Fügen Sie dann einfach Text aus der Zwischenablage ein (über das
1596 Kontextmenü im Textfeld mit der Wasserzeichenschrift >>Text einfügen<<
1597 oder über den Button \menu{Einfügen}). Alternativ können Sie über den Button
1598 \menu{Datei öffnen} eine Datei auswählen, um sie in den Dialog zu laden.
1600 Jetzt markieren Sie z.\,B. den Textbereich, der zum Titel des neuen
1601 Eintrags werden soll, und führen im rechten Teil des Dialogfensters
1602 im Bereich \menu{Verfügbare BibTeX"=Felder} einen Doppelklick auf \emph{title} aus.
1603 So gehen Sie für alle weiteren Felder des neuen Eintrags vor. Sie
1604 können einem Feld natürlich auch mehrere Textbereiche zuordnen. Achten
1605 Sie dazu darauf, dass die Option \menu{anfügen} aktiviert ist, ansonsten
1606 wird bei jedem neuen Zuweisen von Textbereichen das Feld überschrieben
1607 (Option \menu{überschreiben}).
1609 Bereits zugewiesene Textteile werden im Tab \menu{Importtext} blau
1610 hervorgehoben. Um zu kontrollieren, welche Textbereiche Sie einem
1611 bestimmten \bibtex{}-Feld zugewiesen haben, wählen Sie das Feld im
1612 rechten Bereich aus; der zugeordnete Text wird nun rot hervorgehoben.
1614 Sie können sich das Ergebnis des Importvorgangs jederzeit im Tab \menu{BibTeX"=Quelltext}
1615 des Importdialogs ansehen. Hier können keine Änderungen vorgenommen
1616 werden; das ist erst möglich, sobald der Text tatsächlich importiert
1617 und ein neuer Eintrag angelegt wurde. Auf mögliche Fehler werden Sie
1618 im Tab \menu{Hinweise und Warnungen} aufmerksam gemacht.
1620 Haben Sie alle Textstellen den gewünschten \bibtex{}-Feldern zugewiesen,
1621 klicken Sie auf die Schaltfläche \menu{Übernehmen}. Nun erstellt
1622 \jabref den neuen Eintrag, der allerdings noch keinen \bibtex{}-Key
1625 \subsection{Links zu PDF- und PS"=Dateien, URLs und DOIs}
1626 \label{ExternalFiles}
1628 \tip[Anmerkung: ]{Ab \jabref 2.3 gibt es ein verbessertes System für Links zu externen Dateien; siehe dazu den Abschnitt ">\nameref{FileLinks}"<.}
1630 \noindent Mit \jabref können Sie Ihre Einträge mit
1631 den entsprechenden PDF- oder PS-Dateien, die sich auf Ihrem Computer
1632 befinden, verlinken. Ebenso ist es möglich, Dateien im Internet über
1633 einen URL oder DOI zu verlinken.
1636 \subsubsection{Externe Betrachter einrichten}
1638 \jabref benötigt Informationen darüber, welche Programme es für
1639 PDF- und PS"=Dateien und Internetseiten benutzen soll. In der Standardeinstellung
1640 werden sie auf Werte gesetzt, die wahrscheinlich zu Ihrem Betriebssystem
1641 passen, so dass eine gute Chance besteht, dass Sie diese Werte nicht
1642 zu verändern brauchen.
1645 \emph{Um die Einstellungen der externen Programme zu ändern, öffnen
1646 Sie den Unterpunkt \menu{Externe Programme} im Dialog \menu{Optionen}}
1647 \msep{} \emph{\menu{Einstellungen}.}
1650 \subsubsection{Externe Dateien oder Links öffnen}
1652 Es gibt verschiedene Möglichkeiten, wie man externe Dateien oder Internetseiten
1653 aus \jabref öffnen kann. Im Eintrags-Editor können Sie einfach
1654 auf das Textfeld, das einen DOI oder URL enthält, doppelklicken. In
1655 der Tabellenansicht können Sie einen Eintrag auswählen und die Menüeinträge
1656 (unter \menu{Extras}), die Tastenkombinationen (in der Standardeinstellung
1657 F4 für PDF/PS und F3 für DOI/URL) oder das Kontextmenü (mit der rechten
1658 Maustaste) benutzen, um die Datei oder Internetseite zu öffnen. Schließlich
1659 können Sie auch auf ein PDF-, PS-, URL- oder DOI-Icon in der Tabelle
1662 In der Standardeinstellung zeigt die Tabellenansicht zwei Spalten
1663 mit Icons für die Einträge, die mit externen Dateien oder URLs verlinkt
1664 sind. Beide Spalten können im Unterpunkt \menu{Tabellenansicht} des
1665 Dialogs \menu{Optionen} \msep{} \menu{Einstellungen} ausgeblendet
1666 werden. Die zweite Spalte zeigt Icons für PDF- oder PS-Dateien (nur
1667 PDF, wenn beide vorhanden sind), die dritte Spalte zeigt Icons für
1668 URL oder DOI (nur URL, wenn beide vorhanden sind).
1671 \subsubsection{Der Standard-Ordner für PDF-Dateien}
1673 PDF-Dateien erhalten von \jabref eine >>Spezialbehandlung<<,
1674 um das Verlinken mit den entsprechenden Einträgen so einfach wie möglich
1675 zu gestalten. Um diese >>Spezialbehandlung<< nutzen zu können, müssen
1676 Sie im Unterpunkt \menu{Externe Programme} des Dialogs \menu{Optionen}
1677 \msep{} \menu{Einstellungen} einen Ordner als Standard-Ordner für
1678 Ihre PDF-Dateien angeben. Alle PDF-Dateien, die in diesem Ordner oder
1679 einem Unterordner gespeichert sind, werden mit einer relativen Pfadangabe
1680 referenziert, so dass Sie problemlos PDF-Verzeichnisse verschieben
1681 oder mit mehreren Benutzern von verschiedenen Netzwerkarbeitsplätzen
1682 aus an derselben Datei arbeiten können.
1684 Wenn Sie Ihren PDF-Dateien dann noch Namen geben, die mit dem \bibtex{}-Key
1685 des entsprechenden Eintrags übereinstimmen (abgesehen von der Dateiendung \texttt{.pdf}),
1686 sucht \jabref in Ihrem Standard-PDF-Ordner und dessen
1687 Unterordnern nach der richtigen PDF-Datei. Sobald die korrekt benannte
1688 PDF-Datei sich dort befindet, klicken Sie auf die Schaltfläche \menu{Auto}
1689 neben dem PDF-Feld im Eintrags-Editor. Wenn die PDF-Datei gefunden
1690 wird, wird das Feld entsprechend gesetzt.
1692 Wenn Sie eine PDF-Datei wie beschrieben benennen, können Sie sie auch
1693 öffnen, ohne das PDF-Feld überhaupt zu benutzen. Der Nachteil ist
1694 in diesem Fall allerdings, dass das PDF-Icon in der Tabellenansicht
1695 nicht angezeigt wird, solange das PDF-Feld leer bleibt.
1697 \subsubsection{Dateispezifische PDF- und PS-Verzeichnisse}
1699 Sie können für jede Datei eigene PDF- und PS-Verzeichnisse angeben \emph{(}\menu{Datei \msep{} Eigenschaften der Datei}\emph{)}. Diese Verzeichnisse ersetzen dann die Standardverzeichnisse.
1701 \subsubsection{Die Suche mit regulären Ausdrücken für automatische Verknüpfungen nutzen}
1702 \label{RegularExpressionSearch}
1704 Wenn Sie Dateinamen verwenden, die dem bibtexkey ergänzt um die Dateiendung entsprechen, findet \jabref diese Dateien automatisch.
1706 Ab Version~2.2 ist mit Hilfe von regulären Ausdrücken eine größere Flexibilität beim Benennen der Dateien gewährleistet. In den meisten Fällen dürfte das Standardverhalten bereits ausreichend sein.
1708 In den Einstellungen zu externen Programmen \emph{(}\menu{Optionen \msep{} Einstellungen \msep{} Externe Programme}\emph{)} findet sich eine Option ">Suche mit regulärem Ausdruck benutzen"<. Wenn Sie diese Option aktivieren, können Sie für die Suche in PDF-Verzeichnissen einen eigenen regulären Ausdruck angeben.
1710 Die folgende Syntax wird verwendet:
1712 \begin{labeling}{MextensionM}
1713 \item [\texttt{*}] Suche in allen direkten Unterverzeichnissen, NICHT im aktuellen Verzeichnis und in Unterverzeichnissen zweiter oder tieferer Ebene.
1714 \item [\texttt{**}] Rekursive Suche in allen Unterverzeichnissen UND im aktuellen Verzeichnis.
1715 \item [\texttt{.}] Das aktuelle Verzeichnis.
1716 \item [\texttt{..}] Das Elternverzeichnis (eine Ebene höher).
1717 \item [\texttt{{[}title{]}}] Alle Ausdrücke in eckigen Klammern werden durch den Inhalt des entsprechenden Felds ersetzt.
1718 \item [\texttt{{[}extension{]}}] Wird durch die Dateiendung des Feldes, das Sie benutzen, ersetzt.
1719 \item Anderer Text wird als regulärer Ausdruck interpretiert. Aber Vorsicht: \emph{backslashes} müssen mit einem weiteren \emph{backslash} \emph{escaped} werden (\texttt{\textbackslash\textbackslash}), damit sie nicht mit Separatoren in Pfad-Angaben verwechselt werden.
1721 Der Standard ist \lstinline{**/.*[bibtexkey].*\\.[extension]}. Damit wird in allen Unterverzeichnissen des Ordners der entsprechenden Dateiendung (z.\,B. das PDF-Verzeichnis) nach allen Dateien mit der richtigen Dateiendung gesucht, die den bibtexkey in ihrem Namen haben.
1723 \subsection{Links zu externen Dateien (ab Version 2.3)}
1726 \jabref lässt Sie Ihre Einträge mit Dateien jeden Typs verlinken, die Sie auf Ihrem System gespeichert haben. Außerdem sind Links zu Dokumenten im Internet in der Form eines URL oder eines DOI möglich. Jedem Eintrag kann eine beliebige Anzahl von Datei-Links zugeordnet werden und jede verlinkte Datei kann schnell aus JabRef heraus geöffnet werden.
1728 Was \bibtex angeht, werden die Datei"=Links eines Eintrags in ein einzelnes Feld geschrieben. In \jabref erscheinen sie aber als editierbare Liste von Links, die im Eintrags"=Editor zugänglich sind.
1730 \subsubsection{Einrichten der Dateitypen}
1732 Für jeden Datei"=Link muss ein Dateityp gewählt werden, damit das richtige Programm zum Öffnen der Datei und das entsprechende Icon gefunden werden. Die Liste der Dateitypen können Sie einsehen und bearbeiten, indem Sie \menu{Optionen \msep Externe Dateitypen verwalten} wählen oder auf die Schaltfläche \menu{Externe Dateitypen verwalten} im Bereich \menu{Externe Programme} des Einstellungs"=Dialogs klicken.
1734 Ein Dateityp besteht aus einem Namen, einem graphischen Icon, einer Dateierweiterung und einer Anwendung zum Öffnen der Dateien. Wenn Sie Windows benutzen, können Sie den Namen der Anwendung weglassen, wenn Sie das Standardprogramm verwenden wollen.
1736 \subsubsection{Datei"=Links zu einem Eintrag hinzufügen}
1738 Wenn bei den Allgemeinen Feldern (siehe Abschnitt~\ref{GeneralFields}) das Feld \texttt{file} eingetragen ist, können Sie die Liste der externen Links im \nameref{EntryEditorHelp} bearbeiten. Der Editor hat dann Schaltflächen zum Einfügen, Bearbeiten, Löschen und Sortieren der Links.
1740 Eine Datei kann mit Hilfe der \menu{Auto}"=Schaltfläche automatisch verlinkt werden, falls sie in Ihrem Dateiverzeichnis (\menu{Einstellungen \msep Externe Programme \msep Links zu externen Dateien \msep Hauptverzeichnis}) oder einem Unterordner liegt, eine Dateierweiterung hat, die \jabref bekannt ist, und einen Namen hat, der mit dem BibTeX"=Key des Eintrags übereinstimmt. Die Regeln, nach denen Dateinamen mit BibTeX"=Keys automatisch verknüpft werden, können eingestellt werden unter \menu{Einstellungen \msep Externe Programme \msep Links zu externen Dateien \msep Suche mit regulärem Ausdruck benutzen}.
1742 Um eine Datei herunterzuladen und mit einem Eintrag zu verlinken, benutzen Sie die Schaltfläche \menu{Download} im Eintrags"=Editor. Es erscheint ein Dialog, in dem Sie den URL eingeben müssen. Die Datei wird dann in Ihr Hauptverzeichnis gespeichert, anhand des BibTeX-Keys benannt und mit dem Eintrag verknüpft.
1744 \subsubsection{Externe Dateien öffnen}
1746 Es gibt mehrere Möglichkeiten, externe Dateien oder Internetseiten zu öffnen. In der Tabellenansicht können Sie einen Eintrag auswählen und mit dem Menü, einem Tastenkürzel oder dem Kontextmenü den ersten externen Link öffnen. Falls in der Tabellenansicht die Spalte \texttt{file} angezeigt wird (\menu{Einstellungen \msep Tabellenansicht \msep Spezielle Spalten \msep Datei"=Spalten anzeigen}), können Sie auch auf das Icon klicken, um den ersten Link eines Eintrags zu öffnen. Um weitere Links zu öffnen, klicken Sie mit der rechten Maustaste auf das Icon (Mac OS X: \menu{Strg-Klick}); es erscheint dann ein Menü mit allen Links.
1748 \subsection{XMP-Metadaten}
1751 XMP ist ein Standard, der von Adobe Systems entwickelt wurde, um Metadaten (Daten, die Informationen über andere Daten enthalten) in Dateien zu speichern. Ein bekanntes Beispiel für Metadaten sind ID3-Tags, die zur Beschreibung von Künstlern, Albumtiteln und Liednamen einer MP3-Datei verwendet werden. Mit Hilfe von Metadaten können MP3-Dateien unabhängig von ihrem Dateinamen identifiziert und z.B. von MP3-Playern ausgelesen und angezeigt werden.
1753 Mit der XMP-Unterstützung versucht das \jabref-Team, die Vorteile von Metadaten in die Welt der Literaturmanager einzuführen. Sie können \menu{XMP schreiben} im \menu{Allgemein}-Tab des Eintragseditors wählen und damit alle \bibtex{}-Informationen in die verlinkte PDF-Datei schreiben. Wenn Sie diese PDF-Datei mit anderen austauschen, können diese die Datei in das \jabref-Fenster ziehen und haben damit alle Informationen zur Verfügung, die Sie eingegeben haben.
1755 \subsubsection{Benutzung}
1757 Um die XMP-Funktionen in \jabref zu nutzen, gehen Sie folgendermaßen vor:
1760 \item Zum \emph{Importieren einer einzelnen PDF-Datei mit Metadaten} wählen Sie \menu{Datei \msep{} Importieren in {[}neue{|}aktuelle{]} Datenbank} und im anschließenden Dialog als Dateiformat \menu{PDF mit XMP-Anmerkungen} aus. Sie können die PDF-Datei stattdessen auch mit der Maus auf das Hauptfenster von \jabref ziehen.
1761 \item Um \emph{bibliographische Informationen in eine verlinkte PDF-Datei zu schreiben}, klicken Sie auf \menu{XMP schreiben} im \menu{Allgemein}-Tab des Eintragseditors (neben dem \emph{pdf}"=Feld).
1762 \item Wenn Sie \emph{alle PDFs einer Datei mit Metadaten versehen} wollen, wählen Sie \menu{Extras \msep{} XMP-Metadaten in PDFs schreiben}.
1763 \item Um zu überprüfen, ob das Schreiben der Metadaten funktioniert hat, öffnen Sie die Datei in Adobe Acrobat und wählen \menu{Datei \msep{} Dokumenteigenschaften} und dann unter dem Reiter \menu{Beschreibung} die Schaltfläche \menu{Zusätzliche Metadaten}. Wenn Sie links ">Erweitert"< auswählen, sollten Sie im rechten Teil des Dialogs einen Eintrag \texttt{http://jabref.sourceforge.net/bibteXMP} sehen, der die entsprechenden Metadaten enthält. Dies geht nur mit dem Vollprogramm Adobe Acrobat, nicht mit dem Adobe Reader.
1764 \item Wer kein Adobe Acrobat zur Verfügung hat, kann stattdessen das Programm ">pdfinfo"<\footnote{Dieses Programm ist Teil von \href{http://www.foolabs.com/xpdf/}{Xpdf} und \href{http://poppler.freedesktop.org/}{Poppler}.} verwenden, um die XMP-Metadaten zu überprüfen. Rufen Sie dazu auf der Kommandozeile einfach \lstinline{pdfinfo -meta <PDF-Datei>} auf, dann werden die entsprechenden Metadaten angezeigt.
1767 \subsubsection{bibteXMP Dateiformat}
1769 XMP nutzt zum Speichern der Daten eine Teilmenge des \emph{Resource Description Framework} (RDF). Für \jabref wird ein neues Metadatenformat benutzt, das \bibtex{} sehr gut abbildet. Alle Felder und Werte werden in Knoten eines XML-Dokuments verwandelt. Nur Autoren und Herausgeber werden als \texttt{rdf:Seq}-Strukturen gespeichert, so dass die trennenden ">and"< weggelassen werden können. Alle Strings und crossrefs werden in den Metadaten aufgelöst.
1771 Das folgende einfache Minimal-Schema wird benutzt:
1773 \item Der \bibtex{}-Key wird als \texttt{bibtexkey} gespeichert.
1774 \item Der Eintragstyp wird als \texttt{entrytype} gespeichert.
1775 \item \texttt{author} und \texttt{editor} sind kodiert als \texttt{rdf:Seq}, wobei die einzelnen Autoren und Herausgeber als \texttt{rdf:li}s dargestellt werden.
1776 \item Alle anderen Felder werden unter ihrem Feld-Namen gespeichert.
1779 Es folgt ein Beispiel:
1781 @INPROCEEDINGS{CroAnnHow05,
1782 author = {Crowston, K. and Annabi, H. and Howison, J. and Masango, C.},
1783 title = {Effective work practices for floss development: A model and propositions},
1784 booktitle = {Hawaii International Conference On System Sciences (HICSS)},
1787 timestamp = {2006.05.29},
1788 url = {http://james.howison.name/publications.html}
1795 <rdf:Description xmlns:bibtex="http://jabref.sourceforge.net/bibteXMP/"
1796 bibtex:bibtexkey="CroAnnHow05"
1797 bibtex:year="2005"
1798 bibtex:title="Effective work practices for floss development: A model and propositions"
1799 bibtex:owner="oezbek"
1800 bibtex:url="http://james.howison.name/publications.html"
1801 bibtex:booktitle="Hawaii International Conference On System Sciences (HICSS)"
1802 bibtex:timestamp="2006.05.29">
1803 <bibtex:author>
1805 <rdf:li>K. Crowston</rdf:li>
1806 <rdf:li>H. Annabi</rdf:li>
1807 <rdf:li>J. Howison</rdf:li>
1808 <rdf:li>C. Masango</rdf:li>
1810 </bibtex:author>
1811 <bibtex:entrytype>Inproceedings</bibtex:entrytype>
1812 </rdf:Description>
1815 Wenn Sie bibteXMP parsen möchten, beachten Sie, dass in RDF Attribut-Wert-Paare auch als Knoten wiedergegeben werden können und vice versa.
1817 \subsubsection{Weiterführende Links}
1819 Einige Links zu XMP und PDFs mit Anmerkungen (englisch):
1822 \item James Howison's Blog \href{http://freelancepropaganda.com/themp/}{">Themp---Managing Academic Papers like MP3s"<}
1823 \item \href{http://www.xml.com/pub/a/2004/09/22/xmp.html}{XML.com-Artikel} zu XMP
1824 \item \href{http://jempbox.org}{JempBox} und \href{http://pdfbox.org}{PDFBox} von Ben Litchfield (Java libraries zum Zugriff auf die PDFs und die Metadaten)
1825 \item Gute \href{http://episteme.arstechnica.com/eve/ubb.x/a/tpc/f/8300945231/m/377001889631}{Diskussion bei ArsTechnica} zum Management von PDFs.
1826 \item \href{http://partners.adobe.com/public/developer/en/xmp/sdk/xmpspecification.pdf}{Adobe XMP Spezifikation}
1829 \subsection{\jabref und Online-Datenbanken}
1831 \subsubsection{CiteSeer}
1833 \label{CiteSeerHelp}
1834 \tip[]{CiteSeer ist eine digitale Bibliothek und Suchmaschine für wissenschaftliche Literatur, vornehmlich zu den Bereichen Computer und Informatik.}
1835 \jabref kann Informationen über eine bestimmte
1836 Literaturangabe aus der CiteSeer-Datenbank herunterladen. Um diesen
1837 Vorgang zu starten, fügen Sie Ihrer Datei einen neuen Eintrag hinzu
1838 und belegen das Feld \emph{citeseerurl} mit einem Link zur entsprechenden
1839 Inhaltsseite auf CiteSeer. Das Feld \emph{citeseerurl} muss in einem
1840 der folgenden Formate eingegeben werden:
1843 http://citeseer.ist.psu.edu/DDDDDD[.html] % oder
1844 oai:CiteSeerPSU:DDDDDD % oder
1847 wobei DDDDDD eine Ziffernfolge darstellt. Um diese Ziffernfolge für
1848 einen CiteSeer-Eintrag zu finden, gehen Sie auf die Dokumentseite
1849 der Literaturangabe des Formats \texttt{http://citeseer.ist.psu.edu/}\texttt{\emph{nameYearTitle}}\texttt{.html}
1850 und klicken den (Update)"=Link für diese Literaturangabe. Die URL
1851 für den Update-Link beinhaltet die numerische ID für diese Literaturangabe.
1853 Sobald Sie das Feld \emph{citeseerurl} belegt haben, können Sie die
1854 CiteSeer-Felder herunterladen, indem Sie \menu{BibTeX} \msep{} \menu{Felder von CiteSeer importieren}
1855 auswählen. Achten Sie darauf, dass Sie die Zeile(n) ausgewählt haben,
1856 die Sie aktualisieren wollen.
1858 \paragraph{Eine Datei mit zitierenden Literaturangaben erzeugen}
1860 Mit einem Satz von Literaturangaben können Sie eine Liste der Dokumente
1861 erzeugen, die die einzelnen Literaturangaben ihrerseits zitieren. Dazu
1862 muss jede Literaturangabe der entsprechenden Datenbank-Datei ein
1863 ausgefülltes citeseerurl-Feld besitzen, dessen Inhalt dem oben
1864 beschriebenen Format entspricht. Sie können diese Funktion nutzen, indem
1865 Sie \menu{Zitierende Literatur von CiteSeer abrufen} auswählen.
1867 \subsubsection{Medline}
1870 \tip[]{MEDLINE ist die wichtigste Datenbank der \emph{U.\,S. National Library of Medicine}. Sie enthält Literaturangaben von Zeitschriftenartikeln der Lebenswissenschaften, vornehmlich der Biomedizin.
1871 \jabref kann Literaturangaben der Medline"=Datenbank
1872 herunterladen. Um diese Funktion zu nutzen, wählen Sie \menu{Extras
1873 \msep{} Medline abrufen}, so dass der Medline-Dialog im linken
1874 Seitenfeld erscheint.}
1875 Es gibt zwei Möglichkeiten, die Auswahl der Einträge vorzunehmen,
1876 die heruntergeladen werden sollen:
1879 \item Geben Sie eine oder mehr Medline IDs (getrennt durch Komma/Semikolon)
1880 in das Textfeld ein.
1881 \item Geben Sie Namen oder Wörter ein, nach denen gesucht werden soll. Sie
1882 können dazu die Operatoren \texttt{AND} und \texttt{OR} sowie Klammern
1883 benutzen, um Ihren Suchbegriff zu verfeinern.
1885 In beiden Fällen drücken Sie dann ENTER oder die Schaltfläche \menu{Abrufen}.
1886 Wenn Sie eine Textsuche durchführen, wird Ihnen die Anzahl der gefundenen
1887 Einträge angezeigt, und Sie können wählen, wie viele Sie herunterladen
1890 Die abgerufenen Einträge werden Ihrer zu diesem Zeitpunkt aktivierten
1893 \subsubsection{IEEEXplore}
1894 \label{IEEEXploreHelp}
1896 \tip[]{IEEEXplore bietet Zugang zu Literatur in den Bereichen Elektrotechnik, Informatik und Elektronik.}
1897 \jabref kann Literaturangaben der IEEEXplore-Datenbank herunterladen.
1898 Um diese Funktion zu nutzen, wählen Sie \menu{Internet \msep{} IEEEXplore abfragen}
1899 und geben in dem Dialog, der im linken Bildschirmbereich erscheint, Ihre
1900 Suchausdrücke ein. Drücken Sie anschließend die
1901 ENTER-Taste oder den \menu{Abrufen}-Button.
1903 Die Suche wird im Gäste-Modus durchgeführt, es werden also maximal 100 Ergebnisse
1906 Sie können die \emph{abstracts} zusammen mit den Literaturangaben herunterladen,
1907 indem Sie einen Haken bei \menu{Abstracts berücksichtigen} setzen. Das verursacht
1908 eine deutlich höhere Anzahl von Netzwerk-Anfragen; um die Webseite von IEEEXplore
1909 nicht übermäßig zu belasten, lädt \jabref \emph{abstracts} nur bei einer Suche,
1910 deren Ergebnis eine bestimmte Trefferanzahl nicht übersteigt.
1912 \subsubsection{Benutzung eines Proxy-Servers}
1914 Wenn Sie einen HTTP-Proxy-Server benutzen müssen, übergeben Sie den
1915 Servernamen und die Portnummer an Java. Diese Umgebungseinstellungen
1916 sind dokumentiert unter \url{http://java.sun.com/j2se/1.4.2/docs/guide/net/properties.html}
1919 java -Dhttp.proxyHost="hostname" -Dhttp.proxyPort="portnumber"
1922 \subsection{\jabref mit mehreren Benutzern verwenden}
1924 \jabref bietet einige Funktionen, die besonders dann von Nutzen
1925 sind, wenn eine Datenbank von mehreren Benutzern~-- z.\,B. über
1926 ein Netzwerk~-- bearbeitet wird. Das sind vor allem die Felder \emph{owner}
1927 und \emph{timestamp}.
1930 \subsubsection{Zeitstempel \emph{(timestamp)}}
1931 \label{TimeStampHelp}
1934 \emph{Die Benutzung des Zeitstempels kann unter
1935 \menu{Einstellungen}} \msep{} \emph{\menu{Allgemein} an- und
1936 abgestellt sowie verändert werden.}
1938 \jabref kann automatisch das Feld \emph{timestamp} setzen, das
1939 das Datum enthält, an dem der Eintrag zur Datei hinzugefügt wurde.
1940 Die Formatierung des Zeitstempels wird von einem Ausdruck mit Bezeichnern
1941 bestimmt, die die Position verschiedener Bestandteile des Datums angeben.
1942 Es folgen einige der verfügbaren Bezeichner (die Beispiele in Klammern
1943 beziehen sich auf Mittwoch, den 14. September 2005, 17:45 Uhr):
1945 \begin{labeling}{00.00.0000}
1946 \item [\texttt{yy}]Jahr (05)
1947 \item [\texttt{yyyy}]Jahr (2005)
1948 \item [\texttt{MM}]Monat (09)
1949 \item [\texttt{dd}]Tag (14)
1950 \item [\texttt{HH}]Stunde (17)
1951 \item [\texttt{mm}]Minute (45)
1953 Diese Bezeichner können mit Interpunktion und Leerzeichen kombiniert
1954 werden. Hier einige Beispiele:
1956 \begin{labeling}{dd.MM.yyyy-HH:m}
1957 \item [\texttt{yyyy.MM.dd}]$\to$ 2005.09.14
1958 \item [\texttt{yy-MM-dd}]$\to$ 05-09-14
1959 \item [\texttt{dd.MM.yyyy~HH:mm}]$\to$ 14.09.2005 17:45
1962 \subsubsection{Besitzer \emph{(owner)}}
1964 \label{OwnerHelp}\jabref kann allen neuen Einträgen, die zu einer
1965 Datei hinzugefügt oder in sie importiert werden, Ihren Benutzernamen
1966 beigeben. Diese Funktion können Sie im Menü \menu{Einstellungen}
1967 \msep{} \menu{Allgemein} ein- und ausschalten. Dort können Sie auch
1968 den Namen angeben, der in den Einträgen erscheinen soll.
1970 In der Standardeinstellung wird Ihr (System-)Benutzername verwendet.
1971 Der Name wird in dem Feld \emph{owner} eingetragen, das in der Standardeinstellung
1972 im Tab \emph{General fields} des Eintragseditors angezeigt wird.
1975 \subsection{\jabref von der Kommandozeile}
1977 \label{CommandLine}Obwohl \jabref in erster Linie ein Programm
1978 mit grafischer Benutzeroberfläche ist, bietet es einige nützliche
1979 Optionen für die Kommandozeile und kann sogar Dateikonvertierungen
1980 durchführen, ohne die grafische Benutzeroberfläche zu öffnen.
1982 Sie können eine oder mehrere \bibtex{}-Dateien laden, indem Sie auf
1983 der Kommandozeile die entsprechenden Dateinamen auflisten. Achten
1984 Sie darauf, alle gewünschten Optionen anzugeben, bevor Sie die Dateinamen
1985 anfügen. Außerdem müssen Sie sich vergewissern, dass der erste Dateiname
1986 nicht als Argument einer Option missverstanden werden kann~-- falls
1987 eine Bool'sche Option wie \texttt{-n} oder \texttt{-l} direkt vor
1988 einem Dateinamen steht, müssen Sie also \texttt{true} als Argument
1989 angeben. Das Beispielkommando:
1992 jabref -o filetoexport.xml,docbook -n true original.bib
1994 lädt die Datei \texttt{original.bib}, exportiert sie in das Docbook-Format,
1995 speichert sie unter dem Namen \texttt{filetoexport.xml} und unterdrückt
1996 das Laden der grafischen Oberfläche. Das Word \emph{true} verhindert,
1997 dass der Dateiname als Argument der Option \texttt{-n} interpretiert
2001 \subsubsection{Kommandozeilen-Optionen}
2002 \label{kommandozeilenoptionen}
2003 Im folgenden werden die wichtigsten Optionen und Befehle für die Kommandozeile
2007 \item Hilfe: \texttt{-h}
2009 Diese Option veranlasst \jabref, eine Zusammenfassung der Kommandozeilen-Optionen
2010 anzuzeigen und das Programm unmittelbar darauf zu schließen.
2012 \item Kein GUI-Modus: \texttt{-n}
2014 Diese Option unterdrückt sowohl das \jabref-Fenster als auch den
2015 Eröffnungsbildschirm, der normalerweise beim Programmstart angezeigt
2016 wird. Das Programm wird beendet, sobald die Kommandozeilen-Optionen
2017 abgearbeitet wurden.
2018 Diese Option ist nützlich, um Dateikonvertierungen von der Kommandozeile
2019 oder mit Hilfe eines Scripts durchzuführen.
2021 \item Sitzung laden: \texttt{-l}
2023 Diese Option veranlasst \jabref, eine gespeicherte Sitzung zu laden,
2024 sofern eine vorhanden ist, bevor sich das Hauptfenster öffnet.
2026 \item Datei importieren: \texttt{-i Dateiname{[},Importformat{]}}
2028 Bei dieser Option importiert oder lädt \jabref eine bestimmte Datei.
2029 Wenn nur ein Dateiname angegeben wird oder ein Komma und ein {*}-Zeichen
2030 hinter dem Dateinamen stehen, versucht \jabref, das Dateiformat
2031 automatisch zu erkennen. Das sollte bei allen \bibtex{}-Dateien ebenso
2032 funktionieren wie bei Dateien, die in einem der von \jabref unterstützten
2033 Importformate vorliegen. Wenn dem Dateinamen ein Komma und ein Importformat
2034 folgen, wird der angegebene Importfilter benutzt. Mit der Option \texttt{-h}
2035 können Sie sich eine Liste der verfügbaren Importformate anzeigen
2038 Wenn Sie zusätzlich eine Export-Option angeben, wird der Import immer
2039 zuerst ausgeführt, bevor die importierte oder geladene Datei an den
2040 Exportfilter übergeben wird. Falls die grafische Oberfläche nicht
2041 mit der Option \texttt{-n} unterdrückt wird, werden alle geladenen
2042 oder importierten Dateien im Hauptfenster von \jabref angezeigt.
2044 Die Option \texttt{-i} kann nur einmal angegeben werden und nimmt
2045 als Argument maximal eine Datei.
2047 \item Datei exportieren: \texttt{-o Dateiname{[},Exportformat{]}}
2049 Diese Option veranlasst \jabref, eine Datei zu speichern oder zu
2050 exportieren, die von derselben Kommandozeile geladen oder importiert
2051 wurde. Wenn eine Datei mit der Option \texttt{-i} importiert wurde,
2052 wird diese Datei exportiert. Ansonsten wird die Datei exportiert,
2053 die \emph{zuletzt}~-- ohne die Option \texttt{-i}~-- angegeben (und
2054 erfolgreich geladen) wurde.
2056 Wird nur ein Dateiname angegeben, so wird diese Datei im \bibtex{}-Format
2057 gespeichert. Wenn dem Dateinamen ein Komma und ein Exportformat folgen,
2058 wird der angegebene Exportfilter benutzt. Auf diese Weise wird auch
2059 ein benutzerdefinierter Exportfilter angewendet; wenn der Name sowohl
2060 auf einen Standard-Exportfilter, als auch auf einen benutzerdefinierten
2061 Exportfilter zutrifft, wird der benutzerdefinierte verwendet.
2063 Mit der Option \texttt{-h} können Sie sich eine Liste der verfügbaren
2064 Exportformate anzeigen lassen.
2066 Falls die Option \texttt{-n} nicht aufgerufen wurde, wird jeder Exportvorgang
2067 durchgeführt, bevor das \jabref-Fenster geöffnet wird. Dort werden
2068 dann die importierten Dateien angezeigt.
2070 Die Option \texttt{-o} kann nur einmal angegeben werden und nimmt
2071 als Argument maximal eine Datei.
2073 \item Einstellungen exportieren: \texttt{-x Dateiname}
2075 Mit dieser Option können Sie \jabref veranlassen, alle Benutzer-Einstellungen
2076 in eine XML-Datei zu speichern. Nach dem Export startet \jabref
2079 \item Einstellungen importieren: \texttt{-p Dateiname}
2081 Mit dieser Option importiert \jabref Benutzer-Einstellungen, die
2082 mit der Option \texttt{-x} exportiert wurden. Nach dem Import startet
2085 \item Nur benutzte Einträge exportieren: \texttt{-a Dateiname{[}.aux{]},neueBibDatei{[}.bib{]}}
2087 Manchmal ist es nützlich, eine \bibtex{}-Datei zu haben, die nur die
2088 benutzten Einträge enthält. Eine Liste dieser benutzten Einträge findet
2089 sich in einer .aux-Datei (sobald Sie \LaTeX{} aufgerufen haben). \jabref
2090 kann diese Datei analysieren, um eine neue \bibtex{}-Datei zu erstellen,
2091 die nur die bekannten und benutzten Einträge enthält. Das bedeutet,
2092 dass ein Eintrag, der in der Standard-\bibtex{}-Datei nicht definiert
2093 ist, auch nicht in die neue Datei geschrieben werden kann.
2095 \item Aus dem Internet abrufen: \lstinline{--fetch==Name des Fetchers:Suchausdruck}
2097 Die \emph{Fetcher}, also die direkte Suche in Online-Datenbanken,
2098 die Sie im Menü \menu{Internet} finden, können auch von der Kommandozeile
2099 aus gestartet werden. Nutzen Sie dazu die Option \lstinline{--fetch} und geben
2100 sowohl den Namen des Fetchers (z.B. ">ieee"<, ">medline"< oder ">jstor"<)
2101 als auch den Suchausdruck oder die ID des gesuchten Mediums an. Beachten
2102 Sie, dass einige Fetcher eine graphische Oberfläche (GUI) anzeigen,
2103 falls Sie eine Rückmeldung von Ihnen brauchen. Um eine Übersicht der
2104 verfügbaren Fetcher zu erhalten, geben Sie \texttt{-{-}fetch} ohne
2109 \subsubsection{Externer Zugriff}
2112 \emph{Diese Funktion kann unter \menu{Optionen \msep{} Einstellungen \msep{} Erweitert} verwaltet werden.}
2115 \tip[]{Beachten Sie, dass das Aktivieren dieser Funktion mit Windows XP SP2 (und möglicherweise auch mit anderen Konfigurationen) zu einer Meldung führen kann, die besagt, dass bestimmte Funktionen des Programms von der Windows-Firewall geblockt wurden. Sie können die Firewall anweisen, weiterhin zu blocken, denn die Firewall beeinträchtigt den Externen Zugriff von \jabref nicht.}
2116 Falls das Abhören von externen Zugriffen aktiviert ist, versucht \jabref beim Programmstart, den entsprechenden Port abzuhören. Das bedeutet, dass andere Anwendungen Informationen durch diesen Port an \jabref senden können. \jabref akzeptiert dabei nur lokale Verbindungen, um das Risiko eines Eingriffs von außerhalb auszuschließen.
2118 Mit dem externen Zugriff kann eine zweite Instanz von \jabref erkennen, dass eine erste Instanz bereits läuft. In diesem Fall leitet die zweite Instanz ihre Kommandozeilen"=Optionen an die erste Instanz weiter und beendet sich selbst direkt im Anschluss~-- sofern die zweite Instanz nicht ausdrücklich instruiert wurde, im Stand-Alone-Modus (als selbständige Instanz) zu starten.
2120 Die erste \jabref-Instanz liest die Kommandozeilenoptionen und führt die erforderlichen Aktionen aus, z.\,B. das Lesen oder Importieren einer Datei oder das Anhängen einer Datei an die aktive Datenbank. Falls eine Datei mit der Option \texttt{-{-}importToOpen} importiert wird, werden die Einträge an die aktive Datei angehängt. Falls keine Datei geöffnet ist, wird eine neue Datei angelegt.
2126 \subsection{Eintragstypen}
2128 \label{CustomEntriesHelp}
2131 \emph{Um Eintragstypen anzupassen, wählen Sie den Menüpunkt \menu{Optionen}}
2132 \msep{} \emph{\menu{Eintragstypen anpassen}.}
2134 Wenn Sie einen Eintragstyp anpassen, definieren Sie sowohl sein Erscheinungsbild
2135 im Eintragseditor als auch die Bedingungen, nach denen \jabref
2136 einen Eintrag als vollständig akzeptiert. Sie können die bestehenden
2137 Eintragstypen verändern und neue hinzufügen.
2139 Beachten Sie, dass in diesem Dialog keine Änderungen gespeichert werden,
2140 solange Sie nicht auf \menu{Übernehmen} oder \menu{OK} klicken.
2141 Wenn Sie \menu{Abbrechen} anklicken oder einfach den Dialog schließen,
2142 gehen die bislang nicht übernommenen Änderungen verloren.
2145 \subsubsection{Der Dialog \menu{Eintragstypen anpassen}}
2147 Der Dialog \menu{Eintragstypen anpassen} ist in drei Hauptbereiche
2148 unterteilt. Im linken Bereich können Sie den Eintragstyp auswählen,
2149 den Sie bearbeiten wollen, und neue Eintragstypen hinzufügen. Im mittleren
2150 Bereich werden die Einstellungen für die benötigten Felder des ausgewählten
2151 Eintragstyps vorgenommen und im rechten Bereich diejenigen der optionalen
2155 \subsubsection{Eintragstypen hinzufügen und löschen}
2157 Die derzeit verfügbaren Eintragstypen werden im linken Bereich des
2158 Dialogfensters aufgelistet. Wenn Sie einen Eintragstyp auswählen,
2159 werden die anderen Bereiche aktualisiert und zeigen die benötigten
2160 und optionalen Felder dieses Eintragstyps.
2162 Um einen neuen Eintragstyp hinzuzufügen, geben Sie einfach seinen
2163 Namen in das Textfeld unter der Typliste ein und klicken \menu{Hinzufügen}.
2164 Der neue Eintragstyp wird zur Liste hinzugefügt und zur Bearbeitung
2167 Um einen eigenen Eintragstyp zu entfernen, wählen Sie ihn aus und
2168 klicken auf \menu{Löschen}. Dieser Vorgang ist nur für eigene Eintragstypen
2169 verfügbar, die nicht nur Abwandlungen der Standard-Typen sind. Die
2170 Standard-Eintragstypen können nicht gelöscht werden.
2172 Um einem Eintragstyp seinen Standardwert zurückzugeben, wählen Sie
2173 ihn aus und drücken auf \menu{Standard}. Dieser Vorgang ist nur für
2174 Standard-Typen verfügbar, die bearbeitet wurden.
2177 \subsubsection{Eintragstypen bearbeiten}
2179 Wenn ein Eintragstyp ausgewählt ist, werden die derzeitigen benötigten
2180 und optionalen Felder im mittleren und rechten Bereich des Dialogfensters
2181 aufgelistet. Das Vorgehen beim Bearbeiten dieser Listen ist für die
2182 benötigten und optionalen Felder identisch.
2184 Um ein neues Feld hinzuzufügen, bearbeiten Sie das Textfeld unterhalb
2185 der Liste oder wählen einen Feldnamen aus dem Dropdown-Menü und klicken
2186 auf \menu{Hinzufügen}. Der gewählte Feldname erscheint am Ende der
2189 Um eines oder mehrere Felder zu löschen, wählen Sie sie in der Liste
2190 aus und klicken auf \menu{Löschen}. Die Reihenfolge der Felder können
2191 Sie ändern, indem Sie einen Feldnamen auswählen und die Pfeil"=Buttons
2192 benutzen, um das Feld nach oben oder nach unten zu verschieben.
2194 Es gibt eine Beschränkung beim Anpassen der Eintragstypen; bestimmte
2195 Typen haben eine ">und/oder"<"=Bedingung in ihren benötigten Feldern. Ein
2196 \emph{book}-Eintrag ist beispielsweise komplett, wenn entweder das
2197 Feld \emph{author} oder \emph{editor} oder beide gesetzt sind. Diese
2198 Art von Bedingung kann in einem angepassten Eintragstyp nicht realisiert
2202 \subsection{Allgemeine Felder festlegen}
2204 \label{GeneralFields}Sie können dem Eintragseditor eine beliebige
2205 Anzahl von Tabs hinzufügen, die bei allen Eintragstypen sichtbar sind.
2206 Wählen Sie dazu den Menüeintrag \menu{Optionen} \msep{} \menu{Allgemeine Felder festlegen}.
2208 Jede Zeile repräsentiert einen Tab. Der Anfang der Zeile steht für
2209 den Namen des Tabs, gefolgt von einem Doppelpunkt. Anschließend listen
2210 Sie die einzelnen Felder auf, die der Tab enthalten soll, und trennen
2211 sie jeweils durch ein Semikolon.
2216 Allgemeine Felder:url;keywords;doi;pdf
2217 Zusammenfassung:abstract;annote
2219 ergibt somit einen Tab mit dem Namen >>Allgemeine Felder<<, der
2220 die Felder \emph{url}, \emph{keywords}, \emph{doi} und \emph{pdf}
2221 enthält, sowie einen zweiten Tab namens >>Zusammenfassung<< mit
2222 den Feldern \emph{abstract} und \emph{annote}.
2225 \subsection{Automatische Erstellung von \bibtex{}"=Keys}
2226 \label{LabelPatterns}
2228 \emph{Unter \menu{Optionen \msep{} Einstellungen \msep{} BibTeX"=Key"=Muster}
2229 kann man die Felder bestimmen, die zur automatischen Generierung der
2230 \bibtex{}"=Keys herangezogen werden.}
2232 \jabref verwendet ein Standardmuster zur Generierung von \bibtex{}"=Keys, das Keys wie z.\,B.
2233 \texttt{Yared1998} erzeugt. Falls der \bibtex{}-Key in der geöffneten
2234 Datei nicht eindeutig sein sollte, wird einer der Buchstaben a-z angefügt,
2235 bis ein eindeutiger Key gefunden ist. Dementsprechend könnten die
2236 Labels wie folgt aussehen:
2244 Um das Aussehen der \bibtex{}-Keys zu bestimmen, benutzt \jabref
2245 Feldmarken. Das Key"=Muster kann für jeden der vorgegebenen Eintragstypen
2246 bestimmt werden. Es kann beliebigen Text enthalten, unabhängig von
2247 und zusätzlich zu den Feldmarken, die angeben, dass ein bestimmtes
2248 Feld des Eintrags an dieser Stelle des Keys eingefügt werden soll.
2249 Eine Feldmarke besteht gewöhnlich aus dem Feldnamen in eckigen Klammern,
2250 z.\,B. \texttt{{[}volume{]}}. Wenn dieses Feld zum Zeitpunkt der
2251 Erstellung des Keys leer ist, wird kein Text eingefügt.
2253 Es gibt außerdem mehrere spezielle Feldmarken, die nur einen bestimmten
2254 Teil aus einem Feld extrahieren. Sie werden unten aufgelistet. Natürlich
2255 können Sie auch neue spezielle Feldmarken vorschlagen.
2258 \subsubsection{Spezielle Feldmarken}
2259 \label{subsub:SpezielleFeldmarken}
2261 \begin{labeling}{auth.auth.eaMM}
2262 \item [\texttt{{[}auth{]}}]Der Nachname des ersten Autors.
2263 \item [\texttt{{[}authors{]}}]Die Nachnamen aller Autoren.
2264 \item [\texttt{{[}authorsN{]}}]Die Nachnamen von bis zu N Autoren. Falls
2265 es mehr Autoren gibt, wird EtAl angehängt.
2266 \item [\texttt{{[}authIniN{]}}]Der Anfang des Nachnamens von jedem Autoren,
2267 wobei nicht mehr als N Buchstaben verwendet werden.
2268 \item [\texttt{{[}authorIni{]}}]Die ersten 5 Buchstaben des Nachnamens
2269 des ersten Autors und die Initialen der Nachnamen der restlichen Autoren.
2270 \item [\texttt{{[}authN{]}}]Die ersten N Buchstaben des Nachnamens des
2272 \item [\texttt{{[}authN\_M{]}}]Die ersten N Buchstaben des Nachnamens des
2274 \item [\texttt{{[}auth.auth.ea{]}}]Die Nachnamen der beiden ersten Autoren
2275 und \texttt{.ea}, falls es mehr als zwei Autoren sind.
2276 \item [\texttt{{[}auth.etal{]}}]Der Nachname des ersten Autors und der Nachname des zweiten Autors bei zwei Autoren bzw. \texttt{.etal} bei mehr als zwei Autoren.
2277 \item [\texttt{{[}authshort{]}}]Der Nachname bei einem Autor; der erste
2278 Buchstabe der Nachnamen von bis zu drei Autoren, falls mehr als ein
2279 Autor vorhanden ist. Ein Plus (+) wird angehängt, falls es mehr als
2283 \tip[Anmerkung: ]{Falls es keinen Autor gibt (etwa bei einem Buch mit Herausgeber), benutzen die genannten \texttt{{[}auth\ldots{]}}"=Feldmarken den oder die Herausgeber, die im editor"=Feld angegeben wurden. Also werden die Herausgeber eines Buches ohne Autor für die Label"=Erstellung wie Autoren behandelt. Falls Sie dieses Verhalten nicht wünschen und die Feldmarke stattdessen bei einem leeren author"=Feld zu nichts expandieren soll, müssen Sie stattdessen >>pureauth<< verwenden, z.\,B. \texttt{{[}pureauth{]}} oder \texttt{{[}pureauthors3{]}.}}
2285 \begin{labeling}{veryshorttitleMM}
2286 \item [\texttt{{[}edtr{]}}]Der Nachname des ersten Herausgebers.
2287 \item [\texttt{{[}editors{]}}]Die Nachnamen aller Herausgeber.
2288 \item [\texttt{{[}edtrIniN{]}}]Der Anfang des Nachnamens von jedem Herausgeber,
2289 wobei nicht mehr als N Buchstaben verwendet werden.
2290 \item [\texttt{{[}editorIni{]}}]Die ersten 5 Buchstaben des Nachnamens
2291 des Herausgebers und die Initialen der Nachnamen der restlichen Herausgeber.
2292 \item [\texttt{{[}edtrN{]}}]Die ersten N Buchstaben des Nachnamens des
2293 ersten Herausgebers.
2294 \item [\texttt{{[}edtrN\_M{]}}]Die ersten N Buchstaben des Nachnamens des
2296 \item [\texttt{{[}edtr.edtr.ea{]}}]Der Nachname der ersten beiden Herausgeber
2297 und \texttt{.ea}, falls es mehr als zwei Herausgeber sind.
2298 \item [\texttt{{[}edtrshort{]}}]Der Nachname bei einem Herausgeber; der
2299 erste Buchstabe der Nachnamen von bis zu drei Herausgebern, falls
2300 mehr als ein Herausgeber vorhanden ist. Ein Plus (+) wird angehängt,
2301 falls es mehr als drei Herausgeber gibt.
2302 \item [\texttt{{[}firstpage{]}}]Die erste Seitenzahl einer Veröffentlichung
2304 \item [\texttt{{[}keywordN{]}}]Stichwort Nummer N aus dem Feld ">keywords"<, gesetzt den Fall, dass die Stichworte durch Komma oder Semikolon voneinander getrennt sind.
2305 \item [\texttt{{[}lastpage{]}}]Die letzte Seitenzahl einer Veröffentlichung
2307 \item [\texttt{{[}shorttitle{]}}]Die ersten 3 Worte eines Titels (title).
2308 \item [\texttt{{[}shortyear{]}}]Die letzten 2 Ziffern des Jahrgangs (year).
2309 \item [\texttt{{[}veryshorttitle{]}}]Die ersten beiden Worte des Titels
2310 (title), wobei >>the<<, >>a<< und >>an<< ausgelassen werden.
2312 Hinter einem Feldnamen (oder einem der oben aufgeführten Pseudo-Feldnamen)
2313 kann ein Modifikator stehen. Modifikatoren werden in der Reihenfolge
2314 angewendet, in der sie angegeben wurden.
2316 \begin{labeling}{00.00.0000}
2317 \item [\texttt{:abbr}]Kürzt den Text, der von einem Feldnamen oder speziellen
2318 Feldmarken gebildet wird. Nur der erste Buchstabe und weitere Buchstaben,
2319 die auf ein Leerzeichen folgen, werden berücksichtigt. So würde beispielsweise
2320 \texttt{[journal:abbr]} die Zeitschrift >>Journal of Fish Biology<< zu
2322 \item [\texttt{:lower}]Wandelt den von der Feldmarke eingefügten Text in
2323 Kleinbuchstaben. So wird beispielsweise bei \texttt{{[}auth:lower{]}}
2324 der Nachname des ersten Autors in Kleinbuchstaben ausgegeben.
2326 Das Standardmuster, das \bibtex{}-Keys wie \texttt{Yared1998}
2327 erzeugt, ist \texttt{{[}auth{]}{[}year{]}}. Wenn Sie keine Key-Muster
2328 für einen bestimmten Eintragstyp angeben, wird dieses vorgegebene
2329 Muster verwendet. Sie können das vorgegebene Muster natürlich ebenfalls
2330 anpassen%~-- seine Einstellung befindet sich über der Liste der Eintragstypen
2331 %im Tab \menu{Key-Muster} des Dialogs \menu{Einstellungen}
2334 Beachten Sie, dass \jabref Umlaute und Buchstaben mit Akzenten
2335 sowie das ß beim Erstellen von \bibtex{}-Keys verändert, um möglichen
2336 Problemen vorzubeugen. Hierzu einige Beispiele:
2339 Díaz Ibañez (*$\to$*) DiazIbanez
2340 Strömbäck (*$\to$*) Stroembaeck
2341 Waßenhoven (*$\to$*) Wassenhoven
2344 \subsubsection{Ersetzen eines regulären Ausdrucks}
2346 Nachdem das Key"=Muster angewendet wurde, um einen \bibtex{}"=Key zu erstellen, können Sie den Key"=Generator nach einem bestimmten regulären Ausdruck suchen und diesen durch eine Zeichenfolge ersetzen lassen. Der reguläre Ausdruck und die Zeichenfolge, die ihn ersetzen soll, werden in den Textfeldern unter der Liste der Key"=Muster eingegeben. Falls das Feld zur Ersetzung des regulären Ausdrucks leer ist, werden die mit der Suche übereinstimmenden regulären Ausdrücke einfach gelöscht.
2348 \subsection{Eintragsvorschau}
2350 \label{PreviewHelp}Die Eintragsvorschau wird mit denselben Mechanismen
2351 erstellt, die auch bei den Exportfiltern angewendet werden. Bei der
2352 Vorschau durchläuft ein Eintrag eins von zwei möglichen Layouts (die
2353 sie mit F9 wechseln können) und erstellt HTML-Code, der im Vorschaudialog
2354 am unteren Bildschirmrand angezeigt wird.
2356 Aussehen und Inhalt der Vorschau können mit derselben Syntax verändert
2357 werden, die für die Anpassung der Exportfilter verwendet wird (siehe
2358 Abschnitt~\ref{CustomExports}).
2360 \subsection{Exportfilter}
2362 \label{CustomExports}Mit \jabref können Sie Ihre eigenen Exportfilter
2363 definieren und genau so wie die Standard"=Exportfilter benutzen. Ein
2364 Exportfilter wird durch eine oder mehrere \emph{Layout"=Dateien} definiert,
2365 die mittels eingebauter Formatierprogramme das Format der exportierten
2366 Dateien festlegen. Ihre Layout-Datei müssen Sie in einem separaten
2367 Text\-editor erstellen.
2370 \subsubsection{Hinzufügen eines Exportfilters}\label{subsubsec:Hinzufuegen-Exportfilter}
2372 Die einzige Voraussetzung für einen Exportfilter ist, dass eine Datei
2373 mit der Endung \texttt{.layout} vorhanden ist. Um einen neuen, eigenen
2374 Exportfilter hinzuzufügen, öffnen Sie das Dialogfenster \menu{Optionen}
2375 \msep{} \menu{Verwalte externe Exportfilter} und klicken auf die
2376 Schaltfläche \menu{Neu}. Es öffnet sich ein neues Fenster, in dem
2377 Sie einen Namen (der als Auswahl im Dateityp"=Dropdownmenü erscheint, wenn man \menu{Datei \msep{} Exportieren} im \jabref"=Hauptfenster wählt), eine Pfadangabe zur \texttt{.layout}-Datei und die
2378 gewünschte Dateiendung für den Exportfilter angeben können. Wenn Sie
2379 den Exportfilter benutzen, wird diese Endung im Datei"=Dialog automatisch
2383 \subsubsection{Das Erstellen des Exportfilters}
2385 Um einen Eindruck zu bekommen, wie Exportfilter auszusehen haben,
2386 suchen Sie am besten auf unserer Homepage nach dem Paket, das die
2387 Layout"=Dateien der Standard"=Exportfilter enthält.
2389 Nehmen wir einmal an, dass wir einen HTML-Exportfilter erstellen wollen.
2390 Der Exportfilter muss lediglich aus einer einzigen \texttt{.layout}-Datei
2391 bestehen, die in diesem Fall \texttt{html.layout} genannt werden könnte.
2392 Sie können darüber hinaus auch zwei Dateien mit den Namen \texttt{html.begin.layout}
2393 und \texttt{html.end.layout} anlegen. Die erste dieser beiden Dateien
2394 enthält den Kopfteil der Ausgabe, die zweite den Fußteil. \jabref
2395 sucht jedesmal wenn der Exportfilter benutzt wird nach diesen Dateien
2396 und fügt sie~-- falls sie gefunden werden~-- wörtlich vor bzw. nach
2397 den einzelnen Einträgen in die Ausgabe ein.
2399 \tip[]{Beachten Sie, dass sich diese Dateien in demselben Verzeichnis
2400 wie \texttt{html.layout} befinden und die Namensbestandteile \texttt{.begin}
2401 bzw. \texttt{.end} enthalten müssen.}
2403 \noindent In unserem Beispiel-Exportfilter könnten diese Dateien folgendermaßen
2406 \begin{lstlisting}[title=html.begin.layout]
2408 <BODY text="#275856">
2409 <basefont size="4" color="#2F4958" face="arial">
2411 \begin{lstlisting}[title=html.end.layout]
2415 Die Datei \texttt{html.layout} stellt die \emph{Standard}"=Formatvorlage
2416 für den Export eines einzelnen Eintrags bereit. Falls Sie unterschiedliche
2417 Formatvorlagen für verschiedene Eintragstypen anwenden wollen, müssen
2418 Sie typspezifische \texttt{.layout}"=Dateien erstellen. Diese
2419 müssen sich ebenfalls in demselben Verzeichnis wie die Haupt"=Layout"=Datei
2420 befinden und den Namensbestandteil \texttt{.entrytype} enthalten.
2421 Der Name des Eintragstyps muss komplett in Kleinbuchstaben geschrieben
2422 werden. In unserem Beispiel wollen wir eine Formatvorlage für Einträge
2423 des Typs \emph{book} haben, die in der Datei \texttt{html.book.layout}
2424 abgelegt wird. Für eine Dissertation würden wir die Datei \texttt{html.phdthesis.layout}
2425 anlegen~-- und so weiter. Diese Dateien sind der Standard"=Layout"=Datei
2426 sehr ähnlich, nur dass sie lediglich für Einträge des entsprechenden
2427 Typs genutzt werden. Achten Sie darauf, dass die Standard"=Layout"=Datei
2428 so allgemein gehalten wird, dass sie die meisten Eintragstypen abdeckt.
2431 \paragraph{Das Format der Layout-Datei}
2433 Layout"=Dateien werden mit einem einfachen mark\-up"=Format erstellt,
2434 bei dem die Kommandos mit einem >>backslash<< (\texttt{\textbackslash{}})
2435 eingeleitet werden. Alle Textbestandteile, die nicht als Kommando
2436 identifiziert werden, gelangen direkt in die Ausgabedatei.
2439 \paragraph{Feldkommandos}
2441 Ein beliebiges Wort, vor dem ein backslash steht, z.\,B. \texttt{\textbackslash{}author},
2442 \texttt{\textbackslash{}editor,} \texttt{\textbackslash{}title} oder
2443 \texttt{\textbackslash{}year}, wird als Verweis auf das entsprechende
2444 Feld ausgewertet, das dann direkt in die Ausgabe kopiert wird.
2447 \paragraph{Feldformatierer}
2448 \label{par:Feldformatierer}
2450 Oft muss der Feldinhalt vor der Ausgabe verarbeitet werden. Dies wird
2451 mit Hilfe eines \emph{Feldformatierers} gemacht~-- einer java class,
2452 die eine Methode zur Verarbeitung des Feldinhaltes enthält.
2454 Ein Formatierer wird angewendet, indem man das Kommando \texttt{\textbackslash{}format}
2455 gefolgt vom Namen des Formatierers in eckigen Klammern und dem Feldnamen
2456 in geschweiften Klammern einfügt, z.\,B.:
2459 \format[ToLowerCase]{\author}
2461 Sie können auch mehrere Formatierer angeben, getrennt durch Kommas.
2462 Diese werden nacheinander aufgerufen, und zwar von links nach rechts.
2466 \format[ToLowerCase,HTMLChars]{\author}
2468 ruft z.\,B. zunächst den Formatierer \emph{ToLowerCase} auf, \emph{HTMLChars}
2469 formatiert anschließend das Ergebnis. Auf diese Weise können Sie eine
2470 beliebige Anzahl an Formatierern auflisten.
2472 \jabref bietet die folgenden Formatierer, wobei einige von anderen
2475 \begin{labeling}{MMMM}
2476 \item [\texttt{HTMLChars}]ersetzt \TeX{}-spezifische Sonderzeichen wie
2477 \texttt{\{\textbackslash{}\textasciicircum{}a\}} oder \texttt{\{\textbackslash{}\char`\"{}\{o\}\}}
2478 durch ihre HTML-Entsprechungen.
2479 \item [\texttt{HTMLParagraphs}]interpretiert zwei aufeinanderfolgende Zeilenumbrüche (z.\,B. \lstinline{\n \n}) als Beginn eines neuen Absatzes und erstellt dementsprechend Absatz-HTML-Tags.
2480 \item [\texttt{XMLChars}]ersetzt \TeX{}-spezifische Sonderzeichen wie \texttt{\{\textbackslash{}\textasciicircum{}a\}}
2481 oder \texttt{\{\textbackslash{}\char`\"{}\{o\}\}} durch ihre XML-Entsprechungen.
2482 \item [\texttt{CreateDocBookAuthors}]formatiert das author-Feld im DocBook-Stil.
2483 \item [\texttt{CreateDocBookEditors}]\emph{Dokumentation folgt.}
2484 \item [\texttt{CurrentDate}]gibt das aktuelle Datum aus. Ohne Argument gibt dieser Formatierer das aktuelle Datum im Format ">JJJJ.MM.TT HH:MM:SS Z"< (Datum, Zeit und Zeitzone) aus. Mit einem anderen Format-String als Argument kann das Datum angepasst werden. So ergibt \lstinline{\format[CurrentDate]}\texttt{\{}\lstinline{yyyy.MM.dd}\texttt{\}} nur das Datum, z.\,B. ">2005.11.30"<.
2485 \item [\texttt{AuthorFirstFirst}]formatiert die Felder \emph{author}/\emph{editor}
2486 mit den Vornamen zuerst.
2487 \item [\texttt{AuthorFirstFirstCommas}]formatiert die Felder \emph{author}/\emph{editor}
2488 mit den Vornamen zuerst und abgetrennt durch Kommas.
2489 \item [\texttt{AuthorFirstAbbrLastCommas}]\emph{Dokumentation folgt.}
2490 \item [\texttt{AuthorFirstAbbrLastOxfordCommas}]\emph{Dokumentation folgt.}
2491 \item [\texttt{AuthorFirstLastOxfordCommas}]\emph{Dokumentation folgt.}
2492 \item [\texttt{AuthorLastFirst}]formatiert die Felder \emph{author}/\emph{editor}
2493 mit den Nachnamen zuerst.
2494 \item [\texttt{AuthorLastFirstAbbreviator}]kürzt die Vornamen aller Autoren.
2495 Dieser Formatierer kann nur angewendet werden, wenn \texttt{AuthorLastFirst}
2496 bereits benutzt wurde.
2497 \item [\texttt{AuthorLastFirstCommas}]\emph{Dokumentation folgt.}
2498 \item [\texttt{AuthorLastFirstOxfordCommas}]\emph{Dokumentation folgt.}
2499 \item [\texttt{AuthorLastFirstAbbrCommas}]\emph{Dokumentation folgt.}
2500 \item [\texttt{AuthorLastFirstAbbrOxfordCommas}]\emph{Dokumentation folgt.}
2501 \item [\texttt{AuthorAndsReplacer}]ersetzt >>and<< zwischen den Namen
2502 durch >>;<<, zwischen den letzten beiden Autoren steht >>\&<<.
2503 \item [\texttt{AuthorAndsCommaReplacer}]ersetzt >>and<< zwischen den
2504 Namen durch ein Komma (,) sowie >>\&<< zwischen den beiden letzten.
2505 \item [\texttt{AuthorOrgSci}]Der erste Autor erscheint als "Nachname, Vorname", alle anderen als "Vorname Nachname". Vornamen werden abgekürzt.
2506 \item [\texttt{AuthorAbbreviator}]\emph{Dokumentation folgt.}
2507 \item [\texttt{AuthorNatBib}]formatiert Autorennamen im Natbib-Stil, also nur mit Nachnamen; zwei Autoren werden durch ein ">and"< voneinander getrennt, bei mehr als zwei Autoren wird der erste angegeben, gefolgt von ">et al."<
2508 \item [\texttt{NoSpaceBetweenAbbreviations}]Leerzeichen zwischen mehreren abgekürzten Vornamen werden gelöscht.
2509 \item [\texttt{FormatPagesForHTML}]ersetzt >>\texttt{-{}-}<< durch >>\texttt{-}<<.
2510 \item [\texttt{FormatPagesForXML}]ersetzt >>\texttt{-{}-}<< durch einen
2511 XML en-dash (>>--<<).
2512 \item [\texttt{RemoveBrackets}]entfernt alle geschweiften Klammern (>>\{<<
2514 \item [\texttt{RemoveBracketsAddComma}]\emph{Dokumentation folgt.}
2515 \item [\texttt{RemoveWhitespace}]\emph{Dokumentation folgt.}
2516 \item [\texttt{RemoveLatexCommands}]entfernt \LaTeX{} Kommandos wie \texttt{\textbackslash{}em},
2517 \texttt{\textbackslash{}textbf} etc. Zusammen mit \texttt{HTMLChars}
2518 oder \texttt{XMLChars} sollte dieser Formatierer zuletzt aufgerufen
2520 \item [\texttt{RemoveTilde}]ersetzt das Tilde-Zeichen (\lstinline{~}), das in \LaTeX\ als festes Leerzeichen dient, durch ein normales Leerzeichen. Nützlich in Kombination mit dem Namens"=Formatierer (siehe Abschnitt \nameref{NameFormatter}).
2521 \item [\texttt{ToLowerCase}]macht aus allen Buchstaben Kleinbuchstaben.
2522 \item [\texttt{CompositeFormat}]\emph{Dokumentation folgt.}
2523 \item [\texttt{GetOpenOfficeType}]\emph{Dokumentation folgt.}
2524 \item [\texttt{RTFChars}]\emph{Dokumentation folgt.}
2525 \item [\texttt{ResolvePDF}]\emph{Dokumentation folgt.}
2527 Falls keiner der verfügbaren Formatierer das Ergebnis erzielt, das
2528 Sie erreichen möchten, können Sie Ihren eigenen Formatierer hinzufügen,
2529 indem Sie das \lstinline{net.sf.jabref.export.layout.LayoutFormatter}-Interface
2530 implementieren. Wenn Sie in das Paket \lstinline{net.sf.jabref.export.layout.format} Ihre Klasse (class) einfügen, können Sie den Formatierer mit seinem Klassennamen aufrufen,
2531 so wie auch die Standard"=Formatierer. Ansonsten müssen Sie den Formatierer
2532 mit seinem vollen Namen aufrufen (inklusive Paketname). In jedem Fall
2533 muss der Formatierer in ihrem classpath sein, wenn Sie \jabref
2536 \paragraph{Eigene Namens"=Formatierer verwenden}
2537 \label{NameFormatter}
2539 Mit \jabref~2.2 ist es jetzt möglich, eigene Namens"=Formatierer zu definieren. Dazu wird die Syntax der Bibliographie"=Stile (bst) verwendet. Das erlaubt äußerste Flexibilität, ist allerdings aufwändig in der Schreibweise.
2541 Sie können unter \menu{Optionen \msep Einstellungen \msep Namens"=Formatierer} Ihren eigenen Formatierer schreiben. Benutzen Sie das folgende Format:
2543 <Fall1>@<Bereich11>@<Format>@<Bereich12>@<Format>@<Bereich13>(*\ldots*)@@<br>
2544 <Fall2>@<Bereich21>@(*\ldots*)
2546 Dieses Format teilt die Aufgabe, eine Liste von Autoren zu formatieren, in unterschiedliche Fälle abhängig von der Zahl der Autoren (das ist nötig, weil manche Formate sich je nach der Zahl der Autoren unterscheiden). Die einzelnen Fälle werden durch \texttt{@@} voneinander getrennt und enthalten Anweisungen, wie jeder einzelne Autor in diesem Fall zu formatieren ist. Diese Anweisungen werden durch \texttt{@} getrennt.
2548 Fälle werden durch Ganzzahlen (1, 2, 3, etc.) oder das Zeichen \texttt{*} (alle Autoren) definiert. Sie geben die nachfolgenden Anweisungen an den Formatierer weiter, falls weniger oder gleich viele Autoren vorhanden sind.
2550 Bereiche sind entweder \texttt{<Ganzzahl>..<Ganzzahl>}, \texttt{<Ganzzahl>} oder das Zeichen \texttt{*}. Die Liste der Autoren fängt bei 1 an. Die Ganzzahlen können einen negativen Wert haben, um vom letzten Autor der Liste zu starten, wobei -1 der Wert für den letzten Autor ist.
2552 Als Beispiel dient die Autorenliste ">Joe Doe and Mary Jane and Bruce Bar and Arthur Kay"<:
2554 \item 1..3 betrifft Joe, Mary und Bruce
2555 \item 4..4 betrifft Arthur
2556 \item * betrifft alle
2557 \item 2..-1 betrifft Mary, Bruce und Arthur
2560 Die \texttt{<Format>}-Strings nutzen das BibTeX-Namensschema: Die vier Buchstaben v, f, l, j stehen für die Namensteile von, Vorname (first), Nachname (last) und Junior und werden in geschweiften Klammern gesetzt. Ein einzelner Buchstabe v, f, l, j bedeutet, dass der Name abgekürzt werden soll. Wenn einer dieser Buchstaben oder Buchstabenpaare vorkommen, gibt \jabref alle entsprechenden Namen (eventuell abgekürzt) aus, aber der Ausdruck in geschweiften Klammern wird nur ausgegeben, wenn der Namensteil existiert.
2562 Beispielsweise wird beim Format ">\texttt{\{ll\} \{vv \{von Part\}\} \{ff\}}"< die Autorenliste ">Mary Kay and John von Neumann"< von \jabref als ">Kay~~Mary"< (mit zwei Leerzeichen) und ">Neumann von von Part John"< ausgegeben.
2564 Zwei weitere Beispiele sollen das Ganze verdeutlichen; die Dokumentation von \bibtex gibt weitere Hinweise.
2566 Kurzes Beispiel: ">\texttt{\{ll\}, \{f.\}}"< formatiert ">\lstinline{Joe Doe}"< als ">\lstinline{Doe, J.}"<
2568 Ausführliches Beispiel: Um
2570 ">Joe Doe and Mary Jane and Bruce Bar and Arthur Kay"<
2574 ">Doe, J., Jane, M., Bar, B. and Kay, A."<
2576 zu formatieren, nutzt man
2578 1@*@{ll}, {f}.@@2@1@{ll}, {f}.@2@ and {ll}, {f}.@@*@1..-3@{ll}, {f}., @-2@{ll}, {f}.@-1@ and {ll}, {f}.
2580 Falls jemand eine bessere Dokumentation hierzu verfassen möchte: Wenden Sie sich einfach an die \jabref"=Maililnglisten!
2582 \paragraph{Bedingte Ausgabe}
2584 Manche statische Ausgabe macht nur Sinn, wenn ein bestimmtes Feld
2585 nicht leer ist. Wenn wir z.\,B. hinter den Namen der Editoren den
2586 Text \texttt{(Hrsg.)} haben wollen, brauchen wir Folgendes:
2589 \format[HTMLChars,AuthorFirstFirst]{\editor} (Hrsg.)
2591 Wenn nun aber das \emph{editor}-Feld leer ist~-- möglicherweise ist
2592 es für den Eintrag, der exportiert werden soll, nicht erforderlich~--,
2593 dann würde das \texttt{(Hrsg.)} dennoch erscheinen. Das kann man mit
2594 den Kommandos \texttt{\textbackslash{}begin} und \texttt{\textbackslash{}end}
2599 \format[HTMLChars,AuthorFirstFirst]{\editor} (Hrsg.)
2602 Die Kommandos \texttt{\textbackslash{}begin} und \texttt{\textbackslash{}end}
2603 sorgen dafür, dass der Text, den sie einschließen, nur dann ausgegeben
2604 wird, wenn das Feld, auf das in den geschweiften Klammern verwiesen
2605 wird, für den zu exportierenden Eintrag definiert und damit nicht
2608 \tip{Das Benutzen der Kommandos \texttt{\textbackslash{}begin} und
2609 \texttt{\textbackslash{}end} ist ein Schlüssel zum Erstellen von Layout-Dateien,
2610 die mit einer Vielzahl von Eintragstypen umgehen können.}
2613 \paragraph{Gruppierte Ausgabe}
2615 Wenn Sie Ihre Einträge auf der Basis eines bestimmten Feldes gruppieren
2616 wollen, benutzen Sie die Kommandos für die gruppierte Ausgabe. Die
2617 gruppierte Ausgabe ist der bedingten Ausgabe sehr ähnlich, außer dass
2618 der Text zwischen den Kommandos nur ausgegeben wird, wenn das Feld,
2619 auf das in den geschweiften Klammern verwiesen wird, unterschiedliche
2622 Nehmen wir zum Beispiel an, dass wir die Ausgabe nach dem \emph{keyword}
2623 (Stichwort) gruppieren wollen. Bevor die Datei exportiert wird, müssen
2624 die Einträge nach dem \emph{keyword} sortiert worden sein. Dann benutzen
2625 Sie die folgenden Kommandos, um nach \emph{keyword} zu gruppieren:
2628 \begingroup{keywords}
2629 New Category: \format[HTMLChars]{\keywords}
2633 \subsection{Importfilter}
2635 \noindent \jabref bietet Ihnen die Möglichkeit, ganz ähnlich den Standard-Importern, eigene Importer
2636 zu definieren und zu benutzen. Man definiert einen Importer durch eine oder mehrere Java"=\emph{Klassen},
2637 die Dateiinhalte aus einem sogenannten \emph{Input stream} lesen
2638 und daraus \bibtex{}-Einträge erzeugen. Sie können vorkompilierte Importer einbinden, die Sie vielleicht
2639 von SourceForge erhalten haben (siehe Abschnitt ">\nameref{subsec:Ihre-Arbeit}"<). Sie können auch
2640 mit Grundkenntnissen der Java"=Programmierung eigene Importer für Referenzquellen, die für Sie wichtig sind,
2641 erstellen oder neue, verbesserte Versionen existierender Importer einbinden, ohne \jabref neu zu
2644 \paragraph{Vorrangsregeln}
2646 Externe Importfilter haben Vorrang vor Standard-Importern. So können Sie mit Ihren Importern
2647 die existierenden Importer in der automatischen Formaterkennung und an der Kommandozeile in \jabref überschreiben. Externe Importfilter selbst sind dann nach Namen sortiert.
2649 \subsubsection{Einen externen Importfilter hinzufügen}
2651 Stellen Sie sicher, dass Sie den Importer in kompilierter Form haben (eine oder mehrere
2652 \texttt{.class} Dateien) und dass die Klassendateien
2653 in einer Verzeichnisstruktur entsprechend ihrer Package"=Struktur liegen.
2654 Um einen neuen externen Importfilter hinzuzufügen, öffnen Sie den Dialog
2655 \menu{Optionen \msep{} Verwalte externe Importfilter}, und klicken Sie auf
2656 \menu{Aus Klassenpfad hinzufügen}. Ein Dateiauswahl"=Fenster erscheint,
2657 mit dem Sie den Klassenpfad des Importers wählen, das heißt den obersten Ordner,
2658 in dem die Package"=Struktur Ihres Importers beginnt. In einem zweiten Dateiauswahl"=Fenster
2659 wählen Sie die \emph{.class}"=Datei Ihres Importers, die von \texttt{\textbackslash{}ImportFormat} abgeleitet
2660 ist. Wenn Sie \menu{Klasse auswählen} klicken, erscheint Ihr neuer Importer
2661 in der Liste der externen Importfilter. Alle externen Importfilter erscheinen in den
2662 \jabref"=Untermenüs \menu{Datei \msep{} Importieren \msep{} Externe Importfilter} und
2663 \menu{Datei \msep{} Importieren und Anhängen \msep{} Externe Importfilter}.
2665 \tip[Bitte beachten Sie: ]{Wenn Sie die Klassen in ein anderes Verzeichnis verschieben,
2666 müssen Sie den Importer entfernen und neu hinzufügen. Wenn Sie einen Importfilter
2667 mit einem bereits vorhandenen Namen registrieren, ersetzt \jabref den vorhandenen
2668 externen Importfilter. Auch wenn es in manchen Fällen möglich ist, einen schon registrierten
2669 Importer zu aktualisieren ohne \jabref neu zu starten (nämlich dann,
2670 wenn der Importer nicht im Klassenpfad von \jabref ist), empfehlen wir, grundsätzlich
2671 \jabref neu zu starten, wenn Sie ein Update eines externen Importers durchgeführt haben.
2672 Sie können auch Importer aus ZIP- oder JAR-Archiven registrieren, wählen Sie einfach
2673 \emph{\menu{Aus Archiv-Datei hinzufügen}}, dann das ZIP- oder JAR-Archiv und dann den Eintrag
2674 (Klassendatei), der den neuen Importer darstellt.}
2676 \subsubsection{Einen Importfilter entwickeln}
2678 Bitte schauen Sie auf unseren Download-Seiten nach Beispielen und nützlichen Dateien zur
2679 Entwicklung Ihres Importfilters.
2681 \paragraph{Ein einfaches Beispiel}
2683 Angenommen, wir wollen Dateien der folgenden Form importieren:
2685 1936;John Maynard Keynes;The General Theory of Employment, Interest and Money
2686 2003;Boldrin & Levine;Case Against Intellectual Monopoly
2687 2004;ROBERT HUNT AND JAMES BESSEN;The Software Patent Experiment
2690 \subparagraph{SimpleCsvImporter Erstellen}
2692 Erzeugen Sie in einem Text"=Editor eine Klasse, die von \texttt{ImportFormat} abgeleitet
2693 ist und die folgende Methoden implementiert:\\
2694 \texttt{getFormatName()},
2695 \texttt{isRecognizedFormat()}
2696 und \texttt{importEntries()}.\\
2701 import net.sf.jabref.*;
2702 import net.sf.jabref.imports.ImportFormat;
2703 import net.sf.jabref.imports.ImportFormatReader;
2705 public class SimpleCsvImporter extends ImportFormat {
2707 public String getFormatName() {
2708 return "Simple CSV Importer";
2711 public boolean isRecognizedFormat(InputStream stream) throws IOException {
2712 return true; // this is discouraged except for demonstration purposes
2715 public List importEntries(InputStream stream) throws IOException {
2716 ArrayList bibitems = new ArrayList();
2717 BufferedReader in = new BufferedReader(ImportFormatReader.getReaderDefaultEncoding(stream));
2719 String line = in.readLine();
2720 while (line != null) {
2721 if (!"".equals(line.trim())) {
2722 String[] fields = line.split(";");
2723 BibtexEntry be = new BibtexEntry(Util.createNeutralId());
2724 be.setType(BibtexEntryType.getType("techreport"));
2725 be.setField("year", fields[0]);
2726 be.setField("author", fields[1]);
2727 be.setField("title", fields[2]);
2729 line = in.readLine();
2737 \subparagraph{SimpleCsvImporter übersetzen}
2739 Beachten Sie, dass die Beispielklasse im Default"=Package liegt. Angenommen, sie liegt unter \texttt{/meinpfad\slash{}SimpleCsvImporter.java}, die Datei \texttt{JabRef-2.0.jar} ist im gleichen Verzeichnis wie
2740 \texttt{SimpleCsvImporter.java} und Java ist in Ihrem Kommandopfad.
2741 Kompilieren Sie die Klasse mit JSDK 1.4 zum Beispiel mit folgendem Kommandozeilen"=Aufruf:
2743 javac -classpath JabRef-2.0.jar SimpleCsvImporter.java
2745 Nun sollte dort auch eine Datei \texttt{/mypath/SimpleCsvImporter.class} liegen.
2747 \subparagraph{SimpleCsvImporter registrieren}
2749 Öffnen Sie in \jabref \menu{Optionen} \msep{} \menu{Verwaltung externer Importfilter} und klicken Sie
2750 auf \menu{Aus Klassenpfad hinzufügen}. Navigieren Sie nach \texttt{/meinpfad} und
2751 klicken Sie \menu{Klassenpfad auswählen}. Wählen Sie anschließend die Datei \texttt{SimpleCsvImporter.class}
2752 und klicken Sie \menu{Klasse auswählen}. Ihr Importfilter sollte nun in der Liste der
2753 externen Importfilter unter dem Namen >>Simple CSV Importer<< erscheinen und,
2754 sobald Sie \menu{Schließen} gewählt haben, auch in den Untermenüs \menu{Datei} \msep{} \menu{Importieren} \msep{}
2755 \menu{Externe Importfilter} und \menu{Datei} \msep{} \menu{Importieren und Anhängen} \msep{} \menu{Externe Importfilter}
2756 des \jabref-Hauptfensters auftauchen.
2758 \subsection{Teilen Sie Ihre Arbeit mit anderen}
2759 \label{subsec:Ihre-Arbeit}
2760 Mit externen Layout-Dateien und Importfiltern ist es einfach, Ihre eigenen Export-Formate und Importfilter
2761 mit anderen Anwendern gemeinsam zu benutzen. Falls Sie einen Exportfilter oder einen Importfilter
2762 für ein Format erstellt haben, das noch nicht von \jabref unterstützt wird,
2763 oder falls Sie einen bestehenden Exportfilter oder Importfilter verbessern, möchten
2764 wir Sie ermutigen, Ihre Arbeit auf der \href{http://sourceforge.net/projects/jabref/}{SourceForge.net"=Seite} bereitzustellen.
2765 Dasselbe gilt für Formatierklassen, die Sie schreiben. Wir würden
2766 uns freuen, eine Sammlung von bereitgestellten Layout"=Dateien verteilen
2767 zu können oder die Standard"=Exportfilter, -Formatierer und -Importfilter
2771 \section{Tastenkürzel}
2773 Die Menüs können alle über Tastenkürzel angesteuert werden, die meisten
2774 Menübefehle ebenfalls. Das ist immer am unterstrichenen Buchstaben
2777 Es folgt ein Überblick über die wichtigsten Tastenkürzel ohne Anspruch
2778 auf Vollständigkeit~\ldots{}
2780 \begin{longtable}{p{66mm}p{33mm}}
2781 \textbf{Datei (Forts.)}&
2788 STRG-O\tabularnewline
2790 STRG-S\tabularnewline
2791 Datei speichern unter~\ldots{}&
2792 STRG-SHIFT-S\tabularnewline
2794 STRG-W\tabularnewline
2800 STRG-Q\tabularnewline
2803 \begin{longtable}{p{66mm}p{33mm}}
2804 \textbf{Bearbeiten (Forts.)}&
2807 \textbf{Bearbeiten}&
2811 STRG-N\tabularnewline
2812 Neuer Eintrag -- Article&
2813 STRG-SHIFT-A\tabularnewline
2814 Neuer Eintrag -- Book&
2815 STRG-SHIFT-B\tabularnewline
2816 Neuer Eintrag -- Phdthesis&
2817 STRG-SHIFT-T\tabularnewline
2818 Neuer Eintrag -- Inbook&
2819 STRG-SHIFT-I\tabularnewline
2820 Neuer Eintrag -- Mastersthesis&
2821 STRG-SHIFT-M\tabularnewline
2822 Neuer Eintrag -- Proceedings&
2823 STRG-SHIFT-P\tabularnewline
2824 Neuer Eintrag -- Unpublished&
2825 STRG-SHIFT-U\tabularnewline
2826 Neuer Eintrag aus Klartext&
2827 STRG-SHIFT-N\tabularnewline
2829 STRG-E\tabularnewline
2830 \bibtex{}-Keys generieren&
2831 STRG-G\tabularnewline
2833 STRG-Y\tabularnewline
2835 STRG-Z\tabularnewline
2837 STRG-X\tabularnewline
2839 STRG-C\tabularnewline
2841 STRG-V\tabularnewline
2845 STRG-A\tabularnewline
2846 \texttt{\textbackslash{}cite\{BibTeX-Key\}} kopieren&
2847 STRG-K\tabularnewline
2849 STRG-M\tabularnewline
2851 STRG-SHIFT-M\tabularnewline
2852 Präambel bearbeiten&
2853 STRG-P\tabularnewline
2855 STRG-T\tabularnewline
2858 \begin{longtable}{p{66mm}p{33mm}}
2859 \textbf{Ansicht / Navigation (Forts.)}&
2862 \textbf{Ansicht / Navigation}&
2865 Zur nächsten geöffneten Datei springen&
2866 STRG-Bild ab\tabularnewline
2867 Zum vorherigen TAB springen&
2868 STRG-Bild auf\tabularnewline
2869 Gruppendialog ein-/ausblenden&
2870 STRG-SHIFT-G\tabularnewline
2871 Eintragsvorschau ein-/ausblenden&
2872 STRG-F9\tabularnewline
2873 Layout der Eintragsvorschau wechseln&
2877 \begin{longtable}{p{66mm}p{33mm}}
2878 \textbf{Externe Programme / Internet (Forts.)}&
2881 \textbf{Externe Programme / Internet}&
2884 Literaturangaben in \LyX einfügen&
2885 STRG-L\tabularnewline
2886 Literaturangaben in WinEdt einfügen&
2887 STRG-SHIFT-W\tabularnewline
2892 PDF-Links synchronisieren&
2893 SHIFT-F4\tabularnewline
2894 PS-Links synchronisieren&
2895 STRG-F4\tabularnewline
2900 Literaturangaben von CiteSeer abrufen&
2904 \begin{longtable}{p{66mm}p{33mm}}
2905 \textbf{Extras / Sonstiges (Forts.)}&
2908 \textbf{Extras / Sonstiges}&
2912 STRG-F\tabularnewline
2914 STRG-SHIFT-F\tabularnewline
2916 STRG-R\tabularnewline
2922 \section{Häufige Fragen und Antworten}\label{sec:faq}
2925 Die folgenden Fragen und Antworten sind der \href{http://jabref.sourceforge.net/faq.php}{\jabref-Homepage} entnommen. Falls Sie darüber hinaus Fragen haben, die das Handbuch nicht beantworten konnte, haben Sie folgende Möglichkeiten, zu einer Antwort zu kommen:
2927 \item Durchsuchen Sie die \href{http://sourceforge.net/forum/?group_id=92314}{Foren} auf der Projektseite bei Sourceforge.
2928 \item Durchsuchen Sie das \href{http://sourceforge.net/mailarchive/forum.php?forum_name=jabref-users}{Archiv} der \jabref-Mailingliste.
2929 \item Stellen Sie Ihre Frage in einem der Foren oder auf der \href{http://sourceforge.net/mail/?group_id=92314}{\jabref-Mailingliste}.
2932 \faq{Läuft \jabref unter freiem Java (Classpath, Kaffee GCJ etc.)?}{Am 13.~November~2006 hat Sun sein Java unter die GNU General Public License (Version~2) gestellt, so dass die Antwort ">Ja"< lautet. Ansonsten ist zu sagen, dass eine unserer Abhängigkeiten derzeit zu einem Absturz führt, wenn mit einer anderen Java API als der von Sun gearbeitet wird. Das gilt für Version 0.92 von Classpath.}
2934 \faq{\label{faq-linux}\jabref startet nicht unter Linux. Was kann ich tun?}{\jabref läuft unter Linux, wenn Sie eine Java Runtime Environment (JRE) von Sun in der Version~1.4.2 oder einer neueren Version verwenden. Falls \jabref dennoch nicht starten sollte, können Sie folgende Fehlersuche durchführen:
2935 Starten Sie \texttt{java -{-}version} von der Kommandozeile. Falls dabei kein Produkt von Sun Microsystems verwendet wird (sondern beispielsweise angezeigt wird, dass Sie GCJ VM verwenden), selbst wenn Sie die JRE von Sun installiert haben, müssen Sie Ihr Setup anpassen. Da das Vorgehen dafür sehr von Ihrer Linux-Distribution abhängt, können wir keine Hinweise für jede mögliche Konstellation geben.
2936 Unter Debian/Ubuntu können Sie die Einstellungen anpassen, indem Sie \texttt{sudo update-alternatives -{-}config java} aufrufen (dazu brauchen Sie admin-Rechte). In dem Dialog, der daraufhin erscheint, wählen Sie die Sun JDK oder JRE. Alternativ können Sie auch nach der Java-Programmdatei suchen und diese direkt ausführen. In Ubuntu findet man Java gewöhnlich unter \texttt{/usr\slash{}lib\slash{}jvm\slash{}java-1.5.0-sun\slash{}jre\slash{}bin\slash{}java}.
2937 Wenn Sie keine admin-Rechte auf dem Computer haben, können Sie die Sun JRE in ihrem Home-Verzeichnis installieren. Sie müssen dann darauf achten, dass Sie die richtige Programmdatei aufrufen. Wenn Sie die JRE z.\,B. in einen Ordner namens ">java"< in ihrem Home-Verzeichnis installiert haben, geben Sie \texttt{\texttildelow{}/java/jre/bin/java -jar JabRef-2.1.jar} (bzw. die entsprechende Versionsnummer) in der Kommandozeile ein.}
2939 \clearpage\faq{Ich arbeite unter Ubuntu und \jabref startet, wenn ich auf das Icon klicke, aber nicht von der Kommandozeile. Wo liegt das Problem?}{Sie haben mehrere Java Virtual Machines installiert und von der Kommandozeile wird die falsche gewählt. Schauen Sie unter Frage \ref{faq-linux} nach, wie Sie die Einstellungen ändern können.}
2941 \faq{Wie kann ich verhindern, dass \jabref beim Speichern der .bib"=Datei in bestimmten Feldern (wie \texttt{title}) Zeilenumbrüche einfügt?}{Öfnnen Sie \menu{Optionen \msep{} Einstellungen}. Im Bereich \menu{Allgemein} gibt es die Option \menu{Beim Speichern keinen Zeilenumbruch in den folgenden Feldern einfügen}. Diese Option enthält eine Liste von Feldnamen. In Feldern, die Sie dieser Liste hinzufügen (abgetrennt mit einem Semikolon) wird beim Speichern kein Zeilenumbruch hinzugefügt.}
2943 \faq{Mein Virenscanner sagt mir, dass \jabref ein Virus ist. Ist der Server gefährdet?}{Nein, aber der Windows"=Installer benutzt das \href{http://nsis.sourceforge.net/}{Nullsoft Scriptable Install System (NSIS)} in der Version~2.18 (seit \jabref~2.1), das unglücklicherweise Installer produziert, die von einigen Virenscannern als Virus eingeschätzt werden. Wenn Sie mehr darüber erfahren wollen, sehen Sie sich die \href{http://forums.winamp.com/showthread.php?postid=1977648}{Diskussion im NSIS"=Forum} oder die \href{http://nsis.sourceforge.net/NSIS_False_Positives}{Liste der NSIS ">false positives"<} an.
2945 Als Workaround und falls Sie Bedenken haben, den Installer zu benutzen, können Sie immer die plattformunabhängige jar"=Datei benutzen (siehe dazu Abschnitt ">\nameref{subsub:jar}"<).}
2948 \section{Entwicklung}
2952 \noindent \jabref ist ein \emph{Open Source} Projekt, das heißt, dass jede(r)
2953 dazu beitragen kann, das Programm zu verbessern und weiterzuentwickeln.
2954 Wenn Sie Anregungen, Wünsche oder Fragen haben, ist die erste Anlaufstelle
2955 die \href{http://sourceforge.net/projects/jabref/}{Projektseite bei \emph{Sourceforge}}.
2956 Dort gibt es Foren, in denen Sie Ihre Fragen stellen können, und eine
2957 Mailingliste rund um \jabref. Auch Ihre Wünsche \emph{(Feature
2958 Requests)} und Fehlermeldungen \emph{(Bug Reports)} können Sie dort
2959 loswerden. Um sich direkt als Entwickler einzubringen, wenden Sie
2960 sich an einen der beiden Maintainer (Morten O. Alver und Nizar N.
2961 Batada)~-- die E-Mail-Adressen finden Sie auf der Projektseite bei
2962 \emph{Sourceforge}. Sie brauchen lediglich einen Sourceforge-Login,
2963 der dann für das Projekt freigeschaltet werden kann.
2966 \subsection{Beschränkungen und bekannte Probleme (Bugs)}
2969 \emph{Da sich die Software schneller entwickelt als dieses Handbuch, muss an dieser Stelle auf die \href{http://sourceforge.net/projects/jabref/}{Projektseite bei Sourceforge} verwiesen werden.}
2972 \subsection{Danksagung}
2974 Neben den Entwicklern, die die Hilfe"=Seiten des Programms geschrieben haben, danke ich Robert Bitsche, Daniel Förderer, Thomas Fritz, Axel Junge, Jan Suhr und Tobias Wolf für ihre hilfreichen Tipps und Anmerkungen zum Handbuch.
2976 Seit den Anfängen als \emph{BibKeeper} (von Morten O.~Alver) und \emph{JBibtexManager} (von Nizar N.~Batada) haben
2977 zahlreiche Personen dazu beigetragen, dass \jabrefversion{} zu dem
2978 geworden ist, was es ist. Wer zum Entwicklerteam gehört und wer alles zum Programm beigetragen hat, können Sie im Programm unter \menu{Hilfe \msep{} Über JabRef} nachsehen.
2982 \jabref ist frei verfügbar unter den Bedingungen der \href{http://www.gnu.org/copyleft/gpl.html}{GNU General Public License}. Es gibt unterschiedliche Softwarepakete, die von \jabref genutzt werden. Wenn Sie sich über die Lizenzbestimmungen dieser Fremdsoftware informieren wollen, schauen Sie bitte unter \menu{Hilfe \msep{} Über JabRef} nach.
2987 \hypertarget{bibliography}{}
2988 \bibliographystyle{jurabib}
2989 \bibliography{JabRef-UserManual_de}
2993 \addsec{Versionsgeschichte}
2995 \label{RevisionHistory}
2997 %\begin{revhist}{\versiondate}%endgültiges Datum}
3001 \begin{revhist}{\versiondate}%endgültiges Datum}
3002 \item Abschnitte ">\nameref{search-regular-expressions}"< und ">\nameref{kommandozeilenoptionen}"< ergänzt
3003 \item Kleinere Änderungen
3006 \begin{revhist}{1.\,12.\,2007}
3007 \item Abschnitt ">\nameref{NameFormatter}"< hinzugefügt
3008 \item Abschnitte ">\nameref{par:Feldformatierer}"< und ">\nameref{subsub:SpezielleFeldmarken}"< ergänzt
3011 \begin{revhist}{4.\,7.\,2007}
3012 \item Abschnitt ">\nameref{FileLinks}"< hinzugefügt
3013 \item Abschnitt ">Links zu externen Dateien"< in \nameref{ExternalFiles} umbenannt
3014 \item Kleine Änderungen
3017 \begin{revhist}{8.\,6.\,2007}
3018 \item Abschnitt ">Import und Export"< in zwei Abschnitte unterteilt
3019 \item Abschnitt ">\nameref{sec:faq}"< ergänzt
3020 \item Abschnitte ">\nameref{EntryEditorHelp}"< und ">\nameref{subsec:System-Voraussetzungen}"< angepasst
3021 \item Fehler im Abschnitt ">\nameref{PreviewHelp}"< korrigiert
3022 \item Versionsnummer angepasst
3023 \item Beschreibung der Felder ">doi"< und ">eid"< hinzugefügt
3024 \item Fehler im Link zum Mail-Archiv beseitigt
3025 \item Einleitung leicht ergänzt
3026 \item Generelle Überarbeitung des Dokuments
3029 \begin{revhist}{18.\,4.\,2007}
3030 \item Abschnitte ">\nameref{LabelPatterns}"<, ">\nameref{StringEditorHelp}"< und ">\nameref{par:Feldformatierer}"< aktualisiert
3031 \item Fehler in Abschnitt ">\nameref{subsec:Starten-Kommandozeile}"< entfernt
3032 \item \jabref-Logo geändert
3033 \item Ein paar Kleinigkeiten
3036 \begin{revhist}{20.\,3.\,2007}
3037 \item Abschnitt ">\nameref{subsubsec:Hinzufuegen-Exportfilter}"< angepasst
3038 \item Kleinere Änderungen
3041 \begin{revhist}{1.\,2.\,2007}
3042 \item Abschnitte ">\nameref{EndnoteFilters}"<, ">\nameref{subsubsec:endnote-jabref}"<, ">\nameref{subsec:about}"< und ">\nameref{sec:faq}"< überarbeitet
3043 \item Literaturverzeichnis um Eintrag von \cite{btxfaq} ergänzt
3044 \item Und noch ein paar kleine Änderungen
3047 \begin{revhist}{19.\,1.\,2007}
3048 \item Abschnitt ">\nameref{Eintragstypen}"< hinzugefügt
3049 \item Grafik auf Titelseite ausgetauscht
3050 \item Ein paar kleinere Änderungen
3053 \begin{revhist}{10.\,12.\,2006}
3054 \item Abschnitt ">XMP-Metadaten"< leicht verbessert
3055 \item FAQ zu freien Java-APIs aktualisiert (Suns Java ist jetzt selbst frei)
3056 \item Wie immer: kleinere Änderungen
3059 \begin{revhist}{9.\,12.\,2006}
3060 \item Abschnitte ">Weitere Hilfen"< in ">Häufige Fragen und Antworten (FAQ)"< umbenannt
3061 \item FAQs von der Homepage übersetzt und integriert
3062 \item Literaturverzeichnis um Eintrag von \cite{Fenn2006} ergänzt
3063 \item Ein paar kleinere Änderungen
3066 \begin{revhist}{30.\,11.\,2006}
3067 \item Abschnitte ">Weitere Hilfen"< hinzugefügt
3070 \begin{revhist}{28.\,11.\,2006}
3071 \item Abschnitte ">Abkürzung von Zeitschriftentiteln"<, ">XMP-Metadaten"<, ">IEEExplore"< und ">Externer Zugriff"< hinzugefügt
3072 \item Abschnitte ">Einführung in \bibtex{}"<, ">Das Hauptfenster"<, ">Links zu externen Dateien"< und ">Jabref und Online-Datenbanken"< erweitert
3073 \item Abschnitt ">Suchfunktionen"< aktualisiert
3074 \item Abschnitt ">Entwicklung"< gekürzt
3075 \item Paket ">listings"< eingebunden (ersetzt Umgebung ">lyxcode"<)
3076 \item Typewriter-Schrift \texttt{beramono} eingesetzt
3077 \item Einige kleinere Änderungen
3080 \begin{revhist}{30.\,1.\,2006}
3081 \item Abschnitt >>\jabref-Bibliographien in OpenOffice.org benutzen<< aktualisiert
3082 \item Abschnitt zur Erzeugung der \bibtex{}-Keys aktualisiert
3083 \item Neues Kapitel (>>Externe Importfilter<<), geschrieben von Andreas Rudert
3084 \item Einige kleinere Änderungen
3087 \begin{revhist}{6.\,12.\,2005}
3088 \item Lizenzbedingungen für das Handbuch hinzugefügt
3089 \item von PDF~1.4 auf PDF~1.2 umgestellt
3090 \item mehrere kleinere Änderungen
3093 \begin{revhist}{16.\,11.\,2005}
3094 \item Erstentwurf von Dominik Waßenhoven, basierend
3095 auf dem unveröffentlichten englischen \emph{Initial Draft} von Nizar Batada (20.\,2.\,2004)
3096 und den Hilfeseiten des Programms