diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex | 171 |
1 files changed, 129 insertions, 42 deletions
diff --git a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex index 30784ab551c..6866aa5e413 100644 --- a/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex +++ b/Master/texmf-dist/doc/latex/archaeologie/archaeologie.tex @@ -1,7 +1,7 @@ % archaeologie --% % biblatex for archaeologists, % historians and philologists -% Copyright (c) 2016 Lukas C. Bossert | Johannes Friedl +% Copyright (c) 2017 Lukas C. Bossert | Johannes Friedl % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 @@ -10,7 +10,7 @@ % http://www.latex-project.org/lppl.txt % and version 1.3 or later is part of all distributions of LaTeX % version 2005/12/01 or later. -%!TEX program = xelatex +% !TEX program = lualatex \documentclass[a4paper, 10pt, greek, @@ -24,8 +24,8 @@ english \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. -Further information about the code online visit \href{http://www.biblatex-archaeologie.de}{www.biblatex-archaeologie.de}: +\title{\texttt{archaeologie} -- \\\texttt{bib\LaTeX} for archaeologists\footnote{Also very handy for (ancient) History or Classics, too. +For further information about the code visit \href{http://www.biblatex-archaeologie.de}{biblatex-archaeologie.de}: Comments and criticisms are welcome. We thank ›moewew‹ and Herbert Voß for their big help on the code.% }} @@ -35,11 +35,12 @@ We thank ›moewew‹ and Herbert Voß for their big help on the code.% \maketitle \begin{abstract} -\noindent This citation-style covers the citation and bibliography rules of the German Archaeological Institute (\textbf{Deutsches Archäologisches Institut}). +\noindent This citation-style covers the citation and bibliography rules of the \DAI (DAI). Various options are available to change and adjust the outcome according to one's own preferences. The style is compatible with the English, German, Italian, Spanish and French languages, since all |bibstrings| used are defined in each language. +\bigskip -For a short introduction in German see \href{pdfdeu.biblatex-archaeologie.de}{\textbf{online}} or \href{file:archaeologie-ger.pdf}{\textbf{local}}. +\noindent For a short introduction in German see \href{pdfdeu.biblatex-archaeologie.de}{\textbf{online}} or \href{file:archaeologie-ger.pdf}{\textbf{local}}. \end{abstract} @@ -82,7 +83,7 @@ Here is some additional information from the UK \TeX\ FAQ: \bibliography*@\marg{|bib|-file}@* \end{code} -Without any further options the style follows the rules of the German Archaeological Institute. +Without any further options the style follows the rules of the \DAI. No additional settings are needed, but you can change the outcome by using some options which are explained below.\footnote{For an easy and unproblematic compiling we suggest to use \hologo{XeLaTeX} or \hologo{LuaTeX}.} @@ -109,7 +110,7 @@ Additionally this activates the bibliography |archaeologie-lstabbrv.bib|. \DescribeMacro{lstabbrv} Activates the additional bibliography file |archaeologie-lstabbrv.bib|. It provides a list of journals and series according to the abbreviations of the -German Archaeological Institute which can be used as |@String| macros in bibliography entries; cf. \cref{abbrv}. +\DAI which can be used as |@String| macros in bibliography entries; cf. \cref{abbrv}. \DescribeMacro{lstlocations} Activates the additional bibliography file |archaeologie-lstlocations.bib| @@ -144,7 +145,7 @@ Switches \enquote{ed.}/\enquote{Hrsg.} to \enquote{ed. by}/\enquote{hrsg. v.}; c \DescribeMacro{inreferences} Each bibliography entry which is an |@Inreference| is fully referenced according to the special rules of the -German Archaeological Institute for manuals and encyclopaedias; cf. \cref{inreferences}. +\DAI for manuals and encyclopaedias; cf. \cref{inreferences}. \DescribeMacro{noabbrv} By default the short titles of journals and series (|shortjournal| and |shortseries|) are shown in the bibliography. @@ -156,7 +157,7 @@ It also changes the format of the edition and the first print; cf. \cref{publish \DescribeMacro{seenote} By default |archaeologie| prints author-year-system. -With this option you can change it to a different outcome (but still according to the rules of the German Archaeological Institute). +With this option you can change it to a different outcome (but still according to the rules of the \DAI). So the first citation will be a full citation and all the following citations will refer to the first full citation; cf. \cref{seenote} \DescribeMacro{translation} @@ -226,21 +227,6 @@ If one wants to cite several authors or works a very convenient way is the follo \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. @@ -289,9 +275,80 @@ And again there is also a \cs{textcites} in case of several authors: *@\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}. +Public space is part of a city say \textcites{Osland2016}[cf.][]{Evangelidis2014}. +\end{example} + + + \DescribeMacro{\footcite} + Beside the listed \cs{cite} commands above there are more possibilities citing: + There is also the possibility to put the citation into a footnote at once with \cs{footcite}: + \begin{code} +\footcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@* +\end{code} +\begin{example} +Public space is part of a city.\footcite{Osland2016} +\end{example} +This is the equivalent to |\footnote{\cite{Osland2016}.}| but it saves you a lot of time typing. + \DescribeMacro{\footcites} And there is as well \cs{footcites}: +\begin{example} +Public space is part of a city.\footcites(cf.)(){Osland2016}{Evangelidis2014} +\end{example} + + +\DescribeMacro{\smartcite} +And there is also a clever way citing with \cs{smartcite}. +\cs{smartcite} depends on its environment it is used in. If it is your normal text it behaves like \cs{footcite} and will print the citation within a footnote. +If it is already within a footnote it will be handled like \cs{cite}. + is a clever +\begin{code} +\smartcite*@\oarg{postnote}\marg{bibtex-key}%@* +\end{code} + +\begin{example} +Public space is part of a city.\smartcite{Osland2016} +And sometimes more than that.\footnote{\smartcite[cf.][]{Evangelidis2014}.} +\end{example} + + +\DescribeMacro{\smartcites} +And again there is also a \cs{textcites} in case of several authors: +\begin{code} +\smartcites(pre-prenote)(post-postnote)% + *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*% + *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@*% + *@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}\ldots@* +\end{code} +\begin{example} +Public space is part of a city.\smartcites{Osland2016}{Evangelidis2014} +And sometimes more than that.\footnote{\smartcites{Osland2016}[cf.][]{Evangelidis2014}.} +\end{example} + +\DescribeMacro{\autocite} +With \cs{autocite} there is a flexible way of citing. +We set up \cs{autocite} as \cs{footcite} by default. +If you want to change it you can also write in the preamble e.\,g. |autocite=inline|. +\begin{code} +\autocite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}%@* +\end{code} + +\begin{example} +Public space is part of a city.\autocite{Osland2016} +\end{example} + +\DescribeMacro{\fullcite}\DescribeMacro{\footfullcite} +With \cs{fullcite} and \cs{footfullcite} you can print the complete entry in your current text. +\begin{code} +\fullcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@* +\footfullcite*@\oarg{prenote}\oarg{postnote}\marg{bibtex-key}@* +\end{code} + +\begin{example} +Public space is part of a city.\footfullcite{Osland2016} +As can be read in \fullcite{Evangelidis2014} \end{example} + + \DescribeMacro{\citeauthor}\DescribeMacro{\citetitle}\label{citeauthor}% Furthermore and in addition to the ›normal‹ \cs{cite}-commands one can also cite only the author or the work title in the text and in the footnotes. \begin{code} @@ -307,13 +364,36 @@ Public space is part of a city says \citeauthor{Osland2016} in \citetitle{Osland \end{example} For further information cf. \cref{citeauthorformat}. +\DescribeMacro{\citetranslator}\label{citetranslator}% +Addionally there is also a \cs{cite}-command which can be used to print the translator of an (ancient) work. +\begin{code} +\citetranslator*@\marg{bibtex-key}%@* +\end{code} +This will print the name(s) of the translator according to the chosen |citeauthorformat|. +If there is no translator it will name you as translator (\enquote{own translation}). +\begin{code} +\citetranslator* *@\marg{bibtex-key}%@* +\end{code} +\newcommand\latquote[5]{\cite[#1][#2]{#3}: \emph{#4} -- \enquote{#5} \parentext{\citetranslator*{#3}}.} + +The starred version prints also the informtion from which language the text has been translated. +For an efficient way of citing ancient texts we introduce a new command (only a suggestion): +\begin{code} +\newcommand\latquote[5]{\cite[#1][#2]{#3}: \emph{#4} -- \enquote{#5} \parentext{\citetranslator*{#3}}.} +\end{code} +\begin{example} +\latquote{cf.}{12,25,1}{Cic:Att}{sed domus est, ut ais, forum}{Aber dein Heim ist das Forum.} +\end{example} + + + \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>} +The citation rules of the \DAI instruct to abbreviate journals and series according to a given list.\footnote{\url{http://www.dainst.org/documents/10180/70593/03_Liste+abzukürzender+Zeitschriften_quer.pdf} <2016-06-06>} For this purpose we provide a list with bibliography macros which refer to these abbreviations. These abbreviations can be included by loading package option |lstabbrv| (cf. \cref{abbrv}). Besides there are two further lists with |@String| macros cf. \cref{lstpublishers,lstlocations}. -\DescribeMacro{@String} The style |archaeologie| respects the guidelines of the German Archaeological Institute +\DescribeMacro{@String} The style |archaeologie| respects the guidelines of the \DAI and is therefore compatible with the given abbreviations of journals and series. To minimize the susceptibility to errors and to omit unnecessary typing of sometimes very long journal titles |archaeologie| works with so-called |@Strings|. The advantage of these |@Strings| is that several bibliography entries can be defined by one globally given value. @@ -321,7 +401,7 @@ The |@String| is loaded at begin of the |bib|-file, therefore all |@Strings| hav To use this offer of simplification the following bibliography fields should be field with such a a |@String|: |journaltitle| and |shortjournal|, (|series| and |shortseries|. -In \cref{abbrv-lists} there is a list with all the abbreviations given by the German Archaeological Institute, +In \cref{abbrv-lists} there is a list with all the abbreviations given by the \DAI, in which the |@String| (with endings |-short| for |shortjournal| or |shortseries|) are listed in the left column. An |@String| has to be written \emph{without} any curly brackets.\footnote{If you use \emph{JabRef} in its non-coding window, then you have to write \#|AyasofyaMuezYil|\#. @@ -394,8 +474,8 @@ Changes made by these options are {\color{red}coloured in red}. Optional preferences in the preamble are loaded within the package |bib|\LaTeX: \begin{code} \usepackage[% - backend=biber, % activates biber which is done by default anyway - % (but will give an error if not done here) + backend=biber, % activates biber (default; + % but will give an error if not done) style=archaeologie, % loads the style *@|archaeologie|@* inreferences=true, % option *@|inreferences|@* is loaded lstabbrv % option *@|lstabbrv|@* is loaded as well @@ -501,7 +581,7 @@ For the list, cf. \cref{list-publishers} \subsubsection{seenote}\label{seenote} \DescribeMacro{seenote} Even if author-year-citation seems to be commonly accepted in Ancient Studies in the meantime you may want to use a traditional citation style. -For this purpose you can switch to the other allowed citation rule by the German Archaeological Institute +For this purpose you can switch to the other allowed citation rule by the \DAI which works like this: If you cite a work for the first time in a footnote |archaeologie| will print a full cite which contains all bibliography elements. Henceforward each following citation is printed as short cite and will additionally refer to the footnote where the first cite was done. @@ -611,7 +691,7 @@ There are two ways to display this entry: \begin{tcolorbox}[examplebox] |\footnote{\cite{Nieddu1995}.}| \tcblower -\footnote{LTUR 2 (1995) 9f. s. v. Dei Consentes (G. Nieddu).} +\footnote{LTUR 2 (1995) 9\,f. s. v. Dei Consentes (G. Nieddu).} \end{tcolorbox} \end{enumerate} @@ -634,7 +714,7 @@ then it will change the position for the \oarg{postnote}: \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). +because the entry is fully cited before in the footnotes (also stated in the \DAI rules). \end{marker} If the option is not used (|inreferences=false|) the entry will look like this in the bibliography: @@ -856,7 +936,7 @@ to \begin{bibbox}{Ball2013}\footnotesize \parbox[t]{3cm}{{\scshape \color{red}Ball – Dobbins} 2013}\parbox[t]{8.5cm}{% -L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492\newline +L. F. Ball – J. J. Dobbins, Pompeii Forum Project. Current Thinking on the Pompeii Forum, AJA 117/3, 2013, 461–492,\newline ...} \end{bibbox} @@ -896,7 +976,7 @@ and with |bibfullname| it will change to: \subsubsection{noabbrv}\label{noabbrevs} \DescribeMacro{noabbrv} -According to the guidelines of the German Archaeological Institute journal titles and series have to be abbreviated. +According to the guidelines of the \DAI journal titles and series have to be abbreviated. Therefore the fields |shortjournal| or |shortseries| will be considered. If you like to have printed full names of journals and series instead you can switch on the option |noabbrv|. For an example see \cref{string,Koyunlu1990}. @@ -1058,7 +1138,14 @@ Citing these two authors will show their digraphs and trigraphs: This option is set to default, but you can --- of course --- deactivate it with |initials=false| in the preamble. +With this default option you don’t have to change anything in your bibliographical-data. +However you can switch off the option |initials| and do the abbreviation manually: +\begin{code} +author = {family=Mann, given=Christian, given-i={Chr}} + +author = {family=Hufschmid, given=Thomas, given-i={Th}} +\end{code} \subsection{Bibliography entry options}\label{options-bibentry} @@ -1503,7 +1590,7 @@ This following example clarify matters: } \end{bibexample} -\printbib[10em]{Carter2014} +\printbib[12em]{Carter2014} You can also have contributions to a ›Festschrift‹ etc. set up as |@Incollection|, but then notice the additional information in |booktitleaddon|. @@ -1787,17 +1874,17 @@ In the bibliography it will look like \printbib{Neils1994} \item\label{inreference:b} -The German Archaeological Institute has a special rule for inreferences in the footnote. +The \DAI has a special rule for inreferences in the footnote. Then the output will be like:\\ |reference volume (year) pages s.v. title (author)| \\ and there will be no reference to the bibliography since the entry is fully described in the footnote. \DescribeMacro{inreferences} If you prefer this method you have to use the preamble option called |inreferences|---cf. \cref{inreferences} Then it will look like this in the footnote: -\begin{tcolorbox}[examplebox] +\begin{examplebox} |\footnote{\cite{Neils1994}.}| \tcblower \footnote{LIMC 7.1 (1994) 922--951 s. v. Theseus (J. Neils).} -\end{tcolorbox} +\end{examplebox} 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} @@ -2163,7 +2250,7 @@ urn = *@\marg{urn:xxx}@* \end{code} \DescribeMacro{zenon} -This eprint-form is especially designed for the OPAC (Online Public Access Catalogue) of the German Archaeological Institute. +This eprint-form is especially designed for the OPAC (Online Public Access Catalogue) of the \DAI. All bibliographical entries in this OPAC can be referred to via this link. You only need to insert the individual Zenon-number of the entry, e.\,g. \emph{http://zenon.dainst.org/Record/001371402} where \emph{001371402} is the individual number---cf. \cref{Zanker2009}. @@ -2494,7 +2581,7 @@ In these examples we used such |@String|: \item[YUP] Yale University Press \end{description} \end{multicols} -\section{List of abbreviation according to the German Archaeological Institute-guidelines}\label{abbrv-lists} +\section{List of abbreviation according to the \DAI-guidelines}\label{abbrv-lists} We modified the lists with abbreviations of journals, corpora, etc. to make them usable with |bib|\LaTeX. Below there are two lists with\DescribeMacro{@String} |@String| (in \textbf{bold} letters on the left), one with the abbreviations (\cref{liste-kurz}), the other with the long forms (\cref{liste-lang}). |