% archaeologie --%
% biblatex for archaeologists, 
% historians and philologists
% Copyright (c) 2017 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 = lualatex
\documentclass[a4paper,
10pt,
greek,
french,
spanish,
italian,
ngerman,
english,
]{ltxdoc}
\input{archaeologie-preamble.tex}
\hyphenation{}
\externaldocument{archaeologie-ger}[archaeologie-ger.pdf]% <- full or relative path

% \makeatletter
% \patchcmd{\@mpfootnotetext}%
%   {\color@begingroup}
%   {\color@begingroup\toggletrue{blx@footnote}}
%   {}
%   {}
% \makeatother
 
 
\begin{document}
\pdfbookmark[1]{Titlepage}{title}
\title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} for archaeologists\footnote{Also very handy for (ancient) History or Classics, too.
For further information about the code visit \href{http://www.biblatex-archaeologie.de}{biblatex-archaeologie.de}: 
Comments and criticisms are welcome.
We thank especially \href{https://tex.stackexchange.com/users/35864/moewe}{moewe} and \href{https://tex.stackexchange.com/users/2478/herbert}{herbert} for their great help with the code.%
}}
\author{Lukas C. Bossert\\{\small \href{mailto:info@biblatex-archaeologie.de}{info@biblatex-archaeologie.de}} 
\and Johannes Friedl}
\date{Version: \archaeologieversion{} (\archaeologiedate)} 
\maketitle

\begin{abstract}
\noindent This citation-style covers the citation and bibliography rules of the \DAI (DAI). 
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.
\bigskip

\noindent For a short introduction in German see   \href{pdfdeu.biblatex-archaeologie.de}{\textbf{online}} or   \href{file:archaeologie-ger.pdf}{\textbf{local}}.
\end{abstract}


\begin{multicols}{2}
\footnotesize\parskip=0mm \tableofcontents
\end{multicols}

\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{https://www.ctan.org/pkg/archaeologie}} and copy the content of the |zip|-file 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| which has to be activated in the preamble. 

\begin{code}
\usepackage[style=archaeologie,%
          *@\meta{further options}@*]{biblatex}
\addbibresource*@\marg{|bib|-file.bib}@*
\end{code}

Without any further options the style follows the rules of the \DAI. 
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 such as those of ancient authors and  modern scholars we suggest  having them listed in separate bibliographies. 
Further information can be found below   (\cref{bibliographie}).

\section{Overview}\label{overview}
There follows 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 relating to 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 
\DAI 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}.

\DescribeMacro{citeauthorformat}\archversion{2.3.6}
You can chose how the name of authors or editors are displayed within your text when they are cited with \cs{citeauthor}\marg{bibtex-key}.
You can chose between the options 
\meta{initials}, 
\meta{full}, 
\meta{family}, 
\meta{firstfulltheninitials},
\meta{firstinitialsthenfamily},
\meta{firstfullthenfamily}; 
cf. \cref{citeauthorformat}.



\DescribeMacro{initials}
First names are abbreviated keeping digraphs and trigraphs (this is default); cf. \cref{initials}.

\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 affected by this option.

\subsubsection{Manner of citing}

\DescribeMacro{edby}
Switches \enquote{ed.}/\enquote{Hrsg.} to \enquote{ed. by}/\enquote{hrsg. v.}; cf. \cref{edby}.

\DescribeMacro{inreferences}
Each bibliography entry which is an |@Inreference| is fully referenced according to the special rules of the 
\DAI for manuals and encyclopaedias; cf. \cref{inreferences}.

\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}.

\DescribeMacro{publisher}
All locations and the publisher is shown. 
It also changes the format of the edition and the first print; cf. \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 \DAI). 
So the first citation will be a full citation and all the following citations will refer to the first full citation; cf. \cref{seenote}

\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}. 

\DescribeMacro{yearinparens}
The year is shown in parentheses; cf. \cref{yearinparens}.

\DescribeMacro{yearseries}
Switches the order of series and year; cf. \cref{yearseries}.
 
\subsubsection{Global bibliography settings}

\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 of 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 fragmentary 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}.

\DescribeMacro{uniqueme} 
In cases there are different translations of an ancient work you can decide which one is the standard translation and which ones should be made unique by displaying the translator/series/editor; cf. \cref{uniqueme}.

\changes{v1.1}{2015/06/04}{New options added in summary.}

\subsection{Cite commands}
\label{cite-commands}
\subsubsection{cite and cites}
\DescribeMacro{\cite}
As always citing is done with \cs{cite}:
\begin{code}
\cite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
\end{code}

\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{code}
\cite*@\oarg{postnote}\marg{bibtex-key}%@*
\end{code}
The \meta{bibtex-key} corresponds to the key from the bibliography file.

\begin{example}
Public space is part of a city says \cite{Osland2016}.
\end{example}

\DescribeMacro{\cites}
If one wants to cite several authors or works a very convenient way is the following using the \cs{cites}-command:
\begin{code}
\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{code}
\begin{example}
Public space is part of a city say \cites(cf.)(){Osland2016}{Evangelidis2014}.
\end{example}
 
 \subsubsection{parencite and parencites}
\DescribeMacro{\parencite}
Sometimes a citation has to be put in parentheses. 
Therefore we implemented the command \cs{parencite}:
\begin{code}
\parencite*@\oarg{postnote}\marg{bibtex-key}%@*
\end{code} 
This cite command takes care of the correct corresponding parentheses and brackets.
Especially in |@Inreference| citations the parentheses  change to (square) brackets.
The example shown in \cref{faq:inreference} makes it clear.
\begin{example}
Public space is part of a city \parencite{Osland2016}.
\end{example}

\DescribeMacro{\parencites}
Of course there is also the possibility to cite several authors/works in parentheses.
This is done with \cs{parencites}:
\begin{code}
\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{code}
\begin{example}
Public space is part of a city \parencites(cf.)(){Osland2016}{Evangelidis2014}.
\end{example}

\subsubsection{textcite and textcites}
\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 such as year and page will immediately follow in parentheses. 
\begin{code}
\textcite*@\oarg{postnote}\marg{bibtex-key}%@*
\end{code} 

\begin{example}
Public space is part of a city says \textcite{Osland2016}.
\end{example}

\DescribeMacro{\textcites}
And again there is also a \cs{textcites} in case of several authors: 
\begin{code}
\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{code}
\begin{example}
Public space is part of a city say \textcites{Osland2016}[cf.][]{Evangelidis2014}.
\end{example}
Just be aware that using \oarg{prenote} may be give a odd sounding sentence depending what you use \oarg{prenote} for.

\subsubsection{footcite}
 \DescribeMacro{\footcite}
 Beside the listed \cs{cite} commands above there are more possibilities citing:
 There is also the possibility to put the citation into a footnote at once with \cs{footcite}:
 \begin{code}
\footcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*
\end{code}
\begin{example}
Public space is part of a city.\footcite{Osland2016}
\end{example}
This is the equivalent to |\footnote{\cite{Osland2016}.}| but it saves you a lot of time typing.
 \DescribeMacro{\footcites} And there is as well \cs{footcites}:
\begin{example}
Public space is part of a city.\footcites(cf.)(){Osland2016}{Evangelidis2014}
\end{example}
 
 \subsubsection{smartcite and smartcites}

