archaeologie (6oct16)

git-svn-id: svn://tug.org/texlive/trunk@42227 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 366 insertions, 313 deletions

diff --git a/Master/texmf-dist/doc/latex/archaeologie/README.md b/Master/texmf-dist/doc/latex/archaeologie/README.md
index ae101f6fb0d..49ac37f31ae 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/README.md
+++ b/Master/texmf-dist/doc/latex/archaeologie/README.md
@@ -5,11 +5,12 @@ bibLaTeX-__archaeologie__
 
 bibLaTeX-style for archaeologists, historians and philologists.
 ---
-_2016/09/25 v2.2_
+_2016/10/06 v2.2b_
 
 Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
 
-Email: [lukas@digitales-altertum.de](mailto:lukas@digitales-altertum.de)
+* Email: [info@biblatex-archaeologie.de](mailto:info@biblatex-archaeologie.de)
+* Website: [www.biblatex-archaeologie.de](www.biblatex-archaeologie.de)
 
 This citation-style covers the citation and bibliography rules of 
 the [__German Archaeological Institute__ (DAI)](http://www.dainst.org/dai/meldungen). 
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
index 062e4eecad5..7e5e2435b13 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
index 1313ea344f0..e572c4956d1 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
@@ -13,19 +13,24 @@
 %!TEX program = xelatex
 \documentclass[a4paper,10pt,ngerman]{ltxdoc}
 \input{archaeologie-preamble.tex}
+\externaldocument{archaeologie}[archaeologie.pdf]% <- full or relative path
 \begin{document}
  \title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} für Archäologen\footnote{Ebenso geeignet für (Alt-)Philologen und (Alt-)Historiker.
- Die Entwicklung des Codes findet statt auf \url{https://github.com/LukasCBossert/biblatex-archaeologie}: 
+Weitere Informationen zum Code und zur Weiterentwicklung siehe \url{biblatex-archaeologie.de}: 
  Anmerkungen und Kritik sind willkommen.
  Dank an   ›moewew‹ und Herbert Voß für ihre Hilfe.
-}\\ --- {\scshape kurzanleitung} --\footnote{Für eine vollständige Anleitung siehe die englische Stilbeschreibung unter \url{http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/archaeologie/archaeologie.pdf}} }
-\author{Lukas C. Bossert\thanks{\url{lukas@digitales-altertum.de}} \and Johannes Friedl}
+}\\ --- {\scshape kurzanleitung} --}
+\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 Der Stil setzt die Zitations- und Bibliographievorgaben des Deutschen Archäologischen Instituts (DAI) (Stand 2014) um. Verschiedene zusätzliche Optionen erlauben jedoch, das Erscheinungsbild den eigenen Vorlieben anzupassen. Der Stil ist nicht nur für Dokumente in deutscher Sprache geeignet, sondern unterstützt ebenso die Sprachen Englisch, Italienisch und Französisch. Dieses Dokument ist die deutsche Kurzfassung der englischen Hauptdokumentation, Details findet man dort.
+\noindent Der Stil setzt die Zitations- und Bibliographievorgaben um, die das \textbf{Deutsche Archäologische Institut (DAI)}  2014 festgelegt hat. 
+Verschiedene zusätzliche Optionen erlauben jedoch, das Erscheinungsbild den eigenen Vorlieben anzupassen. 
+Der Stil ist nicht nur für Dokumente in deutscher Sprache geeignet, sondern unterstützt ebenso die Sprachen Englisch, Italienisch und Französisch. 
 
+Dieses Dokument ist die deutsche Kurzfassung der englischen Hauptdokumentation: Für eine vollständige Anleitung siehe die englische Stilbeschreibung  \href{http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/archaeologie/archaeologie.pdf}{\textbf{online}} oder \href{file:archaeologie.pdf}{\textbf{lokal}}.
  \end{abstract}
 
 %\begin{multicols}{1}
@@ -35,11 +40,11 @@
 \section{Verwendung}
  \DescribeMacro{archaeologie}  Der Name des Stils ist |archaeologie| und wird an entsprechender Stelle geladen.
 
-\begin{lstlisting}
+\begin{code}
 \usepackage[style=archaeologie,%
-					*@\meta{weitere Optionen}@*]{biblatex}
-\bibliography*@\marg{|bib|-Datei}@*
-\end{lstlisting}
+  *@\meta{weitere Optionen}@*]{biblatex}
+  \bibliography*@\marg{|bib|-Datei}@*
+\end{code}
 
 |archaeologie| funktioniert out-of-the-box und lädt hierfür standardmäßig den DAI-Stil im Autor-Jahr-System. 
 Um schnell und einfach im DAI-Stil zu zitieren, bedarf es also keiner weiteren Einstellungen und Optionen. 
@@ -152,28 +157,29 @@ Wichtig für beispielsweise Inschriften- oder Münzcorpora (CIL, AE, RIC, etc.).
 
 \subsection{Zitierbefehle}\label{cite_commands}
 \DescribeMacro{\cite}  Die einfachste Art zu zitieren ist der Befehl \cs{cite}:
-\begin{lstlisting}
+\begin{code}
 \cite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
-\end{lstlisting}
+\end{code}
 
 Dabei ist \meta{prenote} eine einleitende Bemerkung (z.\,B. \enquote{Vgl.}), \meta{postnote} enthält für gewöhnlich die Seitenzahl. 
 Wird nur ein optionales Argument gegeben, so ist das die Seitenzahl:
-\begin{lstlisting}
+\begin{code}
 \cite*@\oarg{postnote}\marg{bibtex-key}%@*
-\end{lstlisting}
+\end{code}
 
 \meta{bibtex-key} ist der Schlüssel des Bibliographieeintrags aus der |bib|-Datei (\emph{entrykey}).
 
 \DescribeMacro{\cites}  Möchte man mehrere Autoren/Werke zugleich zitieren, eignet sich am besten der \cs{cites}-Befehl:
-\begin{lstlisting}
-\cites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
- 																	*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
- 																	*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
-\end{lstlisting}
+\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}
  
 \DescribeMacro{\parencite}  \DescribeMacro{\parencites}  Soll die Literaturangabe (bspw. in den Fußnoten) in Klammern erscheinen, dann empfiehlt sich dies mittels \cs{parencite} zu tun.
 Der Vorteil dieses Befehls gegenüber der händischen Eingabe von Klammern ist, dass der Befehl automatisch Klammerverschachtelungen erkennt und entsprechende Klammerregeln befolgt: demnach werden runde Klammern innerhalb einer Klammerumgebung als eckigen Klammern geschrieben.
-Dies ist vor allem bei Lexikaeinträgen der wichtig: (LIMC 7.1 [1994] 930 Nr. 283 s. v. Theseus [J. Neils]).
+Dies ist vor allem bei Lexikaeinträgen wichtig: (LIMC 7.1 [1994] 930 Nr. 283 s. v. Theseus [J. Neils]).
 \cs{parencite} und \cs{parencites} verhalten sich in der Bedienung analog zu \cs{cite} und \cs{cites}.
  
 \DescribeMacro{\textcite}  \DescribeMacro{\textcites}  Zu den bisher aufgeführten \cs{cite}-Befehlen gibt es zusätzlich die Möglichkeit, einen Eintrag \enquote{fließtextgerecht} mit \cs{textcite} zu zitieren. 
@@ -191,7 +197,6 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Notwendig:] |author|, |title|, |subtitle|,  |titleaddon|, |pages|, |journaltitle|, |shortjournal|, |volume|, |number|, |year|
 \item[Optional:] |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
-
 \printbib[8em]{Ball2013}
 
 
@@ -298,7 +303,7 @@ Ball2013,Taylor2008,Mann2011,Mundt2015,Kurapkat2014,%
 Wulf-Rheidt2013,Bergmann2015,LTUR,Nieddu1995,Arnolds2005}
 
 \setcounter{section}{0}
