archaeologie (25sep16)

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

5 files changed, 503 insertions, 494 deletions

diff --git a/Master/texmf-dist/doc/latex/archaeologie/README.md b/Master/texmf-dist/doc/latex/archaeologie/README.md
index 8fa3fde536e..ae101f6fb0d 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/README.md
+++ b/Master/texmf-dist/doc/latex/archaeologie/README.md
@@ -5,7 +5,7 @@ bibLaTeX-__archaeologie__
 
 bibLaTeX-style for archaeologists, historians and philologists.
 ---
-_2016/09/20 v2.1_
+_2016/09/25 v2.2_
 
 Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl
 
@@ -31,7 +31,7 @@ documentation:
 
 - archaeologie.pdf
 - archaeologie.tex
-- archaeologie-ger.pdf (*shortdocumentation*)
+- archaeologie-ger.pdf (*short documentation*)
 - archaeologie-ger.tex
 
 mandatory:
@@ -50,6 +50,7 @@ language files:
 
 additional lists and bibliographies:
 
+- archaeologie-examples.bib
 - archaeologie-lstabbrv.bib
 - archaeologie-lstpublishers.bib
 - archaeologie-lstlocations.bib
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.pdf
index c5b6d673f3a..062e4eecad5 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 a0a8848a52a..1313ea344f0 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie-ger.tex
@@ -13,21 +13,6 @@
 %!TEX program = xelatex
 \documentclass[a4paper,10pt,ngerman]{ltxdoc}
 \input{archaeologie-preamble.tex}
-\NewEnviron{bibbsp}[1]
-  {\par\medskip\noindent\footnotesize
-  \begin{tikzpicture}
-    \node[inner sep=0pt] (box) {\parbox[t]{1.05\textwidth}{%
-    \hspace{.05\textwidth}\begin{minipage}{.95\textwidth}
-      \BODY 
-      \end{minipage}
-      }%
-    };
-    \draw[codeblue,line width=2pt] 
-      ( $ (box.north east) + (-5pt,3pt) $ ) -- ( $ (box.north east) + (0,3pt) $ ) -- ( $ (box.south east) + (0,-3pt) $ ) -- + (-5pt,0);
-    \draw[codeblue,line width=2pt] 
-      ( $ (box.north west) + (5pt,3pt) $ ) -- ( $ (box.north west) + (0,3pt) $ ) -- ( $ (box.south west) + (0,-3pt) $ ) -- + (5pt,0);
-  \end{tikzpicture}\par\medskip%
-}
 \begin{document}
  \title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} für Archäologen\footnote{Ebenso geeignet für (Alt-)Philologen und (Alt-)Historiker.
  Die Entwicklung des Codes findet statt auf \url{https://github.com/LukasCBossert/biblatex-archaeologie}: 
@@ -101,6 +86,9 @@ Diese Einträge steuern die Zitationsform und ermöglichen nach Textsorten getre
 
 \DescribeMacro{bibfullname}  Schreibt die Autoren/Herausgeber mit vollem Namen in die Bibliographie. Standard ist sonst die Abkürzung der Vornamen. 
 
+\DescribeMacro{initials}  Kürzt die Vornamen der Autoren oder Herausgeber auf die ersten zwei bzw. drei Buchstaben.
+Berücksichtigt werden Vornamen mit Anfangsbuchstaben |Ch., Chr., Ph., Th., St.|
+
 \DescribeMacro{citeauthorformat}
 Mit dieser Textoption kann man entscheiden, 
 wie Autoren/Herausgeber, die über \cs{citeauthor}\-\marg{bibtex-key} im Fließtext aufgerufen werden,
@@ -152,6 +140,10 @@ Zusätzlich kann ein einzelner Bibliographieeintrag durch folgende Werte in sein
 
 \DescribeMacro{frgancient}  Zeichnet den Eintrag als antikes Fragment aus. Entspricht der Option |ancient|, unterscheidet sich nur darin, dass anstelle des Autors der Herausgeber im Zitat angeführt wird. Die Option kann man dann für antike Texte verwenden, wenn z.\,B. die Autorschaft des Textes/der Fragmente unbekannt ist oder es allgemeiner Usus ist, den Herausgeber anstelle des Autors zu zitieren.
 
+\DescribeMacro{uniqueme} Zeichnet den Eintrag (einer antiken Quellen) dahingehend aus,
+dass dieser über den Zusatz des Übersetzers bzw. der Serie bzw. des Herausgebers eindeutig gesetzt wird.
+Dies empfiehlt sich, wenn  neben einer Standardausgabe einer Quelle weitere Übersetzungen zitiert werden.
+
 \DescribeMacro{corpus}  Auch hier wird das |shorthand|-Feld ohne abschließendes Komma ausgegeben. 
 Wichtig für beispielsweise Inschriften- oder Münzcorpora (CIL, AE, RIC, etc.). 
 
@@ -200,7 +192,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Optional:] |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
 
-\printbib[10em]{Ball2013}
+\printbib[8em]{Ball2013}
 
 
 \DescribeMacro{@book}  \DescribeMacro{@collection}  Für Monographien und Sammelbände.
@@ -209,7 +201,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
 
-\printbib[9em]{Fentress2003}
+\printbib[7em]{Fentress2003}
 
  
 \DescribeMacro{@inbook}  \DescribeMacro{@incollection}  Für Beiträge innerhalb eines Sammelbandes.
@@ -218,7 +210,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
 
-\printbib[7em]{Mundt2015}
+\printbib[5em]{Mundt2015}
 
  
 \DescribeMacro{@proceedings}  Für Konferenz-/Kolloquiumssammelbände, bei denen ein Datum angegeben ist. 
@@ -227,7 +219,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
 
-\printbib[9em]{Kurapkat2014}
+\printbib[7em]{Kurapkat2014}
 
 
 \DescribeMacro{@inproceedings}  Für Beiträge innerhalb eines Konferenz-/Kolloquiumssammelbandes, bei denen ein Datum angegeben ist. 
@@ -236,7 +228,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Optional:] |maintitle|, |mainsubtitle|, |maintitleaddon|, |related|, |relatedtype|, |publisher|, |series|, |number|, |edition|, |origyear|, |origlanguage|, |origlocation|, |translator|, |volume|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
 
-\printbib[9em]{Wulf-Rheidt2013}
+\printbib[7em]{Wulf-Rheidt2013}
 
  
 \DescribeMacro{@talk}  Für (mündliche) Vorträge (Kolloquium, Konferenz) 
@@ -245,7 +237,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Optional:] |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum| 
 \end{description}
 
-\printbib[8em]{Bergmann2015}
+\printbib[6em]{Bergmann2015}
 
 
 \DescribeMacro{@review} Für Rezensionen.
@@ -254,7 +246,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 \item[Optional:] |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
 
-\printbib[7em]{Taylor2008}
+\printbib[5em]{Taylor2008}
 
 
 \DescribeMacro{@reference}  Für Lexika als Gesamtwerk.
@@ -274,7 +266,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 |publisher|, |series|, |number|, |edition|, |origyear|, |doi|, |url|, |urldate|, |eprint|, |eprinttype|, |note|, |addendum|, |pubstate|
 \end{description}
 