\DescribeMacro{\smartcite}
And there is also a clever way citing with \cs{smartcite}.
\cs{smartcite} depends on its environment it is used in. If it is your normal text it behaves like \cs{footcite} and will print the citation within a footnote.
If it is already within a footnote it will be handled like \cs{cite}. 
 is a clever 
\begin{code}
\smartcite*@\oarg{postnote}\marg{bibtex-key}%@*
\end{code} 

\begin{example}
Public space is part of a city.\smartcite{Osland2016} 
And sometimes more than that.\footnote{\smartcite[cf.][]{Evangelidis2014}.}
\end{example}


\DescribeMacro{\smartcites}
And again there is also a \cs{smartcites} in case of several authors: 
\begin{code}
\smartcites(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{code}
\begin{example}
Public space is part of a city.\smartcites{Osland2016}{Evangelidis2014} 
And sometimes more than that.\footnote{\smartcites{Osland2016}[cf.][]{Evangelidis2014}.}
\end{example}

\subsubsection{autocite}

\DescribeMacro{\autocite}
With \cs{autocite} there is a flexible way of citing. 
We set up \cs{autocite} as \cs{footcite} by default.
If you want to change it you can also write in the preamble e.\,g. |autocite=inline|.
\begin{code}
\autocite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
\end{code} 

\begin{example}
Public space is part of a city.\autocite{Osland2016} 
\end{example}

\subsubsection{fullcite and footfullcite}
\DescribeMacro{\fullcite}\DescribeMacro{\footfullcite}
With \cs{fullcite} and \cs{footfullcite} you can print the complete entry in your current text.
\begin{code}
\fullcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*
\footfullcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*
\end{code} 

\begin{example}
Public space is part of a city.\footfullcite{Osland2016}
As can be read in \fullcite{Evangelidis2014}
\end{example}


\subsubsection{citeauthor and citetitle}

\DescribeMacro{\citeauthor}
\DescribeMacro{\citetitle}\label{citeauthor}%
Furthermore and in addition 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{code}
\citeauthor*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
\end{code} 
  and for the works 
\begin{code}
\citetitle*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
\end{code} 

\begin{example}
Public space is part of a city says \citeauthor{Osland2016} in \citetitle{Osland2016}.
\end{example}
For further information cf. \cref{citeauthorformat}.

Note that the |\citetitle|-command works differently with ancient works (for all those who have  |option={ancient}|). 
First the field |origtitle| will be shown if this field is empty it will show its |title| instead. 

\DescribeMacro{\citetitle*}
Sometimes you don’t need the year of publication but still want the published title. 
Then |\citetitle*| is what you need:
\archversion{2.3.4} 
\begin{example}
In 2016  \citeauthor{Osland2016} says in \citetitle*{Osland2016} 
public space is part of a city.
\end{example}

Note that the |\citetitle*|-command will always show the field |title| without the year of publication it doesn’t matter if there is |option={ancient}|.

\subsubsection{citetranslator}
\DescribeMacro{\citetranslator}\label{citetranslator}%
\archversion{2.3.0} 
Addionally there is also a \cs{cite}-command which can be used to print the translator of an (ancient) publication.
\begin{code}
\citetranslator*@\marg{bibtex-key}%@*
\end{code}
This will print the name(s) of the translator according to the chosen |citeauthorformat|.

\begin{example}
\blockcquote[12,25,1]{Cic:Att}{Aber dein Heim ist das Forum.} (\citetranslator{Cic:Att})
\end{example}
\archversion{2.3.3} 
If there is no translator given it will name you as translator using a |bibstring| with \enquote{own translation}.
\begin{example}
\blockcquote[3,62,1]{Artem}{The Agora means confusion and uproar because of the people that are gathered there.} (\citetranslator{Artem})
\end{example}
You can change the |bibstring| \enquote{own translation} and replace it with anything you like, 
at least it is done in the preamble of your document.
\begin{code}
\DefineBibliographyStrings{english}{%
  owntranslation = {by me},%
}
\end{code}



\DescribeMacro{\citetranslator*}\archversion{2.3.0}
\begin{code}
\citetranslator* *@\marg{bibtex-key}%@*
\end{code} 

The starred version prints also the informtion from which language the text has been translated.

\begin{example}
\blockcquote[12,25,1]{Cic:Att}{Aber dein Heim ist das Forum.} (\citetranslator*{Cic:Att})
\end{example}



\subsection{Entries with @String}\label{string}
The citation rules of the \DAI 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} <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 \DAI 
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 following bibliography fields should be field with such a a |@String|: |journaltitle| and |shortjournal|,
(|series| and |shortseries|.
In \cref{abbrv-lists} there is a list with all the abbreviations given by the \DAI, 
in which the |@String| (with endings |-short| for |shortjournal| or |shortseries|) are listed in the left column.  
An |@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| 
\LKeyStrg + \LKey{R}
 which enables direct BibTeX typing without enclosing curly brackets.}


An example shows how to use it:

\begin{bibexample}[label=Koyunlu1990]{{@}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{bibexample}


That article appeared within a rather unusual journal, 
which should be abbreviated with ›AyasofyaMüzYıl‹.

To save  time  looking 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{bibbox}{Koyunlu1990}\footnotesize
\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{bibbox}
Nevertheless the advantage of our abbreviation list lies in the possibility of creating 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 |biblatex-biber| 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 appropriate and possible.

Lastly we want to point out that |@Strings| can also be used partly as following shows:

\begin{code}
@Incollection{Mundt2015,
  ...
  location     = Berlin #{ and Boston}, %@String partly used
  ...
}
\end{code}

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}
In the 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{code}
\usepackage[%        
    backend=biber,  % activates biber (default; 
                    % but will give an error if not done)
    style=archaeologie,   % loads the style *@|archaeologie|@*
    inreferences=true,    % option *@|inreferences|@* is loaded
    lstabbrv              % option *@|lstabbrv|@* is loaded as well
    ]{biblatex}
\end{code}
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 their 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 |archaeologie-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:

With the loaded option |bibancient| you can cite like this:  


\begin{example}
\footnote{\cite[3,2,5--7]{Apul:met}.}
\end{example}


The corresponding bibliography-entry looks like this
\begin{bibexample}[label=Apul:met]{{@}Book\{Apul:met,…\}}
@Book{Apul:met,
  author      = {Apuleius Madaurensis, Lucius},
  title       = {metamorphoses},
  shorthand   = {Apul. met.},
  shortauthor = {Apuleius},
  keywords    = {ancient},
  options     = {ancient},
}
\end{bibexample}
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{code}
\printbibliography[keyword=ancient]
\end{code}
\printbib{Apul:met}

\begin{refsection}
By means of the |bibtexkey| (e.g. |Apul:met|) you can also cite only authors or titles like this: 


\begin{example}
\citeauthor{Apul:met} remarks in \citetitle{Apul:met} ...
\end{example}

\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{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}.

\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}.

\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}




\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 \DAI
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 from this speciality and are cited as always.

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.

We give an example:
\begin{tcolorbox}[examplebox] 
This is the first citation.|\footnote{\cite{Ball2013}.}|
This is one in between.|\footnote{anything in here.}|
And this is the third footnote and the second citation.|\footnote{\cite[470]{Ball2013}.}|
\tcblower
This is the first footnote.\footnote{L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current thinking on the Pompeii Forum, 117/3, 2013, 461–492.}
This is one in between.\footnote{anything in here.}
And this is the third footnote and the second citation.\footnote{Ball – Dobbins loc. cit. (see n. 1) 470.}
\end{tcolorbox}