-    \renewcommand\bibfont{\normalfont\normalsize}
+    \renewcommand\bibfont{\normalfont\footnotesize}
     \setlength{\labwidthsameline}{5.5em} 
 \begin{example}
 \printbibheading[%
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
index e6b495ca31b..7aa5b91755d 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
index a5fe784a4f6..30784ab551c 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
@@ -1,6 +1,6 @@
 % archaeologie --%
 %            biblatex for archaeologists, 
-%				historians and philologists
+%        historians and philologists
 % Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
 %  
 % This work may be distributed and/or modified under the
@@ -12,7 +12,7 @@
 % version 2005/12/01 or later.
 %!TEX program = xelatex
 \documentclass[a4paper,
-11pt,
+10pt,
 greek,
 french,
 spanish,
@@ -20,25 +20,27 @@ italian,
 ngerman,
 english
 ]{ltxdoc}
-\def\thisarchaeologieversion{2.2}
-\def\thisarchaeologiedate{2016-09-25}
 \input{archaeologie-preamble.tex}
+\externaldocument{archaeologie-ger}[archaeologie-ger.pdf]% <- full or relative path
+
 \begin{document}
 \title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} for archaeologists\footnote{Also very handy as well for (ancient) History or Classics.
-The development of the code is done at \url{https://github.com/LukasCBossert/biblatex-archaeologie}: 
+Further information about the code online visit \href{http://www.biblatex-archaeologie.de}{www.biblatex-archaeologie.de}: 
 Comments and criticisms are welcome.
 We thank  ›moewew‹ and Herbert Voß for their big help on the code.%
 }}
-\author{Lukas C. Bossert\thanks{\href{mailto:lukas@digitales-altertum.de}{lukas@digitales-altertum.de}} \and Johannes Friedl}
+\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 German Archaeological Institute. 
+\maketitle
+
+\begin{abstract}
+\noindent This citation-style covers the citation and bibliography rules of the German Archaeological Institute (\textbf{Deutsches Archäologisches Institut}). 
 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.
 
-For a short introduction in German see \url{http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/archaeologie/archaeologie-ger.pdf}
- \end{abstract}
+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}
@@ -51,22 +53,22 @@ and \TeX Live\footnote{Website: \url{http://www.tug.org/texlive}.}~-- thus, you
 can easily install it using the respective package manager. 
 If you would like to
 install |archaeologie| manually, do the following:
-Download the folder |archaeologie| with all relevant files from the CTAN-server\footnote{\url{http://mirrors.ctan.org/macros/latex/contrib/biblatex-contrib/archaeologie.zip}} and copy it to the \texttt{\$LOCALTEXMF} directory of
+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{%
+  \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}
+  \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.
@@ -74,11 +76,11 @@ Here is some additional information from the UK \TeX\ FAQ:
 \section{Usage}
  \DescribeMacro{archaeologie}  The name of the bib\LaTeX-style is  |archaeologie| which has to be activated in the preamble. 
 
-\begin{lstlisting}
+\begin{code}
 \usepackage[style=archaeologie,%
-					*@\meta{further options}@*]{biblatex}
+          *@\meta{further options}@*]{biblatex}
 \bibliography*@\marg{|bib|-file}@*
-\end{lstlisting}
+\end{code}
 
 Without any further options the style follows the rules of the German Archaeological Institute. 
 No additional settings are needed,
@@ -197,75 +199,113 @@ In cases there are different translations of an ancient work you can decide whic
 \changes{v1.1}{2015/06/04}{New options added in summary.}
 
 \subsection{Cite commands}\label{cite-commands}
-\DescribeMacro{\cite}%
+\DescribeMacro{\cite}
 As always citing is done with \cs{cite}:
-\begin{lstlisting}
+\begin{code}
 \cite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
-\end{lstlisting}
+\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{lstlisting}
+\begin{code}
 \cite*@\oarg{postnote}\marg{bibtex-key}%@*
-\end{lstlisting}
+\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{lstlisting}
-\cites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
- 																	*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
- 																	*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
-\end{lstlisting}
+\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}
+
+ \DescribeMacro{\footcite}
+ 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}
+ 
  
 \DescribeMacro{\parencite}
 Sometimes a citation has to be put in parentheses. 
 Therefore we implemented the command \cs{parencite}:
-\begin{lstlisting}
+\begin{code}
 \parencite*@\oarg{postnote}\marg{bibtex-key}%@*
-\end{lstlisting} 
+\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{lstlisting}
+\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{lstlisting}
- 
+\end{code}
+\begin{example}
+Public space is part of a city \parencites(cf.)(){Osland2016}{Evangelidis2014}.
+\end{example}
+
 \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{lstlisting}
+\begin{code}
 \textcite*@\oarg{postnote}\marg{bibtex-key}%@*
-\end{lstlisting} 
+\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{lstlisting}
+\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{lstlisting}
+  *@\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.][]a{Evangelidis2014}.
+\end{example}
 
 \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{lstlisting}
+\begin{code}
 \citeauthor*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
-\end{lstlisting} 
+\end{code} 
   and for the works 
-\begin{lstlisting}
+\begin{code}
 \citetitle*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@*
-\end{lstlisting} 
-For further information cf. \cref{citeauthorformat}.
+\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}.
 
 \subsection{Entries with @String}\label{string}
 The citation rules of the German Archaeological Institute instruct to abbreviate journals and series according to a given list.\footnote{\url{http://www.dainst.org/documents/10180/70593/03_Liste+abzukürzender+Zeitschriften_quer.pdf/2646d351-8e5d-4e8b-8acd-54f3c272d3ff} <2016-06-06>}
@@ -284,21 +324,28 @@ To use this offer of simplification the following bibliography fields should be
 In \cref{abbrv-lists} there is a list with all the abbreviations given by the German Archaeological Institute, 
 in which the |@String| (with endings |-short| for |shortjournal| or |shortseries|) are listed in the left column.  
 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| which enables direct BibTeX typing without enclosing curly brackets.}
+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{lstlisting}[style=bibentry,label=Koyunlu1990,caption={{@}Article\{Koyunlu1990,…\} }]
+
+\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
+  journaltitle = AyasofyaMuezYil,  %@String used
+  shortjournal = AyasofyaMuezYil-short,  %@String used
   volume       = {11},
   pages        = {147--156},
   year         = {1990},
 }
-\end{lstlisting}
+\end{bibexample}
+
 
 That article appeared within a rather unusual journal, 
 which should be abbreviated with ›AyasofyaMüzYıl‹.
