summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/archaeologie/README.md75
-rw-r--r--Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdfbin0 -> 94943 bytes
-rw-r--r--Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex372
-rw-r--r--Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdfbin308424 -> 535301 bytes
-rw-r--r--Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex3615
5 files changed, 2477 insertions, 1585 deletions
diff --git a/Master/texmf-dist/doc/latex/archaeologie/README.md b/Master/texmf-dist/doc/latex/archaeologie/README.md
index 6a2dfa4b4ce..4a33f15c19a 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/README.md
+++ b/Master/texmf-dist/doc/latex/archaeologie/README.md
@@ -1,54 +1,69 @@
-##########################
-## bibLaTeX-archaeologie ##
-#########################
- [2016/03/17 v1.42]
+bibLaTeX-__archaeologie__
+=======
-archaeologie: biblatex fuer Archaeologen,
-Historiker und Philologen
-(Deutsch, Englisch, Italienisch und Französisch)
-Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
+bibLaTeX-style for archaeologists, historians and philologists.
+---
+_2016/06/06 v2.0_
-Email: lukas@digitales-altertum.de
+Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
-Der Stil setzt die Zitations- und Bibliographievorgaben
-des Deutschen Archäologischen Instituts (DAI) (Stand 2014) um.
-Verschiedene zusätzliche Optionen erlauben das Erscheinungsbild
-jedoch auch zu verändern, um eigenen Vorlieben anzupassen.
+Email: [lukas@digitales-altertum.de](mailto:lukas@digitales-altertum.de)
-********************************************
This citation-style covers the citation and bibliography rules of
-the German Archaeological Institute.
+the __German Archaeological Institute__.
Various options are available to change and adjust
the outcome according to one’s own preferences.
-(German, English, Italian, French)
-********************************************
+(German, English, Italian, French, Spanish)
+
+---
+*Der Stil setzt die Zitations- und Bibliographievorgaben
+des __Deutschen Archäologischen Instituts (DAI)__ (Stand 2014) um.
+Verschiedene zusätzliche Optionen erlauben das Erscheinungsbild
+jedoch auch zu verändern, um eigenen Vorlieben anzupassen.*
+
+---
+
+This style contains:
+documentation:
-Zum Stil gehören:
- archaeologie.pdf
-- archaeologie.cbx
-- archaeologie.bbx
-- archaeologie.dbx
+- archaeologie.tex
+- archaeologie-ger.pdf (*shortdocumentation*)
+- archaeologie-ger.tex
+
+mandatory:
+
+* archaeologie.cbx
+* archaeologie.bbx
+* archaeologie.dbx
+
+language files:
+
- archaeologie-ngerman.lbx
- archaeologie-english.lbx
- archaeologie-french.lbx
- archaeologie-italian.lbx
-- archaeologie-abbrv.bib
-- archaeologie-corpora.bib
+- archaeologie-spanish.lbx
+
+additional lists and bibliographies:
+
+- archaeologie-lstabbrv.bib
+- archaeologie-lstpublishers.bib
+- archaeologie-lstlocations.bib
+- archaeologie-bibcorpora.bib
+- archaeologie-bibancient.bib
This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3
of this license or (at your option) any later version.
-The latest version of this license is in
-http://www.latex-project.org/lppl.txt
-and version 1.3 or later is part of all distributions of LaTeX
+The latest version of this license is in [http://www.latex-project.org/lppl.txt](http://www.latex-project.org/lppl.txt) and version 1.3 or later is part of all distributions of LaTeX
version 2005/12/01 or later.
-***
-This work has the LPPL maintenance status 'maintained'.
+---
+This work has the LPPL maintenance status _maintained_.
+The current maintainer of this work is [Lukas C. Bossert](https://github.com/LukasCBossert).
-The Current Maintainer of this work is Lukas C. Bossert.
-***
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
new file mode 100644
index 00000000000..28e7ea940dc
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
new file mode 100644
index 00000000000..836ed7b3f70
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
@@ -0,0 +1,372 @@
+% archaeologie --%
+% biblatex for archaeologists,
+% historians and philologists
+% Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2005/12/01 or later.
+%!TEX program = xelatex
+\documentclass[a4paper,10pt,ngerman]{ltxdoc}
+\input{archaeologie-preamble.tex}
+\NewEnviron{bibbsp}[1]
+ {\par\medskip\noindent\footnotesize
+ \begin{tikzpicture}
+ \node[inner sep=0pt] (box) {\parbox[t]{1.05\textwidth}{%
+ \hspace{.05\textwidth}\begin{minipage}{.95\textwidth}
+ \BODY
+ \end{minipage}
+ }%
+ };
+ \draw[codeblue,line width=2pt]
+ ( $ (box.north east) + (-5pt,3pt) $ ) -- ( $ (box.north east) + (0,3pt) $ ) -- ( $ (box.south east) + (0,-3pt) $ ) -- + (-5pt,0);
+ \draw[codeblue,line width=2pt]
+ ( $ (box.north west) + (5pt,3pt) $ ) -- ( $ (box.north west) + (0,3pt) $ ) -- ( $ (box.south west) + (0,-3pt) $ ) -- + (5pt,0);
+ \end{tikzpicture}\par\medskip%
+}
+\begin{document}
+ \title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} für Archäologen\footnote{Ebenso geeignet für (Alt-)Philologen und (Alt-)Historiker.
+ Die Entwicklung des Codes findet statt auf \url{https://github.com/LukasCBossert/biblatex-archaeologie}:
+ Anmerkungen und Kritik sind willkommen.
+ Dank an ›moewew‹ und Herbert Voß für ihre Hilfe.
+}\\ --- {\scshape kurzanleitung} --\footnote{Für eine vollständige Anleitung siehe die englische Stilbeschreibung unter \url{http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/archaeologie/archaeologie.pdf}} }
+\author{Lukas C. Bossert\thanks{\url{lukas@digitales-altertum.de}} \and Johannes Friedl}
+\date{Version: 2.0 (2016-06-06)}
+
+
+ \maketitle
+ \begin{abstract}
+\noindent Der Stil setzt die Zitations- und Bibliographievorgaben des Deutschen Archäologischen Instituts (DAI) (Stand 2014) um. Verschiedene zusätzliche Optionen erlauben jedoch, das Erscheinungsbild den eigenen Vorlieben anzupassen. Der Stil ist nicht nur für Dokumente in deutscher Sprache geeignet, sondern unterstützt ebenso die Sprachen Englisch, Italienisch und Französisch. Dieses Dokument ist die deutsche Kurzfassung der englischen Hauptdokumentation, Details findet man dort.
+
+ \end{abstract}
+
+%\begin{multicols}{1}
+ {\parskip=0mm \tableofcontents}
+%\end{multicols}
+\section{Verwendung}
+ \DescribeMacro{archaeologie} Der Name des Stils ist |archaeologie| und wird an entsprechender Stelle geladen.
+
+\begin{lstlisting}
+\usepackage[style=archaeologie,%
+ <@\meta{weitere Optionen}@>]{biblatex}
+\bibliography<@\marg{|bib|-Datei}@>
+\end{lstlisting}
+
+|archaeologie| funktioniert out-of-the-box und lädt hierfür standardmäßig den DAI-Stil im Autor-Jahr-System.
+Um schnell und einfach im DAI-Stil zu zitieren, bedarf es also keiner weiteren Einstellungen und Optionen.
+
+Um den Stil den eigenen Bedürfnissen anzupassen können darüber hinaus verschiedene -- weiter unten beschriebene -- Optionen von |archaeologie| oder \enquote{konventionelle} |biblatex|-Optionen geladen werden.
+
+Wie bei |bib|\LaTeX{} gewohnt werden Zitate über einen der \cs{cite}-Befehle eingebunden, der \cs{printbibliography}-Befehl am Ende des Dokuments oder an gewünschter Stelle gibt eine Liste der verwendeten Bibliographie aus. Da |archaeologie| jedoch unterschiedliche Zitierweisen je Textsorte wie antiker Primärliteratur oder wissenschaftlicher Sekundärliteratur unterstützt, empfiehlt es sich, die Bibliographie dementsprechend aufzuteilen (z.\,B. Antike Quellen, Abkürzungen etc.).
+Einige Möglichkeiten zur Gestaltung der Bibliographie geben wir in \cref{bibliographie}.
+
+Um die externen Bibliographien, die |archaeologie| optional bereitstellt, korrekt einzubinden, ist ein Input-Encoding von Nöten, das unter anderem auch griechische Schriftzeichen enthält.
+Für \LaTeX{} ist ein entsprechendes Encoding z.\,B. über \cs{usepackage[utf8]\{inputenc\}} zu erreichen. \XeLaTeX{} unterstützt Unicode von Hause aus.
+
+\section{Übersicht}
+Im Folgenden stellen wir etwas knapp die Optionen und Einstellungen vor, mit denen der Stil |archaeologie| aufgerufen werden kann. Wer mehr wissen will, sei auf die englische Hauptdokumentation verwiesen.
+
+\DescribeMacro{shorthand} Wegen seiner Wichtigkeit soll das Bibliographiefeld (\emph{Data Field}) |shorthand| gleich zu Beginn Erwähnung finden. Denn das Feld |shorthand|, das universal zu bib\LaTeX{} gehört, eignet sich gerade für spezielle Zitationen jenseits der Standardzitierweise: nach DAI-Richtlinien betrifft das besonders Sigel, Corpora, Nachschlagewerke, Abkürzungen antiker Texte etc. Für einige dieser Zitate muss das Komma zwischen Publikations- und Seitennachweis, das DAI-Zitate standardmäßig enthalten (etwa Hölscher 2001, 143), entfernt werden: z.\,B. RIC V 53 anstelle RIC V, 53. Hierfür stellt |archaeologie| verschiedene Optionen bereit, die in \cref{bib_options} erläutert werden.
+
+\subsection{Paketoptionen (Präambel)}\label{preamble_options}
+
+Die Optionen sind nicht Teil der oben angeführten Standardaktivierung von |archaeologie|, sondern können im Bedarfsfall ausgewählt werden.
+
+Neben den |archaeologie|-Optionen kann man -- quasi auf eigene Gefahr -- noch die konventionellen |biblatex|-Optionen (insbesondere zur Formatierung der Abstände etc. des Literaturverzeichnisses) verwenden. Näheres zu diesen findet man in der Dokumentation von |biblatex|.
+
+\subsubsection{Zusatzbibliographien und Makrolisten}
+
+\DescribeMacro{bibancient} Lädt eine separate Bibliographie,
+in der knapp 600 antike Autoren und Werke gespeichert sind, die direkt im Text zitiert werden können.
+Alle Einträge enthalten |keywords={ancient}|, |options={ancient}|.
+Diese steuern die Zitationsform und ermöglichen nach Textsorten getrennte Bibliographien zu erstellen (s. \cref{bibliographie}).
+
+\DescribeMacro{bibcorpora} Lädt eine separate Bibliographie,
+in der über 40 Corpora fertig zitierfähig gespeichert sind.
+Die Option lädt zusätzlich die Bibliographie |archaeologie-lstabbrv.bib|, deren separate Einbindung durch die Option |lstabbrv| (s. oben) erfolgt.
+Alle Corpora-Einträge enthalten |keywords={corpus}|, |options={corpus}|.
+Diese Einträge steuern die Zitationsform und ermöglichen nach Textsorten getrennte Bibliographien zu erstellen (s. \cref{bib_options} und \ref{bibliographie}).
+
+\DescribeMacro{lstabbrv} Aktiviert die separate Bibliographiedatei |archaeologie-lstabbrv.bib|, mit der man über ein Makro in der eigenen Bibliographie automatisch Zeitschriften oder Reihen nach den DAI-Abkürzungsrichtlinien zitieren kann.
+
+\DescribeMacro{lstlocations} Aktiviert die separate Bibliographiedatei |archaeologie-lstlocations.bib|, mit der man über ein Makro in der eigenen Bibliographie automatisch Städtennamen entsprechend der eingestellten Sprache exonym ausgegeben lassen kann.
+
+\DescribeMacro{lstpublishers} Aktiviert die separate Bibliographiedatei |archaeologie-lstpublishers.bib|, mit der man über ein kurzes Makro automatisch gängige Verlage für die Altertumswissenschaften in den Bibliograhpieeintrag einbinden kann.
+
+\subsubsection{Schreibweise der Autorennamen}
+
+\DescribeMacro{bibfullname} Schreibt die Autoren/Herausgeber mit vollem Namen in die Bibliographie. Standard ist sonst die Abkürzung der Vornamen.
+
+\DescribeMacro{fullnames} Schreibt die Autoren/Herausgeber, die über \cs{citeauthor}\-\marg{bibtex-key} im Fließtext aufgerufen werden, mit vollem Vor- und Nachnamen -- sofern diese im Bibliographieeintrag vorhanden sind.
+
+\DescribeMacro{lastnames} Schreibt die Autoren/Herausgeber, die über \cs{citeauthor}\-\marg{bibtex-key} im Fließtext aufgerufen werden, nur mit Nachnamen (dies entspricht der Autoren-Darstellungweise in Fußnoten).
+
+\DescribeMacro{scshape} Die Namen im Fließtext und in den Fußnoten werden in Kapitälchen gesetzt, ausgenommen sind Werke unbekannter Herkunft und Werke antiker Autoren.
+
+\subsubsection{Zitierweise}
+
+\DescribeMacro{edby} Bei Sammelbänden steht anstatt \enquote{Hrsg.} nun \enquote{hrsg. v.}.
+
+\DescribeMacro{inreferences} Bibliographieeinträge mit |@inreference| werden bei aktivierter Funktion vollreferenziert geschrieben.
+Dies verwirft die vom DAI angegebene, spezielle Lexika-Zitation (LIMC, DNP etc.), die nicht in der Bibliographie aufgeführt werden.
+
+\DescribeMacro{noabbrv} Es werden keine Abkürzungen von Zeitschriften und Serien verwendet. Dazu werden die Felder |shortjournal| und |shortseries| ignoriert. Ihre Pendants |journaltitle| und |series| werden ausgelesen.
+
+\DescribeMacro{publisher} Angabe aller Verlagsorte und des Verlags selbst. Ändert die Formatierung von Auflage (|edition|) und Erstausgabe (|origyear|).
+
+\DescribeMacro{seenote} Gibt bei erster Verwendung zunächst das Vollzitat, im Anschluss dann den Rückverweis auf die Erstnennung aus. Löst damit das Autor-Jahr-System ab.
+
+\DescribeMacro{translation} Anzeige der Angaben des Originaltitels, Übersetzers und der Sprache, aus der übersetzt wurde.
+Keinen Einfluss hat die Wahl auf Bibliographie-Einträge, die |options=ancient| haben.
+Dort wird dies standardmäßig angegeben.
+
+\DescribeMacro{yearseries} Die Reihe wird erst nach der Jahreszahl ausgegeben.
+
+\DescribeMacro{yearinparens} Die Jahreszahl wird in Klammern gesetzt.
+
+\subsubsection{Formale Bibliographieeinstellungen}
+
+\DescribeMacro{width} Mit dieser Option wird in der Bibliographie der Abstand zwischen dem Label (Kurzzitat) und dem Vollzitat nach Belieben gesteuert.
+
+\DescribeMacro{counter} In der Bibliographie wird hinter jedem Eintrag die Anzahl an Zitationen im Fließtext vermerkt.
+
+\subsection{Literaturoptionen (Bibliographieeintrag)}\label{bib_options}
+Zusätzlich kann ein einzelner Bibliographieeintrag durch folgende Werte in seinem |options|-Feld manipuliert werden. Dadurch ändert sich die Zitierweise in Zitat und/oder Bibliographie.
+
+\DescribeMacro{ancient} Zeichnet den Eintrag als antike Quelle aus, verwendet für das Zitat |shorthand| (z.\,B. Apul. met.). Nach dem Shorthand-Zitat folgt kein (sonst obligatorisches) abschließendes Komma; in der Bibliographie wird zudem der Herausgeber/Übersetzer, der Originaltitel und die Sprache, aus der übersetzt wurde, angegeben.
+
+\DescribeMacro{frgancient} Zeichnet den Eintrag als antikes Fragment aus. Entspricht der Option |ancient|, unterscheidet sich nur darin, dass anstelle des Autors der Herausgeber im Zitat angeführt wird. Die Option kann man dann für antike Texte verwenden, wenn z.\,B. die Autorschaft des Textes/der Fragmente unbekannt ist oder es allgemeiner Usus ist, den Herausgeber anstelle des Autors zu zitieren.
+
+\DescribeMacro{corpus} Auch hier wird das |shorthand|-Feld ohne abschließendes Komma ausgegeben.
+Wichtig für beispielsweise Inschriften- oder Münzcorpora (CIL, AE, RIC, etc.).
+
+\changes{v1.1}{2015/06/04}{Neue Optionen in Zusammenfassung ergänzt.}
+
+
+\subsection{Zitierbefehle}\label{cite_commands}
+\DescribeMacro{\cite} Die einfachste Art zu zitieren ist der Befehl \cs{cite}:
+\begin{lstlisting}
+\cite<@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@>
+\end{lstlisting}
+
+Dabei ist \meta{prenote} eine einleitende Bemerkung (z.\,B. \enquote{Vgl.}), \meta{postnote} enthält für gewöhnlich die Seitenzahl.
+Wird nur ein optionales Argument gegeben, so ist das die Seitenzahl:
+\begin{lstlisting}
+\cite<@\oarg{postnote}\marg{bibtex-key}%@>
+\end{lstlisting}
+
+\meta{bibtex-key} ist der Schlüssel des Bibliographieeintrags aus der |bib|-Datei (\emph{entrykey}).
+
+\DescribeMacro{\cites} Möchte man mehrere Autoren/Werke zugleich zitieren, eignet sich am besten der \cs{cites}-Befehl:
+\begin{lstlisting}
+\cites(pre-prenote)(post-postnote)<@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@>%
+ <@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@>%
+ <@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@>
+\end{lstlisting}
+
+\DescribeMacro{\parencite} \DescribeMacro{\parencites} Soll die Literaturangabe (bspw. in den Fußnoten) in Klammern erscheinen, dann empfiehlt sich dies mittels \cs{parencite} zu tun.
+Der Vorteil dieses Befehls gegenüber der händischen Eingabe von Klammern ist, dass der Befehl automatisch Klammerverschachtelungen erkennt und entsprechende Klammerregeln befolgt: demnach werden runde Klammern innerhalb einer Klammerumgebung als eckigen Klammern geschrieben.
+Dies ist vor allem bei Lexikaeinträgen der wichtig: (LIMC 7.1 [1994] 930 Nr. 283 s. v. Theseus [J. Neils]).
+\cs{parencite} und \cs{parencites} verhalten sich in der Bedienung analog zu \cs{cite} und \cs{cites}.
+
+\DescribeMacro{\textcite} \DescribeMacro{\textcites} Zu den bisher aufgeführten \cs{cite}-Befehlen gibt es zusätzlich die Möglichkeit, einen Eintrag \enquote{fließtextgerecht} mit \cs{textcite} zu zitieren.
+Der Unterschied zu \cs{cite} besteht darin, dass der Literaturverweis durch Klammern vom Autor getrennt wird: z.\,B. Emme (2013, 5).
+\cs{textcite} und \cs{textcites} verhalten sich in der Bedienung analog zu \cs{cite} und \cs{cites}.
+
+\DescribeMacro{\citeauthor} \DescribeMacro{\citetitle} Diese Befehle ermöglich, nur einzelne Elemente einer Publikation zu zitieren. Je nach Verwendung wird entweder nur der Titel oder der Autor eines Bibliographieeintrages ausgegeben. Ein Vorteil gegenüber des händischen Eintippens eines solchen Elementes ist, dass der Eintrag indiziert und referenziert wird. Dies kann z.\,B. für einen (Autoren-)Index, der auf die Textstelle verweisen soll, relevant sein.
+
+
+\section{Publikationstypen}
+Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry Type}) und ihre von |archaeologie| ausgelesenen Felder (\emph{Data Field}) aufgelistet.
+
+\DescribeMacro{@article} Für Artikel aus periodischen Zeitschriften.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|, |title|, |subtitle|, |titleaddon|, |pages|, |journaltitle|, |shortjournal|, |volume|, |number|, |year|
+\item[Optional:] |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+\printbib[8em]{Ball2013}
+
+
+\DescribeMacro{@book} \DescribeMacro{@collection} Für Monographien und Sammelbände.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|/|editor|, |title|, |subtitle|, |titleaddon|, |location|, |year|
+\item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+\printbib[7em]{Fentress2003}
+
+
+\DescribeMacro{@inbook} \DescribeMacro{@incollection} Für Beiträge innerhalb eines Sammelbandes.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|, |editor|, |title|, |subtitle|, |titleaddon|, |location|, |year|, |pages|, |booktitle|, |booksubtitle|, |booktitleaddon|
+\item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+\printbib[5em]{Mundt2015}
+
+
+\DescribeMacro{@proceedings} Für Konferenz-/Kolloquiumssammelbände, bei denen ein Datum angegeben ist.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|/|editor|, |title|, |subtitle|, |titleaddon|, |location|, |year|, |eventdate|, |eventtitle|, |venue|
+\item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+\printbib[7em]{Kurapkat2014}
+
+
+\DescribeMacro{@inproceedings} Für Beiträge innerhalb eines Konferenz-/Kolloquiumssammelbandes, bei denen ein Datum angegeben ist.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|, |editor|, |title|, |subtitle|, |titleaddon|, |location|, |year|, |pages|, |booktitle|, |booksubtitle|, |booktitleaddon|, |eventdate|, |eventtitle|, |venue|
+\item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+\printbib[7em]{Wulf-Rheidt2013}
+
+
+\DescribeMacro{@talk} Für (mündliche) Vorträge (Kolloquium, Konferenz)
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|, |title|, |subtitle|, |titleaddon|, |date|, |venue|, |institution|, |eventtitle|, |eventdate|
+\item[Optional:] |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|
+\end{description}
+
+\printbib[6em]{Bergmann2015}
+
+
+\DescribeMacro{@review} Für Rezensionen.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|, |title|, |subtitle|, |titleaddon|, |pages|, |journaltitle|, |shortjournal|, |volume|, |number|, |year|, |related|, |relatedtype|
+\item[Optional:] |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+\printbib[5em]{Taylor2008}
+
+
+\DescribeMacro{@reference} Für Lexika als Gesamtwerk.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |editor|, |title|, |subtitle|, |titleaddon|, |location|, |year|
+\item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|,
+|publisher|, |series|, |number|, |edition|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+\printbib{LTUR}
+
+
+\DescribeMacro{@inreference} Für Beiträge innerhalb eines Lexikon.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|, |title|, |subtitle|, |titleaddon|, |location|, |year|, |pages|, |volume|, |booktitle|, |booksubtitle|, |booktitleaddon|
+\item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|,
+|publisher|, |series|, |number|, |edition|, |origyear|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+\printbib[5em]{Nieddu1995}
+
+
+\DescribeMacro{@thesis} Für (unpublizierte) eingereichte Dissertationen oder Master/Magisterarbeiten.
+\begin{description}[topsep=0pt]
+\item[Notwendig:] |author|, |title|, |subtitle|, |titleaddon|, |location|, |year|, |institution|, |type|,
+\item[Optional:] |publisher|, |series|, |number|, |edition|, |origyear|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
+\end{description}
+
+Für eine Dissertation: |type = {phdthesis}|, \\ für eine Magister/Masterarbeit: |type={mathesis}|.
+
+\printbib[5em]{Arnolds2005}
+
+
+\section{Bibliographie}\label{bibliographie}
+\DescribeMacro{\printbibliography}
+Wie bei jedem Text mit zitierten Werken bedarf es einer Stelle, an der diese auch aufgeschlüsselt werden: die Bibliographie.
+Für Altertumswissenschaftler (und auch andere) ist es manchmal hilfreich, verschiedene Bibliographien im Dokument zu haben, die unterschiedliche Arten von Werken beinhalten, bspw. ein Quellenverzeichnis, Abkürzungen und Forschungsliteratur.
+
+Nachfolgend wird gezeigt, wie einem eine solche Bibliographieaufteilung mit |archaeologie| leicht gelingt. Dafür nutzen wir das |keyword|-Feld eines Bibliographieeintrages. Für jeden Bibliographietyp wählen wir eine Kategorie. Zunächst versehen wir in der |bib|-Datei alle antiken Texte, die bereits |options={ancient}| oder |options={frgancient}| enthalten sollten, mit dem Feld |keyword={ancient}|. Das gleiche machen wir für alle Publikationen, die spezielle Abkürzungen haben: Corpora, Lexika und Handbücher. Diese erhalten |keyword={corpus}|. Anschließend können wir antike Primärliteratur und abgekürzte Sigel/Corpora von sekundärer Forschungliteratur getrennt bibliographieren. Bib\LaTeX{} bietet hierfür eine einfache Filtermöglichkeit mit den Optionen |keywort=…| und |notkeyword=…| im \cs{printbibliography}-Befehl:
+
+\begin{lstlisting}
+\printbibheading[%
+ heading=bibliography,
+ title={Bibliographie}]% Überschrift für Bibliographie
+
+\printbibliography[%
+ heading=subbibliography,
+ keyword=ancient,%
+ title={Antike Quellen}]
+
+\printbibliography[%
+ heading=subbibliography,
+ keyword=corpus,%
+ title={Abkürzungen und Sigel}]
+
+\printbibliography[%
+ heading=subbibliography,
+ notkeyword=ancient,%
+ notkeyword=corpus,%
+ title={Forschungsliteratur}]
+\end{lstlisting}
+
+Mithilfe des |keyword|-Filters haben wir in den ersten beiden \cs{printbibliography}-Befehlen die entsprechende Literatur ausgewählt, im letzten \cs{printbibliography}-Befehl, der die \enquote{Restliteratur} auslesen soll, müssen dann alle zuvor verwendeten Filterbegriffe mithilfe eines Ausschlussverfahrens über |notkeyword| eingetragen werden: Die Forschungsliteratur beinhaltet also alle Publikationen, die nicht |ancient| und nicht |corpus| sind.
+
+Die Optionen |heading=bibliography| und |heading=subbibliography| entscheiden über die Gliederung der Bibliographien untereinander. Mit der hier gewählten Einstellung erhalten wir demnach unnummerierte Unterbibliographien. Das Ergebnis der Zeilen könnte etwa so aussehen:
+
+\begin{refsection}
+\nocite{Cic:Att,Fest,%
+Ball2013,Taylor2008,Mann2011,Mundt2015,Kurapkat2014,%
+Wulf-Rheidt2013,Bergmann2015,LTUR,Nieddu1995,Arnolds2005}
+
+\setcounter{section}{0}
+\begin{bsp}
+\renewcommand\bibfont{\normalfont\footnotesize}
+\printbibheading[%
+ heading=bibliography,
+ title={Bibliographie}]% Überschrift für Bibliographie
+
+\printbibliography[%
+ heading=subbibliography,
+ keyword=ancient,%
+ title={Antike Quellen}]
+
+\printbibliography[%
+ heading=subbibliography,
+ keyword=corpus,%
+ title={Abkürzungen und Sigel}]
+
+\printbibliography[%
+ heading=subbibliography,
+ notkeyword=ancient,%
+ notkeyword=corpus,%
+ title={Forschungsliteratur}]
+\end{bsp}
+
+Mit dem eben beschriebenen Verfahren können mit beliebigen |keyword|-Begriffen beliebige Bibliographien über \cs{printbibliography} erstellt werden, die jeweils unterschiedliche Einträge haben können.
+
+Ebenso hilfreich kann es sein, Abkürzungen von Zeitschriften und Reihen aufzulösen. Bib\LaTeX{} liest hierfür die im Feld |shortjournal| bzw. |shortseries| hinterlegten Abkürzungen aller Bibliographieeinträge aus und löst sie durch die Inhalte der Felder |journaltitle| bzw. |series| auf. Hierzu müssen die Felder jedoch beide befüllt sein: ein |shortjournal|-Eintrag ohne |journaltitle|-Entsprechung wird nicht indiziert und folglich in der Liste fehlen.
+
+Die Abkürzungsliste erhält man für Zeitschriften mit:
+\begin{lstlisting}
+\printbiblist[%
+ heading=subbibliography,
+ title={Zeitschriftenabkürzungen}%
+ ]{shortjournal}
+\end{lstlisting}
+
+\begin{bsp}
+\printbiblist[ heading=subbibliography,
+title={Zeitschriftenabkürzungen}]{shortjournal}
+\end{bsp}
+
+und für Reihen mit:
+\begin{lstlisting}
+\printbiblist[%
+ heading=subbibliography,
+ title={Reihenabkürzungen}%
+ ]{shortseries}
+\end{lstlisting}
+
+\begin{bsp}
+\printbiblist[ heading=subbibliography,
+title={Reihenabkürzungen}]{shortseries}
+\end{bsp}
+\end{refsection}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
index b5c6a3b293e..e0a0dc744bf 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
index b7a287e0912..d1a11e5338d 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
@@ -1,5 +1,6 @@
% archaeologie --%
-% biblatex fuer Archaeologen, Historiker und Philologen
+% biblatex for archaeologists,
+% historians and philologists
% Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
%
% This work may be distributed and/or modified under the
@@ -9,1854 +10,2359 @@
% http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
-
+%!TEX program = xelatex
\documentclass[a4paper,
10pt,
greek,
french,
-italian, %ngerman,
-english,
-ngerman
+spanish,
+italian,
+ngerman,
+english
]{ltxdoc}
-\CodelineNumbered
-\AtBeginDocument{\RecordChanges}
-\AtEndDocument{\PrintChanges}
- \usepackage[T1,LGR]{fontenc} % font types and character verification
-\usepackage{ebgaramond}
- \usepackage{metalogo}
- \usepackage{hologo}
- \usepackage{babel}
-\usepackage{coolthms}
-\usepackage[ % advanced quotes
- strict=true, % - warning are errors now
- style=ngerman, % - german quotes
-]{csquotes}
-\usepackage{multicol}
-\setlength{\columnsep}{1.5cm}
-\setlength{\columnseprule}{0.2pt}
-\usepackage{framed}
-\usepackage{enumitem}
-\setlength{\parindent}{0pt}
-\setlength{\parskip}{6pt plus 2pt minus 2pt}
-\setenumerate[1]{label=(\alph*),leftmargin=*,nolistsep,parsep=\parskip}
-\usepackage{changepage}
-
-\makeindex
-
-\newenvironment{bsp}{\begin{framed}\begin{small}
-\begin{adjustwidth}{1cm}{1cm}}{\end{adjustwidth}
-\end{small}\end{framed}}
-
-
-\listfiles
-\EnableCrossrefs
-\CodelineIndex
-\RecordChanges
-
-
- \usepackage[disable]{todonotes} % notes not showed
-
-
+\input{archaeologie-preamble.tex}
+\NewEnviron{bibbsp}[1]
+ {\par\medskip\noindent\footnotesize
+ \begin{tikzpicture}
+ \node[inner sep=0pt] (box) {\parbox[t]{\textwidth}{%
+ \begin{minipage}{.07\textwidth}
+ \hspace{.5em}\scriptsize \textbf{\Cref{#1}}\hfill
+ \end{minipage}%
+ \begin{minipage}{.9\textwidth}
+ \BODY
+ \end{minipage}\hfill}%
+ };
+ \draw[codeblue,line width=2pt]
+ ( $ (box.north east) + (-5pt,3pt) $ ) -- ( $ (box.north east) + (0,3pt) $ ) -- ( $ (box.south east) + (0,-3pt) $ ) -- + (-5pt,0);
+ \draw[codeblue,line width=2pt]
+ ( $ (box.north west) + (5pt,3pt) $ ) -- ( $ (box.north west) + (0,3pt) $ ) -- ( $ (box.south west) + (0,-3pt) $ ) -- + (5pt,0);
+ \end{tikzpicture}\par\medskip%
+}
-\usepackage[ % use for bibliography
- backend=biber,
- style=archaeologie,
-% eprint=false,
-% doi=false,
-% url=false,
-%inreferences,
- %translation,
- %bibfullname,
- %noabbrevs,
- %publisher,
- %edby,
- %yearseries,
-%yearinparens,
- %lastnames,
- %fullnames,
-% scshape,
-% width=6em,
-%counter,
-strings,
- %%%%%%%%%%%%%%%%%%%%%%%
-]{biblatex}
-
-
-\addbibresource{archaeologie.bib}
-%\addbibresource{antike-corpora.bib} %Version 2.0
-\renewcommand\bibfont{\normalfont\small}
-
-
-
-\usepackage{listings}
-\lstMakeShortInline[basicstyle=\small\ttfamily]{|}
-
-\hypersetup{ colorlinks = true, %Colours links instead of ugly boxes
- urlcolor = blue, %Colour for external hyperlinks
- linkcolor = black, %Colour of internal links
- citecolor = blue, %Colour of citations
- }
\begin{document}
-% \DocInput{archaeologie.dtx}
-
-%\MakeShortVerb{\|}
- \newenvironment{syntax}{\begin{small}\medskip\hspace*{2em}}{\par\medskip\end{small}}
- %\def\verbatimchar{;}
-
-
-
- \title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} for archaeologists\footnote{Also very handy as well for (ancient) History or Classics.
-The development of the code is done at \url{https://github.com/giovannotti/biblatex-archaeologie}:
-Comments and critics are welcome.
-We thank ›moewew‹ und Herbert Voß for their big help on the code.
-} }
- \author{Lukas C. Bossert\thanks{\url{lukas@digitales-altertum.de}} \and Johannes Friedl}
- \date{Version: 1.42 (2016-03-17)}
-
-
+\title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} for archaeologists\footnote{Also very handy as well for (ancient) History or Classics.
+The development of the code is done at \url{https://github.com/LukasCBossert/biblatex-archaeologie}:
+Comments and critics are welcome.
+We thank ›moewew‹ and Herbert Voß for their big help on the code.%
+}}
+\author{Lukas C. Bossert\thanks{\href{mailto:lukas@digitales-altertum.de}{lukas@digitales-altertum.de}} \and Johannes Friedl}
+\date{Version: 2.0 (2016-06-06)}
\maketitle
\begin{abstract}
- \begin{multicols}{2}
-\noindent \foreignlanguage{english}{This citation-style covers the citation and bibliography rules of the German Archaeological Institute. Various options are available to change and adjust the outcome according to one's own preferences.
-The style is compatible with the English, Italian and French languages, since all |bibstrings| used are defined in each language.}\columnbreak\\
-\noindent Der Stil setzt die Zitations- und Bibliographievorgaben des Deutschen Archäologischen Instituts (DAI) (Stand 2014) um. Verschiedene zusätzliche Optionen erlauben das Erscheinungsbild jedoch auch zu verändern, um eigenen Vorlieben anzupassen.
-Der Stil ist nicht nur für Dokumente in deutscher Sprache geeignet, sondern wurde ebenso für die Sprachen Englisch, Italienisch und Französisch angepasst.
+\noindent This citation-style covers the citation and bibliography rules of the German Archaeological Institute.
+Various options are available to change and adjust the outcome according to one's own preferences.
+The style is compatible with the English, German, Italian, Spanish and French languages, since all |bibstrings| used are defined in each language.
- \end{multicols}
+For a short introduction in German see \url{http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/archaeologie/archaeologie-ger.pdf}
\end{abstract}
-\section{Letzte Änderungen}
-Änderungen seit Version 1.4
-\begin{itemize}
-\item Verbesserung der |\textcite|-Befehle
-\item Vereinheitlichung des Abstands zwischen Label und Bibliographieeintrag (s. \cref{width}).
-\item Optionales An- oder Abschalten der extra Bibliographie |archaeologie-abbrv.bib| (s. \cref{strings}).
-\item Anpassung an |biblatex 3.3|, was dazu führte, dass alle gängigen |\cite|-Befehle verwendet werden können.
-\item Umstellung der Optionsnamen auf englische Bezeichnungen (s. \cref{preamble_options}).
-\item Hinzufügen der Paketoption |counter| (s. \cref{counter}).
-\end{itemize}
-\changes{v2.0}{2015/11/10}{Ergänzung: Feld |number| bei |@inreference| wird jetzt ausgelesen.}
-\newpage
\begin{multicols}{2}
-{\parskip=0mm \tableofcontents}
+\footnotesize\parskip=0mm \tableofcontents
\end{multicols}
-\section{Verwendung}
- \DescribeMacro{archaeologie} Der Name des Stils ist |archaeologie| und wird an entsprechender Stelle geladen.
+\section{Installation}
+|archaeologie| is part of the distributions MiK\TeX \footnote{Website: \url{http://www.miktex.org}.}
+and \TeX Live\footnote{Website: \url{http://www.tug.org/texlive}.}~-- thus, you
+can easily install it using the respective package manager.
+If you would like to
+install |archaeologie| manually, do the following:
+Download the folder |archaeologie| with all relevant files from the CTAN-server\footnote{\url{http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/archaeologie.zip}} and copy it to the \texttt{\$LOCALTEXMF} directory of
+ your system.\footnote{If you don't know what that is, have a look at
+\url{http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds} or
+\url{http://mirror.ctan.org/tds/tds.html}.}
+Refresh your filename database.\footnote{
+Here is some additional information from the UK \TeX\ FAQ:
+\begin{itemize}[nosep,after=\vspace{-\baselineskip} ]
+ \item \href{%
+ http://www.tex.ac.uk/cgi-bin/texfaq2html?label=install-where}{%
+ Where to install packages}
+ \item \href{%
+ http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-wlcf}{%
+ Installing files \enquote{where \LaTeX /TeX\ can find them}}
+ \item \href{%
+ http://www.tex.ac.uk/cgi-bin/texfaq2html?label=privinst}{%
+ \enquote{Private} installations of files}
+\end{itemize}
+}
+%%introduction from biblatex-dw copied and applied. might to be rewritten.
+
+\section{Usage}
+ \DescribeMacro{archaeologie} The name of the bib\LaTeX-style is |archaeologie| has to be activated in the preamble.
+
+\begin{lstlisting}
+\usepackage[style=archaeologie,%
+ *@\meta{further options}@*]{biblatex}
+\bibliography*@\marg{|bib|-file}@*
+\end{lstlisting}
+
+Without any further options the style covers now the rules of the German Archaeological Institute. No additional settings are needed.
+But you can change the outcome by using some options which are explained below.\footnote{For an easy and unproblematic compiling we suggest to use \hologo{XeLaTeX} or \hologo{LuaTeX}.}
+
+At the end of your document you can write the command |\printbibliography| to print
+the bibliography.
+Since |archaeologie| supports different citations of various texts like from ancient authors and from modern scholars we suggest to have them listed in separated bibliographies.
+Further information are found below (\cref{bibliographie}).
+
+\section{Overview}\label{overview}
+Following there is a quick overview of possible options of the style |archaeologie|.
+Contrary to the alphabetically ordered description later (\cref{options-description}) they here are listed by topic.
+Furthermore you can -- at your own risk -- also use the conventional |bib|\LaTeX-options which are related of indent, etc.
+For that please see the excellent documentation of |bib|\LaTeX.
+
+\subsection{Preamble options}\label{preamble_options}
+\subsubsection{Additional bibliographies and macro lists}
+\DescribeMacro{bibancient}A separate bibliography-file is loaded, in which round about
+600 ancient authors and works are listed and can be cited right away cf. \cref{bibancient}.
+
+\DescribeMacro{bibcorpora}
+A separate bibliography-file is loaded, in which the common corpora for ancient studies are stored cf. \cref{bibcorpora}.
+Additionally this activates the bibliography |archaeologie-lstabbrv.bib|.
+
+\DescribeMacro{lstabbrv}
+Activates the additional bibliography file |archaeologie-lstabbrv.bib|.
+It provides a list of journals and series according to the abbreviations of the
+German Archaeological Institute which can be used as |@String| macros in bibliography entries cf. \cref{abbrv}.
+
+\DescribeMacro{lstlocations}
+Activates the additional bibliography file |archaeologie-lstlocations.bib|
+with |@String| macros of locations which can be used to automatically print out their correct exonym in the selected language cf. \cref{lstlocations}.
+
+\DescribeMacro{lstpublishers}
+Activates the additional bibliography file |archaeologie-lstpublishers.bib| with |@String| macros
+of several publishers which can be used to easily print out their names cf. \cref{lstpublishers}.
+
+\subsubsection{Notation of names}
+\DescribeMacro{bibfullname}
+In the bibliography full names of authors and/or editors are shown cf. \cref{bibfullname}.
-\begin{syntax} |\usepackage[style=archaeologie,%|\\
- | |\meta{weitere Optionen}|]{biblatex}|\\
- |\bibliography|\marg{|bib|-Datei}\end{syntax}
-
-Dabei kann man weitere der \enquote{konventionellen} |biblatex|-Optionen oder der -- weiter unten beschriebenen -- von |archaeologie| zur Verfügung gestellten Optionen laden.
+\DescribeMacro{fullnames}
+Writes only first and family names of authors or editors when they are cited with \cs{citeauthor}\marg{bibtex-key} cf. \cref{fullnames}.
- |archaeologie| lädt standardmäßig den DAI-Stil im Autor-Jahr-System.
- Um schnell und einfach im DAI-Stil zu zitieren, benötigt es keine weiteren Einstellungen und Optionen.
+\DescribeMacro{initials}
+First names are abbreviated keeping digraphs and trigraphs cf. \cref{initials}.
-Am Ende des Dokuments oder an gewünschter Stelle muss der |\printbibliography|-Befehl stehen, sodass eine Bibliographie angelegt und ausgegeben wird.
- Da |archaeologie| unterschiedliche Zitierweisen von Textsorten wie antiker Primärliteratur oder wissenschaftlicher Sekundärliteratur unterstützt, empfiehlt es sich, die Bibliographieaufteilung dementsprechend anzupassen. Verschiedene Möglichkeiten zur Gestaltung der Bibliographie (\cref{bibliographie}).
+\DescribeMacro{lastnames}
+Writes only family names of authors or editors when they are cited with \cs{citeauthor}\marg{bibtex-key}.
+In footnotes this is default cf. \cref{lastnames}.
-\section{Übersicht}
-Im Folgenden sind kurz die möglichen Optionen, mit denen der Stil |archaeologie| aufgerufen werden kann, aufgeführt.
- Dazu kann man -- quasi auf eigene Gefahr -- noch die konventionellen |biblatex|-Optionen (insbesondere zur Formatierung der Abstände etc. des Literaturverzeichnisses) verwenden. Näheres zu diesen findet man in der Dokumentation von |biblatex|.
+\DescribeMacro{scshape}
+Cited names are shown with small capital letters cf. \cref{scshape}.
+Bibliography entries with |option={ancient}| or |option={frgancient}| (\cref{ancient,frgancient}) are not touched by this option.
- \subsection{Paketoptionen (Präambel)}\label{preamble_options}
- \begin{description}
- \item[strings] Aktiviert die extra Bibliographiedatei |dai-abkuerzungen|, mit der man Zeitschrifen oder Reihen mit entsprechenden Abkürzungen zitieren kann. s. \cref{strings}.
- \item[edby] (zuvor |hrsgv|) Bei Sammelbänden steht anstatt \enquote{Hrsg.} nun \enquote{hrsg. v.}. Siehe \cref{edby}.
+\subsubsection{Manner of citing}
+\DescribeMacro{edby}
+Switches \enquote{ed.}/\enquote{Hrsg.} to \enquote{ed. by}/\enquote{hrsg. v.} cf. \cref{edby}.
-\item[yearseries] (zuvor |jahrreihe|) Die Reihe wird erst nach der Jahreszahl ausgegeben. \cref{yearseries}.
-
- \item[yearinparens] (zuvor |jahrinklammer|) Die Jahreszahl wird in Klammern gesetzt. \cref{yearinparens}.
+\DescribeMacro{inreferences}
+Each bibliography entry which is a |@Inreference| is fully referenced according to the special rules of the
+German Archaeological Institute for manuals and encyclopaedias cf. \cref{inreferences}.
-\item[translation] (zuvor |uebersetzung|) Anzeige der Angaben des Originaltitels, Übersetzers und der Sprache, aus der übersetzt wurde. Bei Einträgen, die |options=antik| haben, ist dies Standard. \cref{translation}.
+\DescribeMacro{noabbrv}
+By default the short titles of journals and series (|shortjournal| and |shortseries|) are shown in the bibliography.
+With this option full titles are printed instead (|journaltitle| and |series|) cf. \cref{noabbrevs}.
-\item[noabbrevs] (zuvor |keineabkuerzung|) Die Abkürzungen von Zeitschriften und Serien (|shortjournal|\linebreak |shortseries|) werden ausgeschrieben, wofür die Felder |journaltitle| und |series| ausgelesen werden. \cref{noabbrevs}.
+\DescribeMacro{publisher}
+All locations and the publisher is shown.
+It also changes the format of the edition and the first print cf. \cref{publisher}.
-\item[publisher] (zuvor |verlag|) Angabe aller Verlagsorte und Verlag selbst. Ändert die Formatierung der Edition und Erstausgabe. \cref{publisher}.
+\DescribeMacro{seenote}
+By default |archaeologie| prints author-year-system.
+With this option you can change it to a different outcome (but still according to the rules of the German Archaeological Institute).
+So the first citation will be a full citation and all the following citations will refer to the first full citation cf. \cref{seenote}
-\item[bibfullname] (zuvor |bibvollername|) Schreibt die Autoren/-Herausgeber mit vollem Namen in der Bibliographie. \cref{bibfullname}.
+\DescribeMacro{translation}
+Original title, translator and original language are shown in the bibliography.
+Setting a bibliography entry to |option={ancient}| this behaviour is default cf. \cref{translation}.
-\item[inreferences] (zuvor |lexika|) Bibliographieeinträge mit |@inreference| werden bei aktivierter Funktion vollreferenziert geschrieben. Siehe \cref{inreferences}.
+\DescribeMacro{yearinparens}
+The year is shown in parens cf. \cref{yearinparens}.
-\item[lastnames] (zuvor |nurnachname|) Schreibt die Autoren/-Herausgeber, die über |citeauthor|\-\marg{key} im Fließtext aufgerufen werden, nur mit Nachnamen (= Erscheinen in Fußnoten). \cref{lastnames}.
+\DescribeMacro{yearseries}
+Switches the order of series and year cf. \cref{yearseries}.
+
+\subsubsection{Global bibliography settings}
-\item[fullnames] (zuvor |vollername|) Schreibt die Autoren/-Herausgeber, die über |citeauthor|\-\marg{key} im Fließtext aufgerufen werden, mit vollem Vor- und Nachnamen -- sofern diese im Bibliographieeintrag vorhanden sind. \cref{fullnames}.
+\DescribeMacro{width}
+|width={value}| defines the bibliography width between label and reference cf. \cref{width}.
+
+\DescribeMacro{counter}
+Reveals at the end of each reference a summary of citations in the text cf. \cref{counter}.
+
+\subsection{Entry Options}
+A single bibliography entry can contain a value in its |options|-field.
+Depending on the option it changes the behaviour how that entry is cited cf. \cref{options-bibentry,beispiele}.
+Beside their distinct properties all of these options have in common that the separating comma between citation and page record is missing.
+Actually this concerns citation of ancient texts and corpora where usually the |shorthand|-field is printed in citations.
+
+\DescribeMacro{ancient}
+The entry is an ancient source (e.\,g. Cicero, Plutarch, etc) cf. \cref{ancient}.
+
+\DescribeMacro{frgancient}
+The entry is a fragmented ancient source (e.\,g. Festus) cf. \cref{frgancient}.
+
+\DescribeMacro{corpus}
+Only the |shorthand|-field is printed.
+This is needed especially for corpora of inscriptions or coins (CIL, AE, RIC, etc.) cf. \cref{corpus}.
+
+\changes{v1.1}{2015/06/04}{New options added in summary.}
+
+\subsection{Cite commands}\label{cite-commands}
+\DescribeMacro{\cite}%
+As always citing is done with \cs{cite}:
+\begin{lstlisting}
+\cite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
+\end{lstlisting}
+
+\meta{prenote} sets a short preliminary note (e.\,g. \enquote{Vgl.}) and \meta{postnote} is usually used for page numbers.
+If only one optional argument is used then it is \oarg{postnote}.
+\begin{lstlisting}
+\cite*@\oarg{postnote}\marg{bibtex-key}%@*
+\end{lstlisting}
+The \meta{bibtex-key} corresponds to the key from the bibliography file.
+
+\DescribeMacro{\cites}
+If one wants to cite several authors or works a very convenient way is the following using the \cs{cites}-command:
+\begin{lstlisting}
+\cites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+ *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+ *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
+\end{lstlisting}
+
+\DescribeMacro{\parencite}
+Sometimes a citation has to be put in parentheses.
+Therefore we implemented the command \cs{parencite}:
+\begin{lstlisting}
+\parencite*@\oarg{postnote}\marg{bibtex-key}%@*
+\end{lstlisting}
+This cite command takes care of the correct corresponding parentheses and brackets.
+Especially in |@Inreference| citations the parentheses are changing to (square) brackets.
+The example shown in \cref{faq:inreference} makes it clear.
+\DescribeMacro{\parencites}
+Of course there is also the possibility to cite several authors/works in parentheses.
+This is done with \cs{parencites}:
+\begin{lstlisting}
+\parencites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+ *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+ *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
+\end{lstlisting}
+
+\DescribeMacro{\textcite}
+Beside the listed \cs{cite} commands above there is a third way of citing:
+\cs{textcite} is useful if the author should be mentioned in the text and
+the remaining components like year and page will immediately follow in parentheses.
+\begin{lstlisting}
+\textcite*@\oarg{postnote}\marg{bibtex-key}%@*
+\end{lstlisting}
-\item[scshape] (zuvor |kapitaelchen|) Die Namen in den Fußnoten werden in Kapitälchen gesetzt \cref{scshape}, ausgenommen sind Werke unbekannter Herkunft (\cref{unbekannt}) und Werke antiker Autoren (\cref{antik,frgantik}).
+\DescribeMacro{\textcites}
+And again there is also a \cs{textcites} in case of several authors:
+ \begin{lstlisting}
+\textcites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+ *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+ *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
+\end{lstlisting}
+
+\DescribeMacro{\citeauthor}\DescribeMacro{\citetitle}\label{citeauthor}%
+Furthermore and additionally to the ›normal‹ \cs{cite}-commands one can also cite only the author or the work title in the text and in the footnotes.
+\begin{lstlisting}
+\citeauthor*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
+\end{lstlisting}
+ and for the works
+\begin{lstlisting}
+\citetitle*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
+\end{lstlisting}
+For further information cf. \cref{fullnames}.
+
+
+\subsection{Entries with @String}\label{string}
+The citation rules of the German Archaeological Institute instruct to abbreviate journals and series according to a given list.\footnote{\url{http://www.dainst.org/documents/10180/70593/03_Liste+abzukürzender+Zeitschriften_quer.pdf/2646d351-8e5d-4e8b-8acd-54f3c272d3ff} <2016-06-06>}
+For this purpose we provide a list with bibliography macros which refer to these abbreviations.
+These abbreviations can be included by loading package option |lstabbrv| (cf. \cref{abbrv}).
+Besides there are two further lists with |@String| macros cf. \cref{lstpublishers,lstlocations}.
+
+\DescribeMacro{@String} The style |archaeologie| respects the guidelines of the German Archaeological Institute
+and is therefore compatible with the given abbreviations of journals and series.
+To minimize the susceptibility to errors and to omit unnecessary typing of sometimes very long journal titles |archaeologie| works with so-called |@Strings|.
+The advantage of these |@Strings| is that several bibliography entries can be defined by one globally given value.
+The |@String| is loaded at begin of the |bib|-file, therefore all |@Strings| have to be previous to all other bibliography entries.
+
+To use this offer of simplification the bibliography fields for the title of the journal (|journaltitle|) and its short form (|shortjournal|),
+as well as the name of the series (|series|) and its shortform (|shortseries|) have to be written with a |@String|.
+In \cref{abbrv-lists} there is a list with all the abbreviations given by the German Archaeological Institute,
+in which the |@String| (with endings |-short| for |shortjournal| or |shortseries|) are listed in the left column.
+A |@String| has to be written \emph{without} any curly brackets.\footnote{If you use \emph{JabRef} in its non-coding window,
+then you have to write \#|AyasofyaMuezYil|\#. JabRef converts this internally to a |@String| and omits the \# in the coding window.
+\emph{BibDesk} provides such conversion as well by pressing |cmd-R| which enables direct BibTeX typing without enclosing curly brackets.}
+
+An example shows how to use it:
+\begin{lstlisting}[style=bibentry,label=Koyunlu1990,caption={{@}Article\{Koyunlu1990,…\} }]
+@Article{Koyunlu1990,
+ author = {Koyunlu, A.},
+ title = {Die Bodenbelage und der Errichtungsort der Hagia Sophia},
+ journaltitle = AyasofyaMuezYil, %@String used
+ shortjournal = AyasofyaMuezYil-short, %@String used
+ volume = {11},
+ pages = {147--156},
+ year = {1990},
+}
+\end{lstlisting}
+
+That article appeared within a rather unusual journal,
+which should be abbreviated with ›AyasofyaMüzYıl‹.
+
+To save the time to look for the special character and insert ›ı‹ manually
+it is written in the |@String| with an ›i‹ (for further information see \cref{abbrv-lists}) but will be replaced after compiling with the correct character:
+
+\printbib[6em]{Koyunlu1990}
+
+Whether using the provided abbreviation list with |lstabbrv| or filling the |journaltitle| and |shortjournal| fields manually,
+|archaeologie| uses by default short titles if defined.
+The default embedding of such abbreviations can be switched off, of course.
+In case you use the package option |noabbrv| in the preamble (see \cref{noabbrevs}), then the output changes as follows:
+\begin{bibbsp}{Koyunlu1990}
+\parbox[t]{2cm}{Koyunlu 1990} \parbox[t]{9cm}{A. Koyunlu,
+Die Bodenbelage und der Errichtungsort der Hagia Sophia, {\color{red}Ayasofia Müzesi yıllığı. Annual of Ayasofya Museum} 11, 1990, 147–156}
+\end{bibbsp}
+Nevertheless the advantage of our abbreviation list lies in the possibility to create a separate bibliography
+with all the abbreviations of used journal titles and series (see \cref{bibliographie}) without being prone to citation differences and typing errors.
+
+However, if a journal or a series is \emph{not} included in the list (\cref{abbrv-lists})
+then this journal/series will \emph{not} be abbreviated and converted to full title in curly brackets in the respective field e.\,g. |journaltitle=|\marg{title of the journal} or |series=|\marg{name of the series}.
+Therefore the field content will not be printed.
+At least Bib\TeX{} gives a warning in its log which can be checked.\footnote{For example something like \enquote{\enquote{journaltitle} in entry \meta{entrykey} cannot be null, deleting it}.}
+For the following examples we use |@String| whenever it is clever and possible.
+
+Lastly we want to point out that |@Strings| can also be used partly as following shows:
+
+\begin{lstlisting}
+@Incollection{Mundt2015,
+ ...
+ location = Berlin #{ and Boston}, %@String partly used
+ ...
+}
+\end{lstlisting}
+
+Each time you want to leave the |@String| environment and enter the curly bracket environment (and reverse) make use of a hash \# to concatenate elements.
+
+\section{Details of optional preferences}\label{options-description}
+Following we give a more detailed insight into the various options of |archaeologie|
+and show their results on the bases of concrete examples.
+Changes made by these options are {\color{red}coloured in red}.
+
+\subsection{Preamble options}\label{options-preamble}
+Optional preferences in the preamble are loaded within the package |bib|\LaTeX:
+\begin{lstlisting}
+\usepackage[%
+ backend=biber, % activates biber which is done by default anyway
+ % (but will give an error if not done here)
+ style=archaeologie, % loads the style *@|archaeologie|@*
+ inreferences=true, % option *@|inreferences|@* is loaded
+ lstabbrv % option *@|lstabbrv|@* is loaded as well
+ ]{biblatex}
+\end{lstlisting}
+In this example the style |archaeologie| is loaded with options |inreferences| and |lstabbrv|.
+Now, manual entries don't appear in author-year-style anymore and journal/series |@string|-macros are enabled.
+By the way, it doesn't matter if you write |inreferences| or |inreferences=true|.
+
+Each of the listed options is disabled by default even if we strongly recommend to use in particular the additional bibliographies and |@string| lists.
+All remaining options are rather a matter of taste.
+
+Despite to the overview section (\cref{overview}) the following list is arranged in alphabetic order.
+
+\subsubsection{bibancient}\label{bibancient}
+\DescribeMacro{bibancient}
+In case of citing ancient authors and their works you can do it with common \cs{cite}-commands.
+Exclusively for this case we included a modification that respects the different citation of ancient authors and works.
+With the option |bibancient| you load an additional bibliography called |bibliography-bibancient.bib| in which we inserted almost 600 ancient authors and works with their abbreviation according to The New Pauly/Thesaurus Linguae Latinae.
+For the complete list of those see \cref{list-bibancient}.
+Using these pre-sets is recommended because it will guarantee a high level of consistency and minimize error-proneness.
+
+You can cite the authors or works with their |bibtex-key| which you find in bold in the left column of the list.
+Authors and works are separated in the |bibtex-key| by a colon.
+The entry on the right marks the |shorthand| which will be printed in your paper.
+
+Let us make it clear with an example:
+\begin{refsection}
+With the loaded option |bibancient| you write
+\begin{lstlisting}
+\cite[3,2,5--7]{Apul:met}
+\end{lstlisting}
-\item[width] (zuvor |abstand|) Mit dieser Option wird in der Bibliographie der Abstand zwischen dem Label und dem Vollzitat nach Belieben gesteuert.
-\cref{width}.
+and will get in return after compiling:
-\item[counter] Angabe über die Anzahl an Zitationen des Werks im Text. \cref{counter}.
-\end{description}
+\cite[3,2,5--7]{Apul:met}.
+\end{refsection}
+The corresponding bibliography-entry looks like this
+\begin{lstlisting}[style=bibentry,label=Apul:met,caption={{@}Book\{Apul:met,…\} }]
+@Book{Apul:met,
+ author = {Apuleius Madaurensis, Lucius},
+ title = {metamorphoses},
+ shorthand = {Apul. met.},
+ shortauthor = {Apuleius},
+ keywords = {ancient},
+ options = {ancient},
+}
+\end{lstlisting}
+All entries in the mentioned additional bibliography contain the line |keywords = {ancient}|.
+With that you can print all ancient authors in a separated bibliography by typing:
+\begin{lstlisting}
+\printbibliography[keyword=ancient]
+\end{lstlisting}
+\printbib{Apul:met}
- \subsection{Literaturoptionen (Bibliographieeintrag)}
- Zusätzlich kann ein einzelner Eintrag durch folgende Werte in seinem |options|-Feld manipuliert werden. Siehe dazu auch \cref{optionen-literatur} und \cref{beispiele}.
+\begin{refsection}
+By means of the |bibtexkey| (e.g. |Apul:met|) you can also cite only authors or titles like this:
- \begin{description}
- \item[antik] Zeichnet den Eintrag als antike Quelle aus. Siehe \cref{antik}.
-% \item[frg] Zeichnet den Eintrag als Fragment aus. Siehe \cref{frg}.
- \item[frgantik] Zeichnet den Eintrag als antikes Fragment aus. Siehe \cref{frgantik}.
- \item[corpus] Nur das |shorthand|-Feld wird beim Folgezitat ausgegeben. Wichtig für beispielsweise Inschriften- oder Münzcorpora (CIL, AE, RIC, etc.). Siehe \cref{corpus}.
-% \item[lexikon] Zeichnet den Eintrag als ein zitierfähiges Lexikon aus, das über den abgekürzten Haupttitel zitiert wird (RE, DNP, LTUR, LIMC, etc.). Siehe \cref{lexikon}.
- %\item[unbekannt] Zeichnet den Eintrag als anonymes Werk aus, sodass nach dem Feld |shorthand| zitiert wird. Siehe \cref{unbekannt}.
- \end{description}
+\begin{lstlisting}
+\citeauthor{Apul:met} remarks in \citetitle{Apul:met}...
+\end{lstlisting}
- \changes{v1.1}{2015/06/04}{Neue Optionen in Zusammenfassung ergänzt.}
+will give
+\begin{bsp}
+\citeauthor{Apul:met} remarks in \citetitle{Apul:met}...
+\end{bsp}
+\end{refsection}
+\changes{v1.5}{2016/05/31}{Extra Bibliographie}
-
+\subsubsection{bibcorpora}\label{bibcorpora}
+\DescribeMacro{bibcorpora}
+This loads an additional bibliography which contains the most important corpora for ancient studies, so you can cite them right away in your document without creating a new bibentry by yourself.
+These corpora are listed in \cref{list-bibcorpora}.
+Advantage and usage mostly correspond to |bibancient|,
+so have a look at \cref{bibancient} for details.
+\subsubsection{inreferences}\label{inreferences}
- \subsection{cite-Befehle}\label{cite-befehle}
- \DescribeMacro{\cite}
-Die einfachste Weise zum Zitieren wird mit |\cite| bewerkstelligt:\par
- \begin{syntax}|\cite|\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\end{syntax}
- wobei \meta{prenote} eine einleitende Bemerkung (z.B. \enquote{Vgl.}) ist und \meta{postnote} für gewöhnlich die Seitenzahl. Wenn nur ein optionales Argument gegeben wird, so ist das die Seitenzahl:\par
- \begin{syntax}|\cite|\oarg{postnote}\marg{Schlüssel}\end{syntax}
- \meta{Schlüssel} ist dabei in jedem Fall der Schlüssel des Eintrags aus der |bib|-Datei.
-
- \DescribeMacro{\cites}
- Möchte man mehrere Autoren/Werke zugleich zitieren, eignet sich am besten der |\cites|-Befehl:\par
- \begin{syntax}\noindent|\cites|(pre-prenote)(post-postnote)\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\%\\
- \indent\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\%\\%
- \indent\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\ldots
- \end{syntax}
-\begin{center} * * * \end{center}
+\DescribeMacro{inreferences}
+One peculiarity of citation rules of the German Archaeological Institute
+is the way manuals and encyclopaedias should be cited when not represented in author-year-style.
+|archaeologie| allows to cite these manuals in footnotes or text as full citation in this special manner.
+Single requirement is that the bibliography entry is an |@Inreference| (cf. \cref{inreference}).
- \DescribeMacro{\parencite}
- Möchte man Literaturangaben (bspw. in den Fußnoten) in Klammern setzen, dann empfiehlt sich dies mittels\par
- \begin{syntax}|\parencite|\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\end{syntax} zu tun.
- Dieser Befehl berücksichtigt die Klammerregelung, die besagt, dass runde Klammern innerhalb einer Klammerumgebung als eckigen Klammern geschrieben werden müssen.
- Dies ist vor allem bei Lexikaeinträgen der Fall, wie das Beispiel unter \cref{inreference} zeigt.
-
- \DescribeMacro{\parencites}
- Möchte man mehrere Literaturangaben (bspw. in den Fußnoten) in Klammern setzen, dann empfiehlt sich dies mittels\par
- \begin{syntax}\noindent|\parencites|(pre-prenote)(post-postnote)\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\%\\
- \indent\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\%\\%
- \indent\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\ldots
- \end{syntax} zu tun.
- Dieser Befehl berücksichtigt die Klammerregelung, die besagt, dass runde Klammern innerhalb einer Klammerumgebung als eckigen Klammern geschrieben werden müssen.
- Dies ist vor allem bei Lexikaeinträgen der Fall, wie das Beispiel unter \cref{inreference} zeigt.
- \begin{center} * * * \end{center}
-
- \DescribeMacro{\textcite}
-Zu den bisher aufgeführten |\cite|-Befehlen gibt es zusätzlich die Möglichkeit einen Eintrag bspw. im Fließtext mit |\textcite| zu zitieren: \par
- \begin{syntax}\noindent|\textcite|\oarg{prenote}\oarg{postnote}\marg{Schlüssel}
- \end{syntax}
-
-\DescribeMacro{\textcites}
-Wiederum gibt es die Möglichkeit mehrere Werke mit |\textcites| anzugeben: \par
- \begin{syntax}\noindent|\textcites|(pre-prenote)(post-postnote)\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\\%
- \indent\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\%\\%
- \indent\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\ldots
- \end{syntax}
-
+An example makes it clear:
+\begin{lstlisting}[style=bibentry,label=Nieddu1995,caption={{@}Inreference\{Nieddu1995,…\} }]
+@Inreference{Nieddu1995,
+ author = {Nieddu, Giuseppe},
+ title = {Dei Consentes},
+ booktitle = LTUR-short,
+ pages = {9--10},
+ year = {1995},
+ volume = {2},
+}
+\end{lstlisting}
+\begin{refsection}
+There are two ways to display |\cite{Nieddu1995}|:
+\begin{bsp}
+\begin{enumerate}
+\item by default it prints author-year:
+\cite{Nieddu1995}
+\item with the option |inreferences| it will change to:
+LTUR 2 (1995) 9-10 s. v. Dei Consentes (G. Nieddu)
+\end{enumerate}
+\end{bsp}
-\begin{center} * * * \end{center}
- \DescribeMacro{\citeauthor} \DescribeMacro{\citetitle}
-Zum ›normalen‹ |\cite|-Befehl kann man im Fließtext und in den Anmerkungen auf den Autor/Herausgeber und das Werk verweisen.
-Dies wird über den Befehl\par
- \begin{syntax}|\citeauthor|\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\end{syntax} \par
- und \par
- \begin{syntax}|\citetitle|\oarg{prenote}\oarg{postnote}\marg{Schlüssel}\end{syntax}ausgeführt. Weitere Informationen unter \cref{fullnames}.
-
+If \oarg{postnote} is defined with columns/page number, e.\,g. |\cite[9]{Nieddu1995}|,
+the position of \oarg{postnote} changes:
-
+\begin{bsp}
+\begin{enumerate}
+\item by default it prints in author-year:
+\cite[9]{Nieddu1995}
+\item with the option |inreferences| it appears like:
+LTUR 2 (1995) 9 s. v. Dei Consentes (G. Nieddu)
+\end{enumerate}
+\end{bsp}
-\subsection{Einträge mit @string}
-Die Zitationsrichtlinie des DAI sieht vor, dass vor allem Zeitschriften und Reihen nach einer vorgegebenen Liste abgekürzt werden.\footnote{\url{www.dainst.org/documents/10180/70593/02_Liste-Abkürzungen_quer.pdf} (\today)}
+To mention an important point, activating |inreferences| causes the cited |@Inreference| entry to be automatically \emph{omitted} in the (final) bibliography,
+because the entry is fully cited before in the footnotes (also stated in the German Archaeological Institute rules).
- \DescribeMacro{@string}Der Stil |archaeologie| geht auf diese Vorgabe ein und kürzt Zeitschriften/Reihen ab.
-Um Fehler zu vermeiden und unnötiges Tippen der teilweise langen Zeitschriftennamen, bzw. Reihen zu ersparen, arbeitet |archaeologie| mit |@string|-Angaben.
-Dies hat den Vorteil, dass mittels |@string| mehreren Bibliographieeinträgen einen zentral definierten Wert zugewiesen wird.
-Der |@string| wird in der |bib|-Datei am Anfang geladen, daher muss er vor alle anderen Bibliographieeinträge stehen.
+If the option is not used (|inreferences=false|) the entry will look like this in the bibliography:
+\end{refsection}
-Um dieses Angebot an ›Vereinfachung‹ zu nutzen, müssen Zeitschriftennamen (|journaltitle|) und ihre Kurzformen (|shortjournal|), sowie Reihen (|series|) und deren Kurzformen (|shortseries|) mittels |@string| geschrieben werden.
-In \cref{listen} sind die Abkürzungen nach DAI-Vorgabe aufgeführt, sodass der |@string| (mit den Ergänzungen |-kurz|, bzw. |-lang|) (linke Spalte) abgelesen werden kann.
-Dieser |@string|
-% (bspw. |AyasofyaMuezYil|; siehe \ref{AyasofyaMuezYil-kurz}, bzw. \ref{AyasofyaMuezYil-lang})
-wird dann OHNE Klammersetzung in die Felder (bspw. |journaltitle|) geschrieben.\footnote{Verwendet man bspw. das Programm JabRef in der Fensteransicht, dann muss \#|AyasofyaMuezYil|\# geschrieben werden. JabRef konvertiert dies intern zu einem |@string|.}
+\printbib[6em]{Nieddu1995}
-Ein Beispiel zeigt den Umgang:
+\subsubsection{lstabbrv}\label{abbrv}
+\DescribeMacro{lstabbrv}
+If you want to benefit from the above mentioned method with |@String| (cf. \cref{string})
+you have to activate the option called |lstabbrv| (list of abbreviations) in the preamble.
+Once activated the additional bibliography |archaeologie-lstabbrv.bib| is loaded.
+In this bibliography all abbreviations listed in \cref{abbrv-lists} are stored, for further details of usage see \cref{string}.
-|@article{Koyunlu_1990,|\\
-|author = {Koyunlu, A.},|\\
-|title = {Die Bodenbelage und der Errichtungsort der Hagia Sophia},|\\
-|pages = {147--156},|\\
-|volume = {11},|\\
-|year = {1990},|\\
-|journaltitle = AyasofyaMuezYil-lang,|\\
-|shortjournal = AyasofyaMuezYil-kurz|\\
-|}|\\
+\subsubsection{lstlocations}\label{lstlocations}
+\DescribeMacro{lstlocations}
+This loads an additional bibliography with |@Strings| of locations used to print out their correct exonym in the selected language.
+In that case you are not forced to change location spelling when switching the language.
+(Otherwise it is necessary to adjust location names like \emph{Rome} to \emph{Rom} or \emph{Roma}
+in your potentially multiple-used bibliography each time you change the language of your scientific text).
+For details on the locations list cf. \cref{list-locations}.
-Dieser Artikel erschien in einer nicht geläufigen Zeitschrift, die zudem nach DAI-Vorgabe mit ›AyasofyaMüzYıl‹ abgekürzt werden soll.
-Um sich bei diesem Beispiel die Arbeit zu sparen den Buchstaben ›ı‹ manuell einzufügen, wird er im |@string| mit ›i‹ geschrieben (weitere Besonderheiten siehe \cref{listen}) und erscheint dann nach dem Kompilieren in der korrekten Schreibweise:
+\subsubsection{lstpublishers}\label{lstpublishers}
+\DescribeMacro{lstpublishers}
+Activates the additional bibliography file |archaeologie-lstpublishers.bib| with |@Strings|
+of publishers which can be used to print out their correct name.
+Benefits are similar to the other lists mentioned above and in \cref{string}.
+For the list cf. \cref{list-publishers}
-\begin{bsp}
-\begin{refsection}
-\nocite{Koyunlu_1990}
-\printbibliography[title={Forschungsliteratur}]
-\end{refsection}
-\end{bsp}
-Die standardmäßige Abkürzung kann optional ausgeschaltet werden.
-Verwendet man die Option |noabbrevs| (siehe \cref{noabbrevs}), dann ändert sich die Ausgabe entsprechend:
-\begin{bsp}\todo[noline]{manuelles Beispiel}
-A. Koyunlu, Die Bodenbelage und der Errichtungsort der Hagia Sophia, {\color{red}Ayasofia Müzesi yıllığı. Annual of Ayasofya Museum} 11, 1990, 147–156
-%\fullcite{Koyunlu_1990}
-\end{bsp}
+\subsubsection{seenote}\label{seenote}
+\DescribeMacro{seenote}
+Even if author-year-citation seems to be commonly accepted in Ancient Studies in the meantime you may want to use a traditional citation style.
+For this purpose you can switch to the other allowed citation rule by the German Archaeological Institute
+which works like this:
+If you cite a work for the first time in a footnote |archaeologie| will print a full cite which contains all bibliography elements.
+Henceforward each following citation is printed as short cite and will additionally refer to the footnote where the first cite was done.
+Bibliography entries with |options={ancient}| are excluded form this speciality and are cited as always.
-Ein Vorteil ist, dass man eine eigene Bibliographie mit den Abkürzungen der Zeitschriften und Reihen machen kann. Einzelheiten dazu siehe \cref{bibliographie}.
+You can use the cite-commands \cs{cite(s)} and \cs{parencite(s)} but \cs{textcite(s)}
+will behave like \cs{cite(s)} because |seenote| actually just checks for occurrences in footnotes and does not refer to cites in running text.
-Findet sich die Zeitschrift oder Reihe {\color{red}nicht} in der unter \cref{listen} aufgeführten Liste, dann wird diese {\color{red}nicht} abgekürzt und ganz normal in |{}| bei |journaltitle=|\marg{Zeitschriftentitel} gesetzt.
-In den folgenden Beispielen wird, wo möglich, mit |@string| gearbeitet.
+We give an example, first citation of
+\begin{lstlisting}
+\footnote{\cite{Ball2013}}
+\end{lstlisting}
-\section{Optionale Steuerung}
-Nachfolgend werden die Optionen des Stils |archaeologie| immer auch konkret an Beispielen erläutert.
-Änderungen, die durch die Optionen erfolgen, sind {\color{red}rot} markiert.
-In {\color{blue}blau} sind bibliographische Einträge, die mit dem nächsten Literaturverzeichnis verknüpft sind.
+displays
- \subsection{Optionen in der Präambel}\label{optionen-preamble}
-
- In der Präambel kann man, wie folgt, den Stil |archaeologie| über das Paket |biblatex| laden:
-
-| \usepackage[%|\\
-| | |backend=biber, % aktiviert biber|\\
-| | |style=archaeologie, % lädt den Stil 'archaeologie'|\\
-| | |inreferences=true, %true = bspw. LTUR 2 (1994) 123 s. v.|\\
-| | |]{biblatex}|
-
-In diesem Beispiel wurde der Stil |archaeologie| mit der Option |inreferences| geladen (|=true|).
-Die Ausgabe in Fußnote und in Bibliographie wird jedoch maßgeblich durch weitere verschiedene Optionen manipuliert, die entsprechend ebenfalls in der Präambel geladen werden können.
+\begin{bsp}
+L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current thinking on the Pompeii Forum, 117/3, 2013, 461–492.
+\end{bsp}
-\subsubsection{strings}\label{strings}
- \DescribeMacro{strings}
- Möchte man die oben erwähnte Methode mit |@string| verwenden, muss in der Präambel die Option |strings| aktiviert sein.
- Damit wird die Bibliographie |archaeologie-abbrv.bib| geladen, in der die unter \cref{listen} aufgeführten Abkürzungen gespeichert sind.
-Verwendet man keine |@string|-Einträge, muss nichts weiter gemacht werden.
+Second citation of
+\begin{lstlisting}
+\footnote{\cite[470]{Ball2013}}
+\end{lstlisting}
+ends up in
-\subsubsection{dai-footnote}\label{dai-footnote}
- \DescribeMacro{dai-footnote}
- Diese Option ermöglicht in den Fußnoten die Angabe eines Rückverweises zur Erstnennung des zitierten Bibliographieeintrags.\\
-{\color{red} |#### Work in Progress #### Lauffähig in Version 2.0|}
-
+\begin{bsp}
+Ball – Dobbins loc. cit. (see n. [number of the footnote with full citation]) 470.
+\end{bsp}
+\changes{v1.5}{2016/05/31}{Rückverweis}
\subsubsection{translation}\label{translation}
\DescribeMacro{translation}
-Wenn diese Option aktiviert wird, erfolgt die Angabe eines Originaltitels, die Sprache, aus welcher übersetzt wurde und des Übersetzers des Werkes.
-Werke, bei denen |options={antik}| oder |options={frgantik}| (also antike Autoren und Fragmente) gesetzt wurde, werden stehts mit Originaltitel, Sprache und Übersetzer angegeben.
+Once this option is activated the original title, the original language and the translator of the work are printed (|origtitle|, |origlanguage|, |translator|).
+For ancient texts and fragments (|options={ancient}| or |options={frgancient}|) this is default,
+so they will always be printed with original title, language and translator.
+
+An example will be clarifying.
+The bibliographical entry |Lefebvre2011| contains following fields:
+\begin{lstlisting}[style=bibentry,label=Lefebvre2011,caption={{@}Book\{Lefebvre2011,…\}}]
+@Book{Lefebvre2011,
+ author = {Lefebvre,Henri},
+ title = {The Production of Space},
+ publisher = {Blackwell Publishing Ltd},
+ location = {Maien, MA and Oxford and Victoria},
+ year = {2011},
+ edition = {30},
+ origlocation = {Oxford},
+ origyear = {1991},
+ origtitle = {La production de l’espace},
+ origlanguage = {french},
+ translator = {Donald Nicholson-Smith},
+}
+\end{lstlisting}
-Die Option |translation| ist standardmäßig auf |=false| gesetzt.
-Ein Beispiel verschafft Klarheit. Folgender Bibliographieeintrag \\
-
- |@Book{Lefebvre_2011,|\\
-| Title = {The Production of Space},|\\
-| Author = {Henri Lefebvre},|\\
-| Publisher = {Blackwell Publishing Ltd},|\\
-| Year = {2011},|\\
-| Edition = {30},|\\
-| Location = {Maien, MA and Oxford and Victoria},|\\
-| Origlocation = {Oxford},|\\
-| Origyear = {1991},|\\
-| Origlanguage = {french},|\\
-| Origtitle = {La production de l’espace},|\\
-| Translator = {Donald Nicholson-Smith}|\\
-| }|
-
-wird in der Bibliographie zunächst auf diese Weise umgesetzt:
-%\begin{bsp}
-%%Henri Lefebvre, The Production of Space \textsuperscript{30}(Maien, MA 1991; Nachdr. Maien, MA 2011)
-%%\todo[noline]{dynamisches Beispiel}\fullcite{Lefebvre_2011}
-%\end{bsp}
- \begin{bsp}
-\begin{refsection}
-\nocite{Lefebvre_2011}
-\printbibliography[title={Forschungsliteratur}]
-\end{refsection}
-\end{bsp}
+The bibliography result is:
+\printbib[6em]{Lefebvre2011}
+By activating option |translation| it will change to:
- mit der aktivierten Option |translation| wird daraus:
-\begin{bsp}%
-%\fullcite{Lefebvre_2011}
-H. Lefebvre, The Production of Space, {\color{red} \emph{La production de l’espace}, aus dem Französischen übers. von D. Nicholson-Smith} \textsuperscript{30}(Oxford 1991; Nachdr. Maien, MA 2011)
-\end{bsp}
+\begin{bibbsp}{Lefebvre2011}%
+\parbox[t]{2cm}{Lefebvre 2011} \parbox[t]{9cm}{H. Lefebvre, The Production of Space,
+{\color{red} La production de l’espace, trans. from French by D. Nicholson-Smith} \textsuperscript{30}(Oxford 1991; repr. Maien, MA 2011)}
+\end{bibbsp}
-Dies funktioniert nicht nur bei den Einträgen |@book|, sondern auch bei |@article|:
-
-| @Article{Lefebvre_1977,| \\
-| Title = {Die Produktion des städtischen Raums},| \\
-| Author = {Lefebvre, Henri},| \\
-| Journaltitle = {ARCH+},| \\
-| Number = {9},| \\
-| Pages = {52--57},| \\
-| Volume = {34},| \\
-| Year = {1977},| \\
-| Origlanguage = {french},| \\
-| Origtitle = {Introduction à l'espace urbain},| \\
-| Translator = {Franz Hiss and Hans-Ulrich Wegener}| \\
-| }| \\
-
-Daraus wird dann:
-
-\begin{bsp}%
-%\fullcite{Lefebvre_1977}
- H. Lefebvre, Die Produktion des städtischen Raums, \emph{Introduction à l’espace urbain}, aus dem Französischen übers. von F. Hiss – H.-U. Wegener, ARCH+ 34/9, 1977, 52–57
-\end{bsp}
-
+However, it works not only with entries like |@Book| but also with e.\,g. |@Article|:
+
+\begin{lstlisting}[style=bibentry,label=Lefebvre1977,caption={{@}Article\{Lefebvre1977,…\} }]
+@Article{Lefebvre1977,
+ author = {Lefebvre, Henri},
+ title = {Die Produktion des städtischen Raums},
+ journaltitle = {ARCH+},
+ volume = {34},
+ pages = {52--57},
+ year = {1977},
+ translator = {Franz Hiss and Hans-Ulrich Wegener},
+ origlanguage = {french},
+ number = {9},
+ origtitle = {Introduction à l'espace urbain},
+}
+\end{lstlisting}
+Once again the bibliography entry alters:
+\begin{bibbsp}{Lefebvre1977}%
+\parbox[t]{2cm}{Lefebvre 1977} \parbox[t]{9cm}{H. Lefebvre,
+Die Produktion des stätischen Raums, \emph{Introduction à l’espace urbain},
+{\color{red} trans. from French by F. Hiss -- H.-U. Wegener}, ARCH+ 34/9, 1977, 52–57}
+\end{bibbsp}
\subsubsection{inreferences}\label{inreferences}
-\DescribeMacro{inreferences} Lexikoneinträge können in den Fußnoten in verschiedenen Zitationsformen dargestellt werden.
- Voraussetzung ist, dass es sich um ein |@inreference| handelt (siehe \cref{inreference}).
- Zudem bietet sich optional an ebenso |keywords = {lexikon}| zu setzen, um diese Einträge dann in der Bibliographie auszuschließen (über |notkeyword=lexikon|, bzw. |keyword=lexikon|).
-
- Am folgenden Beispielsdatensatz wird die Option verdeutlicht:\\
+\DescribeMacro{inreferences}
+There is the possibility to cite inreferences in the footnote as a full citation.
+It is only required that the bibliography-entry is an |@Inreference| (cf. \cref{inreference}).
-% \begin{bsp}
-| @Inreference{Nieddu_1995,|\\
-| Title = {Dei Consentes},|\\
-| Author = {Nieddu, Giuseppe},|\\
-| Year = {1995},|\\
-| Booktitle = {LTUR},|\\
-| Pages = {9--10},|\\
-| Volume = {2},|\\
-| Bookpagination = {column},|\\
-| Keywords = {lexikon},|\\
-| }|\\
-% \end{bsp}
+Another example makes it clear:
+\begin{lstlisting}[style=bibentry,label=Nieddu1995,caption={{@}Inreference\{Nieddu1995,…\} }]
+@Inreference{Nieddu1995,
+ author = {Nieddu, Giuseppe},
+ title = {Dei Consentes},
+ booktitle = LTUR-short,
+ pages = {9--10},
+ year = {1995},
+ volume = {2},
+}
+\end{lstlisting}
\begin{refsection}
- Die Ausgabe von |\cite{Nieddu_1995}| ist nun auf zwei Arten möglich:
- \begin{bsp}
-
+There are two ways of the display of |\cite{Nieddu1995}|:
\begin{enumerate}
- \item standardmäßig wird daraus: %Nieddu 1995
- \cite{Nieddu_1995}
- \item mit der Option |inreferences| wird dies zu:
+ \item by default it will give: %Nieddu 1995
+ \cite{Nieddu1995}
+ \item with the option |inreferences| it will change to:
LTUR 2 (1995) 9-10 s. v. Dei Consentes (G. Nieddu)
% \cite{Nieddu_1995}
\end{enumerate}
- \end{bsp}
- Trägt man eine konkrete Spalten/Seitenzahl ein (|\cite[9]{Nieddu_1995}|), dann wird diese Angabe in der Fußnote angegeben:
- \begin{bsp}
+
+If the \oarg{postnote} is defined with the columns/page number, (e.\,g. |\cite[9]{Nieddu1995}|),
+then it will change the position for the \oarg{postnote}:
+% \begin{bsp}
\begin{enumerate}
- \item standardmäßig wird daraus: %Nieddu 1995
- \cite[9]{Nieddu_1995}
- \item mit der Option |inreferences| wird dies zu:
+ \item by default it will give: %Nieddu 1995
+ \cite[9]{Nieddu1995}
+ \item with the option |inreferences| it will change to:
LTUR 2 (1995) 9 s. v. Dei Consentes (G. Nieddu)
\end{enumerate}
-\end{bsp}
+%\end{bsp}
+With the activated option (|inreferences|) the cited entries which are defined as a |@Inreference| will be automatically omitted in the (final) bibliography,
+because the entries are fully cited before in the footnotes.
+
+If the option is not used (|=false|) the entry will look like this in the bibliography:
+ \end{refsection}
+
+\printbib[6em]{Nieddu1995}
-Verwendet man diese Option (|inreferences|), dann werden die als |@inreference| gekennzeichneten Einträge automatisch von der (End-)Bibliographie ausgeschlossen, da sie bereits in den Fußnoten vollständig bibliographiert sind.
-Verwendet man die Option nicht, dann sieht der Eintrag wie folgt aus:
- \begin{bsp}
-\nocite{Nieddu_1995}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
-
-
\subsubsection{yearseries}\label{yearseries}
- \DescribeMacro{yearseries}
- Mit der Option |yearseries| kann man bewirken, dass die Reihe (Felder |series| und |number|) erst \emph{nach} dem Jahr ausgegeben werden, was von der Richtlinie des DAI abweicht.
- Bei Sammelbänden kann diese Option zum Tragen kommen:
-
-| @Incollection{Mundt_2015,|\\
-| Author = {Mundt, Felix},|\\
-| Title = {Der Mensch, das Licht und die Stadt},|\\
-| Subtitle = {Rhetorische Theorie und Praxis antiker|\\
-| || und humanistischer Städtebeschreibung},|\\
-| Pages = {179--206},|\\
-| Editor = {Therese Fuhrer and Felix Mundt and Jan Stenger},|\\
-| Booktitle = {Cityscaping},|\\
-| Booksubtitle = {Constructing and Modelling Images of the City},|\\
-| Publisher = {de Gruyter},|\\
-| Year = {2015},|\\
-| Number = {3},|\\
-| Series = Philologus-lang # |''| Supplement|'' |,|\footnote{Hier zeigt sich eine Besonderheit der |@string|: Zuerst wird die Langform der Serie mittels |Philologus-lang| aufgerufen, dann mit einem |\#| erweitert und mit ''| Supplement|'' ergänzt. In der Ausgabe wird dann die Ergänzung zum |@string| hinzugezogen. }\\
-| Shortseries = Philologus-kurz # |''| Suppl.|'' |,|\\
-| Location = {Berlin and Boston},|\\
-|}|\\
+\DescribeMacro{yearseries}
+The option |yearseries| leads to a different position of the fields |series| and |number|.
+The |series| of a |@Book| or |@Collection| is now printed \emph{after} the year.
+An example with an |@Incollection| demonstrates the effect of this option:
- Ohne eine Option wird in der Bibliographie daraus:
-% \begin{bsp}\todo[noline]{dynamisches Beispiel}\fullcite{Mundt_2015}\end{bsp}
- \begin{bsp}
-\begin{refsection}
-\nocite{Mundt_2015}
-\printbibliography[title={Forschungsliteratur}]
-\end{refsection}
-\end{bsp}
+\begin{lstlisting}[style=bibentry,label=Mundt2015,caption={{@}Incollection\{Mundt2015,…\}}]
+@Incollection{Mundt2015,
+ author = {Mundt, Felix},
+ title = {Der Mensch, das Licht und die Stadt},
+ subtitle = {Rhetorische Theorie und Praxis antiker und humanistischer Städtebeschreibung},
+ pages = {179--206},
+ editor = {Therese Fuhrer and Felix Mundt and Jan Stenger},
+ booktitle = {Cityscaping},
+ booksubtitle = {Constructing and Modelling Images of the City},
+ publisher = WdG,
+ location = Berlin #{ and Boston}, %@String partly used
+ year = {2015},
+ series = Philologus-long #{ Supplement},
+ number = {3},
+ shortseries = Philologus-short #{ Suppl.},
+}
+\end{lstlisting}
+
+Without any option activated it will look like this:
+\printbib[5em]{Mundt2015}
- mit der aktivierten Option |yearseries| verändert sich die Reihenfolge:
- \begin{bsp}
-F. Mundt, Der Mensch, das Licht und die Stadt. Rhetorische Theorie und Praxis antiker und humanistischer Städtebeschreibung, in: T. Fuhrer – F. Mundt – J. Stenger (Hrsg.), Cityscaping. Constructing and Modelling Images of the City (Berlin 2015) {\color{red}Philologus Suppl. 3,} 179–206
-\end{bsp}
+By activating |yearseries| it will change to:
+\begin{bibbsp}{Mundt2015}
+\parbox[t]{1.7cm}{Mundt 2015} \parbox[t]{9cm}{F. Mundt, Der Mensch, das Licht und die Stadt. Rhetorische Theorie und Praxis antiker und humanistischer Städtebeschreibung, in: T. Fuhrer -- F. Mundt -- J. Stenger (ed.), Cityscaping. Constructing and Modelling Images of the City (Berlin 2015) {\color{red}Philologus Suppl. 3,} 179–206}
+\end{bibbsp}
\subsubsection{fullnames / lastnames}\label{fullnames}\label{lastnames}
\DescribeMacro{fullnames}
\DescribeMacro{lastnames}
-Im Fließtext kann direkt auf Autoren (und bei fehlender Autorenangabe wird der oder die Herausgeber genannt) der Forschungsliteratur verwiesen werden.
-Autoren/Herausgeber werden über |\citeauthor|\marg{Schlüssel} aufgerufen.
-Ebenso ist auch das Auslesen der Werktitel über |\citetitle|\marg{Schlüssel} möglich, wobei der Titel in eine |emph{}|-Umgebung gesetzt wird und das Erscheinungsjahr in Klammern dahinter.
-
-Zunächst erfolgt die Ausgabe der Autoren, bzw. Herausgeber mit den Initialen des Vornamens und mit dem Nachnamen.
-Die Darstellung der Namen kann jedoch noch auf zwei andere Arten geschehen und sind stets mit ihrem Bibliographieeintrag zum Bibliographie-\marg{Schlüssel} via |hyperref| verlinkt. Die zwei Arten sind: mit dem vollen Vor- und Zunamen und nur mit dem Nachnamen. In einer Fußnote jedoch wird stets nur der/die Nachnamen gesetzt.
-
-Ein Beispiel macht dies klarer.
-Der Bibliographieeintrag lautet:
-
-|@Article{Boehmer_1985,|\\
-| Title = {Astragalspiele in und um Warka},|\\
-| Author = {Boehmer, Rainer Michael and Wrede, Nadja},|\\
-| Journaltitle = BaM-lang,|\\
-| Shortjournal = BaM-kurz,|\\
-| Pages = {399--404},|\\
-| Volume = {16},|\\
-| Year = {1985},|\\
-| }|\par
-
-Im Fließtext schreibt man:
-\begin{refsection}
-\begin{bsp}
-\ldots , dies behaupten ebenso |\citeauthor{Boehmer_1985}| in ihrem jüngsten Werk |\citetitle{Boehmer_1985}|.
-\end{bsp}
-
-Und nach dem Kompilieren wird dann in der Standardeinstellung (ohne weitere Optionen):\footnote{Wird der Befehel |citeauthor| in einer Fußnote verwendet, dann werden nur die Nachnamen ausgegeben, unabhängig der Optionen |fullnames| (\cref{name:a}) und |lastnames| (\cref{name:b}): \begin{bsp}
-\ldots , dies behaupten ebenso |\citeauthor{Boehmer_1985}| in ihrem jüngsten Werk |\citetitle{Boehmer_1985}|.
-\end{bsp} }
+Every time you mention authors in the running text it is possible to cite them
+directly with their names (\cs{citeauthor}\marg{bibtex-key}) or their works (\cs{citetitle}\marg{bibtex-key})
+having the benefit that they will be linked to your bibliography (cf. \cref{citeauthor}).
+
+By default the author's name is printed with abbreviated first name\footnote{Usually only the first letter, but setting the option |initials| to true it might change (cf. \cref{initials}).} and last name.
+If you prefer to have full names printed (in running text, not in the bibliography!) switch on the option |fullnames|.
+If you want in contrast the authors to be shorten to their last names use |lastnames|.
+
+The following example illustrates it:
+
+\begin{lstlisting}[style=bibentry,label=Boehmer1985,caption={{@}Article\{Boehmer1985,…\} }]
+@Article{Boehmer1985,
+ author = {Boehmer, Rainer Michael and Wrede, Nadja},
+ title = {Astragalspiele in und um Warka},
+ journaltitle = BaM,
+ shortjournal = BaM-short,
+ volume = {16},
+ pages = {399--404},
+ year = {1985},
+}
+\end{lstlisting}
-\begin{bsp} \todo[noline]{dynamisches Beispiel}\ldots , dies behaupten ebenso \citeauthor{Boehmer_1985} in ihrem jüngsten Werk \citetitle{Boehmer_1985}.\end{bsp}
+Let's assume you would like to write:
-Oder mit den Optionen |fullnames| (\cref{name:a}) und |lastnames| (\cref{name:b}):
-\begin{bsp}
- \begin{enumerate}
-\item\label{name:a}
- \ldots , dies behaupten ebenso {\color{red}Rainer Michael Boehmer und Nadja Wrede} in ihrem jüngsten Werk \emph{Astragalspiele in und um Warka} (1985).
-\item\label{name:b}
-\ldots , dies behaupten ebenso {\color{red}Boehmer und Wrede} in ihrem jüngsten Werk \emph{Astragalspiele in und um Warka} (1985).
+\begin{refsection}
+\begin{lstlisting}
+*@\ldots , this is also shown by @*\citeauthor{Boehmer1985}
+*@ in their latest article @*\citetitle{Boehmer1985}*@.@* \end{lstlisting}
- \end{enumerate}
-\end{bsp}
+After compiling it will look by default like this using the
+etting |fullnames| \ref{name:a} or |lastnames| \ref{name:b}:
\begin{bsp}
-\nocite{Boehmer_1985}
-\printbibliography[title={Forschungsliteratur}]
+\begin{enumerate}
+\item\label{name:a}
+\ldots , this is also shown by {\color{red}Rainer Michael Boehmer und Nadja Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985).
+\item\label{name:b}
+\ldots , this is also shown by {\color{red}Boehmer und Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985).
+\end{enumerate}
\end{bsp}
\end{refsection}
+\printbib[9.5em]{Boehmer1985}
+
+Two things are left to be noticed:
+\begin{enumerate}
+\item Citing an author in a footnote prints always last names, no matter which citing option is chosen.
+\item There is a slightly different behaviour if you use \cs{citeauthor} or \cs{citetitle} with ancient authors and work titles (|options={ancient}|).
+Instead of printing the field |author| which contains usually the full ancient name the field |shortauthor| is considered in which you can record the more common name of the ancient author.
+Ancient work titles will be printed without the year in parentheses. Both is demonstrated in the following example: Based on the bibliography entry
+\end{enumerate}
+\begin{lstlisting}[style=bibentry,label=Quint:inst,caption={{@}Book\{Quint:inst,…\} }]
+@Book{Quint:inst,
+ author = {Fabius Quintilianus, Marcus},
+ title = {Ausbildung des Redners},
+ subtitle = {Institutio oratoria},
+ publisher = WBG,
+ location = {Darmstadt},
+ year = {2015},
+ edition = {6},
+ origlanguage = {latin},
+ translator = {Rahn, Helmut},
+ shorthand = {Quint. inst.},
+ shortauthor = {Quintilian},
+ keywords = {ancient},
+ options = {ancient},
+}
+\end{lstlisting}
-Werden allerdings mit |\citeauthor|, bzw. |\citetitle| antike Autoren und ihre Werktitel aufgerufen (dafür muss im Bibliographieeintrag |options=antik| geschrieben werden), dann wird für den Autorenname das Feld |shortauthor| ausgelesen, in dem der deutsche Rufnamen des Autors steht.
-
-Um Fehler zu vermeiden ist es absolut wichtig, dass dieses Feld wie die anderen Namensfelder behandelt wird. Möchte man »Plinius, d. Ä.« als deutschen Rufnamen ausgeben, dann muss man schreiben: |shortauthor = {Plinius, {d.\,Ä.}}|.
-
-Bei antiken Werktitel wird keine Jahreszahl dazugeschrieben.
-Somit wird aus dem Bibliographieeintrag
-
-|@Book{Quint_inst,|\\
-| Title = {Ausbildung des Redners},|\\
-| Author = {Fabius Quintilianus, Marcus},|\\
-| Translator = {Rahn, Helmut},|\\
-| Year = {2015},|\\
-| Edition = {6},|\\
-| Keywords = {Quelle},|\\
-| Location = {Darmstadt},|\\
-| Options = {antik},|\\
-| Origlanguage = {latin},|\\
-| Shorthand = {Quint. inst.},|\\
-| Subtitle = {Institutio oratoria},|\\
-| Shortauthor = {Quintilian}|\\
-|}|
+and the following statement
-wie folgt Autor und Buchttitel ausgelesen:
\begin{refsection}
-
- \ldots\ Auch |\citeauthor{Quint_inst}| nennt in |\citetitle{Quint_inst}| die notwendigen physischen Qualitäten eines Redners.\par
+\begin{lstlisting}
+*@\ldots\ and @*\citeauthor{Quint:inst}*@ names in @*\citetitle{Quint:inst}
+*@ the necessary physical qualities of an orator, too.@*
+\end{lstlisting}
- \begin{bsp}
- \ldots\ \todo[noline]{dynamisches Beispiel}Auch \citeauthor{Quint_inst} nennt in \citetitle{Quint_inst} die notwendigen physischen Qualitäten eines Redners.\par
-\end{bsp}
-
+we obtain the result:
\begin{bsp}
-\nocite{Quint_inst}
-\printbibliography[title={Antike Quellen}]
+\ldots\ and \citeauthor{Quint:inst} names in \citetitle{Quint:inst} the necessary physical qualities of an orator, too.
\end{bsp}
\end{refsection}
-
+\printbib[5em]{Quint:inst}
\subsubsection{yearinparens}\label{yearinparens}
\DescribeMacro{yearinparens}%
-Setzt die Jahreszahlen aller Einträge in der Fußnote und in der Bibliographie in runde Klammern.
-Anstatt wie standardmäßig aus |\cite[475]{Ball_2013}|
-\begin{bsp} Ball – Dobbins 2013, 475 \end{bsp}
- wird, wird mit der Option:
-\begin{bsp}
-Ball – Dobbins {\color{red}(}2013{\color{red})}, 475
+As the options name evokes the publication year of the cited entries
+(|year| or year from |date|) will be put in parentheses,
+in footnotes as well as in the bibliography.
+The ›Klammerregel‹ (correct alternation of different brackets) will be respected.
+
+In the case of |\cite[475]{Ball2013}|, instead of
+\begin{bsp}
+Ball – Dobbins 2013, 475
\end{bsp}
-%und in der Bibliographie:
-%
-%\begin{bsp}
-%\begin{refsection}
-%\nocite{Ball_2013}
-%\printbibliography[title={Forschungsliteratur}]
-%\end{refsection}
-%\end{bsp}
-
+now we get
+\begin{bsp}
+Ball – Dobbins {\color{red}(}2013{\color{red})}, 475.
+\end{bsp}
\subsubsection{scshape}\label{scshape}
\DescribeMacro{scshape}
-Die Option ändert die Formatierung der Zitation, sodass die Namen in den Anmerkungen/Fußnoten und in der Bibliographie in Kapitälchen gesetzt werden. Ausgenommen sind hierbei die Einträge, die über ein |label| (\cref{unbekannt}) ausgegeben werden, da es sich dabei nicht um einen Nachnamen, sondern eine selbst gewählte Bezeichnung handelt.
-Ebenso sind antike Autoren (|options=antik|, bzw. |options={frgantik}|) von dieser Option ausgenommen.
-Anstatt wie standardmäßig aus |\cite[475]{Ball_2013}|
-\begin{bsp} \cite[475]{Ball_2013} \end{bsp}
- wird, wird mit der Option:
-\begin{bsp}
-{\scshape {\color{red}Ball – Dobbins}} 2013, 475
-\end{bsp}
+You can also change the look of your citations.
+With |scshape| author names are set to small capitals---in footnotes and in the bibliography.
-Entsprechend in der Bibliographie:
-\begin{bsp}
-{\scshape {\color{red}Ball – Dobbins}} 2013\\
-\hspace*{3em}L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492
-
-\end{bsp}
+Entries without |author| or |editor| setting but with a defined
+ |label| (\cref{unknown}) are excluded from this option
+because |label| is not an author name but a self-defined expression with varying purposes.
+Further excluded are ancient authors (|options={ancient}| or |options={frgancient}|).
+By default---to quote the just established example |\cite[475]{Ball2013}|---we have again
+\begin{bsp} \cite[475]{Ball2013} \end{bsp}
-\subsubsection{bibfullname}\label{bibfullname}
-\DescribeMacro{bibfullname}
-Ausgabe des vollen Namens (soweit Vor- und Zuname ausgeschrieben wurden) in der Bibliographie.
+But with |schape| it will turn into:
\begin{bsp}
-\begin{refsection}
-\nocite{Ball_2013}
-\printbibliography[title={Forschungsliteratur}]
-\end{refsection}
+{\scshape {\color{red}Ball – Dobbins}} 2013, 475
\end{bsp}
-Mit aktivierter Option wird dies zu:
+And since the entry looks like this
+
+\begin{lstlisting}[style=bibentry,label=Ball2013,caption={{@}Article\{Ball2013,…\} }]
+@Article{Ball2013,
+author = {Larry F. Ball and John J. Dobbins},
+title = {Pompeii Forum Project},
+subtitle = {Current Thinking on the Pompeii Forum},
+journaltitle = AJA,
+shortjournal = AJA-short,
+volume = {117},
+pages = {461--492},
+year = {2013},
+doi = {10.3764/aja.117.3.0461},
+eprint = {10.3764/aja.117.3.0461},
+eprinttype = {jstor},
+month = {July},
+number = {3},
+}
+\end{lstlisting}
-\begin{bsp}
-{\color{red}Larry F. Ball – John J. Dobbins}, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492
-%\fullcite{Ball_2013}
-\end{bsp}
+the output in the bibliography changes from:
+\printbib[8em]{Ball2013}
-\subsubsection{noabbrevs}\label{noabbrevs}
-\DescribeMacro{noabbrevs}
-Die DAI-Vorgabe sieht vor, Zeitschriften nur abgekürzt wiederzugeben, dafür wird das Feld |shortjournal| vom Bibliographieeintrag ausgelesen. Gibt es keine Abkürzung, also wurde das Feld |shortjournal| leer gelesen, wird automatisch das Feld |journal| ausgelesen.
-Möchte man hingegen den vollen Zeitschriftennamen in der Bibliographie haben, dann muss man die Option |noabbrevs| aktivieren.
+to
-|@Article{Ball_2013,|\\
-| Title = {Pompeii Forum Project},|\\
-| Author = {Larry F. Ball and John J. Dobbins},|\\
-| Journaltitle = AJA-lang,|\\
-| Pages = {461--492},|\\
-| Volume = {117},|\\
-| Year = {2013},|\\
-| Number = {3},|\\
-| Shortjournal = AJA-kurz,|\\
-| Subtitle = {Current Thinking on the Pompeii Forum}|\\
-| }|\\
+\begin{bibbsp}{Ball2013}
+\parbox[t]{3cm}{{\scshape \color{red}Ball – Dobbins} 2013}\parbox[t]{8cm}{%
+L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492\newline
+...}
+\end{bibbsp}
-Ohne eine Zusätzliche Option wird der Eintrag in der Bibliographie wie folgt umgesetzt:
+\subsubsection{bibfullname}\label{bibfullname}
+\DescribeMacro{bibfullname}
+This will show the full name of an author and/or editor in the bibliography.
+By default first names are abbreviated.
+
+Without any options the entry
+
+\begin{lstlisting}[style=bibentry,label=Osland2016,caption={{@}Article\{Osland2016,…\} }]
+@Article{Osland2016,
+ author = {Osland, Daniel},
+ title = {Abuse or Reuse?},
+ subtitle = {Public Space in Late Antique Emerita},
+ journaltitle = AJA,
+ shortjournal = AJA-short,
+ volume = {120},
+ pages = {67--97},
+ year = {2016},
+ jstor = {10.3764/aja.120.1.0067},
+ number = {1},
+ zenon = {001454110},
+}
+\end{lstlisting}
-%\begin{bsp}
-%\todo[noline]{dynamisches Beispiel}\fullcite{Ball_2013}
-%\end{bsp}
-\begin{bsp}
-\begin{refsection}
-\nocite{Ball_2013}
-\printbibliography[title={Forschungsliteratur}]
-\end{refsection}
-\end{bsp}
+looks like
+\printbib[5em]{Osland2016}
-Mit der aktivierten angesprochenen Funktion |noabbrevs| wird daraus:
+and with |bibfullname| it will change to:
-\begin{bsp}\todo[noline]{manuelles Beispiel}L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, {\color{red}American Journal of Archaeology} 117/3, 2013, 461–492\end{bsp}
+\begin{bibbsp}{Osland2016}
+\parbox[t]{1.7cm}{Osland 2016} \parbox[t]{9.4cm}{{\color{red}Daniel} Osland, Abuse or Reuse? Public Space in Late Antique Emerita, AJA 120/ 1, 2016, 67–97,\\
+...}
+\end{bibbsp}
+
+\subsubsection{noabbrv}\label{noabbrevs}
+\DescribeMacro{noabbrv}
+According to the guidelines of the German Archaeological Institute journal titles and series have to be abbreviated.
+Therefore the fields |shortjournal| or |shortseries| will be considered.
+If you like to have printed full names of journals and series instead you can switch on the option |noabbrv|.
+For an example see \cref{string,Koyunlu1990}.
\subsubsection{publisher}\label{publisher}
\DescribeMacro{publisher}
-Angabe aller Erscheinungsorte und Verlagsort. Damit geht auch eine Änderung der Auflagezahl einher, die dann direkt vor das Erscheinungsjahr gesetzt wird.
-Erstauflage wird in eckiger Klammer nach dem Erscheinungsjahr gesetzt.
-
-|@Book{Emme_2013,|\\
-| Author = {Burkhard Emme},|\\
-| Title = {Peristyl und Polis},|\\
-| Subtitle = {Entwicklung und Funktionen %|\\
-| ||öffentlicher griechischer Hofanlagen},|\\
-| Number = {1},|\\
-| Publisher = {Walter de Gruyter},|\\
-| Series = {Urban Spaces},|\\
-| Year = {2013},|\\
-| Location = {Berlin and New York},|\\
-|}|\\
-
- Ohne eine Option wird in der Bibliographie daraus:
-% \begin{bsp}\todo[noline]{dynamisches Beispiel}\fullcite{Emme_2013}\end{bsp}
- \begin{bsp}
-\begin{refsection}
-\nocite{Emme_2013}
-\printbibliography[title={Forschungsliteratur}]
-\end{refsection}
-\end{bsp}
-
- mit der aktivierten Option |publisher| verändert sich die Reihenfolge:
- \begin{bsp}
- \todo[noline]{manuelles Beispiel}
- B. Emme, Peristyl und Polis. Entwicklung und Funktionen öffentlicher griechischer Hofanlagen, Urban Spaces 1 (Berlin {\color{red} – New York: Walter de Gruyter} 2013)\end{bsp}
+Once activated all locations and the publisher are printed.
+This will lead to a different output of the edition which will be right in front of the year.
+In case of reprint or second edition the first edition |origyear| will be put in square brackets after the year.
+
+\begin{lstlisting}[style=bibentry,label=Emme2013,caption={{@}Book\{Emme2013,…\} }]
+@Book{Emme2013,
+ author = {Burkhard Emme},
+ title = {Peristyl und Polis},
+ subtitle = {Entwicklung und Funktionen öffentlicher griechischer Hofanlagen},
+ publisher = WdG,
+ location = Berlin #{ and New York}, %@String partly used
+ year = {2013},
+ series = {Urban Spaces},
+ number = {1},
+}
+\end{lstlisting}
+\begin{refsection}\end{refsection}
+
+Default settings produce:
+\printbib[5em]{Emme2013}
+By activating option |publisher| you obtain:
+
+\begin{bibbsp}{Emme2013}
+\parbox[t]{1.7cm}{Emme 2013} \parbox[t]{9.4cm}{B. Emme, Peristyl und Polis. Entwicklung und Funktionen öffentlicher griechischer Hofanlagen, Urban Spaces 1 (Berlin {\color{red} – New York: Walter de Gruyter} 2013)}
+\end{bibbsp}
+And here a more detailed example with |origlocation|, |origyear| and |origpublisher|:
+\begin{lstlisting}[style=bibentry,label=Neufert2002,caption={{@}Book\{Neufert2002,…\} }]
+@Book{Neufert2002,
+ author = {Neufert, Ernst},
+ editor = {Neufert, Peter and Neufert, Cornelius and Neff, Ludwig and Franken, Corinna},
+ title = {Bauentwurfslehre},
+ subtitle = {Grundlagen, Normen, Vorschriften ...},
+ publisher = VT, %@String used
+ origpublisher = {Mann},
+ location = {Wiesbaden},
+ year = {2002},
+ edition = {37},
+ origlocation = Berlin, %@String used
+ origyear = {1936},
+}
+\end{lstlisting}
+\printbib[5em]{Neufert2002}
+
+\begin{bibbsp}{Neufert2002}
+\parbox[t]{1.7cm}{Neufert 2002} \parbox[t]{9.4cm}{%
+E. Neufert, Bauentwurfslehre. Grundlagen, Normen, Vorschriften ... Ed. by P.~Neufert – C. Neufert – L. Neff – C. Franken {\color{red} (Wiesbaden: Vieweg \textsuperscript{3}2002 [Berlin: Mann 1936])}}
+\end{bibbsp}
\subsubsection{edby}\label{edby}
\DescribeMacro{edby}
-Herausgeber werden nicht mehr zu Beginn des Sammelbandes aufgelistet und mit einem |(Hrsg.)| gekennzeichnet, sondern nach dem Titel des Sammelbandes mit dem Zusatz |hrsg. v.|
-
-
-|@Inproceedings{Wulf-Rheidt_2013,|\\
-| Author = {Wulf-Rheidt, Ulrike},|\\
-| Title = {Der Palast auf dem Palatin -- Zentrum im Zentrum},|\\
-| Subtitle = {Geplanter Herrschersitz oder|\\
-| Produkt eines langen Entwicklungsprozesses?},|\\
-| Pages = {277--289},|\\
-| Editor = {Dally, Ortwin and Fless, Friederike and Haensch,|\\
-| Rudolf and Pirson, Felix and Sievers, Susanne},|\\
-| Booktitle = {Politische Räume in vormodernen Gesellschaften},|\\
-| Booksubtitle = {Gestaltung – Wahrnehmung – Funktion},|\\
-| Year = {2013},|\\
-| Eventdate = {2009-11-18/2009-11-22},|\\
-| Eventtitle = {Internationale Tagung des DAI|\\
-| und des DFG-Exzellenzclusters TOPOI},|\\
-| Venue = {Berlin},|\\
-| Publisher = {Verlag Marie Leidorf},|\\
-| Location = {Rahden/Westf.},|\\
-| Series = MKT-lang,|\\
-| Shortseries = MKT-kurz,|\\
-| Number = {6},|\\
-|}|\\
-
-
- Ohne eine Option wird in der Bibliographie daraus:
- %\begin{bsp}\todo[noline]{dynamisches Beispiel}\fullcite{Wulf-Rheidt_2013}\end{bsp}
- \begin{bsp}
-\begin{refsection}
-\nocite{Wulf-Rheidt_2013}
-\printbibliography[title={Forschungsliteratur}]
-\end{refsection}
-\end{bsp}
+This option gives you a different output and position of editors:
+Instead of embedding ›(ed.)‹/›(Hrsg.)‹ right after the editor name
+ it places the adjunct ›ed. by‹/›hrsg. v.‹ behind the editor.
+ Furthermore, in case of |@Incollections| and |@Inproceedings| editor names and book title switch their positions as it is shown below.
+
+\begin{lstlisting}[style=bibentry,label=Wulf-Rheidt2013,caption={{@}Inproceedings\{Wulf-Rheidt2013,…\} }]
+@Inproceedings{Wulf-Rheidt2013,
+ author = {Wulf-Rheidt, Ulrike},
+ title = {Der Palast auf dem Palatin -- Zentrum im Zentrum},
+ subtitle = {Geplanter Herrschersitz oder Produkt eines langen Entwicklungsprozesses?},
+ pages = {277--289},
+ editor = {Dally, Ortwin and Fless, Friederike and Haensch, Rudolf and Pirson, Felix and Sievers, Susanne},
+ booktitle = {Politische Räume in vormodernen Gesellschaften},
+ booksubtitle = {Gestaltung – Wahrnehmung – Funktion},
+ location = {Rahden/Westf\adddot},
+ publisher = VML, %@String used
+ year = {2013},
+ venue = Berlin, %@String used
+ eventdate = {2009-11-18/2009-11-22},
+ eventtitle = {Internationale Tagung des DAI und des DFG-Exzellenzclusters TOPOI},
+ zenon = {001371402},
+ number = {6},
+ series = MKT, %@String used
+ shortseries = MKT-short, %@String used
+}
+\end{lstlisting}
+
+Without option |edby| this |@Inproceedings| would look like:
- mit der aktivierten Option |edby| verändert sich die Reihenfolge:
- \begin{bsp} \todo[noline]{manuelles Beispiel}
-U. Wulf-Rheidt, Der Palast auf dem Palatin – Zentrum im Zentrum. Geplanter Herrschersitz oder Produkt eines langen Entwicklungsprozesses?, in: {\color{red}Politische Räume in vormodernen Gesellschaften. Gestaltung – Wahrnehmung – Funktion, hrsg. v. O. Dally – F. Fless – R. Haensch – F. Pirson – S. Sievers}. Internationale Tagung des DAI und des DFG-Exzellenzclusters TOPOI Berlin 18.–22. November 2009, MKT 6 (Rahden/Westf. 2013) 277–289
- \end{bsp}
+\printbib[7em]{Wulf-Rheidt2013}
+
+But activating |edby| it changes to:
+
+\begin{bibbsp}{Wulf-Rheidt2013}
+\parbox[t]{2.3cm}{Wulf-Rheidt 2013} \parbox[t]{9cm}{%
+U. Wulf-Rheidt, Der Palast auf dem Palatin – Zentrum im Zentrum. Geplanter Herrschersitz oder Produkt eines langen Entwicklungsprozesses?, in: {\color{red}Politische Räume in vormodernen Gesellschaften. Gestaltung – Wahrnehmung – Funktion, ed. by O. Dally – F. Fless – R. Haensch – F. Pirson – S. Sievers}. Internationale Tagung des DAI und des DFG-Exzellenzclusters TOPOI Berlin November 18–22, 2009, MKT 6 (Rahden/Westf. 2013) 277–289}
+\end{bibbsp}
\subsubsection{width}\label{width}
\DescribeMacro{width}
-In der Bibliographie ist der Abstand zwischen dem Label (Autor und Jahr) und der vollständigen bibliographischen Angabe mit dem Wert |4em| angegeben.
-Wünscht man einen anderen Abstand, dann kann dieser selbst gewählt werden:
+|width| controls the width between label (which consists usually of |author| and |year|) and reference in the bibliography, pre-defined as |4em|.
+If you wish to have it bigger or smaller you can change it to every length you would like to have:
-|width = XY|
+|width =| \meta{length}
-Dafür kann XY für jede Länge stehen (bspw. |3em|, |7pt| oder |4cm|).
+\meta{length} stands for the length you want (e.\,g. |3em|, |7pt| or |4cm|), you can even do |-1em|;
+then there is no indent at all.
\subsubsection{counter}\label{counter}
- \DescribeMacro{counter}
- Möchte man die Anzahl an Zitationen eines Werks im Text erfahren,
- dann reicht es wenn man in der Präambel die Option |counter| aktiviert (|counter=true|).\footnote{Idee basiert auf \href{http://tex.stackexchange.com/a/14159/98739}{http://tex.stackexchange.com/a/14159/98739} und wurde entsprechend angepasst.}
- Dadurch wird am Ende eines jeden Literatureintrages die Anzahl der zitierten Einträge geschrieben.
- Die Ausgabe erfolgt bei eingestellter Sprache |ngerman|(im Paket |babel| oder in der |documentclass|) entsprechend auf Deutsch,
- ansonsten auf Englisch.
-\begin{bsp}
-Böhm – Eickstedt 2001\\
-\indent S. Böhm – K.-V. v. Eickstedt (Hrsg.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape wurde 1-mal zitiert.}
-\end{bsp}
-
-Ist ein Eintrag ohne Zitation in die Bibliographie geraten, wird dies entsprechend angezeigt:
-\begin{bsp}
-Böhm – Eickstedt 2001\\
-\indent S. Böhm – K.-V. v. Eickstedt (Hrsg.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape wurde {\color{red}{keinmal}} zitiert.}
-\end{bsp}
-
-
-
-Für alle Sprachen außer Deutsch:
- \begin{bsp}
-Böhm – Eickstedt 2001\\
- \indent S. Böhm – K.-V. v. Eickstedt (ed.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape cited {{\color{red}{not once}}}.}
- \end{bsp}
+\DescribeMacro{counter}
+If you like to know how many times you cited an author or work then use this option called |counter|.\footnote{The idea is based on \href{http://tex.stackexchange.com/a/14159/98739}{tex.stackexchange.com/a/14159/98739} and has been modified.}
+Depending on the language you chose in the preamble of your document the information will be given in German (|ngerman|) or in English (if not |ngerman|).
+
+\begin{bibbsp}{Boehm2001}
+\parbox[t]{3cm}{Böhm – Eickstedt 2001} \parbox[t]{8cm}{%
+S. Böhm – K.-V. v. Eickstedt (Hrsg.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape wurde 1-mal zitiert.}}
+\end{bibbsp}
+
+If there has been no citation in the text (but maybe a \cs{citeauthor} or \cs{citetitle}):
+\begin{bibbsp}{Boehm2001}
+\parbox[t]{3cm}{Böhm – Eickstedt 2001} \parbox[t]{8cm}{%
+S. Böhm – K.-V. v. Eickstedt (Hrsg.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape wurde {\color{red}{keinmal}} zitiert.}}
+\end{bibbsp}
+
+For all languages besides German:
+\begin{bibbsp}{Boehm2001}
+\parbox[t]{3cm}{Böhm – Eickstedt 2001} \parbox[t]{8cm}{%
+S. Böhm – K.-V. v. Eickstedt (ed.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape cited {{\color{red}{not once}}}.}}
+\end{bibbsp}
- \begin{bsp}
-Böhm – Eickstedt 2001\\
- \indent S. Böhm – K.-V. v. Eickstedt (ed.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape cited 1 time.}
- \end{bsp}
-
-Bei mehrmaligeb Zitationen ändert sich die Ausgabe entsprechend:
- \begin{bsp}
- Böhm – Eickstedt 2001\\
- \indent S. Böhm – K.-V. v. Eickstedt (ed.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape cited 3 times.}
-\end{bsp}
-
+If there has been only one citation:
+\begin{bibbsp}{Boehm2001}
+\parbox[t]{3cm}{Böhm – Eickstedt 2001} \parbox[t]{8cm}{%
+S. Böhm – K.-V. v. Eickstedt (ed.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape cited 1 time.}}
+\end{bibbsp}
+
+If there has been more than one citations:
+\begin{bibbsp}{Boehm2001}
+\parbox[t]{3cm}{Böhm – Eickstedt 2001} \parbox[t]{8cm}{%
+S. Böhm – K.-V. v. Eickstedt (ed.), Ithake. Festschrift Jörg Schäfer (Würzburg 2001) $\vert$ {\scshape cited 3 times.}}
+\end{bibbsp}
+
+Note that |biblatex| provides a related option |backref| which lists per reference every page
+that contains the cited reference. But having a different goal that option doesn't support counts.
-
-%%\subsubsection{miturl}\label{miturl}
-%%\DescribeMacro{miturl}
-%%Für Bibliographieeinträge die online sind (|@Online|) werden die URLs/DOI immer mit angegeben.
-%%
-%%| @Online{Selle_2008,|\\
-%%| Title = {Raum und Verhalten},|\\
-%%| Author = {Selle, Klaus},|\\
-%%| Url = {http://www.pt.rwth-aachen.de/%|\\
-%%|dokumente/lehre_materialien/c8_raum_verhalten.pdf},|\\
-%%| Urldate = {2015-06-26},|\\
-%%| Year = {2008},|\\
-%%| Subtitle = {Grundlagen und erste Folgerungen für das Wohnen in der Stadt},|\\
-%%| }|\\
-%%
-%%%\begin{bsp}\todo[noline]{dynamisches Beispiel}\fullcite{Selle_2008}\end{bsp}
-%% \begin{bsp}
-%%\begin{refsection}
-%%\nocite{Selle_2008}
-%%\printbibliography[title={Forschungsliteratur}]
-%%\end{refsection}
-%%\end{bsp}
-%%
-%%Handelt es sich jedoch um einen Artikel o. ä., dann kann man die Angabe der URL/DOI/eprint optional steuern:
-%%
-%%| @Article{Mastrocinque_2012,|\\
-%%| Title = {Magnetometry at Grumentum in Ancient Lucania},|\\
-%%| Author = {Mastrocinque, Attilio and Saggioro, Fabio},|\\
-%%| Journaltitle = {The Journal of Fasti Online},|\\
-%%| Pages = {1--5},|\\
-%%| Year = {2012},|\\
-%%| Url = {www.fastionline.org/docs/FOLDER-it-2012-245.pdf},|\\
-%%| urldate = {2015-07-21},|\\
-%%| }|\\
-%%
-%%
-%%\begin{bsp}\todo[noline]{manuelles Beispiel}
-%%A. Mastrocinque – F. Saggioro, Magnetometry at Grumentum in Ancient Lucania, The Journal of Fasti Online, 2012, 1–5,\\
-%% {\color{red}<|www.fastionline.org/docs/FOLDER-it-2012-245.pdf|> (21. 07. 2015)}
-%%\end{bsp}
-
-\subsection{Optionen der Literatureinträge}\label{optionen-literatur}
-\subsubsection{antik}\label{antik}
- \DescribeMacro{antik} \emph{Die Formatierungen von |antik| und |frgantik| sind vom Bibliographiestil |geschichtsfrkl| v.1.1 (Jonathan Zachhuber) inspiriert und modifiziert worden.}
+\subsubsection{initials}\label{initials}
+\DescribeMacro{counter}
+First names are abbreviated keeping digraphs and trigraphs instead of simple first letter initials.\footnote{Option was included from \href{http://tex.stackexchange.com/a/295486/98739}{tex.stackexchange.com/a/295486/98739}}
+
+\subsection{Bibliography entry options}\label{options-bibentry}
+\subsubsection{ancient}\label{ancient}
+\DescribeMacro{ancient}
+This option was found in an excellent |bib|\LaTeX-style called |geschichtsfrkl| (v.1.1 by Jonathan Zachhuber),
+so after some modifications we adopted and included it into |archaeologie|.
-Bei dem Zitieren antiker Autoren empfiehlt es sich diese Werke mit der Option |antik| zu versehen. Wir betrachten wieder ein Beispiel:\\[3pt]
-|@Book{Cic_Att,|\\
-| Title = {Atticus-Briefe},|\\
-| Author = {Tullius Cicero, Marcus},|\\
-| Editor = {Kasten, Helmut}, % wird bei @book nicht ausgelesen|\\
-| Publisher = {Artemis {\&} Winkler},|\\
-| Series = {Tusculum Bücherei},|\\
-| Year = {1980},|\\
-| Edition = {3},|\\
-| Keywords = {Quelle},|\\
-| Location = {Düsseldorf and Zürich},|\\
-| Options = {antik},|\\
-| Origlanguage = {latin},|\\
-| Origtitle = {epistulae ad Atticum },|\\
-| Origyear = {1959},|\\
-| Shorthand = {Cic. Att.},|\\
-| Translator = {Kasten, Helmut},|\\
-| Shortauthor = {Cicero} % relevant für \citeauthor|\\
-| }|\\[3pt]
-
-
- Beim Zitieren wird nur das Feld |shorthand| berücksichtigt:
- |\cite[1, 3,3]{Cic_Att}| liefert
- \begin{refsection}
-\begin{bsp}
-\cite[1, 3,3]{Cic_Att}
-%Cic. Att. 1, 3,3
-\end{bsp}
-Dieses Feld |shorthand| wird für das Literaturverzeichnis verwendet, wo es als ›Schlüssel‹ auftaucht.:
-\begin{bsp}
-\printbibliography[title={Antike Quellen}]
-\end{bsp}
-\end{refsection}
-
+If you intend to cite ancient authors we strongly recommend this option to you
+because it enables you to cite ancient texts in the style archaeologists and
+historians are used to \emph{plus} to get entirely supported bibliography referencing.
+
+Let us have a look at an example:
+\begin{lstlisting}[style=bibentry,label=Cic:Att,caption={{@}Book\{Cic:Att,…\} }]
+@Book{Cic:Att,
+ author = {Tullius Cicero, Marcus},
+ editor = {Kasten, Helmut},
+ title = {Atticus-Briefe},
+ publisher = AW, %@String used
+ location = {Düsseldorf and Zürich},
+ year = {1980},
+ series = {Tusculum Bücherei},
+ edition = {3},
+ origyear = {1959},
+ origtitle = {epistulae ad Atticum},
+ origlanguage = {latin},
+ translator = {Kasten, Helmut},
+ shorthand = {Cic. Att.},
+ shortauthor = {Cicero},
+ keywords = {ancient},
+ options = {ancient}, %!!
+}
+\end{lstlisting}
+Instead of applying |author| and |year| as label the option |ancient| takes the field |shorthand| into account.
-Es gibt auch antike Texte, die in einem Sammelband (|@incollection|) herausgegeben sind.
-Dieser Fall stellt jedoch kein Problem dar und wird analog zu |@book| geplottet.
-Ein Beispiel verschafft Klarheit:
-
-|@Incollection{Cic_Sest,|\\
-| Title = {Rede für P.\ Sestius},|\\
-| Author = {Tullius Cicero, Marcus},|\\
-| Editor = {Fuhrmann, Manfred},|\\
-| Pages = {110--185},|\\
-| Publisher = {Artemis \& Winkler},|\\
-| Year = {1993},|\\
-| Series = {Sammlung Tusculum},|\\
-| Volume = {II},|\\
-| Keywords = {Quelle},|\\
-| Location = {München},|\\
-| Booktitle= {Die politischen Reden},|\\
-| Options = {antik},|\\
-| Origlanguage = {latin},|\\
-| Origtitle = {pro P.\ Sestio},|\\
-| Shorthand = {Cic. Sest.},|\\
-| Translator = {Fuhrmann, Manfred},|\\
-| Shortauthor = {Cicero}|\\
-|}|\\
+So you write in your text
+\begin{lstlisting}
+\cite[1, 3,3]{Cic:Att}\end{lstlisting}
+and it will be printed as
-\begin{bsp}
\begin{refsection}
-\nocite{Cic_Sest}
-\printbibliography[title={Antike Quellen}]
-\end{refsection}
-\end{bsp}
-
-
-%\subsubsection{frg}\label{frg}
-% \DescribeMacro{frg}
-%%% Wenn man Fragmente zitiert kann man dazu die Option |frg| bzw. |frgantik| wählen. Das wirkt sich dann leicht unterschiedlich auf die Zitatsform aus. Wir betrachten das am besten wieder an Beispielen: Der |bib|-Eintrag\\[3pt]
-%|@book{alkaios,|\\
-%| author={{Alkaios}},|\\
-%| shorthand={Alk.},|\\
-%| sortname={Edgar Lobel and Denys Page},|\\
-%| maintitle={Poetarum Lesbiorum Fragmenta},|\\
-%| editor={Edgar Lobel and Denys Page},|\\
-%| shorteditor={LP},|\\
-%| address={Oxford},|\\
-%| year={1955},|\\
-%| keywords={quelle},|\\
-%| options={frg}|\\
-%|}|\\[3pt]
-%
-%\begin{refsection}
-% \begin{bsp}
-% \cite[2]{alkaios}
-% \end{bsp}
-%
-% In der Bibliographie unterscheidet sich der Eintrag gegenüber |antik| geringfügig:
-%\begin{bsp}
-%\printbibliography[title={Antike Quellen}]
-%\end{bsp}
-%\end{refsection}
-
-%% Das |sorttitle|-Feld sorgt hier dafür, dass der Eintrag nicht unter \enquote{Alkaios} sondern den Namen der Herausgeber sortiert wird. Im Literaturverzeichnis sieht das dann folgendermaßen aus:
-%%\begin{bsp} {\sc Lobel}, Edgar / {\sc Page}, Denys (Hrsg.): Poetarum Lesbiorum Fragmenta, Oxford 1955.\end{bsp}
-%% Wenn man ihn zitiert, erscheint bei |\cite[2]{alkaios}|
-%% \begin{bsp} Alk. frg. 2 LP.\end{bsp}
-%% Bemerkenswert ist insbesondere die Verwendung des |shorteditor|-Feldes. Ansonsten wird nur der Nachname des Herausgebers angegeben. Details findet man in \cref{driver}.
-%%
+\begin{bsp}
+\cite[1, 3,3]{Cic:Att}
+\end{bsp}\end{refsection}
+
+Equally the field |shorthand| is used as label in the bibliography instead of an author-year label:
+\printbib{Cic:Att}
+
+Take notice how |options={ancient}| treats editor and translator in this example.
+While the ancient author is mentioned first, translator and editor are put behind the title,
+in this case even united due to fact that editor and translator are identical.
+
+This works not only with |@Book| but also with those ancient texts which are part of an |@Incollection| employing them similarly to the entries defined as |@Book|.
+
+Another example:
+\begin{lstlisting}[style=bibentry,label=Cic:Sest,caption={{@}Inbook\{Cic:Sest,…\} }]
+@Inbook{Cic:Sest,
+ author = {Tullius Cicero, Marcus},
+ title = {Rede für P.\ Sestius},
+ booktitle = {Die politischen Reden},
+ year = {1993},
+ editor = {Fuhrmann, Manfred},
+ volume = {II},
+ publisher = AW, %@String used
+ pages = {110--185},
+ origlanguage = {latin},
+ series = {Sammlung Tusculum},
+ location = Munich, %@String used
+ intranslator = {Fuhrmann, Manfred},
+ keywords = {ancient},
+ options = {ancient},
+ origtitle = {pro P. Sestio},
+ shortauthor = {Cicero},
+ shorthand = {Cic. Sest.},
+}
+\end{lstlisting}
+
+Even support for several languages is taken into account as this bibliography entries show:
+\printbiball{Cic:Sest}
+
+\subsubsection{frgancient}\label{frgancient}
+\DescribeMacro{frgancient}
+When dealing with fragments of ancient texts often the edition respective the editor is important to cite.
+If you want to cite such a collection of fragments use |options={frgancient}|.
+In this case the editor (|shorteditor| or |editor|) will be put in after the \marg{postnote}.
+
+\begin{lstlisting}[style=bibentry,label=Fest,caption={{@}Book\{Fest,…\} }]
+@Book{Fest,
+ author = {Pompeius Festus, {\relax Sex}tus},
+ editor = {Lindsay, Wallace Martin},
+ title = {De verborum significatu quae supersunt cum Pauli epitome},
+ publisher = {Teubner},
+ location = Leipzig, %@String used
+ year = {1965},
+ series = {Bibliotheca scriptorum et Grecorum et Romanorum Teubnerina},
+ origyear = {1913},
+ shorthand = {Fest.},
+ shortauthor = {Festus},
+ keywords = {ancient},
+ options = {frgancient},
+ shorteditor = {L},
+}
+\end{lstlisting}
-\subsubsection{frgantik}\label{frgantik}
- \DescribeMacro{frgantik}
- Mit der Option |frgantik| werden die Bibliographieeinträge versehen, die antike Fragmente beinhalten, da die Herausgeber dieser Fragmente relevant sind. Dies wird in der Zitierweise berücksichtigt.
- \\[3pt]
-|@Book{Fest,|\\
-| Title = {De verborum significatu quae supersunt cum Pauli epitome},|\\
-| Author = {Pompeius Festus, {\relax Sex}tus},|\\
-| Editor = {Lindsay, Wallace Martin},|\\
-| ShortEditor = {L},|\\
-| Publisher = {Teubner},|\\
-| Series = {Bibliotheca scriptorum et Graecorum et Romanorum Teubneriana},|\\
-| Year = {1965},|\\
-| Keywords = {Quelle},|\\
-| Location = {Leipzig},|\\
-| Options = {frgantik},|\\
-| Origyear = {1913},|\\
-| Shorthand = {Fest.},|\\
-| Shortauthor = {Festus}|\\
-|}|\\[3pt]
- Zitiert man diesen Eintrag durch |\cite[3]{Fest}|, so wird der oder die Herausgeber genannt; ist das Feld |Shorteditor| ausgefüllt, dann wird dieses angegeben, ansonsten die Nachnamen aus |Editor|.
-\begin{refsection}
- \begin{bsp}\todo[noline]{dynamisches Beispiel}
- \cite[3]{Fest}
- \end{bsp}
-
- In der Bibliographie unterscheidet sich der Eintrag gegenüber |antik| geringfügig:
+When you cite this entry in this example with |\cite[3]{Fest}| the field |shorteditor| will be shown.
\begin{bsp}
-\printbibliography[title={Antike Quellen}]
+Fest. 3 L
\end{bsp}
-\end{refsection}
-
+In the bibliography the reference differentiates slightly from |options = {ancient}| because of the missing ancient author of fragment collections,
+so the editors name is printed in the first place:
+\printbib[2em]{Fest}
\subsubsection{corpus}\label{corpus}
\DescribeMacro{corpus}
-Für bestimmte Corpora (Inschriften, Münzen, etc.) wird für gewöhnlich mit einer gängigen Abkürzung zitiert.
-Diese Abkürzung des Corpus wird im Bibliographieeintrag unter |shorthand| eingetragen.
-Nun kann man sehr einfach das gewünschte Corpus in der Fußnote zitieren, mit |prenote| und |postnote|-Feldern. Bei anderen Autoren-Einträge, die mittels |shorthand| zitiert werden, wird ein Komma zwischen Nachname und |postnote| gesetzt. Dank |options=corpus| fällt dieses Komma weg.
-
-Das Beispiel zeigt die Option für die lateinischen Inschriften:
-
-|@Book{CIL,|\\
-| Title = CIL-lang,|\\
-| Keywords = {Sigel},|\\
-| Options = {corpus},|\\
-| Shorthand = CIL-kurz,|\\
-|}|\\
+There are some corpora (e.\,g. inscriptions, minted coins, vases, etc.) which are usually cited with a common abbreviation.
+Those abbreviations are typed in in the field |shorthand|.
+To cite such a corpus with its abbreviation you have to write an additional |options={corpus}| in the bibliographical entry.
+Now you can cite it as usual with \oarg{prenote} or \oarg{postnote} you like to have.
+
+This example shows the behaviour with a corpus that is common for Latin epigraphy:
+\begin{lstlisting}[style=bibentry,label=CIL,caption={{@}Book\{CIL,…\} }]
+@Book{CIL,
+ title = CIL, %@String used
+ location = Berlin, %@String used
+ year = {1863--},
+ shorthand = CIL-short, %@String used
+ keywords = {corpus}, %!
+ options = {corpus},
+}
+\end{lstlisting}
-Zitiert wird, wie gewöhnlich, mit |\cite[06, 01234]{CIL}|. Daraus wird:
+It will be cited with:
+\begin{lstlisting}
+\cite[06, 01234]{CIL}.
+\end{lstlisting}
- \begin{refsection}
+And the result is:
\begin{bsp}
-\cite[06, 01234]{CIL}
-%Cic. Att. 1, 3,3
+CIL 06, 01234
\end{bsp}
-Dieses Feld |shorthand| wird für das Literaturverzeichnis verwendet, wo es als ›Schlüssel‹ auftaucht.:
-\begin{bsp}
-\printbibliography[keyword=Sigel,%
-title={Abkürzungen und Sigel}]\end{bsp}
-\end{refsection}
-
+The field |shorthand| will be used for bibliography reference,
+where it is listed as label.
+\printbib{CIL}
-Aufgrund der Setzung von |keywords=Sigel| können diese Art von Corpora in einer separaten Bibliographie aufgeführt werden. Siehe dazu \cref{bibliographie}
+If you also set something like |keywords={corpus}| then you can make a separate bibliography with all the copora cf. \cref{bibliographie}.
\changes{v1.1}{2015/06/15}{Modifikation der Option |corpus|.}
- \section{Beschreibung der Eintragtypen (Beispiele)} \label{beispiele}
-
-
- Der |archaeologie|-Zitierstil definiert unterschiedliche bibliography driver, die es erlauben verschiedene Arten Werke zu zitieren.
- Diese werden im Folgenden zusammen mit den für sie relevanten Optionen beschrieben.
-
-
-
- \subsection{Typ \texttt{@book}}\label{book}
- \DescribeMacro{@book}
- \DescribeMacro{@collection}\footnote{Der Typ |@collection| entspricht hier dem Typ |@book|.}
- Fangen wir ganz einfach an: Zu einem einfachen Buch sieht der Eintrag in der |bib|-Datei ungefähr folgendermaßen aus:\\[3pt]
-
-
-|@Book{Mann_2011,|\\
-| Author = {Mann, {\relax Chr}istian},|\\
-| Title = {\enquote{Um keinen Kranz, um das Leben kämpfen wir!}},|\\
-| Subtitle = {Gladiatoren im Osten des Römischen Reiches| \\| und die Frage der Romanisierung},|\\
-| Series = {Studien zur Alten Geschichte},|\\
-| Number = {14},|\\
-| Location = {Berlin},|\\
-| Publisher = {Verlag Antike},|\\
-| Year = {2011},|\par
-|}|\\
-\begin{refsection}
-Zitiert man daraus mit |\footnote{\cite[Vgl.][142--144]{Mann_2011}.}|, dann erscheint in der Fußnote\footnote{\cite[Vgl.][142--144]{Mann_2011}.}.
-In der Bibliographie wird der Eintrag wiedergegeben mit:
-%\begin{bsp}\fullcite{Mann_2011}\end{bsp}
-\begin{bsp}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+\section{Examples of entry types}\label{beispiele}
+The style |archaeologie| defines several so-called bibliographical drivers,
+which allow to cite different kind of works.
+Below we describe how they are working and which fields you should fill out.
+For the examples we don't use any further options which are described above.
-\subsubsection{Festschriften u.ä.}
-Um Festschriften/Gedenkschriften/Ausstellungskataloge/Auktionskataloge entsprechend zu zitieren, gehört der Zusatz ins Feld |titleaddon|, bzw. wenn es sich um ein |@inbook| oder |@inproceedings| handelt, entsprechend ins Feld |Booktitleaddon| (\cref{inbook}).
-
-
-|@Book{Boehm_2001,|\\
- | Title = {Ithake},|\\
- | Editor = {Böhm, Stephanie and Eickstedt, Klaus-Valtin von},|\\
- | Titleaddon = {Festschrift Jörg Schäfer},|\\
- | Publisher = {Ergon-Verlag},|\\
- |Year = {2001},|\\
- | Location = {Würzburg},|\\
-|}|\par
-
-%\begin{bsp}\fullcite{Boehm_2001}\end{bsp}
-\begin{refsection}
-\begin{bsp}
-\nocite{Boehm_2001}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+\subsection{Type \texttt{@Book}}\label{book}
+\DescribeMacro{@Book}
+\DescribeMacro{@Collection}%\footnote{Der Typ |@collection| entspricht hier dem Typ |@Book|.}
+Let’s start with an easy example:
+a book or a collection (both are treated equally).
+You can use the following fields:
+\begin{description}
+\item[mandatory:]
+|author|/|editor|,
+|title|, |subtitle|, |titleaddon|,
+|location|, |year|,
+\item[optional:]
+|maintitle|, |mainsubtitle|, |maintitleaddon|, |volume|,
+|publisher|, |series|, |number|, |edition|,
+|origyear|, |origlocation|, |origpublisher|,
+|translator|, |origlanguage|,
+|related|, |relatedtype|,
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+ \end{description}
- \subsubsection{Übersetzungen u.ä.}
-Liegt ein Werk in Übersetzung vor, gibt es die Möglichkeit den Übersetzer/in, Ausgangssprache und ursprünglichen Titel automatisch anzeigen zu lassen.
-Dies funktioniert mit den Literatureinträgen |related| und |relatedtype| (\cref{review}).
-
-Im Beispiel wird die Verwendung klar:
-Das Ausgangswerk ist |Zanker_2014|.
-
-| @Book{Zanker_2014,|\\
-| Title = {Die römische Stadt},|\\
-| Author = {Zanker, Paul},|\\
-| Location = {München},|\\
-| Publisher = {CHB},|\\
-| Subtitle = {Eine kurze Geschichte},|\\
-| Year = {2014},|\\
-| Language = {german},|\\
-| }|\\
-
-Die Übersetzung davon ist |Zanker_2013|:
-
-| @Book{Zanker_2013,|\\
-| Title = {La città romana},|\\
-| Author = {Zanker, Paul},|\\
-| Location = {Roma-Bari},|\\
-| Publisher = {GLF},|\\
-| Series = {Storia della città},|\\
-| Year = {2013},|\\
-| Language = {italian},|\\
-| Relatedtype = {translationof},|\\
-| Related = {Zanker_2014},|\\
-| Translator = {Senatore, Anna Maria}|\\
-| }|\\
-
-
-
- \begin{refsection}
-\begin{bsp}
-\nocite{Zanker_2013,Zanker_2014}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
-
- \subsubsection{Mehrbändige Monographien mit Untertitel}
-Es kommt vor, dass man einen Band einer mehrbändigen Monographie zitiert, der einen eigenen Untertitel hat.
-Damit die jeweilige Zahl des Bandes an korrekter Stelle ausgegen wird,
-muss ein Bibliographieeintrag wie folgt aussehen:
-
-|@Book{MacDonald_1986,|\\
-| Title = {An urban Appraisal},|\\
-| Author = {MacDonald, William L.},|\\
-| Location = {New Haven and London},|\\
-| Number = {35},|\\
-| Publisher = {YUP},|\\
-| Series = {Yale Publictions in the History of Art},|\\
-| Year = {1986},|\\
-| Volume = {II},|\\
-| Maintitle = {The Architecture of the Roman Empire}|\\
-|}|\\
-
-Damit werden Haupttitel der Monographie (|Maintitle|) und Titel des Bandes (|Titel|) getrennt voneinander eingegeben, sodass die Bandzahl (|volume|) vor den Titel gesetzt werden kann.
-
-\begin{refsection}
-\begin{bsp}
-\nocite{MacDonald_1986}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+
+An entry of a book might look as this in your |bib|-file:
+\begin{lstlisting}[style=bibentry,label=Mann2011,caption={{@}Book\{Mann2011,…\} }]
+@Book{Mann2011,
+ author = {Mann, Christian},
+ title = {\enquote{Um keinen Kranz, um das Leben kämpfen wir!}},
+ subtitle = {Gladiatoren im Osten des Römischen Reiches und die Frage der Romanisierung},
+ publisher = {Verlag Antike},
+ location = Berlin, %@String used
+ year = {2011},
+ series = {Studien zur Alten Geschichte},
+ number = {14},
+}
+\end{lstlisting}
+
+A citation in a footnote is done with
+\begin{lstlisting}
+\footnote{\cite[Vgl.][142--144]{Mann2011}.}
+\end{lstlisting}
+
+and it looks like this in footnotes\footnote{Vgl. Mann 2011, 142--144.}
+and like this in the bibliography.
+\printbib[5em]{Mann2011}
+
+\subsubsection{›Festschrift‹, commemorative volume, catalogue, etc.}
+To mark that the book or collection is a so-called ›Festschrift‹/ commemorative volume,
+or an exhibition or auction catalogue you need an additional note to make it clear.
+We suggest to use the field |titleaddon| or if it is a |@Incollection| or |@Inproceedings| you can use the field |booktitleaddon| (for papers in collections see \cref{inbook}).
+\begin{lstlisting}[style=bibentry,label=Boehm2001,caption={{@}Book\{Boehm2001,…\} }]
+@Book{Boehm2001,
+ editor = {Böhm, Stephanie and Eickstedt, Klaus-Valtin von},
+ title = {Ithake},
+ publisher = {Ergon-Verlag},
+ location = {Würzburg},
+ year = {2001},
+ titleaddon = {Festschrift Jörg Schäfer},
+}
+\end{lstlisting}
+\printbib[9em]{Boehm2001}
+
+\subsubsection{Translated book}
+If you cite a translated book you can link it to the original book and let display the translator as well as the original language.
+To obtain this fill the fields |related| and |relatedtype| (for further information see the informations about reviews in \cref{review}).
+
+It will be more clear with this example:
+The first edition of \citetitle*{Zanker2009} by \citeauthor*{Zanker2009} has been published in 1987 (|origyear|), but by now it has been released in its 5th edition.
+
+\begin{lstlisting}[style=bibentry,label=Zanker2009,caption={{@}Book\{Zanker2009,…\} }]
+@Book{Zanker2009,
+ author = {Zanker, Paul},
+ title = {Augustus und die Macht der Bilder},
+ publisher = CHB, %@String used
+ location = Munich, %@String used
+ year = {2009},
+ edition = {5},
+ origlocation = Leipzig, %@String used
+ origyear = {1987},
+ eprint = {000250713},
+ eprinttype = {zenon},
+ language = {german},
+ origpublisher = {Koehler \& Amelang},
+}
+\end{lstlisting}
+
+In \citeyear{Zanker1988}, one year later after the first edition (|origyear|) the book has been translated by A. H. Shapiro:
+\begin{lstlisting}[style=bibentry,label=Zanker1988,caption={{@}Book\{Zanker1988,…\} }]
+@Book{Zanker1988,
+ author = {Zanker, Paul},
+ title = {The Power of Images in the Age of Augustus},
+ publisher = UMP, %@String used
+ location = {Ann Arbor},
+ year = {1988},
+ series = {Jerome Lectures},
+ number = {16},
+ translator = {Shapiro, Alan H.},
+ language = {english},
+ related = {Zanker2009},
+ relatedtype = {translationof},
+}
+\end{lstlisting}
+
+The translated book |Zanker1988| is connected with the book |Zanker2009| via the field |related = |\marg{bibtex-key}
+and the relation got specified with the field |relatedtype|, in this case it is a translation so |={translationof}|.
+
+You don't have to cite |Zanker2009| to have the information visible in the bibliography.
+It will be included automatically. For the following bibliography we only use |\cite{Zanker1988}|:
+
+\printbiball[5em]{Zanker1988}
+
+
+\subsubsection{Multiple volumes of a monograph}
+There is the case that you have to cite a book which consists of several volumes,
+usually there is a volume with text and one volume with plates.
+To cite particularly e.\,g. the second volume you can do the following.
+Let’s assume this is the bibliography entry:
+\begin{lstlisting}[style=bibentry,label=MacDonald1986,caption={{@}Book\{MacDonald1986,…\} }]
+@Book{MacDonald1986,
+ author = {MacDonald, William L.},
+ title = {An urban Appraisal},
+ publisher = YUP, %@String used
+ location = {New Haven and }# London, %@String used
+ year = {1986},
+ maintitle = {The Architecture of the Roman Empire},
+ volume = {II},
+ series = {Yale Publications in the History of Art},
+ number = {35},
+}
+\end{lstlisting}
+In the bibliography the main title of the monograph (|maintitle|)
+and the title of the book (|title|) are shown separately so the volume (|volume|)
+appears before the title of the book
+\printbib[7em]{MacDonald1986}
- \subsection{Typ \texttt{@inbook / @incollection}}\label{inbook}
+\subsection{Type \texttt{@Inbook / @Incollection}}\label{inbook}
+\DescribeMacro{@Incollection}\DescribeMacro{@Inbook}
+Single entries/chapters of a collection are cited best when they are set up as |@Incollection| or |@Inbook|.
- \DescribeMacro{@incollection}
- Kapitel aus Sammelbändern macht man am Besten mit dem Typ |@incollection|.
- Am besten sieht man das wieder an Hand eines Beispiels:\\[3pt]
-
-|@Incollection{Carter_2014,|\\
-| Title = {Spectacle in Rome, Italy, and the Provinces},|\\
-| Author = {Carter, Michael J. and Edmondson, Jonathan},|\\
-| Editor = {Bruun, Christer and Edmondson, Jonathan},|\\
-| Pages = {537--558},|\\
-| Publisher = {Oxford University Press},|\\
-| Year = {2014},|\\
-| Location = {Oxford},|\\
-| Booktitle = {The Oxford Handbook of Roman Epigraphy},|\\
-|}|\\
-
-%\begin{bsp}\todo[noline]{dynamisches Beispiel}\fullcite{Carter_2014}\end{bsp}
-\begin{refsection}
-\begin{bsp}
-\nocite{Carter_2014}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+\begin{description}
+\item[mandatory:]
+|author|, |title|, |subtitle|, |titleaddon|,
+|editor|, |booktitle|, |booksubtitle|, |booktitleaddon|,
+|location|, |year|, |pages|,
+\item[optional:]
+|maintitle|, |mainsubtitle|, |maintitleaddon|, |volume|,
+|publisher|, |series|, |number|, |edition|,
+|origyear|, |origlocation|, |origpublisher|,
+|translator|, |origlanguage|,
+|related|, |relatedtype|,
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+ \end{description}
-Zitiert man einen Beitrag aus einer Festschrift, o.ä., dann kann das folgendermaßen aussehen:
-
-|@Incollection{Hoelscher_2001,|\\
- | Author = {Hölscher, Tonio},|\\
- | Title = {Schatzhäuser -- Banketthäuser?},|\\
- | Pages = {143--152},|\\
- | Editor = {Böhm, Stephanie and Eickstedt, Klaus-Valtin von},|\\
- | Booktitle = {Ithake},|\\
- | Booktitleaddon = {Festschrift Jörg Schäfer},|\\
- | Publisher = {Ergon-Verlag},|\\
- |Year = {2001},|\\
- | Location = {Würzburg},|\\
-|}|\par
-
-In der Bibliographie ist die Darstellung:
-
-%\begin{bsp}\fullcite{Hoelscher_2001}\end{bsp}
-\begin{refsection}
-\begin{bsp}
-\nocite{Hoelscher_2001}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
- \subsubsection{Kleinere Kurzreihen}
-Es kommt auch vor, dass man einen Band einer kleinen Reihe (nicht Serie) zitieren muss.
-Zum Beispiel dieses Buch:
-
-|@Incollection{Fentress_2003,|\\
-| Title = {Cosa in the Republic and Early Empire},|\\
-| Author = {Fentress, Elizabeth and John Bodel and Adam Rabinowitz and Rabun Taylor},|\\
-| Booksubtitle = {Excavations 1991--1997},|\\
-| Booktitle = {An Intermittent Town},|\\
-| Editor = {Fentress, Elizabeth},|\\
-| Location = {Ann Arbor, Mich.},|\\
-| Number = {2},|\\
-| Pages = {13--62},|\\
-| Publisher = UMP,|\\
-| Series = MemAmAc-lang,|\\
-| Shortseries = MemAmAc-kurz,|\\
-| Year = {2003},|\\
-| Volume = {V},|\\
-| Maintitle = {Cosa},|\\
-|}|\par
-
-Es handelt sich also um den fünften Band (Volume) mit dem Titel (Title) ›Cosa in the Republic and Early Empire‹ der Reihe ›Cosa‹ (Maintitle) darstellt, was wiederum den zweiten Band (Number) der Serie ›MemAmAc‹ ist.
-
-\begin{refsection}
-\begin{bsp}
-\nocite{Fentress_2003}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
- \subsubsection{Bestandskatalog}
- Die Angabe von Bestandskatalogen weicht in einer Kleinigkeit von Sammelbänden o.ä. ab:
- Es wird kein Titel genannt. Damit fällt auch das Komma nach dem Autor weg.
-Zwei Beispiele verdeutlichen dies.
-
-|@inbook{Kohlmeyer_1983,|\\
-|author = {K. Kohlmeyer},|\\
-|editor = {U. Gehrig},|\\
-|booktitle = {Tierbilder aus vier Jahrtausenden},|\\
-|booksubtitle = {Antiken der Sammlung Mildenberg},|\\
-|location = {Mainz},|\\
-|pages = {20 Nr. 9},|\\
-|year = {1983}|\\
-|}|\\
-
-und
-
-
-|@inbook{Parlasca_1969,|\\
-|author = {K. Parlasca},|\\
-|booktitle = {Helbig},|\\
-|volume = {III},|\\
-|edition = {4},|\\
-|location = {Tübingen},|\\
-|pages = {98 f. Nr. 2176},|\\
-|year ={1969},|\\
-|}|\\
-
-pages = {98 f. Nr. 2176},
-
- \begin{refsection}
-\begin{bsp}
-\nocite{Kohlmeyer_1983,Parlasca_1969}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+This following example should make it clear:
+ \begin{lstlisting}[style=bibentry,label=Carter2014,caption={{@}Incollection\{Carter2014,…\} }]
+@Incollection{Carter2014,
+ author = {Carter, Michael J. and Edmondson, Jonathan},
+ title = {Spectacle in Rome, Italy, and the Provinces},
+ pages = {537--558},
+ editor = {Bruun, Christer and Edmondson, Jonathan},
+ booktitle = {The Oxford Handbook of Roman Epigraphy},
+ publisher = OUP, %@String used
+ location = {Oxford},
+ year = {2014},
+}
+\end{lstlisting}
+
+\printbib[11em]{Carter2014}
+
+You can also have contributions to a ›Festschrift‹ etc. set up as |@Incollection|,
+but then notice the additional information in |booktitleaddon|.
+\begin{lstlisting}[style=bibentry,label=Hoelscher2001,caption={{@}Incollection\{Hoelscher2001,…\} }]
+@Incollection{Hoelscher2001,
+ author = {Hölscher, Tonio},
+ title = {Schatzhäuser -- Banketthäuser?},
+ pages = {143--152},
+ editor = {Böhm, Stephanie and Eickstedt, Klaus-Valtin von},
+ booktitle = {Ithake},
+ publisher = {Ergon-Verlag},
+ location = {Würzburg},
+ year = {2001},
+ booktitleaddon = {Festschrift Jörg Schäfer},
+}
+\end{lstlisting}
+In the bibliography it will look like:
+\printbib[6em]{Hoelscher2001}
+
+\subsubsection{Short series}
+Some books or collections are part of a small series (not an ongoing series).
+This book is part of the series called abbreviated \emph{MemAmAc}.
+Have a look:
+\begin{lstlisting}[style=bibentry,label=Fentress2003,caption={{@}Incollection\{Fentress2003,…\} }]
+@Incollection{Fentress2003,
+ author = {Fentress, Elizabeth and John Bodel and Adam Rabinowitz and Rabun Taylor},
+ title = {Cosa in the Republic and Early Empire},
+ pages = {13--62},
+ editor = {Fentress, Elizabeth},
+ booktitle = {An Intermittent Town},
+ booksubtitle = {Excavations 1991--1997},
+ publisher = UMP, %@String used
+ location = {Ann Arbor, Mich.},
+ year = {2003},
+ volume = {V},
+ series = MemAmAc, %@String used
+ number = {2},
+ maintitle = {Cosa},
+ shortseries = MemAmAc-short, %@String used
+}
+\end{lstlisting}
+As we can see it is the fifth volume (|volume|) of the series with the main title
+\emph{Cosa} (|maintitle|) but has an individual title (|title|) which is
+\emph{Cosa in the Republic and Early Empire}, furthermore it is the second book (|number|)
+of the series \emph{MemAmAc} (|series|).
+
+Notice the different language-based behaviour of ›et. al.‹ for more than two authors/editors.
+\printbiball[7em]{Fentress2003}
+
- Der Typ |@inbook| entspricht hier dem Typ |@incollection|.
+\subsubsection{Inventory catalogue}
+The output of an inventory catalogue changes slightly compared to collections or sth. similar.
+The title is omitted and therefore there is no comma after the author’s name.
+We provide two examples so you see the difference.
+\begin{lstlisting}[style=bibentry,label=Kohlmeyer1983,caption={{@}Inbook\{Kohlmeyer1983,…\} }]
+@Inbook{Kohlmeyer1983,
+ author = {K. Kohlmeyer},
+ booktitle = {Tierbilder aus vier Jahrtausenden},
+ year = {1983},
+ editor = {U. Gehrig},
+ booksubtitle = {Antiken der Sammlung Mildenberg},
+ pages = {20 Nr. 9},
+ location = Mainz, %@String used
+}
+\end{lstlisting}
+and the second example
+
+\begin{lstlisting}[style=bibentry,label=Parlasca1969,caption={{@}Inbook\{Parlasca1969,…\} }]
+@Inbook{Parlasca1969,
+ author = {K. Parlasca},
+ booktitle = {Helbig},
+ year = {1969},
+ volume = {III},
+ edition = {4},
+ pages = {98\psq\ Nr. 2176},
+ location = Tuebingen, %@String used
+}
+\end{lstlisting}
- \subsection{Typ \texttt{@article}}\label{article}
-%%
-\DescribeMacro{@article}
-
-|@Article{Evangelidis_2014,|\\
-| Title = {Agoras {and} Fora},|\\
-| Author = {Evangelidis, Vasilis},|\\
-| Journaltitle = BSA-lang,|\\
-| Pages = {335--356},|\\
-| Volume = {109},|\\
-| Year = {2014},|\\
-| Doi = {10.1017/s006824541400015x},|\\
-| Shortjournal = BSA-kurz,|\\
-| Subtitle = {Developments in the Central Public Space of|\\
-| the Cities of Greece during the {Roman} Period},|\\
-|}|\\
-
-
-%\begin{bsp}\todo[noline]{dynamisches Beispiel}\fullcite{Evangelidis_2014}\end{bsp}
-\begin{refsection}
-\begin{bsp}
-\nocite{Evangelidis_2014}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+\printbib[6em]{Kohlmeyer1983}
+\begin{refsection}\end{refsection}
+\printbiball[6em]{Parlasca1969}
+
-Es gibt die Möglichkeit bei Zeitschriftenartikel den Publikationszustand anzugeben.
-Die beliebige Eingabe erfolgt im Feld |pubstate| und wird ans Ende des bibliographischen Eintrages gesetzt.
+\subsection{Type \texttt{@Article}}\label{article}
+\DescribeMacro{@Article} This is probably the most common type
+because you find detailed information about specific topics in articles.
-Es empfiehlt sich allerdings sich auf ein paar Standarts zu beschränken, da diese sprachabhängig ausgegeben werden:
\begin{description}
-\item[inpreparation] Typoskript wird für die Publikation vorbereitet. \\(|pubstate = {inpreparation}|)
-\item[submitted] Typoskript wurde bei der Zeitschrift eingereicht.\\(|pubstate = {submitted}|)
-\item[forthcoming] Typoskript wurde von der Zeitschrift akzeptiert.\\(|pubstate = {forthcoming}|)
-\item[inpress] Typoskript liegt bereits als fertig gesetzter Artikel vor.\\(|pubstate = {inpress}|)
-\item[prepublished] Artikel liegt in einer (online) Vorabversion vor. \\(|pubstate = {prepublished}|)
-\end{description}
+\item[mandatory:]
+|author|, |title|, |subtitle|, |titleaddon|,
+|journaltitle|, |shortjournal|, |volume|, |number|, |issue|
+|year|, |pages|,
+\item[optional:]
+|translator|, |origlanguage|,
+|related|, |relatedtype|,
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+ \end{description}
-Ein Beispiel zeigt die Anwendung für |pubstate = {forthcoming}|
+Here we have an example which will explain the (required) fields:
+\begin{lstlisting}[style=bibentry,label=Evangelidis2014,caption={{@}Article\{Evangelidis2014,…\} }]
+@Article{Evangelidis2014,
+ author = {Evangelidis, Vasilis},
+ title = {Agoras {and} Fora},
+ subtitle = {Developments in the Central Public Space of the Cities of Greece during the {Roman} Period},
+ journaltitle = BSA, %@String used
+ shortjournal = BSA-short, %@String used
+ volume = {109},
+ pages = {335--356},
+ year = {2014},
+ doi = {10.1017/s006824541400015x},
+}
+\end{lstlisting}
+In line 5 and 6 you can also write the full or abbreviated journal title in the fields |journaltitle| or |shorttitle| (e.\,g. |journaltitle = {British School of Athens}|, |shortjournal = {BSA}|), but we chose to use a |@String| (cf. \cref{list-bibancient,string}) again.
+\printbib[7em]{Evangelidis2014}
-|@Article{Bossert_2016,|\\
-| Title = {\ldots\ \textsc{in formam anitqvam restitvto}?}, |\\
-| Subtitle = {Überlegungen zur Inschrift der ›Porticus Deorum Consentium‹ (CIL\,VI 102)|\\
-| und ihren Ergänzungen im 19.{\,}Jahrhundert},|\\
- | Author = {Lukas C. Bossert},|\\
- | Volume = {2},|\\
- | Year = {2016},|\\
- | Journaltitle = {BeStAR. Berliner Studien zum Antiken Rom},|\\
- | shortjournal = {BeStAR},|\\
-| pubstate = {forthcoming},|\\
-|}|\\
-\begin{refsection}
-\begin{bsp}
-\nocite{Bossert_2016}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+\subsection{Type \texttt{@Proceedings}}\label{proceedings}
+\DescribeMacro{@Proceedings}
+Similar to a collection but still different in the bibliographical output is proceedings.
+Therefore we recommend to use the type |@Proceedings|.
+The difference lies in the additional mandatory fields |venue|, |eventdate| and |eventtitle|.
+Everything else is like the type |@Book|.
+\begin{description}
+\item[mandatory:]
+%|author|/
+|editor|,
+|title|, |subtitle|, |titleaddon|,
+|venue|, |eventdate|, |eventtitle|,
+|location|, |year|
+\item[optional:]
+|maintitle|, |mainsubtitle|, |maintitleaddon|, |volume|,
+|publisher|, |series|, |number|, |edition|,
+|origyear|, |origlocation|, |origpublisher|,
+|translator|, |origlanguage|,
+|related|, |relatedtype|,
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+ \end{description}
+
+An example:
+ \begin{lstlisting}[style=bibentry,label=Kurapkat2014,caption={{@}Proceedings\{Kurapkat2014,…\} }]
+@Proceedings{Kurapkat2014,
+ title = {Die Architektur des Weges},
+ year = {2014},
+ editor = {Kurapkat, Dietmar and Schneider, Peter I. and Wulf-Rheidt, Ulrike},
+ subtitle = {Gestaltete Bewegung im gebauten Raum},
+ eventtitle = {Kolloquium Architekturreferat des DAI},
+ eventdate = {2012-02-08/2012-02-11},
+ venue = Berlin, %@String used
+ series = DiskAB, %@String used
+ number = {11},
+ organization = {Architekturreferat des DAI},
+ publisher = {Schnell + Steiner},
+ location = Regensburg, %@String used
+ shortseries = DiskAB-short, %@String used
+}
+\end{lstlisting}
+With |venue| we specify the place where the proceeding took place
+(e.\,g. \emph{Berlin} -- |location| is where the book was printed and is connected
+to the |publisher| e.\,g. \emph{Regensburg}),
+|eventtitle| is used for a special title of the proceeding (e.\,g. \emph{Kolloquium Architekturreferat des DAI}),
+|eventtitle| gives the date(range) when the proceeding was hold and has to be typed in in the format YYYY-MM-DD,
+a range has to be separated with a |/| (e.\,g. \emph{2012-02-08/2012-02-11}).
+In the bibliography the information of these additional fields will be used (of course) as this, notice how the output of the date changes according to the chosen language.
+\printbiball[7em]{Kurapkat2014}
-\subsection{Typ \texttt{@proceedings}}\label{proceedings}
+\subsection{Type \texttt{@Inproceedings}}\label{inproceedings}
+\DescribeMacro{@Inproceedings}
+This entry type works similar to |@Procecedings| and |@Incollection| and therefore the needed fields are straightforward to use:
- Für Beiträge innerhalb eines Konferenzbandes müssen die Felder |venue|, |eventdate| und |eventtitle| ausgefüllt werden. Ansonsten alle anderen Felder entsprechend wie bei |@book|:
+\begin{description}
+\item[mandatory:]
+|author|, |title|, |subtitle|, |titleaddon|,
+|editor|, |booktitle|, |booksubtitle|, |booktitleaddon|,
+|venue|, |eventdate|, |eventtitle|,
+|location|, |year|, |pages|,
+\item[optional:]
+|maintitle|, |mainsubtitle|, |maintitleaddon|, |volume|,
+|publisher|, |series|, |number|, |edition|,
+|origyear|, |origlocation|, |origpublisher|,
+|translator|, |origlanguage|,
+|related|, |relatedtype|,
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+\end{description}
-| @Proceedings{Kurapkat_2014,|\\
-|Title = {Die Architektur des Weges},|\\
-|Editor = {Kurapkat, Dietmar and Schneider, Peter I.|\\
-| and Wulf-Rheidt, Ulrike},|\\
-|Year = {2014},|\\
-|Eventdate = {2012-02-08/2012-02-11},|\\
-|Eventtitle = {Kolloquium Architekturreferat des DAI},|\\
-|Location = {Regensburg},|\\
-|Number = {11},|\\
-|Publisher = {Schnell + Steiner},|\\
-|Series = DiskAB-lang,|\\
-|Shortseries = DiskAB-kurz,|\\
-|Subtitle = {Gestaltete Bewegung im gebauten Raum},|\\
-|Venue = {Berlin},|\\
-| }|\\
-
-So wird daraus:
-%\begin{bsp}\todo[noline]{dynamisches Beispiel}
-%\fullcite{Kurapkat_2014}
-%\end{bsp}
-
-\begin{refsection}
-\begin{bsp}
-\nocite{Kurapkat_2014}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
-\subsection{Typ \texttt{@inproceedings}}\label{inproceedings}
-
-Wie bei |@proceedings| so auch hier:
-
-
-| @Inproceedings{Torelli_1991,|\\
-| Author = {Torelli, Mario},|\\
-| Title = {Il \enquote{diribitorium} di Alba Fucens e il \enquote{campus} eroico di Herdonia},|\\
-| Pages = {39--63},|\\
-| Editor = {Mertens, Josef},|\\
-| Booktitle = {Comunitá indigene e problemi della romanizzazione|\\
-| nell’Italia centro-meridionale (IV--III sec. a.C.)},|\\
-| Year = {1991},|\\
-| Eventtitle = {Actes du Colloque International Organisé|\\
-| à l'Occasion du 50. Anniversaire de l'Academia Belgica et|\\
-| du 40. Anniversaire des Fouilles Belges en Italie},|\\
-| Venue = {Roma},|\\
-| Eventdate = {1990-02-01/1990-02-03},|\\
-| Publisher = {Institut Historique Belge de Rome},|\\
-| Location = {Bruxelles},|\\
-| Series = {Études de philologie, d'archéologie et d'histoire anciennes},|\\
-| Number = {29},|\\
-| Hyphenate = {italian},|\\
-| Shorttitle = {Il \enquote{diribitorium}}|\\
-|}| \\
-
-Und daraus wird:
-
-\begin{refsection}
-\begin{bsp}
-\nocite{Torelli_1991}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+ \begin{lstlisting}[style=bibentry,label=Torelli1991,caption={{@}Inproceedings\{Torelli1991,…\} }]
+@Inproceedings{Torelli1991,
+ author = {Torelli, Mario},
+ title = {Il \enquote{diribitorium} di Alba Fucens e il \enquote{campus} eroico di Herdonia},
+ pages = {39--63},
+ editor = {Mertens, Josef},
+ booktitle = {Comunitá indigene e problemi della romanizzazione nell’Italia centro\--meri\-dionale (IV--III sec. a.C.)},
+ location = Brussels, %@String used
+ publisher = {Institut Historique Belge de Rome},
+ year = {1991},
+ venue = Rome #{, Academia Belgica}, %@String used
+ eventdate = {1990-02-01/1990-02-03},
+ eventtitle = {Actes du Colloque International Organisé à l'Occasion du 50. Anniversaire de l'Academia Belgica et du 40. Anniversaire des Fouilles Belges en Italie},
+ hyphenate = {italian},
+ language = {italian},
+ number = {29},
+ series = {Études de philologie, d'archéologie et d'histoire anciennes},
+ shorttitle = {Il \enquote{diribitorium}},
+}
+\end{lstlisting}
+It will be printed as:
+
+\printbiball[4em]{Torelli1991}
- \subsection{Typ \texttt{@inreference}}\label{inreference}
+ \subsection{Type \texttt{@Reference}}\label{reference}
+ \DescribeMacro{@Reference}
+ This entry type can be used especially for references if you want to cite it as whole or if you need to relate to it.
+We provide an example below---cf. \cref{inreference}
- \DescribeMacro{@inreference}
- Mit dem Typ |@inreference| können Lexikonartikel zitiert werden.
- Dabei gibt es generall zwei Möglichkeiten wie der Eintrag dargestellt wird:
- Entweder gleich wie alle anderen Einträge mit ›Autor Jahr‹-Angabe, oder speziell nach den Vorgaben des Deutschen Archäologischen Instituts, sodass der Eintrag in der Fußnote vollzitiert und -referenziert ist:
-›Lexikon Band (Jahr) Seitenzahlen s.\,v. Titel des Artikels (Autor)‹.
-Für die erste Variante bedarf es keine Änderung, präferiert man die zweite Variante, so muss in der Präambel die Option |inreferences=true| gesetzt werden. \DescribeMacro{inreferences=true}
+You don’t need to fill out many fields to have a working entry:
+\begin{description}
+\item[mandatory:] |title|, |shorthand|,
+\item[optional:]
+ |editor|, |subtitle|, |titleaddon|,
+ |location|, |year|
+|maintitle|, |mainsubtitle|, |maintitleaddon|,
+|related|, |relatedtype|,
+|publisher|, |series|, |number|, |edition|, |volume|,
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+\end{description}
-An einem Beispiel wird die Anwendung deutlich.
-
- |@Inreference{Neils_1994,|\\
- | Title = {Theseus},|\\
- | Author = {Neils, Jenifer},|\\
- | Year = {1994},|\\
- | Booktitle = LIMC-kurz, |\emph{Angabe des @string}\\
- | Options = {lexikon},|\\
- | Pages = {922--951},|\\
- | Related = {LIMC},|\\
- | Volume = {7.1},|\\
- |} |
-
-Zusätzlich lohnt es sich den Eintrag über |related| mit dem Hauptwerk (in diesem Falle ›LIMC‹) zu verküpfen:
-
- |@Reference{LIMC, |\\
- | Title = LIMC-lang,|\\
- | Keywords = {Sigel},|\\
- | Options = {corpus},|\\
- | Shorthand = LIMC-kurz |\\
- |}|\\
-
- Dies hat den Vorteil, dass man die Abkürzung ›LIMC‹ in der Teilbibliographie ›Lexika und Corpora‹ (\cref{bib:sigel}) danke des |Keywords = {Sigel}| automatisiert auflösen kann. Dafür muss der Bibliographieeintrag |@reference{LIMC}| nicht manuell zitiert werden, da dies über den Eintrag |related| bei |@inreference{Neils_1994}| dynamischt erfolgt.
-
+And so a complete entry is quite small:
+\begin{lstlisting}[style=bibentry,label=LIMC,caption={{@}Reference\{LIMC,…\} }]
+@Reference{LIMC,
+ title = LIMC,
+ keywords = {corpus},
+ options = {corpus},
+ shorthand = LIMC-short,
+}
+\end{lstlisting}
+But you can also have it more detailed like this one:
+\begin{lstlisting}[style=bibentry,label=Lexikon-der-Technik,caption={{@}Reference\{Lexikon-der-Technik,…\} }]
+@Reference{Lexikon-der-Technik,
+ editor = {Otto Lueger},
+ title = {Lexikon der gesamten Technik und ihrer Hilfswissenschaften},
+ year = {1904--1920},
+ edition = {2},
+ location = Stuttgart, %@String used
+ keywords = {corpus},
+ shorthand = {Lexikon d. T.},
+}
+\end{lstlisting}
+
+ \subsection{Type \texttt{@Inreference}}\label{inreference}
+ \DescribeMacro{@Inreference}
+Besides a whole reference you can also -- and which is more likely -- cite only an entry of it via the type |@Inreference|.
+
+It will be more clear with an example:
+ \begin{lstlisting}[style=bibentry,label=Neils1994,caption={{@}Inreference\{Neils1994,…\} }]
+@Inreference{Neils1994,
+ author = {Neils, Jenifer},
+ title = {Theseus},
+ booktitle = LIMC-short, %@String used
+ pages = {922--951},
+ year = {1994},
+ volume = {7.1},
+ keywords = {lexikon},
+}
+\end{lstlisting}
+You can cite this entry with any of the provided \cs{cite}-commands above---cf. \cref{cite-commands,faq:inreference}.
- Verwendet man den normalen |\cite|\oarg{prenote}\oarg{postnote}\marg{Schlüssel}-Befehl, dann wird bei eingetragener Option (|lexikon|) die \oarg{postnote} nicht nachgestellt, sondern nach der Jahresangabe des Lexikons gesetzt.
- Ist die \oarg{postnote} leer, dann werden die Seiten aus dem Bibliographieeintrag ausgelesen und an diese Stelle gesetzt:
-
+But for the final display of the entry you have two possibilities:
+ \begin{enumerate}
+\item\label{inreference:a}
+
+Either you want it in the default style ›author-year‹, so it will have a label and is referenced
+to your final bibliography, then you don’t have to do anything.
+In the bibliography it will look like
+\printbib{Neils1994}
+
+\item\label{inreference:b}
+The German Archaeological Institute has a special rule for inreferences in the footnote.
+Then the output will be like:\\
+|reference volume (year) pages s.v. title (author)| \\
+and there will be no reference to the bibliography since the entry is fully described in the footnote.
+\DescribeMacro{inreferences} If you prefer this method you have to use the preamble option called |inreferences|---cf. \cref{inreferences}
+Then it will look like this in the footnote:
+\begin{bsp}
+LIMC 7.1 (1994) 922--951 s. v. Theseus (J. Neils)
+\end{bsp}
+When you have the \oarg{postnote} filled out in a citation which belongs to an |@Inreference| then it won’t be printed in the end of the citation.
+\begin{lstlisting}
+\cite[vgl.][930 Nr. 283]{Neils1994}.
+\end{lstlisting}
+The |postnote| \oarg{930 Nr. 283} will be printed instead of the |pages|:
\begin{bsp}
- \ldots\ (|\cite[vgl.][930 Nr. 283]{Neils_1994}|).
-
- ...\ (vgl. LIMC 7.1 (1994) 930 Nr. 283 s. v. Theseus (J. Neils)).
- % \ldots (\fullcite[vgl.][930 Nr. 283]{Neils_1994}).
+vgl. LIMC 7.1 (1994) 930 Nr. 283 s. v. Theseus (J. Neils).
\end{bsp}
-\DescribeMacro{\parencite}
-Dieses Beispiel zeigt, dass keine Klammerregelung angewendet wurde, was nicht gewünscht ist.
-Es ist zu beachten, dass bei gewählter Option |inreferences=true| (in der Präambel) und bei einer gewünschten Zitation in Klammern (), der Befehl |\parencite|\marg{Schlüssel} verwendet wird (\ref{cite-befehle}), damit die Klammerregelung automatisch angewendet wird.
-Dies funktioniert so:
-
- \begin{bsp}
- \ldots\ |\parencite[vgl.][930 Nr. 283]{Neils_1994}.|
-
- ...\ (vgl. LIMC 7.1 [1994] 930 Nr. 283 s. v. Theseus [J. Neils]).
-
- %\ldots \parencite{\fullcite[vgl.][930 Nr. 283]{Neils_1994}}.
- \end{bsp}
+\end{enumerate}
-\DescribeMacro{\parencites}
-Gleiches gilt auch für das Zitieren von mehreren Einträgen in Klammern: Dafür wird analog der Befehl |\parencites|\marg{Schlüssel} verwendet:
- \begin{bsp}
- \ldots\ |\parencites[vgl.][930 Nr. 283]{Neils_1994}[9]{Nieddu_1995}.|
+As mentioned above it is of advantage when you relate entries like an |@Inreference| with its |@Reference|.
+And since not all references have a ›canonical‹ abbreviation (e.\,g. RE, LIMC, DNP, LTUR, LÄ, etc.) it might be necessary to define a |shorthand|.
+This is shown in the example below.
- ...\ (vgl. Neils 1994, 930 Nr. 283; Nieddu 1995, 9).
- \end{bsp}
+\begin{lstlisting}[style=bibentry,label=Weinbrenner1914,caption={{@}Inreference\{Weinbrenner1914,…\} }]
+@Inreference{Weinbrenner1914,
+ author = {Weinbrenner},
+ title = {Rennbahn},
+ booktitle = {Lexikon d. T.},
+ pages = {636--637},
+ year = {1914},
+ related = {Lexikon-der-Technik},
+ volume = {9},
+ number = {2},
+}
+\end{lstlisting}
+As you see this entry is related to |Lexikon-der-Technik| which is described above and has a |shorthand = {Lexikon d. T.}|
+You just need to make sure that |booktitle| of the |@Inreference| and the |shorthand| of
+the |@Reference| are equal so the title can be referenced properly in the bibliography.
- bzw. mit der Präambel-Option |inreferences=true|:
- \begin{bsp}
+For the following bibliography result we just typed (assuming that the entries were already cited in text):
+\begin{lstlisting}
+\printbibliography[keyword=corpus,title={Corpora}]
+\printbibliography[notkeyword=corpus]
+\end{lstlisting}
- \ldots (vgl. LIMC 7.1 [1994] 930 Nr. 283 s. v. Theseus [J. Neils]; LTUR 2 [1995] 9 s. v. Dei Consentes [G. Nieddu])
+\begin{refsection}
+\begin{bibbsp}{Lexikon-der-Technik,Weinbrenner1914}
+\nocite{Lexikon-der-Technik,Weinbrenner1914}
+\printbibliography[keyword=corpus,title={Corpora}]
+\printbibliography[notkeyword=corpus]
+\end{bibbsp}
+\end{refsection}
- %\ldots\ \parencites[vgl.][930 Nr. 283]{Neils_1994}[9]{Nieddu_1995}
- %\ldots \parencite{\fullcite[vgl.][930 Nr. 283]{Neils_1994}}.
- \end{bsp}
+
+\subsection{Type \texttt{@Review}}\label{review}
+\DescribeMacro{@Review}
+Reviews in journals are best cited when they are edited as a |@Review|.
+For a full citation of a review you have to name the reviewed work in detail.
+The following example will show an easy way to combine the review with the reviewed work.
-Da der Bibliographieeintrag ein Lexikonartikel ist (|@inreference|), werden bei gewählter Präambel-Option |inreferences=true| alle Lexikoneinträge von der Bibliographie ausgeschlossen, da sie ja in der Fußnote vollzitiert werden.
+\begin{description}
+\item[mandatory:]
+|author|, |title|, |subtitle|, |titleaddon|,
+|journaltitle|, |shortjournal|, |volume|, |number|, |issue|
+|year|, |pages|,
+|related|, |relatedtype|,
+\item[optional:]
+|translator|, |origlanguage|,
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+ \end{description}
-Ansonsten (Präambel-Option |inreferences=false| = default) sieht der Eintrag in der Bibliographie so aus:
+What you need are two separate entries: one as a |@Review| the other is a |@Book|, |@Collection|, |@Proceedings| or something else.
+
+First we have the reviewed work:
+\begin{lstlisting}[style=bibentry,label=Welch2007,caption={{@}Book\{Welch2007,…\} }]
+@Book{Welch2007,
+ author = {Welch, Katherine E.},
+ title = {The {Roman} Amphitheatre},
+ subtitle = {From its Origins to the Colosseum},
+ publisher = CUP, %@String used
+ location = {Cambridge and New York},
+ year = {2007},
+}
+\end{lstlisting}
+then the review itself:
+\begin{lstlisting}[style=bibentry,label=Bell2011,caption={{@}Review\{Bell2011,…\} }]
+@Review{Bell2011,
+ author = {Bell, Sinclair},
+ number = {1},
+ pages = {1--4},
+ volume = {115},
+ journaltitle = AJA, %@String used
+ shortjournal = AJA-short, %@String used
+ related = {Welch2007},
+ relatedtype = {reviewof},
+ year = {2011},
+ publisher = {Archaeological Institute of America},
+}
+\end{lstlisting}
+You maybe noticed that the reveiw (|Bell2011|) is with the field |related| in line 8 connected to the entry |Welch2007|.
+In addition we not only need a connected work but also to qualify the relation:
+This is done in line 9 with |relatedtype = {reviewof}|.
+This so-called |bibstring| is especially for reviews and contains the language based correct abbreviation for \emph{Review of} or e.\,g. \emph{Rez. zu}.
+You don’t have to type in all relevant information of the reviewed work in the entry of the review,
+since they will be inserted automatically and dynamically with the |related|-function.
+So whenever settings in the reviewed work are changed the print of the review will be automatically adjusted.
+Furthermore, even if the review is cited, the reviewed work won't be listed in the bibliography until it is explicitly cited in the text.
+\printbib{Bell2011}
+
+
+\subsubsection{Reviews with an individual title}
+Some reviews are more detailed then others and have their own title which should be displayed in the bibliography.
+In these cases you can use the field |title| the other things stay the same.
+
+The following entry is an example reviews the book by \citeauthor*{Welch2007}, too but with an individual title:
+\begin{lstlisting}[style=bibentry,label=Hufschmid2010,caption={{@}Review\{Hufschmid2010,…\} }]
+@Review{Hufschmid2010,
+ author = {Hufschmid, Thomas},
+ title = {Von Caesars \emph{theatron kynegetikon} zum \emph{amphitheatrum novum} Vespasians},
+ pages = {487--504},
+ volume = {23},
+ journaltitle = JRA, %@String used
+ shortjournal = JRA-short, %@String used
+ related = {Welch2007},
+ relatedtype = {reviewof},
+ year = {2010},
+}
+\end{lstlisting}
+In the bibliography there will be first the individual title followed by the information of the reviewed work.
+
+\printbib[7em]{Hufschmid2010}
+
+
+\subsubsection{multiple reviewed works in one review}
+Some reviews analyse several works in the same article.
+This makes no big difference for the citing or editing process.
+
+In his review
+\citeauthor{Taylor2008} not only describes the book called
+ \citetitle{Welch2007} by \citeauthor{Welch2007},
+ but at the same time compares it with \citeauthor{Sear2006}s \citetitle{Sear2006}.
+
+The entry of the first analysed book \citetitle{Welch2007} has been described in \cref{review}.
+The entry of the second reviewed book is this:
+\begin{lstlisting}[style=bibentry,label=Sear2006,caption={{@}Book\{Sear2006,…\} }]
+@Book{Sear2006,
+ author = {Sear, Frank},
+ title = {Roman Theatres},
+ subtitle = {An Architectural Study},
+ publisher = OUP, %@String used
+ location = {Oxford},
+ year = {2006},
+ series = {Oxford Monographs on Classical Archaeology},
+}
+\end{lstlisting}
+
+The entry of the review looks like this:
+\begin{lstlisting}[style=bibentry,label=Taylor2008,caption={{@}Review\{Taylor2008,…\} }]
+@Review{Taylor2008,
+ author = {Taylor, Rabun},
+ number = {3},
+ pages = {443--445},
+ volume = {67},
+ journaltitle = {Journal of the Society of Architectural Historians},
+ related = {Sear2006,Welch2007},
+ relatedtype = {reviewof},
+ year = {2008},
+}
+\end{lstlisting}
+In the field |related| you can have several \meta{bibtex-keys} which has to be separated by a comma (see line 7).
-\begin{refsection}
-\begin{bsp}
-\nocite{Neils_1994,Nieddu_1995}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
-
+And in the bibliography all information is gathered:
+\printbib[5em]{Taylor2008}
- Diese Handhabe gilt nicht nur für ›kanonische Lexika‹ der Altertumswissenschaften (RE, LIMC, DNP, LTUR, LÄ, etc.) sondern kann auf alle Lexika angewendet werden.
+ \subsection{Type \texttt{@Thesis}}\label{thesis}
+For MA and PhD thesis, which are not published a monograph or such, can be cited when they are edited as |@Thesis|.
+It is important to differentiate whether it is a MA or a PhD thesis,
+this can be done by |type=|\marg{|phdthesis|} or
+ \marg{|mathesis|}; you also have to define the |institution=|\marg{university}.
- Da es nicht für alle Lexika eine Abkürzungskonvention des Titels gibt, können und sollten diese selbst abkürzt werden.\footnote{Dies ist sehr emphehlenswert, da in der Bibliographie der Abstand zwischen der Autor-Jahr-Abkürzung und dem Vollzitat sich nach der längsten ›Shorthand‹ richtet.}
+\begin{description}
+\item[mandatory:]
+|author|,
+|title|, |subtitle|, |titleaddon|,
+|type|, |institution|,
+|year|,
+\item[optional:]
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+ \end{description}
- Ein weiteres Beispiel:
-| @Inreference{Weinbrenner_1914,|\\
-| Title = {Rennbahn},|\\
-| Author = {Weinbrenner},|\\
-| Number = {2},|\\
-| Pages = {636--637},|\\
-| Volume = {9},|\\
-| Year = {1914},|\\
-| related = {Lexikon-der-Technik},|\\
-| Booktitle = {Lexikon d. T.},|\\
-|}|\\
-
-Der Lexikoneintrag ist über |related| verknüpft mit:
-
-|@reference{Lexikon-der-Technik,|\\
-| editor = {Otto Lueger},|\\
-| location = {Stuttgart},|\\
-|year = {1904--1920},|\\
-|edition = {2},|\\
-|shorthand = {Lexikon d. T.},|\\
-| Keywords = {Sigel},|\\
-| title = {Lexikon der gesamten Technik und ihrer Hilfswissenschaften},|\\
-|}|\\
-
-Wichtig ist, dass |booktitle| des |@inreference| und |shorthand| des |@reference| gleich sind, damit der Titel des Lexikons entsprechend aufgelöst werden kann.
+Here is an example:
+\begin{lstlisting}[style=bibentry,label=Arnolds2005,caption={{@}Thesis\{Arnolds2005,…\} }]
+@Thesis{Arnolds2005,
+ author = {Markus Arnolds},
+ title = {Funktionen republikanischer und frühkaiserzeitlicher Forumsbasiliken in Italien},
+ type = {phdthesis},
+ institution = {Ruprecht-Karls-Universität zu Heidelberg},
+ eprint = {urn:nbn:de:bsz:16-heidok-74406},
+ eprinttype = {urn},
+ date = {2005-05-31},
+}
+\end{lstlisting}
-\begin{refsection}
-\begin{bsp}
-\nocite{Lexikon-der-Technik,Weinbrenner_1914}
- \printbibliography[keyword=Sigel,title={Abkürzungen und Sigel}]
-\printbibliography[title={Forschungsliteratur},notkeyword=Sigel]
-\end{bsp}
- \end{refsection}
+Here is the entry in the bibliography:
+\printbib[5.5em]{Arnolds2005}
- \subsection{Typ \texttt{@review}}\label{review}
-\DescribeMacro{@review}
-Rezensionen, die in Zeitschriften erschienen sind, werden als |@review| verarbeitet.
-Oft zitiert man die Rezension und das rezensierte Werk in seiner Arbeit.
-Das folgende Beispiel geht auf diesen Fall ein und erläutert die relevanten Punkte und Besonderheiten.
-
-Dafür sind zwei Bibliographieeinträge notwendig.
-Zuerst das rezensierte Werk:
-
-|@Book{Welch_2007,|\\
-| Title = {The {Roman} Amphitheatre},|\\
-| Author = {Welch, Katherine E.},|\\
-| Location = {Cambridge and New York},|\\
-| Publisher = CUP,|\\
-| Subtitle = {From its Origins to the Colosseum},|\\
-| Year = {2007}|\\
-|}|\\
-
-und schließlich die dazugehörige Rezension:
-
-|@Review{Bell_2011,|\\
-| Author = {Bell, Sinclair},|\\
-| Related = {Welch_2007},%| \emph{Besonderheit!!}\\
-| Relatedtype = {reviewof},%| \emph{Besonderheit!!}\\
-| Number = {1},|\\
-| Volume = {115},|\\
-| Pages = {1--4},|\\
-| Year = {2011},|\\
-| Journaltitle = AJA-lang,|\\
-| Publisher = {Archaeological Institute of America},|\\
-| Shortjournal = AJA-kurz,|\\
-|}|\\
-
-Im Bibliographieeintrag der Rezension (|Bell_2011|) wird im Feld |Related| mittels Eintrag |{Welch_2007}| Bezug auf das rezensierte Werk (|Welch_2007|) genommen.
-Das Feld |Relatedtype| enthält die Information in welcher Beziehung das Werk (|Bell_2011|) zu |Welch_2007| steht. Die Angabe |reviewof| ist der |bibstring| für Rezensionen und enthält sprachabhängig (Deutsch und Englisch) die Bezeichnung |Rez. zu| bzw. |Review of|.
-Dies ist für die Bibliographie relevant: Es ist nun nicht mehr notwendig das rezensierte Werk mit allen dazugehörigen Angaben einzutippen, da dies automatisch über die |Related|-Funktion erfolgt.
+ \changes{v1.1}{2015/06/04}{Umsetzung von |@thesis| im Stil.}
-\begin{refsection}
-\begin{bsp}
-\nocite{Bell_2011}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
-
-Der Vorteil mit |Related| und |Relatedtype| zu arbeiten liegt in der Dynamik: Ändert sich eine Angabe im rezensierten Werk, wird dies bei der Rezension automatisch geändert.
-Zudem wird das rezensierte Werk bei der Erwähung in der Rezension nicht automatisch in die Bibliographie als eigener Eintrag aufgenommen, sondern erst dann, wenn es selbst explizit zitiert wird.
-
-\subsubsection{Rezensionen mit eigenem Titel}
-Manche Rezensionen sind ausführlicher und haben daher einen eigenen Titel, der angegeben werden soll.
-In diesem Fall wird das Feld |Title| ausgefüllt, ansonsten bleibt alles gleich:
-
-|@Review{Hufschmid_2010,|\\
-| Title = {Von Caesars \emph{theatron kynegetikon}|\\
-| zum \emph{amphitheatrum novum} Vespasians},|\\
-| Related = {Welch_2007},%| \emph{Besonderheit!!}\\
-| Relatedtype = {reviewof},%| \emph{Besonderheit!!}\\
-| Author = {Hufschmid, {\relax Th}omas},|\footnote{Mit |relax| wird geregelt, dass |Th.| als Initiale ausgegeben wird.}\\
-| Pages = {487--504},|\\
-| Volume = {23},|\\
-| Year = {2010},|\\
-| Journaltitle = JRA-lang,|\\
-| Shortjournal = JRA-kurz,|\\
-|}|\\
-
-In der Bibliographie wird dann zuerst der eigene Titel der Rezension ausgegeben, dann die Angaben zum rezensierten Werk.
-
-\begin{refsection}
-\begin{bsp}
-\nocite{Hufschmid_2010}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+ \subsection{Type \texttt{@Talk}}\label{talk}
+For (oral) given papers e.\,g. at a colloquium or a proceeding we created a new entry type called ›@Talk‹.
+\begin{description}
+\item[mandatory:]
+|author|,
+|title|, |subtitle|, |titleaddon|,
+|date|,
+|venue|,
+|institution|,
+|eventtitle|,
+|eventdate|,
+\item[optional:]
+|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|,
+ \end{description}
+
+Here is an example for a paper given in Berlin in 2015:
+\begin{lstlisting}[style=bibentry,label=Bergmann2015,caption={{@}Talk\{Bergmann2015,…\} }]
+@Talk{Bergmann2015,
+ author = {Bergmann, Birgit},
+ title = {\enquote{An exciting find}},
+ date = {2015-04-27},
+ subtitle = {Neues zum Forums-Fries der Praedia Iuliae Felicis},
+ titleaddon = {(Pompeii II, 4)},
+ url = {https://www.antikezentrum.hu-berlin.de/de/veranstaltungskalender/bibergmann},
+ urldate = {2016-05-14},
+ eventtitle = {Kolloquium der Klassischen Archäologie},
+ institution = {Freie Universität Berlin},
+ venue = Berlin,
+}
+\end{lstlisting}
+The bibliography will show the entry as:
-\subsubsection{Sammelrezensionen}
-Es kann vorkommen, dass Rezensionen nicht nur ein Werk unter die Lupe nehmen, sondern zwei oder noch mehr.
-Dies ist jedoch kein Problem, da das Vorgehen fast analog zu den oben genannten Beispielen ist.
-\citeauthor{Taylor_2008} hat nicht nur das bereits erwähnte Buch \citetitle{Welch_2007} von \citeauthor{Welch_2007} rezensiert, sondern es zugleich mit \citeauthor{Sear_2006}s \citetitle{Sear_2006} verglichen.
+ \printbib[6.5em]{Bergmann2015}
+
+ \changes{v1.5}{2016/05/31}{Rückverweis}
-|@Review{Taylor_2008,|\\
-| Author = {Taylor, Rabun},|\\
-| Number = {3},|\\
-| Pages = {443--445},|\\
-| Related = {Sear_2006,Welch_2007},|\\
-| Relatedtype = {reviewof},|\\
-| Journaltitle = {Journal of the Society of Architectural Historians},|\\
-| Volume = {67},|\\
-| Year = {2008},|\\
-|}|\\
+\newpage
+ \section{Bibliography}\label{bibliographie}
+ \DescribeMacro{\printbibliography}
+As long as you don’t use the option\DescribeMacro{seenote} |seenote|---for
+which a final bibliography is not needed---you will need to print you cited entries in a bibliography
+at a certain place in your document.
+It can be useful to differentiate your bibliography and divide it e.\,g. into a bibliography
+with ancient authors and one with modern scholars.
+Additionally you can have a bibliography with the |shorthand| shortcuts or all abbreviated journal titles, etc.
+
+How the different bibliographies can be set up is explained now:
+Let’s assume you want to have a bibliography with the ancient authors and one with modern scholars.
+Since the entries of the ancient authors have the field |keyword={ancient}| (or should have it) this is done quite easy.
+
+But first we define the heading of the whole bibliography:
+\begin{lstlisting}
+\printbibheading[%
+ heading=bibliography,%
+ %heading=bibnumbered,% if you want it numbered
+ title={Bibliography}] %heading for bibliography
+\end{lstlisting}
+You can give any title you would like to give (|title = |\marg{any title}).
+
+The next step is to set up the bibliography for the ancient authors.
+
+\begin{lstlisting}
+\printbibliography[%
+ keyword=ancient,%
+ heading=subbibliography,
+ %heading=subbibnumbered,% if you want it numbered
+ title={Ancient authors and works}]
+\end{lstlisting}
+We tell the bibliography just to contain the entries which have have |ancient| in the field |keywords| (line 2).
-|@Book{Sear_2006,|\\
-| Title = {Roman Theatres},|\\
-| Author = {Sear, Frank},|\\
-| Location = {Oxford},|\\
-| Publisher = OUP,|\\
-| Series = {Oxford Monographs on Classical Archeology},|\\
-| Subtitle = {An Architectural Study},|\\
-| Year = {2006},|\\
-|}|\\
+Finally the bibliography for modern scholars:
+\begin{lstlisting}
+\printbibliography[%
+ notkeyword=ancient,%
+ notkeyword=corpus,%
+ heading=subbibliography,
+ %heading=subbibnumbered,% if you want it numbered
+ title={Secondary literature}]
+\end{lstlisting}
+This time we exclude all entries which have |ancient| or |corpus| in the field |keywords|.
+That’s it.
+(Don't be surprised about the line |notkeyword=corpus| which excludes entries with special |shorthand| labels, a further bibliography part with all the |shorthands| is described below.).
\begin{refsection}
+\nocite{*}
+Now have a look how it looks like with all the entries we explained above.
\begin{bsp}
-\nocite{
-%Sear_2006,
-Taylor_2008,
-%Welch_2007
-}
-\printbibliography[title={Forschungsliteratur}]
-\end{bsp}
- \end{refsection}
+\renewcommand\bibfont{\normalfont\footnotesize}
+\printbibheading[%
+ heading=bibliography,%
+ title={Bibliography}] %heading for bibliography
+\printbibliography[%
+ keyword=ancient,%
+ heading=subbibliography,
+ title={Ancient authors and works}]
- \subsection{Typ \texttt{@thesis}}\label{thesis}
-Master- und (unpublizierte) Doktorarbeiten sind als |@thesis| aufzunehmen.
-Wichtige Felder sind |type=|\marg{|phdthesis|} bzw. \marg{|mathesis|} und |institution=|\marg{Universität}.
+\printbibliography[%
+ notkeyword=ancient,%
+ notkeyword=corpus,%
+ heading=subbibliography,
+ title={Secondary literature}]
+\end{bsp}
-Beispiel:
+You can create as many bibliographies as you wish each with an other keyword if you like.
+Or you can make a bibliography with all the |shorthands| used in your text---for that we use |keyword= {corpus}| (line 2):
+\begin{lstlisting}
+\printbibliography[%
+ keyword=corpus,%
+ heading=subbibliography,
+ title={Abbreviation and corpora}]
+\end{lstlisting}
+Now the bibliography only lists the used entries which have |corpus| in the field |keywords|:
+\begin{bsp}
+\printbibliography[%
+ keyword={corpus},
+ heading=subbibliography,
+ title={Abbreviation of corpora}]\label{bib:corpus}
+\end{bsp}
-| @Thesis{Arnolds_2005,|\\
-| Title = {Funktionen republikanischer und frühkaiserzeitlicher|\\
-| Forumsbasiliken in Italien},|\\
-| Author = {Markus Arnolds},|\\
-| Date = {2005-05-31},|\\
-| Institution = {Ruprecht-Karls-Universität zu Heidelberg},|\\
-| Type = {phdthesis},|\\
-| Year = {2005},|\\
-| eprint = {urn:nbn:de:bsz:16-heidok-74406}, |\\
-| eprinttype = {urn},|\\
-| }|\
+Note: If you want to separate in your bibliography author-year labels from |shorthand| labels
+ you should insure yourself that bibliography entries which contain a |shorthand| denomination
+are set with a keyword either |ancient|, |corpus| or something else, to guarantee that there is
+no bibliographical shortcut wrongly sorted in the bibliography.
-In der Bibiographie wird das zu:
-%\begin{bsp}\todo[noline]{dynamisches Beispiel}
-%\fullcite{Arnolds_2005}
-%\end{bsp}
+Furthermore you can have a bibliography for all the abbreviated journal titles and series to have the abbreviation and its long form.
+For journals it works like this:
+\begin{lstlisting}
+\printbiblist[%
+ heading=subbibliography,
+ title={Abbreviation of journals}]{shortjournal}
+\end{lstlisting}
-\begin{refsection}
\begin{bsp}
-\nocite{Arnolds_2005}
-\printbibliography[title={Forschungsliteratur}]
+\printbiblist[%
+ heading=subbibliography,
+ title={Abbreviation of journals}]{shortjournal}
\end{bsp}
- \end{refsection}
-
-
- \changes{v1.1}{2015/06/04}{Umsetzung von |@thesis| im Stil.}
+For series it is done like this:
+\begin{lstlisting}
+\printbiblist[%
+ heading=subbibliography,
+ title={Abbreviation of series}]{shortseries}
+\end{lstlisting}
-\section{Verschiedenes}
-\subsection{Anonymes Werk}\label{unbekannt}
- Für manche Artikel oder Bücher lässt sich kein Autor oder Herausgeber ermitteln.
- Diese Werke werden dann als anonym gekennzeichnet und nicht nach dem (anonymen) Autor/Herausgeber zitiert, sondern nach einem gewählten |label|.
+\begin{bsp}
+\printbiblist[heading=subbibliography,title={Abbreviation of series}]{shortseries}\end{bsp}
-
-| @Article{Cosa_1949,|\\
-| Title = {Cosa},|\\
-| Journaltitle = ClJ-lang,|\\
-| Shortjournal = ClJ-kurz,|\\
-| Pages = {141--149},|\\
-| Volume = {45},|\\
-| Year = {1949},|\\
-| Number = {1},|\\
-| Label = {Cosa},|\\
-| Subtitle = {Republican Colony in Etruria},|\\
-|}|\\
+\end{refsection}
-
- Das |Label| wurde in diesem Fall analog zum Titel gewählt (Cosa).
- Zitiert man dieses Werk in einer Fußnote, dann wird
- |\cite[vgl.][145--146]{Cosa_1949}|
+\section{FAQ: For Ancient (scholars of high) Quality}
+\subsection{Following pages}
+\DescribeMacro{\psq} If you have to cite two following pages there is the macro \cs{psq} which is best to you since it is also controlled by the set up language.
+Just write the first page in the \oarg{postnote} and then the \cs{psq}---cf. \cref{Parlasca1969}.
- zu
- \begin{refsection}
- \begin{bsp}
- \cite[vgl.][145--146]{Cosa_1949}
-% vgl. [Cosa 1949], 145--146
- \end{bsp}
+\subsection{Online referencing}
+\DescribeMacro{eprint}\DescribeMacro{eprinttype} If you have a paper or book which is available
+in the internet via a permanent link there a different possibilities referring to it---see also the
+ \href{http://tug.ctan.org/macros/latex/exptl/biblatex/doc/biblatex.pdf}{|bib|\LaTeX-documentation chapter 3.11.7}.\footnote{You can also use as an |eprinttype|: |arXiv|, |pubmed|, |hdl|, |googlebooks|.
+}
+
+\DescribeMacro{jstor}
+ If you can refer to the on-line plattform \href{www.jstor.org}{jstor} then you need the individual number for the article---cf. \cref{Ball2013}:
+\begin{lstlisting}
+eprint = *@\marg{jstor-number}@*
+eprinttype = {jstor}
+\end{lstlisting}
+OR---cf. \cref{Osland2016}
+\begin{lstlisting}
+jstor = *@\marg{jstor-number}@*
+\end{lstlisting}
+
+\DescribeMacro{urn}
+For all papers referable via an ›urn‹ (\emph{Uniform Resource Name}), which have been registered at the German National Library---cf. \cref{Arnolds2005}
+\begin{lstlisting}
+eprint = *@\marg{urn:xxx}@*
+eprinttype = {urn}
+\end{lstlisting}
+
+OR
+\begin{lstlisting}
+urn = *@\marg{urn:xxx}@*
+\end{lstlisting}
+
+\DescribeMacro{zenon}
+This is eprint-form is especially designed for the OPAC of the German Archaeological Institute.
+All bibliographical entries in this OPAC can be referred to via this link.
+You only need to insert the individual Zenon-number of the entry, e.\,g. \emph{http://zenon.dainst.org/Record/001371402} where \emph{001371402} is the individual number---cf. \cref{Zanker2009}.
+\begin{lstlisting}
+eprint = *@\marg{Zenon-number}@*
+eprinttype = {zenon}
+\end{lstlisting}
+OR cf. \cref{Osland2016,Wulf-Rheidt2013}.
+\begin{lstlisting}
+zenon = *@\marg{Zenon-number}@*
+\end{lstlisting}
+
+
+\DescribeMacro{doi} In addition you can also refer to a document via its |doi|-number---cf. \cref{Ball2013,Evangelidis2014}
+\begin{lstlisting}
+doi = *@\marg{doi-number}@*
+\end{lstlisting}
+
+\subsection{Brackets (with @Inreference)}\label{faq:inreference}
+Be aware to stick to the correct order of parentheses and brackets.
+The rule says that within a pair of parentheses you have to use square brackets.
+Citing |@Inreferences| can lead easily to a false behaviour when you put it in parentheses.
+This is an example how it should not be done:
+\begin{lstlisting}
+\cite[vgl.][930 Nr. 283]{Neils1994}.
+\end{lstlisting}
+ \begin{bsp}
+(vgl. LIMC 7.1 (1994) 930 Nr. 283 s. v. Theseus (J. Neils)). \textcolor{red}{WRONG!}
+\end{bsp}
-Und für die Bibliographie:
-\begin{bsp}
-%\nocite{Cosa_1949}
-\printbibliography[title={Forschungsliteratur}]
+\DescribeMacro{\parencite} \DescribeMacro{\parencites}
+This example shows that the correct order of parentheses has not been followed.
+Especially when you activated the preamble option |inreferences=true| \DescribeMacro{inreferences} you should use \cs{parencite}\marg{bibtex-key} instead (\cref{cite-commands}), then the correct order of parentheses and square brackets is given:
+\begin{lstlisting}
+\parencite[vgl.][930 Nr. 283]{Neils1994}.
+\end{lstlisting}
+
+\begin{bsp}
+(vgl. LIMC 7.1 [1994] 930 Nr. 283 s. v. Theseus [J. Neils]). \textcolor{green}{CORRECT!}
\end{bsp}
- \end{refsection}
-
-%%
-%%
-
+\subsection{Unknown work}\label{unknown}
+Sometimes it is impossible to get hold of the author or editor but you still want to cite them.
+If you come along such a paper you can define a |label| which will be used for citing and sorting.
+This is not connected to an entry type -- it can be used with any work.
+In the following example we use an entry type |@Article|:
+\begin{lstlisting}[style=bibentry,label=Cosa1949,caption={{@}Article\{Cosa1949,…\} }]
+@Article{Cosa1949,
+ title = {Cosa},
+ subtitle = {Republican Colony in Etruria},
+ journaltitle = ClJ,
+ shortjournal = ClJ-short,
+ volume = {45},
+ pages = {141--149},
+ year = {1949},
+ label = {Cosa},
+ number = {1},
+}
+\end{lstlisting}
+ The |label| (line 9) can be defined as one wishes in this case we chose it analogous to the title: |label = {Cosa}|.
+When you cite such an anonymous work it will be done like all the others:
+\begin{lstlisting}
+ \cite[vgl.][145--146]{Cosa1949}
+\end{lstlisting}
+ It will look like this:
+ \begin{bsp}
+ vgl. Cosa 1949, 145--146
+ \end{bsp}
+and be printed in the bibliography like this:
+\printbib{Cosa1949}
+
+\subsection{Publication status}
+Sometimes you know the author of an article or a book, proceedings etc. and you get a proof of the work beforehand.
+You can also cite this version of the work and provide information about the publication status in the field |pubstate|.
+This field is usable with all entry types provided (except |@Talk|).
+There are some predefined publication status which are recommended to use since they are translated into the used language:
+\begin{description}
+\item[inpreparation] Typoscript is prepared for your publication.
+\begin{lstlisting}
+pubstate = {inpreparation}
+\end{lstlisting}
+\item[submitted] Typoscript has been submitted.
-\newpage
- \section{Bibliographie}\label{bibliographie}
- \DescribeMacro{\printbibliography}
-Wie bei jedem Dokument mit im Text zitierten Werken bedarf es einer Stelle, an der diese auch aufgeschlüsselt werden: die Bibliographie.
-Für Altertumswissenschaftler (und auch andere) ist es manchmal hilfreich verschiedene Bibliographien im Dokument zu haben, die unterschiedliche Arten von Werke beinhalten, bspw. ein Quellenverzeichnis, Abkürzungen und Forschungsliteratur.
-Nachfolgend wird gezeigt, wie dies berwerkstelligt werden kann.
-Zunächst sollten alle Quellen in der |bib|-Datei mit dem Feld
- |keyword={Quelle},|
- versehen werden.
-Es bietet sich an, mit (nummerierten) Unterbibliographien zu arbeiten, die über die Option |heading=bibnumbered|, bzw. |heading=subbibnumbered| geladen werden.
-
-|\printbibheading[%|\\
-| ||heading=bibnumbered,|\\
-| ||title={Bibliographie}] %| \emph{Überschrift für Bibliographieumgebung}\\
-|\printbibliography[%|\\
-| ||keyword=Quelle,|\\
-| ||heading=subbibnumbered,%|\\
-| ||title={Antike Quellen}]|\\
-|\printbibliography[%|\\
-| ||notkeyword=Quelle,|\\
-| ||notkeyword=Sigel,%|\\
-| ||heading=subbibnumbered,%|\\
-| ||title={Forschungsliteratur}]|
+\begin{lstlisting}
+pubstate = {submitted}
+\end{lstlisting}
-\begin{refsection}
-\nocite{*}
+\item[forthcoming] Typoscript has been accepted by the journal.
-Damit wird zuerst die Quellen und danach das \enquote{gewöhnliche} Literaturverzeichnis getrennt voneinander ausgegeben.
-\setcounter{section}{0}
-\begin{bsp}
-\renewcommand\bibfont{\normalfont\footnotesize}
-\printbibheading[heading=bibnumbered,
- title={Bibliographie}]
-\printbibliography[keyword=Quelle,
- heading=subbibnumbered,
- title={Antike Quellen}]
-\printbibliography[%
- notkeyword=Quelle,%
- notkeyword=Sigel,%
- heading=subbibnumbered,
- title={Forschungsliteratur}]
-\end{bsp}
+\begin{lstlisting}
+pubstate = {forthcoming}
+\end{lstlisting}
+\item[inpress] Typoscript has been edited and you have a proof version of it.
-Es können mehrere Bibliographien über |\printbibliography| erstellt werden, die jeweils unterschiedliche Einträge haben können.
-Beispielsweise kann man eine Unterbibliographie erstellen, in der nur die Sigeln (Lexika, Handbücher, Inschriftencorpora, etc) aufgeführt werden, sodass diese dann aus der |Forschungsliteratur| herausfliegen (dort |notkeyword=Sigel| ergänzen). Dafür wird das Feld |keyword| auf den Inhalt |Sigel| ausgelesen:
+\begin{lstlisting}
+pubstate = {inpress}
+\end{lstlisting}
-|\printbibliography[keyword=Sigel,%|\\
-| ||heading=subbibnumbered,%|\\
-| ||title={Abkürzungen und Sigel}]|\\
+\item[prepublished] Article has been published in an (online) preversion.
-Die Teilbibliographie umfasst dann nur Einträge, die unter |keywords = {Sigel}| stehen haben:
-\begin{bsp}
-\printbibliography[keyword={Sigel},
- heading=subbibnumbered,
- title={Abkürzungen und Sigel}]\label{bib:sigel}
-\end{bsp}
+\begin{lstlisting}
+pubstate = {prepublished}
+\end{lstlisting}
-Ebenso hilfreich kann es sein, dass die verwendeten Abkürzungen der Zeitschriften und Reihen aufgelöst werden.
-Dies geschieht für die Zeitschriften mit:
+\end{description}
+This following example is about an article which was accepted by the journal and so we use |pubstate = {forthcoming}|:
+\begin{lstlisting}[style=bibentry,label=Bossert:forthcoming,caption={{@}Article\{Bossert:forthcoming,…\} }]
+@Article{Bossert:forthcoming,
+ author = {Lukas C. Bossert},
+ title = {\ldots\ \textsc{in formam anitqvam restitvto}?},
+ subtitle = {Überlegungen zur Inschrift der ›Porticus Deorum Consentium‹ (CIL\,VI 102) und ihren Ergänzungen im 19.{\,}Jh.},
+ journaltitle = {BeStAR. Berliner Studien zum Antiken Rom},
+ shortjournal = {BeStAR},
+ volume = {2},
+ pubstate = {forthcoming},
+}
+\end{lstlisting}
-|\printbiblist[%|\\
-| ||heading=subbibnumbered,%|\\
-| ||title={Zeitschriftenabkürzungenl}]{shortjournal}|\\
-\begin{bsp}
-\printbiblist[heading=subbibnumbered,
-title={Zeitschriftenabkürzungen}]{shortjournal}
-\end{bsp}
+\printbib[9em]{Bossert:forthcoming}
-bzw. für die Reihen:
+\clearpage
+\begin{multicols}{2}\footnotesize
+\lstlistoflistings
+\end{multicols}
+\section{Additional bibliography with ancient authors and works}\label{list-bibancient}
+The bibliography |archaeologie-bibancient.bib| is filled with ancient authors, works and their abbreviation according to The New Pauly.
+The bold entry on the left is the |bibtex-key|.\footnote{If you think the list should be enlarged, let us know the entries.}
+All the entries have the fields |keywords={ancient}|, |options={ancient}|.
-|\printbiblist[%|\\
-| ||heading=subbibnumbered,%|\\
-| ||title={Reihenabkürzungen}]{shortseries}|\\
+\begin{multicols}{2}
+ \input{archaeologie-ancient.tex}
+\end{multicols}
+ \changes{v1.5}{2016/05/31}{Antike Bibliographie}
-\begin{bsp}
-\printbiblist[heading=subbibnumbered,title={Reihenabkürzungen}]{shortseries}\end{bsp}
-\end{refsection}
-\setcounter{section}{5}
-\section{Abkürzungen nach DAI-Richtlinie}\label{listen}
+\section{Additional bibliography with corpora}\label{list-bibcorpora}
+List of corpora in ancient studies |archaeologie-bibcorpora.bib|.
+This activates the other additional bibliography |archaeologie-lstabbrv.bib| automatically.
+The bold entry on the left is the |bibtex-key|.\footnote{If you think the list should be enlarged, let us know the entries.}
+All the entries have |keywords={corpus}|, |options={corpus}|.
+\begin{multicols}{2}
+ \input{archaeologie-corpora.tex}
+\end{multicols}
+ \changes{v1.5}{2016/05/31}{Antike Bibliographie}
+
+\section{List of locations}\label{list-locations}
+\DescribeMacro{lstlocations}If you use the option |lstlocations| it will load an additional bibliography called |archaeologie-lstlocations.bib|.\footnote{If you think the list should be enlarged, let us know the entries.}
+Below you find a list with the available locations in five (at maximum) different languages.
+The bold entry on the left is to use for |location=|\meta{location} -- do not put \meta{location} into |{}|.
+In these examples we used such |@Strings|:
+\cref{Mundt2015,Emme2013,Neufert2002,Wulf-Rheidt2013,Cic:Sest,Fest,CIL,Mann2011,Zanker2009,%
+MacDonald1986,Kohlmeyer1983,Parlasca1969,Kurapkat2014,Torelli1991,%
+Lexikon-der-Technik,Bergmann2015}
+
+
+\begin{multicols}{3}
+\begin{description}\footnotesize
+\item[Aix-la-Chapelle] <-- English\newline German: Aachen\newline Italian: \newline Spanish: Aquisgrán\newline French: Aix-la-Chapelle
+\item[Athens] <-- English\newline German: Athen\newline Italian: Atene\newline Spanish: Atenas\newline French: Athènes
+\item[Augsburg] <-- English\newline German: Augsburg\newline Italian: Augusta\newline Spanish: Ausburgo\newline French: Augsbourg
+\item[Basle] <-- English\newline German: Basel\newline Italian: Basilea\newline Spanish: Basilea\newline French: Basel
+\item[Berlin] <-- English\newline German: Berlin\newline Italian: Berlino\newline Spanish: Berlín\newline French: Berlin
+\item[Brussels] <-- English\newline German: Brüssel\newline Italian: Bruxelles\newline Spanish: Bruselas\newline French: Bruxelles
+\item[Cologne] <-- English\newline German: Köln\newline Italian: Colonia\newline Spanish: Colonia\newline French: Cologne
+\item[Copenhagen] <-- English\newline German: Kopenhagen\newline Italian: Copenaghen\newline Spanish: Copenhague\newline French: Copenhague
+\item[Dresden] <-- English\newline German: Dresden\newline Italian: Desda\newline Spanish: Dresde\newline French: Dresde
+\item[Florence] <-- English\newline German: Florenz\newline Italian: Firenze\newline Spanish: Firenze\newline French: Florence
+\item[Frankfort-on-the-Main] <-- English\newline German: Frankfurt am Main\newline Italian: Francoforte sul Meno\newline Spanish: Francfort del Meno\newline French: Francfort-sur-le-Main
+\item[Freiburg] <-- English\newline German: Freiburg (i. Breisgau)\newline Italian: Friburgo in Brisgovia\newline Spanish: Friburgo de Brisgovia\newline French: Fribourg-en-Brisgau
+\item[Goettingen] <-- English\newline German: Göttingen\newline Italian: Gottinga\newline Spanish: Gotinga\newline French: Gœttingue
+\item[Hamburg] <-- English\newline German: Hamburg\newline Italian: Amburgo\newline Spanish: Hamburgo\newline French: Hambourg
+\item[Leipzig] <-- English\newline German: Leipzig\newline Italian: Lipsia\newline Spanish: Leipzig\newline French: Leipzig
+\item[London] <-- English\newline German: London\newline Italian: Londra\newline Spanish: Londres\newline French: Londres
+\item[Louvain] <-- English\newline German: Löwen\newline Italian: Lovanio\newline Spanish: Lovaina\newline French: Louvain
+\item[Mainz] <-- English\newline German: Mainz am Rhein\newline Italian: Magonza\newline Spanish: Maguncia\newline French: Mayence
+\item[Milan] <-- English\newline German: Mailand\newline Italian: Milano\newline Spanish: Milán\newline French: Milan
+\item[Munich] <-- English\newline German: München\newline Italian: Monaco (di Bavaria)\newline Spanish: Múnich\newline French: Munich
+\item[Naples] <-- English\newline German: Neapel\newline Italian: Napoli\newline Spanish: Napoli\newline French: Naples
+\item[Paris] <-- English\newline German: Paris\newline Italian: Parigi\newline Spanish: París\newline French: Paris
+\item[Regensburg] <-- English\newline German: Regensburg\newline Italian: Ratisbona\newline Spanish: Ratisbona\newline French: Ratisbonne
+\item[Rome] <-- English\newline German: Rom\newline Italian: Roma\newline Spanish: Roma\newline French: Rome
+\item[Saarbrucken] <-- English\newline German: Saarbrücken\newline Italian: \newline Spanish: Saarbruck\newline French: Saarbruck
+\item[Stuttgart] <-- English\newline German: Stuttgart\newline Italian: Stoccardo\newline Spanish: Estútgart\newline French: Stuttgart
+\item[Trier] <-- English\newline German: Trier\newline Italian: Treviri\newline Spanish: Trèveris\newline French: Trèves
+\item[Tuebingen] <-- English\newline German: Tübingen\newline Italian: Tubinga\newline Spanish: Tubinga\newline French: Tubingue
+\item[Vienna] <-- English\newline German: Wien\newline Italian: Vienna\newline Spanish: Viena\newline French: Vienne
-Da die Schreibweise von manchen Kürzeln der Zeitschriften oder Reihen nicht als |@string| übernommen werden konnten, musste die Liste an die \TeX-verarbeitende Lesart angepasst werden.
-Generell gilt, dass Akzente weggelassen wurden, Umlaute ausgeschrieben (ä--> ae), ähnliche Buchstaben mit Äquivalenten ersetzt wurden (ı --> i).\footnote{Für problemloses Kompilieren und Verarbeiten der nichtlateinischen Buchstaben wird \hologo{XeLaTeX} oder \hologo{LuaTeX} empfohlen.}
-Nachfolgend werden zwei Listen angeführt, die die Auflistung nach @string (links) und Ausgabe (rechts) zeigen.
-Die erste Liste enthält die Abkürzungen (\cref{liste-kurz}), die zweite Liste die ausgeschriebenen Namen (\cref{liste-lang}).
-Es empfiehlt sich, in diesen Listen die |@string|-Angaben nachzuschauen und dann für |journaltitle| und |shortjournal|, bzw. |series| und |shortseries| einzutragen.
+\end{description}
+\end{multicols}
+\section{List of publishers}\label{list-publishers}
+Below there is a list with\DescribeMacro{@String} |@String| (in \textbf{bold} letters on the left), which you can use for the field |publisher|.\footnote{If you think the list should be enlarged, let us know the entries.}
+In these examples we used such |@String|:
+\cref{Mundt2015,Quint:inst,Emme2013,Neufert2002,Wulf-Rheidt2013,Cic:Att,Cic:Sest,Zanker2009,Zanker1988,MacDonald1986,Carter2014,%
+Fentress2003,Welch2007,Sear2006}
-Die Unterscheidung, ob in der Bibliographie die Abkürzung (Standard) oder der voller Titel genannt werden soll, erfolgt automatisch über die Option |noabbrevs| (Siehe \cref{noabbrevs}). Ist diese Option nicht aktiviert, dann werden standardmäßig die Abkürzungen angegeben.
+\begin{multicols}{2}
+\begin{description}\footnotesize
+\item[AWi] Artemis \& Winkler
+\item[CHB] C.\ H.~Beck
+\item[COUP] Cornell University Press
+\item[CUP] Cambridge University Press
+\item[EdB] L'erma di Bretschneider
+\item[EQ] Edizioni Quasar
+\item[FZ] Franz Steiner
+\item[GLF] Gius. Laterza \& Figli Spa
+\item[HUP] Harvard University Press
+\item[JHUP] Johns Hopkins University Press
+\item[JPGM] J. Paul Getty Museum
+\item[MI] Michael Imhof
+\item[MIT] MIT Press
+\item[OUP] Oxford University Press
+\item[PUP] Princeton University Press
+\item[PvZ] Philip von Zabern
+\item[stw] suhrkamp taschenbuch wissenschaft
+\item[TopoiB] Topoi. Berliner Studien der Alten Welt
+\item[UCP] University of California Press
+\item[UMP] University of Michigan Press
+\item[UTP] University of Texas Press
+\item[UWP] University of Wisconsin Press
+\item[VML] Verlag Marie Leidorf
+\item[VR] Vandenhoeck \& Ruprecht
+\item[VS] Verlag für Sozialwissenschaften
+\item[VT] Vieweg+Teubner
+\item[WBG] Wissenschaftliche Buchgesellschaft
+\item[WdG] Walter de Gruyter
+\item[YUP] Yale University Press
+\end{description}
+\end{multicols}
+\section{List of abbreviation according to the German Archaeological Institute-guidelines}\label{abbrv-lists}
+We modified the lists with abbreviations of journals, corpora, etc. to make them usable with |bib|\LaTeX.
+Below there are two lists with\DescribeMacro{@String} |@String| (in \textbf{bold} letters on the left),
+one with the abbreviations (\cref{liste-kurz}), the other with the long forms (\cref{liste-lang}).
-%%Beim Kompilieren wird eine Bibliographiedatei (|dai-abkuerzungen.bib|) erstellt, in der die Angaben der |@strings| gespeichert sind.
-%%Diese Bibliographiedatei wird zusätzlich zur eigenen Bibliographie geladen.
-%%Ist |dai-abkuerzungen.bib| bereits vorhanden, dann wird sie nicht neu generiert.
+We recommend to look up the journal names in the list and insert the |@String| in the fields |journaltitle| and |shortjournal|, or |series| and |shortseries|.
-\subsection{Kurzformen\label{liste-kurz}}
+\subsection{Short form} \label{liste-kurz}
\begin{multicols}{2}
-\input{dai-abkuerzungen-kurz-liste.tex}
+\input{archaeologie-lstabbrv-short.tex}
\end{multicols}
-\subsection{Langformen\label{liste-lang}}
-Die Ausgabe erfolgt über die Option |noabbrevs|.
+\subsection{Long forms}\label{liste-lang}
+\DescribeMacro{noabbrv}
+To see the long forms of journal titles or series you have to switch on the option |noabbrv|.
%\begin{multicols}{1}
-\input{dai-abkuerzungen-lang-liste.tex}
+\input{archaeologie-lstabbrv.tex}
%\end{multicols}
\changes{v1.1}{2015/07/06}{Erstellung der Liste mit Abkürzungen}
-
-%\section{Umsetzung}
-%\label{driver}
-%|archaeologie| besteht aus einem Bibliographieformat (|bbx|) und einem Zitierformat (|cbx|).
-%%%
-%
-%\subsection{archaeologie.bbx}
+%%\clearpage
+%%\section{Umsetzung}
+%%\label{driver}
+%%|archaeologie| consists of various files:
+%%There is one file that takes care of the bibliography (|bbx|)
+%%another looks after the citation-style (|cbx|)
+%%and several files which are necessary for the individual languages (|lbx|),
+%%furthermore there is a |dbx|-file.
+%%
+%%%http://tex.stackexchange.com/questions/95036/continue-line-numbers-in-listings-package
+%%\subsection{archaeologie.bbx}
%%|archaeologie| baut auf dem |standard|-Stil von |biblatex| auf, der entsprechend geladen werden muss.
-%% \begin{macrocode}
+%% \DescribeMacro{bbx}
+%% \StartLineAt{13}
+%%\begin{lstlisting}[style=code]
%%\ProvidesFile{archaeologie.bbx}%
-%% [2015/09/15 v1.0 archaeologie -- %
-%% biblatex fuer Archaeologen, Historiker und Philologen, bbx-Datei]
+%% [2016/05/31 v2.0 archaeologie -- %
+%% biblatex for archaeologists,
+%% historians and philologists, bbx-file]
%%\RequireBibliographyStyle{standard}
-%% \end{macro}
-%
-%
+%%\end{lstlisting}
+%%
+%%It continues with all required settings
+%%\ContinueLineNumber
+%%\begin{lstlisting}[style=code]
+%%\AtBeginDocument{%
+%% \urlstyle{sf}%
+%% \typeout{* * * archaeologie * * *
+%% biblatex for archaeologists,
+%% historians and philologists}
+%%}
+%%\ExecuteBibliographyOptions{%
+%%pagetracker=true,%
+%%citecounter=true,%
+%%giveninits=true,%
+%%sortlocale=auto,%
+%%language=auto,%
+%%autolang=other,%
+%%bibencoding=utf8,%
+%%dateabbrev=false, %
+%%sorting=nyt,%
+%%maxnames=2,%
+%%minnames=1,%
+%%maxitems=1,%
+%%maxbibnames=999,%
+%%}
+%%\end{lstlisting}
+%% \StartLineAt{426}
+%%\begin{lstlisting}[style=code]
+%%\renewbibmacro*{journal}{%
+%% \ifboolexpr{test {\iffieldundef{shortjournal}} %
+%% or bool {bbx:noabbrevs}}%
+%% {\printtext[journaltitle]{%
+%% \printfield[titlecase]{journaltitle}%
+%% \setunit{\subtitlepunct}%
+%% \printfield[titlecase]{journalsubtitle}}}%
+%% {\printfield{shortjournal}}%
+%% }
+%%\end{lstlisting}
+%%
+
%\subsection{archaeologie.cbx}
\changes{v0.1}{2015/06/04}{Started Project}
@@ -1864,5 +2370,4 @@ Die Ausgabe erfolgt über die Option |noabbrevs|.
\PrintChanges
\PrintIndex
-
\end{document}