path: root/Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex

%
% This file presents default localization keys for the module specified by
% the main document language passed to 'babel'.
%
\documentclass{article}

% localization modules
% - ascii
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
%\usepackage[brazilian]{babel}
%\usepackage[catalan]{babel}
%\usepackage[croatian]{babel}
%\usepackage[czech]{babel}
%\usepackage[danish]{babel}
%\usepackage[dutch]{babel}
\usepackage[english]{babel}
%\usepackage[estonian]{babel}
%\usepackage[finnish]{babel}
%\usepackage[french]{babel}
%\usepackage[german]{babel}
%\usepackage[icelandic]{babel}
%\usepackage[italian]{babel}
%\usepackage[norsk]{babel}
%\usepackage[nynorsk]{babel}
%\usepackage[polish]{babel}
%\usepackage[portuguese]{babel}
%\usepackage[slovene]{babel}
%\usepackage[spanish]{babel}
%\usepackage[swedish]{babel}
% - UTF-8
% -- Russian
%\usepackage[T1,T2A]{fontenc}
%\usepackage[utf8]{inputenc}
%\usepackage[russian]{babel}
% -- Greek
%\usepackage[T1]{fontenc}
%\usepackage[utf8]{inputenx}
%\usepackage[english,greek]{babel}

\usepackage[autostyle]{csquotes}
\DeclareQuoteAlias{spanish}{catalan}
\DeclareQuoteAlias{croatian}{polish}
\DeclareQuoteAlias{croatian}{slovene}
\usepackage[backend=biber]{biblatex}
\usepackage[colorlinks]{hyperref}