@@ -308,6 +355,7 @@ it is written in the |@String| with an ›i‹ (for further information see \cre
 
 \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.
@@ -322,18 +370,18 @@ with all the abbreviations of used journal titles and series (see \cref{bibliogr
 However, if a journal or a series is \emph{not} included in the list (\cref{abbrv-lists}) 
 then this journal/series will \emph{not} be abbreviated and converted to full title in curly brackets in the respective field e.\,g. |journaltitle=|\marg{title of the journal} or |series=|\marg{name of the series}. 
 Therefore the field content will not be printed. 
-At least Bib\TeX{} gives a warning in its log which can be checked.\footnote{For example something like \enquote{\enquote{journaltitle} in entry \meta{entrykey} cannot be null, deleting it}.}
+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{lstlisting}
+\begin{code}
 @Incollection{Mundt2015,
   ...
   location     = Berlin #{ and Boston}, %@String partly used
   ...
 }
-\end{lstlisting}
+\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.  
 
@@ -344,15 +392,15 @@ Changes made by these options are {\color{red}coloured in red}.
 
 \subsection{Preamble options}\label{options-preamble}
 Optional preferences in the preamble are loaded within the package |bib|\LaTeX:
-\begin{lstlisting}
-\usepackage[%				
-		backend=biber,	% activates biber which is done by default anyway 
-										%	(but will give an error if not done here)
-		style=archaeologie, 	% loads the style *@|archaeologie|@*
-		inreferences=true,		% option *@|inreferences|@* is loaded
-		lstabbrv							% option *@|lstabbrv|@* is loaded as well
-		]{biblatex}
-\end{lstlisting}
+\begin{code}
+\usepackage[%        
+    backend=biber,  % activates biber which is done by default anyway 
+                    %  (but will give an error if not done here)
+    style=archaeologie,   % loads the style *@|archaeologie|@*
+    inreferences=true,    % option *@|inreferences|@* is loaded
+    lstabbrv              % option *@|lstabbrv|@* is loaded as well
+    ]{biblatex}
+\end{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|.
@@ -366,7 +414,7 @@ Despite to the overview section (\cref{overview}) the following list is arranged
 \DescribeMacro{bibancient}
 In case of citing ancient authors and their works you can do it with common \cs{cite}-commands.
 Exclusively for this case we included a modification that respects the different citation of ancient authors and works.
-With the option |bibancient| you load an additional bibliography called |bibliography-bibancient.bib| in which we inserted almost 600 ancient authors and works with their abbreviation according to The New Pauly/Thesaurus Linguae Latinae.
+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.
 
@@ -380,12 +428,12 @@ With the loaded option |bibancient| you can cite like this:
 
 
 \begin{example}
-\cite[3,2,5--7]{Apul:met} 
+\footnote{\cite[3,2,5--7]{Apul:met}.}
 \end{example}
 
 
 The corresponding bibliography-entry looks like this
-\begin{lstlisting}[style=bibentry,label=Apul:met,caption={{@}Book\{Apul:met,…\} }]
+\begin{bibexample}[label=Apul:met]{{@}Book\{Apul:met,…\}}
 @Book{Apul:met,
   author      = {Apuleius Madaurensis, Lucius},
   title       = {metamorphoses},
@@ -394,12 +442,12 @@ The corresponding bibliography-entry looks like this
   keywords    = {ancient},
   options     = {ancient},
 }
-\end{lstlisting}
+\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{lstlisting}
+\begin{code}
 \printbibliography[keyword=ancient]
-\end{lstlisting}
+\end{code}
 \printbib{Apul:met}
 
 \begin{refsection}
@@ -407,7 +455,7 @@ By means of the |bibtexkey| (e.g. |Apul:met|) you can also cite only authors or
 
 
 \begin{example}
-\citeauthor{Apul:met} remarks in \citetitle{Apul:met}...
+\citeauthor{Apul:met} remarks in \citetitle{Apul:met} ...
 \end{example}
 
 \end{refsection}
@@ -462,21 +510,18 @@ Bibliography entries with |options={ancient}| are excluded from this speciality
 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, first citation will show:
-
+We give an example:
 \begin{tcolorbox}[examplebox] 
-|\footnote{\cite{Ball2013}.}|
+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
-\footnote{L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current thinking on the Pompeii Forum, 117/3, 2013, 461–492.}
+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}
 
 
-Second citation of
-\begin{tcolorbox}[examplebox] 
-|\footnote{\cite{Ball2013}.}|
-\tcblower
-\footnote{Ball – Dobbins loc. cit. (see n. \oarg{number of the footnote with full citation}) 470.}
-\end{tcolorbox}
 
 \changes{v1.5}{2016/05/31}{Rückverweis}
 
@@ -488,7 +533,7 @@ 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{lstlisting}[style=bibentry,label=Lefebvre2011,caption={{@}Book\{Lefebvre2011,…\}}]
+\begin{bibexample}[label=Lefebvre2011]{{@}Book\{Lefebvre2011,…\}}
 @Book{Lefebvre2011,
   author       = {Lefebvre,Henri},
   title        = {The Production of Space},
@@ -502,7 +547,7 @@ The bibliographical entry |Lefebvre2011| contains following fields:
   origlanguage = {french},
   translator   = {Donald Nicholson-Smith},
 }
-\end{lstlisting}
+\end{bibexample}
 
 The bibliography result is:
 \printbib[6em]{Lefebvre2011}
@@ -516,7 +561,7 @@ By activating option |translation| it will change to:
  
 However, it works not only with entries like |@Book| but also with e.\,g. |@Article|:
 
-\begin{lstlisting}[style=bibentry,label=Lefebvre1977,caption={{@}Article\{Lefebvre1977,…\} }]
+\begin{bibexample}[label=Lefebvre1977]{{@}Article\{Lefebvre1977,…\}}
 @Article{Lefebvre1977,
   author       = {Lefebvre, Henri},
   title        = {Die Produktion des städtischen Raums},
@@ -529,7 +574,7 @@ However, it works not only with entries like |@Book| but also with e.\,g. |@Arti
   number       = {9},
   origtitle    = {Introduction à l'espace urbain},
 }
-\end{lstlisting}
+\end{bibexample}
 
 Once again the bibliography entry alters:
 
@@ -545,28 +590,28 @@ There is the possibility to cite inreferences in the footnote as a full citation
 It is only required that the bibliography-entry is an |@Inreference|  (cf. \cref{inreference}).
  
 Another example makes it clear: 
-\begin{lstlisting}[style=bibentry,label=Nieddu1995,caption={{@}Inreference\{Nieddu1995,…\} }]
+\begin{bibexample}[label=Nieddu1995]{{@}Inreference\{Nieddu1995,…\}}
 @Inreference{Nieddu1995,
   author    = {Nieddu, Giuseppe},
   title     = {Dei Consentes},
   booktitle = LTUR-short,
-  pages     = {9--10},
+  pages     = {9\psq},
   year      = {1995},
   volume    = {2},
 }
-\end{lstlisting}
+\end{bibexample}
 
 There are two ways to display this entry:
  \begin{enumerate}
  \item by default it will give:  
  \begin{example}
- \cite{Nieddu1995}
+\footnote{\cite{Nieddu1995}.}
  \end{example}
  \item with the option |inreferences| it will change:
  \begin{tcolorbox}[examplebox]
- | \cite{Nieddu1995}|
+ |\footnote{\cite{Nieddu1995}.}|
  \tcblower
- LTUR 2 (1995) 9-10 s. v. Dei Consentes (G. Nieddu)
+\footnote{LTUR 2 (1995) 9f. s. v. Dei Consentes (G. Nieddu).}
  \end{tcolorbox}
   \end{enumerate}
 
@@ -575,13 +620,13 @@ then it will change the position for the \oarg{postnote}:
 \begin{enumerate} 
  \item by default it will give: 
  \begin{example}
- \cite[9]{Nieddu1995}
+\footnote{\cite[9]{Nieddu1995}.}
  \end{example}
  \item with the option |inreferences| it will change again:
   \begin{tcolorbox}[examplebox]
- | \cite[9]{Nieddu1995}|
+|\footnote{\cite[9]{Nieddu1995}.}|
  \tcblower
-  LTUR 2 (1995) 9 s. v. Dei Consentes (G. Nieddu)
+\footnote{LTUR 2 (1995) 9 s. v. Dei Consentes (G. Nieddu).}
  \end{tcolorbox}
   \end{enumerate}
 
@@ -602,7 +647,7 @@ The option |yearseries| leads to a different position of the fields |series| and
 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{lstlisting}[style=bibentry,label=Mundt2015,caption={{@}Incollection\{Mundt2015,…\}}]
+\begin{bibexample}[label=Mundt2015]{{@}Incollection\{Mundt2015,…\}}
 @Incollection{Mundt2015,
   author       = {Mundt, Felix},
   title        = {Der Mensch, das Licht und die Stadt},
@@ -618,7 +663,7 @@ An example with an |@Incollection| demonstrates the effect of this option:
   number       = {3},
   shortseries  = Philologus-short #{ Suppl.},
 }
-\end{lstlisting}
+\end{bibexample}
 
 Without any option activated it will look like this:
 \printbib[5em]{Mundt2015}
@@ -644,7 +689,7 @@ If you want in contrast the authors to be shorten to their last names use |citea
 
 The following example illustrates it:
 
-\begin{lstlisting}[style=bibentry,label=Boehmer1985,caption={{@}Article\{Boehmer1985,…\} }]
+\begin{bibexample}[label=Boehmer1985]{{@}Article\{Boehmer1985,…\}}
 @Article{Boehmer1985,
   author       = {Boehmer, Rainer Michael and Wrede, Nadja},
   title        = {Astragalspiele in und um Warka},
@@ -654,7 +699,7 @@ The following example illustrates it:
   pages        = {399--404},
   year         = {1985},
 }
-\end{lstlisting}
+\end{bibexample}
 
 Let's assume you would like to write something like that and
 after compiling it will look like this, 
@@ -708,7 +753,7 @@ Instead of printing the field |author| which contains usually the full ancient n
 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{lstlisting}[style=bibentry,label=Quint:inst,caption={{@}Book\{Quint:inst,…\} }]
+\begin{bibexample}[label=Quint:inst]{{@}Book\{Quint:inst,…\}}
 @Book{Quint:inst,
   author       = {Fabius Quintilianus, Marcus},
   title        = {Ausbildung des Redners},
@@ -724,7 +769,7 @@ Both are demonstrated in the following example: Based on the bibliography entry
   keywords     = {ancient},
   options      = {ancient},
 }
-\end{lstlisting}
+\end{bibexample}
 
 and the following statement we obtain the result:
 
@@ -746,16 +791,16 @@ The ›Klammerregel‹ (correct alternation of different brackets) will be respe
 
 In the case of a common entry which will be shown like this
 \begin{example}
-\cite[475]{Ball2013}
+\footnote{\cite[475]{Ball2013}.}
 \end{example}
 
 
 now we get
 
 \begin{tcolorbox}[examplebox] 
-|\cite[475]{Ball2013}|
+|\footnote{\cite[475]{Ball2013}.}|
 \tcblower
-Ball – Dobbins {\color{red}(}2013{\color{red})}, 475.
+\footnote{Ball – Dobbins {\color{red}(}2013{\color{red})}, 475.}
 \end{tcolorbox}
 
 
@@ -785,7 +830,7 @@ But with |schape| it will turn into:
 
 And since the entry looks like this
 
-\begin{lstlisting}[style=bibentry,label=Ball2013,caption={{@}Article\{Ball2013,…\} }]
+\begin{bibexample}[label=Ball2013]{{@}Article\{Ball2013,…\}}
 @Article{Ball2013,
 author       = {Larry F. Ball and John J. Dobbins},
 title        = {Pompeii Forum Project},
@@ -800,7 +845,7 @@ eprint       = {10.3764/aja.117.3.0461},
 eprinttype   = {jstor},
 number       = {3},
 }
-\end{lstlisting}
+\end{bibexample}
 
 
 the output in the bibliography changes from:
@@ -810,7 +855,7 @@ the output in the bibliography changes from:
 to 
 
 \begin{bibbox}{Ball2013}\footnotesize
-\parbox[t]{2.9cm}{{\scshape \color{red}Ball – Dobbins} 2013}\parbox[t]{8cm}{%
+\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}
@@ -822,7 +867,7 @@ By default first names are abbreviated.
 
 Without any options the entry
 
-\begin{lstlisting}[style=bibentry,label=Osland2016,caption={{@}Article\{Osland2016,…\} }]
+\begin{bibexample}[label=Osland2016]{{@}Article\{Osland2016,…\}}
 @Article{Osland2016,
   author       = {Osland, Daniel},
   title        = {Abuse or Reuse?},
@@ -836,7 +881,7 @@ Without any options the entry
   number       = {1},
   zenon        = {001454110},
 }
-\end{lstlisting}
+\end{bibexample}
 
 looks like
 
@@ -845,7 +890,7 @@ looks like
 and with |bibfullname| it will change to:
 
 \begin{bibbox}{Osland2016}\footnotesize
-\parbox[t]{1.7cm}{Osland 2016} \parbox[t]{9.4cm}{{\color{red}Daniel} Osland, Abuse or Reuse? Public Space in Late Antique Emerita, AJA 120/ 1, 2016, 67–97,\\
+\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}
 
@@ -862,7 +907,7 @@ Once activated all locations and the publisher are printed.
 This will lead to a different output of the edition which will be right in front of the year.
 In case of reprint or second edition the first edition |origyear| will be put in square brackets after the year.
 
-\begin{lstlisting}[style=bibentry,label=Emme2013,caption={{@}Book\{Emme2013,…\} }]
+\begin{bibexample}[label=Emme2013]{{@}Book\{Emme2013,…\}}
 @Book{Emme2013,
   author    = {Burkhard Emme},
   title     = {Peristyl und Polis},
@@ -873,7 +918,7 @@ In case of reprint or second edition the first edition |origyear| will be put in
   series    = {Urban Spaces},
   number    = {1},
 }
-\end{lstlisting}
+\end{bibexample}
 \begin{refsection}\end{refsection}
 
 Default settings produce:
@@ -886,7 +931,7 @@ By activating option |publisher| you obtain:
 \end{bibbox}
  
 And here a more detailed example with |origlocation|, |origyear| and |origpublisher|:
-\begin{lstlisting}[style=bibentry,label=Neufert2002,caption={{@}Book\{Neufert2002,…\} }]
+\begin{bibexample}[label=Neufert2002]{{@}Book\{Neufert2002,…\}}
 @Book{Neufert2002,
   author       = {Neufert, Ernst},
   editor       = {Neufert, Peter and Neufert, Cornelius and Neff, Ludwig and Franken, Corinna},
@@ -900,7 +945,7 @@ And here a more detailed example with |origlocation|, |origyear| and |origpublis
   origlocation = Berlin, %@String used
   origyear     = {1936},
 }
-\end{lstlisting}
+\end{bibexample}
  
 \printbib[5.5em]{Neufert2002}
 
@@ -916,7 +961,7 @@ Instead of embedding ›(ed.)‹/›(Hrsg.)‹ right after the editor name
  it places the adjunct ›ed. by‹/›hrsg. v.‹ behind the editor. 
  Furthermore, in case of |@Incollections| and |@Inproceedings| editor names and book title switch their positions as it is shown below.
 
-\begin{lstlisting}[style=bibentry,label=Wulf-Rheidt2013,caption={{@}Inproceedings\{Wulf-Rheidt2013,…\} }]
+\begin{bibexample}[label=Wulf-Rheidt2013]{{@}Inproceedings\{Wulf-Rheidt2013,…\}}
 @Inproceedings{Wulf-Rheidt2013,
   author       = {Wulf-Rheidt, Ulrike},
   title        = {Der Palast auf dem Palatin -- Zentrum im Zentrum},
@@ -926,17 +971,17 @@ Instead of embedding ›(ed.)‹/›(Hrsg.)‹ right after the editor name
   booktitle    = {Politische Räume in vormodernen Gesellschaften},
   booksubtitle = {Gestaltung – Wahrnehmung – Funktion},
   location     = {Rahden/Westf\adddot},
-  publisher    = VML,		%@String used
+  publisher    = VML,    %@String used
   year         = {2013},
-  venue        = Berlin, 	%@String used
+  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
+  series       = MKT,    %@String used
+  shortseries  = MKT-short,  %@String used
 }
-\end{lstlisting}
+\end{bibexample}
 
 Without option |edby| this |@Inproceedings| would look like:
  
@@ -999,9 +1044,8 @@ that contains the cited reference. But having a different goal that option doesn
  
 \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 modified.}
+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:
@@ -1028,12 +1072,12 @@ 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{lstlisting}[style=bibentry,label=Cic:Att,caption={{@}Book\{Cic:Att,…\} }]
+\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
+  publisher    = AWi,   %@String used
   location     = {Düsseldorf and Zürich},
   year         = {1980},
   series       = {Tusculum Bücherei},
@@ -1047,14 +1091,14 @@ Let us have a look at an example:
   keywords     = {ancient},
   options      = {ancient}, %!!
 }
-\end{lstlisting}
+\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}
-\cite[1, 3,3]{Cic:Att}
+\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:
@@ -1067,7 +1111,7 @@ in this case even united due to fact that editor and translator are identical.
 This works not only with |@Book| but also with those ancient texts which are part of an |@Incollection| employing them similarly to the entries defined as |@Book|.
 
 Another example:
-\begin{lstlisting}[style=bibentry,label=Cic:Sest,caption={{@}Inbook\{Cic:Sest,…\} }]
+\begin{bibexample}[label=Cic:Sest]{{@}Inbook\{Cic:Sest,…\}}
 @Inbook{Cic:Sest,
   author       = {Tullius Cicero, Marcus},
   title        = {Rede für P.\ Sestius},
@@ -1075,11 +1119,11 @@ Another example:
   year         = {1993},
   editor       = {Fuhrmann, Manfred},
   volume       = {II},
-  publisher    = AWi,		%@String used
+  publisher    = AWi,    %@String used
   pages        = {110--185},
   origlanguage = {latin},
   series       = {Sammlung Tusculum},
-  location     = Munich,			%@String used
+  location     = Munich,      %@String used
   intranslator = {Fuhrmann, Manfred},
   keywords     = {ancient},
   options      = {ancient},
@@ -1087,7 +1131,7 @@ Another example:
   shortauthor  = {Cicero},
   shorthand    = {Cic. Sest.},
 }
-\end{lstlisting}
+\end{bibexample}
 
 Even support for several languages is taken into account as this bibliography entries show: 
 \printbiball[4em]{Cic:Sest}
@@ -1098,13 +1142,13 @@ When dealing with fragments of ancient texts often it is important to cite the e
 If you want to cite such a collection of fragments use |options={frgancient}|.
 In this case the editor (|shorteditor| or |editor|) will be put in after the \marg{postnote}. 
 
-\begin{lstlisting}[style=bibentry,label=Fest,caption={{@}Book\{Fest,…\} }]
+\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
+  location    = Leipzig,     %@String used
   year        = {1965},
   series      = {Bibliotheca scriptorum et Grecorum et Romanorum Teubnerina},
   origyear    = {1913},
@@ -1114,11 +1158,11 @@ In this case the editor (|shorteditor| or |editor|) will be put in after the \ma
   options     = {frgancient},
   shorteditor = {L},
 }
