[svn-upgrade] Integrating new upstream version, jabref (2.3~beta1)
[debian/jabref.git] / src / help / de / JabRef-UserManual_de.tex
1 %%%%% To do %%%%%
2 % DW 2007-03-23
3 % - Bibliographie mit biblatex statt jurabib?
4 \documentclass[10pt,normalheadings,ngerman]{scrartcl}
5 \usepackage[T1]{fontenc}
6 \usepackage[latin1]{inputenc}
7 \usepackage{textcomp}
8 \setcounter{secnumdepth}{2}
9 \setcounter{tocdepth}{4}
10 \usepackage{xspace}
11
12 %%%%% author, version of file %%%%%
13 \newcommand{\versiondate}{in Bearb.}%8.\,6.\,2007 20:44
14 \def\FileAuthor{Dominik Waßenhoven}
15 \def\FileTitle{\jabrefversion{} Benutzerhandbuch}
16
17 %%%%% Page Dimensions %%%%%
18 \usepackage{geometry}
19 \geometry{verbose,a5paper,tmargin=2cm,bmargin=2cm,lmargin=1cm,rmargin=1cm}
20
21 %%%%% Packages %%%%%
22 \usepackage{array}
23 \usepackage{longtable}
24 \usepackage{amsmath}
25 \usepackage{graphicx}
26 \usepackage{setspace}
27 \usepackage{amssymb}
28 \usepackage{soul}
29 \usepackage{hanging}
30
31 \makeatletter
32 %%%%% LyX command %%%%%
33 \providecommand{\LyX}{L\kern-.1667em\lower.25em\hbox{Y}\kern-.125emX\@\xspace}
34
35 %%%%% Listings %%%%%
36 \usepackage{listings}
37 \lstset{%
38   frame=none,
39   %backgroundcolor=\color{pyellow},
40   language=[LaTeX]TeX,
41   basicstyle=\ttfamily,%\small,
42   commentstyle=\color{red},
43   keywordstyle=, % LaTeX-Befehle werden nicht fett dargestellt
44   numbers=none,%left/right
45   %numberstyle=\tiny\lnstyle,
46   %numbersep=5pt,
47   %numberblanklines=false,
48   breaklines=true,
49   %caption=\lstname,
50   xleftmargin=25pt,
51   xrightmargin=20pt,
52   escapeinside={(*}{*)},
53   belowskip=\medskipamount,
54   prebreak=\mbox{$\hookleftarrow$}% "geklaut" vom scrguide (KOMA-Script)
55 }
56
57 %%%%% Environment "revhist" (for revision history) %%%%%
58 \newenvironment{revhist}[1]
59     {\subsection*{#1}
60      \list{--}{\setlength\itemsep{0pt}\setlength{\parsep}{0pt}}}
61     {\endlist}
62
63 %%%%% PDF 1.2 for Acrobat 3 onwards %%%%%
64 \pdfoptionpdfminorversion 2
65
66 %%%%% Colors %%%%%
67 \usepackage[dvipsnames]{xcolor}
68 \definecolor{dkblue}{rgb}{0,0.1,0.5} % dark blue
69 \definecolor{dkred}{rgb}{0.66,0.04,0.04} % dark red
70 \definecolor{pyellow}{rgb}{1,0.97,0.75} % pale yellow
71
72 %%%%% New commands %%%%%
73 %%% JabRef "logo"
74 \DeclareRobustCommand{\jabref}{%
75   \texorpdfstring{% TeX string
76           \raisebox{-.32ex}{\color{dkred}J}\kern-.06em%
77             \hbox{$\m@th$% %% force math size calculations
78                   \csname S@\f@size\endcsname
79                   \fontsize\sf@size\z@
80                   \math@fontsfalse\selectfont
81                   \color{orange}A\kern-.025emB}\-%
82           \hbox{\kern-.06em\-R\hspace{-.08em}%
83             \raisebox{.16ex}{$\m@th$% %% force math size calculations
84                   \csname S@\f@size\endcsname
85                   \fontsize\sf@size\z@
86                   \math@fontsfalse\selectfont
87                   E\kern-.025emF}}\xspace}%
88           {JabRef\xspace}% PDF string
89 }
90
91 %%% version number
92 \newcommand{\versionnr}{\texorpdfstring{2.3\,(beta)}{2.3 (beta)}} %
93 %%% JabRef logo with version nr
94 \newcommand{\jabrefversion}{\jabref~\versionnr}
95 %%% BibTeX logo
96 \newcommand{\bibtex}{\texorpdfstring{Bib\kern-.125em\TeX\xspace}{BibTeX}}
97 %%% for Menu references
98 \newcommand{\menu}[1]{\texorpdfstring{{\color{dkred}\textit{#1}}}{#1}}
99 %%% Menu separator
100 \newcommand{\msep}{{\color{dkred}\textit{\guilsinglright}}}
101 %%% yellow box with dark blue text
102 \newcommand{\tip}[2][Tipp: ]{%
103   \begin{center}%
104   \colorbox{pyellow}{\parbox{0.85\textwidth}{%
105     \color{dkblue}\textit{#1}#2}}%
106   \end{center}%
107 }%
108 %%% for the FAQ 
109 \newcounter{faq}
110 \newcommand{\faq}[2]{\refstepcounter{faq}%
111   \medskip\noindent\colorbox{pyellow}{\parbox{0.9\textwidth}{%
112     \hangpara{0.11\textwidth}{1}%
113     \color{dkblue}Frage \thefaq: \textit{#1}}}\par\smallskip%
114   \begin{hangparas}{0.11\textwidth}{0}%
115     #2\par%
116   \end{hangparas}
117 }%
118
119 %%% for CTAN references
120 \newcommand{\ctan}[1]{%
121   {\textsc{ctan}: \color{dkred}#1}%
122 }
123
124 %%%%% Headings %%%%%
125 \usepackage{scrpage2}
126 \pagestyle{scrheadings}
127 \ihead{\FileTitle{} (\versiondate{})}
128 \chead{}
129 \ohead{\headmark}
130 \ifoot{}
131 \cfoot{\pagemark}
132 \ofoot{}
133 \automark[section]{section}
134
135 %%%%% Fonts %%%%%
136 \usepackage{charter}
137 \addtokomafont{sectioning}{\rmfamily} % Headings with serifs
138 \renewcommand{\headfont}{\normalfont\itshape} % Headlines italic, not slanted ***
139 \usepackage[scaled=.83]{beramono}
140
141 %%%%% Other stuff %%%%%
142 \deffootnote{1.5em}{1em}{\makebox[1.5em][l]{\thefootnotemark}}
143 %\usepackage{microtype} % micro typography
144
145 %%%%% Mini TOCs %%%%%
146 \usepackage{minitoc}
147 \mtcsetrules{secttoc}{off}
148 %\mtcsetdepth{secttoc}{3}
149 \mtcsetfont{secttoc}{subsection}{}
150 %\mtcsettitle{secttoc}{In diesem Abschnitt}
151 %\mtcsettitlefont{secttoc}{\itshape}
152
153 %%%%% Language %%%%%
154 \usepackage{babel}
155
156 %%%%% Bibliography %%%%%
157 \usepackage{jurabib}
158 \jurabibsetup{%
159   annote=true,
160   authorformat=year,
161   dotafter=bibentry
162 }
163 \renewcommand{\biblnfont}{}                     % Autoren-Nachnamen (Standard: fett)
164 \renewcommand{\bibfnfont}{}                     % Autoren-Vornamen (Standard: fett)
165 \renewcommand{\bibelnfont}{}                    % Hrsg-Nachnamen (Standard: fett)
166 \renewcommand{\bibefnfont}{}                    % Hrsg-Vornamen (Standard: fett)
167 \renewcommand{\bibtfont}{\textit}       % Titel (Bücher)
168 \renewcommand{\bibbtfont}{\textit}      % Titel (Sammelwerke)
169 \renewcommand{\bibjtfont}{\textit}      % Titel (Zeitschriften)
170 \renewcommand{\bibpldelim}{(}                   % runde Klammern bei...
171 \renewcommand{\bibprdelim}{)}                   % ...Zeitschriften (Jahr)
172 \renewcommand{\ajtsep}{}                                % kein Komma nach Zs-Titeln
173 \renewcommand{\biburlprefix}{\jblangle\textsc{url: }}   % Klammer und Text vor einer URL (Standard: "URL: ")
174
175 \renewcommand{\bib@heading}{\addsec{Kommentiertes Literaturverzeichnis}}
176
177 %%%%% Hyperref %%%%%
178 \usepackage{hyperref}
179 \hypersetup{%
180 breaklinks=true,%
181 colorlinks=true,%
182 linkcolor=dkblue,%
183 urlcolor=dkblue,%
184 citecolor=dkblue,%
185 pdftitle={JabRef \versionnr{} Benutzerhandbuch},%
186 pdfsubject={Einführung in die Benutzung von JabRef},%
187 pdfkeywords = {BibTeX, Bibliographie, Literaturverwaltung},%
188 pdfauthor={\FileAuthor},%
189 pdfstartview=FitH,%
190 bookmarksopen=true,%
191 bookmarksopenlevel=1,%
192 }
193 \urlstyle{rm}
194
195 \hyphenation{
196 LaTeX
197 BibTeX
198 Da-tei-na-men
199 Me-nü-be-feh-le
200 For-mat-erken-nung% verhindert Trennung "Formater-kennung"
201 }
202
203 \makeatother
204
205 %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%% %%%%%
206 \begin{document}
207
208 \subject{\includegraphics[scale=.5]{../../images/JabRef-icon-48}}
209
210
211 \title{\jabrefversion{}\\
212 Benutzerhandbuch}
213
214
215 \author{Dominik Waßenhoven\\
216 {\normalsize (\href{mailto:domwass@users.sourceforge.net}{domwass@users.sourceforge.net})}}
217
218
219 \date{\small \versiondate}
220
221 \maketitle
222
223 \begin{abstract}
224 \jabref ist eine grafische Java-Anwendung zur Bearbeitung von \bibtex{}-Dateien
225 (.bib). Mit \jabref können Literaturangaben in Gruppen organisiert
226 und mit einem einfachen Klick die Ansicht auf eine einzelne Gruppe,
227 eine Schnittmenge von Gruppen oder die Gesamtmenge mehrerer Gruppen
228 eingegrenzt werden. \jabref kann Literaturangaben sortieren (für
229 alle Standard-\bibtex{}-Felder) und automatisch \bibtex{}-Keys erzeugen.
230 Auch Links zu PDF-Dateien oder Webseiten können mit \jabref einfach
231 erstellt werden.
232
233 \jabref kann verschiedene Dateiformate importieren und exportieren,
234 außerdem können die Exportfilter angepasst werden. \jabref kann
235 auch von der Kommandozeile gestartet werden, um von einem Importformat
236 in ein Exportformat zu konvertieren, ohne die grafische Benutzeroberfläche
237 zu starten.
238 \end{abstract}
239 \begin{quote}
240 \begin{spacing}{0.7}
241 \begin{center}{\scriptsize Copyright \textcopyright{} 2005--2007, Dominik
242 Waßenhoven}
243 \end{center}
244 {\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}
245
246 \end{quote}
247 \thispagestyle{empty}
248
249 \newpage
250 \dosecttoc[e]
251 \faketableofcontents{}
252
253 \newpage
254
255
256 \section{Einleitung}
257 \secttoc
258
259 \subsection{Über dieses Handbuch}\label{subsec:about}
260
261 Dieses Handbuch will eine kurze Einführung zu den nützlichsten Funktionen
262 von \jabref bieten, ohne dabei eine erschöpfende Beschreibung aller
263 Funktionalitäten dieser Software zu liefern. \emph{}\jabref ist
264 das Ergebnis der Verschmelzung von \emph{BibKeeper} und \emph{JBibtexManager}.
265 Weitere Informationen gibt es im Programm selbst unter \menu{Hilfe} \msep{} \menu{Inhalt}
266 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}).
267
268 Die Anleitungen basieren auf den Hilfeseiten des Programms. Da dieses
269 Handbuch und die Hilfeseiten unabhängig voneinander gepflegt und aktualisiert
270 werden, müssen die Beschreibungen jedoch nicht immer übereinstimmen.
271 Im Zweifel sind die Hilfeseiten des Programms aktueller als die hier
272 vorgelegte Beschreibung.
273
274 Am Anfang jedes Abschnitts sollte~(!) zunächst stehen, wie man zur
275 entsprechenden Funktion gelangt (d.\,h. über welches Menü und mit
276 welchem Tastenkürzel). Menü-Einträge werden in einer kursiven, dunkelroten
277 Schrift dargestellt (Beispiel: \menu{Menü} \msep{} \menu{Untermenü}).
278 Besondere Hinweise und Tipps werden in einem gelb hinterlegten Kasten
279 mit dunkelblauer Schrift dargestellt. Hyperlinks sind ebenfalls dunkelblau
280 und anklickbar~-- das gilt sowohl für die Navigation innerhalb des
281 Dokuments als auch für Links ins Internet.
282
283 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 Versionen dieses Handbuchs gibt der Abschnitt ">\nameref{RevisionHistory}"< Auskunft.
284
285 \subsection{Einführung in \bibtex{}}
286
287 \label{BibtexHelp}\tip[]{\jabref hilft Ihnen bei der Arbeit mit
288 Ihren \bibtex{}-Dateien, aber es müssen dennoch Regeln beachtet werden,
289 wenn Sie Ihre Einträge bearbeiten. Nur so kann sichergestellt werden,
290 dass \bibtex{} Ihre Datei richtig verarbeiten kann.}
291
292 \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.
293
294 \subsubsection{\bibtex{}-Eintragstypen}
295 \label{Eintragstypen}
296 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.
297
298 \begin{itemize}
299 \item \emph{@article}\\
300 Ein Artikel in einer Zeitschrift.
301 \item \emph{@book}\\
302 Ein Buch, von einem Verlag veröffentlicht.
303 \item \emph{@booklet}\\
304 Ein gedrucktes und gebundenes Buch ohne Verlag.
305 \item \emph{@conference}\\
306 Siehe \emph{@inproceedings}
307 \item \emph{@inbook}\\
308 Ein Teil eines Buches, z.\,B. ein Kapitel oder Abschnitt.
309 \item \emph{@incollection}\\
310 Ein Beitrag aus einem Buch, z.\,B. einem Sammelband.
311 \item \emph{@inproceedings}\\
312 Ein Artikel aus einem Tagungsbericht, der nicht zwangsläufig in einem Verlag erschienen ist.
313 \item \emph{@manual}\\
314 Eine Dokumentation oder ein Handbuch.
315 \item \emph{@mastersthesis}\\
316 Eine Diplom-/Magisterarbeit.
317 \item \emph{@misc}\\
318 Dieser Typ kann benutzt werden, wenn nichts anderes passt.
319 \item \emph{@phdthesis}\\
320 Eine (unveröffentlichte) Dissertation.
321 \item \emph{@proceedings}\\
322 Ein Tagungsbericht.
323 \item \emph{@techreport}\\
324 Von einer Universität oder Institution (normalerweise in einer Reihe) veröffentlichter Bericht.
325 \item \emph{@unpublished}\\
326 Ein Dokument mit Autor und Titel, unveröffentlicht.
327 \end{itemize}
328
329 \subsubsection{\bibtex{}-Felder}
330
331 Es gibt viele unterschiedliche Felder in \bibtex{} und einige zusätzliche Felder, die Sie in \jabref einsetzen können.
332 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.}
333
334 Hinweise zu einigen Feldtypen:
335 \begin{itemize}
336 \item \emph{Bibtexkey}\\
337 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).
338   \item \emph{address}\\
339     Der Ort des \emph{Verlags} oder einer anderen Institution.
340   \item \emph{annote}\\
341     Eine Anmerkung.
342 Dieses Feld wird von den Standard-Bibliographiestilen nicht verwendet, kann aber bei einigen Stilen benutzt werden, um eine kommentierte Literaturliste zu erstellen.
343   \item \emph{author}\\
344     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:
345 \begin{itemize}
346 \item Donald E. Knuth \emph{oder} Knuth, Donald E.
347 \item Eddie van Halen \emph{oder} van Halen, Eddie
348 \end{itemize}
349 Die zweite Form sollte für Autoren mit zwei oder mehr Nachnamen benutzt werden, um zwischen dem mittleren und dem Nachnamen zu unterscheiden.
350   \item \emph{booktitle}\\
351     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.
352   \item \emph{chapter}\\
353     Eine Kapitelnummer (oder Abschnittsnummer oder was-auch-immer-Nummer).
354   \item \emph{crossref}\\
355     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.
356   \item \emph{edition}\\
357     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.
358   \item \emph{editor}\\
359     Dieses Feld ist analog zu dem \emph{author}-Feld.
360 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.
361   \item \emph{howpublished}\\
362     Die Art, wie ein Werk veröffentlicht wurde (meist außerhalb eines Verlags). Das erste Wort sollte mit einem Großbuchstaben beginnen.
363   \item \emph{institution}\\
364     Die fördernde Institutions eines technischen Reports.
365   \item \emph{journal}\\
366     Der Name einer Zeitschrift.
367 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 
368 verwenden.
369   \item \emph{key}\\
370     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).
371   \item \emph{month}\\
372     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).
373   \item \emph{note}\\
374     Zusätzliche Infromationen. Das erste Wort sollte mit einem Großbuchstaben beginnen.
375   \item \emph{number}\\
376 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.
377   \item \emph{organization}\\
378     Die Organisation, die einen Konferenzband fördert.
379   \item \emph{pages}\\
380     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).
381 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).
382   \item \emph{publisher}\\
383     Der Name des Verlags.
384   \item \emph{school}\\
385     Der Name einer Universität, an der eine Abschlussarbeit~-- z.\,B. eine Dissertation (\texttt{phdthesis}) oder Magisterarbeit (\texttt{mastersthesis})~-- geschrieben wurde.
386   \item \emph{series}\\
387     Der Name einer Reihe, in der ein Buch erschienen ist.
388 Falls die Bücher einer Reihe nummeriert sind, wird die entsprechende Nummer im Feld \texttt{number} angegeben.
389   \item \emph{title}\\
390     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}).
391   \item \emph{type}\\
392     Der Typ eines technischen Reports, z.\,B. ">Research Note"<. Bei \emph{jurabib} wird dieses Feld auch für den Typ einer Abschlussarbeit verwendet.
393   \item \emph{volume}\\
394     Der Band (Jahrgang) einer Zeitschrift oder der Band eines Buches in einem mehrbändigen Werk.
395   \item \emph{year}\\
396     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)}.
397     Dieses Feld wird für die meisten Eintragstypen benötigt.
398 \end{itemize}
399
400 \subsubsection{Weitere Felder}
401
402 Bibliographie-Stile für \bibtex{} wurden von vielen Leuten entwickelt,
403 und einige haben weitere Felder erstellt. Es folgt eine kleine Auswahl.
404
405 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}).
406
407 \begin{itemize}
408   \item \emph{affiliation*}\\
409     Die Zugehörigkeit eines Autors.
410   \item \emph{abstract}\\
411     Die Zusammenfassung eines Werks.
412   \item \emph{contents*}\\
413     Ein Inhaltsverzeichnis.
414   \item \emph{copyright*}\\
415     Copyright-Informationen.
416   \item \emph{doi}\\
417     Der \emph{Digital Object Identifier} ist eine permanente Kennung von Dokumenten.
418   \item \emph{eid}\\
419     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.
420   \item \emph{ISBN*}\\
421     Die Internationale Standardbuchnummer.
422   \item \emph{ISSN*}\\
423     Die Internationale Standardseriennummer (für Zeitschriften).
424   \item \emph{keywords}\\
425     Stichworte~-- sie können in \jabref gut zum Gruppieren verwendet werden.
426   \item \emph{language*}\\
427     Die Sprache des Werks.
428   \item \emph{location*}\\
429     Der Ort, der mit einem Werk in Verbindung steht, z.\,B. die Stadt, in der eine Konferenz stattgefunden hat.
430   \item \emph{LCCN*}\\
431     Die \emph{Library of Congress Call Number}.  Das Feld kann auch \texttt{lib-congress} heißen.
432   \item \emph{mrnumber*}\\
433     Die \emph{Mathematical Reviews}-Nummer.
434   \item \emph{price*}\\
435     Der Preis.
436   \item \emph{size*}\\
437     Die physische Größe eines Dokuments.
438   \item \emph{url}\\
439     Der \emph{Uniform Resource Locator} (URL, ">einheitlicher Quellenanzeiger"<), der auf eine Webseite im Internet verweist.
440   \item \emph{urldate}\\
441     Das Datum, an dem eine Webseite zuletzt besucht wurde.
442 \end{itemize}
443
444
445 \clearpage 
446 \section{Installation}
447 \secttoc
448
449 \subsection{System-Voraussetzungen}
450 \label{subsec:System-Voraussetzungen}
451 \jabref ist in Java programmiert und somit betriebssystemunabhängig,
452 kann prinzipiell also unter Windows, Mac OS X, Linux und anderen UNIX-Systemen
453 betrieben werden. Voraussetzung ist allerdings, dass die \emph{Java
454 Virtual Machine} mindestens in der Version~1.5 installiert ist.\footnote{Bis zur Version 2.2 von \jabref reichte Java~1.4.2 aus.}
455 Sie ist kostenlos und kann unter \url{http://java.sun.com/} heruntergeladen
456 werden. Im Normalfall sollte das \emph{Java Runtime Environment} (JRE) ausreichen;
457 nur wenn Sie \jabref kompilieren möchten, benötigen Sie das \emph{Java
458 Development Kit} (JDK).
459
460
461 \subsection{Windows}
462
463
464 \subsubsection{Installer (msi)}
465
466 \jabref gibt es im Windows Installer-Format (\texttt{.msi}). Ein
467 Doppelklick auf die MSI-Datei installiert \jabref und fügt dem
468 Startmenü eine Verknüpfung hinzu. Falls Java nicht installiert ist,
469 wird eine Warnmeldung ausgegeben.%
470 \footnote{Die Windows-Installation wurde von Dale Visser erstellt, der dazu
471 die folgenden \emph{Open-Source-Tools} benutzt hat: JSmooth, ein \texttt{.exe}
472 wrapper für Java-Anwendungen (\url{http://jsmooth.sf.net/}); Wix,
473 ein Tool zum Kompilieren von MSI-Dateien aus einer XML-Spezifikation
474 (\url{http://wix.sf.net/}).%
475 }
476
477
478 \subsubsection{Batch-Datei (jar)}
479 \label{subsub:jar}
480 Wenn Sie die ausführbare jar-Datei (\texttt{.jar}) heruntergeladen
481 haben, probieren Sie zunächst, ob ein Doppelklick darauf das Programm
482 startet~-- dies funktioniert zumindest auf einigen Systemen. Falls
483 \jabref nicht direkt startet (Windows also nicht weiß, was es mit
484 einer jar-Datei anfangen soll), fahren Sie folgendermaßen fort:
485
486 Erstellen Sie in dem Ordner, in dem Sie die Datei \emph{JabRef.jar}
487 abgelegt haben, eine Batch-Datei mit dem Namen \emph{jabref-start.bat}.
488 Diese Datei soll nur eine Zeile enthalten:
489
490 \begin{lstlisting}
491 start javaw -jar JabRef.jar
492 \end{lstlisting}
493 Mit einem Doppelklick auf die Batch-Datei starten Sie \jabref.
494
495
496 \subsection{Starten von der Kommandozeile}\label{subsec:Starten-Kommandozeile}
497
498 \begin{enumerate}
499 \item mit dem \emph{Java Runtime Environment}:
500 \begin{lstlisting}
501 jre -new -jar <Pfad zur jar-Datei>
502 \end{lstlisting}
503 oder
504 \begin{lstlisting}
505 jrew -new -jar <Pfad zur jar-Datei>
506 \end{lstlisting}
507 \item mit dem \emph{Java Development Kit}:
508 \begin{lstlisting}
509 java -jar <Pfad zur jar-Datei>
510 \end{lstlisting}
511 \end{enumerate}
512 Es wird empfohlen, \jabref mit Java 1.5 zu benutzen und die Option \lstinline{-Dswing.aatext=true}
513 vor der Option \lstinline{-jar} einfügen, um das Benutzen von Anti-Alias-Schriften
514 im Programm zu ermöglichen.
515
516 Die jar-Datei, die \jabref enthält, kann entpackt werden mit den
517 Kommandos 
518 \begin{lstlisting}
519 jar xf <Pfad zur jar-Datei>
520 \end{lstlisting}
521 bzw. 
522 \begin{lstlisting}
523 jar xf <Pfad zur jar-Datei> <Liste der Dateien, die entpackt werden sollen>
524 \end{lstlisting}
525 Das Entpacken der jar-Datei ist nicht notwendig, um das Programm zu
526 starten!
527
528 Weitere Hinweise zur Installation finden Sie in der Datei INSTALL
529 (zum Kompilieren aus den \emph{sourcen}) und auf der \href{http://jabref.sourceforge.net}{\jabref-Homepage}.
530
531
532 \clearpage 
533 \section{Funktionen}
534 \secttoc
535 \bigskip
536
537 \noindent \label{JabRefHelp}\jabref ist ein Programm zur Verwaltung von
538 \bibtex{}-Dateien. Es benutzt kein eigenes Dateiformat, d.\,h. dass
539 Sie Ihre Dateien direkt im \bibtex{}-Format (Dateiendung \texttt{.bib})
540 laden und speichern. Sie können aber auch bibliographische Datenbanken
541 anderer Formate in \jabref importieren.
542
543 \jabref unterstützt Sortier- und Suchfunktionen, um einen Überblick
544 über den Inhalt Ihrer Datei zu bekommen. Sie können der Datei ganz
545 einfach neue Einträge hinzufügen, ohne sich daran erinnern zu müssen,
546 welche Informationen benötigt werden. Außerdem kann \jabref \bibtex{}-Keys
547 automatisch generieren. \jabref ist sehr nützlich, wenn Sie \bibtex{}
548 oder CiteMaker verwenden, kann aber auch für diejenigen sinnvoll sein,
549 die andere Bibliographie-Systeme benutzen oder schlicht und einfach
550 ihre Literaturquellen organisieren wollen.
551
552 \subsection{Das Hauptfenster}
553
554 \tip[]{Die meisten Menüfunktionen, auf die im Folgenden hingewiesen
555 wird, haben Tastenkürzel, und viele Funktionen können über die Werkzeugleiste
556 aufgerufen werden.}
557 \label{BaseFrameHelp}Im Hauptfenster, in dem Sie mit Ihrer Datei
558 arbeiten, befindet sich unter der Menüleiste und der Werkzeugleiste
559 die Tableiste mit Tabs (Reitern) für jede Ihrer geöffneten Dateien.
560 Wenn Sie einen dieser Tabs anklicken, erscheint eine Tabelle, die
561 alle Datensätze und einige der Datenfelder auf"|listet.
562
563 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).
564
565 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.
566
567 Welche Felder (Spalten) in der Tabelle angezeigt werden sollen, können
568 Sie im \menu{Einstellungs}-Dialog auswählen. Auch die Breite der
569 Tabellenspalten kann eingestellt werden, indem man die Trennlinie
570 zwischen den Spaltenköpfen anklickt und nach links oder rechts verschiebt.
571 Im \menu{Einstellungs}-Dialog können Sie festlegen, ob die Tabelle
572 an die Bildschirmgröße angepasst werden soll oder nicht. Aktivieren
573 Sie diese Funktion, um sicherzustellen, dass Sie die gesamte Tabelle
574 sehen können. Deaktivieren Sie diese Funktion, wenn mehr Informationen
575 dargestellt werden sollen.
576
577 Die Farbanzeige kann ebenfalls im \menu{Einstellungs}-Dialog ein-
578 und ausgeschaltet werden. Die Farbanzeige illustriert, ob Ihre Daten
579 vollständig sind, indem sie die Zellen wie folgt darstellt:
580
581 \begin{itemize}
582 \item Eine \colorbox{red}{\textcolor{white}{rote}} Zelle in der linken Spalte kennzeichnet
583 einen unvollständigen Eintrag.
584 \item Eine \colorbox{yellow}{gelbe} Zelle in der linken Spalte kennzeichnet
585 einen Eintrag, der nicht alle benötigten Felder selbst enthält, der
586 aber einen Querverweis enthält.
587 \item Eine \colorbox{blue}{\textcolor{white}{blaue}} Zelle kennzeichnet ein benötigtes Feld.
588 \item Eine \colorbox{green}{grüne} Zelle kennzeichnet ein optionales Feld.
589 \item Eine farblose (weiße) Zelle kennzeichnet ein Feld, das von \bibtex{}
590 für diesen Eintragstyp nicht benutzt wird. Das Feld kann selbstverständlich
591 in \jabref bearbeitet werden.
592 \end{itemize}
593
594 \subsubsection{Einen neuen Eintrag hinzufügen}
595
596 Es gibt verschiedene Möglichkeiten, einen neuen Eintrag hinzuzufügen.
597 Im Menü \menu{BibTeX} führt ein Klick auf \menu{Neuer Eintrag} zu
598 einem Dialog, in dem Sie den Eintragstyp aus einer Liste wählen können.
599 Um diesen Dialog zu umgehen, gibt es auch eigene Menüpunkte für jeden
600 Eintragstyp und außerdem Tastenkürzel für die gängigsten Typen.
601
602 Wenn ein Eintrag hinzugefügt wird, wird standardmäßig ein Editor für
603 den Eintrag geöffnet. Sie können dieses Verhalten im \menu{Einstellungs}-Dialog
604 abstellen.
605
606 \tip[]{Wir empfehlen, sich die Tastenkürzel für die Eintragstypen
607 einzuprägen, die Sie am häufigsten benutzen, z.\,B. STRG-SHIFT-A
608 für einen Zeitschriftenaufsatz \emph{(article)}.}
609
610
611 \subsubsection{Einen Eintrag bearbeiten}
612
613 Um den \nameref{EntryEditorHelp} zur Bearbeitung
614 eines existierenden Eintrags zu öffnen, klicken Sie einfach doppelt
615 auf die entsprechende Zeile oder markieren den Eintrag
616 und drücken auf ENTER.
617
618
619 \subsubsection{Einen \bibtex{}-String in einem Feld verwenden}
620
621 In \jabref schreiben Sie den Inhalt aller Felder so, wie Sie es
622 in einem Texteditor machen würden, mit einer Ausnahme: um einen String
623 (eine Art Abkürzung) zu verwenden, umschließen Sie den Namen des Strings
624 mit je einem \#, z.\,B.
625
626 \begin{lstlisting}
627 #jan# 1997
628 \end{lstlisting}
629 was interpretiert wird als String mit dem Namen \texttt{jan} gefolgt
630 von \texttt{1997}. Vergleichen Sie dazu auch die Hinweise zum \nameref{StringEditorHelp}.
631
632
633 \subsection{Eintrags"=Editor}
634
635 \label{EntryEditorHelp}
636
637 \begin{quote}
638 \emph{Geöffnet wird der Eintrags"=Editor im Hauptfenster durch einen
639 Doppelklick auf die linke Spalte eines Eintrags oder durch
640 Drücken auf ENTER. Der Eintrags-Editor wird geschlossen, indem man
641 auf ESC drückt.}
642 \end{quote}
643 Im Eintrags-Editor können Sie alle relevanten Informationen eines
644 Eintrags festlegen. Der Editor überprüft den Eintragstyp und zeigt
645 alle benötigten und optionalen Felder für den Gebrauch mit \bibtex{}
646 an. Darüber hinaus gibt es einige Felder, die \emph{Allgemeine Felder}
647 genannt werden und für alle Eintragstypen gelten.
648
649 Sie können die Felder, die für die einzelnen Eintragstypen als benötigt
650 und optional angesehen werden, und auch die Allgemeinen Felder anpassen.
651 Näheres dazu erfahren Sie im Abschnitt \nameref{CustomEntriesHelp}.
652
653 \subsubsection{Die Panels des Eintrags-Editors}
654
655 Der Eintrags-Editor besteht in der Standardeinstellung aus fünf Panels:
656 \emph{Benötigte Felder}, \emph{Optionale Felder}, \emph{General},
657 \emph{Abstract} und \emph{\bibtex{}"=Quelltext}, wobei \emph{General}
658 und \emph{Abstract} vom Benutzer angepasst werden können (siehe dazu
659 Abschnitt~\ref{GeneralFields}). In den ersten drei Panels können
660 Sie mit TAB und SHIFT-TAB zwischen den einzelnen Feldern hin- und
661 herwechseln. Zu einem anderen Panel gelangen Sie, indem Sie auf die
662 Tabs klicken. Mit den folgenden Tastaturkürzeln können Sie ebenfalls
663 zwischen den Panels navigieren:
664
665 \begin{itemize}
666 \item STRG-TAB oder STRG-+ wechselt zum Panel rechts vom aktuellen Panel,
667 \item STRG-SHIFT-TAB oder STRG-{-} (MINUS) wechselt dementsprechend zum
668 Panel links vom aktuellen Panel.
669 \end{itemize}
670 Außerdem können Sie zum nächsten oder vorherigen Eintrag wechseln,
671 indem Sie >>STRG-SHIFT-$\downarrow$<< bzw. >>STRG-SHIFT-$\uparrow$<<
672 oder die Pfeil-Buttons in der linken Toolbar drücken.
673
674 Das Panel \emph{\bibtex{}"=Quelltext} zeigt, wie der Eintrag aussehen
675 wird, wenn die Datei im \texttt{bib}-Format gespeichert wird. Wenn
676 Sie wollen, können Sie den \bibtex{}"=Quelltext direkt bearbeiten.
677 Sobald Sie zu einem anderen Panel wechseln, STRG-S drücken oder den
678 Eintrags-Editor schließen, wird \jabref versuchen, den Inhalt des
679 Quelltext"=Panels zu analysieren. Falls dabei Probleme auftreten, werden
680 Sie benachrichtigt und erhalten die Möglichkeit, den Eintrag noch
681 einmal zu überarbeiten oder den vorherigen Inhalt wiederherzustellen. (Nähere
682 Einzelheiten dazu finden Sie im Abschnitt \nameref{subsub:feldkonsistenz}.)
683 Wenn in den \menu{Einstellungen} (unter \menu{Allgemein}) die Option
684 \menu{Quelltext standardmäßig anzeigen} gewählt wurde, wird das Quelltext"=Panel
685 beim Öffnen des Eintrags-Editors als erstes angezeigt. Wenn Sie lieber
686 den Quelltext bearbeiten als die anderen Panels zu benutzen, sollten
687 Sie diese Option wählen.
688
689 \tip{Wenn Ihre Datei Felder enthält, die \jabref nicht kennt,
690 erscheinen diese im Quelltext"=Panel.}
691
692 \tip[Und noch ein Tipp: ]{Die \emph{PDF-} und \emph{URL}-Felder unterstützen
693 Drag \& Drop. Sie können z.\,B. ein URL aus Ihrem Browser dort einfügen.}
694
695
696 \subsubsection{Überprüfung der Feldkonsistenz}
697 \label{subsub:feldkonsistenz}
698 Wenn der Inhalt eines Feldes geändert wird, überprüft \jabref,
699 ob der neue Inhalt akzeptiert werden kann. Bei Feldern, die von \bibtex{}
700 genutzt werden, wird der Inhalt zum einen auf die richtige Klammerung
701 mit geschweiften Klammern, aber auch auf die Benutzung des Zeichens
702 \texttt{\#} hin überprüft. Das >>hash<<-Symbol (im Deutschen oft
703 >>Doppelkreuz<< oder >>Raute<< genannt) darf \emph{nur} paarweise
704 benutzt werden, um damit den Namen eines \bibtex{}-Strings einzuschließen.
705 Beachten Sie, dass \jabref nicht überprüft, ob der angeführte String
706 tatsächlich vorhanden ist, da der \bibtex{}-Stil, den Sie benutzen, 
707 eine beliebige Anzahl von Strings definieren kann, die \jabref nicht
708 kennt.
709
710 Falls die Inhalte nicht akzeptabel sind, wird das Feld mit roter Farbe
711 hinterlegt, was auf einen Fehler hindeutet. In diesem Fall werden
712 die Änderungen nicht gespeichert.
713
714
715 \subsection{Integritätsprüfung}
716
717 \begin{quote}
718 \emph{Erreichbar über das Menü \menu{Extras \msep{} Datenbank durchsuchen
719 \msep{} Überprüfung der Integrität}.}
720 \end{quote}
721 Mit dieser Funktion überprüft \jabref alle Einträge auf deren Gültigkeit
722 und versucht Fehler aufzudecken. Mit dem \menu{Überprüfen}-Button
723 kann der Vorgang gestartet werden. Es wird eine Liste mit Hinweisen
724 (Info-Icon) und möglichen Fehlern (Ausrufezeichen-Icon) sowie dem
725 entsprechenden \bibtex{}-Key erstellt. Wenn Sie einen Hinweis auswählen,
726 erscheint der Inhalt des Feldes, das beanstandet wird. Sie können
727 nun den Feldinhalt verändern und die Veränderungen mit Klick auf die
728 Schaltfläche \menu{Übernehmen} speichern.
729
730
731 \subsection{\bibtex{}-Keys}
732
733 Damit man sich in einem \LaTeX{}-Dokument auf einen Literaturverweis
734 beziehen kann, braucht man einen eindeutigen \bibtex{}-Key. Eindeutig
735 heißt, dass er nur einmal vergeben sein darf. Es wird nach Groß"~
736 und Kleinschreibung unterschieden, \texttt{Yared1998} ist also nicht
737 identisch mit \texttt{yared1998}. \jabref bietet einige Möglichkeiten,
738 um auch bei größeren Datenbanken den Überblick über die \bibtex{}-Keys
739 nicht zu verlieren.
740
741 \tip{Falls Sie in einem \LaTeX{}-Dokument mehrere \bibtex{}-Dateien
742 einbinden, müssen Sie selbst darauf achten, dass in den unterschiedlichen
743 Dateien nicht mehrmals derselbe \bibtex{}-Key vergeben ist. Nutzen
744 Sie deshalb am besten die Funktion \menu{Extras} \msep{} \menu{Neue Teildatei aus AUX-Datei}.}
745 Der einfachste Weg, einen eindeutigen \bibtex{}-Key zu bekommen, ist
746 das automatische Erzeugen, das Sie mit der Tastenkombination STRG-G
747 oder mit dem Zauberstab-Button im Eintrags-Editor veranlassen können.
748 Falls Sie sich nicht im Eintrags-Editor befinden, werden mit Hilfe
749 von STRG-G oder dem Zauberstab-Button aus der Menüleiste für alle
750 Einträge der Datei \bibtex{}-Keys erzeugt. Falls dabei Keys überschrieben
751 werden, gibt \jabref eine Warnmeldung aus.
752
753 Wie die \bibtex{}-Keys aussehen, die \jabref automatisch generiert,
754 und wie Sie dieses Aussehen verändern können, erfahren Sie im Abschnitt~\ref{LabelPatterns} \nameref{LabelPatterns}.
755
756
757 \subsection{Suchfunktionen}
758
759 \label{SearchHelp}
760 \begin{quote}
761 \emph{STRG-F öffnet oder aktiviert den Suchdialog.
762 Drückt man mehrmals auf STRG-F, so werden die verschiedenen Suchmodi
763 ausgewählt. STRG-SHIFT-F öffnet oder aktiviert den Suchdialog
764 und wählt gleichzeitig die direkte Suche aus. Bei der direkten Suche
765 springt man mit STRG-F oder STRG-SHIFT-F zum nächsten Treffer.}
766 \end{quote}
767
768 \subsubsection{Direkte Suche}
769
770 Bei der direkten Suche sucht \jabref unmittelbar, wenn Sie einen
771 Buchstaben eingeben. Die Statuszeile informiert Sie über den Sucherfolg.
772 Mit STRG-F oder STRG-SHIFT-F wird zum nächsten Vorkommen des aktuellen
773 Suchbegriffs gesprungen. Falls es keine weiteren Vorkommen gibt, informiert
774 die Statuszeile darüber. Bei erneuter Wiederholung startet die Suche
775 vom Anfang der Datei. Die Suchreihenfolge richtet sich nach der aktuellen
776 Sortierung Ihrer Datei. Um die direkte Suche zu verlassen, drücken
777 Sie ESC oder klicken Sie auf \menu{Zurücksetzen}.
778
779
780 \subsubsection{Normale Suche}
781
782 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.
783
784 \subsubsection{Suchoptionen}
785
786 Der \menu{Einstellungen}-Button im Suchdialog öffnet ein Menü, in
787 dem man mehrere Optionen (de)aktivieren kann: das Beachten von Groß-
788 und Kleinschreibung, das Nutzen regulärer Ausdrücke sowie das Auswählen
789 der Suchergebnisse.
790
791 \tip{Suchen Sie mit der Option \menu{Treffer auswählen} und drücken
792 anschließend STRG-M, so haben Sie alle Treffer markiert (vgl. Abschnitt ">\nameref{MarkingHelp}"<) und können z.\,B. eine weitere Suche durchführen,
793 ohne die bisherigen Ergebnisse zu >>verlieren<<.}
794
795 \subsubsection{Feldbezeichner und logische Operatoren}
796 \label{SearchHelp_advanced}
797
798 \tip[Achtung! ]{Die folgenden Hinweise gelten nicht für die direkte Suche.}
799 Um nur einige bestimmte Felder zu durchsuchen
800 und\slash{}oder logische Operatoren im Suchbegriff zu benutzen, wird
801 eine spezielle Syntax zur Verfügung gestellt. Um beispielsweise nach
802 Einträgen mit dem Autor >>Miller<< zu suchen, geben Sie
803
804 \begin{lstlisting}
805 author = miller
806 \end{lstlisting}
807 in das Suchfeld ein. Falls der Suchbegriff Leerzeichen enthält, schließen
808 Sie ihn in Anführungszeichen ein. Benutzen Sie \emph{nie} Leerzeichen
809 in dem Feldbezeichner. Mehrere Feldbezeichner werden durch >>|<<
810 voneinander getrennt. Um beispielsweise nach Einträgen über Karl den
811 Großen zu suchen, geben Sie Folgendes ein:
812
813 \begin{lstlisting}
814 title|keywords = "Karl der Große"
815 \end{lstlisting}
816 Sie können die logischen Operatoren AND, OR und NOT sowie Klammern
817 verwenden:
818
819 \begin{lstlisting}
820 (author = miller OR title|keywords = "Karl der Große") AND NOT author = brown
821 \end{lstlisting}
822 \ldots{} sucht beispielsweise nach Einträgen, in denen entweder der
823 Autor >>Miller<< heißt oder im \emph{title}- oder \emph{keywords}-Feld
824 der Begriff >>Karl der Große<< steht; gleichzeitig werden die Einträge
825 mit dem Autor >>Brown<< nicht angezeigt.
826
827 Das \texttt{=}-Zeichen ist eigentlich eine Abkürzung für >>enthält<<
828 \emph{(contains)}. Wenn man nach genauen Treffern suchen möchte, muss
829 man \texttt{==} oder \texttt{matches} (>>übereinstimmen<<) eingeben.
830 \texttt{!=} sucht nach Einträgen, bei denen der Suchbegriff \emph{nicht}
831 enthalten ist. Um nach Einträgen eines bestimmten Typs zu suchen,
832 gibt es ein Pseudofeld namens \emph{entrytype}:
833
834 \begin{lstlisting}
835 entrytype = thesis
836 \end{lstlisting}
837 \ldots{} findet Einträge, deren Typ (wie in der Spalte \emph{Entrytype}
838 dargestellt) das Wort >>thesis<< enthält (z.\,B. >>phdthesis<<
839 und >>mastersthesis<<). Ebenso erlaubt das Pseudofeld \emph{bibtexkey}
840 die Suche nach \bibtex{}-Keys, z.\,B.:
841
842 \begin{lstlisting}
843 bibtexkey = miller2005
844 \end{lstlisting}
845
846 \subsection{Gruppen}
847
848 Mit Gruppen können Sie Ihre \bibtex{}-Datei in einer Baumstruktur
849 anordnen, vergleichbar mit einer Dateistruktur in Ordnern und Unterordnern.
850 Die beiden Hauptunterschiede sind:
851
852 \begin{enumerate}
853 \item Während eine Datei auf einer Festplatte immer in genau einem Ordner
854 abgelegt ist, kann ein Literatureintrag in \jabref mehreren Gruppen
855 angehören.
856 \item Gruppen benutzen bestimmte Kriterien, um ihren Inhalt dynamisch zu
857 bestimmen. Neue Einträge, die den Kriterien einer Gruppe entsprechen,
858 gehören automatisch zu dieser Gruppe. Diese Funktionalität gibt es
859 nicht in üblichen Dateisystemen, wohl aber in einigen E-Mail-Programmen
860 (z.\,B. Thunderbird und Opera).
861 \end{enumerate}
862 Wenn Sie eine Gruppe auswählen, werden die Einträge dieser Gruppe
863 angezeigt. Wenn Sie mehrere Gruppen auswählen, werden entweder die
864 Einträge angezeigt, die in einer der Gruppen sind (Vereinigung), oder
865 solche, die in allen Gruppen vorhanden sind (Schnittmenge)~-- das
866 hängt von Ihren Einstellungen ab. All dies wird im Folgenden detailliert
867 erläutert.
868
869 Gruppendefinitionen sind dateispezifisch; sie werden als \texttt{@COMMENT}-Block
870 in der \texttt{bib}-Datei gespeichert und von allen Benutzern gemeinsam
871 benutzt. (Künftige Versionen von \jabref werden möglicherweise
872 benutzerabhängige Gruppen unterstützen.)
873
874
875 \subsubsection{Die Gruppenansicht}
876 \begin{quote}
877 \emph{Die Gruppenansicht wird im linken Bereich des Bildschirms angezeigt.
878 Sie kann mit der Tastenkombination STRG-SHIFT-G oder dem Gruppen-Button
879 in der Toolbar ein- und ausgeblendet werden. Die Gruppenansicht verfügt
880 über mehrere Schaltflächen, aber die meisten Funktionen werden über
881 das Kontextmenü angesteuert (also mit der rechten Maustaste). Drag\,\&\,Drop
882 wird ebenfalls unterstützt.}
883 \end{quote}
884
885
886 \subsubsection{Einige kurze Beispiele}
887
888 Sie möchten vielleicht~\ldots{}
889
890 \begin{itemize}
891 \item [\ldots]\textbf{einfach nur eine Gruppe anlegen und ihr einige Einträge
892 zuordnen}
893
894
895 Vergewissern Sie sich, dass die Gruppenansicht eingeschaltet ist.
896 Drücken Sie auf den Button \menu{Neue Gruppe}, geben einen Namen
897 für die Gruppe ein und drücken \menu{OK}. Sie können alle Einstellungen
898 auf ihren Standardwerten belassen. Jetzt wählen Sie die Einträge aus,
899 die der Gruppe zugeordnet werden sollen, und ziehen diese mit der
900 Maus auf die Gruppe oder wählen \menu{Zu Gruppe hinzufügen} aus dem
901 Kontextmenü. Jetzt können Sie die Gruppe anklicken, um sich ihren
902 Inhalt anzeigen zu lassen (das sollten die Einträge sein, die Sie
903 gerade hinzugefügt haben).
904
905 \item [\ldots]\textbf{das Feld} \textbf{\emph{keywords}} \textbf{benutzen,
906 um die Einträge zu gruppieren}
907
908
909 Stellen Sie sicher, dass die Gruppenansicht aktiviert ist. Drücken
910 Sie auf den Button \menu{Neue Gruppe}, geben einen Namen für die
911 Gruppe ein und wählen die Option \menu{Dynamisches Gruppieren der Einträge anhand eines Stichworts in einem Feld}.
912 Geben Sie das Stichwort, nach dem gesucht werden soll, ein und drücken
913 \menu{OK}. Jetzt können Sie die Gruppe anklicken, um sich ihren Inhalt
914 anzeigen zu lassen (das sollten alle Einträge sein, deren \emph{keywords}-Feld
915 das Stichwort enthält, das Sie angegeben haben).
916
917 \item [\ldots]\textbf{einen frei wählbaren Suchausdruck verwenden, um eine
918 Gruppe zu definieren}
919
920
921 Stellen Sie sicher, dass die Gruppenansicht aktiviert ist. Drücken
922 Sie auf den Button \menu{Neue Gruppe}, geben einen Namen für die
923 Gruppe ein und wählen die Option \menu{Dynamisches Gruppieren der Einträge anhand eines beliebigen Suchausdrucks}.
924 Geben Sie \texttt{author=smith} als Suchausdruck ein (ersetzen Sie
925 \texttt{smith} mit einem Namen, der wirklich in Ihrer Datei vorkommt)
926 und klicken \menu{OK}. Jetzt können Sie die Gruppe anklicken, um
927 sich ihren Inhalt anzeigen zu lassen (das sollten alle Einträge sein,
928 deren \emph{author}-Feld den Namen beinhaltet, den Sie angegeben haben).
929
930 \item [\ldots]\textbf{mehrere Gruppen kombinieren }
931
932
933 Erstellen sie zwei unterschiedliche Gruppen (z.\,B. so wie oben beschrieben).
934 Klicken Sie auf den Button \menu{Einstellungen} in der Gruppenansicht
935 und wählen \menu{Vereinigung}. Jetzt wählen Sie beide Gruppen aus
936 (dazu klicken Sie auf eine Gruppe und anschließend bei gedrückter
937 STRG-Taste auf die andere Gruppe). Sie sollten jetzt alle Einträge
938 sehen, die in einer der beiden Gruppen aufgeführt sind. Klicken Sie
939 noch einmal auf \menu{Einstellungen} und wählen \menu{Schnittmenge}
940 aus. Nun sollten Sie nur die Einträge sehen, die in beiden Gruppen
941 enthalten sind (das können auch keine sein, oder aber genau dieselben
942 Einträge wie zuvor, sofern beide Gruppen dieselben Einträge enthalten).
943
944 \item [\ldots]\textbf{sehen, welche Gruppen sich überschneiden}
945
946
947 Mit \jabref können Sie ganz einfach herausfinden, welche Gruppen
948 sich mit den aktuell ausgewählten Gruppen überschneiden (d.\,h. welche
949 Gruppen zumindest einen Eintrag enthalten, der auch in der aktuell
950 ausgewählten Gruppe ist). Klicken Sie auf \menu{Einstellungen} und
951 aktivieren die Option \menu{Sich überschneidende Gruppen markieren}.
952 Wählen Sie dann eine Gruppe, die sich mit anderen überschneidet. Diese
953 anderen Gruppen sollten nun markiert sein.
954
955 \end{itemize}
956
957 \subsubsection{Arten von Gruppen}
958
959 In \jabref gibt es vier verschiedene Arten von Gruppen:
960
961 \begin{enumerate}
962 \item Die Gruppe \emph{Alle Einträge}, die~-- wie der Name vermuten lässt~--
963 alle Einträge beinhaltet, ist immer vorhanden und kann weder verändert
964 noch gelöscht werden.
965 \item \emph{Statische Gruppen} verhalten sich wie Ordner auf einer Festplatte
966 und beinhalten nur die Einträge, die Sie ihnen explizit zuweisen.
967 \item \emph{Dynamische Gruppen basierend auf einem Stichwort} beinhalten
968 Einträge, die in einem bestimmten \bibtex{}-Feld (z.\,B. \emph{keywords})
969 ein bestimmtes Stichwort (z.\,B. \emph{elektrisch}) aufweisen. Diese
970 Methode benötigt kein manuelles Zuweisen der Einträge, sondern nutzt
971 die bereits in der Datei vorhandenen Informationen. Wenn alle Einträge
972 in Ihrer Datenbank passende Stichwörter haben, könnte diese Art von
973 Gruppe die beste Wahl für Sie sein.
974 \item \emph{Dynamische Gruppen basierend auf einer freien Suche} beinhalten
975 Einträge, die mit einem bestimmten Suchausdruck übereinstimmen. Dabei
976 wird dieselbe Syntax verwendet wie beim Suchen (siehe Abschnitt~\ref{SearchHelp}).
977 Diese Syntax (die auf S.\,\pageref{SearchHelp_advanced} genauer
978 beschrieben wird) unterstützt logische Operatoren (AND, OR, NOT) und
979 erlaubt es, in einem oder mehreren \bibtex{}-Feldern zu suchen. Dadurch
980 ist eine flexiblere Definition von Gruppen möglich als mit einer Stichwortsuche
981 (z.\,B. \texttt{author=smith AND title=elektrisch}).
982 \end{enumerate}
983 Jede Gruppe, die Sie erstellen, ist von einer der drei letztgenannten
984 Arten. Der Dialog \menu{Gruppe bearbeiten}, der mit einem Doppelklick
985 auf eine Gruppe aufgerufen wird, zeigt eine kurze Beschreibung der
986 ausgewählten Gruppe.
987
988
989 \subsubsection{Gruppenstrukturen, Erstellen und Löschen von Gruppen}
990
991 Die Gruppen sind~-- vergleichbar mit Datei-Ordnern~-- in einer Baumansicht
992 strukturiert, in der die Gruppe \emph{Alle Einträge} das Stammelement
993 ist. Mit einem Rechtsklick auf eine Gruppe können Sie dem Baum eine
994 neue Gruppe hinzufügen, entweder auf derselben Ebene wie die ausgewählte
995 Gruppe oder als ihre Untergruppe. Der Button \menu{Neue Gruppe} erzeugt
996 eine neue Untergruppe der Gruppe \emph{Alle Einträge}, egal ob Sie
997 gerade Gruppen ausgewählt haben oder nicht. Im Kontextmenü können
998 Sie auch Gruppen und\slash{}oder Untergruppen löschen, Untergruppen
999 alphabetisch sortieren oder Gruppen an eine andere Stelle des Baums
1000 verschieben. Letzteres können Sie auch mit Drag\,\&\,Drop machen,
1001 allerdings mit der Einschränkung, dass bei Drag\,\&\,Drop die Reihenfolge
1002 der Untergruppen einer Gruppe nicht verändert werden kann.
1003
1004 Die Funktionen \menu{Rückgängig} und \menu{Wiederholen} werden für
1005 alle Bearbeitungsschritte unterstützt.
1006
1007
1008 \paragraph{Statische Gruppen}
1009
1010 Statische Gruppen werden nur durch manuelles Zuweisen von Einträgen
1011 >>gefüttert<<. Nachdem Sie eine statische Gruppe erstellt haben,
1012 wählen Sie die Einträge aus, die Sie ihr zuweisen wollen, und nutzen
1013 entweder Drag\,\&\,Drop oder das Kontextmenü in der Tabelle, um
1014 die Zuweisung durchzuführen. Um Einträge aus einer Gruppe zu entfernen,
1015 wählen Sie sie aus und benutzen das Kontextmenü in der Tabelle. Es
1016 können keine weiteren Optionen angegeben werden.
1017
1018 Diese Methode des Gruppierens setzt voraus, dass alle Einträge einen
1019 eindeutigen \bibtex{}-Key haben. Im Falle von fehlenden oder doppelten
1020 \bibtex{}-Keys kann das Zuweisen der betreffenden Einträge in künftigen
1021 Sitzungen nicht korrekt wiederhergestellt werden.
1022
1023
1024 \paragraph{Dynamische Gruppen}
1025
1026 Der Inhalt einer dynamischen Gruppe wird von einer logischen Bedingung
1027 bestimmt. Nur Einträge, die dieser Bedingung entsprechen, gehören
1028 zu dieser Gruppe. Diese Methode nutzt die bereits in der Datei vorhandenen
1029 Informationen und wird aktualisiert, sobald Sie Veränderungen in der
1030 Datei vornehmen. Es gibt zwei mögliche Arten von Bedingungen:
1031
1032 \begin{enumerate}
1033 \item Ein Feld nach einem Stichwort durchsuchen
1034
1035
1036 Diese Methode gruppiert Einträge, bei denen ein bestimmtes \bibtex{}-Feld
1037 (z.\,B. \emph{keywords}) einen bestimmten Suchausdruck (z.\,B. \emph{elektrisch})
1038 enthält. Damit dies funktioniert, muss das Feld, nach dem sortiert
1039 wird, natürlich in jedem Eintrag vorhanden und sein Inhalt fehlerfrei
1040 sein. Das obige Beispiel würde alle Einträge zu einer Gruppe zusammenfassen,
1041 die sich auf etwas Elektrisches beziehen. Benutzt man das Feld \emph{author},
1042 kann man sich Einträge eines bestimmten Autors gruppieren lassen,
1043 usw. Die Suche ist als reine Textsuche oder mit einem regulären Ausdruck
1044 möglich. Im ersten Fall erlaubt \jabref das manuelle Zuweisen zu
1045 und Entfernen aus einer Gruppe; dazu fügt \jabref den Suchausdruck
1046 dem entsprechenden Feld zu bzw. entfernt ihn daraus. Das macht nur
1047 für das Feld \emph{keywords} oder für selbstdefinierte Felder Sinn,
1048 aber offensichtlich nicht für Felder wie \emph{author} oder \emph{year}.
1049
1050 \item Einen freien Suchausdruck verwenden
1051
1052
1053 Diese Vorgehensweise ist ganz ähnlich wie die eben beschriebene, aber
1054 statt nur ein Feld nach einem Suchausdruck zu durchsuchen, kann hierbei
1055 die Syntax der Suche (siehe S.\,\pageref{SearchHelp_advanced}) angewendet
1056 werden, die logische Operatoren (AND, OR, NOT) und die Suche in mehreren
1057 Feldern gleichzeitig unterstützt. So fasst z.\,B. die Suchanfrage
1058 \texttt{keywords=Regression AND NOT keywords=linear} Einträge, die
1059 sich mit nicht-linearer Regression beschäftigen, zu einer Gruppe zusammen.
1060
1061 \end{enumerate}
1062 In der Gruppenansicht werden dynamische Gruppen standardmäßig \emph{kursiv}
1063 dargestellt. Dies kann unter \menu{Optionen} \msep{} \menu{Einstellungen}
1064 \msep{} \menu{Gruppen} abgestellt werden.
1065
1066
1067 \paragraph{Hierarchischer Kontext}
1068
1069 Standardmäßig ist eine Gruppe \emph{unabhängig} von ihrer Position
1070 im Gruppenbaum. Ist eine Gruppe ausgewählt, wird nur der Inhalt dieser
1071 Gruppe angezeigt. Es ist jedoch~-- besonders beim Verwenden dynamischer
1072 Gruppen~-- oft nützlich, eine Untergruppe zu erstellen, die \emph{ihre
1073 Obergruppe einbezieht}. Wenn diese Untergruppe ausgewählt wird, werden alle Einträge dieser
1074 Gruppe und ihrer Obergruppe angezeigt. Erstellen Sie z.\,B. eine
1075 Obergrupe, die Einträge mit dem Stichwort \emph{Verteilung} enthält,
1076 sowie eine einbeziehende Untergruppe mit Einträgen, die das Stichwort
1077 \emph{Gauß} enthalten. Wenn Sie nun die Untergruppe auswählen, werden
1078 alle Einträge angezeigt, die beiden Bedingungen entsprechen, also
1079 alle, die mit Gauß'scher Verteilung zu tun haben. Indem Sie nun eine
1080 weitere Untergruppe für \emph{Laplace} anlegen, die dieselbe Obergruppe
1081 einbezieht, können Sie die Gruppierung einfach erweitern. Im Gruppenbaum
1082 haben solche Gruppen, die ihre Obergruppen einbeziehen, ein spezielles
1083 Icon. (Dieses Verhalten kann in den Einstellungen abgestellt werden.)
1084
1085 Das logische Gegenstück zu einer solchen einbeziehenden Untergruppe
1086 ist eine Gruppe, die \emph{ihre Untergruppen berücksichtigt}.
1087 Wird sie ausgewählt, werden nicht nur die Einträge dieser Gruppe,
1088 sondern auch diejenigen aller Untergruppen angezeigt. Im Gruppenbaum
1089 hat auch diese Art von Gruppen ein spezielles Icon. (Dieses Verhalten
1090 kann in den Einstellungen abgestellt werden.)
1091
1092
1093 \subsubsection{Einträge einer Gruppe anzeigen, mehrere Gruppen kombinieren}
1094
1095 Wenn Sie eine Gruppe auswählen, werden die Einträge, die dieser Gruppe
1096 zugeordnet sind, hervorgehoben und~-- je nach Einstellung (die mit
1097 einem Klick auf den \menu{Einstellungen}-Button vorgenommen werden
1098 kann)~-- an den Anfang der Tabelle verschoben und\slash{}oder ausgewählt.
1099 Diese Optionen entsprechen denen für die normale Suche (siehe Abschnitt~\ref{SearchHelp}).
1100
1101 Wenn Sie meherere Gruppen auswählen (indem Sie die STRG-Taste gedrückt
1102 halten und mehrere Gruppen anklicken), wird~-- je nach Einstellung~--
1103 entweder die Vereinigung oder die Schnittmenge ihrer Inhalte angezeigt.
1104 Damit können mehrere Bedingungen schnell miteinander kombiniert werden.
1105 Ein Beispiel: Wenn Sie eine statische Gruppe namens \emph{Sehr wichtig}
1106 haben, in der alle sehr wichtigen Einträge sind, können Sie sich die
1107 sehr wichtigen Einträge jeder anderen Gruppe anzeigen lassen, indem
1108 Sie beide Gruppen auswählen (dazu muss \menu{Schnittmenge} in den
1109 Einstellungen aktiviert sein).
1110
1111
1112 \subsubsection{Gruppen und Suche}
1113
1114 Wenn der Inhalt einer oder mehrerer Gruppen angezeigt wird, können
1115 Sie eine Suche innerhalb dieser Einträge durchführen. Benutzen Sie
1116 dazu die normalen Suchfunktionen (siehe Abschnitt~\ref{SearchHelp}).
1117
1118
1119 \subsubsection{Sich überschneidende Gruppen markieren}
1120
1121 Der \menu{Einstellungen}-Button bietet eine Option zum Markieren
1122 von sich überschneidenden Gruppen. Wenn diese Option aktiviert ist
1123 und Sie eine (oder mehrere) Gruppe(n) auswählen, werden alle Gruppen
1124 markiert, die mindestens einen Eintrag enthalten, der auch der ausgewählten
1125 Gruppe zugeordnet ist. Damit können Sie schnell Überschneidungen zwischen
1126 den Einträgen verschiedener Gruppen erkennen. Sie könnten beispielsweise
1127 eine Gruppe mit dem Namen \emph{lesen} erstellen, die alle Einträge
1128 enthält, die sie lesen wollen. Sobald Sie nun eine Gruppe auswählen,
1129 wird die Gruppe \emph{lesen} markiert, sofern die ausgewählte Gruppe
1130 Einträge enthält, die Sie noch lesen wollten.
1131
1132
1133 \subsubsection{Erweiterte Funktionen}
1134
1135 Wenn Sie sich mit dem oben beschriebenen Gruppenkonzept vertraut gemacht
1136 haben, könnten die folgenden erweiterten Funktionen nützlich sein.
1137
1138
1139 \paragraph{Dynamische Gruppen automatisch erstellen}
1140
1141 Mit einem Klick auf den Button \menu{Automatisch Gruppen für die Datei anlegen}
1142 können Sie ganz schnell passende Gruppen für Ihre Datei erzeugen.
1143 Diese Funktion sammelt alle Wörter eines bestimmten Felds Ihrer Wahl
1144 und erstellt eine Gruppe für jedes Wort. Das ist zum Beispiel nützlich,
1145 wenn Ihre Datei geeignete Stichworte für alle Einträge enthält. Mit
1146 dem automatischen Erstellen von Gruppen basierend auf dem Feld \emph{keywords}
1147 können Sie also ohne großen Aufwand ein Grundgerüst von Gruppen anlegen.
1148
1149 Sie können auch Zeichen angeben, die ignoriert werden sollen, z.\,B.
1150 Kommas, die zwischen einzelnen Stichworten stehen. Diese werden als
1151 Worttrenner behandelt und nicht als Teile des Wortes selbst. Dieser
1152 Schritt ist wichtig, damit kombinierte Stichworte wie etwa \emph{Gauß'sche
1153 Verteilung} als semantische Einheit interpretiert werden können. (Sie
1154 können diese Option allerdings nicht verwenden, um ganze Wörter zu
1155 ignorieren. Sie müssen stattdessen die Gruppen, die Sie nicht wollen,
1156 nach dem automatischen Erstellen von Hand löschen.)
1157
1158
1159 \paragraph{Ansicht aktualisieren}
1160
1161 Der \menu{Aktualisieren}-Button in der Gruppenansicht aktualisiert
1162 die Tabelle in Bezug auf die aktuell ausgewählten Gruppen. Normalerweise
1163 erfolgt dies automatisch, aber in seltenen Fällen (z.\,B. nach einem
1164 Rückgängig- oder Wiederholen"=Vorgang, der mit Gruppen zusammenhängt)
1165 ist ein händisches Aktualisieren nötig.
1166
1167
1168 \paragraph{Einbeziehende Unter- und Obergruppen mischen}
1169
1170 Ist eine einbeziehende Gruppe die Untergruppe von einer Gruppe,
1171 die ihre Untergruppen berücksichtigt~-- hat sie also sozusagen Geschwister~--, 
1172 dann werden diese Geschwister ignoriert,
1173 sobald die einbeziehende Gruppe ausgewählt wird.
1174
1175
1176 \subsection{Markieren von Einträgen}
1177 \label{MarkingHelp}
1178
1179 \begin{quote}
1180 \emph{Mit der Tastenkombination STRG-M können
1181 Sie Einträge markieren und diese Markierung mit STRG-SHIFT-M wieder
1182 aufheben. Diese Aktionen sind auch im Menü \menu{Bearbeiten} zu finden.}
1183 \end{quote}
1184 Das Markieren ist nicht dasselbe wie das Auswählen eines Eintrags.
1185 Markierte Einträge verhalten sich in zweierlei Hinsicht anders als
1186 die restlichen Einträge:
1187
1188 \begin{enumerate}
1189 \item Markierte Einträge werden immer mit einem gelben Hintergrund in der
1190 Tabelle angezeigt.
1191 \item Markierte Einträge werden an den Anfang der Eintragsliste verschoben,
1192 falls Ihre Tabelle nicht nach Gruppen oder aufgrund einer Suche sortiert
1193 ist.
1194 \end{enumerate}
1195 Wenn Sie Ihre Datei speichern, werden die Markierungen beibehalten.
1196 Das Markieren von Einträgen ist z.\,B. nützlich, wenn Sie verschiedene
1197 Suchvorgänge durchführen wollen, ohne das erste Suchergebnis zu verlieren,
1198 oder wenn Sie sich merken wollen, welche Artikel oder Bücher Sie noch
1199 einmal genauer ansehen müssen.
1200
1201
1202 \subsection{String"=Editor}
1203 \label{StringEditorHelp}
1204
1205 \begin{quote}
1206 \emph{Zugriff über das Menü \menu{BibTeX}} \msep{} \emph{\menu{Strings bearbeiten}
1207 oder durch Klick auf die Schaltfläche \menu{Strings bearbeiten}.}
1208 \end{quote}
1209 \emph{Strings} sind das \bibtex{}-Äquivalent zu Konstanten in einer
1210 Programmiersprache. Jeder String wird durch einen eindeutigen \emph{Namen}
1211 und einen \emph{Inhalt} festgelegt. Der Name kann an anderer Stelle
1212 in der Datei benutzt werden, um den Inhalt wiederzugeben.
1213
1214 Ein Beispiel: Wenn viele Einträge aus einer Zeitschrift stammen, deren
1215 Abkürzung schwer zu behalten ist, wie etwa >>J. Theor. Biol.<< (Journal
1216 of Theroretical Biology), könnte ein String mit dem Namen >>JTB<<
1217 angelegt werden, um den Namen der Zeitschrift zu repräsentieren. Statt
1218 nun in jedem Eintrag den exakten Namen der Zeitschrift einzutragen,
1219 genügt die Zeichenfolge \texttt{\#JTB\#} im Feld \emph{journal}, und
1220 es ist sichergestellt, dass der Name jedesmal in identischer Schreibweise
1221 ausgegeben wird.
1222
1223 Der Verweis auf einen String kann an jeder Stelle eines Feldes erscheinen, 
1224 wobei der Name des Strings immer von einem Paar \texttt{\#}-Zeichen
1225 eingeschlossen werden muss. Diese Syntax gilt nur für \jabref und
1226 weicht ein wenig von der \bibtex{}-Syntax ab, die erzeugt wird, wenn
1227 Sie Ihre Datei speichern. Strings können für alle Standard-\bibtex{}-Felder verwendet werden.
1228 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.
1229
1230 In derselben Weise kann man auch im Inhalt eines Strings auf einen
1231 anderen String verweisen, vorausgesetzt, dass der String, auf den
1232 verwiesen wird, bereits \emph{vorher} definiert ist.
1233
1234 Während die Reihenfolge der Strings in Ihrer \bibtex{}-Datei in einigen
1235 Fällen wichtig ist, brauchen Sie sich bei der Benutzung von \jabref
1236 darüber keine Gedanken zu machen. Die Strings werden in alphabetischer
1237 Reihenfolge im String-Editor aufgelistet und in derselben Reihenfolge
1238 gespeichert, außer wenn eine andere Reihenfolge von \bibtex{} verlangt
1239 wird.
1240
1241 \subsection{Abkürzung von Zeitschriftentiteln}
1242 \label{JournalAbbreviations}
1243 \begin{quote}
1244 \emph{Diese Funktion kann unter \menu{Optionen \msep{} Abkürzungen der Zeitschriften verwalten} eingestellt werden.}
1245 \end{quote}
1246 \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.
1247
1248 \subsubsection{Benutzungshinweise}
1249
1250 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:
1251 \begin{itemize}
1252     \item Kompletter Name, z.\,B. ">Aquacultural Engineering"<
1253     \item \caps{ISO}-Abkürzung, z.\,B. ">Aquacult. Eng."<
1254     \item \caps{MEDLINE}-Abkürzung, z.\,B. ">Aquacult Eng"<
1255 \end{itemize}
1256 Falls der Zeitschriftentitel sich nicht in Ihren Zeitschriftenlisten findet, wird das Feld nicht verändert.
1257
1258 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.
1259 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.
1260
1261 \subsubsection{Zeitschriftenlisten verwalten}
1262
1263 Sie können mehrere Zeitschriftenlisten als externe Textdateien benutzen, die mit \jabref verlinkt sind. Die primäre Liste kann in \jabref selbst verwaltet werden.
1264
1265 \paragraph{Ihre persönliche Zeitschriften-Abkürzungsliste}
1266
1267 Ihre persönliche Liste verwalten Sie im oberen Teil des Dialogs \menu{Abkürzung der Zeitschriftentitel}.
1268 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.
1269
1270 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.
1271
1272 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.
1273
1274 \paragraph{Externe Zeitschriftenlisten}
1275
1276 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.
1277
1278 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.
1279     \begin{itemize}
1280     \item Mit dem \menu{Durchsuchen}-Knopf können Sie eine auf Ihrem Computer bestehende Datei auswählen.
1281     \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.
1282     Der URL ist standardmäßig die Adresse einer Zeitschriftenliste auf der \jabref-Homepage. Diese Liste ist unvollständig, wird in Zukunft aber ausgebaut.
1283     \end{itemize}
1284 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.
1285
1286 \subsection{Wortauswahl verwalten}
1287
1288 \label{ContentSelectorHelp}Diese Funktion ermöglicht es, eine Auswahl
1289 von oft benutzten Wörtern oder Phrasen zu speichern. In der Standardeinstellung
1290 ist sie für die Felder \emph{journal}, \emph{keywords} und \emph{publisher}
1291 aktiviert, aber Sie können die Funktion auch in anderen Feldern verwenden,
1292 indem Sie diese Felder im oberen Teil des Dialogs \menu{Extras} \msep{}
1293 \menu{Wortauswahl verwalten} hinzufügen.
1294
1295 Die Wortauswahl gilt nur für die jeweilige Datei und wird daher zusammen
1296 mit den Literaturangaben in der \bibtex{}-Datei gespeichert. Jedes
1297 Feld mit Wortauswahl erhält im Eintrags-Editor einen gesonderten Bereich
1298 mit einer Auswahlliste und der Schaltfläche \menu{Verwalten}. Wenn
1299 Sie die Auswahlliste mit der Maus anklicken, erscheint eine Liste
1300 der für dieses Feld verfügbaren Wörter. Sobald Sie auf das gewünschte
1301 Wort klicken, wird es in das entsprechende Feld geschrieben.
1302
1303 Um ein neues Wort hinzuzufügen, schreiben Sie es einfach in das Auswahlfeld
1304 (über der Schaltfläche \menu{Verwalten}) und drücken ENTER. Im Dialog
1305 \menu{Verwalten} können Sie hinzugefügte Wörter auch wieder löschen.
1306
1307
1308 \subsection{Import}
1309
1310 \subsubsection{Import-Kontrollfenster}
1311
1312 \label{ImportInspectionDialog}Beim Importieren neuer Einträge aus
1313 einem unterstützten Format oder beim Herunterladen von Einträgen aus
1314 dem Internet werden diese Einträge zunächst im Import-Kontrollfenster
1315 gezeigt. Zu diesem Zeitpunkt wurden noch keine Einträge zu einer geöffneten
1316 Datei hinzugefügt.
1317
1318 Im Kontrollfenster können Sie Einträge entfernen, die nicht übernommen
1319 werden sollen, und einige einfache Arbeiten durchführen wie etwa das
1320 Generieren von \bibtex{}-Keys für die Einträge oder das Zuordnen von
1321 Einträgen zu Gruppen. Wenn Sie in eine bestehende Datei importieren,
1322 ist es oftmals leichter, diese Arbeiten durchzuführen, bevor die neuen
1323 Einträge zwischen die bereits bestehenden sortiert wurden.
1324
1325 \subsubsection[EndNote -> \jabref]{EndNote $\to$~\jabref}\label{subsubsec:endnote-jabref}
1326
1327 EndNote hat einen Export-Stil \bibtex{}, der allerdings nicht alle
1328 Eintragstypen und Felder von \bibtex{} und auch nicht die zusätzlich
1329 von \jabref genutzten Allgemeinen Felder (\emph{pdf}, \emph{owner},
1330 \emph{key} usw.) unterstützt. Falls Sie diese Felder nutzen wollen,
1331 verwenden Sie die EndNote Extras (\menu{Extras \msep{} EndNote Filter-Set entpacken}), extrahieren die Zip-Datei,
1332 die dabei erstellt wird und folgen den Anweisungen in der Datei \texttt{readme.txt}.
1333
1334 \subsection{Export}
1335 \subsubsection[\jabref -> EndNote]{\jabref $\to$~EndNote}
1336 \label{EndnoteFilters}
1337
1338 \begin{quote}
1339 \emph{\jabref kann Dateien so exportieren,
1340 dass EndNote sie lesen kann. Um diese Funktion zu nutzen, wählen Sie
1341 \menu{Datei \msep{} Exportieren}, dann bei \emph{Dateityp} \menu{Endnote} und
1342 geben den Namen der Export"=Datei an.}
1343 \end{quote}
1344 Der Standard"=Importfilter von EndNote kann nicht richtig mit mehreren
1345 Autoren oder Editoren umgehen. Es gibt zwei Möglichkeiten, um diese
1346 Schwierigkeit zu umgehen:
1347
1348 \begin{enumerate}
1349 \item Benutzen Sie den eingebauten Filter und bessern Sie die Datei später
1350 aus.
1351
1352 Um die Datei in EndNote zu öffnen, erstellen Sie eine neue Datei oder
1353 öffnen eine bestehende Datei in EndNote. Dann wählen Sie \menu{Datei}
1354 \msep{} \menu{Importieren}, klicken mit der Maus auf \menu{Datei wählen},
1355 wählen die aus \jabref exportierte Datei aus und drücken auf \menu{Auswählen}.
1356 Anschließend drücken Sie auf \menu{Import Optionen} und wählen \menu{EndNote Import}.
1357 Mit einem Klick auf \menu{Importieren} starten Sie den Importvorgang.
1358 Anschließend gehen Sie zum Menüpunkt \menu{Bearbeiten} \msep{} \menu{Text ändern}
1359 und ändern \emph{Any Field} in \emph{Author}. Geben Sie \lstinline{_and_}
1360 in das Suchfeld ein (die Unterstriche stehen für Leerzeichen) sowie ein RETURN-Zeichen
1361 in das Feld \emph{Ändern} (Option-Return unter Mac OS X, STRG-Return unter
1362 Windows XP). Dann klicken Sie auf \menu{Ändern}. Wiederholen Sie
1363 das Ganze für das Feld \emph{Secondary Author} (Zweiter Autor).
1364
1365 \item Installieren Sie den \emph{EndNote Import from JabRef Filter}.
1366
1367 Folgen Sie den Anweisungen im Abschnitt \nameref{EndNote_erweitert}. Um die Datei in
1368 EndNote zu öffnen, erstellen Sie eine neue Datei oder öffnen eine
1369 bestehende Datei in EndNote. Dann wählen Sie \menu{Datei} \msep{}
1370 \menu{Importieren}, klicken auf \menu{Datei wählen}, wählen die
1371 exportierte Datei aus und drücken auf \menu{Auswählen}. Anschließend
1372 drücken Sie auf \menu{Import Optionen} und wählen \menu{EndNote Import from JabRef}.
1373 (Falls dieser Eintrag nicht erscheint, wählen Sie \menu{Weitere Filter}.
1374 Wenn er dann immer noch nicht erscheint, wurde der Filter nicht korrekt
1375 installiert.) Klicken Sie schließlich auf \menu{Importieren}, um
1376 den Importvorgang zu starten.
1377
1378 \end{enumerate}
1379 Der EndNote Exportfilter ordnet \bibtex{}-Eintragstypen folgenden
1380 EndNote-Re\-fe\-renz\-ty\-pen zu:
1381
1382 \medskip{}
1383 \begin{center}\begin{tabular}{ll}
1384 \textbf{\bibtex{}-Eintragstyp}&
1385 \textbf{Endnote-Referenztyp}\tabularnewline
1386 misc, other&
1387 Generic\tabularnewline
1388 unpublished&
1389 Manuscript\tabularnewline
1390 manual&
1391 Computer Program\tabularnewline
1392 article&
1393 Journal Article\tabularnewline
1394 book&
1395 Book\tabularnewline
1396 booklet&
1397 Personal Communication\tabularnewline
1398 inbook, incollection&
1399 Book Section\tabularnewline
1400 inproceedings&
1401 Conference Proceedings\tabularnewline
1402 techreport&
1403 Report\tabularnewline
1404 mastersthesis, phdthesis~&
1405 Thesis\tabularnewline
1406 \end{tabular} \end{center}
1407 \medskip{}
1408
1409 \noindent In der Standardeinstellung geht der Exportfilter davon aus,
1410 dass Einträge in den Feldern \emph{author} oder \emph{editor}, die
1411 geklammert sind, mehrere Autoren enthalten und ersetzt die Klammern
1412 durch ein angehängtes Komma. Dadurch werden Einträge, die \LaTeX{}-Befehle
1413 mit Klammern enthalten, als Eintrag mit mehreren Autoren gewertet
1414 und demzufolge unpassend formatiert.
1415
1416 \subsubsection{Erweiterte Benutzung: EndNote Extras}
1417
1418 \label{EndNote_erweitert}Einige Felder, die von \bibtex{} genutzt
1419 werden, gehören nicht zu EndNotes vorgegebenen Referenztypen. Während
1420 der Import in \jabref und der Export nach \jabref ohne ein Ändern
1421 der Referenztypen funktioniert, werden die Feldnamen in EndNote nicht
1422 korrekt dargestellt (z.\,B. wird das PDF-Feld \emph{Custom 1} heißen
1423 statt \emph{pdf}). Darüber hinaus können diese Felder bei neuen Einträgen
1424 in EndNote nicht genutzt werden, weil sie nicht im Eintragsdialog
1425 erscheinen. Der vorgegebene Importfilter von EndNote kann darüberhinaus
1426 das Feld \emph{author} nicht richtig analysieren. Der \emph{EndNote
1427 Import from JabRef Filter} kann dies. Außerdem erkennt dieser Filter
1428 ein Feld \texttt{endnotereftype}, das die vorgegebene Zuordnung überschreibt.
1429 Um den Filter zu installieren, nutzen Sie die EndNote Extras
1430 (\menu{Extras \msep{} EndNote Filter-Set entpacken})
1431 und entpacken die Zip-Datei, die dabei erstellt wird. Dann folgen
1432 Sie den Angaben in der Datei \texttt{readme.txt}.
1433
1434 \subsubsection{\jabref-Bibliographien in OpenOffice.org benutzen}
1435
1436 \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.
1437
1438 In beiden Fällen besteht die exportierte Tabelle aus einem Arbeitsblatt, das die Einträge in Reihen
1439 und die unterschiedlichen Felder in Spalten enthält. Die Reihenfolge und Benennung der Spalten ist kompatibel
1440 zu den Literaturverzeichnis-Funktionen von OpenOffice.org (OOo 1.1: \texttt{.sxc}, OOo 2.0: \texttt{.ods}).
1441
1442 \paragraph{Die exportierte Datei als Bibliographiedatenbank in OpenOffice 2.0 (oder neuer) benutzen}
1443 Gehen Sie folgendermaßen vor, um eine Tabelle, die von \jabref exportiert wurde, als Bibliographiedatenbank in OpenOffice.org zu benutzen:
1444
1445 \begin{itemize}
1446 \item Exportieren Sie Ihre Datenbank in das \texttt{.ods} -Format.
1447 \item Starten Sie OpenOffice.org.
1448 \item Wählen Sie \menu{Extras} \msep{} \menu{Optionen} \msep{} \menu{OpenOffice.org Base} \msep{} \menu{Datenbanken}.
1449 \item Bearbeiten Sie die \emph{Bibliography}-Datenbank und ändern ihren Namen z.\,B. in \emph{Bibliographie-alt}.
1450 \item Schließen Sie das Fenster \menu{Optionen} und gehen Sie zu \menu{Datei} \msep{} \menu{Neu} \msep{} \menu{Datenbank}.
1451 \item Dann wählen Sie \menu{Verbindung zu einer bestehenden Datenbank herstellen}, nehmen \menu{Tabellendokument} als
1452     Datenbanktyp und wählen die \texttt{.ods}-Datei, die Sie exportiert haben.
1453 \item Klicken Sie auf \menu{Fertig stellen} und wählen den Namen \emph{Bibliography} im Speicherdialog.
1454 \end{itemize}
1455 Anschließend wählen Sie \menu{Extras} \msep{} \menu{Literaturdatenbank}. Ihre Datenbank sollte nun angezeigt werden.
1456
1457 \paragraph{Eine exportierte Datei als Datenbank in OpenOffice 1.1.x benutzen}
1458
1459 \begin{itemize}
1460 \item Exportieren Sie Ihre Datei in das \texttt{.sxc}-Format.
1461 \item Starten Sie OpenOffice.org.
1462 \item Wählen Sie \menu{Extras} \msep{} \menu{Datenquellen}.
1463 \item Wählen Sie die \emph{Bibliography}-Datei und ändern ihren Namen beispielsweise in \emph{Bibliographie-alt}. 
1464 \item Drücken Sie \menu{Anwenden}.
1465 \item Klicken Sie \menu{Neue Datenquelle}. Ein neuer Eintrag erscheint. Ändern Sie den Namen zu \emph{Bibliography}.
1466 \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.
1467 \item Klicken Sie auf \menu{OK}, um das Fenster \menu{Datenquellen} zu schließen.
1468 \end{itemize}
1469 Anschließend wählen Sie \menu{Extras} \msep{} \menu{Literaturdatenbank}.
1470 Ihre Datenbank sollte nun angezeigt werden.
1471
1472 \subsubsection{Klartext-Import}
1473
1474 \begin{quote}
1475 \emph{Sie können aus einfachen Text-Dateien oder der Zwischenablage
1476 einen Importvorgang starten, indem Sie \menu{BibTeX}} \msep{} \emph{\menu{Neuer Eintrag aus Klartext}
1477 oder die Tastenkombination STRG-SHIFT-N wählen.}
1478 \end{quote}
1479 Dieser Dialog ermöglicht das schnelle Einfügen von Einträgen aus normalem
1480 Text. Wählen Sie zunächst aus, welcher Eintragstyp erstellt werden
1481 soll. Fügen Sie dann einfach Text aus der Zwischenablage ein (über das
1482 Kontextmenü im Textfeld mit der Wasserzeichenschrift >>Text einfügen<<
1483 oder über den Button \menu{Einfügen}). Alternativ können Sie über den Button
1484 \menu{Datei öffnen} eine Datei auswählen, um sie in den Dialog zu laden.
1485
1486 Jetzt markieren Sie z.\,B. den Textbereich, der zum Titel des neuen
1487 Eintrags werden soll, und führen im rechten Teil des Dialogfensters
1488 im Bereich \menu{Verfügbare BibTeX"=Felder} einen Doppelklick auf \emph{title} aus.
1489 So gehen Sie für alle weiteren Felder des neuen Eintrags vor. Sie
1490 können einem Feld natürlich auch mehrere Textbereiche zuordnen. Achten
1491 Sie dazu darauf, dass die Option \menu{anfügen} aktiviert ist, ansonsten
1492 wird bei jedem neuen Zuweisen von Textbereichen das Feld überschrieben
1493 (Option \menu{überschreiben}).
1494
1495 Bereits zugewiesene Textteile werden im Tab \menu{Importtext} blau
1496 hervorgehoben. Um zu kontrollieren, welche Textbereiche Sie einem
1497 bestimmten \bibtex{}-Feld zugewiesen haben, wählen Sie das Feld im
1498 rechten Bereich aus; der zugeordnete Text wird nun rot hervorgehoben.
1499
1500 Sie können sich das Ergebnis des Importvorgangs jederzeit im Tab \menu{BibTeX"=Quelltext}
1501 des Importdialogs ansehen. Hier können keine Änderungen vorgenommen
1502 werden; das ist erst möglich, sobald der Text tatsächlich importiert
1503 und ein neuer Eintrag angelegt wurde. Auf mögliche Fehler werden Sie
1504 im Tab \menu{Hinweise und Warnungen} aufmerksam gemacht.
1505
1506 Haben Sie alle Textstellen den gewünschten \bibtex{}-Feldern zugewiesen,
1507 klicken Sie auf die Schaltfläche \menu{Übernehmen}. Nun erstellt
1508 \jabref den neuen Eintrag, der allerdings noch keinen \bibtex{}-Key
1509 hat.
1510
1511 \subsection{Links zu externen Dateien}
1512
1513 \label{ExternalFiles}Mit \jabref können Sie Ihre Einträge mit
1514 den entsprechenden PDF- oder PS-Dateien, die sich auf Ihrem Computer
1515 befinden, verlinken. Ebenso ist es möglich, Dateien im Internet über
1516 einen URL oder DOI zu verlinken.
1517
1518
1519 \subsubsection{Externe Betrachter einrichten}
1520
1521 \jabref benötigt Informationen darüber, welche Programme es für
1522 PDF- und PS"=Dateien und Internetseiten benutzen soll. In der Standardeinstellung
1523 werden sie auf Werte gesetzt, die wahrscheinlich zu Ihrem Betriebssystem
1524 passen, so dass eine gute Chance besteht, dass Sie diese Werte nicht
1525 zu verändern brauchen.
1526
1527 \begin{quote}
1528 \emph{Um die Einstellungen der externen Programme zu ändern, öffnen
1529 Sie den Unterpunkt \menu{Externe Programme} im Dialog \menu{Optionen}}
1530 \msep{} \emph{\menu{Einstellungen}.}
1531 \end{quote}
1532
1533 \subsubsection{Externe Dateien oder Links öffnen}
1534
1535 Es gibt verschiedene Möglichkeiten, wie man externe Dateien oder Internetseiten
1536 aus \jabref öffnen kann. Im Eintrags-Editor können Sie einfach
1537 auf das Textfeld, das einen DOI oder URL enthält, doppelklicken. In
1538 der Tabellenansicht können Sie einen Eintrag auswählen und die Menüeinträge
1539 (unter \menu{Extras}), die Tastenkombinationen (in der Standardeinstellung
1540 F4 für PDF/PS und F3 für DOI/URL) oder das Kontextmenü (mit der rechten
1541 Maustaste) benutzen, um die Datei oder Internetseite zu öffnen. Schließlich
1542 können Sie auch auf ein PDF-, PS-, URL- oder DOI-Icon in der Tabelle
1543 klicken.
1544
1545 In der Standardeinstellung zeigt die Tabellenansicht zwei Spalten
1546 mit Icons für die Einträge, die mit externen Dateien oder URLs verlinkt
1547 sind. Beide Spalten können im Unterpunkt \menu{Tabellenansicht} des
1548 Dialogs \menu{Optionen} \msep{} \menu{Einstellungen} ausgeblendet
1549 werden. Die zweite Spalte zeigt Icons für PDF- oder PS-Dateien (nur
1550 PDF, wenn beide vorhanden sind), die dritte Spalte zeigt Icons für
1551 URL oder DOI (nur URL, wenn beide vorhanden sind).
1552
1553
1554 \subsubsection{Der Standard-Ordner für PDF-Dateien}
1555
1556 PDF-Dateien erhalten von \jabref eine >>Spezialbehandlung<<,
1557 um das Verlinken mit den entsprechenden Einträgen so einfach wie möglich
1558 zu gestalten. Um diese >>Spezialbehandlung<< nutzen zu können, müssen
1559 Sie im Unterpunkt \menu{Externe Programme} des Dialogs \menu{Optionen}
1560 \msep{} \menu{Einstellungen} einen Ordner als Standard-Ordner für
1561 Ihre PDF-Dateien angeben. Alle PDF-Dateien, die in diesem Ordner oder
1562 einem Unterordner gespeichert sind, werden mit einer relativen Pfadangabe
1563 referenziert, so dass Sie problemlos PDF-Verzeichnisse verschieben
1564 oder mit mehreren Benutzern von verschiedenen Netzwerkarbeitsplätzen
1565 aus an derselben Datei arbeiten können.
1566
1567 Wenn Sie Ihren PDF-Dateien dann noch Namen geben, die mit dem \bibtex{}-Key
1568 des entsprechenden Eintrags übereinstimmen (abgesehen von der Dateiendung \texttt{.pdf}), 
1569 sucht \jabref in Ihrem Standard-PDF-Ordner und dessen
1570 Unterordnern nach der richtigen PDF-Datei. Sobald die korrekt benannte
1571 PDF-Datei sich dort befindet, klicken Sie auf die Schaltfläche \menu{Auto}
1572 neben dem PDF-Feld im Eintrags-Editor. Wenn die PDF-Datei gefunden
1573 wird, wird das Feld entsprechend gesetzt.
1574
1575 Wenn Sie eine PDF-Datei wie beschrieben benennen, können Sie sie auch
1576 öffnen, ohne das PDF-Feld überhaupt zu benutzen. Der Nachteil ist
1577 in diesem Fall allerdings, dass das PDF-Icon in der Tabellenansicht
1578 nicht angezeigt wird, solange das PDF-Feld leer bleibt.
1579
1580 \subsubsection{Dateispezifische PDF- und PS-Verzeichnisse}
1581
1582 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.
1583
1584 \subsubsection{Die Suche mit regulären Ausdrücken für automatische Verknüpfungen nutzen}
1585 \label{RegularExpressionSearch}
1586
1587 Wenn Sie Dateinamen verwenden, die dem bibtexkey ergänzt um die Dateiendung entsprechen, findet \jabref diese Dateien automatisch.
1588
1589 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.
1590
1591 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.
1592
1593 Die folgende Syntax wird verwendet:
1594
1595 \begin{labeling}{MextensionM}
1596   \item [\texttt{*}] Suche in allen direkten Unterverzeichnissen, NICHT im aktuellen Verzeichnis und in Unterverzeichnissen zweiter oder tieferer Ebene.
1597   \item [\texttt{**}] Rekursive Suche in allen Unterverzeichnissen UND im aktuellen Verzeichnis.
1598   \item [\texttt{.}] Das aktuelle Verzeichnis.
1599   \item [\texttt{..}] Das Elternverzeichnis (eine Ebene höher).
1600   \item [\texttt{{[}title{]}}] Alle Ausdrücke in eckigen Klammern werden durch den Inhalt des entsprechenden Felds ersetzt.
1601   \item [\texttt{{[}extension{]}}] Wird durch die Dateiendung des Feldes, das Sie benutzen, ersetzt.
1602   \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.
1603 \end{labeling}
1604 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.
1605
1606 \subsection{XMP-Metadaten}
1607 \label{XMPHelp}
1608
1609 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.
1610
1611 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.
1612
1613 \subsubsection{Benutzung}
1614
1615 Um die XMP-Funktionen in \jabref zu nutzen, gehen Sie folgendermaßen vor:
1616
1617 \begin{itemize}
1618   \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.
1619   \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).
1620   \item Wenn Sie \emph{alle PDFs einer Datei mit Metadaten versehen} wollen, wählen Sie \menu{Extras \msep{} XMP-Metadaten in PDFs schreiben}.
1621   \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.
1622   \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.
1623 \end{itemize}
1624
1625 \subsubsection{bibteXMP Dateiformat}
1626
1627 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.
1628  
1629 Das folgende einfache Minimal-Schema wird benutzt:
1630 \begin{itemize}
1631   \item Der \bibtex{}-Key wird als \texttt{bibtexkey} gespeichert.
1632   \item Der Eintragstyp wird als \texttt{entrytype} gespeichert.
1633   \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.
1634   \item Alle anderen Felder werden unter ihrem Feld-Namen gespeichert.
1635 \end{itemize}
1636
1637 Es folgt ein Beispiel:
1638 \begin{lstlisting}
1639 @INPROCEEDINGS{CroAnnHow05,
1640   author = {Crowston, K. and Annabi, H. and Howison, J. and Masango, C.},
1641   title = {Effective work practices for floss development: A model and propositions},
1642   booktitle = {Hawaii International Conference On System Sciences (HICSS)},
1643   year = {2005},
1644   owner = {oezbek},
1645   timestamp = {2006.05.29},
1646   url = {http://james.howison.name/publications.html}
1647 }
1648 \end{lstlisting}
1649
1650 wird umgewandelt in
1651
1652 \begin{lstlisting}
1653 &lt;rdf:Description xmlns:bibtex=&quot;http://jabref.sourceforge.net/bibteXMP/&quot;
1654     bibtex:bibtexkey=&quot;CroAnnHow05&quot;
1655     bibtex:year=&quot;2005&quot;
1656     bibtex:title=&quot;Effective work practices for floss development: A model and propositions&quot;
1657     bibtex:owner=&quot;oezbek&quot;
1658     bibtex:url=&quot;http://james.howison.name/publications.html&quot;
1659     bibtex:booktitle=&quot;Hawaii International Conference On System Sciences (HICSS)&quot;
1660     bibtex:timestamp=&quot;2006.05.29&quot;&gt;
1661         &lt;bibtex:author&gt;
1662             &lt;rdf:Seq&gt;
1663                 &lt;rdf:li&gt;K. Crowston&lt;/rdf:li&gt;
1664                 &lt;rdf:li&gt;H. Annabi&lt;/rdf:li&gt;
1665                 &lt;rdf:li&gt;J. Howison&lt;/rdf:li&gt;
1666                 &lt;rdf:li&gt;C. Masango&lt;/rdf:li&gt;
1667             &lt;/rdf:Seq&gt;
1668         &lt;/bibtex:author&gt;
1669     &lt;bibtex:entrytype&gt;Inproceedings&lt;/bibtex:entrytype&gt;
1670 &lt;/rdf:Description&gt;
1671 \end{lstlisting}
1672
1673 Wenn Sie bibteXMP parsen möchten, beachten Sie, dass in RDF Attribut-Wert-Paare auch als Knoten wiedergegeben werden können und vice versa.
1674
1675 \subsubsection{Weiterführende Links}
1676
1677 Einige Links zu XMP und PDFs mit Anmerkungen (englisch):
1678
1679 \begin{itemize}
1680   \item James Howison's Blog \href{http://freelancepropaganda.com/themp/}{">Themp---Managing Academic Papers like MP3s"<}
1681   \item \href{http://www.xml.com/pub/a/2004/09/22/xmp.html}{XML.com-Artikel} zu XMP
1682   \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)
1683   \item Gute \href{http://episteme.arstechnica.com/eve/ubb.x/a/tpc/f/8300945231/m/377001889631}{Diskussion bei ArsTechnica} zum Management von PDFs.
1684   \item \href{http://partners.adobe.com/public/developer/en/xmp/sdk/xmpspecification.pdf}{Adobe XMP Spezifikation}
1685 \end{itemize}
1686
1687 \subsection{\jabref und Online-Datenbanken}
1688
1689 \subsubsection{CiteSeer}
1690
1691 \label{CiteSeerHelp}
1692 \tip[]{CiteSeer ist eine digitale Bibliothek und Suchmaschine für wissenschaftliche Literatur, vornehmlich zu den Bereichen Computer und Informatik.}
1693 \jabref kann Informationen über eine bestimmte
1694 Literaturangabe aus der CiteSeer-Datenbank herunterladen. Um diesen
1695 Vorgang zu starten, fügen Sie Ihrer Datei einen neuen Eintrag hinzu
1696 und belegen das Feld \emph{citeseerurl} mit einem Link zur entsprechenden
1697 Inhaltsseite auf CiteSeer. Das Feld \emph{citeseerurl} muss in einem
1698 der folgenden Formate eingegeben werden:
1699
1700 \begin{lstlisting}
1701 http://citeseer.ist.psu.edu/DDDDDD[.html] % oder
1702 oai:CiteSeerPSU:DDDDDD                    % oder
1703 DDDDDD
1704 \end{lstlisting}
1705 wobei DDDDDD eine Ziffernfolge darstellt. Um diese Ziffernfolge für
1706 einen CiteSeer-Eintrag zu finden, gehen Sie auf die Dokumentseite
1707 der Literaturangabe des Formats \texttt{http://citeseer.ist.psu.edu/}\texttt{\emph{nameYearTitle}}\texttt{.html}
1708 und klicken den (Update)"=Link für diese Literaturangabe. Die URL
1709 für den Update-Link beinhaltet die numerische ID für diese Literaturangabe.
1710
1711 Sobald Sie das Feld \emph{citeseerurl} belegt haben, können Sie die
1712 CiteSeer-Felder herunterladen, indem Sie \menu{BibTeX} \msep{} \menu{Felder von CiteSeer importieren}
1713 auswählen. Achten Sie darauf, dass Sie die Zeile(n) ausgewählt haben,
1714 die Sie aktualisieren wollen.
1715
1716 \paragraph{Eine Datei mit zitierenden Literaturangaben erzeugen}
1717
1718 Mit einem Satz von Literaturangaben können Sie eine Liste der Dokumente
1719 erzeugen, die die einzelnen Literaturangaben ihrerseits zitieren. Dazu
1720 muss jede Literaturangabe der entsprechenden Datenbank-Datei ein
1721 ausgefülltes citeseerurl-Feld besitzen, dessen Inhalt dem oben
1722 beschriebenen Format entspricht. Sie können diese Funktion nutzen, indem
1723 Sie \menu{Zitierende Literatur von CiteSeer abrufen} auswählen.
1724
1725 \subsubsection{Medline}
1726 \label{MedlineHelp}
1727
1728 \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.
1729 \jabref kann Literaturangaben der Medline"=Datenbank
1730 herunterladen. Um diese Funktion zu nutzen, wählen Sie \menu{Extras
1731 \msep{} Medline abrufen}, so dass der Medline-Dialog im linken
1732 Seitenfeld erscheint.}
1733 Es gibt zwei Möglichkeiten, die Auswahl der Einträge vorzunehmen,
1734 die heruntergeladen werden sollen:
1735
1736 \begin{enumerate}
1737 \item Geben Sie eine oder mehr Medline IDs (getrennt durch Komma/Semikolon)
1738 in das Textfeld ein.
1739 \item Geben Sie Namen oder Wörter ein, nach denen gesucht werden soll. Sie
1740 können dazu die Operatoren \texttt{AND} und \texttt{OR} sowie Klammern
1741 benutzen, um Ihren Suchbegriff zu verfeinern.
1742 \end{enumerate}
1743 In beiden Fällen drücken Sie dann ENTER oder die Schaltfläche \menu{Abrufen}.
1744 Wenn Sie eine Textsuche durchführen, wird Ihnen die Anzahl der gefundenen
1745 Einträge angezeigt, und Sie können wählen, wie viele Sie herunterladen
1746 möchten.
1747
1748 Die abgerufenen Einträge werden Ihrer zu diesem Zeitpunkt aktivierten
1749 Datei zugeordnet.
1750
1751 \subsubsection{IEEEXplore}
1752 \label{IEEEXploreHelp}
1753
1754 \tip[]{IEEEXplore bietet Zugang zu Literatur in den Bereichen Elektrotechnik, Informatik und Elektronik.}
1755 \jabref kann Literaturangaben der IEEEXplore-Datenbank herunterladen.
1756 Um diese Funktion zu nutzen, wählen Sie \menu{Internet \msep{} IEEEXplore abfragen}
1757 und geben in dem Dialog, der im linken Bildschirmbereich erscheint, Ihre
1758 Suchausdrücke ein. Drücken Sie anschließend die
1759 ENTER-Taste oder den \menu{Abrufen}-Button.
1760
1761 Die Suche wird im Gäste-Modus durchgeführt, es werden also maximal 100 Ergebnisse
1762 angezeigt.
1763
1764 Sie können die \emph{abstracts} zusammen mit den Literaturangaben herunterladen,
1765 indem Sie einen Haken bei \menu{Abstracts berücksichtigen} setzen. Das verursacht
1766 eine deutlich höhere Anzahl von Netzwerk-Anfragen; um die Webseite von IEEEXplore
1767 nicht übermäßig zu belasten, lädt \jabref \emph{abstracts} nur bei einer Suche,
1768 deren Ergebnis eine bestimmte Trefferanzahl nicht übersteigt.
1769
1770 \subsubsection{Benutzung eines Proxy-Servers}
1771
1772 Wenn Sie einen HTTP-Proxy-Server benutzen müssen, übergeben Sie den
1773 Servernamen und die Portnummer an Java. Diese Umgebungseinstellungen
1774 sind dokumentiert unter \url{http://java.sun.com/j2se/1.4.2/docs/guide/net/properties.html}
1775
1776 \begin{lstlisting}
1777 java -Dhttp.proxyHost="hostname" -Dhttp.proxyPort="portnumber"
1778 \end{lstlisting}
1779
1780 \subsection{\jabref mit mehreren Benutzern verwenden}
1781
1782 \jabref bietet einige Funktionen, die besonders dann von Nutzen
1783 sind, wenn eine Datenbank von mehreren Benutzern~-- z.\,B. über
1784 ein Netzwerk~-- bearbeitet wird. Das sind vor allem die Felder \emph{owner}
1785 und \emph{timestamp}.
1786
1787
1788 \subsubsection{Zeitstempel \emph{(timestamp)}}
1789 \label{TimeStampHelp}
1790
1791 \begin{quote}
1792 \emph{Die Benutzung des Zeitstempels kann unter
1793 \menu{Einstellungen}} \msep{} \emph{\menu{Allgemein} an- und
1794 abgestellt sowie verändert werden.}
1795 \end{quote}
1796 \jabref kann automatisch das Feld \emph{timestamp} setzen, das
1797 das Datum enthält, an dem der Eintrag zur Datei hinzugefügt wurde.
1798 Die Formatierung des Zeitstempels wird von einem Ausdruck mit Bezeichnern
1799 bestimmt, die die Position verschiedener Bestandteile des Datums angeben.
1800 Es folgen einige der verfügbaren Bezeichner (die Beispiele in Klammern
1801 beziehen sich auf Mittwoch, den 14. September 2005, 17:45 Uhr):
1802
1803 \begin{labeling}{00.00.0000}
1804 \item [\texttt{yy}]Jahr (05)
1805 \item [\texttt{yyyy}]Jahr (2005)
1806 \item [\texttt{MM}]Monat (09)
1807 \item [\texttt{dd}]Tag (14)
1808 \item [\texttt{HH}]Stunde (17)
1809 \item [\texttt{mm}]Minute (45)
1810 \end{labeling}
1811 Diese Bezeichner können mit Interpunktion und Leerzeichen kombiniert
1812 werden. Hier einige Beispiele:
1813
1814 \begin{labeling}{dd.MM.yyyy-HH:m}
1815 \item [\texttt{yyyy.MM.dd}]$\to$ 2005.09.14
1816 \item [\texttt{yy-MM-dd}]$\to$ 05-09-14
1817 \item [\texttt{dd.MM.yyyy~HH:mm}]$\to$ 14.09.2005 17:45
1818 \end{labeling}
1819
1820 \subsubsection{Besitzer \emph{(owner)}}
1821
1822 \label{OwnerHelp}\jabref kann allen neuen Einträgen, die zu einer
1823 Datei hinzugefügt oder in sie importiert werden, Ihren Benutzernamen
1824 beigeben. Diese Funktion können Sie im Menü \menu{Einstellungen}
1825 \msep{} \menu{Allgemein} ein- und ausschalten. Dort können Sie auch
1826 den Namen angeben, der in den Einträgen erscheinen soll.
1827
1828 In der Standardeinstellung wird Ihr (System-)Benutzername verwendet.
1829 Der Name wird in dem Feld \emph{owner} eingetragen, das in der Standardeinstellung
1830 im Tab \emph{General fields} des Eintragseditors angezeigt wird.
1831
1832
1833 \subsection{\jabref von der Kommandozeile}
1834
1835 \label{CommandLine}Obwohl \jabref in erster Linie ein Programm
1836 mit grafischer Benutzeroberfläche ist, bietet es einige nützliche
1837 Optionen für die Kommandozeile und kann sogar Dateikonvertierungen
1838 durchführen, ohne die grafische Benutzeroberfläche zu öffnen.
1839
1840 Sie können eine oder mehrere \bibtex{}-Dateien laden, indem Sie auf
1841 der Kommandozeile die entsprechenden Dateinamen auflisten. Achten
1842 Sie darauf, alle gewünschten Optionen anzugeben, bevor Sie die Dateinamen
1843 anfügen. Außerdem müssen Sie sich vergewissern, dass der erste Dateiname
1844 nicht als Argument einer Option missverstanden werden kann~-- falls
1845 eine Bool'sche Option wie \texttt{-n} oder \texttt{-l} direkt vor
1846 einem Dateinamen steht, müssen Sie also \texttt{true} als Argument
1847 angeben. Das Beispielkommando:
1848
1849 \begin{lstlisting}
1850 jabref -o filetoexport.xml,docbook -n true original.bib
1851 \end{lstlisting}
1852 lädt die Datei \texttt{original.bib}, exportiert sie in das Docbook-Format,
1853 speichert sie unter dem Namen \texttt{filetoexport.xml} und unterdrückt
1854 das Laden der grafischen Oberfläche. Das Word \emph{true} verhindert,
1855 dass der Dateiname als Argument der Option \texttt{-n} interpretiert
1856 wird.
1857
1858
1859 \subsubsection{Kommandozeilen-Optionen}
1860
1861 Im folgenden werden die wichtigsten Optionen und Befehle für die Kommandozeile
1862 vorgestellt.
1863
1864 \begin{itemize}
1865 \item Hilfe: \texttt{-h}
1866
1867 Diese Option veranlasst \jabref, eine Zusammenfassung der Kommandozeilen-Optionen
1868 anzuzeigen und das Programm unmittelbar darauf zu schließen.
1869
1870 \item Kein GUI-Modus: \texttt{-n}
1871
1872 Diese Option unterdrückt sowohl das \jabref-Fenster als auch den
1873 Eröffnungsbildschirm, der normalerweise beim Programmstart angezeigt
1874 wird. Das Programm wird beendet, sobald die Kommandozeilen-Optionen
1875 abgearbeitet wurden.
1876 Diese Option ist nützlich, um Dateikonvertierungen von der Kommandozeile
1877 oder mit Hilfe eines Scripts durchzuführen.
1878
1879 \item Sitzung laden: \texttt{-l}
1880
1881 Diese Option veranlasst \jabref, eine gespeicherte Sitzung zu laden,
1882 sofern eine vorhanden ist, bevor sich das Hauptfenster öffnet.
1883
1884 \item Datei importieren: \texttt{-i Dateiname{[},Importformat{]}}
1885
1886 Bei dieser Option importiert oder lädt \jabref eine bestimmte Datei.
1887 Wenn nur ein Dateiname angegeben wird oder ein Komma und ein {*}-Zeichen
1888 hinter dem Dateinamen stehen, versucht \jabref, das Dateiformat
1889 automatisch zu erkennen. Das sollte bei allen \bibtex{}-Dateien ebenso
1890 funktionieren wie bei Dateien, die in einem der von \jabref unterstützten
1891 Importformate vorliegen. Wenn dem Dateinamen ein Komma und ein Importformat
1892 folgen, wird der angegebene Importfilter benutzt. Mit der Option \texttt{-h}
1893 können Sie sich eine Liste der verfügbaren Importformate anzeigen
1894 lassen.
1895
1896 Wenn Sie zusätzlich eine Export-Option angeben, wird der Import immer
1897 zuerst ausgeführt, bevor die importierte oder geladene Datei an den
1898 Exportfilter übergeben wird. Falls die grafische Oberfläche nicht
1899 mit der Option \texttt{-n} unterdrückt wird, werden alle geladenen
1900 oder importierten Dateien im Hauptfenster von \jabref angezeigt.
1901
1902 Die Option \texttt{-i} kann nur einmal angegeben werden und nimmt
1903 als Argument maximal eine Datei.
1904
1905 \item Datei exportieren: \texttt{-o Dateiname{[},Exportformat{]}}
1906
1907 Diese Option veranlasst \jabref, eine Datei zu speichern oder zu
1908 exportieren, die von derselben Kommandozeile geladen oder importiert
1909 wurde. Wenn eine Datei mit der Option \texttt{-i} importiert wurde,
1910 wird diese Datei exportiert. Ansonsten wird die Datei exportiert,
1911 die \emph{zuletzt}~-- ohne die Option \texttt{-i}~-- angegeben (und
1912 erfolgreich geladen) wurde.
1913
1914 Wird nur ein Dateiname angegeben, so wird diese Datei im \bibtex{}-Format
1915 gespeichert. Wenn dem Dateinamen ein Komma und ein Exportformat folgen,
1916 wird der angegebene Exportfilter benutzt. Auf diese Weise wird auch
1917 ein benutzerdefinierter Exportfilter angewendet; wenn der Name sowohl
1918 auf einen Standard-Exportfilter, als auch auf einen benutzerdefinierten
1919 Exportfilter zutrifft, wird der benutzerdefinierte verwendet.
1920
1921 Mit der Option \texttt{-h} können Sie sich eine Liste der verfügbaren
1922 Exportformate anzeigen lassen.
1923
1924 Falls die Option \texttt{-n} nicht aufgerufen wurde, wird jeder Exportvorgang
1925 durchgeführt, bevor das \jabref-Fenster geöffnet wird. Dort werden
1926 dann die importierten Dateien angezeigt.
1927
1928 Die Option \texttt{-o} kann nur einmal angegeben werden und nimmt
1929 als Argument maximal eine Datei.
1930
1931 \item Einstellungen exportieren: \texttt{-x Dateiname}
1932
1933 Mit dieser Option können Sie \jabref veranlassen, alle Benutzer-Einstellungen
1934 in eine XML-Datei zu speichern. Nach dem Export startet \jabref
1935 normal.
1936
1937 \item Einstellungen importieren: \texttt{-p Dateiname}
1938
1939 Mit dieser Option importiert \jabref Benutzer-Einstellungen, die
1940 mit der Option \texttt{-x} exportiert wurden. Nach dem Import startet
1941 \jabref normal.
1942
1943 \item Nur benutzte Einträge exportieren: \texttt{-a Dateiname{[}.aux{]},neueBibDatei{[}.bib{]}}
1944
1945 Manchmal ist es nützlich, eine \bibtex{}-Datei zu haben, die nur die
1946 benutzten Einträge enthält. Eine Liste dieser benutzten Einträge findet
1947 sich in einer .aux-Datei (sobald Sie \LaTeX{} aufgerufen haben). \jabref
1948 kann diese Datei analysieren, um eine neue \bibtex{}-Datei zu erstellen,
1949 die nur die bekannten und benutzten Einträge enthält. Das bedeutet,
1950 dass ein Eintrag, der in der Standard-\bibtex{}-Datei nicht definiert
1951 ist, auch nicht in die neue Datei geschrieben werden kann.
1952
1953 \end{itemize}
1954
1955 \subsubsection{Externer Zugriff}
1956 \label{RemoteHelp}
1957 \begin{quote}
1958 \emph{Diese Funktion kann unter \menu{Optionen \msep{} Einstellungen \msep{} Erweitert} verwaltet werden.}
1959 \end{quote}
1960
1961 \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.}
1962 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.
1963
1964 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.
1965
1966 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.
1967
1968 \clearpage 
1969 \section{Anpassung}
1970 \secttoc
1971
1972 \subsection{Eintragstypen}
1973
1974 \label{CustomEntriesHelp}
1975
1976 \begin{quote}
1977 \emph{Um Eintragstypen anzupassen, wählen Sie den Menüpunkt \menu{Optionen}}
1978 \msep{} \emph{\menu{Eintragstypen anpassen}.}
1979 \end{quote}
1980 Wenn Sie einen Eintragstyp anpassen, definieren Sie sowohl sein Erscheinungsbild
1981 im Eintragseditor als auch die Bedingungen, nach denen \jabref
1982 einen Eintrag als vollständig akzeptiert. Sie können die bestehenden
1983 Eintragstypen verändern und neue hinzufügen.
1984
1985 Beachten Sie, dass in diesem Dialog keine Änderungen gespeichert werden,
1986 solange Sie nicht auf \menu{Übernehmen} oder \menu{OK} klicken.
1987 Wenn Sie \menu{Abbrechen} anklicken oder einfach den Dialog schließen,
1988 gehen die bislang nicht übernommenen Änderungen verloren.
1989
1990
1991 \subsubsection{Der Dialog \menu{Eintragstypen anpassen}}
1992
1993 Der Dialog \menu{Eintragstypen anpassen} ist in drei Hauptbereiche
1994 unterteilt. Im linken Bereich können Sie den Eintragstyp auswählen,
1995 den Sie bearbeiten wollen, und neue Eintragstypen hinzufügen. Im mittleren
1996 Bereich werden die Einstellungen für die benötigten Felder des ausgewählten
1997 Eintragstyps vorgenommen und im rechten Bereich diejenigen der optionalen
1998 Felder.
1999
2000
2001 \subsubsection{Eintragstypen hinzufügen und löschen}
2002
2003 Die derzeit verfügbaren Eintragstypen werden im linken Bereich des
2004 Dialogfensters aufgelistet. Wenn Sie einen Eintragstyp auswählen,
2005 werden die anderen Bereiche aktualisiert und zeigen die benötigten
2006 und optionalen Felder dieses Eintragstyps.
2007
2008 Um einen neuen Eintragstyp hinzuzufügen, geben Sie einfach seinen
2009 Namen in das Textfeld unter der Typliste ein und klicken \menu{Hinzufügen}.
2010 Der neue Eintragstyp wird zur Liste hinzugefügt und zur Bearbeitung
2011 ausgewählt.
2012
2013 Um einen eigenen Eintragstyp zu entfernen, wählen Sie ihn aus und
2014 klicken auf \menu{Löschen}. Dieser Vorgang ist nur für eigene Eintragstypen
2015 verfügbar, die nicht nur Abwandlungen der Standard-Typen sind. Die
2016 Standard-Eintragstypen können nicht gelöscht werden.
2017
2018 Um einem Eintragstyp seinen Standardwert zurückzugeben, wählen Sie
2019 ihn aus und drücken auf \menu{Standard}. Dieser Vorgang ist nur für
2020 Standard-Typen verfügbar, die bearbeitet wurden.
2021
2022
2023 \subsubsection{Eintragstypen bearbeiten}
2024
2025 Wenn ein Eintragstyp ausgewählt ist, werden die derzeitigen benötigten
2026 und optionalen Felder im mittleren und rechten Bereich des Dialogfensters
2027 aufgelistet. Das Vorgehen beim Bearbeiten dieser Listen ist für die
2028 benötigten und optionalen Felder identisch.
2029
2030 Um ein neues Feld hinzuzufügen, bearbeiten Sie das Textfeld unterhalb
2031 der Liste oder wählen einen Feldnamen aus dem Dropdown-Menü und klicken
2032 auf \menu{Hinzufügen}. Der gewählte Feldname erscheint am Ende der
2033 Liste.
2034
2035 Um eines oder mehrere Felder zu löschen, wählen Sie sie in der Liste
2036 aus und klicken auf \menu{Löschen}. Die Reihenfolge der Felder können
2037 Sie ändern, indem Sie einen Feldnamen auswählen und die Pfeil"=Buttons
2038 benutzen, um das Feld nach oben oder nach unten zu verschieben.
2039
2040 Es gibt eine Beschränkung beim Anpassen der Eintragstypen; bestimmte
2041 Typen haben eine ">und/oder"<"=Bedingung in ihren benötigten Feldern. Ein
2042 \emph{book}-Eintrag ist beispielsweise komplett, wenn entweder das
2043 Feld \emph{author} oder \emph{editor} oder beide gesetzt sind. Diese
2044 Art von Bedingung kann in einem angepassten Eintragstyp nicht realisiert
2045 werden.
2046
2047
2048 \subsection{Allgemeine Felder festlegen}
2049
2050 \label{GeneralFields}Sie können dem Eintragseditor eine beliebige
2051 Anzahl von Tabs hinzufügen, die bei allen Eintragstypen sichtbar sind.
2052 Wählen Sie dazu den Menüeintrag \menu{Optionen} \msep{} \menu{Allgemeine Felder festlegen}.
2053
2054 Jede Zeile repräsentiert einen Tab. Der Anfang der Zeile steht für
2055 den Namen des Tabs, gefolgt von einem Doppelpunkt. Anschließend listen
2056 Sie die einzelnen Felder auf, die der Tab enthalten soll, und trennen
2057 sie jeweils durch ein Semikolon.
2058
2059 Das Beispiel
2060
2061 \begin{lstlisting}
2062 Allgemeine Felder:url;keywords;doi;pdf
2063 Zusammenfassung:abstract;annote
2064 \end{lstlisting}
2065 ergibt somit einen Tab mit dem Namen >>Allgemeine Felder<<, der
2066 die Felder \emph{url}, \emph{keywords}, \emph{doi} und \emph{pdf}
2067 enthält, sowie einen zweiten Tab namens >>Zusammenfassung<< mit
2068 den Feldern \emph{abstract} und \emph{annote}.
2069
2070
2071 \subsection{Automatische Erstellung von \bibtex{}"=Keys}
2072 \label{LabelPatterns}
2073 \begin{quote}
2074 \emph{Unter \menu{Optionen \msep{} Einstellungen \msep{} BibTeX"=Key"=Muster} 
2075 kann man die Felder bestimmen, die zur automatischen Generierung der
2076 \bibtex{}"=Keys herangezogen werden.}
2077 \end{quote}
2078 \jabref verwendet ein Standardmuster zur Generierung von \bibtex{}"=Keys, das Keys wie z.\,B.
2079 \texttt{Yared1998} erzeugt. Falls der \bibtex{}-Key in der geöffneten
2080 Datei nicht eindeutig sein sollte, wird einer der Buchstaben a-z angefügt,
2081 bis ein eindeutiger Key gefunden ist. Dementsprechend könnten die
2082 Labels wie folgt aussehen:
2083
2084 \begin{lstlisting}
2085 Yared1998
2086 Yared1998a
2087 Yared1998b
2088 (*\ldots*)
2089 \end{lstlisting}
2090 Um das Aussehen der \bibtex{}-Keys zu bestimmen, benutzt \jabref
2091 Feldmarken. Das Key"=Muster kann für jeden der vorgegebenen Eintragstypen
2092 bestimmt werden. Es kann beliebigen Text enthalten, unabhängig von
2093 und zusätzlich zu den Feldmarken, die angeben, dass ein bestimmtes
2094 Feld des Eintrags an dieser Stelle des Keys eingefügt werden soll.
2095 Eine Feldmarke besteht gewöhnlich aus dem Feldnamen in eckigen Klammern,
2096 z.\,B. \texttt{{[}volume{]}}. Wenn dieses Feld zum Zeitpunkt der
2097 Erstellung des Keys leer ist, wird kein Text eingefügt.
2098
2099 Es gibt außerdem mehrere spezielle Feldmarken, die nur einen bestimmten
2100 Teil aus einem Feld extrahieren. Sie werden unten aufgelistet. Natürlich
2101 können Sie auch neue spezielle Feldmarken vorschlagen.
2102
2103
2104 \subsubsection{Spezielle Feldmarken}
2105
2106 \begin{labeling}{auth.auth.eaMM}
2107 \item [\texttt{{[}auth{]}}]Der Nachname des ersten Autors.
2108 \item [\texttt{{[}authors{]}}]Die Nachnamen aller Autoren.
2109 \item [\texttt{{[}authorsN{]}}]Die Nachnamen von bis zu N Autoren. Falls
2110 es mehr Autoren gibt, wird EtAl angehängt.
2111 \item [\texttt{{[}authIniN{]}}]Der Anfang des Nachnamens von jedem Autoren,
2112 wobei nicht mehr als N Buchstaben verwendet werden.
2113 \item [\texttt{{[}authorIni{]}}]Die ersten 5 Buchstaben des Nachnamens
2114 des ersten Autors und die Initialen der Nachnamen der restlichen Autoren.
2115 \item [\texttt{{[}authN{]}}]Die ersten N Buchstaben des Nachnamens des
2116 ersten Autors.
2117 \item [\texttt{{[}authN\_M{]}}]Die ersten N Buchstaben des Nachnamens des
2118 M-ten Autors.
2119 \item [\texttt{{[}auth.auth.ea{]}}]Die Nachnamen der beiden ersten Autoren
2120 und \texttt{.ea}, falls es mehr als zwei Autoren sind.
2121 \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.
2122 \item [\texttt{{[}authshort{]}}]Der Nachname bei einem Autor; der erste
2123 Buchstabe der Nachnamen von bis zu drei Autoren, falls mehr als ein
2124 Autor vorhanden ist. Ein Plus (+) wird angehängt, falls es mehr als
2125 drei Autoren gibt.
2126 \end{labeling}
2127
2128 \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{]}.}}
2129
2130 \begin{labeling}{veryshorttitleMM}
2131 \item [\texttt{{[}edtr{]}}]Der Nachname des ersten Herausgebers.
2132 \item [\texttt{{[}editors{]}}]Die Nachnamen aller Herausgeber.
2133 \item [\texttt{{[}edtrIniN{]}}]Der Anfang des Nachnamens von jedem Herausgeber,
2134 wobei nicht mehr als N Buchstaben verwendet werden.
2135 \item [\texttt{{[}editorIni{]}}]Die ersten 5 Buchstaben des Nachnamens
2136 des Herausgebers und die Initialen der Nachnamen der restlichen Herausgeber.
2137 \item [\texttt{{[}edtrN{]}}]Die ersten N Buchstaben des Nachnamens des
2138 ersten Herausgebers.
2139 \item [\texttt{{[}edtrN\_M{]}}]Die ersten N Buchstaben des Nachnamens des
2140 M-ten Herausgebers.
2141 \item [\texttt{{[}edtr.edtr.ea{]}}]Der Nachname der ersten beiden Herausgeber
2142 und \texttt{.ea}, falls es mehr als zwei Herausgeber sind.
2143 \item [\texttt{{[}edtrshort{]}}]Der Nachname bei einem Herausgeber; der
2144 erste Buchstabe der Nachnamen von bis zu drei Herausgebern, falls
2145 mehr als ein Herausgeber vorhanden ist. Ein Plus (+) wird angehängt,
2146 falls es mehr als drei Herausgeber gibt.
2147 \item [\texttt{{[}firstpage{]}}]Die erste Seitenzahl einer Veröffentlichung
2148 (pages).
2149 \item [\texttt{{[}lastpage{]}}]Die letzte Seitenzahl einer Veröffentlichung
2150 (pages).
2151 \item [\texttt{{[}shorttitle{]}}]Die ersten 3 Worte eines Titels (title).
2152 \item [\texttt{{[}shortyear{]}}]Die letzten 2 Ziffern des Jahrgangs (year).
2153 \item [\texttt{{[}veryshorttitle{]}}]Die ersten beiden Worte des Titels
2154 (title), wobei >>the<<, >>a<< und >>an<< ausgelassen werden.
2155 \end{labeling}
2156 Hinter einem Feldnamen (oder einem der oben aufgeführten Pseudo-Feldnamen)
2157 kann ein Modifikator stehen. Modifikatoren werden in der Reihenfolge
2158 angewendet, in der sie angegeben wurden.
2159
2160 \begin{labeling}{00.00.0000}
2161 \item [\texttt{:abbr}]Kürzt den Text, der von einem Feldnamen oder speziellen
2162 Feldmarken gebildet wird. Nur der erste Buchstabe und weitere Buchstaben,
2163 die auf ein Leerzeichen folgen, werden berücksichtigt. So würde beispielsweise
2164 \texttt{[journal:abbr]} die Zeitschrift >>Journal of Fish Biology<< zu
2165 >>JoFB<< wandeln.
2166 \item [\texttt{:lower}]Wandelt den von der Feldmarke eingefügten Text in
2167 Kleinbuchstaben. So wird beispielsweise bei \texttt{{[}auth:lower{]}}
2168 der Nachname des ersten Autors in Kleinbuchstaben ausgegeben.
2169 \end{labeling}
2170 Das Standardmuster, das \bibtex{}-Keys wie \texttt{Yared1998}
2171 erzeugt, ist \texttt{{[}auth{]}{[}year{]}}. Wenn Sie keine Key-Muster
2172 für einen bestimmten Eintragstyp angeben, wird dieses vorgegebene
2173 Muster verwendet. Sie können das vorgegebene Muster natürlich ebenfalls
2174 anpassen%~-- seine Einstellung befindet sich über der Liste der Eintragstypen
2175 %im Tab \menu{Key-Muster} des Dialogs \menu{Einstellungen}
2176 .
2177
2178 Beachten Sie, dass \jabref Umlaute und Buchstaben mit Akzenten
2179 sowie das ß beim Erstellen von \bibtex{}-Keys verändert, um möglichen
2180 Problemen vorzubeugen. Hierzu einige Beispiele:
2181
2182 \begin{lstlisting}
2183 Díaz Ibañez (*$\to$*) DiazIbanez
2184 Strömbäck   (*$\to$*) Stroembaeck
2185 Waßenhoven  (*$\to$*) Wassenhoven
2186 \end{lstlisting}
2187
2188 \subsubsection{Ersetzen eines regulären Ausdrucks}
2189
2190 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.
2191
2192 \subsection{Eintragsvorschau}
2193
2194 \label{PreviewHelp}Die Eintragsvorschau wird mit denselben Mechanismen
2195 erstellt, die auch bei den Exportfiltern angewendet werden. Bei der
2196 Vorschau durchläuft ein Eintrag eins von zwei möglichen Layouts (die
2197 sie mit F9 wechseln können) und erstellt HTML-Code, der im Vorschaudialog
2198 am unteren Bildschirmrand angezeigt wird.
2199
2200 Aussehen und Inhalt der Vorschau können mit derselben Syntax verändert
2201 werden, die für die Anpassung der Exportfilter verwendet wird (siehe
2202 Abschnitt~\ref{CustomExports}).
2203
2204 \subsection{Exportfilter}
2205
2206 \label{CustomExports}Mit \jabref können Sie Ihre eigenen Exportfilter
2207 definieren und genau so wie die Standard"=Exportfilter benutzen. Ein
2208 Exportfilter wird durch eine oder mehrere \emph{Layout"=Dateien} definiert,
2209 die mittels eingebauter Formatierprogramme das Format der exportierten
2210 Dateien festlegen. Ihre Layout-Datei müssen Sie in einem separaten
2211 Text\-editor erstellen.
2212
2213
2214 \subsubsection{Hinzufügen eines Exportfilters}\label{subsubsec:Hinzufuegen-Exportfilter}
2215
2216 Die einzige Voraussetzung für einen Exportfilter ist, dass eine Datei
2217 mit der Endung \texttt{.layout} vorhanden ist. Um einen neuen, eigenen
2218 Exportfilter hinzuzufügen, öffnen Sie das Dialogfenster \menu{Optionen}
2219 \msep{} \menu{Verwalte externe Exportfilter} und klicken auf die
2220 Schaltfläche \menu{Neu}. Es öffnet sich ein neues Fenster, in dem
2221 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
2222 gewünschte Dateiendung für den Exportfilter angeben können. Wenn Sie
2223 den Exportfilter benutzen, wird diese Endung im Datei"=Dialog automatisch
2224 vorgeschlagen.
2225
2226
2227 \subsubsection{Das Erstellen des Exportfilters}
2228
2229 Um einen Eindruck zu bekommen, wie Exportfilter auszusehen haben,
2230 suchen Sie am besten auf unserer Homepage nach dem Paket, das die
2231 Layout"=Dateien der Standard"=Exportfilter enthält.
2232
2233 Nehmen wir einmal an, dass wir einen HTML-Exportfilter erstellen wollen.
2234 Der Exportfilter muss lediglich aus einer einzigen \texttt{.layout}-Datei
2235 bestehen, die in diesem Fall \texttt{html.layout} genannt werden könnte.
2236 Sie können darüber hinaus auch zwei Dateien mit den Namen \texttt{html.begin.layout}
2237 und \texttt{html.end.layout} anlegen. Die erste dieser beiden Dateien
2238 enthält den Kopfteil der Ausgabe, die zweite den Fußteil. \jabref
2239 sucht jedesmal wenn der Exportfilter benutzt wird nach diesen Dateien
2240 und fügt sie~-- falls sie gefunden werden~-- wörtlich vor bzw. nach
2241 den einzelnen Einträgen in die Ausgabe ein.
2242
2243 \tip[]{Beachten Sie, dass sich diese Dateien in demselben Verzeichnis
2244 wie \texttt{html.layout} befinden und die Namensbestandteile \texttt{.begin}
2245 bzw. \texttt{.end} enthalten müssen.}
2246
2247 \noindent In unserem Beispiel-Exportfilter könnten diese Dateien folgendermaßen
2248 aussehen:
2249
2250 \begin{lstlisting}[title=html.begin.layout]
2251 <HTML>
2252 <BODY text="#275856">
2253 <basefont size="4" color="#2F4958" face="arial">
2254 \end{lstlisting}
2255 \begin{lstlisting}[title=html.end.layout]
2256 </BODY>
2257 </HTML>
2258 \end{lstlisting}
2259 Die Datei \texttt{html.layout} stellt die \emph{Standard}"=Formatvorlage
2260 für den Export eines einzelnen Eintrags bereit. Falls Sie unterschiedliche
2261 Formatvorlagen für verschiedene Eintragstypen anwenden wollen, müssen
2262 Sie typspezifische \texttt{.layout}"=Dateien erstellen. Diese
2263 müssen sich ebenfalls in demselben Verzeichnis wie die Haupt"=Layout"=Datei
2264 befinden und den Namensbestandteil \texttt{.entrytype} enthalten.
2265 Der Name des Eintragstyps muss komplett in Kleinbuchstaben geschrieben
2266 werden. In unserem Beispiel wollen wir eine Formatvorlage für Einträge
2267 des Typs \emph{book} haben, die in der Datei \texttt{html.book.layout}
2268 abgelegt wird. Für eine Dissertation würden wir die Datei \texttt{html.phdthesis.layout}
2269 anlegen~-- und so weiter. Diese Dateien sind der Standard"=Layout"=Datei
2270 sehr ähnlich, nur dass sie lediglich für Einträge des entsprechenden
2271 Typs genutzt werden. Achten Sie darauf, dass die Standard"=Layout"=Datei
2272 so allgemein gehalten wird, dass sie die meisten Eintragstypen abdeckt.
2273
2274
2275 \paragraph{Das Format der Layout-Datei}
2276
2277 Layout"=Dateien werden mit einem einfachen mark\-up"=Format erstellt,
2278 bei dem die Kommandos mit einem >>backslash<< (\texttt{\textbackslash{}})
2279 eingeleitet werden. Alle Textbestandteile, die nicht als Kommando
2280 identifiziert werden, gelangen direkt in die Ausgabedatei.
2281
2282
2283 \paragraph{Feldkommandos}
2284
2285 Ein beliebiges Wort, vor dem ein backslash steht, z.\,B. \texttt{\textbackslash{}author},
2286 \texttt{\textbackslash{}editor,} \texttt{\textbackslash{}title} oder
2287 \texttt{\textbackslash{}year}, wird als Verweis auf das entsprechende
2288 Feld ausgewertet, das dann direkt in die Ausgabe kopiert wird.
2289
2290
2291 \paragraph{Feldformatierer}
2292 \label{par:Feldformatierer}
2293
2294 Oft muss der Feldinhalt vor der Ausgabe verarbeitet werden. Dies wird
2295 mit Hilfe eines \emph{Feldformatierers} gemacht~-- einer java class,
2296 die eine Methode zur Verarbeitung des Feldinhaltes enthält.
2297
2298 Ein Formatierer wird angewendet, indem man das Kommando \texttt{\textbackslash{}format}
2299 gefolgt vom Namen des Formatierers in eckigen Klammern und dem Feldnamen
2300 in geschweiften Klammern einfügt, z.\,B.:
2301
2302 \begin{lstlisting}
2303 \format[ToLowerCase]{\author}
2304 \end{lstlisting}
2305 Sie können auch mehrere Formatierer angeben, getrennt durch Kommas.
2306 Diese werden nacheinander aufgerufen, und zwar von links nach rechts.
2307 Das Kommando
2308
2309 \begin{lstlisting}
2310 \format[ToLowerCase,HTMLChars]{\author}
2311 \end{lstlisting}
2312 ruft z.\,B. zunächst den Formatierer \emph{ToLowerCase} auf, \emph{HTMLChars}
2313 formatiert anschließend das Ergebnis. Auf diese Weise können Sie eine
2314 beliebige Anzahl an Formatierern auflisten.
2315
2316 \jabref bietet die folgenden Formatierer, wobei einige von anderen
2317 abhängen:
2318
2319 \begin{labeling}{MMMM}
2320 \item [\texttt{HTMLChars}]ersetzt \TeX{}-spezifische Sonderzeichen wie
2321 \texttt{\{\textbackslash{}\textasciicircum{}a\}} oder \texttt{\{\textbackslash{}\char`\"{}\{o\}\}}
2322 durch ihre HTML-Entsprechungen.
2323 \item [\texttt{HTMLParagraphs}]interpretiert zwei aufeinanderfolgende Zeilenumbrüche (z.\,B. \lstinline{\n \n}) als Beginn eines neuen Absatzes und erstellt dementsprechend Absatz-HTML-Tags.
2324 \item [\texttt{XMLChars}]ersetzt \TeX{}-spezifische Sonderzeichen wie \texttt{\{\textbackslash{}\textasciicircum{}a\}}
2325 oder \texttt{\{\textbackslash{}\char`\"{}\{o\}\}} durch ihre XML-Entsprechungen.
2326 \item [\texttt{CreateDocBookAuthors}]formatiert das author-Feld im DocBook-Stil.
2327 \item [\texttt{CreateDocBookEditors}]\emph{Dokumentation folgt.}
2328 \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"<.
2329 \item [\texttt{AuthorFirstFirst}]formatiert die Felder \emph{author}/\emph{editor}
2330 mit den Vornamen zuerst.
2331 \item [\texttt{AuthorFirstFirstCommas}]formatiert die Felder \emph{author}/\emph{editor}
2332 mit den Vornamen zuerst und abgetrennt durch Kommas.
2333 \item [\texttt{AuthorFirstAbbrLastCommas}]\emph{Dokumentation folgt.}
2334 \item [\texttt{AuthorFirstAbbrLastOxfordCommas}]\emph{Dokumentation folgt.}
2335 \item [\texttt{AuthorFirstLastOxfordCommas}]\emph{Dokumentation folgt.}
2336 \item [\texttt{AuthorLastFirst}]formatiert die Felder \emph{author}/\emph{editor}
2337 mit den Nachnamen zuerst.
2338 \item [\texttt{AuthorLastFirstAbbreviator}]kürzt die Vornamen aller Autoren.
2339 Dieser Formatierer kann nur angewendet werden, wenn \texttt{AuthorLastFirst}
2340 bereits benutzt wurde.
2341 \item [\texttt{AuthorLastFirstCommas}]\emph{Dokumentation folgt.}
2342 \item [\texttt{AuthorLastFirstOxfordCommas}]\emph{Dokumentation folgt.}
2343 \item [\texttt{AuthorLastFirstAbbrCommas}]\emph{Dokumentation folgt.}
2344 \item [\texttt{AuthorLastFirstAbbrOxfordCommas}]\emph{Dokumentation folgt.}
2345 \item [\texttt{AuthorAndsReplacer}]ersetzt >>and<< zwischen den Namen
2346 durch >>;<<, zwischen den letzten beiden Autoren steht >>\&<<.
2347 \item [\texttt{AuthorAndsCommaReplacer}]ersetzt >>and<< zwischen den
2348 Namen durch ein Komma (,) sowie >>\&<< zwischen den beiden letzten.
2349 \item [\texttt{AuthorOrgSci}]Der erste Autor erscheint als "Nachname, Vorname", alle anderen als "Vorname Nachname". Vornamen werden abgekürzt.
2350 \item [\texttt{AuthorAbbreviator}]\emph{Dokumentation folgt.}
2351 \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."<
2352 \item [\texttt{NoSpaceBetweenAbbreviations}]Leerzeichen zwischen mehreren abgekürzten Vornamen werden gelöscht.
2353 \item [\texttt{FormatPagesForHTML}]ersetzt >>\texttt{-{}-}<< durch >>\texttt{-}<<.
2354 \item [\texttt{FormatPagesForXML}]ersetzt >>\texttt{-{}-}<< durch einen
2355 XML en-dash (>>--<<).
2356 \item [\texttt{RemoveBrackets}]entfernt alle geschweiften Klammern (>>\{<<
2357 und >>\}<<).
2358 \item [\texttt{RemoveBracketsAddComma}]\emph{Dokumentation folgt.}
2359 \item [\texttt{RemoveWhitespace}]\emph{Dokumentation folgt.}
2360 \item [\texttt{RemoveLatexCommands}]entfernt \LaTeX{} Kommandos wie \texttt{\textbackslash{}em},
2361 \texttt{\textbackslash{}textbf} etc. Zusammen mit \texttt{HTMLChars}
2362 oder \texttt{XMLChars} sollte dieser Formatierer zuletzt aufgerufen
2363 werden.
2364 \item [\texttt{ToLowerCase}]macht aus allen Buchstaben Kleinbuchstaben.
2365 \item [\texttt{CompositeFormat}]\emph{Dokumentation folgt.}
2366 \item [\texttt{GetOpenOfficeType}]\emph{Dokumentation folgt.}
2367 \item [\texttt{RTFChars}]\emph{Dokumentation folgt.}
2368 \item [\texttt{ResolvePDF}]\emph{Dokumentation folgt.}
2369 \end{labeling}
2370 Falls keiner der verfügbaren Formatierer das Ergebnis erzielt, das
2371 Sie erreichen möchten, können Sie Ihren eigenen Formatierer hinzufügen,
2372 indem Sie das \lstinline{net.sf.jabref.export.layout.LayoutFormatter}-Interface
2373 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,
2374 so wie auch die Standard"=Formatierer. Ansonsten müssen Sie den Formatierer
2375 mit seinem vollen Namen aufrufen (inklusive Paketname). In jedem Fall
2376 muss der Formatierer in ihrem classpath sein, wenn Sie \jabref
2377 starten.
2378
2379
2380 \paragraph{Bedingte Ausgabe}
2381
2382 Manche statische Ausgabe macht nur Sinn, wenn ein bestimmtes Feld
2383 nicht leer ist. Wenn wir z.\,B. hinter den Namen der Editoren den
2384 Text \texttt{(Hrsg.)} haben wollen, brauchen wir Folgendes:
2385
2386 \begin{lstlisting}
2387 \format[HTMLChars,AuthorFirstFirst]{\editor} (Hrsg.)
2388 \end{lstlisting}
2389 Wenn nun aber das \emph{editor}-Feld leer ist~-- möglicherweise ist
2390 es für den Eintrag, der exportiert werden soll, nicht erforderlich~--,
2391 dann würde das \texttt{(Hrsg.)} dennoch erscheinen. Das kann man mit
2392 den Kommandos \texttt{\textbackslash{}begin} und \texttt{\textbackslash{}end}
2393 verhindern:
2394
2395 \begin{lstlisting}
2396 \begin{editor}
2397 \format[HTMLChars,AuthorFirstFirst]{\editor} (Hrsg.)
2398 \end{editor}
2399 \end{lstlisting}
2400 Die Kommandos \texttt{\textbackslash{}begin} und \texttt{\textbackslash{}end}
2401 sorgen dafür, dass der Text, den sie einschließen, nur dann ausgegeben
2402 wird, wenn das Feld, auf das in den geschweiften Klammern verwiesen
2403 wird, für den zu exportierenden Eintrag definiert und damit nicht
2404 leer ist.
2405
2406 \tip{Das Benutzen der Kommandos \texttt{\textbackslash{}begin} und
2407 \texttt{\textbackslash{}end} ist ein Schlüssel zum Erstellen von Layout-Dateien,
2408 die mit einer Vielzahl von Eintragstypen umgehen können.}
2409
2410
2411 \paragraph{Gruppierte Ausgabe}
2412
2413 Wenn Sie Ihre Einträge auf der Basis eines bestimmten Feldes gruppieren
2414 wollen, benutzen Sie die Kommandos für die gruppierte Ausgabe. Die
2415 gruppierte Ausgabe ist der bedingten Ausgabe sehr ähnlich, außer dass
2416 der Text zwischen den Kommandos nur ausgegeben wird, wenn das Feld,
2417 auf das in den geschweiften Klammern verwiesen wird, unterschiedliche
2418 Werte enthält.
2419
2420 Nehmen wir zum Beispiel an, dass wir die Ausgabe nach dem \emph{keyword}
2421 (Stichwort) gruppieren wollen. Bevor die Datei exportiert wird, müssen
2422 die Einträge nach dem \emph{keyword} sortiert worden sein. Dann benutzen
2423 Sie die folgenden Kommandos, um nach \emph{keyword} zu gruppieren:
2424
2425 \begin{lstlisting}
2426 \begingroup{keywords}
2427 New Category: \format[HTMLChars]{\keywords}
2428 \endgroup{keywords}
2429 \end{lstlisting}
2430
2431 \subsection{Importfilter}
2432
2433 \noindent \jabref bietet Ihnen die Möglichkeit, ganz ähnlich den Standard-Importern, eigene Importer 
2434 zu definieren und zu benutzen. Man definiert einen Importer durch eine oder mehrere Java"=\emph{Klassen},
2435 die Dateiinhalte aus einem sogenannten \emph{Input stream} lesen
2436 und daraus \bibtex{}-Einträge erzeugen. Sie können vorkompilierte Importer einbinden, die Sie vielleicht 
2437 von SourceForge erhalten haben (siehe Abschnitt ">\nameref{subsec:Ihre-Arbeit}"<). Sie können auch
2438 mit Grundkenntnissen der Java"=Programmierung eigene Importer für Referenzquellen, die für Sie wichtig sind,
2439 erstellen oder neue, verbesserte Versionen existierender Importer einbinden, ohne \jabref neu zu
2440 kompilieren.
2441
2442 \paragraph{Vorrangsregeln}
2443
2444 Externe Importfilter haben Vorrang vor Standard-Importern. So können Sie mit Ihren Importern
2445 die existierenden Importer in der automatischen Formaterkennung und an der Kommandozeile in \jabref überschreiben. Externe Importfilter selbst sind dann nach Namen sortiert.
2446
2447 \subsubsection{Einen externen Importfilter hinzufügen}
2448
2449 Stellen Sie sicher, dass Sie den Importer in kompilierter Form haben (eine oder mehrere
2450 \texttt{.class} Dateien) und dass die Klassendateien
2451 in einer Verzeichnisstruktur entsprechend ihrer Package"=Struktur liegen. 
2452 Um einen neuen externen Importfilter hinzuzufügen, öffnen Sie den Dialog 
2453 \menu{Optionen \msep{} Verwalte externe Importfilter}, und klicken Sie auf
2454 \menu{Aus Klassenpfad hinzufügen}. Ein Dateiauswahl"=Fenster erscheint, 
2455 mit dem Sie den Klassenpfad des Importers wählen, das heißt den obersten Ordner,
2456 in dem die Package"=Struktur Ihres Importers beginnt. In einem zweiten Dateiauswahl"=Fenster
2457 wählen Sie die \emph{.class}"=Datei Ihres Importers, die von \texttt{\textbackslash{}ImportFormat} abgeleitet
2458 ist. Wenn Sie \menu{Klasse auswählen} klicken, erscheint Ihr neuer Importer
2459 in der Liste der externen Importfilter. Alle externen Importfilter erscheinen in den
2460 \jabref"=Untermenüs \menu{Datei \msep{} Importieren \msep{} Externe Importfilter} und 
2461 \menu{Datei \msep{} Importieren und Anhängen \msep{} Externe Importfilter}.
2462
2463 \tip[Bitte beachten Sie: ]{Wenn Sie die Klassen in ein anderes Verzeichnis verschieben,
2464 müssen Sie den Importer entfernen und neu hinzufügen. Wenn Sie einen Importfilter
2465 mit einem bereits vorhandenen Namen registrieren, ersetzt \jabref den vorhandenen
2466 externen Importfilter. Auch wenn es in manchen Fällen möglich ist, einen schon registrierten
2467 Importer zu aktualisieren ohne \jabref neu zu starten (nämlich dann,
2468 wenn der Importer nicht im Klassenpfad von \jabref ist), empfehlen wir, grundsätzlich
2469 \jabref neu zu starten, wenn Sie ein Update eines externen Importers durchgeführt haben.
2470 Sie können auch Importer aus ZIP- oder JAR-Archiven registrieren, wählen Sie einfach
2471 \emph{\menu{Aus Archiv-Datei hinzufügen}}, dann das ZIP- oder JAR-Archiv und dann den Eintrag
2472 (Klassendatei), der den neuen Importer darstellt.}
2473
2474 \subsubsection{Einen Importfilter entwickeln}
2475
2476 Bitte schauen Sie auf unseren Download-Seiten nach Beispielen und nützlichen Dateien zur 
2477 Entwicklung Ihres Importfilters.
2478
2479 \paragraph{Ein einfaches Beispiel}
2480
2481 Angenommen, wir wollen Dateien der folgenden Form importieren:
2482 \begin{lstlisting}
2483 1936;John Maynard Keynes;The General Theory of Employment, Interest and Money
2484 2003;Boldrin & Levine;Case Against Intellectual Monopoly
2485 2004;ROBERT HUNT AND JAMES BESSEN;The Software Patent Experiment
2486 \end{lstlisting}
2487
2488 \subparagraph{SimpleCsvImporter Erstellen}
2489
2490 Erzeugen Sie in einem Text"=Editor eine Klasse, die von \texttt{ImportFormat} abgeleitet
2491 ist und die folgende Methoden implementiert:\\
2492 \texttt{getFormatName()}, 
2493 \texttt{isRecognizedFormat()}
2494 und \texttt{importEntries()}.\\
2495 Hier ein Beispiel:
2496 \begin{lstlisting}
2497 import java.io.*;
2498 import java.util.*;
2499 import net.sf.jabref.*;
2500 import net.sf.jabref.imports.ImportFormat;
2501 import net.sf.jabref.imports.ImportFormatReader;
2502
2503 public class SimpleCsvImporter extends ImportFormat {
2504
2505   public String getFormatName() {
2506     return "Simple CSV Importer";
2507   }
2508
2509   public boolean isRecognizedFormat(InputStream stream) throws IOException {
2510     return true; // this is discouraged except for demonstration purposes
2511   }
2512
2513   public List importEntries(InputStream stream) throws IOException {
2514         ArrayList bibitems = new ArrayList();
2515     BufferedReader in = new BufferedReader(ImportFormatReader.getReaderDefaultEncoding(stream));
2516
2517     String line = in.readLine();
2518     while (line != null) {
2519       if (!"".equals(line.trim())) {
2520         String[] fields = line.split(";");
2521         BibtexEntry be = new BibtexEntry(Util.createNeutralId());
2522         be.setType(BibtexEntryType.getType("techreport"));
2523         be.setField("year", fields[0]);
2524         be.setField("author", fields[1]);
2525         be.setField("title", fields[2]);
2526         bibitems.add(be);
2527         line = in.readLine();
2528       }
2529     }
2530     return bibitems;
2531   }
2532 }
2533 \end{lstlisting}
2534
2535 \subparagraph{SimpleCsvImporter übersetzen}
2536
2537 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
2538 \texttt{SimpleCsvImporter.java} und Java ist in Ihrem Kommandopfad. 
2539 Kompilieren Sie die Klasse mit JSDK 1.4 zum Beispiel mit folgendem Kommandozeilen"=Aufruf: 
2540 \begin{lstlisting}
2541 javac -classpath JabRef-2.0.jar SimpleCsvImporter.java
2542 \end{lstlisting}
2543 Nun sollte dort auch eine Datei \texttt{/mypath/SimpleCsvImporter.class} liegen.
2544
2545 \subparagraph{SimpleCsvImporter registrieren}
2546
2547 Öffnen Sie in \jabref \menu{Optionen} \msep{} \menu{Verwaltung externer Importfilter} und klicken Sie
2548 auf \menu{Aus Klassenpfad hinzufügen}. Navigieren Sie nach \texttt{/meinpfad} und 
2549 klicken Sie \menu{Klassenpfad auswählen}. Wählen Sie dann die Datei \texttt{SimpleCsvImporter.class}
2550 und klicken Sie \menu{Klasse auswählen}. Ihr Importfilter sollte nun in der Liste der
2551 externen Importfilter unter dem Namen >>Simple CSV Importer<< erscheinen und,
2552 sobald Sie \menu{Schließen} gewählt haben, auch in den Untermenüs \menu{Datei} \msep{} \menu{Importieren} \msep{} 
2553 \menu{Externe Importfilter} und \menu{Datei} \msep{} \menu{Importieren und Anhängen} \msep{} \menu{Externe Importfilter} 
2554 des \jabref-Hauptfensters auftauchen.
2555
2556 \subsection{Teilen Sie Ihre Arbeit mit anderen}
2557 \label{subsec:Ihre-Arbeit}
2558 Mit externen Layout-Dateien und Importfiltern ist es einfach, Ihre eigenen Export-Formate und Importfilter
2559 mit anderen Anwendern gemeinsam zu benutzen. Falls Sie einen Exportfilter oder einen Importfilter
2560 für ein Format erstellt haben, das noch nicht von \jabref unterstützt wird,
2561 oder falls Sie einen bestehenden Exportfilter oder Importfilter verbessern, möchten
2562 wir Sie ermutigen, Ihre Arbeit auf der \href{http://sourceforge.net/projects/jabref/}{SourceForge.net"=Seite} bereitzustellen.
2563 Dasselbe gilt für Formatierklassen, die Sie schreiben. Wir würden
2564 uns freuen, eine Sammlung von bereitgestellten Layout"=Dateien verteilen
2565 zu können oder die Standard"=Exportfilter, -Formatierer und -Importfilter
2566 zu erweitern.
2567
2568 \clearpage 
2569 \section{Tastenkürzel}
2570
2571 Die Menüs können alle über Tastenkürzel angesteuert werden, die meisten
2572 Menübefehle ebenfalls. Das ist immer am unterstrichenen Buchstaben
2573 sichtbar.
2574
2575 Es folgt ein Überblick über die wichtigsten Tastenkürzel ohne Anspruch
2576 auf Vollständigkeit~\ldots{}
2577
2578 \begin{longtable}{p{66mm}p{33mm}}
2579 \textbf{Datei (Forts.)}&
2580 \tabularnewline
2581 \endhead
2582 \textbf{Datei}&
2583 \tabularnewline
2584 \endfirsthead
2585 Datei öffnen&
2586 STRG-O\tabularnewline
2587 Datei speichern&
2588 STRG-S\tabularnewline
2589 Datei speichern unter~\ldots{}&
2590 STRG-SHIFT-S\tabularnewline
2591 Datei schließen&
2592 STRG-W\tabularnewline
2593 Sitzung speichern&
2594 F11\tabularnewline
2595 Sitzung laden&
2596 F12\tabularnewline
2597 \jabref beenden&
2598 STRG-Q\tabularnewline
2599 \end{longtable}
2600
2601 \begin{longtable}{p{66mm}p{33mm}}
2602 \textbf{Bearbeiten (Forts.)}&
2603 \tabularnewline
2604 \endhead
2605 \textbf{Bearbeiten}&
2606 \tabularnewline
2607 \endfirsthead
2608 Neuer Eintrag&
2609 STRG-N\tabularnewline
2610 Neuer Eintrag -- Article&
2611 STRG-SHIFT-A\tabularnewline
2612 Neuer Eintrag -- Book&
2613 STRG-SHIFT-B\tabularnewline
2614 Neuer Eintrag -- Phdthesis&
2615 STRG-SHIFT-T\tabularnewline
2616 Neuer Eintrag -- Inbook&
2617 STRG-SHIFT-I\tabularnewline
2618 Neuer Eintrag -- Mastersthesis&
2619 STRG-SHIFT-M\tabularnewline
2620 Neuer Eintrag -- Proceedings&
2621 STRG-SHIFT-P\tabularnewline
2622 Neuer Eintrag -- Unpublished&
2623 STRG-SHIFT-U\tabularnewline
2624 Neuer Eintrag aus Klartext&
2625 STRG-SHIFT-N\tabularnewline
2626 Eintrag bearbeiten&
2627 STRG-E\tabularnewline
2628 \bibtex{}-Keys generieren&
2629 STRG-G\tabularnewline
2630 Rückgängig&
2631 STRG-Y\tabularnewline
2632 Wiederholen&
2633 STRG-Z\tabularnewline
2634 Ausschneiden&
2635 STRG-X\tabularnewline
2636 Kopieren&
2637 STRG-C\tabularnewline
2638 Einfügen&
2639 STRG-V\tabularnewline
2640 Löschen&
2641 Entf\tabularnewline
2642 Alles auswählen&
2643 STRG-A\tabularnewline
2644 \texttt{\textbackslash{}cite\{BibTeX-Key\}} kopieren&
2645 STRG-K\tabularnewline
2646 Einträge markieren&
2647 STRG-M\tabularnewline
2648 Markierung löschen&
2649 STRG-SHIFT-M\tabularnewline
2650 Präambel bearbeiten&
2651 STRG-P\tabularnewline
2652 Strings bearbeiten&
2653 STRG-T\tabularnewline
2654 \end{longtable}
2655
2656 \begin{longtable}{p{66mm}p{33mm}}
2657 \textbf{Ansicht / Navigation (Forts.)}&
2658 \tabularnewline
2659 \endhead
2660 \textbf{Ansicht / Navigation}&
2661 \tabularnewline
2662 \endfirsthead
2663 Zur nächsten geöffneten Datei springen&
2664 STRG-Bild ab\tabularnewline
2665 Zum vorherigen TAB springen&
2666 STRG-Bild auf\tabularnewline
2667 Gruppendialog ein-/ausblenden&
2668 STRG-SHIFT-G\tabularnewline
2669 Eintragsvorschau ein-/ausblenden&
2670 STRG-F9\tabularnewline
2671 Layout der Eintragsvorschau wechseln&
2672 F9\tabularnewline
2673 \end{longtable}
2674
2675 \begin{longtable}{p{66mm}p{33mm}}
2676 \textbf{Externe Programme / Internet (Forts.)}&
2677 \tabularnewline
2678 \endhead
2679 \textbf{Externe Programme / Internet}&
2680 \tabularnewline
2681 \endfirsthead
2682 Literaturangaben in \LyX einfügen&
2683 STRG-L\tabularnewline
2684 Literaturangaben in WinEdt einfügen&
2685 STRG-SHIFT-W\tabularnewline
2686 URL/DOI öffnen&
2687 F3\tabularnewline
2688 PDF/PS öffnen&
2689 F4\tabularnewline
2690 PDF-Links synchronisieren&
2691 SHIFT-F4\tabularnewline
2692 PS-Links synchronisieren&
2693 STRG-F4\tabularnewline
2694 Medline abrufen&
2695 F5\tabularnewline
2696 CiteSeer abrufen&
2697 F6\tabularnewline
2698 Literaturangaben von CiteSeer abrufen&
2699 F7\tabularnewline
2700 \end{longtable}
2701
2702 \begin{longtable}{p{66mm}p{33mm}}
2703 \textbf{Extras / Sonstiges (Forts.)}&
2704 \tabularnewline
2705 \endhead
2706 \textbf{Extras / Sonstiges}&
2707 \tabularnewline
2708 \endfirsthead
2709 Suchen&
2710 STRG-F\tabularnewline
2711 Weitersuchen&
2712 STRG-SHIFT-F\tabularnewline
2713 Suchen \& Ersetzen&
2714 STRG-R\tabularnewline
2715 Hilfe&
2716 F1\tabularnewline
2717 \end{longtable}
2718
2719 \clearpage 
2720 \section{Häufige Fragen und Antworten}\label{sec:faq}
2721 %\secttoc
2722
2723 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:
2724 \begin{enumerate}
2725         \item Durchsuchen Sie die \href{http://sourceforge.net/forum/?group_id=92314}{Foren} auf der Projektseite bei Sourceforge.
2726         \item Durchsuchen Sie das \href{http://sourceforge.net/mailarchive/forum.php?forum_name=jabref-users}{Archiv} der \jabref-Mailingliste.
2727         \item Stellen Sie Ihre Frage in einem der Foren oder auf der \href{http://sourceforge.net/mail/?group_id=92314}{\jabref-Mailingliste}.
2728 \end{enumerate}
2729
2730 \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.}
2731
2732 \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:
2733 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.
2734 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}.
2735 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.}
2736
2737 \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.}
2738
2739 \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.}
2740
2741 \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.
2742
2743 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}"<).}
2744
2745 \clearpage 
2746 \section{Entwicklung}
2747 \secttoc
2748 \bigskip
2749
2750 \noindent \jabref ist ein \emph{Open Source} Projekt, das heißt, dass jede(r)
2751 dazu beitragen kann, das Programm zu verbessern und weiterzuentwickeln.
2752 Wenn Sie Anregungen, Wünsche oder Fragen haben, ist die erste Anlaufstelle
2753 die \href{http://sourceforge.net/projects/jabref/}{Projektseite bei \emph{Sourceforge}}.
2754 Dort gibt es Foren, in denen Sie Ihre Fragen stellen können, und eine
2755 Mailingliste rund um \jabref. Auch Ihre Wünsche \emph{(Feature
2756 Requests)} und Fehlermeldungen \emph{(Bug Reports)} können Sie dort
2757 loswerden. Um sich direkt als Entwickler einzubringen, wenden Sie
2758 sich an einen der beiden Maintainer (Morten O. Alver und Nizar N.
2759 Batada)~-- die E-Mail-Adressen finden Sie auf der Projektseite bei
2760 \emph{Sourceforge}. Sie brauchen lediglich einen Sourceforge-Login,
2761 der dann für das Projekt freigeschaltet werden kann.
2762
2763
2764 \subsection{Beschränkungen und bekannte Probleme (Bugs)}
2765
2766 \begin{quote}
2767 \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.}
2768 \end{quote}
2769
2770 \subsection{Danksagung}
2771
2772 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.
2773
2774 Seit den Anfängen als \emph{BibKeeper} (von Morten O.~Alver) und \emph{JBibtexManager} (von Nizar N.~Batada) haben
2775 zahlreiche Personen dazu beigetragen, dass \jabrefversion{} zu dem
2776 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.
2777
2778 \subsection{Lizenz}
2779
2780 \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.
2781
2782 \appendix
2783 \newpage
2784 \nocite{*}
2785 \hypertarget{bibliography}{}
2786 \bibliographystyle{jurabib}
2787 \bibliography{JabRef-UserManual_de}
2788
2789
2790 \newpage
2791 \addsec{Versionsgeschichte}
2792
2793 \label{RevisionHistory}
2794
2795 %\begin{revhist}{\versiondate}%endgültiges Datum}
2796 %\item Änderung
2797 %\end{revhist}
2798
2799 \begin{revhist}{\versiondate}%endgültiges Datum}
2800 \item Kleine Änderungen
2801 \end{revhist}
2802
2803 \begin{revhist}{8.\,6.\,2007}
2804 \item Abschnitt ">Import und Export"< in zwei Abschnitte unterteilt
2805 \item Abschnitt \nameref{sec:faq} ergänzt
2806 \item Abschnitte \nameref{EntryEditorHelp} und \nameref{subsec:System-Voraussetzungen} angepasst
2807 \item Fehler im Abschnitt \nameref{PreviewHelp} korrigiert
2808 \item Versionsnummer angepasst
2809 \item Beschreibung der Felder ">doi"< und ">eid"< hinzugefügt
2810 \item Fehler im Link zum Mail-Archiv beseitigt
2811 \item Einleitung leicht ergänzt
2812 \item Generelle Überarbeitung des Dokuments
2813 \end{revhist}
2814
2815 \begin{revhist}{18.\,4.\,2007}
2816 \item Abschnitte \nameref{LabelPatterns}, \nameref{par:Feldformatierer} und \nameref{StringEditorHelp} aktualisiert
2817 \item Fehler in Abschnitt \nameref{subsec:Starten-Kommandozeile} entfernt
2818 \item \jabref-Logo geändert
2819 \item Ein paar Kleinigkeiten
2820 \end{revhist}
2821
2822 \begin{revhist}{20.\,3.\,2007}
2823 \item Abschnitt \nameref{subsubsec:Hinzufuegen-Exportfilter} angepasst
2824 \item Kleinere Änderungen
2825 \end{revhist}
2826
2827 \begin{revhist}{1.\,2.\,2007}
2828 \item Abschnitte \nameref{EndnoteFilters}, \nameref{subsubsec:endnote-jabref}, \nameref{subsec:about} und \nameref{sec:faq} überarbeitet
2829 \item Literaturverzeichnis um Eintrag von \cite{btxfaq} ergänzt
2830 \item Und noch ein paar kleine Änderungen
2831 \end{revhist}
2832
2833 \begin{revhist}{19.\,1.\,2007}
2834 \item Abschnitt ">\nameref{Eintragstypen}"< hinzugefügt
2835 \item Grafik auf Titelseite ausgetauscht
2836 \item Ein paar kleinere Änderungen
2837 \end{revhist}
2838
2839 \begin{revhist}{10.\,12.\,2006}
2840 \item Abschnitt ">XMP-Metadaten"< leicht verbessert
2841 \item FAQ zu freien Java-APIs aktualisiert (Suns Java ist jetzt selbst frei)
2842 \item Wie immer: kleinere Änderungen
2843 \end{revhist}
2844
2845 \begin{revhist}{9.\,12.\,2006}
2846 \item Abschnitte ">Weitere Hilfen"< in ">Häufige Fragen und Antworten (FAQ)"< umbenannt
2847 \item FAQs von der Homepage übersetzt und integriert
2848 \item Literaturverzeichnis um Eintrag von \cite{Fenn2006} ergänzt
2849 \item Ein paar kleinere Änderungen
2850 \end{revhist}
2851
2852 \begin{revhist}{30.\,11.\,2006}
2853 \item Abschnitte ">Weitere Hilfen"< hinzugefügt
2854 \end{revhist}
2855
2856 \begin{revhist}{28.\,11.\,2006}
2857 \item Abschnitte ">Abkürzung von Zeitschriftentiteln"<, ">XMP-Metadaten"<, ">IEEExplore"< und ">Externer Zugriff"< hinzugefügt
2858 \item Abschnitte ">Einführung in \bibtex{}"<, ">Das Hauptfenster"<, ">Links zu externen Dateien"< und ">Jabref und Online-Datenbanken"< erweitert
2859 \item Abschnitt ">Suchfunktionen"< aktualisiert
2860 \item Abschnitt ">Entwicklung"< gekürzt
2861 \item Paket ">listings"< eingebunden (ersetzt Umgebung ">lyxcode"<)
2862 \item Typewriter-Schrift \texttt{beramono} eingesetzt
2863 \item Einige kleinere Änderungen
2864 \end{revhist}
2865
2866 \begin{revhist}{30.\,1.\,2006}
2867 \item Abschnitt >>\jabref-Bibliographien in OpenOffice.org benutzen<< aktualisiert
2868 \item Abschnitt zur Erzeugung der \bibtex{}-Keys aktualisiert
2869 \item Neues Kapitel (>>Externe Importfilter<<), geschrieben von Andreas Rudert
2870 \item Einige kleinere Änderungen
2871 \end{revhist}
2872
2873 \begin{revhist}{6.\,12.\,2005}
2874 \item Lizenzbedingungen für das Handbuch hinzugefügt
2875 \item von PDF~1.4 auf PDF~1.2 umgestellt
2876 \item mehrere kleinere Änderungen
2877 \end{revhist}
2878
2879 \begin{revhist}{16.\,11.\,2005}
2880 \item Erstentwurf von Dominik Waßenhoven, basierend
2881 auf dem unveröffentlichten englischen \emph{Initial Draft} von Nizar Batada (20.\,2.\,2004)
2882 und den Hilfeseiten des Programms
2883 \end{revhist}
2884
2885 \end{document}