-\printbib[7em]{Nieddu1995}
+\printbib[5em]{Nieddu1995}
 
 
 \DescribeMacro{@thesis}  Für (unpublizierte) eingereichte Dissertationen oder Master/Magisterarbeiten.
@@ -285,7 +277,7 @@ Im folgenden werden die zur Verfügung stehenden Publikationstypen (\emph{Entry
 
 Für eine Dissertation:  |type = {phdthesis}|, \\ für eine Magister/Masterarbeit: |type={mathesis}|.
 
-\printbib[7em]{Arnolds2005}
+\printbib[5em]{Arnolds2005}
 
 
 \section{Bibliographie}\label{bibliographie}
@@ -295,27 +287,6 @@ Für Altertumswissenschaftler (und auch andere) ist es manchmal hilfreich, versc
 
 Nachfolgend wird gezeigt, wie einem eine solche Bibliographieaufteilung mit |archaeologie| leicht gelingt. Dafür nutzen wir das |keyword|-Feld eines Bibliographieeintrages. Für jeden Bibliographietyp wählen wir eine Kategorie. Zunächst versehen wir in der |bib|-Datei  alle antiken Texte, die bereits |options={ancient}| oder |options={frgancient}| enthalten sollten, mit dem Feld |keyword={ancient}|. Das gleiche machen wir für alle Publikationen, die spezielle Abkürzungen haben: Corpora, Lexika und Handbücher. Diese erhalten |keyword={corpus}|. Anschließend können wir antike Primärliteratur und abgekürzte Sigel/Corpora von sekundärer Forschungliteratur getrennt bibliographieren. Bib\LaTeX{} bietet hierfür eine einfache Filtermöglichkeit mit den Optionen |keywort=…| und |notkeyword=…| im \cs{printbibliography}-Befehl:
 
-\begin{lstlisting}
-\printbibheading[%
-							heading=bibliography,
-							title={Bibliographie}]% Überschrift für Bibliographie
-
-\printbibliography[%
-							heading=subbibliography,
-							keyword=ancient,%
-							title={Antike Quellen}]
-
-\printbibliography[%
-							heading=subbibliography,
-              keyword=corpus,%
-              title={Abkürzungen und Sigel}]
-
-\printbibliography[%
-							heading=subbibliography,
-							notkeyword=ancient,%
-							notkeyword=corpus,%
-							title={Forschungsliteratur}]
-\end{lstlisting}
 
 Mithilfe des |keyword|-Filters haben wir in den ersten beiden \cs{printbibliography}-Befehlen die entsprechende Literatur ausgewählt, im letzten \cs{printbibliography}-Befehl, der die \enquote{Restliteratur} auslesen soll, müssen dann alle zuvor verwendeten Filterbegriffe mithilfe eines Ausschlussverfahrens über |notkeyword| eingetragen werden: Die Forschungsliteratur beinhaltet also alle Publikationen, die nicht |ancient| und nicht |corpus| sind.
 
@@ -327,57 +298,55 @@ Ball2013,Taylor2008,Mann2011,Mundt2015,Kurapkat2014,%
 Wulf-Rheidt2013,Bergmann2015,LTUR,Nieddu1995,Arnolds2005}
 
 \setcounter{section}{0}
-\begin{bsp}
-\renewcommand\bibfont{\normalfont\footnotesize}
+    \renewcommand\bibfont{\normalfont\normalsize}
+    \setlength{\labwidthsameline}{5.5em} 
+\begin{example}
 \printbibheading[%
-							heading=bibliography,
-							title={Bibliographie}]% Überschrift für Bibliographie
+  heading=bibliography,
+  title={Bibliographie}]% Überschrift für Bibliographie
+\end{example}
+
 
+\begin{example}
 \printbibliography[%
-							heading=subbibliography,
-							keyword=ancient,%
-							title={Antike Quellen}]
+  heading=subbibliography,
+  keyword=ancient,%
+  title={Antike Quellen}]
+\end{example}
 
+\begin{example}
 \printbibliography[%
-							heading=subbibliography,
-              				keyword=corpus,%
-              				title={Abkürzungen und Sigel}]
+  heading=subbibliography,
+  keyword=corpus,%
+  title={Abkürzungen und Sigel}]
 
 \printbibliography[%
-							heading=subbibliography,
-							notkeyword=ancient,%
-							notkeyword=corpus,%
-							title={Forschungsliteratur}]
-\end{bsp}
+  heading=subbibliography,
+  notkeyword=ancient,%
+  notkeyword=corpus,%
+  title={Forschungsliteratur}]
+\end{example}
+
 
 Mit dem eben beschriebenen Verfahren können mit beliebigen |keyword|-Begriffen beliebige Bibliographien über \cs{printbibliography} erstellt werden, die jeweils unterschiedliche Einträge haben können.
 
 Ebenso hilfreich kann es sein, Abkürzungen von Zeitschriften und Reihen aufzulösen. Bib\LaTeX{} liest hierfür die im Feld |shortjournal| bzw. |shortseries| hinterlegten Abkürzungen aller Bibliographieeinträge aus und löst sie durch die Inhalte der Felder |journaltitle| bzw. |series| auf. Hierzu müssen die Felder jedoch beide befüllt sein: ein |shortjournal|-Eintrag ohne |journaltitle|-Entsprechung wird nicht indiziert und folglich in der Liste fehlen.
 
 Die Abkürzungsliste erhält man für Zeitschriften mit:
-\begin{lstlisting}
+\begin{example}
 \printbiblist[%
-					heading=subbibliography,
-					title={Zeitschriftenabkürzungen}%
-					]{shortjournal}
-\end{lstlisting}
-
-\begin{bsp}
-\printbiblist[	heading=subbibliography,
-title={Zeitschriftenabkürzungen}]{shortjournal}
-\end{bsp}
+  heading=subbibliography,
+  title={Zeitschriftenabkürzungen}%
+]{shortjournal}
+\end{example}
 
 und für Reihen mit:
-\begin{lstlisting}
+\begin{example}
 \printbiblist[%
-					heading=subbibliography,
-					title={Reihenabkürzungen}%
-					]{shortseries}
-\end{lstlisting}
+  heading=subbibliography,
+  title={Reihenabkürzungen}%
+]{shortseries}
+\end{example}
 
-\begin{bsp}
-\printbiblist[	heading=subbibliography,
-title={Reihenabkürzungen}]{shortseries}
-\end{bsp}
 \end{refsection}
 \end{document}
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.pdf
index b98b0814813..e6b495ca31b 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 d7555e552da..a5fe784a4f6 100644
--- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
+++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex
@@ -12,7 +12,7 @@
 % version 2005/12/01 or later.
 %!TEX program = xelatex
 \documentclass[a4paper,
-10pt,
+11pt,
 greek,
 french,
 spanish,
@@ -20,27 +20,9 @@ italian,
 ngerman,
 english
 ]{ltxdoc}
-\def\thisarchaeologieversion{2.1}
-\def\thisarchaeologiedate{2016-09-20}
+\def\thisarchaeologieversion{2.2}
+\def\thisarchaeologiedate{2016-09-25}
 \input{archaeologie-preamble.tex}