-\end{lstlisting}
+\end{bibexample}
 
 When you cite this entry in this example the field  |shorteditor| will be shown.
 \begin{example}
-\cite[3]{Fest}
+\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, 
@@ -1136,7 +1180,7 @@ Let us give you an example with the most famous ancient architect \citeauthor{Vi
 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{lstlisting}[style=bibentry,label=Vitr,caption={{@}Book\{Vitr,…\} }]
+\begin{bibexample}[label=Vitr]{{@}Book\{Vitr,…\}}
 @Book{Vitr,
   author        = {Vitruvius},
   title         = {Zehn Bücher über Architektur},
@@ -1154,15 +1198,15 @@ the bibliographical entry looks like this:
   options       = {ancient},
   sortshorthand = {Vitr.},
 }
-\end{lstlisting}
+\end{bibexample}
 
 When we cite \citeauthor{Vitr} we get the following result:
 \begin{example}
-\cite[1,1,2]{Vitr}.
+\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{lstlisting}[style=bibentry,label=Vitr:Loeb,caption={{@}Book\{Vitr:Loeb,…\} }]
+\begin{bibexample}[label=Vitr:Loeb]{{@}Book\{Vitr:Loeb,…\}}
 @Book{Vitr:Loeb,
   author        = {Vitruvius},
   title         = {On Architecture},
@@ -1181,9 +1225,9 @@ First the english standard translation (\cref{Vitr:Loeb}):
   shortseries   = {Loeb},
   sortshorthand = {Vitr. Loeb},
 }
-\end{lstlisting}
+\end{bibexample}
 Then there is also the French most common translation (\cref{Vitr:Saliou}):
-\begin{lstlisting}[style=bibentry,label=Vitr:Saliou,caption={{@}Book\{Vitr:Saliou,…\} }]
+\begin{bibexample}[label=Vitr:Saliou]{{@}Book\{Vitr:Saliou,…\}}
 @Book{Vitr:Saliou,
   author        = {Vitruvius},
   title         = {De L'Architecture},
@@ -1201,9 +1245,9 @@ Then there is also the French most common translation (\cref{Vitr:Saliou}):
   date          = {1986/2009},
   sortshorthand = {Vitr. Saliou},
 }
-\end{lstlisting}
+\end{bibexample}
 And an old one (\cref{Vitr:Krohn}):
-\begin{lstlisting}[style=bibentry,label=Vitr:Krohn,caption={{@}Book\{Vitr:Krohn,…\} }]
+\begin{bibexample}[label=Vitr:Krohn]{{@}Book\{Vitr:Krohn,…\}}
 @Book{Vitr:Krohn,
   author        = {Vitruvius},
   editor        = {Krohn, Franz},
@@ -1218,10 +1262,10 @@ And an old one (\cref{Vitr:Krohn}):
   date          = {1912},
   sortshorthand = {Vitr. Krohn},
 }
-\end{lstlisting}
+\end{bibexample}
 
 And last there is a translation published in a section of a book (\cref{Vitr:Fischer}):
-\begin{lstlisting}[style=bibentry,label=Vitr:Fischer,caption={{@}Book\{Vitr:Fischer,…\} }]
+\begin{bibexample}[label=Vitr:Fischer]{{@}Book\{Vitr:Fischer,…\}}
 @Inbook{Vitr:Fischer,
   author       = {Vitruvius},
   booktitle    = {Vitruv NEU oder Was ist Architektur?},
@@ -1239,11 +1283,11 @@ And last there is a translation published in a section of a book (\cref{Vitr:Fis
   shorthand    = {Vitr.},
   sortshorhand = {Vitr. Fischer},
 }
-\end{lstlisting}
+\end{bibexample}
 
 If you cite these works you do as usual, you will get:
 \begin{example}
-\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. 
+\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}
 
 
@@ -1262,20 +1306,20 @@ To cite such a corpus with its abbreviation you have to write an additional |opt
 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{lstlisting}[style=bibentry,label=CIL,caption={{@}Book\{CIL,…\} }]
+\begin{bibexample}[label=CIL]{{@}Book\{CIL,…\}}
 @Book{CIL,
   title     = CIL, %@String used
   location  = Berlin, %@String used
   year      = {1863--},
-  shorthand = CIL-short,	%@String used
+  shorthand = CIL-short,  %@String used
   keywords  = {corpus}, %!
   options   = {corpus},
 }
-\end{lstlisting}
+\end{bibexample}
 
 It will be cited with and you see the result right away:
 \begin{example}
-\cite[06, 01234]{CIL}.
+\footnote{\cite[06, 01234]{CIL}.}
 \end{example}
 
 The field |shorthand| will be used for bibliography reference,
@@ -1315,18 +1359,18 @@ You can use the following fields:
  
  
 An entry of a book might look as this in your |bib|-file:
-\begin{lstlisting}[style=bibentry,label=Mann2011,caption={{@}Book\{Mann2011,…\} }]
+\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
+  location  = Berlin,   %@String used
   year      = {2011},
   series    = {Studien zur Alten Geschichte},
   number    = {14},
 }
-\end{lstlisting}
+\end{bibexample}
 
 A citation in a footnote is done like this and will be printed as you see:
 \begin{example}
@@ -1338,7 +1382,7 @@ A citation in a footnote is done like this and will be printed as you see:
 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{lstlisting}[style=bibentry,label=Boehm2001,caption={{@}Book\{Boehm2001,…\} }]
+\begin{bibexample}[label=Boehm2001]{{@}Book\{Boehm2001,…\}}
 @Book{Boehm2001,
   editor     = {Böhm, Stephanie and Eickstedt, Klaus-Valtin von},
   title      = {Ithake},
@@ -1347,7 +1391,7 @@ We suggest using  the field |titleaddon| or if it is a |@Incollection| or |@Inpr
   year       = {2001},
   titleaddon = {Festschrift Jörg Schäfer},
 }
-\end{lstlisting}
+\end{bibexample}
 
 \printbib[9em]{Boehm2001}
  
@@ -1358,12 +1402,12 @@ To obtain this fill the fields |related| and |relatedtype| (for further guidance
 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{lstlisting}[style=bibentry,label=Zanker2009,caption={{@}Book\{Zanker2009,…\} }]
+\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
+  publisher     = CHB,   %@String used
+  location      = Munich,  %@String used
   year          = {2009},
   edition       = {5},
   origlocation  = Leipzig, %@String used
@@ -1373,14 +1417,14 @@ The first edition of \citetitle*{Zanker2009} by \citeauthor*{Zanker2009} has bee
   language      = {german},
   origpublisher = {Koehler \& Amelang},
 }
-\end{lstlisting}
+\end{bibexample}
 
 In \citeyear{Zanker1988}, one year later after the first edition (|origyear|) the book was translated by A. H. Shapiro:
-\begin{lstlisting}[style=bibentry,label=Zanker1988,caption={{@}Book\{Zanker1988,…\} }]
+\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
+  publisher   = UMP,    %@String used
   location    = {Ann Arbor},
   year        = {1988},
   series      = {Jerome Lectures},
@@ -1390,7 +1434,7 @@ In \citeyear{Zanker1988}, one year later after the first edition (|origyear|) th
   related     = {Zanker2009},
   relatedtype = {translationof},
 }
-\end{lstlisting}
+\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}|.
@@ -1406,11 +1450,11 @@ It may be the case that you have to cite a book which consists of several volume
 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{lstlisting}[style=bibentry,label=MacDonald1986,caption={{@}Book\{MacDonald1986,…\} }]