\changes{v1.5}{2016/05/31}{Rückverweis}

\subsubsection{translation}\label{translation}
\DescribeMacro{translation}
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 clarify matters:
The bibliographical entry |Lefebvre2011| contains following fields:
\begin{bibexample}[label=Lefebvre2011]{{@}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{bibexample}

The bibliography result is:
\printbib[6em]{Lefebvre2011}

By activating option |translation| it will change to:

\begin{bibbox}{Lefebvre2011}\footnotesize
\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{bibbox}
 
However, it works not only with entries like |@Book| but also with e.\,g. |@Article|:

\begin{bibexample}[label=Lefebvre1977]{{@}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{bibexample}

Once again the bibliography entry alters:

\begin{bibbox}{Lefebvre1977}\footnotesize
\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{bibbox}

\subsubsection{inreferences}\label{inreferences}
\DescribeMacro{inreferences}  
There is the possibility to cite inreferences in the footnote as a full citations.
It is only required that the bibliography-entry is an |@Inreference|  (cf. \cref{inreference}).
 
Another example makes it clear: 
\begin{bibexample}[label=Nieddu1995]{{@}Inreference\{Nieddu1995,…\}}
@Inreference{Nieddu1995,
  author    = {Nieddu, Giuseppe},
  title     = {Dei Consentes},
  booktitle = LTUR-short,
  pages     = {9\psq},
  year      = {1995},
  volume    = {2},
}
\end{bibexample}

There are two ways to display this entry:
 \begin{enumerate}
 \item by default it will give:  
 \begin{example}
\footnote{\cite{Nieddu1995}.}
 \end{example}
 \item with the option |inreferences| it will change:
 \begin{tcolorbox}[examplebox]
 |\footnote{\cite{Nieddu1995}.}|
 \tcblower
\footnote{LTUR 2 (1995) 9\,f. s. v. Dei Consentes (G. Nieddu).}
 \end{tcolorbox}
  \end{enumerate}

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{enumerate} 
 \item by default it will give: 
 \begin{example}
\footnote{\cite[9]{Nieddu1995}.}
 \end{example}
 \item with the option |inreferences| it will change again:
  \begin{tcolorbox}[examplebox]
|\footnote{\cite[9]{Nieddu1995}.}|
 \tcblower
\footnote{LTUR 2 (1995) 9 s. v. Dei Consentes (G. Nieddu).}
 \end{tcolorbox}
  \end{enumerate}



\begin{marker}
    Activating |inreferences=true| 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 \DAI rules).
\end{marker}

If the option is not used (|inreferences=false|) the entry will look like this in the bibliography:

\printbib[6em]{Nieddu1995} 

\subsubsection{yearseries}\label{yearseries}
\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:
 
\begin{bibexample}[label=Mundt2015]{{@}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{bibexample}

Without any option activated it will look like this:
\printbib[5em]{Mundt2015}
 
By activating |yearseries| it will change to:
\begin{bibbox}{Mundt2015}\footnotesize
\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{bibbox}

\subsubsection{citeauthorformat}\label{citeauthorformat}\archversion{2.3.6}
\DescribeMacro{citeauthorformat}
\DescribeMacro{=initials}
\DescribeMacro{=full}
\DescribeMacro{=family}
\DescribeMacro{=firstfulltheninitials}
\DescribeMacro{=firstinitialsthenfamily}
\DescribeMacro{=firstfullthenfamily}
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});
this has 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 |citeauthorformat=full|.
If you want in contrast the authors to be shorten to their last names use |citeauthorformat=family|.

The following example illustrates it:

\begin{bibexample}[label=Boehmer1985]{{@}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{bibexample}

Let's assume you would like to write something like that and
after compiling it will look like this, 
because the default is set  |citeauthorformat=initials| 

\begin{refsection}
\begin{example}
... , this is also shown by \citeauthor{Boehmer1985} 
 in their latest article \citetitle{Boehmer1985}.
 \end{example}



Or you can change it using the settings in the preamble:

\begin{enumerate}
\item\label{name:full} 
\begin{tcolorbox}[examplebox]
 |citeauthorformat=full| 
 \tcblower
\ldots , this is also shown by {\color{red}Rainer Michael Boehmer and Nadja Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985).
\end{tcolorbox}
\item\label{name:family}
\begin{tcolorbox}[examplebox]
 |citeauthorformat=family| 
 \tcblower
\ldots , this is also shown by {\color{red}Boehmer and  Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985).
\end{tcolorbox}
\item\label{name:firstfulltheninitials}
\begin{tcolorbox}[examplebox]
 |citeauthorformat=firstfulltheninitials|
 \tcblower
\ldots , this is also shown by \textcolor{red}{Rainer Michael Boehmer  and Nadja Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985). 
\textcolor{red}{R. M. Boehmer  and N. Wrede} argue that \ldots
\end{tcolorbox}
  If you use |citeauthorformat=firstfulltheninitials| the first citation will look like \ref{name:firstfull}, but after that that all following citations of |\citeauthor{Boehmer1985}| will change to the default behaviour and show the initials.
  
\item\label{name:firstfulltheninitials}
\begin{tcolorbox}[examplebox]
 |citeauthorformat=firstfullthenfamily|
 \tcblower
\ldots , this is also shown by \textcolor{red}{Rainer Michael Boehmer  and Nadja Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985). 
\textcolor{red}{Boehmer  and Wrede} argue that \ldots
\end{tcolorbox}
 If you use |citeauthorformat=firstfullthenfamily| the first citation will look like \ref{name:firstfull}, but after that that all following citations of |\citeauthor{Boehmer1985}| will change and only show the family name(s), \ref{name:family}.


\item\label{name:firstinitialsthenfamily}
\begin{tcolorbox}[examplebox]
 |citeauthorformat=firstinitialsthenfamily|
 \tcblower
\ldots , this is also shown by \textcolor{red}{R. M. Boehmer  and N. Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985). 
\textcolor{red}{Boehmer  and Wrede} argue that \ldots
\end{tcolorbox}

 If you use |citeauthorformat=firstinitialsthenfamily| the first citation will look like |citeauthorformat=initials|, but after that that all following citations of |\citeauthor{Boehmer1985}| will change and only show the family name(s), \ref{name:family}.
\end{enumerate}
\end{refsection}

To complete this example,
here is the appearence of the entry in a bibliography:
\printbib[9.5em]{Boehmer1985}


Two things are left to mention: 
\begin{enumerate}
\item Citing an author in a footnote will start again with a first mention and then continue writing the name depending on your chosen option.

\item There is a slightly different behavior 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 are demonstrated in the following example: Based on the bibliography entry
\end{enumerate}
\begin{bibexample}[label=Quint:inst]{{@}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{bibexample}

and the following statement we obtain the result:

\begin{refsection}
\begin{example}
... and \citeauthor{Quint:inst} names in \citetitle{Quint:inst} the  necessary physical qualities of an orator, too.
\end{example}
\end{refsection}

And again the bibliography for |@Book{Quint:inst}|:
\printbib[5em]{Quint:inst}

\subsubsection{yearinparens}\label{yearinparens}
\DescribeMacro{yearinparens}%
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 a common entry which will be shown like this
\begin{example}
\footnote{\cite[475]{Ball2013}.}
\end{example}


now we get

\begin{tcolorbox}[examplebox] 
|\footnote{\cite[475]{Ball2013}.}|
\tcblower
\footnote{Ball – Dobbins {\color{red}(}2013{\color{red})}, 475.}
\end{tcolorbox}


\subsubsection{scshape}\label{scshape}
\DescribeMacro{scshape}
You can also change the look of your citations. 
With |scshape| author names are set to small capitals---in footnotes and in the bibliography.

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 |\@Article{Ball2013}|---we have again by default:

\begin{example}
\footnote{\cite[475]{Ball2013}.}
\end{example}

But with |schape| it will turn into:

\begin{tcolorbox}[examplebox] 
|\footnote{\cite[475]{Ball2013}.}|
\tcblower
\footnote{{\scshape {\color{red}Ball – Dobbins}} 2013, 475.}
\end{tcolorbox}

And since the entry looks like this

\begin{bibexample}[label=Ball2013]{{@}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},
number       = {3},
}
\end{bibexample}


the output in the bibliography changes from:

\printbib[8em]{Ball2013}

to 

\begin{bibbox}{Ball2013}\footnotesize
\parbox[t]{3cm}{{\scshape \color{red}Ball – Dobbins} 2013}\parbox[t]{8.5cm}{%
L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492,\newline
...}
\end{bibbox}

\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{bibexample}[label=Osland2016]{{@}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{bibexample}

looks like

\printbib[6em]{Osland2016}

and with |bibfullname| it will change to:

\begin{bibbox}{Osland2016}\footnotesize
\parbox[t]{2cm}{Osland 2016} \parbox[t]{9cm}{{\color{red}Daniel} Osland, Abuse or Reuse? Public Space in Late Antique Emerita, AJA 120/ 1, 2016, 67–97,\\
...}
\end{bibbox}

\subsubsection{noabbrv}\label{noabbrevs}
\DescribeMacro{noabbrv}
According to the guidelines of the \DAI 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} 
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{bibexample}[label=Emme2013]{{@}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{bibexample}
\begin{refsection}\end{refsection}

Default settings produce:
\printbib[5em]{Emme2013}
 
By activating option |publisher| you obtain:

\begin{bibbox}{Emme2013}\footnotesize
\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{bibbox}
 
And here a more detailed example with |origlocation|, |origyear| and |origpublisher|:
\begin{bibexample}[label=Neufert2002]{{@}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{bibexample}
 
\printbib[5.5em]{Neufert2002}

\begin{bibbox}{Neufert2002}\footnotesize
\parbox[t]{1.7cm}{Neufert  2002} \parbox[t]{9.4cm}{%
E. Neufert, Bauentwurfslehre. Grundlagen, Normen, Vorschriften ... Ed. by Peter Neufert – Cornelius Neufert – Ludwig Neff  – Corinna Franken {\color{red} (Wiesbaden: Vieweg \textsuperscript{3}2002 [Berlin: Mann 1936])}}
\end{bibbox}
 
\subsubsection{edby}\label{edby}
\DescribeMacro{edby}
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{bibexample}[label=Wulf-Rheidt2013]{{@}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{bibexample}

Without option |edby| this |@Inproceedings| would look like:
 
\printbib[7em]{Wulf-Rheidt2013}

But activating |edby| it changes to:

\begin{bibbox}{Wulf-Rheidt2013}\footnotesize
\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{bibbox}
 
 
\subsubsection{width}\label{width}
\DescribeMacro{width}
|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 =| \meta{length}

\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} 
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{bibbox}{Boehm2001}\footnotesize
\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{bibbox}

If there has been no citation in the text (but maybe a \cs{citeauthor} or \cs{citetitle}):
\begin{bibbox}{Boehm2001}\footnotesize
\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{bibbox} 

For all languages besides German:
\begin{bibbox}{Boehm2001}\footnotesize
\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{bibbox}
  
If there has been only one citation:
\begin{bibbox}{Boehm2001}\footnotesize
\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{bibbox}

If there has been more than one citation:
\begin{bibbox}{Boehm2001}\footnotesize
\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{bibbox}

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{initials}\label{initials}
\DescribeMacro{initials} 
First names are abbreviated keeping digraphs and trigraphs instead of simple first letter initials.\footnote{The code for this option was taken from \href{http://tex.stackexchange.com/a/295486/98739}{tex.stackexchange.com/a/295486/98739} and has been modified.}
Also see the warning when printing an index; cf. \cref{initials:index}.
First names starting with |Ph..., Chr..., Ch..., Th..., St...| are abbreviated to these digraphs and trigraphs. For example in the bibliography or when you use \cs{citeauthor}\marg{bibtex-key}.

Citing these two authors will show their digraphs and trigraphs:

\begin{example}
\citeauthor{Mann2011} and \citeauthor{Hufschmid2010}
\end{example}



This option is set to default, but you can --- of course --- deactivate it with |initials=false| in the preamble.

With this default option you don’t have to change anything in your bibliographical-data.
However  you can switch off the option |initials| and do the abbreviation manually:

\begin{code}
author = {family=Mann, given=Christian, given-i={Chr}}

author = {family=Hufschmid, given=Thomas, given-i={Th}}
\end{code}


\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| ( by Jonathan Zachhuber),\footnote{\href{https://www.ctan.org/pkg/geschichtsfrkl}{www.ctan.org/pkg/geschichtsfrkl}} 
so after some modifications we adopted and included it into |archaeologie|.
 
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} you get entirely supported bibliography referencing.

Let us have a look at an example:
\begin{bibexample}[label=Cic:Att]{{@}Book\{Cic:Att,…\}}
@Book{Cic:Att,
  author       = {Tullius Cicero, Marcus},
  editor       = {Kasten, Helmut},
  title        = {Atticus-Briefe},
  publisher    = AWi,   %@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{bibexample}

Instead of applying |author| and |year| as labels the option |ancient| takes the field |shorthand| into account.

So you write in your text and it will be printed as

\begin{example}
\footnote{\cite[1, 3,3]{Cic:Att}.}
\end{example} 

Equally the field |shorthand| is used as a 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{bibexample}[label=Cic:Sest]{{@}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       = {2},
  publisher    = AWi,    %@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{bibexample}

Even support for several languages is taken into account as this bibliography entries show: 
\printbiball[4em]{Cic:Sest}

\subsubsection{frgancient}\label{frgancient}
\DescribeMacro{frgancient}
When dealing with fragments of ancient texts often it is important to cite the edition respective to the editor.
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{bibexample}[label=Fest]{{@}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{bibexample}

When you cite this entry in this example the field  |shorteditor| will be shown.
\begin{example}
\footnote{\cite[3]{Fest}.}
\end{example}

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[3em]{Fest}

\subsubsection{uniqueme}\label{uniqueme}
\DescribeMacro{uniqueme} 
Let us stick to ancient works for the option |uniqueme|:
Sometimes you cite different kinds of translations of one ancient author.
Despite you have several books the abbreviation of the ancient work is still the same and will be shown without a difference. 
For these cases we introduced an option with which you can decide which translation should be cited in the common citation and which ones should be enhanced with e.g. the translator, the series, or the editor.

Let us give you an example with the most famous ancient architect \citeauthor{Vitr}:
Since he is so famous there are variant translations of his text.
The German translation should be the standard referenced translation;
the bibliographical entry looks like this:
\begin{bibexample}[label=Vitr]{{@}Book\{Vitr,…\}}
@Book{Vitr,
  author        = {Vitruvius},
  title         = {Zehn Bücher über Architektur},
  publisher     = WBG, %@String used
  location      = {Darmstadt},
  year          = {2008},
  edition       = {6},
  origyear      = {1964},
  origtitle     = {De architectura},
  origlanguage  = {latin},
  translator    = {Fensterbusch, Curt},
  shorthand     = {Vitr.},
  shortauthor   = {Vitruv},
  keywords      = {ancient},
  options       = {ancient},
  sortshorthand = {Vitr.},
}
\end{bibexample}

When we cite \citeauthor{Vitr} we get the following result:
\begin{example}
\footnote{\cite[1,1,2]{Vitr}.}
\end{example}
Now let us assume we want to compare that with other, different translations / text editions. 
First the english standard translation (\cref{Vitr:Loeb}):
\begin{bibexample}[label=Vitr:Loeb]{{@}Book\{Vitr:Loeb,…\}}
@Book{Vitr:Loeb,
  author        = {Vitruvius},
  title         = {On Architecture},
  publisher     = HUP, %@String used
  location      = {Cambridge and London},
  year          = {1983},
  series        = {Loeb Classical Library},
  number        = {251},
  origyear      = {1931},
  origtitle     = {De architectura},
  origlanguage  = {latin},
  shorthand     = {Vitr.},
  shortauthor   = {Vitruv},
  keywords      = {ancient},
  options       = {ancient,uniqueme},
  shortseries   = {Loeb},
  sortshorthand = {Vitr. Loeb},
}
\end{bibexample}
Then there is also the French most common translation (\cref{Vitr:Saliou}):
\begin{bibexample}[label=Vitr:Saliou]{{@}Book\{Vitr:Saliou,…\}}
@Book{Vitr:Saliou,
  author        = {Vitruvius},
  title         = {De L'Architecture},
  publisher     = {Les belles lettres},
  location      = Paris, %@String used
  volumes        = {10},
  series        = {Collection des Universités de France},
  origtitle     = {De architectura},
  origlanguage  = {latin},
  translator    = {Saliou, Catherine},
  shorthand     = {Vitr.},
  shortauthor   = {Vitruv},
  keywords      = {ancient},
  options       = {ancient,uniqueme},
  date          = {1986/2009},
  sortshorthand = {Vitr. Saliou},
}
\end{bibexample}
And an old one (\cref{Vitr:Krohn}):
\begin{bibexample}[label=Vitr:Krohn]{{@}Book\{Vitr:Krohn,…\}}
@Book{Vitr:Krohn,
  author        = {Vitruvius},
  editor        = {Krohn, Franz},
  publisher     = {Teubner},
  location      = Leipzig, %@String used
  origtitle     = {Vitruvii De architectura libri decem},
  origlanguage  = {latin},
  shorthand     = {Vitr.},
  shortauthor   = {Vitruv},
  keywords      = {ancient},
  options       = {ancient,uniqueme},
  date          = {1912},
  sortshorthand = {Vitr. Krohn},
}
\end{bibexample}

And last there is a translation published in a section of a book (\cref{Vitr:Fischer}):
\begin{bibexample}[label=Vitr:Fischer]{{@}Book\{Vitr:Fischer,…\}}
@Inbook{Vitr:Fischer,
  author       = {Vitruvius},
  booktitle    = {Vitruv NEU oder Was ist Architektur?},
  year         = {2010},
  editor       = {Fischer, Günther},
  publisher    = {Birkhäuser},
  pages        = {70--76. 92--95. 132\psq},
  origlanguage = {latin},
  location     = Berlin, %@String used
  intranslator = {Fischer, Günther},
  keywords     = {ancient},
  options      = {ancient,uniqueme},
  origtitle    = {De architectura},
  origyear     = {2009},
  shorthand    = {Vitr.},
  sortshorhand = {Vitr. Fischer},
}
\end{bibexample}

If you cite these works you do as usual, you will get:
\begin{example}
\footnote{\cite[1,1,2]{Vitr}; see as well \cite{Vitr:Loeb}; with changed translation in \cite{Vitr:Krohn} and in \cite{Vitr:Saliou}; in \cite{Vitr:Fischer} it is kept untranslated.}
\end{example}


\begin{marker}
Notice that the field |sortshorthand| should be filled with the sorting order you would like to have in the bibliography for the varient works by \citeauthor{Vitr}, see below.
\end{marker}

\printbib[6em]{Vitr,Vitr:Fischer,Vitr:Krohn,Vitr:Loeb,Vitr:Saliou}


\subsubsection{corpus}\label{corpus}
\DescribeMacro{corpus}
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 the \oarg{prenote} or \oarg{postnote} you like to have.

This example shows the behaviour with a corpus that is common for Latin epigraphy:
\begin{bibexample}[label=CIL]{{@}Book\{CIL,…\}}
@Book{CIL,
  title     = CIL, %@String used
  location  = Berlin, %@String used
  year      = {1863--},
  shorthand = CIL-short,  %@String used
  keywords  = {corpus}, %!
  options   = {corpus},
}
\end{bibexample}

It will be cited with and you see the result right away:
\begin{example}
\footnote{\cite[06, 01234]{CIL}.}
\end{example}

The field |shorthand| will be used for bibliography reference,
where it is listed as label.
\printbib{CIL}

If you also set something like |keywords={corpus}| then you can make a separate bibliography with all the corpora cf. \cref{bibliographie}.

\changes{v1.1}{2015/06/15}{Modifikation der Option |corpus|.}


\section{Examples of entry types}\label{beispiele}
The style |archaeologie| defines several so-called bibliographical drivers,
which allow you 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.

\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}
 
 
An entry of a book might look as this in your |bib|-file:
\begin{bibexample}[label=Mann2011]{{@}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{bibexample}

A citation in a footnote is done like this and will be printed as you see:
\begin{example}
\footnote{\cite[Vgl.][142--144]{Mann2011}.}
\end{example} 
\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 using  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{bibexample}[label=Boehm2001]{{@}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{bibexample}

\printbib[9.5em]{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 guidance see the information about reviews in \cref{review}).

This example will clarify matters:
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{bibexample}[label=Zanker2009]{{@}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{bibexample}

In \citeyear{Zanker1988}, one year later after the first edition (|origyear|) the book was translated by A. H. Shapiro:
\begin{bibexample}[label=Zanker1988]{{@}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{bibexample}

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 (cf. \cref{mvbook})}
It may be 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  e.\,g. the second volume in particular you can do the following.
Let’s assume this is the bibliography entry:
\begin{bibexample}[label=MacDonald1986]{{@}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    = {2},
  series    = {Yale Publications in the History of Art},
  number    = {35},
}
\end{bibexample}
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[6.5em]{MacDonald1986}


\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|.

\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}
 
 
 
This following example clarify matters:
 \begin{bibexample}[label=Carter2014]{{@}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{bibexample}

\printbib[12em]{Carter2014}

You can also have contributions to a ›Festschrift‹ etc. set up as |@Incollection|,
but then notice the additional information in |booktitleaddon|.
\begin{bibexample}[label=Hoelscher2001]{{@}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{bibexample}
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{bibexample}[label=Fentress2003]{{@}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       = {5},
  series       = MemAmAc,    %@String used
  number       = {2},
  maintitle    = {Cosa},
  shortseries  = MemAmAc-short,    %@String used
}
\end{bibexample}
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[7.5em]{Fentress2003}

 
\subsubsection{Inventory catalogue}
The output of an inventory catalogue changes slightly compared to collections or something 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{bibexample}[label=Kohlmeyer1983]{{@}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{bibexample}
and the second example

\begin{bibexample}[label=Parlasca1969]{{@}Inbook\{Parlasca1969,…\}}
@Inbook{Parlasca1969,
  author    = {K. Parlasca},
  booktitle = {Helbig},
  year      = {1969},
  volume    = {3},
  edition   = {4},
  pages     = {98\psq\ Nr. 2176},
  location  = Tuebingen, %@String used
}
\end{bibexample}


\printbib[6em]{Kohlmeyer1983}
and
\printbiball[6em]{Parlasca1969}

\subsubsection{Section of Monograph}
\archversion{2.3.4}
In some cases there are several parts of a monograph which are written by variant people (e.\,g. excavation reports). 
Then the book is technically not an edited one by an editor but (mainly) written by one (book)author. 

The difference to an edited volume is that in the bibliography   there is no |(ed.)|, cf. \cref{Ganzert1984}.


\begin{bibexample}[label=Ganzert1984]{{@}Inbook\{Ganzert1984,…\}}
@Inbook{Ganzert1984,
author = {Herz, Peter},
title = {Gaius Caesar und Artavasdes},
bookauthor = {Ganzert, Joachim},
booktitle = {Das Kenotaph für Gaius Caesar in Limyra},
booksubtitle = {Architektur und Bauornamentik},
pages = {118--126},
publisher = {Wasmuth},
location = Tuebingen,
year = {1984},
zenon = {000042874},
series = IstForsch,
shortseries = IstForsch-short,
number = {35}
}
\end{bibexample}

\printbib[6em]{Ganzert1984}


\subsection{Type \texttt{@MvBook}}\label{mvbook}
\DescribeMacro{@MvBook}\archversion{2.3.4} If you have a small series consistend of several volumes and you want to have them listed together you should read the following.

Using the entry type |@MvBook| (Multivolume) for the main entry you can have several volumes connected to it (children).
For example we have \citetitle{EAOR} with seven volumes. 
The main entry looks like this

\begin{bibexample}[label=EAOR]{{@}MvBook\{EAOR,…\}}
@Mvbook{EAOR,
  title       = {Epigrafia anfiteatrale dell'Occidente Romano},
  date        = {1988/2009},
  editor      = {Patrizia Sabbatini Tumolesi},
  keywords    = {corpus},
  location    = Rome, %@String used
  options     = {corpus},
  publisher   = EQ, %@String used
  related     = {EAOR-01,EAOR-02,EAOR-03,EAOR-04,EAOR-05,EAOR-06,EAOR-07},
  relatedtype = {multivolume},
  series      = {Vetera. Richerche di storia, epigrafia e antichità},
  shorthand   = {EAOR I--VII},
  volumes     = {7},
}
\end{bibexample}

Two children belonging to \cref{EAOR} look like

\begin{bibexample}[label=EAOR-01]{{@}MvBook\{EAOR-01,…\}}
@Book{EAOR-01,
  title     = {Roma},
  year      = {1988},
  editor    = {Tumolesi, Patrizia Sabbatini},
  volume    = {1},
  keywords  = {corpus},
  options   = {corpus,skipbib},
  shorthand = {EAOR I},
  crossref = {EAOR},
}
\end{bibexample}

\begin{bibexample}[label=EAOR-02]{{@}MvBook\{EAOR-02,…\}}
@Book{EAOR-02,
  title     = {Regiones Italiae VI--XI},
  year      = {1989},
  editor    = {Gregori, Gian Luca},
  volume    = {2},
  keywords  = {corpus},
  options   = {corpus,skipbib},
  shorthand = {EAOR II},
  crossref = {EAOR},
}
\end{bibexample}
It is important that you have |skipbib| in the field |options|!

The advantage is that you cite either |EAOR| then you will all of the volumes listed in the bibliography 
or you can only cite individual volumes in your text.
In this case (e.g. citing |EAOR-01| and |EAOR-02|) it looks like this in the bibliography 
\printbib[5em]{EAOR-01,EAOR-02}


\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.

\begin{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}

Here we have an example which will explain the (required)  fields:
\begin{bibexample}[label=Evangelidis2014]{{@}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{bibexample}
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[6.5em]{Evangelidis2014}


\subsection{Type \texttt{@Proceedings}}\label{proceedings}
\DescribeMacro{@Proceedings}
Similar to a collection but still different in the bibliographical output are proceedings.
Therefore we recommend  using 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{bibexample}[label=Kurapkat2014]{{@}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{bibexample}
%\iffalse
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[7.5em]{Kurapkat2014}

\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:

\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}
 
 
 
 \begin{bibexample}[label=Torelli1991]{{@}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{bibexample}
It will be printed as:
 
\printbiball[5em]{Torelli1991}

 \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 a reference. 
We provide an example below---cf. \cref{inreference}

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}

And so a complete entry is quite small:
\begin{bibexample}[label=LIMC]{{@}Reference\{LIMC,…\}}
@Reference{LIMC,
  title     = LIMC,
  keywords  = {corpus},
  options   = {corpus},
  shorthand = LIMC-short,
}
\end{bibexample}
 
But you can also have it  more detailed  like this one:
\begin{bibexample}[label=Lexikon-der-Technik]{{@}Reference\{Lexikon-der-Technik,…\}}
@Reference{Lexikon-der-Technik,
  editor    = {Otto Lueger},
  title     = {Lexikon der gesamten Technik und ihrer Hilfswissenschaften},
  date      = {1904/1920},
  edition   = {2},
  location  = Stuttgart,   %@String used
  keywords  = {corpus},
  shorthand = {Lexikon d. T.},
}
\end{bibexample}

 \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|.

Let’s clarify matters with an example:
\begin{bibexample}[label=Neils1994]{{@}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{bibexample}
You can cite this entry with any of the provided \cs{cite}-commands above---cf. \cref{cite-commands,faq:inreference}.

But for the final display of the entry  you have two possibilities:
 \begin{enumerate}
\item\label{inreference:a} 

If 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 \DAI 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{examplemanual}
\footnote{LIMC 7.1 (1994) 922--951 s. v. Theseus (J. Neils).}
\end{examplemanual}
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.
The |postnote| \oarg{930 Nr. 283} will be printed instead of the |pages|:
\begin{example}
\footnote{\cite[vgl.][930 Nr. 283]{Neils1994}.}
\end{example} 
\end{enumerate}

As mentioned above it is  advantageous to relate entries such as  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.
 
\begin{bibexample}[label=Weinbrenner1914]{{@}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{bibexample}
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.

For the following bibliography result we just typed (assuming that the entries were already cited in text):

\begin{refsection}
\nocite{Lexikon-der-Technik,Weinbrenner1914,LTUR,Neils1994}
\setlength{\labwidthsameline}{5em} 
\begin{example}
\printbibliography[keyword=corpus,title={Corpora}]
\printbibliography[notkeyword=corpus]
\end{example}
\end{refsection}


 
\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.

\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}

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{bibexample}[label=Welch2007]{{@}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{bibexample}
then the review itself:
\begin{bibexample}[label=Bell2011]{{@}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{bibexample}
You maybe noticed that the review (|Bell2011|) is connected to the entry |Welch2007| with the field |related| in line 8.
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[4em]{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 which also reviews the book by \citeauthor*{Welch2007},  but with an individual title:
\begin{bibexample}[label=Hufschmid2010]{{@}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{bibexample}
In the bibliography there will be first the individual title followed by the information of the reviewed work.

\printbib[6em]{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{bibexample}[label=Sear2006]{{@}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{bibexample}

The entry of the review looks like this:
\begin{bibexample}[label=Taylor2008]{{@}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{bibexample}
In the field |related| you can have several \meta{bibtex-keys} which have to be separated by a comma (see line 7).

Subsequently, all information is gathered in the bibliography:
\printbib[5em]{Taylor2008}


 \subsection{Type \texttt{@Thesis}}\label{thesis}
MA and PhD theses, which are not published as a monograph or such, can be cited when they are edited as |@Thesis|.
It is important to differentiate between an entry referring to an 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}.
 
\begin{description}
\item[mandatory:] 
|author|,
|title|, |subtitle|, |titleaddon|,
|type|, |institution|,
|year|,
\item[optional:]
|doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |pubstate|, 
 \end{description}
 

Here is an example:
\begin{bibexample}[label=Arnolds2005]{{@}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},
}
\end{bibexample}

Here is the entry in the bibliography:

\printbib[5.5em]{Arnolds2005}

 
 \changes{v1.1}{2015/06/04}{Umsetzung von |@thesis| im Stil.}

 \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{bibexample}[label=Bergmann2015]{{@}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{bibexample}
The bibliography will show the entry as:

\printbib[7em]{Bergmann2015}
  
\changes{v1.5}{2016/05/31}{Rückverweis}


 \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 your 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) this is done quite easy.

But first we define the heading of the whole  bibliography:

\begin{refsection}
    \nocite{*}
    \renewcommand\bibfont{\normalfont\footnotesize}
    \setlength{\labwidthsameline}{6em} 
\begin{example}
\printbibheading[%
  heading=bibliography,%
  %heading=bibnumbered,% if you want it numbered
  title={Bibliography}] %heading for bibliography
\end{example}
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.

\setlength{\labwidthsameline}{6.5em} 
\begin{example}
\printbibliography[%
  keyword=ancient,%
  heading=subbibliography,
  %heading=subbibnumbered,% if you want it numbered
  title={Ancient authors and works}]
\end{example}
We tell the bibliography just to contain the entries which have |ancient| in the field |keywords| (line 2).


Finally the bibliography for modern scholars.
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.).

\setlength{\labwidthsameline}{7em} 
\begin{example}
\printbibliography[%
  notkeyword=ancient,%
  notkeyword=corpus,%
  heading=subbibliography,
  %heading=subbibnumbered,% if you want it numbered
  title={Secondary literature}]
\end{example}



You can create as many bibliographies as you wish each with another 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):
Now the bibliography only lists the used entries which have |corpus| in the field |keywords|:
\begin{example}
\printbibliography[%
keyword={corpus},
heading=subbibliography,
title={Abbreviation of corpora}]
\label{bib:corpus}
\end{example}

\begin{marker}
 If you want to separate author-year labels from |shorthand| labels in your bibliography,  
 you should ensure 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.
\end{marker}


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{example}
\printbiblist[%
  heading=subbibliography,
  title={Abbreviation of journals}]{shortjournal}
\end{example}

For series it is done like this:
\begin{example}
\printbiblist[%
  heading=subbibliography,
  title={Abbreviation of series}]{shortseries}
\end{example}
\end{refsection}


\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,Vitr:Fischer}.

\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 are different possibilities for 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 platform \href{www.jstor.org}{jstor} then you need the individual number for the article---cf. \cref{Ball2013}:
\begin{code}
eprint = *@\marg{jstor-number}@*
eprinttype = {jstor} 
\end{code}      
OR---cf. \cref{Osland2016}
\begin{code}
jstor = *@\marg{jstor-number}@*
\end{code}  

\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{code}
eprint = *@\marg{urn:xxx}@*
eprinttype = {urn} 
\end{code}      

OR
\begin{code}
urn = *@\marg{urn:xxx}@*
\end{code}  

\DescribeMacro{zenon}
This eprint-form is especially designed for the OPAC (Online Public Access Catalogue) of the \DAI.
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}.

This option is set to |false| by default.
\begin{code}
eprint = *@\marg{Zenon-number}@*
eprinttype = {zenon} 
\end{code}      
OR  cf. \cref{Osland2016,Wulf-Rheidt2013}.
\begin{code}
zenon = *@\marg{Zenon-number}@*
\end{code}      


\DescribeMacro{doi} In addition you can also refer to a document via its |doi|-number---cf. \cref{Ball2013,Evangelidis2014} 
\begin{code}
doi = *@\marg{doi-number}@*
\end{code}  

If you want or don’t want to have the online references printed you can enable or disable the fields with |jstor=false|, 
|urn=false|,
|zenon=true|,
|doi=false| etc. as preamble option.

\subsection{Brackets (with @Inreference)}\label{faq:inreference}
Ensure you 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{tcolorbox}[examplebox]
|(\cite[vgl.][930 Nr. 283]{Neils1994}).| 
\tcblower
(vgl. LIMC 7.1 (1994) 930 Nr. 283 s. v. Theseus (J. Neils)). \textcolor{red}{\textbf{WRONG!!}}
\end{tcolorbox}
 
\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{tcolorbox}[examplebox]
|\parencite[vgl.][930 Nr. 283]{Neils1994}.| 
\tcblower
(vgl. LIMC 7.1 [1994] 930 Nr. 283 s. v. Theseus [J. Neils]). \textcolor{green!50!black}{\textbf{CORRECT!}}
\end{tcolorbox}

\subsection{Unknown work}\label{unknown}
Sometimes it is impossible to ascertain 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{bibexample}[label=Cosa1949]{{@}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{bibexample}
 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,
 It will look like this:
\begin{example}
\footnote{\cite[Vgl.][145--147]{Cosa1949}.}
\end{example}
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 statuses which you are recommended to use since they are translated into the used language:

\DescribeMacro{inpreparation}
Typoscript is prepared for your publication. 
\begin{code}
pubstate = {inpreparation}
\end{code}

\DescribeMacro{submitted}
Typoscript has been submitted.
\begin{code}
pubstate = {submitted}
\end{code}

\DescribeMacro{forthcoming}
Typoscript has been accepted by the journal.
\begin{code}
pubstate = {forthcoming}
\end{code}

\DescribeMacro{inpress}
Typescript has been edited and you have a proof version of it.
\begin{code}
pubstate = {inpress}
\end{code}

\DescribeMacro{prepublished}
Article has been published in an (online) preversion.
\begin{code}
pubstate = {prepublished}
\end{code}


This following example is about an article which was accepted by the journal and so we use |pubstate = {forthcoming}|:
\begin{bibexample}[label=Doe:forthcoming]{{@}Article\{Doe:forthcoming,…\}}
@Article{Doe:forthcoming,
  author       = {Doe, John},
  title        = {My Ideas about Antiquity},
  subtitle     = {And Some Lines for a Subtitle},
  journaltitle = {Journal of Ancient Thoughts},
  shortjournal = {JAT},
  volume       = {12},
  pubstate     = {forthcoming},
}
\end{bibexample}

\printbib[8em]{Doe:forthcoming}


\subsection{Print the used options}
If you want to print the options  of the |bib|\LaTeX -style |archaeologie| you used in your document you can use the command \cs{archaeologieoptions}.
It will list all options used:
\begin{otherlanguage}{ngerman}
\begin{example}
\archaeologieoptions
\end{example}
\end{otherlanguage}
\begin{example}
\archaeologieoptions
\end{example}
If you do not want to have the text in the beginning (which is defined in English and in German) you can get rid of them with the optional argument  \cs{archaeologieoptions}\texttt{[plain]}
\begin{example}
\archaeologieoptions[plain]
\end{example}
\begin{otherlanguage}{ngerman}
\begin{example}
\archaeologieoptions[plain]
\end{example}
\end{otherlanguage}

You can print the version of this style with |\archaeologieversion| 
\begin{example}
\archaeologieversion
\end{example}
or the date of this version with |\archaeologiedate|.
\begin{example}
\archaeologiedate
\end{example}

\subsection{Print the cited authors of secondary literature}
In case you want to have an index about the authors you cited in your text,
you can do that quite easily.
We coded it that way so authors of ancient sources (e.\,g. Cicero) will be omitted in that index (when these entries have |options={ancient}| or |options={frgancient}|).

First you have to activate indexing in the package |biblatex|:
\begin{code}
\usepackage[style=archaeologie,%
          indexing=cite,
          *@\meta{further options}@*]{biblatex}
\end{code}
|cite| will enable indexing in citations only, 
you can also do |bib| which will enable indexing in the bibliography only.
Or |true| so in citations and in the bibliography (|false| is the default setting).

Then you have to load a package for indexing,
we suggest using the package |imakeidx| since you can create multiple indexes with it.
If you have only one index which will be used for the authors of secondary literature you can pass several options to it.
 \begin{code}
\usepackage{imakeidx}
\makeindex[%
  title=Index of  authors,
  columns=3,
]
\end{code}   

Now you only need to place \cs{printindex} whre you want to have the index.
\begin{marker}
If you have the option \texttt{initials} activated your index will have some issues with names that are being shortend automatically.\label{initials:index}
We are working on it, see the issue on \href{https://github.com/LukasCBossert/biblatex-archaeologie/issues/97}{GitHub} and on \href{http://tex.stackexchange.com/q/330971/98739}{\TeX.sx} for more information.\footnote{So far we can only offer a work-around:
Go into your \texttt{.bbl}-file which is in the same folder as your \texttt{.tex}-file.
Replace |family=\{\{|\meta{Ch / Chr / Ph / St / Th}|\}| with |family=\{|\meta{Ch / Chr / Ph / St / Th}.
Then compile your document one more time. You will have the initials in the text, 
and the index looks fine. 
Be aware that after running \texttt{biber} you have to repeat this step.}
\end{marker}


\subsection{Variant ways of entries in year/date-field}
Sometimes you have a range of years of a publication because it is maybe a sequence of volumes.
Let us take as example the \citetitle{LTUR}:
\begin{bibexample}[label=LTUR]{{@}Reference\{LTUR,…\}}
@Reference{LTUR,
  editor    = {Steinby, Eva Margareta},
  title     = LTUR, %@String used
  date      = {1993/2000},
  publisher = EQ, %@String used
  location  = Rome, %@String used
  keywords  = {corpus},
  options   = {corpus},
  shorthand = LTUR-short, %@String used
}
\end{bibexample}
\printbib[4em]{LTUR}

Since this reference-series is completed we define the first and last year by using |date = {1993/2000}|. Be sure \emph{not}  using field |year| but instead |date| since |year| cannot cope with date ranges dependably.

Let us take a look at another example:
\begin{bibexample}[label=DeVisscher1951-1952]{{@}Article\{DeVisscher1951-1952,…\}}
@Article{DeVisscher1951-1952,
  author       = {de Visscher, Fernand and Mertens, Joseph},
  title        = {Les puits du Forum d'Alba Fucense},
  journaltitle = BCom, %@String used
  shortjournal = BCom-short, %@String used
  volume       = {74},
  pages        = {3--13},
  date         = {1951/1952},
}
\end{bibexample}
This time the article appeared in an issue which covers two years (\citedate{DeVisscher1951-1952}) and we want them to appear in the label.
That is why we have to use the field |date| instead of |year|. 
Note that if the date range consists out of only two sequent years, the delimiter will be a slash |/|.
If the range is bigger than two years it will be an em-dash |–|.
\printbib[11em]{DeVisscher1951-1952}
By the way, if you want to cite only the year of publication use |\citedate|\marg{bibtex-key} and not |\citeyear|\marg{bibtex-key} since the field |year| will only give you the first year.


%\begin{multicols}{1}
{\footnotesize
%\lstlistoflistings
\tcblistof[\section]{bibexample}{List of Examples}}
%\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}|.

\begin{multicols}{2}
  \input{archaeologie-ancient.tex}
\end{multicols}
 \changes{v1.5}{2016/05/31}{Antike Bibliographie}


\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,LTUR}


\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[Frankfurt] <-- 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 \parentext{i. Breisgau}\newline Italian: Friburgo in Brisgovia\newline Spanish: Friburgo de Brisgovia\newline French: Fribourg-en-Brisgau
\item[Göttingen] <-- 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[Milano] <-- English\newline German: Mailand\newline Italian: Milano\newline Spanish: Milán\newline French: Milan
\item[Munich] <-- English\newline German: München\newline Italian: Monaco \parentext{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
\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}

\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[PSUP] Pennsylvania State 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 \DAI-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}).

We recommend  looking up the journal names in the list and inserting the |@String| in the fields  |journaltitle| and |shortjournal|, or |series| and |shortseries|.


\subsection{Short form} \label{liste-kurz}
\begin{multicols}{2}
\input{archaeologie-lstabbrv-short.tex}
\end{multicols}


\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{archaeologie-lstabbrv.tex}
%\end{multicols}


 \changes{v1.1}{2015/07/06}{Erstellung der Liste mit Abkürzungen}


%%\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.
%% \DescribeMacro{bbx}
%% \StartLineAt{13}
%%\begin{code}[style=code]
%%\ProvidesFile{archaeologie.bbx}%
%%               [2016/05/31 v2.0  archaeologie -- %
%%                biblatex for archaeologists, 
%%                historians and philologists, bbx-file]
%%\RequireBibliographyStyle{standard}
%%\end{code}
%%
%%It continues with all required settings
%%\ContinueLineNumber
%%\begin{code}[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{code}
%% \StartLineAt{426}
%%\begin{code}[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{code}
%%    

%\subsection{archaeologie.cbx}

 \changes{v0.1}{2015/06/04}{Started Project}
 \changes{v1}{2015/09/15}{First public version}
%\PrintChanges
%\PrintIndex

%\fi
\end{document}