-\NewEnviron{bibbsp}[1]
-  {\par\medskip\noindent\footnotesize
-  \begin{tikzpicture}
-    \node[inner sep=0pt] (box) {\parbox[t]{\textwidth}{%
-      \begin{minipage}{.07\textwidth}
-      \hspace{.5em}\scriptsize \textbf{\Cref{#1}}\hfill
-      \end{minipage}%
-      \begin{minipage}{.9\textwidth}
-      \BODY
-      \end{minipage}\hfill}%
-    };
-    \draw[codeblue,line width=2pt] 
-      ( $ (box.north east) + (-5pt,3pt) $ ) -- ( $ (box.north east) + (0,3pt) $ ) -- ( $ (box.south east) + (0,-3pt) $ ) -- + (-5pt,0);
-    \draw[codeblue,line width=2pt] 
-      ( $ (box.north west) + (5pt,3pt) $ ) -- ( $ (box.north west) + (0,3pt) $ ) -- ( $ (box.south west) + (0,-3pt) $ ) -- + (5pt,0);
-  \end{tikzpicture}\par\medskip%
-}
-
 \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}: 
@@ -147,7 +129,7 @@ cf. \cref{citeauthorformat}.
 
 
 \DescribeMacro{initials}
-First names are abbreviated keeping digraphs and trigraphs; cf. \cref{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}.
@@ -209,6 +191,9 @@ The entry is a fragmentary ancient source (e.\,g. Festus); cf. \cref{frgancient}
 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}
@@ -247,9 +232,10 @@ The example shown in \cref{faq:inreference} makes it clear.
 Of course there is also the possibility to cite several authors/works in parentheses.
 This is done with \cs{parencites}:
 \begin{lstlisting}
-\parencites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
- 																			*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
- 																			*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
+\parencites(pre-prenote)(post-postnote)%
+*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
 \end{lstlisting}
  
 \DescribeMacro{\textcite}
@@ -263,9 +249,10 @@ the remaining components such as year and page will immediately follow in parent
 \DescribeMacro{\textcites}
 And again there is also a \cs{textcites} in case of several authors: 
   \begin{lstlisting}
-\textcites(pre-prenote)(post-postnote)*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
- 																			*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
- 																			*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
+\textcites(pre-prenote)(post-postnote)%
+*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*%
+*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@*
 \end{lstlisting}
 
 \DescribeMacro{\citeauthor}\DescribeMacro{\citetitle}\label{citeauthor}%
@@ -319,16 +306,16 @@ 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[8em]{Koyunlu1990}
+\printbib[6em]{Koyunlu1990}
 
 Whether using the provided abbreviation list with |lstabbrv| or filling the |journaltitle| and |shortjournal| fields manually, 
 |archaeologie| uses by default short titles if defined.
 The default embedding of such abbreviations can be switched off, of course.
 In case you use the package option |noabbrv| in the preamble (see \cref{noabbrevs}), then the output changes as follows:
-\begin{bibbsp}{Koyunlu1990}
+\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{bibbsp}
+\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.
 
@@ -388,17 +375,14 @@ Authors and works are separated in the |bibtex-key| by a colon.
 The entry on the right marks the |shorthand| which will be printed in your paper.
 
 Let us make it clear with an example:
-\begin{refsection}
-With the loaded option |bibancient| you write  
 
-\begin{lstlisting}
-\cite[3,2,5--7]{Apul:met} 
-\end{lstlisting}
+With the loaded option |bibancient| you can cite like this:  
 
-and will get in return after compiling: 
 
-\cite[3,2,5--7]{Apul:met}.
-\end{refsection}
+\begin{example}
+\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,…\} }]
@@ -421,16 +405,14 @@ With that you can print all ancient authors in a separated bibliography by typin
 \begin{refsection}
 By means of the |bibtexkey| (e.g. |Apul:met|) you can also cite only authors or titles like this: 
 
-\begin{lstlisting}
-\citeauthor{Apul:met} remarks in \citetitle{Apul:met}...
-\end{lstlisting}
 
-will give
-\begin{bsp}
+\begin{example}
 \citeauthor{Apul:met} remarks in \citetitle{Apul:met}...
-\end{bsp}
+\end{example}
+
 \end{refsection}
 
+
 \changes{v1.5}{2016/05/31}{Extra Bibliographie}
 
 \subsubsection{bibcorpora}\label{bibcorpora}
@@ -440,57 +422,7 @@ These corpora are listed in \cref{list-bibcorpora}.
 Advantage and usage mostly correspond to |bibancient|, 
 so have a look at \cref{bibancient} for details.
 
-\subsubsection{inreferences}\label{inreferences}
-
-\DescribeMacro{inreferences}  
-One peculiarity of citation rules of the German Archaeological Institute 
-is the way manuals and encyclopaedias should be cited when not represented in author-year-style. 
-|archaeologie| allows you to cite these manuals in footnotes or text as full citation in this special manner.
-The single requirement is that the bibliography entry is an |@Inreference|  (cf. \cref{inreference}).
- 
-An example makes it clear: 
-\begin{lstlisting}[style=bibentry,label=Nieddu1995,caption={{@}Inreference\{Nieddu1995,…\} }]
-@Inreference{Nieddu1995,
-  author    = {Nieddu, Giuseppe},
-  title     = {Dei Consentes},
-  booktitle = LTUR-short,
-  pages     = {9--10},
-  year      = {1995},
-  volume    = {2},
-}
-\end{lstlisting}
-
-\begin{refsection}
-There are two ways to display |\cite{Nieddu1995}|:
-
-\begin{bsp}
-\begin{enumerate}
-\item by default it prints author-year:
-\cite{Nieddu1995}
-\item with the option |inreferences| it will change to:
-LTUR 2 (1995) 9-10 s. v. Dei Consentes (G. Nieddu)
-\end{enumerate}
-\end{bsp}
-
-If \oarg{postnote} is defined with columns/page number, e.\,g. |\cite[9]{Nieddu1995}|, 
-the position of \oarg{postnote} changes:
-
-\begin{bsp}
-\begin{enumerate} 
-\item by default it prints in author-year:
-\cite[9]{Nieddu1995}
-\item with the option |inreferences| it appears like:
-LTUR 2 (1995) 9 s. v. Dei Consentes (G. Nieddu)
-\end{enumerate}
-\end{bsp}
-
-To mention an important point, activating |inreferences| causes the cited |@Inreference| entry to be automatically \emph{omitted} in the (final) bibliography,
-because the entry is fully cited before in the footnotes (also stated in the German Archaeological Institute rules).
-
-If the option is not used (|inreferences=false|) the entry will look like this in the bibliography:
-\end{refsection}
 
-\printbib[8em]{Nieddu1995} 
 
 \subsubsection{lstabbrv}\label{abbrv}
 \DescribeMacro{lstabbrv}
@@ -530,27 +462,22 @@ 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 of 
-\begin{lstlisting}
-\footnote{\cite{Ball2013}}
-\end{lstlisting}
+We give an example, first citation will show:
 