+\begin{bibexample}[label=MacDonald1986]{{@}Book\{MacDonald1986,…\}}
 @Book{MacDonald1986,
   author    = {MacDonald, William L.},
   title     = {An urban Appraisal},
-  publisher = YUP,		%@String used
+  publisher = YUP,    %@String used
   location  = {New Haven and }# London, %@String used
   year      = {1986},
   maintitle = {The Architecture of the Roman Empire},
@@ -1418,11 +1462,11 @@ Let’s assume this is the bibliography entry:
   series    = {Yale Publications in the History of Art},
   number    = {35},
 }
-\end{lstlisting}
+\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[6em]{MacDonald1986}
+\printbib[6.5em]{MacDonald1986}
 
 
 \subsection{Type \texttt{@Inbook / @Incollection}}\label{inbook}
@@ -1446,24 +1490,24 @@ Single entries/chapters of a collection are cited best when they are set up as
  
  
 This following example clarify matters:
- \begin{lstlisting}[style=bibentry,label=Carter2014,caption={{@}Incollection\{Carter2014,…\} }]
+ \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
+  publisher = OUP,    %@String used
   location  = {Oxford},
   year      = {2014},
 }
-\end{lstlisting}
+\end{bibexample}
 
 \printbib[10em]{Carter2014}
 
 You can also have contributions to a ›Festschrift‹ etc. set up as |@Incollection|,
 but then notice the additional information in |booktitleaddon|.