% list format
\newcommand*{\ie}{i.\,e.}
\newcommand*{\eg}{e.\,g.}
\newcommand{\cmd}[1]{\vrb{\textbackslash #1}}
\newcommand{\vrb}[1]{\mbox{\ttfamily #1}}
\newcommand{\acr}[1]{\textsc{#1}}
\newrobustcmd*{\bibfield}[1]{\mbox{\ttfamily #1}}
\newrobustcmd*{\bibtype}[1]{\mbox{\ttfamily @#1}}
\newcommand{\prm}[1]{%
  \mbox{%
    \ensuremath\langle
    \normalfont\textit{#1}%
    \ensuremath\rangle}}
\newenvironment*{keylist}
  {\list{}{%
     \setlength{\labelwidth}{1.25in}%
     \setlength{\labelsep}{10pt}%
     \setlength{\leftmargin}{0pt}%
     \setlength{\itemsep}{0pt}%
     \raggedright%
     \renewcommand*{\makelabel}[1]{\hss\bfseries##1}}}
  {\endlist}
\makeatletter
\def\keyitem#1{%
  \item[#1]
  \begingroup
    \keyitemhook%
    \blx@bibinit%
    \midsentence\ifbibstring{#1}{}{\latintext}\biblstring{#1}%
    \expandafter\lbx@initnamehook\lsmartoftext%
    \par\nobreak
    \midsentence\ifbibstring{#1}{}{\latintext}\bibsstring{#1}%
    \expandafter\lbx@initnamehook\ssmartoftext%
  \endgroup
  \par\nobreak}
\makeatother
\ifdefstring{\languagename}{greek}{%
  \AtBeginDocument{%
    \appto{\keyitemhook}{\greektext}%
    \latintext}
  \preto{\UrlFont}{\latintext}
  \pretocmd{\printbibliography}{\greektext}{}{}}{}
\AtBeginBibliography{\raggedright}
\AtBeginDocument{\MakeAutoQuote*{<}{>}}

% user-configurable commands
\newcommand{\keyitemhook}{}
\newcommand{\lsmartoftext}{A}
\newcommand{\ssmartoftext}{B}

\addbibresource{biblatex-examples.bib}
\nocite{*}

\begin{document}
\section*{Localization Strings for \vrb{\languagename}}

The localization keys listed in this document are defined by default. Each key is printed with its description from the \vrb{biblatex} manual and strings specified by \vrb{\languagename.lbx} in following format.
\begin{verbatim}
<key name>  <long string>
            <short string>
\end{verbatim}
Long and short strings ending with \cmd{smartof}-type commands are respectively given the arguments \cmd{lsmarttext} and \cmd{ssmarttext}, which can be redefined in this document's preamble. Any unspecified keys will appear in boldface and generate warnings in the \vrb{log} file. String definitions or corrections are welcome at:
\begin{center}
\url{http://github.com/plk/biblatex/issues}
\end{center}

\subsection*{Headings}

The following strings are special because they are intended for use in headings and made available globally via macros. For this reason, they should be capitalized for use in headings and they must not include any local commands which are part of \vrb{biblatex}'s author interface.

\begin{keylist}
\keyitem{bibliography} The term <bibliography>, also available as \cmd{bibname}.
\keyitem{references} The term <references>, also available as \cmd{refname}.
\keyitem{shorthands} The term <list of shorthands> or <list of abbreviations>, also available as \cmd{losname}.
\end{keylist}

\subsection*{Roles, Expressed as Functions}

The following keys refer to roles which are expressed as a function (<editor>, <translator>) rather than as an action (<edited by>, <translated by>).

\begin{keylist}
\keyitem{editor} The term <editor>, referring to the main editor. This is the most generic editorial role.
\keyitem{editors} The plural form of \vrb{editor}.
\keyitem{compiler} The term <compiler>, referring to an editor whose task is to compile a work.
\keyitem{compilers} The plural form of \vrb{compiler}.
\keyitem{founder} The term <founder>, referring to a founding editor.
\keyitem{founders} The plural form of \vrb{founder}.
\keyitem{continuator} An expression like <continuator>, <continuation>, or <continued>, referring to a past editor who continued the work of the founding editor but was subsequently replaced by the current editor.
\keyitem{continuators} The plural form of \vrb{continuator}.
\keyitem{redactor} The term <redactor>, referring to a secondary editor.
\keyitem{redactors} The plural form of \vrb{redactor}.
\keyitem{reviser} The term <reviser>, referring to a secondary editor.
\keyitem{revisers} The plural form of \vrb{reviser}.
\keyitem{collaborator} A term like <collaborator>, <collaboration>, <cooperator>, or <cooperation>, referring to a secondary editor.
\keyitem{collaborators} The plural form of \vrb{collaborator}.
\keyitem{translator} The term <translator>.
\keyitem{translators} The plural form of \vrb{translator}.
\keyitem{commentator} The term <commentator>, referring to the author of a commentary to a work.
\keyitem{commentators} The plural form of \vrb{commentators}.
\keyitem{annotator} The term <annotator>, referring to the author of annotations to a work.
\keyitem{annotators} The plural form of \vrb{annotators}.
\end{keylist}

\subsection*{Concatenated Editor Roles, Expressed as Functions}

The following keys are similar in function to \vrb{editor}, \vrb{translator}, etc. They are used to indicate additional roles of the editor, e.g. <editor and translator>, <editor and foreword>.

\begin{keylist}
\keyitem{editortr} Used if \vrb{editor}\slash \vrb{translator} are identical.
\keyitem{editorstr} The plural form of \vrb{editortr}.
\keyitem{editorco} Used if \vrb{editor}\slash \vrb{commentator} are identical.
\keyitem{editorsco} The plural form of \vrb{editorco}.
\keyitem{editoran} Used if \vrb{editor}\slash \vrb{annotator} are identical.
\keyitem{editorsan} The plural form of \vrb{editoran}.
\keyitem{editorin} Used if \vrb{editor}\slash \vrb{introduction} are identical.
\keyitem{editorsin} The plural form of \vrb{editorin}.
\keyitem{editorfo} Used if \vrb{editor}\slash \vrb{foreword} are identical.
\keyitem{editorsfo} The plural form of \vrb{editorfo}.
\keyitem{editoraf} Used if \vrb{editor}\slash \vrb{afterword} are identical.
\keyitem{editorsaf} The plural form of \vrb{editoraf}.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{translator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{editortrco} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator} are identical.
\keyitem{editorstrco} The plural form of \vrb{editortrco}.
\keyitem{editortran} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{annotator} are identical.
\keyitem{editorstran} The plural form of \vrb{editortran}.
\keyitem{editortrin} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{introduction} are identical.
\keyitem{editorstrin} The plural form of \vrb{editortrin}.
\keyitem{editortrfo} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{foreword} are identical.
\keyitem{editorstrfo} The plural form of \vrb{editortrfo}.
\keyitem{editortraf} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{afterword} are identical.
\keyitem{editorstraf} The plural form of \vrb{editortraf}.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{commentator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{editorcoin} Used if \vrb{editor}\slash \vrb{commentator}\slash \vrb{introduction} are identical.
\keyitem{editorscoin} The plural form of \vrb{editorcoin}.
\keyitem{editorcofo} Used if \vrb{editor}\slash \vrb{commentator}\slash \vrb{foreword} are identical.
\keyitem{editorscofo} The plural form of \vrb{editorcofo}.
\keyitem{editorcoaf} Used if \vrb{editor}\slash \vrb{commentator}\slash \vrb{afterword} are identical.
\keyitem{editorscoaf} The plural form of \vrb{editorcoaf}.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{annotator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{editoranin} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{introduction} are identical.
\keyitem{editorsanin} The plural form of \vrb{editoranin}.
\keyitem{editoranfo} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{foreword} are identical.
\keyitem{editorsanfo} The plural form of \vrb{editoranfo}.
\keyitem{editoranaf} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{afterword} are identical.
\keyitem{editorsanaf} The plural form of \vrb{editoranaf}.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{editortrcoin} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator}\slash \vrb{introduction} are identical.
\keyitem{editorstrcoin} The plural form of \vrb{editortrcoin}.
\keyitem{editortrcofo} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator}\slash \vrb{foreword} are identical.
\keyitem{editorstrcofo} The plural form of \vrb{editortrcofo}.
\keyitem{editortrcoaf} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator}\slash \vrb{afterword} are identical.
\keyitem{editorstrcoaf} The plural form of \vrb{editortrcoaf}.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{annotator}\slash \vrb{commentator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{editortranin} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{commentator}\slash \vrb{introduction} are identical.
\keyitem{editorstranin} The plural form of \vrb{editortranin}.
\keyitem{editortranfo} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{commentator}\slash \vrb{foreword} are identical.
\keyitem{editorstranfo} The plural form of \vrb{editortranfo}.
\keyitem{editortranaf} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{commentator}\slash \vrb{afterword} are identical.
\keyitem{editorstranaf} The plural form of \vrb{editortranaf}.
\end{keylist}

\subsection*{Concatenated Translator Roles, Expressed as Functions}

The following keys are similar in function to \vrb{translator}. They are used to indicate additional roles of the translator, e.g. <translator and commentator>, <translator and introduction>.

\begin{keylist}
\keyitem{translatorco} Used if \vrb{translator}\slash \vrb{commentator} are identical.
\keyitem{translatorsco} The plural form of \vrb{translatorco}.
\keyitem{translatoran} Used if \vrb{translator}\slash \vrb{annotator} are identical.
\keyitem{translatorsan} The plural form of \vrb{translatoran}.
\keyitem{translatorin} Used if \vrb{translator}\slash \vrb{introduction} are identical.
\keyitem{translatorsin} The plural form of \vrb{translatorin}.
\keyitem{translatorfo} Used if \vrb{translator}\slash \vrb{foreword} are identical.
\keyitem{translatorsfo} The plural form of \vrb{translatorfo}.
\keyitem{translatoraf} Used if \vrb{translator}\slash \vrb{afterword} are identical.
\keyitem{translatorsaf} The plural form of \vrb{translatoraf}.
\end{keylist}
%
Keys for \vrb{translator}\slash \vrb{commentator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{translatorcoin} Used if \vrb{translator}\slash \vrb{commentator}\slash \vrb{introduction} are identical.
\keyitem{translatorscoin} The plural form of \vrb{translatorcoin}.
\keyitem{translatorcofo} Used if \vrb{translator}\slash \vrb{commentator}\slash \vrb{foreword} are identical.
\keyitem{translatorscofo} The plural form of \vrb{translatorcofo}.
\keyitem{translatorcoaf} Used if \vrb{translator}\slash \vrb{commentator}\slash \vrb{afterword} are identical.
\keyitem{translatorscoaf} The plural form of \vrb{translatorcoaf}.
\end{keylist}
%
Keys for \vrb{translator}\slash \vrb{annotator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{translatoranin} Used if \vrb{translator}\slash \vrb{annotator}\slash \vrb{introduction} are identical.
\keyitem{translatorsanin} The plural form of \vrb{translatoranin}.
\keyitem{translatoranfo} Used if \vrb{translator}\slash \vrb{annotator}\slash \vrb{foreword} are identical.
\keyitem{translatorsanfo} The plural form of \vrb{translatoranfo}.
\keyitem{translatoranaf} Used if \vrb{translator}\slash \vrb{annotator}\slash \vrb{afterword} are identical.
\keyitem{translatorsanaf} The plural form of \vrb{translatoranaf}.
\end{keylist}

\subsection*{Roles, Expressed as Actions}

The following keys refer to roles which are expressed as an action (<edited by>, <translated by>) rather than as a function (<editor>, <translator>).

\begin{keylist}
\keyitem{byauthor} The expression <[created] by \prm{name}>.
\keyitem{byeditor} The expression <edited by \prm{name}>.
\keyitem{bycompiler} The expression <compiled by \prm{name}>.
\keyitem{byfounder} The expression <founded by \prm{name}>.
\keyitem{bycontinuator} The expression <continued by \prm{name}>.
\keyitem{byredactor} The expression <redacted by \prm{name}>.
\keyitem{byreviser} The expression <revised by \prm{name}>.
\keyitem{byreviewer} The expression <reviewed by \prm{name}>.
\keyitem{bycollaborator} An expression like <in collaboration with \prm{name}> or <in cooperation with \prm{name}>.
\keyitem{bytranslator} The expression <translated by \prm{name}> or <translated from \prm{language} \prm{name}>.
\keyitem{bycommentator} The expression <commented by \prm{name}>.
\keyitem{byannotator} The expression <annotated by \prm{name}>.
\end{keylist}

\subsection*{Concatenated Editor Roles, Expressed as Actions}

The following keys are similar in function to \vrb{byeditor}, \vrb{bytranslator}, etc. They are used to indicate additional roles of the editor, e.g. <edited and translated by>, <edited and furnished with an introduction by>, <edited, with a foreword, by>.

\begin{keylist}
\keyitem{byeditortr} Used if \vrb{editor}\slash \vrb{translator} are identical.
\keyitem{byeditorco} Used if \vrb{editor}\slash \vrb{commentator} are identical.
\keyitem{byeditoran} Used if \vrb{editor}\slash \vrb{annotator} are identical.
\keyitem{byeditorin} Used if \vrb{editor}\slash \vrb{introduction} are identical.
\keyitem{byeditorfo} Used if \vrb{editor}\slash \vrb{foreword} are identical.
\keyitem{byeditoraf} Used if \vrb{editor}\slash \vrb{afterword} are identical.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{translator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{byeditortrco} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator} are identical.
\keyitem{byeditortran} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{annotator} are identical.
\keyitem{byeditortrin} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{introduction} are identical.
\keyitem{byeditortrfo} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{foreword} are identical.
\keyitem{byeditortraf} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{afterword} are identical.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{commentator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{byeditorcoin} Used if \vrb{editor}\slash \vrb{commentator}\slash \vrb{introduction} are identical.
\keyitem{byeditorcofo} Used if \vrb{editor}\slash \vrb{commentator}\slash \vrb{foreword} are identical.
\keyitem{byeditorcoaf} Used if \vrb{editor}\slash \vrb{commentator}\slash \vrb{afterword} are identical.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{annotator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{byeditoranin} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{introduction} are identical.
\keyitem{byeditoranfo} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{foreword} are identical.
\keyitem{byeditoranaf} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{afterword} are identical.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{byeditortrcoin} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator}\slash \vrb{introduction} are identical.
\keyitem{byeditortrcofo} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator}\slash \vrb{foreword} are identical.
\keyitem{byeditortrcoaf} Used if \vrb{editor}\slash \vrb{translator}\slash \vrb{commentator}\slash \vrb{afterword} are identical.
\end{keylist}
%
Keys for \vrb{editor}\slash \vrb{translator}\slash \vrb{annotator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{byeditortranin} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{commentator}\slash \vrb{introduction} are identical.
\keyitem{byeditortranfo} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{commentator}\slash \vrb{foreword} are identical.
\keyitem{byeditortranaf} Used if \vrb{editor}\slash \vrb{annotator}\slash \vrb{commentator}\slash \vrb{afterword} are identical.
\end{keylist}

\subsection*{Concatenated Translator Roles, Expressed as Actions}

The following keys are similar in function to \vrb{bytranslator}. They are used to indicate additional roles of the translator, e.g. <translated and commented by>, <translated and furnished with an introduction by>, <translated, with a foreword, by>.

\begin{keylist}
\keyitem{bytranslatorco} Used if \vrb{translator}\slash \vrb{commentator} are identical.
\keyitem{bytranslatoran} Used if \vrb{translator}\slash \vrb{annotator} are identical.
\keyitem{bytranslatorin} Used if \vrb{translator}\slash \vrb{introduction} are identical.
\keyitem{bytranslatorfo} Used if \vrb{translator}\slash \vrb{foreword} are identical.
\keyitem{bytranslatoraf} Used if \vrb{translator}\slash \vrb{afterword} are identical.
\end{keylist}
%
Keys for \vrb{translator}\slash \vrb{commentator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{bytranslatorcoin} Used if \vrb{translator}\slash \vrb{commentator}\slash \vrb{introduction} are identical.
\keyitem{bytranslatorcofo} Used if \vrb{translator}\slash \vrb{commentator}\slash \vrb{foreword} are identical.
\keyitem{bytranslatorcoaf} Used if \vrb{translator}\slash \vrb{commentator}\slash \vrb{afterword} are identical.
\end{keylist}
%
Keys for \vrb{translator}\slash \vrb{annotator}\slash \prm{role} combinations:

\begin{keylist}
\keyitem{bytranslatoranin} Used if \vrb{translator}\slash \vrb{annotator}\slash \vrb{introduction} are identical.
\keyitem{bytranslatoranfo} Used if \vrb{translator}\slash \vrb{annotator}\slash \vrb{foreword} are identical.
\keyitem{bytranslatoranaf} Used if \vrb{translator}\slash \vrb{annotator}\slash \vrb{afterword} are identical.
\end{keylist}

\subsection*{Roles, Expressed as Objects}

Roles which are related to supplementary material may also be expressed as objects (<with a commentary by>) rather than as functions (<commentator>) or as actions (<commented by>).

\begin{keylist}
\keyitem{withcommentator} The expression <with a commentary by \prm{name}>.
\keyitem{withannotator} The expression <with annotations by \prm{name}>.
\keyitem{withintroduction} The expression <with an introduction by \prm{name}>.
\keyitem{withforeword} The expression <with a foreword by \prm{name}>.
\keyitem{withafterword} The expression <with an afterword by \prm{name}>.
\end{keylist}

\subsection*{Supplementary Material}

\begin{keylist}
\keyitem{commentary} The term <commentary>.
\keyitem{annotations} The term <annotations>.
\keyitem{introduction} The term <introduction>.
\keyitem{foreword} The term <foreword>.
\keyitem{afterword} The term <afterword>.
\end{keylist}

\subsection*{Publication Details}

\begin{keylist}
\keyitem{volume} The term <volume>, referring to a book.
\keyitem{volumes} The plural form of \vrb{volume}.
\keyitem{involumes} The term <in>, as used in expressions like <in \prm{number of volumes} volumes>.
\keyitem{jourvol} The term <volume>, referring to a journal.
\keyitem{jourser} The term <series>, referring to a journal.
\keyitem{book} The term <book>, referring to a document division.
\keyitem{part} The term <part>, referring to a part of a book or a periodical.
\keyitem{issue} The term <issue>, referring to a periodical.
\keyitem{newseries} The expression <new series>, referring to a journal.
\keyitem{oldseries} The expression <old series>, referring to a journal.
\keyitem{edition} The term <edition>.
\keyitem{in} The term <in>, referring to the title of a work published as part of another one, e.g. <\prm{title of article} in \prm{title of journal}>.
\keyitem{inseries} The term <in>, as used in expressions like <volume \prm{number} in \prm{name of series}>.
\keyitem{ofseries} The term <of>, as used in expressions like <volume \prm{number} of \prm{name of series}>.
\keyitem{number} The term <number>, referring to an issue of a journal.
\keyitem{chapter} The term <chapter>, referring to a chapter in a book.
\keyitem{version} The term <version>, referring to a revision number.
\keyitem{reprint} The term <reprint>.
\keyitem{reprintof} The expression <reprint of \prm{title}>.
\keyitem{reprintas} The expression <reprinted as \prm{title}>.
\keyitem{reprintfrom} The expression <reprinted from \prm{title}>.
\keyitem{translationof} The expression <translation of \prm{title}>.
\keyitem{translationas} The expression <translated as \prm{title}>.
\keyitem{translationfrom} The expression <translated from [the] \prm{language}>.
\keyitem{reviewof} The expression <review of \prm{title}>.
\keyitem{origpubas} The expression <originally published as \prm{title}>.
\keyitem{origpubin} The expression <originally published in \prm{year}>.
\keyitem{astitle} The term <as>, as used in expressions like <published by \prm{publisher} as \prm{title}>.
\keyitem{bypublisher} The term <by>, as used in expressions like <published by \prm{publisher}>.
\end{keylist}

\subsection*{Publication State}

\begin{keylist}
\keyitem{inpreparation} The expression <in preparation> (the manuscript is being prepared for publication).
\keyitem{submitted} The expression <submitted> (the manuscript has been submitted to a journal or conference).
\keyitem{forthcoming} The expression <forthcoming> (the manuscript has been accepted by a press or journal).
\keyitem{inpress} The expression <in press> (the manuscript is fully copyedited and out of the author's hands; it is in the final stages of the production process).
\keyitem{prepublished} The expression <pre-published> (the manuscript is published in a preliminary form or location, such as online version in advance of print publication).
\end{keylist}

\subsection*{Pagination}

\begin{keylist}
\keyitem{page} The term <page>.
\keyitem{pages} The plural form of \vrb{page}.
\keyitem{column} The term <column>, referring to a column on a page.
\keyitem{columns} The plural form of \vrb{column}.
\keyitem{section} The term <section>, referring to a document division (usually abbreviated as \S).
\keyitem{sections} The plural form of \vrb{section} (usually abbreviated as \S\S).
\keyitem{paragraph} The term <paragraph> (\ie a block of text, not to be confused with \vrb{section}).
\keyitem{paragraphs} The plural form of \vrb{paragraph}.
\keyitem{verse} The term <verse> as used when referring to a work which is cited by verse numbers.
\keyitem{verses} The plural form of \vrb{verse}.
\keyitem{line} The term <line> as used when referring to a work which is cited by line numbers.
\keyitem{lines} The plural form of \vrb{line}.
\end{keylist}

\subsection*{Types}

The following keys are typically used in the \bibfield{type} field of \bibtype{thesis}, \bibtype{report}, \bibtype{misc}, and other entries:

\begin{keylist}
\keyitem{mathesis} An expression equivalent to the term <Master's thesis>.
\keyitem{phdthesis} The term <PhD thesis>, <PhD dissertation>, <doctoral thesis>, etc.
\keyitem{candthesis} An expression equivalent to the term <Candidate thesis>. Used for <Candidate> degrees that have no clear equivalent to the Master's or doctoral level.
\keyitem{techreport} The term <technical report>.
\keyitem{resreport} The term <research report>.
\keyitem{software} The term <computer software>.
\keyitem{datacd} The term <data \textsc{cd}> or <\textsc{cd-rom}>.
\keyitem{audiocd} The term <audio \textsc{cd}>.
\end{keylist}

\subsection*{Dates and Times}
\begin{keylist}
\keyitem{commonera} The term used to denote the secular era modern term \eg\ <CE>.
\keyitem{beforecommonera} The term used to denote the secular era pre-modern term \eg\ <BCE>.
\keyitem{annodomini} The term used to denote the christian era modern term \eg\ <AD>.
\keyitem{beforechrist} The term used to denote the christian era pre-modern term \eg\ <BC>.
\keyitem{circa} The string prefix used to denote approximate dates \eg\ <circa>.
\keyitem{spring} The string <spring>.
\keyitem{summer} The string <summer>.
\keyitem{autumn} The string <autumn>.
\keyitem{winter} The string <winter>.
\keyitem{am} The string <AM>.
\keyitem{pm} The string <PM>.
\end{keylist}

\subsection*{Miscellaneous}

\begin{keylist}
\keyitem{nodate} The term to use in place of a date when there is no date for an entry \eg\ <n.d.>
\keyitem{and} The term <and>, as used in a list of authors or editors, for example.
\keyitem{andothers} The expression <and others> or <et alii>, used to mark the truncation of a name list.
\keyitem{andmore} Like \vrb{andothers} but used to mark the truncation of a literal list.
\end{keylist}

\subsection*{Labels}

The following strings are intended for use as labels, \eg\ <Address: \prm{url}> or <Abstract: \prm{abstract}>.

\begin{keylist}
\keyitem{url} The term <address> in the sense of an internet address.
\keyitem{urlfrom} An expression like <available from \prm{url}> or <available at \prm{url}>.
\keyitem{urlseen} An expression like <accessed on \prm{date}>, <retrieved on \prm{date}>, <visited on \prm{date}>, referring to the access date of an online resource.
\keyitem{file} The term <file>.
\keyitem{library} The term <library>.
\keyitem{abstract} The term <abstract>.
\keyitem{annotation} The term <annotations>.
\end{keylist}

\subsection*{Citations}

Traditional scholarly expressions used in citations:

\begin{keylist}
\keyitem{idem} The term equivalent to the Latin <idem> (<the same [person]>).
\keyitem{idemsf} The feminine singular form of \vrb{idem}.
\keyitem{idemsm} The masculine singular form of \vrb{idem}.
\keyitem{idemsn} The neuter singular form of \vrb{idem}.
\keyitem{idempf} The feminine plural form of \vrb{idem}.
\keyitem{idempm} The masculine plural form of \vrb{idem}.
\keyitem{idempn} The neuter plural form of \vrb{idem}.
\keyitem{idempp} The plural form of \vrb{idem} suitable for a mixed gender list of names.
\keyitem{ibidem} The term equivalent to the Latin <ibidem> (<in the same place>).
\keyitem{opcit} The term equivalent to the Latin term <opere citato> (<[in] the work [already] cited>).
\keyitem{loccit} The term equivalent to the Latin term <loco citato> (<[at] the place [already] cited>).
\keyitem{confer} The term equivalent to the Latin <confer> (<compare>).
\keyitem{sequens} The term equivalent to the Latin <sequens> (<[and] the following [page]>), as used to indicate a range of two pages when only the starting page is provided (\eg\ <25\,sq.> or <25\,f.> instead of <25--26>).
\keyitem{sequentes} The term equivalent to the Latin <sequentes> (<[and] the following [pages]>), as used to indicate an open"=ended range of pages when only the starting page is provided (\eg\ <25\,sqq.> or <25\,ff.>).
\keyitem{passim} The term equivalent to the Latin <passim> (<throughout>, <here and there>, <scatteredly>).
\end{keylist}
%
Other expressions frequently used in citations:

\begin{keylist}
\keyitem{see} The term <see>.
\keyitem{seealso} The expression <see also>.
\keyitem{seenote} An expression like <see note \prm{footnote}> or <as in \prm{footnote}>, used to refer to a previous footnote in a citation.
\keyitem{backrefpage} An expression like <see page \prm{page}> or <cited on page \prm{page}>, used to introduce back references in the bibliography.
\keyitem{backrefpages} The plural form of \vrb{backrefpage}, \eg\ <see pages \prm{pages}> or <cited on pages \prm{pages}>.
\keyitem{quotedin} An expression like <quoted in \prm{citation}>, used when quoting a passage which was already a quotation in the cited work.
\keyitem{citedas} An expression like <henceforth cited as \prm{shorthand}>, used to introduce a shorthand in a citation.
\keyitem{thiscite} The expression used in some verbose citation styles to differentiate between the page range of the cited item (typically an article in a journal, collection, or conference proceedings) and the page number the citation refers to. For example: \enquote{Author, Title, in: Book, pp. 45--61, \vrb{thiscite} p. 52.}
\end{keylist}

\subsection*{Month Names}

\begin{keylist}
\keyitem{january} The name <January>.
\keyitem{february} The name <February>.
\keyitem{march} The name <March>.
\keyitem{april} The name <April>.
\keyitem{may} The name <May>.
\keyitem{june} The name <June>.
\keyitem{july} The name <July>.
\keyitem{august} The name <August>.
\keyitem{september} The name <September>.
\keyitem{october} The name <October>.
\keyitem{november} The name <November>.
\keyitem{december} The name <December>.
\end{keylist}

\subsection*{Language Names}

\begin{keylist}
\keyitem{langamerican} The language <American> or <American English>.
\keyitem{langbrazilian} The language <Brazilian> or <Brazilian Portuguese>.
\keyitem{langcatalan} The language <Catalan>.
\keyitem{langcroatian} The language <Croatian>.
\keyitem{langczech} The language <Czech>.
\keyitem{langdanish} The language <Danish>.
\keyitem{langdutch} The language <Dutch>.
\keyitem{langenglish} The language <English>.
\keyitem{langfinnish} The language <Finnish>.
\keyitem{langfrench} The language <French>.
\keyitem{langgerman} The language <German>.
\keyitem{langgreek} The language <Greek>.
\keyitem{langitalian} The language <Italian>.
\keyitem{langlatin} The language <Latin>.
\keyitem{langnorwegian} The language <Norwegian>.
\keyitem{langpolish} The language <Polish>.
\keyitem{langportuguese} The language <Portuguese>.
\keyitem{langrussian} The language <Russian>.
\keyitem{langslovene} The language <Slovene>.
\keyitem{langspanish} The language <Spanish>.
\keyitem{langswedish} The language <Swedish>.
\end{keylist}
%
The following strings are intended for use in phrases like <translated from [the] English by \prm{translator}>:

\begin{keylist}
\keyitem{fromamerican} The expression <from [the] American> or <from [the] American English>.
\keyitem{frombrazilian} The expression <from [the] Brazilian> or <from [the] Brazilian Portuguese>.
\keyitem{fromcatalan} The expression <from [the] Catalan>.
\keyitem{fromcroatian} The expression <from [the] Croatian>.
\keyitem{fromczech} The expression <from [the] Czech>.
\keyitem{fromdanish} The expression <from [the] Danish>.
\keyitem{fromdutch} The expression <from [the] Dutch>.
\keyitem{fromenglish} The expression <from [the] English>.
\keyitem{fromfinnish} The expression <from [the] Finnish>.
\keyitem{fromfrench} The expression <from [the] French>.
\keyitem{fromgerman} The expression <from [the] German>.
\keyitem{fromgreek} The expression <from [the] Greek>.
\keyitem{fromitalian} The expression <from [the] Italian>.
\keyitem{fromlatin} The expression <from [the] Latin>.
\keyitem{fromnorwegian} The expression <from [the] Norwegian>.
\keyitem{frompolish} The expression <from [the] Polish>.
\keyitem{fromportuguese} The expression <from [the] Portuguese>.
\keyitem{fromrussian} The expression <from [the] Russian>.
\keyitem{fromslovene} The expression <from [the] Slovene>.
\keyitem{fromspanish} The expression <from [the] Spanish>.
\keyitem{fromswedish} The expression <from [the] Swedish>.
\end{keylist}

\subsection*{Country Names}

Country names are localized by using the string \vrb{country} plus the \acr{ISO}-3166 country code as the key. The short version of the translation should be the \acr{ISO}-3166 country code. Note that only a small number of country names is defined by default, mainly to illustrate this scheme. These keys are used in the \bibfield{location} list of \bibtype{patent} entries but they may be useful for other purposes as well.

\begin{keylist}
\keyitem{countryde} The name <Germany>, abbreviated as \vrb{DE}.
\keyitem{countryeu} The name <European Union>, abbreviated as \vrb{EU}.
\keyitem{countryep} Similar to \vrb{countryeu} but abbreviated as \vrb{EP}. This is intended for \bibfield{patent} entries.
\keyitem{countryfr} The name <France>, abbreviated as \vrb{FR}.
\keyitem{countryuk} The name <United Kingdom>, abbreviated (according to \acr{ISO}-3166) as \vrb{GB}.
\keyitem{countryus} The name <United States of America>, abbreviated as \vrb{US}.
\end{keylist}

\subsection*{Patents and Patent Requests}

Strings related to patents are localized by using the term \vrb{patent} plus the \acr{ISO}-3166 country code as the key. Note that only a small number of patent keys is defined by default, mainly to illustrate this scheme. These keys are used in the \bibfield{type} field of \bibtype{patent} entries.

\begin{keylist}
\keyitem{patent} The generic term <patent>.
\keyitem{patentde} The expression <German patent>.
\keyitem{patenteu} The expression <European patent>.
\keyitem{patentfr} The expression <French patent>.
\keyitem{patentuk} The expression <British patent>.
\keyitem{patentus} The expression <U.S. patent>.
\end{keylist}
%
Patent requests are handled in a similar way, using the string \vrb{patreq} as the base name of the key:

\begin{keylist}
\keyitem{patreq} The generic term <patent request>.
\keyitem{patreqde} The expression <German patent request>.
\keyitem{patreqeu} The expression <European patent request>.
\keyitem{patreqfr} The expression <French patent request>.
\keyitem{patrequk} The expression <British patent request>.
\keyitem{patrequs} The expression <U.S. patent request>.
\end{keylist}

\printbibliography
\end{document}