-displays
+\begin{tcolorbox}[examplebox] 
+|\footnote{\cite{Ball2013}.}|
+\tcblower
+\footnote{L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current thinking on the Pompeii Forum, 117/3, 2013, 461–492.}
+\end{tcolorbox}
 
-\begin{bsp}
-L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current thinking on the Pompeii Forum, 117/3, 2013, 461–492.
-\end{bsp}
 
 Second citation of
-\begin{lstlisting}
-\footnote{\cite[470]{Ball2013}}
-\end{lstlisting}
-
-ends up in
+\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}
 
-\begin{bsp}
-Ball – Dobbins loc. cit. (see n. [number of the footnote with full citation]) 470.
-\end{bsp}
 \changes{v1.5}{2016/05/31}{Rückverweis}
 
 \subsubsection{translation}\label{translation}
@@ -578,14 +505,14 @@ The bibliographical entry |Lefebvre2011| contains following fields:
 \end{lstlisting}
 
 The bibliography result is:
-\printbib[8em]{Lefebvre2011}
+\printbib[6em]{Lefebvre2011}
 
 By activating option |translation| it will change to:
 
-\begin{bibbsp}{Lefebvre2011}%
+\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{bibbsp}
+\end{bibbox}
  
 However, it works not only with entries like |@Book| but also with e.\,g. |@Article|:
 
@@ -606,11 +533,11 @@ However, it works not only with entries like |@Book| but also with e.\,g. |@Arti
 
 Once again the bibliography entry alters:
 
-\begin{bibbsp}{Lefebvre1977}%
+\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{bibbsp}
+\end{bibbox}
 
 \subsubsection{inreferences}\label{inreferences}
 \DescribeMacro{inreferences}  
@@ -628,33 +555,46 @@ Another example makes it clear:
   volume    = {2},
 }
 \end{lstlisting}
-  \begin{refsection}
-There are two ways to display  |\cite{Nieddu1995}|:
+
+There are two ways to display this entry:
  \begin{enumerate}
- \item by default it will give:  %Nieddu 1995
+ \item by default it will give:  
+ \begin{example}
  \cite{Nieddu1995}
- \item with the option |inreferences| it will change to:
+ \end{example}
+ \item with the option |inreferences| it will change:
+ \begin{tcolorbox}[examplebox]
+ | \cite{Nieddu1995}|
+ \tcblower
  LTUR 2 (1995) 9-10 s. v. Dei Consentes (G. Nieddu)
- % \cite{Nieddu_1995}
+ \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{bsp}
 \begin{enumerate} 
- \item by default it will give:  %Nieddu 1995
+ \item by default it will give: 
+ \begin{example}
  \cite[9]{Nieddu1995}
- \item with the option |inreferences| it will change to:
+ \end{example}
+ \item with the option |inreferences| it will change again:
+  \begin{tcolorbox}[examplebox]
+ | \cite[9]{Nieddu1995}|
+ \tcblower
   LTUR 2 (1995) 9 s. v. Dei Consentes (G. Nieddu)
+ \end{tcolorbox}
   \end{enumerate}
-%\end{bsp}
-With the activated option   (|inreferences|) the cited entries which are defined as a |@Inreference| will be automatically omitted in the (final) bibliography,
-because the entries are fully cited before in the footnotes.
 
-If the option is not used (|=false|) the entry will look like this in the bibliography:
-  \end{refsection}
 
-\printbib[8em]{Nieddu1995} 
+
+\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 German Archaeological Institute 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}
@@ -681,12 +621,12 @@ An example with an |@Incollection| demonstrates the effect of this option:
 \end{lstlisting}
 
 Without any option activated it will look like this:
-\printbib[7em]{Mundt2015}
+\printbib[5em]{Mundt2015}
  
 By activating |yearseries| it will change to:
-\begin{bibbsp}{Mundt2015}
+\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{bibbsp}
+\end{bibbox}
 
 \subsubsection{citeauthorformat}\label{citeauthorformat}
 \DescribeMacro{citeauthorformat}
@@ -716,50 +656,49 @@ The following example illustrates it:
 }
 \end{lstlisting}
 
-Let's assume you would like to write:
+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{lstlisting}
-*@\ldots , this is also shown by @*\citeauthor{Boehmer1985} 
-*@ in their latest article @*\citetitle{Boehmer1985}*@.@* \end{lstlisting}
-
-After compiling it will look like this, 
-because the default is set  |citeauthorformat=initials| 
+\begin{example}
+... , this is also shown by \citeauthor{Boehmer1985} 
+ in their latest article \citetitle{Boehmer1985}.
+ \end{example}
 
-\begin{bsp}
-\ldots , this is also shown by \citeauthor{Boehmer1985} 
-in their latest article \citetitle{Boehmer1985}
-\end{bsp}
 
-Or you can change it using the settings
-\begin{enumerate}
-\item |citeauthorformat=full| \ref{name:full} 
-\item |citeauthorformat=family| \ref{name:family}
-\item  |citeauthorformat=firstfull|  \ref{name:firstfull}
-\end{enumerate}
 
+Or you can change it using the settings in the preamble:
 
-
-\begin{bsp}
 \begin{enumerate}
 \item\label{name:full} 
+\begin{tcolorbox}[examplebox]
+ |citeauthorformat=full| 
+ \tcblower
 \ldots , this is also shown by {\color{red}Rainer Michael Boehmer  und Nadja Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985).
+\end{tcolorbox}
 \item\label{name:family}
+\begin{tcolorbox}[examplebox]
+ |citeauthorformat=family| 
+ \tcblower
 \ldots , this is also shown by {\color{red}Boehmer und  Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985).
+\end{tcolorbox}
 \item\label{name:firstfull}
+\begin{tcolorbox}[examplebox]
+ |citeauthorformat=firstfull| 
+ \tcblower
 \ldots , this is also shown by {\color{red}Rainer Michael Boehmer  und Nadja Wrede} in their latest article \emph{Astragalspiele in und um Warka} (1985).
+\end{tcolorbox}
 \end{enumerate}
-\end{bsp}
-
-If you use |citeauthorformat=firstfull| the first citation will look like \ref{name:firstfull}, but after that that all following citations of |\citeauthor{Boehmer1985}| will change to:
 
-\begin{bsp}
-\ldots , this is also shown by R. M. Boehmer und  N. Wrede in their latest article \emph{Astragalspiele in und um Warka} (1985).
-\end{bsp}
 
+If you use |citeauthorformat=firstfull| 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.
 \end{refsection}
 
-\printbib[11.5em]{Boehmer1985}
+To complete this example,
+here is the appearence of the entry in a bibliography:
+\printbib[9em]{Boehmer1985}
+
 
 Two things are left to mention: 
 \begin{enumerate}
@@ -787,22 +726,16 @@ Both are demonstrated in the following example: Based on the bibliography entry
 }
 \end{lstlisting}
 
-and the following statement
+and the following statement we obtain the result:
 
 \begin{refsection}