-\begin{lstlisting}[style=bibentry,label=Hoelscher2001,caption={{@}Incollection\{Hoelscher2001,…\} }]
+\begin{bibexample}[label=Hoelscher2001]{{@}Incollection\{Hoelscher2001,…\}}
 @Incollection{Hoelscher2001,
   author         = {Hölscher, Tonio},
   title          = {Schatzhäuser -- Banketthäuser?},
@@ -1475,7 +1519,7 @@ but then notice the additional information in |booktitleaddon|.
   year           = {2001},
   booktitleaddon = {Festschrift Jörg Schäfer},
 }
-\end{lstlisting}
+\end{bibexample}
 In the bibliography it will look like:
 \printbib[5.5em]{Hoelscher2001}
 
@@ -1483,7 +1527,7 @@ In the bibliography it will look like:
 Some books or collections are part of a small series (not an ongoing series).
 This book is part of the series called abbreviated \emph{MemAmAc}.
 Have a look:
-\begin{lstlisting}[style=bibentry,label=Fentress2003,caption={{@}Incollection\{Fentress2003,…\} }]
+\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},
@@ -1491,16 +1535,16 @@ Have a look:
   editor       = {Fentress, Elizabeth},
   booktitle    = {An Intermittent Town},
   booksubtitle = {Excavations 1991--1997},
-  publisher    = UMP,		%@String used
+  publisher    = UMP,    %@String used
   location     = {Ann Arbor, Mich.},
   year         = {2003},
   volume       = {V},
-  series       = MemAmAc,		%@String used
+  series       = MemAmAc,    %@String used
   number       = {2},
   maintitle    = {Cosa},
-  shortseries  = MemAmAc-short,		%@String used
+  shortseries  = MemAmAc-short,    %@String used
 }
-\end{lstlisting}
+\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|) 
@@ -1514,7 +1558,7 @@ Notice the different language-based behaviour of ›et. al.‹ for more than two
 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{lstlisting}[style=bibentry,label=Kohlmeyer1983,caption={{@}Inbook\{Kohlmeyer1983,…\} }]
+\begin{bibexample}[label=Kohlmeyer1983]{{@}Inbook\{Kohlmeyer1983,…\}}
 @Inbook{Kohlmeyer1983,
   author       = {K. Kohlmeyer},
   booktitle    = {Tierbilder aus vier Jahrtausenden},
@@ -1524,10 +1568,10 @@ We provide two examples so you see the difference.
   pages        = {20 Nr. 9},
   location     = Mainz, %@String used
 }
-\end{lstlisting}
+\end{bibexample}
 and the second example
 
-\begin{lstlisting}[style=bibentry,label=Parlasca1969,caption={{@}Inbook\{Parlasca1969,…\} }]
+\begin{bibexample}[label=Parlasca1969]{{@}Inbook\{Parlasca1969,…\}}
 @Inbook{Parlasca1969,
   author    = {K. Parlasca},
   booktitle = {Helbig},
@@ -1537,11 +1581,11 @@ and the second example
   pages     = {98\psq\ Nr. 2176},
   location  = Tuebingen, %@String used
 }
-\end{lstlisting}
+\end{bibexample}
 
 
 \printbib[6em]{Kohlmeyer1983}
-
+and
 \printbiball[6em]{Parlasca1969}
 
 
@@ -1561,19 +1605,19 @@ because you find detailed information about specific topics in articles.
  \end{description}
 
 Here we have an example which will explain the (required)  fields:
-\begin{lstlisting}[style=bibentry,label=Evangelidis2014,caption={{@}Article\{Evangelidis2014,…\} }]
+\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
+  journaltitle = BSA,    %@String used
+  shortjournal = BSA-short,    %@String used
   volume       = {109},
   pages        = {335--356},
   year         = {2014},
   doi          = {10.1017/s006824541400015x},
 }
-\end{lstlisting}
+\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}
 
@@ -1602,7 +1646,7 @@ Everything else is like the type |@Book|.
  \end{description}
  
 An example:
- \begin{lstlisting}[style=bibentry,label=Kurapkat2014,caption={{@}Proceedings\{Kurapkat2014,…\} }]
+ \begin{bibexample}[label=Kurapkat2014]{{@}Proceedings\{Kurapkat2014,…\}}
 @Proceedings{Kurapkat2014,
   title        = {Die Architektur des Weges},
   year         = {2014},
@@ -1610,15 +1654,16 @@ An example:
   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
+  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
+  location     = Regensburg,     %@String used
+  shortseries  = DiskAB-short,    %@String used
 }
-\end{lstlisting}
+\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}),
@@ -1650,17 +1695,17 @@ This entry type works similar to |@Procecedings| and |@Incollection| and therefo
  
  
  
- \begin{lstlisting}[style=bibentry,label=Torelli1991,caption={{@}Inproceedings\{Torelli1991,…\} }]
+ \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
+  location   = Brussels,     %@String used
   publisher  = {Institut Historique Belge de Rome},
   year       = {1991},
-  venue      = Rome #{, Academia Belgica},		%@String used
+  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},
@@ -1669,7 +1714,7 @@ This entry type works similar to |@Procecedings| and |@Incollection| and therefo
   series     = {Études de philologie, d'archéologie et d'histoire anciennes},
   shorttitle = {Il \enquote{diribitorium}},
 }
-\end{lstlisting}
+\end{bibexample}
 It will be printed as:
  
 \printbiball[5em]{Torelli1991}
@@ -1692,44 +1737,44 @@ You don’t need to fill out many fields to have a working entry:
 \end{description}
 
 And so a complete entry is quite small:
-\begin{lstlisting}[style=bibentry,label=LIMC,caption={{@}Reference\{LIMC,…\} }]
+\begin{bibexample}[label=LIMC]{{@}Reference\{LIMC,…\}}
 @Reference{LIMC,
   title     = LIMC,
   keywords  = {corpus},
   options   = {corpus},
   shorthand = LIMC-short,
 }
-\end{lstlisting}
+\end{bibexample}
  
 But you can also have it  more detailed  like this one:
-\begin{lstlisting}[style=bibentry,label=Lexikon-der-Technik,caption={{@}Reference\{Lexikon-der-Technik,…\} }]
+\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
+  location  = Stuttgart,   %@String used
   keywords  = {corpus},
   shorthand = {Lexikon d. T.},
 }
-\end{lstlisting}
+\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{lstlisting}[style=bibentry,label=Neils1994,caption={{@}Inreference\{Neils1994,…\} }]
+\begin{bibexample}[label=Neils1994]{{@}Inreference\{Neils1994,…\}}
 @Inreference{Neils1994,
   author    = {Neils, Jenifer},
   title     = {Theseus},
-  booktitle = LIMC-short,		%@String used
+  booktitle = LIMC-short,    %@String used
   pages     = {922--951},
   year      = {1994},
   volume    = {7.1},
   keywords  = {lexikon},
 }
-\end{lstlisting}
+\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:
@@ -1749,14 +1794,14 @@ and there will be no reference to the bibliography since the entry is fully desc
 \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{tcolorbox}[examplebox] 
-|\cite{Neils1994}.|
+|\footnote{\cite{Neils1994}.}|
 \tcblower
-LIMC 7.1 (1994) 922--951 s. v. Theseus (J. Neils)
+\footnote{LIMC 7.1 (1994) 922--951 s. v. Theseus (J. Neils).}
 \end{tcolorbox}
 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}
-\cite[vgl.][930 Nr. 283]{Neils1994}.
+\footnote{\cite[vgl.][930 Nr. 283]{Neils1994}.}
 \end{example} 
 \end{enumerate}
 
@@ -1764,7 +1809,7 @@ As mentioned above it is  advantageous to relate entries such as  an |@Inreferen
 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{lstlisting}[style=bibentry,label=Weinbrenner1914,caption={{@}Inreference\{Weinbrenner1914,…\} }]
+\begin{bibexample}[label=Weinbrenner1914]{{@}Inreference\{Weinbrenner1914,…\}}
 @Inreference{Weinbrenner1914,
   author    = {Weinbrenner},
   title     = {Rennbahn},
@@ -1775,7 +1820,7 @@ This is shown in the example below.
   volume    = {9},
   number    = {2},
 }
-\end{lstlisting}
+\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.
@@ -1813,31 +1858,31 @@ The following example will show an easy way to combine the review with the revie
 What you need are two separate entries: one as a |@Review| the other is a |@Book|, |@Collection|, |@Proceedings| or something else.
 
 First we have the reviewed work:
-\begin{lstlisting}[style=bibentry,label=Welch2007,caption={{@}Book\{Welch2007,…\} }]
+\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
+  publisher = CUP,    %@String used
   location  = {Cambridge and New York},
   year      = {2007},
 }
-\end{lstlisting}
+\end{bibexample}
 then the review itself:
-\begin{lstlisting}[style=bibentry,label=Bell2011,caption={{@}Review\{Bell2011,…\} }]
+\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
+  journaltitle = AJA,    %@String used
+  shortjournal = AJA-short,    %@String used
   related      = {Welch2007},
   relatedtype  = {reviewof},
   year         = {2011},
   publisher    = {Archaeological Institute of America},
 }
-\end{lstlisting}
+\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}|.
@@ -1854,19 +1899,19 @@ Some reviews are more detailed then others and  have their own title which shoul
 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{lstlisting}[style=bibentry,label=Hufschmid2010,caption={{@}Review\{Hufschmid2010,…\} }]
+\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
+  journaltitle = JRA,    %@String used
+  shortjournal = JRA-short,    %@String used
   related      = {Welch2007},
   relatedtype  = {reviewof},
   year         = {2010},
 }
-\end{lstlisting}
+\end{bibexample}
 In the bibliography there will be first the individual title followed by the information of the reviewed work.
 
 \printbib[6em]{Hufschmid2010}
@@ -1883,20 +1928,20 @@ In his review
 
 The entry of the first analysed book \citetitle{Welch2007} has been described in \cref{review}.
 The entry of the second reviewed book is this:
-\begin{lstlisting}[style=bibentry,label=Sear2006,caption={{@}Book\{Sear2006,…\} }]
+\begin{bibexample}[label=Sear2006]{{@}Book\{Sear2006,…\}}
 @Book{Sear2006,
   author     = {Sear, Frank},
   title      = {Roman Theatres},
   subtitle   = {An Architectural Study},
-  publisher  = OUP,		%@String used
+  publisher  = OUP,    %@String used
   location   = {Oxford},
   year       = {2006},
   series     = {Oxford Monographs on Classical Archaeology},
 }
-\end{lstlisting}
+\end{bibexample}
 
 The entry of the review looks like this:
-\begin{lstlisting}[style=bibentry,label=Taylor2008,caption={{@}Review\{Taylor2008,…\} }]
+\begin{bibexample}[label=Taylor2008]{{@}Review\{Taylor2008,…\}}
 @Review{Taylor2008,
   author       = {Taylor, Rabun},
   number       = {3},
@@ -1907,7 +1952,7 @@ The entry of the review looks like this:
   relatedtype  = {reviewof},
   year         = {2008},
 }
-\end{lstlisting}
+\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:
@@ -1933,7 +1978,7 @@ You also have to define the  |institution=|\marg{university}.
  
 
 Here is an example:
-\begin{lstlisting}[style=bibentry,label=Arnolds2005,caption={{@}Thesis\{Arnolds2005,…\} }]
+\begin{bibexample}[label=Arnolds2005]{{@}Thesis\{Arnolds2005,…\}}
 @Thesis{Arnolds2005,
   author      = {Markus Arnolds},
   title       = {Funktionen republikanischer und frühkaiserzeitlicher Forumsbasiliken in Italien},
@@ -1943,7 +1988,7 @@ Here is an example:
   eprinttype  = {urn},
   date        = {2005},
 }
-\end{lstlisting}
+\end{bibexample}
 
 Here is the entry in the bibliography:
 
@@ -1969,7 +2014,7 @@ For (oral) given papers e.\,g. at a colloquium or a proceeding we created a new
  \end{description}
  
 Here is an example for a  paper  given in Berlin in 2015:
-\begin{lstlisting}[style=bibentry,label=Bergmann2015,caption={{@}Talk\{Bergmann2015,…\} }]
+\begin{bibexample}[label=Bergmann2015]{{@}Talk\{Bergmann2015,…\}}
 @Talk{Bergmann2015,
   author      = {Bergmann, Birgit},
   title       = {\enquote{An exciting find}},
@@ -1982,11 +2027,11 @@ Here is an example for a  paper  given in Berlin in 2015:
   institution = {Freie Universität Berlin},
   venue       = Berlin,
 }
-\end{lstlisting}
+\end{bibexample}
 The bibliography will show the entry as:
 
 \printbib[6em]{Bergmann2015}
-	
+  
  \changes{v1.5}{2016/05/31}{Rückverweis}
 
 
@@ -2096,26 +2141,26 @@ in the internet via a permanent link there are different possibilities for refer
 
 \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{lstlisting}
+\begin{code}
 eprint = *@\marg{jstor-number}@*
 eprinttype = {jstor} 
-\end{lstlisting}			
+\end{code}      
 OR---cf. \cref{Osland2016}
-\begin{lstlisting}
+\begin{code}
 jstor = *@\marg{jstor-number}@*
-\end{lstlisting}	
+\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{lstlisting}
+\begin{code}
 eprint = *@\marg{urn:xxx}@*
 eprinttype = {urn} 
-\end{lstlisting}			
+\end{code}      
 
 OR
-\begin{lstlisting}
+\begin{code}
 urn = *@\marg{urn:xxx}@*
-\end{lstlisting}	
+\end{code}  
 
 \DescribeMacro{zenon}
 This eprint-form is especially designed for the OPAC (Online Public Access Catalogue) of the German Archaeological Institute.
@@ -2123,20 +2168,20 @@ 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{lstlisting}
+\begin{code}
 eprint = *@\marg{Zenon-number}@*
 eprinttype = {zenon} 
-\end{lstlisting}			
+\end{code}      
 OR  cf. \cref{Osland2016,Wulf-Rheidt2013}.
-\begin{lstlisting}
+\begin{code}
 zenon = *@\marg{Zenon-number}@*
-\end{lstlisting}			
+\end{code}      
 
 
 \DescribeMacro{doi} In addition you can also refer to a document via its |doi|-number---cf. \cref{Ball2013,Evangelidis2014} 