-\begin{lstlisting}
-*@\ldots\ and @*\citeauthor{Quint:inst}*@ names in @*\citetitle{Quint:inst} 
-*@ the necessary physical qualities of an orator, too.@*
-\end{lstlisting}
- 
-we obtain the result:
-
-\begin{bsp}
-\ldots\ and \citeauthor{Quint:inst} names in \citetitle{Quint:inst} the  necessary physical qualities of an orator, too.
-\end{bsp}
+\begin{example}
+... and \citeauthor{Quint:inst} names in \citetitle{Quint:inst} the  necessary physical qualities of an orator, too.
+\end{example}
 \end{refsection}
 
-\printbib[7em]{Quint:inst}
+And again the bibliography for |@Book{Quint:inst}|:
+\printbib[5em]{Quint:inst}
 
 \subsubsection{yearinparens}\label{yearinparens}
 \DescribeMacro{yearinparens}%
@@ -811,16 +744,19 @@ As the options name evokes the publication year of the cited entries
 in footnotes as well as in the bibliography. 
 The ›Klammerregel‹ (correct alternation of different brackets) will be respected.
 
-In the case of |\cite[475]{Ball2013}|, instead of
-\begin{bsp} 
-Ball – Dobbins 2013, 475 
-\end{bsp}
+In the case of a common entry which will be shown like this
+\begin{example}
+\cite[475]{Ball2013}
+\end{example}
+
 
 now we get
 
-\begin{bsp}
+\begin{tcolorbox}[examplebox] 
+|\cite[475]{Ball2013}|
+\tcblower
 Ball – Dobbins {\color{red}(}2013{\color{red})}, 475.
-\end{bsp}
+\end{tcolorbox}
 
 
 \subsubsection{scshape}\label{scshape}
@@ -833,15 +769,19 @@ Entries without |author| or |editor| setting but with a defined
 because |label| is not an author name but a self-defined expression with varying purposes.
 Further excluded are ancient authors (|options={ancient}| or |options={frgancient}|).
 
-By default---to quote the just established example |\cite[475]{Ball2013}|---we have again
+By default---to quote the just established example |\@Article{Ball2013}|---we have again by default:
 
-\begin{bsp} \cite[475]{Ball2013} \end{bsp}
+\begin{example}
+\footnote{\cite[475]{Ball2013}.}
+\end{example}
 
 But with |schape| it will turn into:
 
-\begin{bsp}
-{\scshape {\color{red}Ball – Dobbins}} 2013, 475
-\end{bsp}
+\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
 
@@ -865,15 +805,15 @@ number       = {3},
 
 the output in the bibliography changes from:
 
-\printbib[10em]{Ball2013}
+\printbib[8em]{Ball2013}
 
 to 
 
-\begin{bibbsp}{Ball2013}
+\begin{bibbox}{Ball2013}\footnotesize
 \parbox[t]{2.9cm}{{\scshape \color{red}Ball – Dobbins} 2013}\parbox[t]{8cm}{%
 L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492\newline
 ...}
-\end{bibbsp}
+\end{bibbox}
 
 \subsubsection{bibfullname}\label{bibfullname}
 \DescribeMacro{bibfullname}
@@ -900,14 +840,14 @@ Without any options the entry
 
 looks like
 
-\printbib[7em]{Osland2016}
+\printbib[6em]{Osland2016}
 
 and with |bibfullname| it will change to:
 
-\begin{bibbsp}{Osland2016}
+\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,\\
 ...}
-\end{bibbsp}
+\end{bibbox}
 
 \subsubsection{noabbrv}\label{noabbrevs}
 \DescribeMacro{noabbrv}
@@ -937,13 +877,13 @@ In case of reprint or second edition the first edition |origyear| will be put in
 \begin{refsection}\end{refsection}
 
 Default settings produce:
-\printbib[7em]{Emme2013}
+\printbib[5em]{Emme2013}
  
 By activating option |publisher| you obtain:
 
-\begin{bibbsp}{Emme2013}
+\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{bibbsp}
+\end{bibbox}
  
 And here a more detailed example with |origlocation|, |origyear| and |origpublisher|:
 \begin{lstlisting}[style=bibentry,label=Neufert2002,caption={{@}Book\{Neufert2002,…\} }]
@@ -962,12 +902,12 @@ And here a more detailed example with |origlocation|, |origyear| and |origpublis
 }
 \end{lstlisting}
  
-\printbib[7em]{Neufert2002}
+\printbib[5.5em]{Neufert2002}
 
-\begin{bibbsp}{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{bibbsp}
+\end{bibbox}
  
 \subsubsection{edby}\label{edby}
 \DescribeMacro{edby}
@@ -1000,14 +940,14 @@ Instead of embedding ›(ed.)‹/›(Hrsg.)‹ right after the editor name
 
 Without option |edby| this |@Inproceedings| would look like:
  
-\printbib[9em]{Wulf-Rheidt2013}
+\printbib[7em]{Wulf-Rheidt2013}
 
 But activating |edby| it changes to:
 
-\begin{bibbsp}{Wulf-Rheidt2013}
+\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{bibbsp}
+\end{bibbox}
  
  
 \subsubsection{width}\label{width}
@@ -1025,46 +965,62 @@ then there is no indent at all.
 If you like to know how many times you cited an author or work then use this option called |counter|.\footnote{The idea is based on \href{http://tex.stackexchange.com/a/14159/98739}{tex.stackexchange.com/a/14159/98739} and has been modified.} 
 Depending on the language you chose in the preamble of your document the information will be given in German (|ngerman|) or in English (if not |ngerman|).
 
-\begin{bibbsp}{Boehm2001}
+\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{bibbsp}
+\end{bibbox}
 
 If there has been no citation in the text (but maybe a \cs{citeauthor} or \cs{citetitle}):
-\begin{bibbsp}{Boehm2001}
+\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{bibbsp} 
+\end{bibbox} 
 
 For all languages besides German:
-\begin{bibbsp}{Boehm2001}
+\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{bibbsp}
+\end{bibbox}
   
 If there has been only one citation:
-\begin{bibbsp}{Boehm2001}
+\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{bibbsp}
+\end{bibbox}
 
 If there has been more than one citation:
-\begin{bibbsp}{Boehm2001}
+\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{bibbsp}
+\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{counter} 
-First names are abbreviated keeping digraphs and trigraphs instead of simple first letter initials.\footnote{Option was included from \href{http://tex.stackexchange.com/a/295486/98739}{tex.stackexchange.com/a/295486/98739}}
+\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.}
+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.
+
+
+
 
 \subsection{Bibliography entry options}\label{options-bibentry}
 \subsubsection{ancient}\label{ancient}
 \DescribeMacro{ancient}
-This option was found in an excellent |bib|\LaTeX-style called  |geschichtsfrkl| (v.1.1 by Jonathan Zachhuber), 
+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 
@@ -1095,16 +1051,11 @@ Let us have a look at an example:
 
 Instead of applying |author| and |year| as labels the option |ancient| takes the field |shorthand| into account.
 
-So you write in your text
-\begin{lstlisting}
-\cite[1, 3,3]{Cic:Att}\end{lstlisting} 
+So you write in your text and it will be printed as
 
-and it will be printed as
-
-\begin{refsection}
-\begin{bsp}
+\begin{example}
 \cite[1, 3,3]{Cic:Att}
-\end{bsp}\end{refsection}
+\end{example} 
 
 Equally the field |shorthand| is used as a label in the bibliography instead of an author-year label:
 \printbib{Cic:Att}
@@ -1139,7 +1090,7 @@ Another example:
 \end{lstlisting}
 
 Even support for several languages is taken into account as this bibliography entries show: 
-\printbiball{Cic:Sest}
+\printbiball[4em]{Cic:Sest}
 
 \subsubsection{frgancient}\label{frgancient}
 \DescribeMacro{frgancient}
@@ -1165,14 +1116,143 @@ In this case the editor (|shorteditor| or |editor|) will be put in after the \ma
 }
 \end{lstlisting}
 
-When you cite this entry in this example with |\cite[3]{Fest}| the field  |shorteditor| will be shown.
-\begin{bsp}
-Fest. 3 L
-\end{bsp}
+When you cite this entry in this example the field  |shorteditor| will be shown.
+\begin{example}
+\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[5em]{Fest}
+\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{lstlisting}[style=bibentry,label=Vitr,caption={{@}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{lstlisting}
+
+When we cite \citeauthor{Vitr} we get the following result:
+\begin{example}
+\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,…\} }]
+@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{lstlisting}
+Then there is also the French most common translation (\cref{Vitr:Saliou}):
+\begin{lstlisting}[style=bibentry,label=Vitr:Saliou,caption={{@}Book\{Vitr:Saliou,…\} }]
+@Book{Vitr:Saliou,
+  author        = {Vitruvius},
+  title         = {De L'Architecture},
+  publisher     = {Les belles lettres},
+  location      = Paris, %@String used
+  volume        = {I--X},
+  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{lstlisting}
+And an old one (\cref{Vitr:Krohn}):
+\begin{lstlisting}[style=bibentry,label=Vitr:Krohn,caption={{@}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{lstlisting}
+
+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,…\} }]
+@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{lstlisting}
+
+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. 
+\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}
@@ -1193,15 +1273,10 @@ This example shows the behaviour with a corpus that is common for Latin epigraph
 }
 \end{lstlisting}
 
-It will be cited with:
-\begin{lstlisting}
+It will be cited with and you see the result right away:
+\begin{example}
 \cite[06, 01234]{CIL}.
-\end{lstlisting}
-
-And the result is:
-\begin{bsp}
-CIL 06, 01234
-\end{bsp}
+\end{example}
 
 The field |shorthand| will be used for bibliography reference,
 where it is listed as label.
@@ -1253,16 +1328,13 @@ An entry of a book might look as this in your |bib|-file:
 }
 \end{lstlisting}
 