-\begin{lstlisting}
+\begin{code}
 doi = *@\marg{doi-number}@*
-\end{lstlisting}	
+\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|,
@@ -2160,7 +2205,7 @@ Especially when you activated the preamble option  |inreferences=true| \Describe
 \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}{\textbf{CORRECT!}}
+(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}
@@ -2168,7 +2213,7 @@ Sometimes it is impossible to ascertain the author or editor but you still want
 If you come along such a paper you can define a |label| which will be used for citing and sorting.
 This is not connected to an entry type -- it can be used with any work.
 In the following example we use an entry type |@Article|:
-\begin{lstlisting}[style=bibentry,label=Cosa1949,caption={{@}Article\{Cosa1949,…\} }]
+\begin{bibexample}[label=Cosa1949]{{@}Article\{Cosa1949,…\}}
 @Article{Cosa1949,
   title        = {Cosa},
   subtitle     = {Republican Colony in Etruria},
@@ -2180,12 +2225,12 @@ In the following example we use an entry type |@Article|:
   label        = {Cosa},
   number       = {1},
 }
-\end{lstlisting}
+\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}
- \cite[vgl.][145--146]{Cosa1949}
+\footnote{\cite[Vgl.][145--147]{Cosa1949}.}
 \end{example}
 and be printed in the bibliography like this:
 \printbib{Cosa1949}
@@ -2198,37 +2243,37 @@ There are some predefined publication statuses which you are recommended to use
 
 \DescribeMacro{inpreparation}
 Typoscript is prepared for your publication. 
-\begin{lstlisting}
+\begin{code}
 pubstate = {inpreparation}
-\end{lstlisting}
+\end{code}
 
 \DescribeMacro{submitted}
 Typoscript has been submitted.
-\begin{lstlisting}
+\begin{code}
 pubstate = {submitted}
-\end{lstlisting}
+\end{code}
 
 \DescribeMacro{forthcoming}
 Typoscript has been accepted by the journal.
-\begin{lstlisting}
+\begin{code}
 pubstate = {forthcoming}
-\end{lstlisting}
+\end{code}
 
 \DescribeMacro{inpress}
 Typescript has been edited and you have a proof version of it.
-\begin{lstlisting}
+\begin{code}
 pubstate = {inpress}
-\end{lstlisting}
+\end{code}
 
 \DescribeMacro{prepublished}
 Article has been published in an (online) preversion.
-\begin{lstlisting}
+\begin{code}
 pubstate = {prepublished}
-\end{lstlisting}
+\end{code}
 
 
 This following example is about an article which was accepted by the journal and so we use |pubstate = {forthcoming}|:
-\begin{lstlisting}[style=bibentry,label=Bossert:forthcoming,caption={{@}Article\{Bossert:forthcoming,…\} }]
+\begin{bibexample}[label=Bossert:forthcoming]{{@}Article\{Bossert:forthcoming,…\}}
 @Article{Bossert:forthcoming,
   author       = {Lukas C. Bossert},
   title        = {\ldots\ \textsc{in formam anitqvam restitvto}?},
@@ -2238,9 +2283,9 @@ This following example is about an article which was accepted by the journal and
   volume       = {2},
   pubstate     = {forthcoming},
 }
-\end{lstlisting}
+\end{bibexample}
 
-\printbib[7.5em]{Bossert:forthcoming}
+\printbib[8em]{Bossert:forthcoming}
 
 
 \subsection{Print the used options}
@@ -2271,11 +2316,11 @@ 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{lstlisting}
+\begin{code}
 \usepackage[style=archaeologie,%
-					indexing=cite,
-					*@\meta{further options}@*]{biblatex}
-\end{lstlisting}
+          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).
@@ -2283,21 +2328,20 @@ Or |true| so in citations and in the bibliography (|false| is the default settin
 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{lstlisting}
+ \begin{code}
 \usepackage{imakeidx}
 \makeindex[%
   title=Index of  authors,
   columns=3,
 ]
-\end{lstlisting}   
+\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 (same folder as your \texttt{.tex}-file,
-search for |family=\{\{|.
-Delete the  |\{..\}| which are embracing the first two or three characters of the family name.
+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.}
@@ -2307,24 +2351,24 @@ Be aware that after running \texttt{biber} you have to repeat this step.}
 \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{lstlisting}[style=bibentry,label=LTUR,caption={{@}Reference\{LTUR,…\} }]
+\begin{bibexample}[label=LTUR]{{@}Reference\{LTUR,…\}}
 @Reference{LTUR,
   editor    = {Steinby, Eva Margareta},
   title     = LTUR, %@String used
   date      = {1993/2000},
-  publisher = {Edizioni Quasar},
+  publisher = EQ, %@String used
   location  = Rome, %@String used
   keywords  = {corpus},
   options   = {corpus},
   shorthand = LTUR-short, %@String used
 }
-\end{lstlisting}
+\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{lstlisting}[style=bibentry,label=DeVisscher1951-1952,caption={{@}Article\{DeVisscher1951-1952,…\} }]
+\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},
@@ -2334,23 +2378,25 @@ Let us take a look at another example:
   pages        = {3--13},
   date         = {1951/1952},
 }
-\end{lstlisting}
+\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|.
 \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}{2}\footnotesize
-\lstlistoflistings
-\end{multicols}
+%\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}{3}
-	\input{archaeologie-ancient.tex}
+  \input{archaeologie-ancient.tex}
 \end{multicols}
  \changes{v1.5}{2016/05/31}{Antike Bibliographie}
 
@@ -2361,7 +2407,7 @@ This activates the other additional bibliography |archaeologie-lstabbrv.bib| aut
 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}
+  \input{archaeologie-corpora.tex}
 \end{multicols}
  \changes{v1.5}{2016/05/31}{Antike Bibliographie}
 
@@ -2487,21 +2533,21 @@ To see the long forms of journal titles or series you have to switch on the opti
 %%|archaeologie| baut auf dem |standard|-Stil von |biblatex| auf, der entsprechend geladen werden muss.
 %% \DescribeMacro{bbx}
 %% \StartLineAt{13}
-%%\begin{lstlisting}[style=code]
+%%\begin{code}[style=code]
 %%\ProvidesFile{archaeologie.bbx}%
 %%               [2016/05/31 v2.0  archaeologie -- %
 %%                biblatex for archaeologists, 
 %%                historians and philologists, bbx-file]
 %%\RequireBibliographyStyle{standard}
-%%\end{lstlisting}
+%%\end{code}
 %%
 %%It continues with all required settings
 %%\ContinueLineNumber
-%%\begin{lstlisting}[style=code]
+%%\begin{code}[style=code]
 %%\AtBeginDocument{%
-%%		\urlstyle{sf}%
-%%		\typeout{* * * archaeologie * * *  
-%%				biblatex for archaeologists, 
+%%    \urlstyle{sf}%
+%%    \typeout{* * * archaeologie * * *  
+%%        biblatex for archaeologists, 
 %%               historians and philologists}
 %%}
 %%\ExecuteBibliographyOptions{%
@@ -2519,19 +2565,19 @@ To see the long forms of journal titles or series you have to switch on the opti
 %%maxitems=1,%
 %%maxbibnames=999,%
 %%}
-%%\end{lstlisting}
+%%\end{code}
 %% \StartLineAt{426}
-%%\begin{lstlisting}[style=code]
+%%\begin{code}[style=code]
 %%\renewbibmacro*{journal}{%
 %%  \ifboolexpr{test {\iffieldundef{shortjournal}} %
-%%  					or bool {bbx:noabbrevs}}%
+%%            or bool {bbx:noabbrevs}}%
 %%    {\printtext[journaltitle]{%
 %%       \printfield[titlecase]{journaltitle}%
 %%       \setunit{\subtitlepunct}%
 %%       \printfield[titlecase]{journalsubtitle}}}%
 %%    {\printfield{shortjournal}}%
 %%    }
-%%\end{lstlisting}
+%%\end{code}
 %%    
 
 %\subsection{archaeologie.cbx}
@@ -2541,4 +2587,5 @@ To see the long forms of journal titles or series you have to switch on the opti
 %\PrintChanges
 %\PrintIndex
 
+%\fi
 \end{document}
\ No newline at end of file