-A citation in a footnote is done with
-\begin{lstlisting}
+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{lstlisting} 
+\end{example} 
+\printbib[5em]{Mann2011}
 
-and it looks like this in footnotes\footnote{Vgl. Mann 2011, 142--144.}
-and like this in the bibliography.
-\printbib[7em]{Mann2011}
-
-\subsubsection{›Festschrift‹, commemorative volume, catalogue, etc.}
+\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}).
@@ -1277,7 +1349,7 @@ We suggest using  the field |titleaddon| or if it is a |@Incollection| or |@Inpr
 }
 \end{lstlisting}
 
-\printbib[11em]{Boehm2001}
+\printbib[9em]{Boehm2001}
  
 \subsubsection{Translated book}
 If you cite a translated book you can link it to the original book and let display the translator as well as the original language. 
@@ -1326,7 +1398,7 @@ and the relation got specified with the field |relatedtype|, in this case it is
 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[7em]{Zanker1988}
+\printbiball[5em]{Zanker1988}
 
 
 \subsubsection{Multiple volumes of a monograph}
@@ -1350,7 +1422,7 @@ Let’s assume this is the bibliography entry:
 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[9em]{MacDonald1986}
+\printbib[6em]{MacDonald1986}
 
 
 \subsection{Type \texttt{@Inbook / @Incollection}}\label{inbook}
@@ -1387,7 +1459,7 @@ This following example clarify matters:
 }
 \end{lstlisting}
 
-\printbib[13em]{Carter2014}
+\printbib[10em]{Carter2014}
 
 You can also have contributions to a ›Festschrift‹ etc. set up as |@Incollection|,
 but then notice the additional information in |booktitleaddon|.
@@ -1405,7 +1477,7 @@ but then notice the additional information in |booktitleaddon|.
 }
 \end{lstlisting}
 In the bibliography it will look like:
-\printbib[8em]{Hoelscher2001}
+\printbib[5.5em]{Hoelscher2001}
 
 \subsubsection{Short series}
 Some books or collections are part of a small series (not an ongoing series).
@@ -1435,7 +1507,7 @@ As we can see it is the fifth volume (|volume|) of the series with the main titl
 of the series  \emph{MemAmAc} (|series|).
 
 Notice the different language-based behaviour of ›et. al.‹ for more than two authors/editors.
-\printbiball[9em]{Fentress2003}
+\printbiball[7.5em]{Fentress2003}
 
  
 \subsubsection{Inventory catalogue}
@@ -1468,9 +1540,9 @@ and the second example
 \end{lstlisting}
 
 
-\printbib[8em]{Kohlmeyer1983}
-\begin{refsection}\end{refsection}
-\printbiball[8em]{Parlasca1969}
+\printbib[6em]{Kohlmeyer1983}
+
+\printbiball[6em]{Parlasca1969}
 
 
 \subsection{Type \texttt{@Article}}\label{article}
@@ -1503,7 +1575,7 @@ Here we have an example which will explain the (required)  fields:
 }
 \end{lstlisting}
 In line 5 and 6 you can also write the full or abbreviated journal title in the fields |journaltitle| or |shorttitle| (e.\,g. |journaltitle = {British School of Athens}|, |shortjournal = {BSA}|), but we chose to use a |@String| (cf. \cref{list-bibancient,string}) again.
-\printbib[9em]{Evangelidis2014}
+\printbib[6.5em]{Evangelidis2014}
 
 
 \subsection{Type \texttt{@Proceedings}}\label{proceedings}
@@ -1555,7 +1627,7 @@ to the |publisher| e.\,g. \emph{Regensburg}),
 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[9em]{Kurapkat2014}
+\printbiball[7.5em]{Kurapkat2014}
 
 \subsection{Type \texttt{@Inproceedings}}\label{inproceedings}
 \DescribeMacro{@Inproceedings}
@@ -1600,7 +1672,7 @@ This entry type works similar to |@Procecedings| and |@Incollection| and therefo
 \end{lstlisting}
 It will be printed as:
  
-\printbiball[6em]{Torelli1991}
+\printbiball[5em]{Torelli1991}
 
  \subsection{Type \texttt{@Reference}}\label{reference}
  \DescribeMacro{@Reference}
@@ -1676,18 +1748,16 @@ Then the output will be like:\\
 and there will be no reference to the bibliography since the entry is fully described in the footnote.
 \DescribeMacro{inreferences} If you prefer this method you have to use the preamble option called  |inreferences|---cf. \cref{inreferences}
 Then it will look like this in the footnote:
-\begin{bsp}
+\begin{tcolorbox}[examplebox] 
+|\cite{Neils1994}.|
+\tcblower
 LIMC 7.1 (1994) 922--951 s. v. Theseus (J. Neils)
-\end{bsp}
+\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.
-\begin{lstlisting}
-\cite[vgl.][930 Nr. 283]{Neils1994}.
-\end{lstlisting}
 The |postnote| \oarg{930 Nr. 283} will be printed instead of the |pages|:
- \begin{bsp}
-vgl. LIMC 7.1 (1994) 930 Nr. 283 s. v. Theseus (J. Neils).
- \end{bsp}
- 
+\begin{example}
+\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|. 
@@ -1711,18 +1781,14 @@ You just need to make sure that  |booktitle| of the |@Inreference| and the |shor
 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{lstlisting}
-\printbibliography[keyword=corpus,title={Corpora}]
-\printbibliography[notkeyword=corpus]
-\end{lstlisting}
-
-\begin{refsection}\setlength{\labwidthsameline}{7em} 
 
-\begin{bibbsp}{Lexikon-der-Technik,Weinbrenner1914}
-\nocite{Lexikon-der-Technik,Weinbrenner1914}
+\begin{refsection}
+\nocite{Lexikon-der-Technik,Weinbrenner1914,LTUR,Neils1994}
+\setlength{\labwidthsameline}{5em} 
+\begin{example}
 \printbibliography[keyword=corpus,title={Corpora}]
 \printbibliography[notkeyword=corpus]
-\end{bibbsp}
+\end{example}
 \end{refsection}
 
 
@@ -1780,7 +1846,7 @@ You don’t have to type in all relevant information of the reviewed work in the
 since they will be inserted automatically and dynamically with the  |related|-function. 
 So whenever settings in the reviewed work are changed the print of the review will be automatically adjusted. 
 Furthermore, even if the review is cited, the reviewed work won't be listed in the bibliography until it is explicitly cited in the text.
-\printbib{Bell2011}
+\printbib[4em]{Bell2011}
 
 
 \subsubsection{Reviews with an individual title}
@@ -1803,7 +1869,7 @@ The following entry is an example which also reviews the book by \citeauthor*{We
 \end{lstlisting}
 In the bibliography there will be first the individual title followed by the information of the reviewed work.
 
-\printbib[9em]{Hufschmid2010}
+\printbib[6em]{Hufschmid2010}
 
 
 \subsubsection{multiple reviewed works in one review}
@@ -1845,7 +1911,7 @@ The entry of the review looks like this:
 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[7em]{Taylor2008}
+\printbib[5em]{Taylor2008}
 
 
  \subsection{Type \texttt{@Thesis}}\label{thesis}
@@ -1881,7 +1947,7 @@ Here is an example:
 
 Here is the entry in the bibliography:
 
-\printbib[7.5em]{Arnolds2005}
+\printbib[5.5em]{Arnolds2005}
 
  
  \changes{v1.1}{2015/06/04}{Umsetzung von |@thesis| im Stil.}
@@ -1919,12 +1985,11 @@ Here is an example for a  paper  given in Berlin in 2015:
 \end{lstlisting}
 The bibliography will show the entry as:
 
-		\printbib[8.5em]{Bergmann2015}
+\printbib[6em]{Bergmann2015}
 	
  \changes{v1.5}{2016/05/31}{Rückverweis}
 
 
-\newpage
  \section{Bibliography}\label{bibliographie}
  \DescribeMacro{\printbibliography}
 As long as you don’t use the option\DescribeMacro{seenote} |seenote|---for 
@@ -1939,114 +2004,89 @@ Let’s assume you want to have a bibliography with the ancient authors and one
 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{lstlisting}
+
+\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{lstlisting}
+  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.
 
-\begin{lstlisting}
+\setlength{\labwidthsameline}{6.5em} 
+\begin{example}
 \printbibliography[%
-							keyword=ancient,%
-							heading=subbibliography,
-							%heading=subbibnumbered,% if you want it numbered
-							title={Ancient authors and works}]
-\end{lstlisting}
+  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:
-\begin{lstlisting}
-\printbibliography[%
-							notkeyword=ancient,%
-							notkeyword=corpus,%
-							heading=subbibliography,
-							%heading=subbibnumbered,% if you want it numbered
-							title={Secondary literature}]
-\end{lstlisting}
+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.).
 
-
-\begin{refsection}
-\nocite{*}
-Now have a look how it looks like with all the entries we explained above.
-\begin{bsp}
-\renewcommand\bibfont{\normalfont\footnotesize}
-\printbibheading[%
-							heading=bibliography,%
-							title={Bibliography}] %heading for bibliography
-
+\setlength{\labwidthsameline}{7em} 
+\begin{example}
 \printbibliography[%
-							keyword=ancient,%
-							heading=subbibliography,
-							title={Ancient authors and works}]
+  notkeyword=ancient,%
+  notkeyword=corpus,%
+  heading=subbibliography,
+  %heading=subbibnumbered,% if you want it numbered
+  title={Secondary literature}]
+\end{example}
+
 
-\printbibliography[%
-							notkeyword=ancient,%
-							notkeyword=corpus,%
-							heading=subbibliography,
-							title={Secondary literature}]
-\end{bsp}
 
 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):
-\begin{lstlisting}
-\printbibliography[%
-						keyword=corpus,%
-						heading=subbibliography,
-					 	title={Abbreviation and corpora}]
-\end{lstlisting}
 Now the bibliography only lists the used entries which have |corpus| in the field |keywords|:
-\begin{bsp}
+\begin{example}
 \printbibliography[%
-						keyword={corpus},
-          				heading=subbibliography,
-            			title={Abbreviation of corpora}]\label{bib:corpus}
-\end{bsp}
-
-Note: If you want to separate author-year labels from |shorthand| labels in your bibliography 
+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{lstlisting}
+\begin{example}
 \printbiblist[%
-					heading=subbibliography,
-					title={Abbreviation of journals}]{shortjournal}
-\end{lstlisting}
-
-\begin{bsp}
-\printbiblist[%
-					heading=subbibliography,
-					title={Abbreviation of journals}]{shortjournal}
-\end{bsp}
+  heading=subbibliography,
+  title={Abbreviation of journals}]{shortjournal}
+\end{example}
 
 For series it is done like this:
-\begin{lstlisting}
+\begin{example}
 \printbiblist[%
-					heading=subbibliography,
-					title={Abbreviation of series}]{shortseries}
-\end{lstlisting}
-
-
-\begin{bsp}
-\printbiblist[heading=subbibliography,title={Abbreviation of series}]{shortseries}\end{bsp}
-
+  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}.
+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 
@@ -2108,23 +2148,20 @@ 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{lstlisting}
-\cite[vgl.][930 Nr. 283]{Neils1994}.
-\end{lstlisting}
- \begin{bsp}
-(vgl. LIMC 7.1 (1994) 930 Nr. 283 s. v. Theseus (J. Neils)). \textcolor{red}{WRONG!}
-\end{bsp}
+\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{lstlisting}
-\parencite[vgl.][930 Nr. 283]{Neils1994}.
-\end{lstlisting}
-
-\begin{bsp} 
-(vgl. LIMC 7.1 [1994] 930 Nr. 283 s. v. Theseus [J. Neils]). \textcolor{green}{CORRECT!}
-\end{bsp}
+\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!}}
+\end{tcolorbox}
 
 \subsection{Unknown work}\label{unknown}
 Sometimes it is impossible to ascertain the author or editor but you still want to cite them.
@@ -2145,14 +2182,11 @@ In the following example we use an entry type |@Article|:
 }
 \end{lstlisting}
  The |label| (line 9) can be defined as one wishes; in this case we chose it analogous to the title: |label = {Cosa}|.
-When you cite such an anonymous work it will be done like all the others:
-\begin{lstlisting}
- \cite[vgl.][145--146]{Cosa1949}
-\end{lstlisting}
+When you cite such an anonymous work it will be done like all the others,
  It will look like this:
- \begin{bsp} 
- vgl. Cosa 1949, 145--146
- \end{bsp}
+\begin{example}
+ \cite[vgl.][145--146]{Cosa1949}
+\end{example}
 and be printed in the bibliography like this:
 \printbib{Cosa1949}
 
@@ -2161,36 +2195,38 @@ Sometimes you know the author of an article or a book, proceedings etc. and you
 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:
-\begin{description}
-\item[inpreparation] Typoscript is prepared for your publication. 
+
+\DescribeMacro{inpreparation}
+Typoscript is prepared for your publication. 
 \begin{lstlisting}
 pubstate = {inpreparation}
 \end{lstlisting}
-\item[submitted] Typoscript has been submitted.
 
+\DescribeMacro{submitted}
+Typoscript has been submitted.
 \begin{lstlisting}
 pubstate = {submitted}
 \end{lstlisting}
 
-\item[forthcoming] Typoscript has been accepted by the journal.
-
+\DescribeMacro{forthcoming}
+Typoscript has been accepted by the journal.
 \begin{lstlisting}
 pubstate = {forthcoming}
 \end{lstlisting}
 
-\item[inpress] Typescript has been edited and you have a proof version of it.
-
+\DescribeMacro{inpress}
+Typescript has been edited and you have a proof version of it.
 \begin{lstlisting}
 pubstate = {inpress}
 \end{lstlisting}
 
-\item[prepublished] Article has been published in an (online) preversion.
-
+\DescribeMacro{prepublished}
+Article has been published in an (online) preversion.
 \begin{lstlisting}
 pubstate = {prepublished}
 \end{lstlisting}
 
-\end{description}
+
 This following example is about an article which was accepted by the journal and so we use |pubstate = {forthcoming}|:
 \begin{lstlisting}[style=bibentry,label=Bossert:forthcoming,caption={{@}Article\{Bossert:forthcoming,…\} }]
 @Article{Bossert:forthcoming,
@@ -2204,33 +2240,30 @@ This following example is about an article which was accepted by the journal and
 }
 \end{lstlisting}
 
-\printbib[11em]{Bossert:forthcoming}
+\printbib[7.5em]{Bossert: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{bsp}
+\begin{otherlanguage}{ngerman}
+\begin{example}
 \archaeologieoptions
-\end{bsp}
-\foreignlanguage{ngerman}{%
-\begin{bsp}
-\archaeologieoptions
-\end{bsp}
-}
+\end{example}
+\end{otherlanguage}
 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{bsp}
+\begin{example}
 \archaeologieoptions[plain]
-\end{bsp}
+\end{example}
 
-You can also print the version of this style with |\archaeologieversion| 
-\begin{bsp}
+You can print the version of this style with |\archaeologieversion| 
+\begin{example}
 \archaeologieversion
-\end{bsp}
+\end{example}
 or the date of this version with |\archaeologiedate|.
-\begin{bsp}
+\begin{example}
 \archaeologiedate
-\end{bsp}
+\end{example}
 
 \subsection{Print the citet authors of secondary literature}
 In case you want to have an index about the authors you cited in your text,
@@ -2248,7 +2281,7 @@ 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 |imakeidx| since you can create multiple indexes with it.
+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}
 \usepackage{imakeidx}
@@ -2258,25 +2291,32 @@ If you have only one index which will be used for the authors of secondary liter
 ]
 \end{lstlisting}   
 
-Now you only need to place |\printindex| whre you want to have the index.
+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.
+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}
 
-\alertinfo{If you have the option |initials| activated your index will have some issues with names that are being shortend automatically.
-We are working on it, see \href{https://github.com/LukasCBossert/biblatex-archaeologie/issues/97}{github issue} for more information.}
 
-\clearpage
 \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,…\} }]
 @Reference{LTUR,
   editor    = {Steinby, Eva Margareta},
-  title     = LTUR,
+  title     = LTUR, %@String used
   date      = {1993/2000},
   publisher = {Edizioni Quasar},
-  location  = Rome,
+  location  = Rome, %@String used
   keywords  = {corpus},
   options   = {corpus},
-  shorthand = LTUR-short,
+  shorthand = LTUR-short, %@String used
 }
 \end{lstlisting}
 \printbib[4em]{LTUR}
@@ -2284,12 +2324,12 @@ Let us take as example the \citetitle{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{lstlisting}[style=bibentry,label=DeVisscher1951-1952,caption={{@}Article\{DeVisscher1951-1952,…\} }]
 @Article{DeVisscher1951-1952,
   author       = {de Visscher, Fernand and Mertens, Joseph},
   title        = {Les puits du Forum d'Alba Fucense},
-  journaltitle = BCom,
-  shortjournal = BCom-short,
+  journaltitle = BCom, %@String used
+  shortjournal = BCom-short, %@String used
   volume       = {74},
   pages        = {3--13},
   date         = {1951/1952},
@@ -2297,10 +2337,10 @@ Let us take a look at another example:
 \end{lstlisting}
 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[4em]{DeVisscher1951-1952}
+\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.
 
-\clearpage
+
 \begin{multicols}{2}\footnotesize
 \lstlistoflistings
 \end{multicols}
@@ -2309,7 +2349,7 @@ The bibliography |archaeologie-bibancient.bib| is filled with ancient authors, w
 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}
+\begin{multicols}{3}
 	\input{archaeologie-ancient.tex}
 \end{multicols}
  \changes{v1.5}{2016/05/31}{Antike Bibliographie}
@@ -2332,7 +2372,7 @@ The bold entry on the left is to use for |location=|\meta{location} -- do not pu
 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}
+Lexikon-der-Technik,Bergmann2015,LTUR}
 
 
 \begin{multicols}{3}
@@ -2372,8 +2412,7 @@ Lexikon-der-Technik,Bergmann2015}
 \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}
+\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
@@ -2499,7 +2538,7 @@ To see the long forms of journal titles or series you have to switch on the opti
 
  \changes{v0.1}{2015/06/04}{Started Project}
  \changes{v1}{2015/09/15}{First public version}
-\PrintChanges
-\PrintIndex
+%\PrintChanges
+%\PrintIndex
 
-\end{document}
+\end{document}
\ No newline at end of file