diff options
author | Karl Berry <karl@freefriends.org> | 2013-05-09 23:01:42 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2013-05-09 23:01:42 +0000 |
commit | 8542531ab70ed2628cb4e1c8674fee9821f81c6a (patch) | |
tree | 013384ef6495b9f19cd419d89b270b2b2570402a /Master/texmf-dist/doc/latex | |
parent | 3316f6f00b0df5fa5871c2c3c1214501eced9b7a (diff) |
biblatex 2.6 (9may13)
git-svn-id: svn://tug.org/texlive/trunk@30358 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex/RELEASE | 17 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex/biblatex.pdf | bin | 1268824 -> 1089976 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex/biblatex.tex | 396 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex | 625 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex/examples/90-related-entries.tex | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib | 2991 |
6 files changed, 2494 insertions, 1537 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex/RELEASE b/Master/texmf-dist/doc/latex/biblatex/RELEASE index e6558181d28..5c55e0ffaf5 100644 --- a/Master/texmf-dist/doc/latex/biblatex/RELEASE +++ b/Master/texmf-dist/doc/latex/biblatex/RELEASE @@ -1,6 +1,21 @@ +RELEASE NOTES FOR VERSION 2.6 + +* Biber version 1.6 is required for biblatex 2.6 + +* INCOMPATIBLE CHANGE - \DeclareLabelyear is now \DeclareLabeldate so + that the extra fields labelmonth and labelday can be generated by + biber. The 'labelyear' package option is now called 'labeldate'. The + old names will work but will generate warnings. The default + definition for \DeclareLabeldate in biblatex.def results in the same + behaviour as with the old \DeclareLabelyear. + +* Localised and fixed string fallbacks now possible as values for labelyear field + +* Cyclic and cascading RELATED entries now working properly. + RELEASE NOTES FOR VERSION 2.5 -* Biber version 1.5 is required for biblatex 2.5 +* Biber version 1.5 is required for biblatex 2.5 * New sourcemap step "entrynull" can be used to completely skip an entry. diff --git a/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf b/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf Binary files differindex 74664694af3..67ed6c091d0 100644 --- a/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf +++ b/Master/texmf-dist/doc/latex/biblatex/biblatex.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex/biblatex.tex b/Master/texmf-dist/doc/latex/biblatex/biblatex.tex index 0f68a5cd523..e7c01bb5d98 100644 --- a/Master/texmf-dist/doc/latex/biblatex/biblatex.tex +++ b/Master/texmf-dist/doc/latex/biblatex/biblatex.tex @@ -1,6 +1,9 @@ \documentclass{ltxdockit}[2011/03/25] \usepackage{btxdockit} -\usepackage[latin9]{inputenc} +\usepackage{fontspec} +\setmainfont[Ligatures=TeX]{TeXGyrePagella} +\setsansfont[Ligatures=TeX]{TexGyreHeros} +\setmonofont[Ligatures=NoCommon]{TeXGyreCursor} \usepackage[american]{babel} \usepackage[strict]{csquotes} \usepackage{tabularx} @@ -8,9 +11,9 @@ \usepackage{booktabs} \usepackage{shortvrb} \usepackage{pifont} -\usepackage{libertine} -\usepackage[scaled=0.8]{beramono} \usepackage{microtype} +\usepackage{typearea} +\areaset[current]{370pt}{700pt} \lstset{basicstyle=\ttfamily,keepspaces=true} \KOMAoptions{numbers=noenddot} \addtokomafont{paragraph}{\spotcolor} @@ -27,14 +30,15 @@ \patchcmd{\paragraph}{-1em}{1.5ex \@plus .2ex}{}{} \makeatother -\MakeAutoQuote{«}{»} +\MakeAutoQuote{«}{»} \MakeAutoQuote*{<}{>} \MakeShortVerb{\|} \newcommand*{\biber}{Biber\xspace} \newcommand*{\biblatex}{Biblatex\xspace} \newcommand*{\biblatexhome}{http://sourceforge.net/projects/biblatex/} -\newcommand*{\biblatexctan}{http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/} +\newcommand*{\biblatexctan}{% + http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex/} \titlepage{% title={The \sty{biblatex} Package}, @@ -42,8 +46,8 @@ url={\biblatexhome}, author={Philipp Lehman (with Audrey Boruvka, Philip Kime and Joseph Wright)}, email={}, - revision={2.5}, - date={10/01/2013}} + revision={2.6}, + date={30/04/2013}} \hypersetup{% pdftitle={The \biblatex Package}, @@ -151,22 +155,23 @@ Please use the \sty{biblatex} project page on GitHub to report bugs and submit f \subsection{Acknowledgments} -The language modules of this package include contributions by the following contributors (in the order of submission): -Ignacio Fernández Galván (Spanish), -Enrico Gregorio (Italian), -Johannes Wilm, Håkon Malmedal (Danish\slash Norwegian), -Per Starbäck, Carl-Gustav Werner, Filip Åsblom (Swedish), -Augusto Ritter Stoffel (Brazilian), -Alexander van Loon (Dutch), -Apostolos Syropoulos (Greek), -Hannu Väisänen (Finnish), -Prokopis (Greek), -Mateus Araújo (Brazilian), -Andrea Marchitelli (Italian), -José Carlos Santos (Portuguese), -Oleg Domanov (Russian), -Pieter Belmans (Dutch), -Baldur Kristinsson (Icelandic). +The language modules of this package are made possible thanks to the following contributors: +Augusto Ritter Stoffel, Mateus Araújo (Brazilian); +Sebastià Vila-Marta (Catalan); +Ivo Pletikosić (Croatian); +Michal Hoftich (Czech); +Johannes Wilm (Danish\slash Norwegian); +Alexander van Loon, Pieter Belmans (Dutch); +Hannu Väisänen, Janne Kujanpää (Finnish); +Denis Bitouzé (French); +Apostolos Syropoulos, Prokopis (Greek); +Baldur Kristinsson (Icelandic); +Enrico Gregorio, Andrea Marchitelli (Italian); +HÃ¥kon Malmedal (Norwegian); +José Carlos Santos (Portuguese); +Oleg Domanov (Russian); +Ignacio Fernández Galván (Spanish); +Per Starbäck, Carl-Gustav Werner, Filip Ã…sblom (Swedish). \subsection{Prerequisites} \label{int:pre} @@ -315,6 +320,7 @@ compatibility matrix for the recent versions. \toprule Biber version & \biblatex\ version\\ \midrule +1.6 & 2.6\\ 1.5 & 2.5\\ 1.4 & 2.4\\ 1.3 & 2.3\\ @@ -755,7 +761,7 @@ The Digital Object Identifier of the work. \fielditem{edition}{integer or literal} -The edition of a printed publication. This must be an integer, not an ordinal. Don't say |edition={First}| or |edition={1st}| but |edition={1}|. The bibliography style converts this to a language dependent ordinal. It is also possible to give the edition as a literal string, for example «Third, revised and expanded edition». +The edition of a printed publication. This must be an integer, not an ordinal. Don't say |edition={First}| or |edition={1st}| but |edition={1}|. The bibliography style converts this to a language dependent ordinal. It is also possible to give the edition as a literal string, for example «Third, revised and expanded edition». \listitem{editor}{name} @@ -815,7 +821,7 @@ The date of a conference, a symposium, or some other event in \bibtype{proceedin \fielditem{eventtitle}{literal} -The title of a conference, a symposium, or some other event in \bibtype{proceedings} and \bibtype{inproceedings} entries. This field may also be useful for the custom types listed in \secref{bib:typ:ctm}. Note that this field holds the plain title of the event. Things like «Proceedings of the Fifth XYZ Conference» go into the \bibfield{titleaddon} or \bibfield{booktitleaddon} field, respectively. See also \bibfield{eventdate} and \bibfield{venue}. +The title of a conference, a symposium, or some other event in \bibtype{proceedings} and \bibtype{inproceedings} entries. This field may also be useful for the custom types listed in \secref{bib:typ:ctm}. Note that this field holds the plain title of the event. Things like «Proceedings of the Fifth XYZ Conference» go into the \bibfield{titleaddon} or \bibfield{booktitleaddon} field, respectively. See also \bibfield{eventdate} and \bibfield{venue}. \fielditem{file}{verbatim} @@ -835,7 +841,7 @@ A publication notice for unusual publications which do not fit into any of the c \fielditem{indextitle}{literal} -A title to use for indexing instead of the regular \bibfield{title} field. This field may be useful if you have an entry with a title like «An Introduction to \dots» and want that indexed as «Introduction to \dots, An». Style authors should note that \sty{biblatex} automatically copies the value of the \bibfield{title} field to \bibfield{indextitle} if the latter field is undefined. +A title to use for indexing instead of the regular \bibfield{title} field. This field may be useful if you have an entry with a title like «An Introduction to \dots» and want that indexed as «Introduction to \dots, An». Style authors should note that \sty{biblatex} automatically copies the value of the \bibfield{title} field to \bibfield{indextitle} if the latter field is undefined. \listitem{institution}{literal} @@ -927,7 +933,7 @@ An addon to be printed immediately after the author name in the bibliography. No \fielditem{note}{literal} -Miscellaneous bibliographic data which does not fit into any other field. The \bibfield{note} field may be used to record bibliographic data in a free format. Publication facts such as «Reprint of the edition London 1831» are typical candidates for the \bibfield{note} field. See also \bibfield{addendum}. +Miscellaneous bibliographic data which does not fit into any other field. The \bibfield{note} field may be used to record bibliographic data in a free format. Publication facts such as «Reprint of the edition London 1831» are typical candidates for the \bibfield{note} field. See also \bibfield{addendum}. \fielditem{number}{literal} @@ -987,7 +993,7 @@ The publication state of the work, \eg\ <in press>. See \secref{aut:lng:key:pst} \fielditem{series}{literal} -The name of a publication series, such as «Studies in \dots», or the number of a journal series. Books in a publication series are usually numbered. The number or volume of a book in a series is given in the \bibfield{number} field. Note that the \bibtype{article} entry type makes use of the \bibfield{series} field as well, but handles it in a special way. See \secref{bib:use:ser} for details. +The name of a publication series, such as «Studies in \dots», or the number of a journal series. Books in a publication series are usually numbered. The number or volume of a book in a series is given in the \bibfield{number} field. Note that the \bibtype{article} entry type makes use of the \bibfield{series} field as well, but handles it in a special way. See \secref{bib:use:ser} for details. \listitem{shortauthor}{name} @@ -1003,7 +1009,7 @@ A special designation to be used by the citation style instead of the usual labe \fielditem{shorthandintro}{literal} -The verbose citation styles which comes with this package use a phrase like «henceforth cited as [shorthand]» to introduce shorthands on the first citation. If the \bibfield{shorthandintro} field is defined, it overrides the standard phrase. Note that the alternative phrase must include the shorthand. +The verbose citation styles which comes with this package use a phrase like «henceforth cited as [shorthand]» to introduce shorthands on the first citation. If the \bibfield{shorthandintro} field is defined, it overrides the standard phrase. Note that the alternative phrase must include the shorthand. \fielditem{shortjournal}{literal} @@ -1092,13 +1098,13 @@ The gender of the author or the gender of the editor, if there is no author. The \begin{table} \tablesetup -\begin{tabularx}{\textwidth}{@{}p{100pt}@{}p{100pt}@{}X@{}} +\begin{tabularx}{\textwidth}{@{}p{100pt}@{}p{150pt}@{}X@{}} \toprule \multicolumn{1}{@{}H}{Language} & \multicolumn{1}{@{}H}{Region/Dialect} & \multicolumn{1}{@{}H}{Babel Identifiers} \\ \cmidrule(r){1-1}\cmidrule(r){2-2}\cmidrule{3-3} -Catalan & Andorra, Balearic islands, Catalonia, Valencia, Roussillon & \opt{catalan} \\ +Catalan & Spain, France, Andorra, Italy & \opt{catalan} \\ Czech & Czech Republic & \opt{czech} \\ Danish & Denmark & \opt{danish} \\ Dutch & Netherlands & \opt{dutch} \\ @@ -1157,7 +1163,7 @@ A comma"=separated list of entry options in \keyval notation. This field is used A special field used to modify the sorting order of the bibliography. This field is the first item the sorting routine considers when sorting the bibliography, hence it may be used to arrange the entries in groups. This may be useful when creating subdivided bibliographies with the bibliography filters. Please refer to \secref{use:srt} for further details. Also see \secref{aut:ctm:srt}. This field is consumed by the backend processing and does not appear in the \path{.bbl}. -\fielditem{related}{comma"=separated values} +\fielditem{related}{comma"=separated values\BiberOnlyMark} Citation keys of other entries which have a relationship to this entry. The relationship is specified by the \bibfield{relatedtype} field. Please refer to \secref{use:rel} for further details. @@ -1175,7 +1181,7 @@ formatting directives and bibliography macros for the related entries. Please re A field used to override the bibliography string specified by \bibfield{relatedtype}. Please refer to \secref{use:rel} for further details. -\fielditem{sortkey}{literal\BiberOnlyMark} +\fielditem{sortkey}{literal} A field used to modify the sorting order of the bibliography. Think of this field as the master sort key. If present, \sty{biblatex} uses this field during sorting and ignores everything else, except for the \bibfield{presort} field. Please refer to \secref{use:srt} for further details. This field is consumed by the backend processing and does not appear in the \path{.bbl}. @@ -1189,7 +1195,7 @@ Similar to \bibfield{sortkey} but used in the list of shorthands. If present, \s \fielditem{sorttitle}{literal} -A field used to modify the sorting order of the bibliography. If present, this field is used instead of the \bibfield{title} field when sorting the bibliography. The \bibfield{sorttitle} field may come in handy if you have an entry with a title like «An Introduction to\dots» and want that alphabetized under <I> rather than <A>. In this case, you could put «Introduction to\dots» in the \bibfield{sorttitle} field. Please refer to \secref{use:srt} for further details. This field is consumed by the backend processing and does not appear in the \path{.bbl}. +A field used to modify the sorting order of the bibliography. If present, this field is used instead of the \bibfield{title} field when sorting the bibliography. The \bibfield{sorttitle} field may come in handy if you have an entry with a title like «An Introduction to\dots» and want that alphabetized under <I> rather than <A>. In this case, you could put «Introduction to\dots» in the \bibfield{sorttitle} field. Please refer to \secref{use:srt} for further details. This field is consumed by the backend processing and does not appear in the \path{.bbl}. \fielditem{sortyear}{literal} @@ -1505,7 +1511,7 @@ The \bibtype{article} entry type makes use of the \bibfield{series} field as wel ... \end{lstlisting} % -This entry will be printed as «\emph{Journal Name}. 3rd ser. 15.7 (1995)». Some journals use designations such as «old series» and «new series» instead of a number. Such designations may be given in the \bibfield{series} field as well, either as a literal string or as a localization key. Consider the following example which makes use of the localization key \texttt{newseries}: +This entry will be printed as «\emph{Journal Name}. 3rd ser. 15.7 (1995)». Some journals use designations such as «old series» and «new series» instead of a number. Such designations may be given in the \bibfield{series} field as well, either as a literal string or as a localization key. Consider the following example which makes use of the localization key \texttt{newseries}: \begin{lstlisting}[style=bibtex]{} @Article{..., @@ -1516,7 +1522,7 @@ This entry will be printed as «\emph{Journal Name}. 3rd ser. 15.7 (1995)». Some ... \end{lstlisting} % -This entry will be printed as «\emph{Journal Name}. New ser. 9 (1998)». See \secref{aut:lng:key} for a list of localization keys defined by default. +This entry will be printed as «\emph{Journal Name}. New ser. 9 (1998)». See \secref{aut:lng:key} for a list of localization keys defined by default. \subsubsection{Date Specifications} \label{bib:use:dat} @@ -1701,7 +1707,7 @@ hash\_size & & 5000 & 10000 & 19000 & 35000 \\ Sorry---you've exceeded BibTeX's total number of fields 17250 \end{lstlisting} % -\Tabref{bib:cav:tab2} gives an overview of the various capacity parameters of \file{bibtex8} and the command"=line switches used to increase their default values. There are two ways to increase the capacity on the command"=line. You may use a high"=level switch like |--huge| to select a different set of defaults or low"=level switches such as |--mfields| to modify a single parameter. The first thing you should always do is run \file{bibtex8} with the |--wolfgang| switch. Don't even bother trying anything else. With a very large database, however, even that capacity may be too small. In this case, you need to resort to the low"=level switches. Here is an example of a set of switches which should cope with a \file{bib} file containing about 1000 entries: +\Tabref{bib:cav:tab2} gives an overview of the various capacity parameters of \file{bibtex8} and the command"=line switches used to increase their default values. There are two ways to increase the capacity on the command"=line. You may use a high"=level switch like |--huge| to select a different set of defaults or low"=level switches such as |--mfields| to modify a single parameter. The first thing you should always do is run \file{bibtex8} with the |--wolfgang| switch. Don't even bother trying anything else. With a very large database, however, even that capacity may be too small. In this case, you need to resort to the low"=level switches. Here is an example of a set of switches which should cope with a \file{bib} file containing about 1000 entries: \begin{lstlisting}[style=plain]{} bibtex8 --wolfgang --mcites 30000 --mentints 30000 --mentstrs 40000 @@ -1719,7 +1725,7 @@ When taking a closer look at \tabref{bib:cav:tab2}, you will notice that there a \paragraph{\bibtex} \label{bib:cav:enc:btx} -Traditional \bibtex can only alphabetize Ascii characters correctly. If the bibliographic data includes non"=Ascii characters, they have to be given in Ascii notation. For example, instead of typing a letter like <ä> directly, you need to input it as |\"a|, using an accent command and the Ascii letter. This Ascii notation needs to be wrapped in a pair of curly braces. Traditional \bibtex will then ignore the accent and use the Ascii letter for sorting. Here are a few examples: +Traditional \bibtex can only alphabetize Ascii characters correctly. If the bibliographic data includes non"=Ascii characters, they have to be given in Ascii notation. For example, instead of typing a letter like <ä> directly, you need to input it as |\"a|, using an accent command and the Ascii letter. This Ascii notation needs to be wrapped in a pair of curly braces. Traditional \bibtex will then ignore the accent and use the Ascii letter for sorting. Here are a few examples: \begin{lstlisting}[style=bibtex,upquote]{} author = {S<<{\'a}>>nchez, Jos<<{\'e}>>}, @@ -1728,20 +1734,20 @@ translator = {Ferdi<<{\`e}>>re, Fr<<{\c{c}}>>ois}, title = {<<{\OE}>>uvres compl<<{\`e}>>tes}, \end{lstlisting} % -Apart from it being inconvenient, there are two major issues with this convention. One subtle problem is that the extra set of braces suppresses the kerning on both sides of all non"=Ascii letters. But first and foremost, simply ignoring all accents may not be the correct way to handle them. For example, in Danish, the letter <å> is the very last letter of the alphabet, so it should be alphabetized after <z>. \bibtex will sort it like an <a>. The <æ> ligature and the letter <ø> are also sorted after <z> in this language. There are similar cases in Norwegian. In Swedish, the letter <ö> is the very last letter of the alphabet and the letters <å> and <ä> are also alphabetized after <z>, rather than like an <a>. What's more, even the sorting of Ascii characters is done in a rather peculiar way by traditional \bibtex because the sorting algorithm uses Ascii codepage order (\texttt{0-9,A-Z,a-z}). This implies that the lowercase letter <a> would end up after the uppercase <Z>, which is not even acceptable in the language \bibtex was originally designed for. The traditional \file{bst} files work around this problem by converting all strings used for sorting to lowercase, \ie sorting is effectively case"=insensitive. See also \secref{bib:cav:enc:enc}. +Apart from it being inconvenient, there are two major issues with this convention. One subtle problem is that the extra set of braces suppresses the kerning on both sides of all non"=Ascii letters. But first and foremost, simply ignoring all accents may not be the correct way to handle them. For example, in Danish, the letter <Ã¥> is the very last letter of the alphabet, so it should be alphabetized after <z>. \bibtex will sort it like an <a>. The <æ> ligature and the letter <ø> are also sorted after <z> in this language. There are similar cases in Norwegian. In Swedish, the letter <ö> is the very last letter of the alphabet and the letters <Ã¥> and <ä> are also alphabetized after <z>, rather than like an <a>. What's more, even the sorting of Ascii characters is done in a rather peculiar way by traditional \bibtex because the sorting algorithm uses Ascii codepage order (\texttt{0-9,A-Z,a-z}). This implies that the lowercase letter <a> would end up after the uppercase <Z>, which is not even acceptable in the language \bibtex was originally designed for. The traditional \file{bst} files work around this problem by converting all strings used for sorting to lowercase, \ie sorting is effectively case"=insensitive. See also \secref{bib:cav:enc:enc}. \paragraph{\file{bibtex8}} \label{bib:cav:enc:bt8} Switching to \file{bibtex8} will help in such cases. \file{bibtex8} can sort case"=sensitively and it can handle 8-bit characters properly, provided that you supply it with a suitable \file{csf} file and give the |--csfile| switch on the command line. This also implies that it is possible to apply language specific sorting rules to the bibliography. The \sty{biblatex} package comes with \file{csf} files for some common Western European encodings. \bin{bibtex8} also ships with a few \file{csf} files. Note that \file{biblatex.bst} can not detect if it is running under traditional \bibtex or \file{bibtex8}, hence the \opt{bibtex8} package option. By default, sorting is case-insensitive since this is required for traditional \bibtex. If the \opt{bibtex8} package option is enabled, sorting is case-sensitive. -Since \file{bibtex8} is backwards compatible with traditional \bibtex, it is possible to mix 8-bit input and Ascii notation. This is useful if the encoding used in the \file{bib} file does not cover all required characters. There are also a few marginal cases in which the Ascii notation scheme would yield better sorting results. A typical example is the ligature <½>. \file{bibtex8} will handle this ligature like a single character. Depending on the sorting scheme defined in the \file{csf} file, it could be treated like an <o> or alphabetized after the letter <o> but it can not be sorted as <oe>. The Ascii notation (|\oe|) is equivalent to <oe> during sorting: +Since \file{bibtex8} is backwards compatible with traditional \bibtex, it is possible to mix 8-bit input and Ascii notation. This is useful if the encoding used in the \file{bib} file does not cover all required characters. There are also a few marginal cases in which the Ascii notation scheme would yield better sorting results. A typical example is the ligature <Å“>. \file{bibtex8} will handle this ligature like a single character. Depending on the sorting scheme defined in the \file{csf} file, it could be treated like an <o> or alphabetized after the letter <o> but it can not be sorted as <oe>. The Ascii notation (|\oe|) is equivalent to <oe> during sorting: \begin{lstlisting}[style=bibtex,upquote]{} -title = {<<¼>>uvres compl<<è>>tes}, -title = {<<{\OE}>>uvres compl<<è>>tes}, +title = {<<Å’>>uvres compl<<è>>tes}, +title = {<<{\OE}>>uvres compl<<è>>tes}, \end{lstlisting} % -Sometimes even that is not sufficient and further tricks are required. For example, the letter <ß> in German is particularly tricky. This letter is essentially alphabetized as <ss> but after <ss>. The name <Baßmann> would be alphabetized as follows: Basmann\slash Bassmann\slash Baßmann\slash Bastmann. In this case, the Ascii notation (|\ss|) would yield slightly better sorting results than <ß> in conjunction with a \file{csf} file which treats <ß> like <s>: +Sometimes even that is not sufficient and further tricks are required. For example, the letter <ß> in German is particularly tricky. This letter is essentially alphabetized as <ss> but after <ss>. The name <Baßmann> would be alphabetized as follows: Basmann\slash Bassmann\slash Baßmann\slash Bastmann. In this case, the Ascii notation (|\ss|) would yield slightly better sorting results than <ß> in conjunction with a \file{csf} file which treats <ß> like <s>: \begin{lstlisting}[style=bibtex,upquote]{} author = {Ba<<{\ss}>>mann, Paul}, @@ -1750,7 +1756,7 @@ author = {Ba<<{\ss}>>mann, Paul}, To get it absolutely right, however, you need to resort to the \bibfield{sortname} field: \begin{lstlisting}[style=bibtex,upquote]{} -author = {Ba<<ß>>mann, Paul}, +author = {Ba<<ß>>mann, Paul}, sortname = {Ba<<sszz>>mann, Paul}, \end{lstlisting} % @@ -1759,7 +1765,7 @@ Not only \bibtex, \latex needs to know about the encoding as well. See \secref{b \paragraph{\biber} \biber handles Ascii, 8-bit encodings such as Latin\,1, and \utf. It features true Unicode support and is capable of reencoding the \file{bib} data on the fly in a robust way. For sorting, \biber uses a Perl implementation of the Unicode Collation Algorithm (\acr{UCA}), as outlined in Unicode Technical Standard \#10.\fnurl{http://unicode.org/reports/tr10/} Collation tailoring based on the Unicode Common Locale Data Repository (\acr{CLDR}) is also supported.\fnurl{http://cldr.unicode.org/} The bottom line is that \biber will deliver sorting results far superior to both \bibtex and \file{bibtex8} in many cases. If you are interested in the technical details, section 1.8 of Unicode Technical Standard \#10 will provide you with a very concise summary of why the inadequateness of traditional \bibtex and even \bin{bibtex8} is of a very general nature and not limited to the lack of \utf support.\fnurl{http://unicode.org/reports/tr10/#Common_Misperceptions} -Supporting Unicode implies much more than handling \utf input. Unicode is a complex standard covering more than its most well-known parts, the Unicode character encoding and transport encodings such as \utf. It also standardizes aspects such as string collation, which is required for language-sensitive sorting. For example, by using the Unicode Collation Algorithm, \biber can handle the character <ß> mentioned as an example in \secref{bib:cav:enc:bt8} without any manual intervention. All you need to do to get localized sorting is specify the locale: +Supporting Unicode implies much more than handling \utf input. Unicode is a complex standard covering more than its most well-known parts, the Unicode character encoding and transport encodings such as \utf. It also standardizes aspects such as string collation, which is required for language-sensitive sorting. For example, by using the Unicode Collation Algorithm, \biber can handle the character <ß> mentioned as an example in \secref{bib:cav:enc:bt8} without any manual intervention. All you need to do to get localized sorting is specify the locale: \begin{lstlisting}[style=latex]{} \usepackage[backend=biber,sortlocale=de]{biblatex} @@ -1880,6 +1886,18 @@ If this option is enabled, \sty{biblatex} will ignore \sty{inputenc}'s \opt{utf8 This solution may be acceptable as a workaround if the data in the \file{bib} file is mostly Ascii anyway, with only a few strings, such as some authors' names, causing problems. However, keep in mind that it will not magically make traditional \tex or \pdftex support Unicode. It may help if the occasional odd character is not supported by \sty{inputenc}, but may still be processed by \tex when using an accent command (\eg |\d{S}| instead of \texttt{\d{S}}). If you need full Unicode support, however, switch to \xetex or \luatex. +Typical errors when \sty{inputenc} cannot handle a certain UTF-8 character are: + +\begin{verbatim} +Package inputenc Error: Unicode char \u8: not set up for use with LaTeX +\end{verbatim} +% +but also less obvious things like: + +\begin{verbatim} +! Argument of \UTFviii@three@octets has an extra }. +\end{verbatim} + \subsubsection{Editors and Compiler Scripts} \label{bib:cav:ide} @@ -1996,7 +2014,7 @@ The sorting order of the list of shorthands. The following choices are available The sorting order of shorthands with \biber is more flexible and is set with the \opt{sorting} option to the \cmd{printshorthands} command. -\boolitem[true]{related} +\boolitem[true]{related}[\BiberOnly] Whether or not to use information from related entries or not. See \secref{use:rel}. @@ -2050,13 +2068,13 @@ This option controls multilingual support. When set to \opt{auto}, \sty{biblatex \begin{table} \tablesetup -\begin{tabularx}{\textwidth}{@{}p{100pt}@{}p{100pt}@{}>{\ttfamily}X@{}} +\begin{tabularx}{\textwidth}{@{}p{100pt}@{}p{150pt}@{}>{\ttfamily}X@{}} \toprule \multicolumn{1}{@{}H}{Language} & \multicolumn{1}{@{}H}{Region/Dialect} & \multicolumn{1}{@{}H}{Identifier} \\ \cmidrule(r){1-1}\cmidrule(r){2-2}\cmidrule{3-3} -Catalan & Andorra, Balearic islands, Catalonia, Valencia, Roussillon & catalan \\ +Catalan & Spain, France, Andorra, Italy & catalan \\ Czech & Czech Republic & czech \\ Danish & Denmark & danish \\ Dutch & Netherlands & dutch \\ @@ -2269,6 +2287,10 @@ January 21--30, 2010\par % As seen in the above examples, the actual date format is language specific. Note that the month name in all long formats is responsive to the \opt{abbreviate} package option. The leading zeros in all short formats may be controlled separately with the \opt{datezeros} package option. +\optitem[comp]{datelabel}{\opt{short}, \opt{long}, \opt{terse}, \opt{comp}, \opt{iso8601}} + +Similar to the \opt{date} option but controls the format of the date field selected with \cmd{DeclareLabeldate}. + \optitem[comp]{origdate}{\opt{short}, \opt{long}, \opt{terse}, \opt{comp}, \opt{iso8601}} Similar to the \opt{date} option but controls the format of the \bibfield{origdate}. @@ -2295,7 +2317,7 @@ This option controls whether \texttt{long} and \texttt{comp} dates are printed w \boolitem[false]{defernumbers} -In contrast to standard \latex, the numeric labels generated by this package are normally assigned to the full list of references at the beginning of the document body. If this option is enabled, numeric labels (\ie the \bibfield{labelnumber} field discussed in \secref{aut:bbx:fld}) are assigned the first time an entry is printed in any bibliography. See \secref{use:cav:lab} for further explanation. This option requires two \latex runs after the data has been exported to the \file{bbl} file by the backend. See \secref{aut:int}. +In contrast to standard \latex, the numeric labels generated by this package are normally assigned to the full list of references at the beginning of the document body. If this option is enabled, numeric labels (\ie the \bibfield{labelnumber} field discussed in \secref{aut:bbx:fld}) are assigned the first time an entry is printed in any bibliography. See \secref{use:cav:lab} for further explanation. This option requires two \latex runs after the data has been exported to the \file{bbl} file by the backend (in addition to any other runs required by page breaks changing etc.). An important thing to note is that if you change the value of this option in your document (or the value of options which depend on this like some of the options to the \cmd{printbibliography} macro, see \secref{use:bib:bib}), then it is likely that you will need to delete your current \file{aux} file and re-run \latex to obtain the correct numbering. See \secref{aut:int}. \boolitem[false]{punctfont} @@ -2433,7 +2455,7 @@ This option controls the <ibidem> tracker which is required by the \cmd{ifciteib \item[true] Enable the tracker in global mode. \item[false] Disable the tracker. \item[context] Enable the tracker in context"=sensitive mode. In this mode, citations in footnotes and in the body text are tracked separately. -\item[strict] Enable the tracker in strict mode. In this mode, potentially ambiguous references are suppressed. A reference is considered ambiguous if either the current citation (the one including the <ibidem>) or the previous citation (the one the <ibidem> refers to) consists of a list of references.\footnote{For example, suppose the initial citation is «Jones, \emph{Title}; Williams, \emph{Title}» and the following one «ibidem». From a technical point of view, it is fairly clear that the <ibidem> refers to <Williams> because this is the last reference processed by the previous citation command. To a human reader, however, this may not be obvious because the <ibidem> may also refer to both titles. The strict mode avoids such ambiguous references.} +\item[strict] Enable the tracker in strict mode. In this mode, potentially ambiguous references are suppressed. A reference is considered ambiguous if either the current citation (the one including the <ibidem>) or the previous citation (the one the <ibidem> refers to) consists of a list of references.\footnote{For example, suppose the initial citation is «Jones, \emph{Title}; Williams, \emph{Title}» and the following one «ibidem». From a technical point of view, it is fairly clear that the <ibidem> refers to <Williams> because this is the last reference processed by the previous citation command. To a human reader, however, this may not be obvious because the <ibidem> may also refer to both titles. The strict mode avoids such ambiguous references.} \item[constrict] This mode combines the features of \opt{context} and \opt{strict}. It also keeps track of footnote numbers and detects potentially ambiguous references in footnotes in a stricter way than the \opt{strict} option. In addition to the conditions imposed by the \opt{strict} option, a reference in a footnote will only be considered as unambiguous if the current citation and the previous citation are given in the same footnote or in immediately consecutive footnotes. \end{valuelist} @@ -2527,9 +2549,9 @@ Whether or not to provide the special field \bibfield{extratitle}, see \secref{a Whether or not to provide the special field \bibfield{extratitleyear}, see \secref{aut:bbx:fld} for details. Note that the special field \bibfield{labeltitle} is always provided and this option controls rather whether \bibfield{labeltitle} is used to generate \bibfield{extratitleyear} information. This option is also settable on a per-type basis. Table \ref{use:opt:tab2} summarises the various \opt{extra*} disambiguation counters and what they track. -\boolitem[false]{labelyear} +\boolitem[false]{labeldate} -Whether or not to provide the special fields \bibfield{labelyear} and \bibfield{extrayear}, see \secref{aut:bbx:fld} for details. +Whether or not to provide the special fields \bibfield{labelyear}, \bibfield{labelmonth}, \bibfield{labelday} and \bibfield{extrayear}, see \secref{aut:bbx:fld} for details. \BiberOnlyMark With \biber, this option is also settable on a per-type basis. Table \ref{use:opt:tab2} summarises the various \opt{extra*} disambiguation counters and what they track. \boolitem[false]{singletitle} @@ -2562,7 +2584,7 @@ Whether or not to update the \cnt{uniquelist} counter, see \secref{aut:aux:tst} \begin{valuelist} \item[true] Disambiguate the \bibfield{labelname} list. \item[false] Disable this feature. -\item[minyear] Disambiguate the \bibfield{labelname} list only if the truncated list is identical to another one with the same \bibfield{labelyear}. This mode of operation is useful for author-year styles and requires \kvopt{labelyear}{true}. +\item[minyear] Disambiguate the \bibfield{labelname} list only if the truncated list is identical to another one with the same \bibfield{labelyear}. This mode of operation is useful for author-year styles and requires \kvopt{labeldate}{true}. \end{valuelist} % Note that the \opt{uniquelist} option will also affect the \cmd{ifsingletitle} test and the \bibfield{extrayear} field. See \secref{aut:cav:amb} for further details and practical examples. See \secref{aut:cav:amb} for further details and practical examples. @@ -2580,7 +2602,7 @@ Note that the \opt{uniquelist} option will also affect the \cmd{ifsingletitle} t \multicolumn{1}{@{}H}{Counter tracks} \\ \cmidrule(r){1-1}\cmidrule(r){2-2}\cmidrule(r){3-3}\cmidrule{4-4} labelalpha & labelalpha & extraalpha & label\\ -labelyear & labelyear & extrayear & labelname+labelyear\\ +labeldate & labelyear & extrayear & labelname+labelyear\\ labeltitle & --- & extratitle & labelname+labeltitle\\ labeltitleyear & --- & extratitleyear & labeltitle+labelyear\\ \bottomrule @@ -2628,7 +2650,7 @@ With the standard styles, the \bibfield{translator} is printed after the title b \boolitem[false]{useprefix} -Whether the name prefix (von, van, of, da, de, della, etc.) is considered when printing the last name in citations. This also affects the sorting and formatting of the bibliography as well as the generation of certain types of labels. If this option is enabled, \sty{biblatex} always precedes the last name with the prefix. For example, Ludwig van Beethoven would be cited as «Beethoven» and alphabetized as «Beethoven, Ludwig van» by default. If this option is enabled, he is cited as «van Beethoven» and alphabetized as «Van Beethoven, Ludwig» instead. +Whether the name prefix (von, van, of, da, de, della, etc.) is considered when printing the last name in citations. This also affects the sorting and formatting of the bibliography as well as the generation of certain types of labels. If this option is enabled, \sty{biblatex} always precedes the last name with the prefix. For example, Ludwig van Beethoven would be cited as «Beethoven» and alphabetized as «Beethoven, Ludwig van» by default. If this option is enabled, he is cited as «van Beethoven» and alphabetized as «Van Beethoven, Ludwig» instead. \BiberOnlyMark With \biber, this option is also settable on a per-type basis. \optitem{indexing}{\opt{true}, \opt{false}, \opt{cite}, \opt{bib}} @@ -2736,37 +2758,37 @@ The citation styles which come with this package implement several common citati \begin{marglist} \item[numeric] -This style implements a numeric citation scheme similar to the standard bibliographic facilities of \latex. It should be employed in conjunction with a numeric bibliography style which prints the corresponding labels in the bibliography. It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelnumber}{true}. This style also provides an additional preamble option called \opt{subentry} which affects the handling of entry sets. If this option is disabled, citations referring to a member of a set will point to the entire set. If it is enabled, the style supports citations like «[5c]» which point to a subentry in a set (the third one in this example). See the style example for details. +This style implements a numeric citation scheme similar to the standard bibliographic facilities of \latex. It should be employed in conjunction with a numeric bibliography style which prints the corresponding labels in the bibliography. It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelnumber}{true}. This style also provides an additional preamble option called \opt{subentry} which affects the handling of entry sets. If this option is disabled, citations referring to a member of a set will point to the entire set. If it is enabled, the style supports citations like «[5c]» which point to a subentry in a set (the third one in this example). See the style example for details. \item[numeric-comp] -A compact variant of the \texttt{numeric} style which prints a list of more than two consecutive numbers as a range. This style is similar to the \sty{cite} package and the \opt{sort\&compress} option of the \sty{natbib} package in numerical mode. For example, instead of «[8, 3, 1, 7, 2]» this style would print «[1--3, 7, 8]». It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{sortcites}{true}, \kvopt{labelnumber}{true}. It also provides the \opt{subentry} option. +A compact variant of the \texttt{numeric} style which prints a list of more than two consecutive numbers as a range. This style is similar to the \sty{cite} package and the \opt{sort\&compress} option of the \sty{natbib} package in numerical mode. For example, instead of «[8, 3, 1, 7, 2]» this style would print «[1--3, 7, 8]». It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{sortcites}{true}, \kvopt{labelnumber}{true}. It also provides the \opt{subentry} option. \item[numeric-verb] -A verbose variant of the \texttt{numeric} style. The difference affects the handling of a list of citations and is only apparent when multiple entry keys are passed to a single citation command. For example, instead of «[2, 5, 6]» this style would print «[2]; [5]; [6]». It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelnumber}{true}. It also provides the \opt{subentry} option. +A verbose variant of the \texttt{numeric} style. The difference affects the handling of a list of citations and is only apparent when multiple entry keys are passed to a single citation command. For example, instead of «[2, 5, 6]» this style would print «[2]; [5]; [6]». It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelnumber}{true}. It also provides the \opt{subentry} option. \item[alphabetic] -This style implements an alphabetic citation scheme similar to the \path{alpha.bst} style of traditional \bibtex. The alphabetic labels resemble a compact author"=year style to some extent, but the way they are employed is similar to a numeric citation scheme. For example, instead of «Jones 1995» this style would use the label «[Jon95]». «Jones and Williams 1986» would be rendered as «[JW86]». This style should be employed in conjunction with an alphabetic bibliography style which prints the corresponding labels in the bibliography. It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelalpha}{true}. +This style implements an alphabetic citation scheme similar to the \path{alpha.bst} style of traditional \bibtex. The alphabetic labels resemble a compact author"=year style to some extent, but the way they are employed is similar to a numeric citation scheme. For example, instead of «Jones 1995» this style would use the label «[Jon95]». «Jones and Williams 1986» would be rendered as «[JW86]». This style should be employed in conjunction with an alphabetic bibliography style which prints the corresponding labels in the bibliography. It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelalpha}{true}. \item[alphabetic-verb] -A verbose variant of the \texttt{alphabetic} style. The difference affects the handling of a list of citations and is only apparent when multiple entry keys are passed to a single citation command. For example, instead of «[Doe92; Doe95; Jon98]» this style would print «[Doe92]; [Doe95]; [Jon98]». It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelalpha}{true}. +A verbose variant of the \texttt{alphabetic} style. The difference affects the handling of a list of citations and is only apparent when multiple entry keys are passed to a single citation command. For example, instead of «[Doe92; Doe95; Jon98]» this style would print «[Doe92]; [Doe95]; [Jon98]». It is intended for in-text citations. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelalpha}{true}. \item[authoryear] -This style implements an author"=year citation scheme. If the bibliography contains two or more works by the same author which were all published in the same year, a letter is appended to the year. For example, this style would print citations such as «Doe 1995a; Doe 1995b; Jones 1998». This style should be employed in conjunction with an author"=year bibliography style which prints the corresponding labels in the bibliography. It is primarily intended for in-text citations, but it could also be used with citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}. +This style implements an author"=year citation scheme. If the bibliography contains two or more works by the same author which were all published in the same year, a letter is appended to the year. For example, this style would print citations such as «Doe 1995a; Doe 1995b; Jones 1998». This style should be employed in conjunction with an author"=year bibliography style which prints the corresponding labels in the bibliography. It is primarily intended for in-text citations, but it could also be used with citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labeldate}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}. \item[authoryear-comp] -A compact variant of the \texttt{authoryear} style which prints the author only once if subsequent references passed to a single citation command share the same author. If they share the same year as well, the year is also printed only once. For example, instead of «Doe 1995b; Doe 1992; Jones 1998; Doe 1995a» this style would print «Doe 1992, 1995a,b; Jones 1998». It is primarily intended for in-text citations, but it could also be used with citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{sortcites}{true}, \kvopt{labelyear}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}. +A compact variant of the \texttt{authoryear} style which prints the author only once if subsequent references passed to a single citation command share the same author. If they share the same year as well, the year is also printed only once. For example, instead of «Doe 1995b; Doe 1992; Jones 1998; Doe 1995a» this style would print «Doe 1992, 1995a,b; Jones 1998». It is primarily intended for in-text citations, but it could also be used with citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{sortcites}{true}, \kvopt{labeldate}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}. \item[authoryear-ibid] -A variant of the \texttt{authoryear} style which replaces repeated citations by the abbreviation \emph{ibidem} unless the citation is the first one on the current page or double-page spread, or the \emph{ibidem} would be ambiguous in the sense of the package option \kvopt{ibidtracker}{constrict}. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details. +A variant of the \texttt{authoryear} style which replaces repeated citations by the abbreviation \emph{ibidem} unless the citation is the first one on the current page or double-page spread, or the \emph{ibidem} would be ambiguous in the sense of the package option \kvopt{ibidtracker}{constrict}. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labeldate}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details. \item[authoryear-icomp] -A style combining \texttt{authoryear-comp} and \texttt{authoryear-ibid}. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labelyear}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}, \kvopt{sortcites}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details. +A style combining \texttt{authoryear-comp} and \texttt{authoryear-ibid}. The style will set the following package options at load time: \kvopt{autocite}{inline}, \kvopt{labeldate}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}, \kvopt{sortcites}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details. \item[authortitle] This style implements a simple author"=title citation scheme. It will make use of the \bibfield{shorttitle} field, if available. It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}. \item[authortitle-comp] -A compact variant of the \texttt{authortitle} style which prints the author only once if subsequent references passed to a single citation command share the same author. For example, instead of «Doe, \emph{First title}; Doe, \emph{Second title}» this style would print «Doe, \emph{First title}, \emph{Second title}». It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{sortcites}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}. +A compact variant of the \texttt{authortitle} style which prints the author only once if subsequent references passed to a single citation command share the same author. For example, instead of «Doe, \emph{First title}; Doe, \emph{Second title}» this style would print «Doe, \emph{First title}, \emph{Second title}». It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{sortcites}{true}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}. \item[authortitle-ibid] A variant of the \texttt{authortitle} style which replaces repeated citations by the abbreviation \emph{ibidem} unless the citation is the first one on the current page or double-page spread, or the \emph{ibidem} would be ambiguous in the sense of the package option \kvopt{ibidtracker}{constrict}. It is intended for citations given in footnotes. The style will set the following package options at load time: \kvopt{autocite}{footnote}, \kvopt{uniquename}{full}, \kvopt{uniquelist}{true}, \kvopt{ibidtracker}{constrict}, \kvopt{pagetracker}{true}. This style also provides an additional preamble option called \opt{ibidpage}. See the style example for details. @@ -2835,7 +2857,7 @@ This style prints a numeric label similar to the standard bibliographic faciliti This style prints an alphabetic label similar to the \path{alpha.bst} style of traditional \bibtex. It is intended for use in conjunction with an alphabetic citation style. Note that the \bibfield{shorthand} field overrides the default label. The style will set the following package options at load time: \kvopt{labelalpha}{true}, \kvopt{sorting}{anyt}. \item[authoryear] -This style differs from the other styles in that the publication date is not printed towards the end of the entry but rather after the author\slash editor. It is intended for use in conjunction with an author"=year citation style. Recurring author and editor names are replaced by a dash unless the entry is the first one on the current page or double-page spread. This style provides an additional preamble option called \opt{dashed} which controls this feature. It also provided a preamble option called \opt{mergedate}. See the style example for details. The style will set the following package options at load time: \kvopt{labelyear}{true}, \kvopt{sorting}{nyt}, \kvopt{pagetracker}{true}, \kvopt{mergedate}{true}. +This style differs from the other styles in that the publication date is not printed towards the end of the entry but rather after the author\slash editor. It is intended for use in conjunction with an author"=year citation style. Recurring author and editor names are replaced by a dash unless the entry is the first one on the current page or double-page spread. This style provides an additional preamble option called \opt{dashed} which controls this feature. It also provided a preamble option called \opt{mergedate}. See the style example for details. The style will set the following package options at load time: \kvopt{labeldate}{true}, \kvopt{sorting}{nyt}, \kvopt{pagetracker}{true}, \kvopt{mergedate}{true}. \item[authortitle] This style does not print any label at all. It is intended for use in conjunction with an author"=title citation style. Recurring author and editor names are replaced by a dash unless the entry is the first one on the current page or double-page spread. This style also provides an additional preamble option called \opt{dashed} which controls this feature. See the style example for details. The style will set the following package options at load time: \kvopt{pagetracker}{true}. @@ -2863,7 +2885,7 @@ This style prints all bibliographic data in tabular format. It is intended for d \subsection{Related Entries} \label{use:rel} -Almost all bibliography styles require authors to specify certain types of relationship between entries such as «Reprint of», «Reprinted in» etc. It is impossible to provide data fields to cover all of these relationships and so \sty{biblatex} provides a general mechanism for this using the entry fields \bibfield{related}, \bibfield{relatedtype} and \bibfield{relatedstring}. A related entry does not need to be cited and does not appear in the bibliography itself (unless of course it is also cited itself independently) as a clone is taken of the related entry to be used as a data source. The \bibfield{relatedtype} field should specify a localization string which will be printed before the information from the related entries is printed, for example «Orig. Pub. as». The \bibfield{relatedstring} field can be used to override the string determined via \bibfield{relatedtype}. Some examples: +Almost all bibliography styles require authors to specify certain types of relationship between entries such as «Reprint of», «Reprinted in» etc. It is impossible to provide data fields to cover all of these relationships and so \sty{biblatex} provides a general mechanism for this using the entry fields \bibfield{related}, \bibfield{relatedtype} and \bibfield{relatedstring}. A related entry does not need to be cited and does not appear in the bibliography itself (unless of course it is also cited itself independently) as a clone is taken of the related entry to be used as a data source. The \bibfield{relatedtype} field should specify a localization string which will be printed before the information from the related entries is printed, for example «Orig. Pub. as». The \bibfield{relatedstring} field can be used to override the string determined via \bibfield{relatedtype}. Some examples: \begin{lstlisting}[style=bibtex]{} @Book{key1, @@ -2881,7 +2903,7 @@ Almost all bibliography styles require authors to specify certain types of relat Here we specify that entry \texttt{key1} is a reprint of entry \texttt{key2}. In the bibliography driver for \texttt{Book} entries, when \cmd{usebibmacro\{related\}} is called for entry \texttt{key1}: \begin{itemize} -\item If the localization string «\texttt{reprintof}» is defined, it is printed, then +\item If the localization string «\texttt{reprintof}» is defined, it is printed in the \texttt{relatedstring:reprintof} format. If this formatting directive is undefined, the string is printed in the \texttt{relatedstring:default} format. \item If the \texttt{related:reprintof} macro is defined, it is used to format the information contained in entry \texttt{key2}, otherwise the \texttt{related:default} macro is used \item If the \texttt{related:reprintof} format is defined, it is used to format both the localization string and data. If this format is not defined, then the \texttt{related} format is used instead. \end{itemize} @@ -3543,10 +3565,12 @@ The following commands are provided by the core of \sty{biblatex}. They are inte \begin{ltxsyntax} \cmditem{citeauthor}[prenote][postnote]{key} +\cmditem*{citeauthor*}[prenote][postnote]{key} \cmditem{Citeauthor}[prenote][postnote]{key} +\cmditem*{Citeauthor*}[prenote][postnote]{key} These commands print the authors. Strictly speaking, it prints the \bibfield{labelname} list, which may be the -\bibfield{author}, the \bibfield{editor}, or the \bibfield{translator}. \cmd{Citeauthor} is similar to \cmd{citeauthor} but capitalizes the name prefix of the first name in the citation if the \opt{useprefix} option is enabled, provided that there is a name prefix. +\bibfield{author}, the \bibfield{editor}, or the \bibfield{translator}. \cmd{Citeauthor} is similar to \cmd{citeauthor} but capitalizes the name prefix of the first name in the citation if the \opt{useprefix} option is enabled, provided that there is a name prefix. The starred variants effectively force maxcitenames to 1 for just this command on so only print the first name in the labelname list (potentially followed by the «et al» string if there are more names). This allows more natural textual flow when refering to a paper in the singular when otherwise \cmd{citeauthor} would generate a (naturally plural) list of names. \cmditem{citetitle}[prenote][postnote]{key} \cmditem*{citetitle*}[prenote][postnote]{key} @@ -3884,6 +3908,9 @@ The separator inserted between <units> in the sense explained in \secref{aut:pct \csitem{finentrypunct} The punctuation printed at the very end of every bibliography entry, usually a period. The default definition is a period. +\csitem{entrysetpunct}\BiberOnlyMark +The punctuation printed between bibliography subentries of an entry set. The default definition is a semicolon and a space. + \csitem{bibnamedelima}\BiberOnlyMark This delimiter controls the spacing between the elements which make up a name part. It is inserted automatically after the first name element if the element is less than three characters long and before the last element. The default definition is an interword space penalized by the value of the \cnt{highnamepenalty} counter (\secref{use:fmt:len}). Please refer to \secref{use:cav:nam} for further details. @@ -3951,7 +3978,7 @@ The separator printed after the name used for alphabetizing in the bibliography The separator printed between the fields \bibfield{title} and \bibfield{subtitle}, \bibfield{booktitle} and \bibfield{booksubtitle}, as well as \bibfield{maintitle} and \bibfield{mainsubtitle}. With the default styles, this separator replaces \cmd{newunitpunct} at this location. The default definition is \cmd{newunitpunct}, \ie it is not handled differently from regular unit punctuation. \csitem{intitlepunct} -The separator between the word «in» and the following title in entry types such as \bibtype{article}, \bibtype{inbook}, \bibtype{incollection}, etc. The default definition is a colon plus an interword space (\eg «Article, in: \emph{Journal}» or «Title, in: \emph{Book}»). Note that this is the separator string, not only the punctuation mark. If you don't want a colon after «in», \cmd{intitlepunct} should still insert a space. +The separator between the word «in» and the following title in entry types such as \bibtype{article}, \bibtype{inbook}, \bibtype{incollection}, etc. The default definition is a colon plus an interword space (\eg «Article, in: \emph{Journal}» or «Title, in: \emph{Book}»). Note that this is the separator string, not only the punctuation mark. If you don't want a colon after «in», \cmd{intitlepunct} should still insert a space. \csitem{bibpagespunct} The separator printed before the \bibfield{pages} field. The default is a comma plus an interword space. @@ -4141,15 +4168,15 @@ The horizontal space between entries and their corresponding labels in the bibli \lenitem{bibitemsep} -The vertical space between the individual entries in the bibliography. This length is initialized to \cmd{itemsep} at load-time. Note that \len{bibitemsep}, \len{bibnamesep}, and \len{bibinitsep} are cumulative. When they coincide, the largest value will be applied. +The vertical space between the individual entries in the bibliography. This length is initialized to \cmd{itemsep} at load-time. Note that \len{bibitemsep}, \len{bibnamesep}, and \len{bibinitsep} obey the rules for \cmd{addvspace}, that is, when vertical space introduced by any of these commands immediately follows on from space introduced by another of them, the resulting total space is equal to the largest of them. \lenitem{bibnamesep} -Vertical space to be inserted between two entries in the bibliography whenever an entry starts with a name which is different from the initial name of the previous entry. The default value is zero. Setting this length to a positive value greater than \len{bibitemsep} will group the bibliography by author\slash editor name. Note that \len{bibitemsep}, \len{bibnamesep}, and \len{bibinitsep} are cumulative. When they coincide, the largest value will be applied. +Vertical space to be inserted between two entries in the bibliography whenever an entry starts with a name which is different from the initial name of the previous entry. The default value is zero. Setting this length to a positive value greater than \len{bibitemsep} will group the bibliography by author\slash editor name. Note that \len{bibitemsep}, \len{bibnamesep}, and \len{bibinitsep} obey the rules for \cmd{addvspace}, that is, when vertical space introduced by any of these commands immediately follows on from space introduced by another of them, the resulting total space is equal to the largest of them. \lenitem{bibinitsep} -Vertical space to be inserted between two entries in the bibliography whenever an entry starts with a letter which is different from the initial letter of the previous entry. The default value is zero. Setting this length to a positive value greater than \len{bibitemsep} will group the bibliography alphabetically. Note that \len{bibitemsep}, \len{bibnamesep}, and \len{bibinitsep} are cumulative. When they coincide, the largest value will be applied. +Vertical space to be inserted between two entries in the bibliography whenever an entry starts with a letter which is different from the initial letter of the previous entry. The default value is zero. Setting this length to a positive value greater than \len{bibitemsep} will group the bibliography alphabetically. Note that \len{bibitemsep}, \len{bibnamesep}, and \len{bibinitsep} obey the rules for \cmd{addvspace}, that is, when vertical space introduced by any of these commands immediately follows on from space introduced by another of them, the resulting total space is equal to the largest of them. \lenitem{bibparsep} @@ -4157,7 +4184,7 @@ The vertical space between paragraphs within an entry in the bibliography. The d \cntitem{abbrvpenalty} -This counter, which is used by the localization modules, holds the penalty used in short or abbreviated localization strings. For example, a linebreak in expressions such as «et al.» or «ed. by» is unfortunate, but should still be possible to prevent overfull boxes. This counter is initialized to \cmd{hyphenpenalty} at load-time. The idea is making \tex treat the whole expression as if it were a single, hyphenatable word as far as line"=breaking is concerned. If you dislike such linebreaks, use a higher value. If you do not mind them at all, set this counter to zero. If you want to suppress them unconditionally, set it to <infinite> (10\,000 or higher).\footnote{The default values assigned to \cnt{abbrvpenalty}, \cnt{lownamepenalty}, and \cnt{highnamepenalty} are deliberately very low to prevent overfull boxes. This implies that you will hardly notice any effect on line-breaking if the text is set justified. If you set these counters to 10\,000 to suppress the respective breakpoints, you will notice their effect but you may also be confronted with overfull boxes. Keep in mind that line-breaking in the bibliography is often more difficult than in the body text and that you can not resort to rephrasing a sentence. In some cases it may be preferable to set the entire bibliography \cmd{raggedright} to prevent suboptimal linebreaks. In this case, even the fairly low default penalties will make a visible difference.} +This counter, which is used by the localization modules, holds the penalty used in short or abbreviated localization strings. For example, a linebreak in expressions such as «et al.» or «ed. by» is unfortunate, but should still be possible to prevent overfull boxes. This counter is initialized to \cmd{hyphenpenalty} at load-time. The idea is making \tex treat the whole expression as if it were a single, hyphenatable word as far as line"=breaking is concerned. If you dislike such linebreaks, use a higher value. If you do not mind them at all, set this counter to zero. If you want to suppress them unconditionally, set it to <infinite> (10\,000 or higher).\footnote{The default values assigned to \cnt{abbrvpenalty}, \cnt{lownamepenalty}, and \cnt{highnamepenalty} are deliberately very low to prevent overfull boxes. This implies that you will hardly notice any effect on line-breaking if the text is set justified. If you set these counters to 10\,000 to suppress the respective breakpoints, you will notice their effect but you may also be confronted with overfull boxes. Keep in mind that line-breaking in the bibliography is often more difficult than in the body text and that you can not resort to rephrasing a sentence. In some cases it may be preferable to set the entire bibliography \cmd{raggedright} to prevent suboptimal linebreaks. In this case, even the fairly low default penalties will make a visible difference.} \cntitem{highnamepenalty} @@ -4226,13 +4253,13 @@ will yield <Special issue> or <special issue>, as appropriate. If the string to \autocap{\'e}dition sp\'eciale \end{lstlisting} % -This will yield <Édition spéciale> or <édition spéciale>. If the string to be capitalized starts with a command which prints a character, such as \cmd{ae} or \cmd{oe}, simply put the command in the \prm{character} argument: +This will yield <Édition spéciale> or <édition spéciale>. If the string to be capitalized starts with a command which prints a character, such as \cmd{ae} or \cmd{oe}, simply put the command in the \prm{character} argument: \begin{lstlisting}[style=latex]{} \autocap{\oe}uvres \end{lstlisting} % -This will yield <¼uvres> or <½uvres>. +This will yield <Å’uvres> or <Å“uvres>. \end{ltxsyntax} @@ -4339,7 +4366,7 @@ With traditional \bibtex, the \cmd{bibliography} command serves two purposes. It Whenever a reference to a work which has not been cited before is added, this procedure must be repeated. This is also the case if the last reference to a work which has been cited before is removed because some citation labels may change in this case. In contrast to traditional \bibtex, there is normally no need to run \bin{latex} twice after running the backend as far as the handling of bibliographic data is concerned.\footnote{That is, unless the \opt{defernumbers} package option is enabled. See \secref{aut:int}} -\BibTeXOnlyMark Note that when using \bibtex as the backend this only applies to the most basic case. Using the \bibfield{xref} field or the \bibfield{entryset} field may require an additional \latex/\bibtex/\latex cycle. Some other facilities provided by \sty{biblatex} may also require an additional \bin{latex} run to get certain references and the page tracking right. In this case, the usual warning messages such as «There were undefined references» and «Label(s) may have changed. Rerun to get cross-references right» will be printed. +\BibTeXOnlyMark Note that when using \bibtex as the backend this only applies to the most basic case. Using the \bibfield{xref} field or the \bibfield{entryset} field may require an additional \latex/\bibtex/\latex cycle. Some other facilities provided by \sty{biblatex} may also require an additional \bin{latex} run to get certain references and the page tracking right. In this case, the usual warning messages such as «There were undefined references» and «Label(s) may have changed. Rerun to get cross-references right» will be printed. \subsubsection{Auxiliary Files} \label{use:use:aux} @@ -4420,7 +4447,7 @@ If \cmd{printbibliography} is used inside a \env{refsection} environment, it aut \end{document} \end{ltxexample} % -Note the definition of the bibliography heading in the above example. This is the definition taking care of the subheadings in the bibliography. The main heading is generated with a plain \cmd{chapter} command in this case. The \sty{biblatex} package automatically sets a label at the beginning of every \env{refsection} environment, using the standard \cmd{label} command. The identifier used is the string \texttt{refsection:} followed by the number of the respective \env{refsection} environment. The number of the current section is accessible via the \cnt{refsection} counter. When using the \opt{section} option of \cmd{printbibliography}, this counter is also set locally. This means that you may use the counter in heading definitions to print subheadings like «References for Chapter 3», as shown above. You could also use the title of the respective chapter as a subheading by loading the \sty{nameref} package and using \cmd{nameref} instead of \cmd{ref}: +Note the definition of the bibliography heading in the above example. This is the definition taking care of the subheadings in the bibliography. The main heading is generated with a plain \cmd{chapter} command in this case. The \sty{biblatex} package automatically sets a label at the beginning of every \env{refsection} environment, using the standard \cmd{label} command. The identifier used is the string \texttt{refsection:} followed by the number of the respective \env{refsection} environment. The number of the current section is accessible via the \cnt{refsection} counter. When using the \opt{section} option of \cmd{printbibliography}, this counter is also set locally. This means that you may use the counter in heading definitions to print subheadings like «References for Chapter 3», as shown above. You could also use the title of the respective chapter as a subheading by loading the \sty{nameref} package and using \cmd{nameref} instead of \cmd{ref}: \begin{lstlisting}[style=latex] \usepackage{<<nameref>>} @@ -4583,7 +4610,7 @@ The handling of the headings is different from \cmd{bibbysection} and \cmd{bibby \subsubsection{Entry Sets} \label{use:use:set} -An entry set is a group of entries which are cited as a single reference and listed as a single item in the bibliography. The \sty{biblatex} package supports two types of entry sets. Static entry sets are defined in the \file{bib} file like any other entry. Dynamic entry sets are defined with \cmd{defbibentryset} (\secref{use:bib:set}) on a per-document\slash per-refsection basis in the document preamble or the document body. This section deals with the definition of entry sets; style authors should also see \secref{aut:cav:set} for further information. +An entry set is a group of entries which are cited as a single reference and listed as a single item in the bibliography. The individual entries in the set are separated by \cmd{entrysetpunct} (\secref{aut:fmt:fmt}). The individual entries in the set are separated by \cmd{entrysetpunct} (\secref{aut:fmt:fmt}). The \sty{biblatex} package supports two types of entry sets. Static entry sets are defined in the \file{bib} file like any other entry. Dynamic entry sets are defined with \cmd{defbibentryset} (\secref{use:bib:set}) on a per-document\slash per-refsection basis in the document preamble or the document body. This section deals with the definition of entry sets; style authors should also see \secref{aut:cav:set} for further information. \paragraph{Static entry sets} @@ -4679,7 +4706,7 @@ See also \secref{bib:typ:blx,bib:fld:spc}. \subsubsection{Electronic Publishing Information} \label{use:use:epr} -The \sty{biblatex} package provides three fields for electronic publishing information: \bibfield{eprint}, \bibfield{eprinttype}, and \bibfield{eprintclass}. The \bibfield{eprint} field is a verbatim field similar to \bibfield{doi} which holds the identifier of the item. The \bibfield{eprinttype} field holds the resource name, \ie the name of the site or electronic archive. The optional \bibfield{eprintclass} field is intended for additional information specific to the resource indicated by the \bibfield{eprinttype} field. This could be a section, a path, classification information, etc. If the \bibfield{eprinttype} field is available, the standard styles will use it as a literal label. In the following example, they would print «Resource: identifier» rather than the generic «eprint: identifier»: +The \sty{biblatex} package provides three fields for electronic publishing information: \bibfield{eprint}, \bibfield{eprinttype}, and \bibfield{eprintclass}. The \bibfield{eprint} field is a verbatim field similar to \bibfield{doi} which holds the identifier of the item. The \bibfield{eprinttype} field holds the resource name, \ie the name of the site or electronic archive. The optional \bibfield{eprintclass} field is intended for additional information specific to the resource indicated by the \bibfield{eprinttype} field. This could be a section, a path, classification information, etc. If the \bibfield{eprinttype} field is available, the standard styles will use it as a literal label. In the following example, they would print «Resource: identifier» rather than the generic «eprint: identifier»: \begin{lstlisting}[style=bibtex]{} <<eprint>> = {<<identifier>>}, @@ -4716,7 +4743,7 @@ When using \acr{JSTOR}'s export feature to export citations in \bibtex format, \ url = {http://www.jstor.org/stable/<<number>>}, \end{lstlisting} % -While this will work as expected, full \acr{URL}s tend to clutter the bibliography. With the \bibfield{eprint} fields, the standard styles will use the more readable «\acr{JSTOR}: \prm{number}» format which also supports hyperlinks. The \prm{number} becomes a clickable link if \sty{hyperref} support is enabled. +While this will work as expected, full \acr{URL}s tend to clutter the bibliography. With the \bibfield{eprint} fields, the standard styles will use the more readable «\acr{JSTOR}: \prm{number}» format which also supports hyperlinks. The \prm{number} becomes a clickable link if \sty{hyperref} support is enabled. For PubMed references, put the stable PubMed identifier in the \bibfield{eprint} field and the string \texttt{pubmed} in the \bibfield{eprinttype} field. This means that: @@ -4731,7 +4758,7 @@ becomes: <<eprinttype>> = {<<pubmed>>}, \end{lstlisting} % -and the standard styles will print «\acr{PMID}: \prm{pmid}» instead of the lengthy \acr{URL}. If hyperref support is enabled, the \prm{pmid} will be a clickable link to PubMed. +and the standard styles will print «\acr{PMID}: \prm{pmid}» instead of the lengthy \acr{URL}. If hyperref support is enabled, the \prm{pmid} will be a clickable link to PubMed. For handles (\acr{HDL}s), put the handle in the \bibfield{eprint} field and the string \texttt{hdl} in the \bibfield{eprinttype} field: @@ -4753,7 +4780,7 @@ would become: <<eprinttype>> = {<<googlebooks>>}, \end{lstlisting} % -and the standard styles would print «Google Books: |XXu4AkRVBBoC|» instead of the full \acr{URL}. If hyperref support is enabled, the identifier will be a clickable link to Google Books.\footnote{Note that the Google Books \acr{id} seems to be a bit of an <internal> value. As of this writing, there does not seem to be any way to search for an \acr{id} on Google Books. You may prefer to use the \bibfield{url} in this case.} +and the standard styles would print «Google Books: |XXu4AkRVBBoC|» instead of the full \acr{URL}. If hyperref support is enabled, the identifier will be a clickable link to Google Books.\footnote{Note that the Google Books \acr{id} seems to be a bit of an <internal> value. As of this writing, there does not seem to be any way to search for an \acr{id} on Google Books. You may prefer to use the \bibfield{url} in this case.} Note that \bibfield{eprint} is a verbatim field. Always give the identifier in its unmodified form. For example, there is no need to replace |_| with |\_|. Also see \secref{aut:cav:epr} on how to add dedicated support for other eprint resources. @@ -4915,21 +4942,21 @@ Initials in the \file{bib} file get a special delimiter: \item J.\delim{~}{i}Edward\delim{ }{d}Doe \end{namesample} % -Let's consider a more complex name: \enquote{Charles-Jean Étienne Gustave Nicolas de La Vallée Poussin}. This name is composed of the following parts: +Let's consider a more complex name: \enquote{Charles-Jean Étienne Gustave Nicolas de La Vallée Poussin}. This name is composed of the following parts: \begin{nameparts} -First & Charles-Jean Étienne Gustave Nicolas \\ +First & Charles-Jean Étienne Gustave Nicolas \\ Prefix & de \\ -Last & La Vallée Poussin \\ +Last & La Vallée Poussin \\ Suffix & --- \\ \end{nameparts} % The delimiters: \begin{namesample} -\item Charles-Jean\delim{~}{b}Étienne\delim{~}{b}Gustave\delim{~}{a}Nicolas\delim{ }{d}% +\item Charles-Jean\delim{~}{b}Étienne\delim{~}{b}Gustave\delim{~}{a}Nicolas\delim{ }{d}% de\delim{ }{c}% - La\delim{~}{a}Vallée\delim{~}{a}Poussin + La\delim{~}{a}Vallée\delim{~}{a}Poussin \end{namesample} % Note that \cmd{bibnamedelima/b/i} are inserted by the backend. The backend processes the name parts and takes care of the delimiters between the elements that make up a name part, processing each part individually. In contrast to that, the delimiters between the parts of the complete name (\cmd{bibnamedelimc/d}) are added by name formatting directives at a later point in the processing chain. The spacing and punctuation of initials is also handled by the backend and may be customized by redefining the following three macros: @@ -5285,7 +5312,7 @@ Formatting directives for names are similar to those for literal lists, but the {}} \end{lstlisting} % -The above directive reverses the name of the first author («Last, First») and prints the remaining names in their regular sequence («First Last»). Note that the only component which is guaranteed to be available is the last name, hence we have to check which parts of the name are actually present. If a certain component of a name is not available, the corresponding argument will be blank. As with directives for literal lists, the separator to be inserted between the individual items in the list is also handled by the formatting directive, hence we have to check whether we are in the middle of the list or at the end when inserting it. This is what the second \cmd{ifthenelse} test does. +The above directive reverses the name of the first author («Last, First») and prints the remaining names in their regular sequence («First Last»). Note that the only component which is guaranteed to be available is the last name, hence we have to check which parts of the name are actually present. If a certain component of a name is not available, the corresponding argument will be blank. As with directives for literal lists, the separator to be inserted between the individual items in the list is also handled by the formatting directive, hence we have to check whether we are in the middle of the list or at the end when inserting it. This is what the second \cmd{ifthenelse} test does. \subsubsection{Special Fields} \label{aut:bbx:fld} @@ -5337,6 +5364,11 @@ If the \opt{backref} package option is enabled, this list holds the page numbers This field holds the initial letter of the string used during sorting. This is useful when subdividing the bibliography alphabetically. +\fielditem{clonesourcekey}{string\BiberOnlyMark} + +This field holds the entry key of the entry from which an entry was cloned. Clones are created for +entries which are mentioned in \bibfield{related} fields as part of related entry processing, for example. + \end{fieldlist} \paragraph{Fields for Use in Citation Labels} @@ -5379,12 +5411,22 @@ It is sometimes useful, for example in author"=title citation schemes, to be abl \fielditem{labelyear}{literal} -The publication year, as specified in the \bibfield{date} or the \bibfield{year} field, for use in author-year labels. A complete author-year label consists of the fields \bibfield{labelyear} plus \bibfield{extrayear}. Note that the \bibfield{labelyear} and \bibfield{extrayear} fields need to be requested with the package option \opt{labelyear}, see \secref{use:opt:pre:int} for details. See also \bibfield{extrayear}. -\BiberOnlyMark With \biber, this field may be customized. See \secref{aut:ctm:fld} for details. +The publication year, as specified in the \bibfield{date} or the \bibfield{year} field, for use in author-year labels. A complete author-year label consists of the fields \bibfield{labelyear} plus \bibfield{extrayear}. Note that the \bibfield{labelyear} and \bibfield{extrayear} fields need to be requested with the package option \opt{labeldate}, see \secref{use:opt:pre:int} for details. See also \bibfield{extrayear}. +\BiberOnlyMark With \biber, the source date field for this may be customized. See \secref{aut:ctm:fld} for details. + +\fielditem{labelmonth}{integer} + +The publication month, as specified in the \bibfield{date} or the \bibfield{month} field, for use in author-year labels. Note that the \bibfield{labelmonth} field needs to be requested with the package option \opt{labeldate}, see \secref{use:opt:pre:int} for details. +\BiberOnlyMark With \biber, this source date field for this may be customized. See \secref{aut:ctm:fld} for details. + +\fielditem{labelday}{integer} + +The publication day, as specified in the \bibfield{date}, for use in author-year labels. Note that the \bibfield{labelday} field needs to be requested with the package option \opt{labeldate}, see \secref{use:opt:pre:int} for details. +\BiberOnlyMark With \biber, this source date field for this may be customized. See \secref{aut:ctm:fld} for details. \fielditem{extrayear}{integer} -The author"=year citation scheme usually requires a letter to be appended to the year if the bibliography contains two or more works by the same author which were all published in the same year. In this case, the \bibfield{extrayear} field holds an integer which may be converted to a letter with \cmd{mknumalph} or formatted in some other way. This field is undefined if there is only one work by the author in the bibliography or if all works by the author have different publication years. A complete author-year label consists of the fields \bibfield{labelyear} plus \bibfield{extrayear}. Note that the \bibfield{labelyear} and \bibfield{extrayear} fields need to be requested with the package option \opt{labelyear}, see \secref{use:opt:pre:int} for details. See also \bibfield{labelyear}. Table \ref{use:opt:tab2} summarises the various \opt{extra*} disambiguation counters and what they track. +The author"=year citation scheme usually requires a letter to be appended to the year if the bibliography contains two or more works by the same author which were all published in the same year. In this case, the \bibfield{extrayear} field holds an integer which may be converted to a letter with \cmd{mknumalph} or formatted in some other way. This field is undefined if there is only one work by the author in the bibliography or if all works by the author have different publication years. A complete author-year label consists of the fields \bibfield{labelyear} plus \bibfield{extrayear}. Note that the \bibfield{labelyear} and \bibfield{extrayear} fields need to be requested with the package option \opt{labeldate}, see \secref{use:opt:pre:int} for details. See also \bibfield{labelyear}. Table \ref{use:opt:tab2} summarises the various \opt{extra*} disambiguation counters and what they track. \end{fieldlist} @@ -5700,6 +5742,14 @@ This command prints the date of the entry, as specified in the fields \bibfield{ Similar to \cmd{printdate} but incorporates the \bibfield{extrayear} field in the date specification. This is useful for bibliography styles designed for author-year citations. +\csitem{printdatelabel}|\BiberOnlyMark| + +Similar to \cmd{printdate} but prints the date field determined by \cmd{DeclareLabeldate}. The date format is controlled by the package option \opt{datelabel} from \secref{use:opt:pre:gen}. Additional formatting may be applied by adjusting the field format \texttt{urldate} (\secref{aut:fmt:ich}). + +\csitem{printdateextralabel}|\BiberOnlyMark| + +Similar to \cmd{printdatelabel} but incorporates the \bibfield{extrayear} field in the date specification. This is useful for bibliography styles designed for author-year citations. + \csitem{printurldate} Similar to \cmd{printdate} but prints the \bibfield{urldate} of the entry. The date format is controlled by the package option \opt{urldate} from \secref{use:opt:pre:gen}. Additional formatting may be applied by adjusting the field format \texttt{urldate} (\secref{aut:fmt:ich}). @@ -5784,7 +5834,7 @@ Defines the name list format \prm{format}. This formatting directive is arbitrar \item[\#4] The first names, given as initials. \item[\#5] The name prefixes, for example von, van, of, da, de, del, della, etc. Note that name prefixes are referred to as the <von part> of the name in the \bibtex file format documentation. \item[\#6] The name prefixes, given as initials. -\item[\#7] The name affixes, for example <junior>, <senior>, <der Jüngere>, <der Ältere>, etc. +\item[\#7] The name affixes, for example <junior>, <senior>, <der Jüngere>, <der Ältere>, etc. Note that name affixes are referred to as the <junior part> of the name in the \bibtex file format documentation. \item[\#8] The name affixes, given as initials. \end{argumentlist} @@ -5860,7 +5910,7 @@ The related entry feature is enabled by default by the package option \opt{relat Bibliographic data sources which are automatically generated or which you have no control over can be a problem if you need to edit them in some way. For this reason, \biber has the ability to modify data as it is read so that you can apply modifications to the source data stream without actually changing it. The modification can be defined in \biber's config file (see \biber docs), or via \sty{biblatex} macros in which case you can apply the modification only for specific documents, styles or globally. -Source mappings can be defined at different «levels» which are applied +Source mappings can be defined at different «levels» which are applied in a defined order. See the \biblatex\ manual regarding these macros:\\[2ex] \noindent \texttt{user}-level maps defined with \cmd{DeclareSourcemap}$\rightarrow$\\ @@ -6413,7 +6463,7 @@ For constraints of \prm{type} <conditional>, specifies a quantified set of \cmd{ \choitem{quantifier}{all, one, none} -Specifies how many of the \cmd{constrainfield}'s inside the \cmd{consequent} have to be present to satisfy the consequent of the conditional constraint. +Specifies how many of the \cmd{constraintfield}'s inside the \cmd{consequent} have to be present to satisfy the consequent of the conditional constraint. \end{optionlist*} @@ -6537,6 +6587,14 @@ The number of characters of the \prm{field} to use. For name list fields, if \kv The side of the string from which to take the \texttt{strwidth} number of characters. +\choitem[right]{padside}{left, right} + +Side to pad the label part when using the \texttt{padchar} option. Only for use with fixed-width label strings (\texttt{strwidth}). + +\valitem{padchar}{character} + +If present, pads the label part on the \texttt{padside} side with the specified character to the length of \texttt{strwidth}. Only for use with fixed-width label strings (\texttt{strwidth}). + \boolitem[false]{uppercase} Forces the label part derived from the field to uppercase. By default, the case is taken from the field source and not modified. @@ -6753,6 +6811,41 @@ Agassi, Courier, Laver [ACouL-002] Borg, Connors, Edberg [BCEd-003] Borg, Connors, Emerson [BCEm-004] \end{lstlisting} +% +Here is another rather contrived example showing that you don't need to specially quote \latex special characters (apart from <\%>, obviously) when specifying padding characters and literals: + +\begin{lstlisting}[style=latex]{} +\DeclareLabelalphaTemplate{ + \labelelement{ + \literal{>} + } + \labelelement{ + \literal{\%} + } + \labelelement{ + \field[strwidth=4, padchar=_]{<<labelname>>} + } + \labelelement{ + \field[strwidth=3, padchar=&, padside=left]{title} + } + \labelelement{ + \field[strwidth=2,strside=right]{<<year>>} + } +} +\end{lstlisting} +% +which given: +\begin{lstlisting}[style=bibtex]{} +@Book{test, + author = {XXX YY}, + title = {T}, + year = {2007}, +} +\end{lstlisting} +would resulting a label looking like this: +\begin{verbatim} +[>%YY__&&T07] +\end{verbatim} \subsubsection{Sorting} \label{aut:ctm:srt} @@ -6843,7 +6936,7 @@ The \cmd{citeorder} element has a special meaning. It requests a sort based on t \cite{one,two} \end{lstlisting} % -there is a distinction between the lexical order and the semantic order. Here «one» and «two» have the same semantic order but a unique lexical order. The semantic order only matters if you specify further sorting to disambiguate entries with the same semantic order. For example, this is the definition of the \opt{none} sorting scheme: +there is a distinction between the lexical order and the semantic order. Here «one» and «two» have the same semantic order but a unique lexical order. The semantic order only matters if you specify further sorting to disambiguate entries with the same semantic order. For example, this is the definition of the \opt{none} sorting scheme: \begin{lstlisting}[style=latex]{} \DeclareSortingScheme{none}{ @@ -6851,7 +6944,7 @@ there is a distinction between the lexical order and the semantic order. Here «o } \end{lstlisting} % -This sorts the bibliography purely lexically by the order of the keys in the citation commands. In the example above, it sorts «one» before «two». However, suppose that you consider «one» and «two» to have the same order (semantic order) since they are cited at the same time and want to further sort these by year. Suppose «two» has an earlier \bibfield{year} than «one»: +This sorts the bibliography purely lexically by the order of the keys in the citation commands. In the example above, it sorts «one» before «two». However, suppose that you consider «one» and «two» to have the same order (semantic order) since they are cited at the same time and want to further sort these by year. Suppose «two» has an earlier \bibfield{year} than «one»: \begin{lstlisting}[style=latex]{} \DeclareSortingScheme{noneyear}{ @@ -6860,7 +6953,7 @@ This sorts the bibliography purely lexically by the order of the keys in the cit } \end{lstlisting} % -This sorts «two» before «one», even though lexically, «one» would sort before «two». This is possible because the semantic order can be disambiguated by the further sorting on year. With the standard \opt{none} sorting scheme, the lexical order and semantic order are identical because there is nothing further to disambiguate them. This means that you can use \cmd{citeorder} just like any other sorting specification element, choosing how to further sort entries cited at the same time (in the same citation command). +This sorts «two» before «one», even though lexically, «one» would sort before «two». This is possible because the semantic order can be disambiguated by the further sorting on year. With the standard \opt{none} sorting scheme, the lexical order and semantic order are identical because there is nothing further to disambiguate them. This means that you can use \cmd{citeorder} just like any other sorting specification element, choosing how to further sort entries cited at the same time (in the same citation command). \end{ltxsyntax} @@ -6938,7 +7031,7 @@ Specifies a string to be used to automatically populate the \bibfield{presort} f \subsubsection{Controlling Name Initials Generation} \label{aut:ctm:noinit} -Generating initials for name parts from a given name involves some difficulties when you have names with prefixes, diacritics, hyphens etc. Often, you want to ignore things like prefixes when generating initials so that the initials for «al-Hasan» is just «H» instead of «a-H». This is tricky when you also have names like «Ho-Pun» where you want the initials to be «H-P», for example. +Generating initials for name parts from a given name involves some difficulties when you have names with prefixes, diacritics, hyphens etc. Often, you want to ignore things like prefixes when generating initials so that the initials for «al-Hasan» is just «H» instead of «a-H». This is tricky when you also have names like «Ho-Pun» where you want the initials to be «H-P», for example. \begin{ltxsyntax} @@ -6993,7 +7086,7 @@ If there is no \cmd{DeclareNosort} specification, \biber will default to: } \end{lstlisting} % -This \biber default strips diacritics and prefixes from names when sorting. Suppose you wanted to ignore «The» at the beginning of a \bibfield{title} field when sorting: +This \biber default strips diacritics and prefixes from names when sorting. Suppose you wanted to ignore «The» at the beginning of a \bibfield{title} field when sorting: \begin{lstlisting}[style=latex]{} \DeclareNosort{ @@ -7001,7 +7094,7 @@ This \biber default strips diacritics and prefixes from names when sorting. Supp } \end{lstlisting} % -Or if you wanted to ignore «The» at the beginning of any title field: +Or if you wanted to ignore «The» at the beginning of any title field: \begin{lstlisting}[style=latex]{} \DeclareNosort{ @@ -7093,20 +7186,22 @@ For example, the following specification for selecting \bibfield{labelname} firs % See \secref{use:opt:bib:ded} for options to override this on a per-entry basis. -\cmditem{DeclareLabelyear}[entrytype, \dots]{specification}|\BiberOnlyMark| +\cmditem{DeclareLabeldate}[entrytype, \dots]{specification}|\BiberOnlyMark| -Defines the date components to consider when generating the \bibfield{labelyear} field (see \secref{aut:bbx:fld:lab}). The \prm{specification} is an ordered list of \cmd{field} commands. The items are checked in the order listed and the first item which is available will be used as \bibfield{labelyear}. Note that the items are date components, not date fields. This is the default definition: +Defines the date components to consider when generating \bibfield{labelyear}, \bibfield{labelmonth} and \bibfield{labelday} fields (see \secref{aut:bbx:fld:lab}). The \prm{specification} is an ordered list of \cmd{field} or \cmd{literal} commands. The items are checked in the order listed and the first item which is available will be used to popluate the \bibfield{labelyear}, \bibfield{labelmonth} and \bibfield{labelday} fields. Note that the \cmd{field} items do not have to be datetype <date> in the data model so that you can create pseudo-year labels by, for example, using a \bibfield{pubstate} field contents, if available, as the year label by defining \cmd{DeclareLabeldate} suitably. Note also that a \cmd{literal} command will always be used when found and so this should always be the last thing in the list. If the value of a \cmd{literal} command is a valid localisation string, then this will be resolved in the current language, otherwise the value is used as a literal string as-is. This is the default definition: \begin{lstlisting}[style=latex]{} -\DeclareLabelyear{% - \field{year} - \field{eventyear} - \field{origyear} - \field{urlyear} +\DeclareLabeldate{% + \field{date} + \field{eventdate} + \field{origdate} + \field{urldate} + \literal{nodate} } \end{lstlisting} % -The \bibfield{labelyear} field may be customized globally or on a per-type basis. If the optional \prm{entrytype} argument is given, the specification applies to the respective entry type. If not, it is applied globally. The \prm{entrytype} argument may be a comma"=separated list of values. This command may only be used in the preamble. See also \secref{aut:bbx:fld:dat}. +Note that the \bibfield{date} field is split by the backend into \bibfield{year}, \bibfield{month} which are also valid fields in the default data model. In order to support legacy data which directly sets \bibfield{year} and/or \bibfield{month}, the specification <\bibfield{date}> in \cmd{DeclareLabeldate} will also match \bibfield{year} and \bibfield{month} fields, if present. +The \bibfield{labelyear}, \bibfield{labelmonth} and \bibfield{labelday} fields may be customized globally or on a per-type basis. If the optional \prm{entrytype} argument is given, the specification applies to the respective entry type. If not, it is applied globally. The \prm{entrytype} argument may be a comma"=separated list of values. This command may only be used in the preamble. See also \secref{aut:bbx:fld:dat}. \cmditem{DeclareLabeltitle}[entrytype, \dots]{specification}|\BiberOnlyMark| @@ -7447,7 +7542,7 @@ Expands to \prm{true} if the \prm{list} is defined and has been truncated in the \cmditem{ifmorenames}{true}{false} -Expands to \prm{true} if the current name list has been or will be truncated, and to \prm{false} otherwise. This command is intended for use in formatting directives for name lists. It will always expand to \prm{false} when used elsewhere. This command performs the equivalent of an \cmd{ifandothers} test for the current list. If this test is negative, it also checks if the \cnt{listtotal} counter is larger than \cnt{liststop}. This command may be used in a formatting directive to decide if a note such as «and others» or «et al.» is to be printed at the end of the list. Note that you still need to check whether you are in the middle or at the end of the list, \ie whether \cnt{listcount} is smaller than or equal to \cnt{liststop}, see \secref{aut:bib:dat} for details. +Expands to \prm{true} if the current name list has been or will be truncated, and to \prm{false} otherwise. This command is intended for use in formatting directives for name lists. It will always expand to \prm{false} when used elsewhere. This command performs the equivalent of an \cmd{ifandothers} test for the current list. If this test is negative, it also checks if the \cnt{listtotal} counter is larger than \cnt{liststop}. This command may be used in a formatting directive to decide if a note such as «and others» or «et al.» is to be printed at the end of the list. Note that you still need to check whether you are in the middle or at the end of the list, \ie whether \cnt{listcount} is smaller than or equal to \cnt{liststop}, see \secref{aut:bib:dat} for details. \cmditem{ifmoreitems}{true}{false} @@ -7535,7 +7630,7 @@ Executes \prm{true} if the \prm{string} is an Arabic or Roman numeral, and \prm{ \cmditem{ifnumerals}{string}{true}{false} -Executes \prm{true} if the \prm{string} is a range or a list of Arabic or Roman numerals, and \prm{false} otherwise. This command is robust. In contrast to \cmd{ifnumeral}, it will also execute \prm{true} with arguments like «52--58», «14/15», «1,~3,~5», and so on. See also \cmd{DeclareNumChars}, \cmd{DeclareRangeChars}, \cmd{DeclareRangeCommands}, and \cmd{NumCheckSetup} in \secref{aut:aux:msc}. +Executes \prm{true} if the \prm{string} is a range or a list of Arabic or Roman numerals, and \prm{false} otherwise. This command is robust. In contrast to \cmd{ifnumeral}, it will also execute \prm{true} with arguments like «52--58», «14/15», «1,~3,~5», and so on. See also \cmd{DeclareNumChars}, \cmd{DeclareRangeChars}, \cmd{DeclareRangeCommands}, and \cmd{NumCheckSetup} in \secref{aut:aux:msc}. \cmditem{ifpages}{string}{true}{false} @@ -7794,7 +7889,7 @@ The optional argument \bibfield{pagination} in the first example is omissible. \cmditem{mkpagetotal}[pagination][postpro]{text} -This command is similar to \cmd{mkpageprefix} except that it is intended for the \bibfield{pagetotal} field of bibliography entries, \ie it will print «123 pages» rather than «page 123». The optional \prm{pagination} argument defaults to \bibfield{bookpagination}. The spacing inserted between the pagination suffix and the \prm{text} may be modified by redefining the macro \cmd{ppspace}. The optional \prm{postpro} argument specifies a macro to be used for post-processing the \prm{text}. If only one optional argument is given, it is taken as \prm{pagination}. Here is a typical example: +This command is similar to \cmd{mkpageprefix} except that it is intended for the \bibfield{pagetotal} field of bibliography entries, \ie it will print «123 pages» rather than «page 123». The optional \prm{pagination} argument defaults to \bibfield{bookpagination}. The spacing inserted between the pagination suffix and the \prm{text} may be modified by redefining the macro \cmd{ppspace}. The optional \prm{postpro} argument specifies a macro to be used for post-processing the \prm{text}. If only one optional argument is given, it is taken as \prm{pagination}. Here is a typical example: \begin{lstlisting}[style=latex]{} \DeclareFieldFormat{pagetotal}{<<\mkpagetotal[bookpagination]{#1}>>} @@ -7841,7 +7936,7 @@ The optional argument \bibfield{bookpagination} is omissible in this case. \cmditem{mkcomprange}[postpro]{text} \cmditem*{mkcomprange*}[postpro]{text} -This command, which is intended for use in field formatting directives, will parse its \prm{text} argument for page ranges and compress them. For example, «125--129» may be formatted as «125--9». You may configure the behavior of \cmd{mkcomprange} by adjusting the \latex counters \cnt{mincomprange}, \cnt{maxcomprange}, and \cnt{mincompwidth}, as illustrated in \tabref{aut:aux:tab1}. The default settings are \texttt{10}, \texttt{100000}, and \texttt{1}, respectively. This means that the command tries to compress as much as possible by default. Use \cmd{setcounter} to adjust the parameters. The scanner recognizes \cmd{bibrangedash} and hyphens as range dashes. It will normalize the dash by replacing any number of consecutive hyphens with \cmd{bibrangedash}. Lists of ranges delimited with \cmd{bibrangessep} (\biber\footnote{\biber will always convert commas/semicolon multi-range separators into \cmd{bibrangessep} so that it can be controlled in the style.}) or commas/semicolons (BibTeX) are also supported. If you want to hide a character from the list/range scanner for some reason, wrap the character or the entire string in curly braces. The optional \prm{postpro} argument specifies a macro to be used for post-processing the \prm{text}. This is important if you want to combine \cmd{mkcomprange} with other formatting macros which also need to parse their \prm{text} argument, such as \cmd{mkpageprefix}. Simply nesting these commands will not work as expected. Use the \prm{postpro} argument to set up the processing chain as follows: +This command, which is intended for use in field formatting directives, will parse its \prm{text} argument for page ranges and compress them. For example, «125--129» may be formatted as «125--9». You may configure the behavior of \cmd{mkcomprange} by adjusting the \latex counters \cnt{mincomprange}, \cnt{maxcomprange}, and \cnt{mincompwidth}, as illustrated in \tabref{aut:aux:tab1}. The default settings are \texttt{10}, \texttt{100000}, and \texttt{1}, respectively. This means that the command tries to compress as much as possible by default. Use \cmd{setcounter} to adjust the parameters. The scanner recognizes \cmd{bibrangedash} and hyphens as range dashes. It will normalize the dash by replacing any number of consecutive hyphens with \cmd{bibrangedash}. Lists of ranges delimited with \cmd{bibrangessep} (\biber\footnote{\biber will always convert commas/semicolon multi-range separators into \cmd{bibrangessep} so that it can be controlled in the style.}) or commas/semicolons (BibTeX) are also supported. If you want to hide a character from the list/range scanner for some reason, wrap the character or the entire string in curly braces. The optional \prm{postpro} argument specifies a macro to be used for post-processing the \prm{text}. This is important if you want to combine \cmd{mkcomprange} with other formatting macros which also need to parse their \prm{text} argument, such as \cmd{mkpageprefix}. Simply nesting these commands will not work as expected. Use the \prm{postpro} argument to set up the processing chain as follows: \begin{lstlisting}[style=latex]{} \DeclareFieldFormat{postnote}{\mkcomprange[<<{>>\mkpageprefix[pagination]<<}>>]{#1}} @@ -7878,6 +7973,22 @@ pp. 5, 123, 423 p. 5, p. 123, p. 423 \end{lstlisting} +\cmditem{rangelen}{text} + +This command will parse its argument as a range and return the length of the range. It will return 0 for open-ended ranges. + +\begin{lstlisting}[style=latex]{} +\rangelen{5-10} returns '5' +\rangelen{-10} returns '0' +\rangelen{5-} returns '0' +\rangelen{5} returns '1' +\end{lstlisting} +% +This can be used as part of tests in styles which require, for example, <f> as a suffix for ranges of only two pages, for example, when a page range <36-37> should be printed as <36f>. This could be done using \cmd{ifnumcomp}: + +\begin{lstlisting}[style=latex]{} +\ifnumcomp{\rangelen{\thefield{pages}}}{=}{1}{add 'f'}{do nothing} +\end{lstlisting} \cmditem{DeclareNumChars}{characters} \cmditem*{DeclareNumChars*}{characters} @@ -7989,6 +8100,11 @@ Inserts \cmd{finentrypunct}. This command should be used at the very end of ever The \cmd{setunit} command is similar to \cmd{newunit} except that it uses \prm{punctuation} instead of \cmd{newunitpunct}. The starred variant differs from the regular version in that it checks if the last \cmd{printtext}, \cmd{printfield}, \cmd{printlist}, \cmd{printnames}, or \cmd{bibstring} command did actually print anything. If not, it does nothing. +\cmditem{printunit}{punctuation} +\cmditem*{printunit*}{punctuation} + +The \cmd{printunit} command is similar to \cmd{setunit} except that \prm{punctuation} persists in the buffer until the next \cmd{printtext}, \cmd{printfield}, \cmd{printlist}, \cmd{printnames}, or \cmd{bibstring} command. + \cmditem{setpunctfont}{command} This command, which is intended for use in field formatting directives, provides an alternative way of dealing with unit punctuation after a field printed in a different font (for example, a title printed in italics). The standard \latex way of dealing with this is adding a small amount of space, the so-called italic correction. This command allows adapting the punctuation to the font of the preceding field. The \prm{command} should be a text font command which takes one argument, such as \cmd{emph} or \cmd{textbf}. This command will only affect punctuation marks inserted by one of the commands from \secref{aut:pct:pct}. The font adaption is applied to the next punctuation mark only and will be reset automatically thereafter. If you want to reset it manually before it takes effect, issue \cmd{resetpunctfont}. If the \opt{punctfont} package option is disabled, this command does nothing. Note that the \cmd{mkbibemph} and \cmd{mkbibbold} wrappers from \secref{aut:fmt:ich} incorporate this feature by default. @@ -8199,7 +8315,7 @@ Undoes the settings applied by \cmd{uspunctuation}, restoring standard punctuati \subsubsection{Correcting Punctuation Tracking} \label{aut:pct:ctr} -The facilities for punctuation tracking and automatic capitalization are very reliable under normal circumstances, but there are always marginal cases which may require manual intervention. Typical cases are localization strings printed as the first word in a footnote (which is usually treated as the beginning of a paragraph as far as capitalization is concerned, but \tex is not in vertical mode at this point) or punctuation after periods which are not really end"=of"=sentence periods (for example, after an ellipsis like «[\dots\unkern]» a command such as \cmd{addperiod} would do nothing since parentheses and brackets are transparent to the punctuation tracker). In such cases, use the following commands in bibliography and citation styles to mark the beginning or middle of a sentence if and where required: +The facilities for punctuation tracking and automatic capitalization are very reliable under normal circumstances, but there are always marginal cases which may require manual intervention. Typical cases are localization strings printed as the first word in a footnote (which is usually treated as the beginning of a paragraph as far as capitalization is concerned, but \tex is not in vertical mode at this point) or punctuation after periods which are not really end"=of"=sentence periods (for example, after an ellipsis like «[\dots\unkern]» a command such as \cmd{addperiod} would do nothing since parentheses and brackets are transparent to the punctuation tracker). In such cases, use the following commands in bibliography and citation styles to mark the beginning or middle of a sentence if and where required: \begin{ltxsyntax} @@ -8286,6 +8402,10 @@ Similar to \cmd{bibxstring} but always uses the long string, ignoring the \opt{a Similar to \cmd{bibxstring} but always uses the short string, ignoring the \opt{abbreviate} option. +\cmditem{mainlang} + +Switches from the current language to the main document language. This can be used the \prm{wrapper} argument in the localization string commands above. + \end{ltxsyntax} \subsection{Localization Modules} @@ -8557,7 +8677,7 @@ The following keys refer to roles which are expressed as an action (<edited by>, \item[byreviser] The expression <revised by \prm{name}>. \item[byreviewer] The expression <reviewed by \prm{name}>. \item[bycollaborator] An expression like <in collaboration with \prm{name}> or <in cooperation with \prm{name}>. -\item[bytranslator] The expression <translated by \prm{name}> or <translated from \prm{language} by \prm{name}>. +\item[bytranslator] The expression <translated by \prm{name}> or <translated from \prm{language} by \prm{name}>. \item[bycommentator] The expression <commented by \prm{name}>. \item[byannotator] The expression <annotated by \prm{name}>. \end{keymarglist} @@ -8755,6 +8875,7 @@ The following keys are typically used in the \bibfield{type} field of \bibtype{t \label{aut:lng:key:msc} \begin{keymarglist} +\item[nodate] The term to use in place of a date when there is no date for an entry \eg\ <n.d.> \item[and] The term <and>, as used in a list of authors or editors, for example. \item[andothers] The expression <and others> or <et alii>, used to mark the truncation of a name list. \item[andmore] Like \texttt{andothers} but used to mark the truncation of a literal list. @@ -8767,6 +8888,7 @@ The following strings are intended for use as labels, \eg\ <Address: \prm{url}> \begin{keymarglist} \item[url] The term <address> in the sense of an internet address. +\item[urlfrom] An expression like <available from \prm{url}> or <available at \prm{url}>. \item[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. \item[file] The term <file>. \item[library] The term <library>. @@ -8989,7 +9111,7 @@ The separator to be printed after the name used for alphabetizing in the bibliog The separator to be printed between the fields \bibfield{title} and \bibfield{subtitle}, \bibfield{booktitle} and \bibfield{booksubtitle}, as well as \bibfield{maintitle} and \bibfield{mainsubtitle}. Use this separator instead of \cmd{newunitpunct} at this location. The default is \cmd{newunitpunct}, \ie it is not handled differently from regular unit punctuation but permits convenient reconfiguration. \csitem{intitlepunct} -The separator to be printed between the word «in» and the following title in entry types such as \bibtype{article}, \bibtype{inbook}, \bibtype{incollection}, etc. Use this separator instead of \cmd{newunitpunct} at this location. The default definition is a colon plus an interword space. +The separator to be printed between the word «in» and the following title in entry types such as \bibtype{article}, \bibtype{inbook}, \bibtype{incollection}, etc. Use this separator instead of \cmd{newunitpunct} at this location. The default definition is a colon plus an interword space. \csitem{bibpagespunct} The separator to be printed before the \bibfield{pages} field. Use this separator instead of \cmd{newunitpunct} at this location. The default is a comma plus an interword space. @@ -9287,6 +9409,10 @@ A special formatting directive which controls the format of the volume portion i A special formatting directive which controls the format of \cmd{printdate} (\secref{aut:bib:dat}). Note that the date format (long/short etc.) is controlled by the package option \opt{date} from \secref{use:opt:pre:gen}. This formatting directive only controls additional formatting such as fonts etc. +\optitem{datelabel} + +Similar to \texttt{date} but controls the format of \cmd{printdatelabel}. + \optitem{urldate} Similar to \texttt{date} but controls the format of \cmd{printurldate}. @@ -9375,7 +9501,7 @@ This counter is similar to \cnt{citecount} but only available in multicite comma \cntitem{listtotal} -This counter holds the total number of items in the current list. It is intended for use in list formatting directives and does not hold a meaningful value when used anywhere else. As an exception, it may also be used in the second optional argument to \cmd{printnames} and \cmd{printlist}, see \secref{aut:bib:dat} for details. For every list, there is also a counter by the same name which holds the total number of items in the corresponding list. For example, the \cnt{author} counter holds the total number of items in the \bibfield{author} list. This applies to both name lists and literal lists. These counters are similar to \cnt{listtotal} except that they may also be used independently of list formatting directives. For example, a bibliography style might check the \cnt{editor} counter to decide Whether or not to print the term «editor» or rather its plural form «editors» after the list of editors. +This counter holds the total number of items in the current list. It is intended for use in list formatting directives and does not hold a meaningful value when used anywhere else. As an exception, it may also be used in the second optional argument to \cmd{printnames} and \cmd{printlist}, see \secref{aut:bib:dat} for details. For every list, there is also a counter by the same name which holds the total number of items in the corresponding list. For example, the \cnt{author} counter holds the total number of items in the \bibfield{author} list. This applies to both name lists and literal lists. These counters are similar to \cnt{listtotal} except that they may also be used independently of list formatting directives. For example, a bibliography style might check the \cnt{editor} counter to decide Whether or not to print the term «editor» or rather its plural form «editors» after the list of editors. \cntitem{listcount} @@ -9424,6 +9550,10 @@ Appends the \prm{code} to an internal hook executed at the beginning of every it Appends the \prm{code} to an internal hook executed at the beginning of every item in the list of shorthands. The \prm{code} is executed immediately after the \prm{item code} of \cmd{defbibenvironment}. The bibliographic data of the respective entry is available at this point. This command may only be used in the preamble. +\cmditem{AtNextBibliography}{code} + +Similar to \cmd{AtBeginBibliography} but only affecting the next \cmd{printbibliography}. The internal hook is cleared after being executed once. This command may be used in the document body. + \cmditem{AtEveryCite}{code} Appends the \prm{code} to an internal hook executed at the beginning of every citation command. The \prm{code} is executed immediately before the \prm{precode} of the command (see \secref{aut:cbx:cbx}). No bibliographic data is available at this point. This command may only be used in the preamble. @@ -10355,7 +10485,7 @@ The \opt{ris} driver reflects the fact that \opt{ris} itself is a very simple an \subsection{\opt{zoterordfxml}} -The \opt{zoterordfxml} driver reads the Zotero\footnote{\url{www.zotero.org}} XML representation of its RDF format. From the \biblatex point of view, it suffers from a lack of the notion of a citation key and so is of limited use. The format may include a citation key in the future at which point the \biber driver and these default mappings will be updated. As with \opt{endnotexml}, the format is somewhat messy with, in particular, a very limited way of dealing with related entries which makes the driver setup rather ugly. As can be seen below, it is possible to map into a field prefixed with «BIBERCUSTOM» which is not a real field in the data model but can be detected in the \biber driver itself and used to process a source field which does not map naturally to any \biblatex data model field as it needs special treatment. This is messy but is due largely due to messy source data models. +The \opt{zoterordfxml} driver reads the Zotero\footnote{\url{www.zotero.org}} XML representation of its RDF format. From the \biblatex point of view, it suffers from a lack of the notion of a citation key and so is of limited use. The format may include a citation key in the future at which point the \biber driver and these default mappings will be updated. As with \opt{endnotexml}, the format is somewhat messy with, in particular, a very limited way of dealing with related entries which makes the driver setup rather ugly. As can be seen below, it is possible to map into a field prefixed with «BIBERCUSTOM» which is not a real field in the data model but can be detected in the \biber driver itself and used to process a source field which does not map naturally to any \biblatex data model field as it needs special treatment. This is messy but is due largely due to messy source data models. \begin{lstlisting}[style=latex]{} \DeclareDriverSourcemap[datatype=zoterordfxml]{ @@ -10742,7 +10872,7 @@ labeltitlefield &\_&\_&\_&\+\\ labeltitleform &\_&\_&\_&\+\\ labeltitlelang &\_&\_&\_&\+\\ labeltitleyear &\+&\+&\+&\_\\ -labelyear &\+&\+&\+&\_\\ +labeldate &\+&\+&\+&\_\\ language &\+&\+&\_&\_\\ loadfiles &\+&\+&\_&\_\\ loccittracker &\+&\+&\_&\_\\ @@ -10802,6 +10932,20 @@ This revision history is a list of changes relevant to users of this package. Ch \begin{changelog} +\begin{release}{2.6}{2013-04-30} +\item Added \cmd{printunit}see{aut:pct:new} +\item Added field \bibfield{clonesourcekey}see{aut:bbx:fld:gen} +\item New options for \cmd{DeclareLabelalphaTemplate}\see{aut:ctm:lab} +\item Added \cmd{DeclareLabeldate} and retired \cmd{DeclareLabelyear}\see{aut:ctm:fld} +\item Added \texttt{nodate} localisation string\see{aut:lng:key:msc} +\item Added \cmd{rangelen}\see{aut:aux:msc} +\item Added starred variants of \cmd{citeauthor} and \cmd{Citeauthor}\see{use:cit:txt} +\item Restored original \texttt{url} format. Added \texttt{urlfrom} localization key\see{aut:lng:key:lab} +\item Added \cmd{AtNextBibliography}\see{aut:fmt:hok} +\item Fixed related entry processing to allow nested and cyclic related entries +\item Misc bug fixes +\end{release} + \begin{release}{2.5}{2013-01-10} \item Made \texttt{url} work as a localisation string, defaulting to previously hard-coded value <\textsc{URL}>. \item Changed some \biber\ option names to cohere with \biber\ 1.5. @@ -11095,7 +11239,7 @@ This revision history is a list of changes relevant to users of this package. Ch \item Added option \opt{check} to \cmd{printbibliography}\see{use:bib:bib} \item Added option \opt{check} to \cmd{printshorthands}\see{use:bib:los} \item Added \cmd{defbibcheck}\see{use:bib:flt} -\item Updated support for Portuguese (José Carlos Santos) +\item Updated support for Portuguese (José Carlos Santos) \item Fixed conflict with \sty{titletoc} \item Fixed some bugs \end{release} @@ -11144,7 +11288,7 @@ This revision history is a list of changes relevant to users of this package. Ch %\item Added field alias \bibfield{primaryclass}\see{bib:fld:als} %\item Updated documentation\see{use:use:epr} %\item Tweaked package option \kvopt{babel}{other*}\see{use:opt:pre:gen} -%\item Updated support for Brazilian (Mateus Araújo) +%\item Updated support for Brazilian (Mateus Araújo) %\item Fixed some bugs %\end{release} % @@ -11240,7 +11384,7 @@ This revision history is a list of changes relevant to users of this package. Ch %\item Added localization key \texttt{backrefpages}\see{aut:lng:key} %\item Slightly expanded documentation\see{bib:use:dat} %\item Slightly expanded documentation\see{aut:bbx:fld:dat} -%\item Added support for Finnish (translations by Hannu Väisänen) +%\item Added support for Finnish (translations by Hannu Väisänen) %\item Updated support for Greek (translations by Prokopis) % %\end{release} @@ -11422,7 +11566,7 @@ This revision history is a list of changes relevant to users of this package. Ch %\item Updated and clarified documentation\see{aut:lng:key} %\item Added support for Brazilian Portuguese (by Augusto Ritter Stoffel) %\item Added preliminary support for Portuguese/Portugal\see{use:opt:pre:gen} -%\item Added revised Swedish translations (by Per Starbäck)\see{use:opt:pre:gen} +%\item Added revised Swedish translations (by Per Starbäck)\see{use:opt:pre:gen} %\item Expanded documentation\see{aut:cav:nam} %\item Improved concatenation of editorial and other roles %\item Fixed some bugs @@ -11595,7 +11739,7 @@ This revision history is a list of changes relevant to users of this package. Ch %\item Added \cmd{DeclareNumChars}\see{aut:aux:msc} %\item Added \cmd{DeclareRangeChars}\see{aut:aux:msc} %\item Added \cmd{DeclareRangeCommands}\see{aut:aux:msc} -%\item Added support for Swedish (translations by Per Starbäck and others) +%\item Added support for Swedish (translations by Per Starbäck and others) %\item Updated various localization files %\item Various minor improvements throughout %\item Fixed some bugs @@ -12048,7 +12192,7 @@ This revision history is a list of changes relevant to users of this package. Ch %\item Updated documentation\see{aut:fmt:fmt} %\item Updated and completed documentation\see{use:fmt:lng} %\item Updated and completed documentation\see{aut:fmt:lng} -%\item Added support for Spanish (translations by Ignacio Fernández Galván) +%\item Added support for Spanish (translations by Ignacio Fernández Galván) %\item Various memory-related optimizations in \path{biblatex.bst} % %\end{release} @@ -12231,7 +12375,7 @@ This revision history is a list of changes relevant to users of this package. Ch \end{document} %%% Local Variables: -%%% TeX-command-default: "PDFLaTeX" +%%% coding: utf-8 %%% eval: (auto-fill-mode -1) %%% eval: (visual-line-mode) %%% End: diff --git a/Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex b/Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex new file mode 100644 index 00000000000..2e031d9b3c4 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex/examples/03-localization-keys.tex @@ -0,0 +1,625 @@ +% +% 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[brazilian]{babel} +%\usepackage[catalan]{babel} +%\usepackage[croatian]{babel} +%\usepackage[czech]{babel} +%\usepackage[danish]{babel} +%\usepackage[dutch]{babel} +\usepackage[english]{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[spanish]{babel} +%\usepackage[swedish]{babel} +% - UTF-8 +% -- Russian +%\usepackage[T1,T2A]{fontenc} +%\usepackage[utf8]{inputenc} +%\usepackage[russian]{babel} +% -- Greek +%\usepackage[LGRx,T1]{fontenc} +%\usepackage[utf8]{inputenx} +%\usepackage[english,greek]{babel} + +\usepackage[autostyle]{csquotes} +\DeclareQuoteAlias{spanish}{catalan} +\DeclareQuoteAlias{croatian}{polish} +\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\biblstring{#1}% + \expandafter\lbx@initnamehook\lsmartoftext% + \par\nobreak + \midsentence\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} +\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*{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{langportuguese} The language <Portuguese>. +\keyitem{langrussian} The language <Russian>. +\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{fromczech} The expression <from [the] Czech>. +\keyitem{fromcroatian} The expression <from [the] Croatian>. +\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{fromportuguese} The expression <from [the] Portuguese>. +\keyitem{fromrussian} The expression <from [the] Russian>. +\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} diff --git a/Master/texmf-dist/doc/latex/biblatex/examples/90-related-entries.tex b/Master/texmf-dist/doc/latex/biblatex/examples/90-related-entries.tex index df15724ba2f..3d376be8bb7 100644 --- a/Master/texmf-dist/doc/latex/biblatex/examples/90-related-entries.tex +++ b/Master/texmf-dist/doc/latex/biblatex/examples/90-related-entries.tex @@ -9,7 +9,7 @@ \usepackage{hyperref} \addbibresource{biblatex-examples.bib} \begin{document} -\nocite{knuth:ct:related,kullback:related} +\nocite{knuth:ct:related,kullback:related,moore:related} \nocite{doody,vangennep:trans,vangennep:related,vizedom:related} \printbibliography \end{document} diff --git a/Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib b/Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib index 994b91995db..e2fb9051305 100644 --- a/Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib +++ b/Master/texmf-dist/doc/latex/biblatex/examples/biblatex-examples.bib @@ -1,1436 +1,1609 @@ -@string{anch-ie = {Angew.~Chem. Int.~Ed.} } -@string{cup = {Cambridge University Press} } -@string{dtv = {Deutscher Taschenbuch-Verlag} } -@string{hup = {Harvard University Press} } -@string{jams = {J.~Amer. Math. Soc.} } -@string{jchph = {J.~Chem. Phys.} } -@string{jomch = {J.~Organomet. Chem.} } -@string{pup = {Princeton University Press} } - -@incollection{westfahl:space, - crossref = {westfahl:frontier}, - hyphenation = {american}, - author = {Westfahl, Gary}, - indextitle = {True Frontier, The}, - title = {The True Frontier}, - subtitle = {Confronting and Avoiding the Realities of Space in American - Science Fiction Films}, - pages = {55--65}, - annotation = {A cross-referenced article from a \texttt{collection}. This is - an \texttt{incollection} entry with a \texttt{crossref} field. Note the - \texttt{subtitle} and \texttt{indextitle} fields} +@string{ anch-ie = {Angew.~Chem. Int.~Ed.} } +@string{ cup = {Cambridge University Press} } +@string{ dtv = {Deutscher Taschenbuch-Verlag} } +@string{ hup = {Harvard University Press} } +@string{ jams = {J.~Amer. Math. Soc.} } +@string{ jchph = {J.~Chem. Phys.} } +@string{ jomch = {J.~Organomet. Chem.} } +@string{ pup = {Princeton University Press} } + +@InCollection{westfahl:space, + author = {Westfahl, Gary}, + title = {The True Frontier}, + subtitle = {Confronting and Avoiding the Realities of Space in American + Science Fiction Films}, + pages = {55-65}, + crossref = {westfahl:frontier}, + hyphenation = {american}, + indextitle = {True Frontier, The}, + annotation = {A cross-referenced article from a \texttt{collection}. This is + an \texttt{incollection} entry with a \texttt{crossref} + field. Note the \texttt{subtitle} and \texttt{indextitle} + fields}, } + @set{set, - entryset = {herrmann,aksin,yoon}, - annotation = {A \texttt{set} with three members} + entryset = {herrmann,aksin,yoon}, + annotation = {A \texttt{set} with three members}, } + @set{stdmodel, - entryset = {glashow,weinberg,salam}, - annotation = {A \texttt{set} with three members discussing the standard - model of particle physics} -} -@article{aksin, - author = {Aks{\i}n, {\"O}zge and T{\"u}rkmen, Hayati and Artok, Levent - and {\k{C}}etinkaya, Bekir and Ni, Chaoying - and B{\"u}y{\"u}kg{\"u}ng{\"o}r, Orhan and {\"O}zkal, Erhan}, - indextitle = {Effect of immobilization on catalytic characteristics}, - title = {Effect of immobilization on catalytic characteristics of saturated - Pd-N-heterocyclic carbenes in Mizoroki-Heck reactions}, + entryset = {glashow,weinberg,salam}, + annotation = {A \texttt{set} with three members discussing the standard + model of particle physics}, +} + +@Article{aksin, + author = {Aks{\i}n, {\"O}zge and T{\"u}rkmen, Hayati and Artok, Levent + and {\k{C}}etinkaya, Bekir and Ni, Chaoying and + B{\"u}y{\"u}kg{\"u}ng{\"o}r, Orhan and {\"O}zkal, Erhan}, + title = {Effect of immobilization on catalytic characteristics of + saturated Pd-N-heterocyclic carbenes in Mizoroki-Heck + reactions}, journaltitle = jomch, - volume = {691}, - number = {13}, - date = {2006}, - pages = {3027--3036} -} -@article{angenendt, - hyphenation = {german}, - author = {Angenendt, Arnold}, - indextitle = {In Honore Salvatoris}, - title = {In Honore Salvatoris~-- Vom Sinn und Unsinn der Patrozinienkunde}, - shorttitle = {In Honore Salvatoris}, + date = 2006, + volume = 691, + number = 13, + pages = {3027-3036}, + indextitle = {Effect of immobilization on catalytic characteristics}, +} + +@Article{angenendt, + author = {Angenendt, Arnold}, + title = {In Honore Salvatoris~-- Vom Sinn und Unsinn der + Patrozinienkunde}, journaltitle = {Revue d'Histoire Eccl{\'e}siastique}, - volume = {97}, - date = {2002}, - pages = {431--456, 791--823}, - annotation = {A German article in a French journal. Apart from that, a - typical \texttt{article} entry. Note the \texttt{indextitle} field} -} -@article{baez/article, - hyphenation = {american}, - author = {Baez, John C. and Lauda, Aaron D.}, - title = {Higher-Dimensional Algebra V: 2-Groups}, + date = 2002, + volume = 97, + pages = {431--456, 791--823}, + hyphenation = {german}, + indextitle = {In Honore Salvatoris}, + shorttitle = {In Honore Salvatoris}, + annotation = {A German article in a French journal. Apart from that, a + typical \texttt{article} entry. Note the \texttt{indextitle} + field}, +} + +@Article{baez/article, + author = {Baez, John C. and Lauda, Aaron D.}, + title = {Higher-Dimensional Algebra V: 2-Groups}, journaltitle = {Theory and Applications of Categories}, - volume = {12}, - version = {3}, - date = {2004}, - pages = {423--491}, - eprinttype = {arxiv}, - eprint = {math/0307200v3}, - annotation = {An \texttt{article} with \texttt{eprint} and - \texttt{eprinttype} fields. Note that the arXiv reference is transformed - into a clickable link if \texttt{hyperref} support has been enabled. - Compare \texttt{baez\slash online}, which is the same item given as an - \texttt{online} entry} -} -@article{bertram, - hyphenation = {american}, - author = {Bertram, Aaron and Wentworth, Richard}, - title = {Gromov invariants for holomorphic maps on Riemann surfaces}, - shorttitle = {Gromov invariants}, + date = 2004, + volume = 12, + pages = {423-491}, + version = 3, + eprint = {math/0307200v3}, + eprinttype = {arxiv}, + hyphenation = {american}, + annotation = {An \texttt{article} with \texttt{eprint} and + \texttt{eprinttype} fields. Note that the arXiv reference is + transformed into a clickable link if \texttt{hyperref} support + has been enabled. Compare \texttt{baez\slash online}, which + is the same item given as an \texttt{online} entry}, +} + +@Article{bertram, + author = {Bertram, Aaron and Wentworth, Richard}, + title = {Gromov invariants for holomorphic maps on Riemann surfaces}, journaltitle = jams, - volume = {9}, - number = {2}, - date = {1996}, - pages = {529--571}, - annotation = {An \texttt{article} entry with a \texttt{volume} and a - \texttt{number} field} -} -@article{doody, - title = {Hemingway's Style and Jake's Narration}, - author = {Doody, Terrence}, - related = {matuz:doody}, - relatedstring = {\autocap{e}xcerpt in}, - journal = {The Journal of Narrative Technique}, - volume = {4}, - number = {3}, - pages = {212--225}, - year = {1974}, - annotation = {An \texttt{article} entry cited as an excerpt from a - \texttt{collection} entry. Note the format of the \texttt{related} - and \texttt{relatedstring} fields} -} -@collection{matuz:doody, - title = {Contemporary Literary Criticism}, - editor = {Matuz, Roger}, - volume = {61}, - location = {Detroit}, - publisher = {Gale}, - pages = {204--208}, - year = {1990}, - annotation = {A \texttt{collection} entry providing the excerpt information - for the \texttt{doody} entry. Note the format of the \texttt{pages} field} -} -@article{gillies, - hyphenation = {british}, - author = {Gillies, Alexander}, - title = {Herder and the Preparation of Goethe's Idea of World Literature}, + date = 1996, + volume = 9, + number = 2, + pages = {529-571}, + hyphenation = {american}, + shorttitle = {Gromov invariants}, + annotation = {An \texttt{article} entry with a \texttt{volume} and a + \texttt{number} field}, +} + +@Article{doody, + author = {Doody, Terrence}, + title = {Hemingway's Style and Jake's Narration}, + year = 1974, + volume = 4, + number = 3, + pages = {212-225}, + hyphenation = {american}, + related = {matuz:doody}, + relatedstring= {\autocap{e}xcerpt in}, + journal = {The Journal of Narrative Technique}, + annotation = {An \texttt{article} entry cited as an excerpt from a + \texttt{collection} entry. Note the format of the + \texttt{related} and \texttt{relatedstring} fields}, +} + +@Collection{matuz:doody, + editor = {Matuz, Roger}, + title = {Contemporary Literary Criticism}, + year = 1990, + volume = 61, + publisher = {Gale}, + location = {Detroit}, + pages = {204-208}, + hyphenation = {american}, + annotation = {A \texttt{collection} entry providing the excerpt information + for the \texttt{doody} entry. Note the format of the + \texttt{pages} field}, +} + +@Article{gillies, + author = {Gillies, Alexander}, + title = {Herder and the Preparation of Goethe's Idea of World + Literature}, journaltitle = {Publications of the English Goethe Society}, - volume = {9}, - series = {newseries}, - date = {1933}, - pages = {46--67}, - annotation = {An \texttt{article} entry with a \texttt{series} and a - \texttt{volume} field. Note that format of the \texttt{series} field in - the database file} -} -@article{glashow, - author = {Glashow, Sheldon}, - title = {Partial Symmetries of Weak Interactions}, + date = 1933, + series = {newseries}, + volume = 9, + pages = {46-67}, + hyphenation = {british}, + annotation = {An \texttt{article} entry with a \texttt{series} and a + \texttt{volume} field. Note that format of the \texttt{series} + field in the database file}, +} + +@Article{glashow, + author = {Glashow, Sheldon}, + title = {Partial Symmetries of Weak Interactions}, journaltitle = {Nucl.~Phys.}, - volume = {22}, - date = {1961}, - pages = {579--588} -} -@article{herrmann, - author = {Herrmann, Wolfgang A. and {\"O}fele, Karl and Schneider, Sabine K. - and Herdtweck, Eberhardt and Hoffmann, Stephan D.}, - indextitle = {Carbocyclic carbene as an efficient catalyst, A}, - title = {A carbocyclic carbene as an efficient catalyst ligand for C--C - coupling reactions}, + date = 1961, + volume = 22, + pages = {579-588}, +} + +@Article{herrmann, + author = {Herrmann, Wolfgang A. and {\"O}fele, Karl and Schneider, + Sabine K. and Herdtweck, Eberhardt and Hoffmann, Stephan D.}, + title = {A carbocyclic carbene as an efficient catalyst ligand for C--C + coupling reactions}, journaltitle = anch-ie, - volume = {45}, - number = {23}, - date = {2006}, - pages = {3859--3862} -} -@article{kastenholz, - hyphenation = {american}, - author = {Kastenholz, M. A. and H{\"u}nenberger, Philippe H.}, - indextitle = {Computation of ionic solvation free energies}, - title = {Computation of methodology\hyphen independent ionic solvation free - energies from molecular simulations}, - subtitle = {I. The electrostatic potential in molecular liquids}, + date = 2006, + volume = 45, + number = 23, + pages = {3859-3862}, + indextitle = {Carbocyclic carbene as an efficient catalyst, A}, +} + +@Article{kastenholz, + author = {Kastenholz, M. A. and H{\"u}nenberger, Philippe H.}, + title = {Computation of methodology\hyphen independent ionic solvation + free energies from molecular simulations}, journaltitle = jchph, - volume = {124}, - eid = {124106}, - date = {2006}, - doi = {10.1063/1.2172593}, - annotation = {An \texttt{article} entry with an \texttt{eid} and a - \texttt{doi} field. Note that the \textsc{doi} is transformed into a - clickable link if \texttt{hyperref} support has been enabled}, - abstract = {The computation of ionic solvation free energies from atomistic - simulations is a surprisingly difficult problem that has found no - satisfactory solution for more than 15 years. The reason is that the - charging free energies evaluated from such simulations are affected by - very large errors. One of these is related to the choice of a specific - convention for summing up the contributions of solvent charges to the - electrostatic potential in the ionic cavity, namely, on the basis of point - charges within entire solvent molecules (M scheme) or on the basis of - individual point charges (P scheme). The use of an inappropriate - convention may lead to a charge-independent offset in the calculated - potential, which depends on the details of the summation scheme, on the - quadrupole-moment trace of the solvent molecule, and on the approximate - form used to represent electrostatic interactions in the system. However, - whether the M or P scheme (if any) represents the appropriate convention - is still a matter of on-going debate. The goal of the present article is - to settle this long-standing controversy by carefully analyzing (both - analytically and numerically) the properties of the electrostatic - potential in molecular liquids (and inside cavities within them).} -} -@article{murray, - hyphenation = {american}, - author = {Hostetler, Michael J. and Wingate, Julia E. and Zhong, Chuan-Jian - and Harris, Jay E. and Vachet, Richard W. and Clark, Michael R. - and Londono, J. David and Green, Stephen J. and Stokes, Jennifer J. - and Wignall, George D. and Glish, Gary L. and Porter, Marc D. - and Evans, Neal D. and Murray, Royce W.}, - indextitle = {Alkanethiolate gold cluster molecules}, - title = {Alkanethiolate gold cluster molecules with core diameters from 1.5 - to 5.2~nm}, - subtitle = {Core and monolayer properties as a function of core size}, - shorttitle = {Alkanethiolate gold cluster molecules}, + date = 2006, + subtitle = {I. The electrostatic potential in molecular liquids}, + volume = 124, + eid = 124106, + doi = {10.1063/1.2172593}, + hyphenation = {american}, + indextitle = {Computation of ionic solvation free energies}, + annotation = {An \texttt{article} entry with an \texttt{eid} and a + \texttt{doi} field. Note that the \textsc{doi} is transformed + into a clickable link if \texttt{hyperref} support has been + enabled}, + abstract = {The computation of ionic solvation free energies from + atomistic simulations is a surprisingly difficult problem that + has found no satisfactory solution for more than 15 years. The + reason is that the charging free energies evaluated from such + simulations are affected by very large errors. One of these is + related to the choice of a specific convention for summing up + the contributions of solvent charges to the electrostatic + potential in the ionic cavity, namely, on the basis of point + charges within entire solvent molecules (M scheme) or on the + basis of individual point charges (P scheme). The use of an + inappropriate convention may lead to a charge-independent + offset in the calculated potential, which depends on the + details of the summation scheme, on the quadrupole-moment + trace of the solvent molecule, and on the approximate form + used to represent electrostatic interactions in the + system. However, whether the M or P scheme (if any) represents + the appropriate convention is still a matter of on-going + debate. The goal of the present article is to settle this + long-standing controversy by carefully analyzing (both + analytically and numerically) the properties of the + electrostatic potential in molecular liquids (and inside + cavities within them).}, +} + +@Article{murray, + author = {Hostetler, Michael J. and Wingate, Julia E. and Zhong, + Chuan-Jian and Harris, Jay E. and Vachet, Richard W. and + Clark, Michael R. and Londono, J. David and Green, Stephen + J. and Stokes, Jennifer J. and Wignall, George D. and Glish, + Gary L. and Porter, Marc D. and Evans, Neal D. and Murray, + Royce W.}, + title = {Alkanethiolate gold cluster molecules with core diameters from + 1.5 to 5.2~nm}, journaltitle = {Langmuir}, - volume = {14}, - number = {1}, - date = {1998}, - pages = {17--30}, - annotation = {An \texttt{article} entry with \arabic{author} authors. By - default, long author and editor lists are automatically truncated. This is - configurable} -} -@article{reese, - hyphenation = {american}, - author = {Reese, Trevor R.}, - title = {Georgia in Anglo-Spanish Diplomacy, 1736-1739}, + date = 1998, + subtitle = {Core and monolayer properties as a function of core size}, + volume = 14, + number = 1, + pages = {17-30}, + hyphenation = {american}, + indextitle = {Alkanethiolate gold cluster molecules}, + shorttitle = {Alkanethiolate gold cluster molecules}, + annotation = {An \texttt{article} entry with \arabic{author} authors. By + default, long author and editor lists are automatically + truncated. This is configurable}, +} + +@Article{reese, + author = {Reese, Trevor R.}, + title = {Georgia in Anglo-Spanish Diplomacy, 1736-1739}, journaltitle = {William and Mary Quarterly}, - volume = {15}, - series = {3}, - date = {1958}, - pages = {168--190}, - annotation = {An \texttt{article} entry with a \texttt{series} and a - \texttt{volume} field. Note the format of the series. If the value of the - \texttt{series} field is an integer, this number is printed as an ordinal - and the string \enquote*{series} is appended automatically} -} -@article{sarfraz, - author = {M. Sarfraz and M. F. A. Razzak}, - title = {Technical section: {An} algorithm for automatic capturing of the - font outlines}, - journal = {Computers and Graphics}, - volume = {26}, - number = {5}, - pages = {795--804}, - year = {2002}, - issn = {0097-8493}, - annotation = {An \texttt{article} entry with an \texttt{issn} field} -} -@article{shore, - author = {Shore, Bradd}, - title = {Twice-Born, Once Conceived}, - subtitle = {Meaning Construction and Cultural Cognition}, + date = 1958, + series = 3, + volume = 15, + pages = {168-190}, + hyphenation = {american}, + annotation = {An \texttt{article} entry with a \texttt{series} and a + \texttt{volume} field. Note the format of the series. If the + value of the \texttt{series} field is an integer, this number + is printed as an ordinal and the string \enquote*{series} is + appended automatically}, +} + +@Article{sarfraz, + author = {M. Sarfraz and M. F. A. Razzak}, + title = {Technical section: {An} algorithm for automatic capturing of + the font outlines}, + year = 2002, + volume = 26, + number = 5, + pages = {795-804}, + issn = {0097-8493}, + journal = {Computers and Graphics}, + annotation = {An \texttt{article} entry with an \texttt{issn} field}, +} + +@Article{shore, + author = {Shore, Bradd}, + title = {Twice-Born, Once Conceived}, journaltitle = {American Anthropologist}, - volume = {93}, - series = {newseries}, - number = {1}, - date = {1991-03}, - pages = {9--27}, - annotation = {An \texttt{article} entry with \texttt{series}, - \texttt{volume}, and \texttt{number} fields. Note the format of the - \texttt{series} which is a localization key} -} -@article{sigfridsson, - hyphenation = {american}, - author = {Sigfridsson, Emma and Ryde, Ulf}, - indextitle = {Methods for deriving atomic charges}, - title = {Comparison of methods for deriving atomic charges from the - electrostatic potential and moments}, + date = {1991-03}, + subtitle = {Meaning Construction and Cultural Cognition}, + series = {newseries}, + volume = 93, + number = 1, + pages = {9-27}, + annotation = {An \texttt{article} entry with \texttt{series}, + \texttt{volume}, and \texttt{number} fields. Note the format + of the \texttt{series} which is a localization key}, +} + +@Article{sigfridsson, + author = {Sigfridsson, Emma and Ryde, Ulf}, + title = {Comparison of methods for deriving atomic charges from the + electrostatic potential and moments}, journaltitle = {Journal of Computational Chemistry}, - volume = {19}, - number = {4}, - date = {1998}, - doi = {10.1002/(SICI)1096-987X(199803)19:4<377::AID-JCC1>3.0.CO;2-P}, - pages = {377--395}, - annotation = {An \texttt{article} entry with \texttt{volume}, - \texttt{number}, and \texttt{doi} fields. Note that the \textsc{doi} is - transformed into a clickable link if \texttt{hyperref} support has been - enabled}, - abstract = {Four methods for deriving partial atomic charges from the - quantum chemical electrostatic potential (CHELP, CHELPG, Merz-Kollman, and - RESP) have been compared and critically evaluated. It is shown that - charges strongly depend on how and where the potential points are - selected. Two alternative methods are suggested to avoid the - arbitrariness in the point-selection schemes and van der Waals exclusion - radii: CHELP-BOW, which also estimates the charges from the electrostatic - potential, but with potential points that are Boltzmann-weighted after - their occurrence in actual simulations using the energy function of the - program in which the charges will be used, and CHELMO, which estimates - the charges directly from the electrostatic multipole moments. Different - criteria for the quality of the charges are discussed.} -} -@article{spiegelberg, - hyphenation = {german}, - sorttitle = {Intention und Intentionalitat in der Scholastik, bei Brentano - und Husserl}, - indexsorttitle = {Intention und Intentionalitat in der Scholastik, bei - Brentano und Husserl}, - author = {Spiegelberg, Herbert}, - title = {\mkbibquote{Intention} und \mkbibquote{Intentionalit{\"a}t} in der - Scholastik, bei Brentano und Husserl}, - shorttitle = {Intention und Intentionalit{\"a}t}, + date = 1998, + volume = 19, + number = 4, + pages = {377-395}, + doi = {10.1002/(SICI)1096-987X(199803)19:4<377::AID-JCC1>3.0.CO;2-P}, + hyphenation = {american}, + indextitle = {Methods for deriving atomic charges}, + annotation = {An \texttt{article} entry with \texttt{volume}, + \texttt{number}, and \texttt{doi} fields. Note that the + \textsc{doi} is transformed into a clickable link if + \texttt{hyperref} support has been enabled}, + abstract = {Four methods for deriving partial atomic charges from the + quantum chemical electrostatic potential (CHELP, CHELPG, + Merz-Kollman, and RESP) have been compared and critically + evaluated. It is shown that charges strongly depend on how and + where the potential points are selected. Two alternative + methods are suggested to avoid the arbitrariness in the + point-selection schemes and van der Waals exclusion radii: + CHELP-BOW, which also estimates the charges from the + electrostatic potential, but with potential points that are + Boltzmann-weighted after their occurrence in actual + simulations using the energy function of the program in which + the charges will be used, and CHELMO, which estimates the + charges directly from the electrostatic multipole + moments. Different criteria for the quality of the charges are + discussed.}, +} + +@Article{spiegelberg, + author = {Spiegelberg, Herbert}, + title = {\mkbibquote{Intention} und \mkbibquote{Intentionalit{\"a}t} in + der Scholastik, bei Brentano und Husserl}, journaltitle = {Studia Philosophica}, - volume = {29}, - date = {1969}, - pages = {189--216}, - annotation = {An \texttt{article} entry. Note the \texttt{sorttitle} and - \texttt{indexsorttitle} fields and the markup of the quotes in the - database file} -} -@article{springer, - hyphenation = {british}, - author = {Springer, Otto}, - title = {Mediaeval Pilgrim Routes from Scandinavia to Rome}, - shorttitle = {Mediaeval Pilgrim Routes}, + date = 1969, + volume = 29, + pages = {189-216}, + hyphenation = {german}, + sorttitle = {Intention und Intentionalitat in der Scholastik, bei Brentano + und Husserl}, + indexsorttitle= {Intention und Intentionalitat in der Scholastik, bei Brentano + und Husserl}, + shorttitle = {Intention und Intentionalit{\"a}t}, + annotation = {An \texttt{article} entry. Note the \texttt{sorttitle} and + \texttt{indexsorttitle} fields and the markup of the quotes in + the database file}, +} + +@Article{springer, + author = {Springer, Otto}, + title = {Mediaeval Pilgrim Routes from Scandinavia to Rome}, journaltitle = {Mediaeval Studies}, - volume = {12}, - date = {1950}, - pages = {92--122}, - annotation = {A plain \texttt{article} entry} -} -@article{weinberg, - author = {Weinberg, Steven}, - title = {A Model of Leptons}, + date = 1950, + volume = 12, + pages = {92-122}, + hyphenation = {british}, + shorttitle = {Mediaeval Pilgrim Routes}, + annotation = {A plain \texttt{article} entry}, +} + +@Article{weinberg, + author = {Weinberg, Steven}, + title = {A Model of Leptons}, journaltitle = {Phys.~Rev.~Lett.}, - volume = {19}, - date = {1967}, - pages = {1264--1266} -} -@article{yoon, - author = {Yoon, Myeong S. and Ryu, Dowook and Kim, Jeongryul - and Ahn, Kyo Han}, - indextitle = {Palladium pincer complexes}, - title = {Palladium pincer complexes with reduced bond angle strain: - efficient catalysts for the Heck reaction}, + date = 1967, + volume = 19, + pages = {1264-1266}, +} + +@Article{yoon, + author = {Yoon, Myeong S. and Ryu, Dowook and Kim, Jeongryul and Ahn, + Kyo Han}, + title = {Palladium pincer complexes with reduced bond angle strain: + efficient catalysts for the Heck reaction}, journaltitle = {Organometallics}, - volume = {25}, - number = {10}, - date = {2006}, - pages = {2409--2411} -} -@book{aristotle:anima, - keywords = {primary}, - hyphenation = {british}, - author = {Aristotle}, - editor = {Hicks, Robert Drew}, - title = {De Anima}, - publisher = cup, - location = {Cambridge}, - date = {1907}, - annotation = {A \texttt{book} entry with an \texttt{author} and an - \texttt{editor}} -} -@book{aristotle:physics, - keywords = {primary}, - hyphenation = {american}, - author = {Aristotle}, - translator = {Wicksteed, P. H. and Cornford, F. M.}, - title = {Physics}, - shorttitle = {Physics}, - publisher = {G. P. Putnam}, - location = {New York}, - date = {1929}, - annotation = {A \texttt{book} entry with a \texttt{translator} field} -} -@book{aristotle:poetics, - keywords = {primary}, - hyphenation = {british}, - author = {Aristotle}, - editor = {Lucas, D. W.}, - title = {Poetics}, - shorttitle = {Poetics}, - series = {Clarendon Aristotle}, - publisher = {Clarendon Press}, - location = {Oxford}, - date = {1968}, - annotation = {A \texttt{book} entry with an \texttt{author} and an - \texttt{editor} as well as a \texttt{series} field} -} -@book{aristotle:rhetoric, - keywords = {primary}, - hyphenation = {british}, - sorttitle = {Rhetoric of Aristotle}, - author = {Aristotle}, - editor = {Cope, Edward Meredith}, - commentator = {Cope, Edward Meredith}, - indextitle = {Rhetoric of Aristotle, The}, - title = {The Rhetoric of Aristotle with a commentary by the late Edward - Meredith Cope}, - shorttitle = {Rhetoric}, - volumes = {3}, - publisher = cup, - date = {1877}, - annotation = {A commented edition. Note the concatenation of the - \texttt{editor} and \texttt{commentator} fields as well as the - \texttt{volumes}, \texttt{sorttitle}, and \texttt{indextitle} fields} -} -@book{augustine, - hyphenation = {american}, - author = {Augustine, Robert L.}, - title = {Heterogeneous catalysis for the synthetic chemist}, - shorttitle = {Heterogeneous catalysis}, - publisher = {Marcel Dekker}, - location = {New York}, - date = {1995}, - annotation = {A plain \texttt{book} entry} -} -@book{averroes/bland, - keywords = {primary}, - hyphenation = {american}, - author = {Averroes}, - editor = {Bland, Kalman P.}, - translator = {Bland, Kalman P.}, - indextitle = {Epistle on the Possibility of Conjunction, The}, - title = {The Epistle on the Possibility of Conjunction with the Active - Intellect by Ibn Rushd with the Commentary of Moses Narboni}, - shorttitle = {Possibility of Conjunction}, - series = {Moreshet: Studies in Jewish History, Literature and Thought}, - number = {7}, - publisher = {Jewish Theological Seminary of America}, - location = {New York}, - date = {1982}, - annotation = {A \texttt{book} entry with a \texttt{series} and a - \texttt{number}. Note the concatenation of the \texttt{editor} and - \texttt{translator} fields as well as the \texttt{indextitle} field} -} -@book{averroes/hannes, - keywords = {primary}, - hyphenation = {german}, - sorttitle = {Uber die Moglichkeit der Conjunktion}, - indexsorttitle = {Uber die Moglichkeit der Conjunktion}, - author = {Averroes}, - editor = {Hannes, Ludwig}, - translator = {Hannes, Ludwig}, - annotator = {Hannes, Ludwig}, - indextitle = {{\"U}ber die M{\"o}glichkeit der Conjunktion}, - title = {Des Averro{\"e}s Abhandlung: \mkbibquote{{\"U}ber die - M{\"o}glichkeit der Conjunktion} oder \mkbibquote{{\"U}ber den - materiellen Intellekt}}, - shorttitle = {{\"U}ber die M{\"o}glichkeit der Conjunktion}, - publisher = {C.~A. Kaemmerer}, - location = {Halle an der Saale}, - date = {1892}, - annotation = {An annotated edition. Note the concatenation of the - \texttt{editor}, \texttt{translator}, and \texttt{annotator} fields. Also - note the \texttt{shorttitle}, \texttt{indextitle}, \texttt{sorttitle}, - and \texttt{indexsorttitle} fields} -} -@book{averroes/hercz, - keywords = {primary}, - hyphenation = {german}, - indexsorttitle = {Drei Abhandlungen uber die Conjunction}, - author = {Averroes}, - editor = {Hercz, J.}, - translator = {Hercz, J.}, - indextitle = {Drei Abhandlungen {\"u}ber die Conjunction}, - title = {Drei Abhandlungen {\"u}ber die Conjunction des separaten Intellects - mit dem Menschen}, - subtitle = {Von Averroes (Vater und Sohn), aus dem Arabischen {\"u}bersetzt - von Samuel Ibn Tibbon}, - shorttitle = {Drei Abhandlungen}, - publisher = {S.~Hermann}, - location = {Berlin}, - date = {1869}, - annotation = {A \texttt{book} entry. Note the concatenation of the - \texttt{editor} and \texttt{translator} fields as well as the - \texttt{indextitle} and \texttt{indexsorttitle} fields} -} -@book{cicero, - hyphenation = {german}, - author = {Cicero, Marcus Tullius}, - editor = {Blank-Sangmeister, Ursula}, - translator = {Blank-Sangmeister, Ursula}, - afterword = {Thraede, Klaus}, - indextitle = {De natura deorum}, - title = {De natura deorum. {\"U}ber das Wesen der G{\"o}tter}, - shorttitle = {De natura deorum}, - language = {langlatin and langgerman}, - publisher = {Reclam}, - location = {Stuttgart}, - date = {1995}, - annotation = {A bilingual edition of Cicero's \emph{De natura deorum}, with - a German translation. Note the format of the \texttt{language} field in - the database file, the concatenation of the \texttt{editor} and - \texttt{translator} fields, and the \texttt{afterword} field} -} -@book{coleridge, - hyphenation = {british}, - author = {Coleridge, Samuel Taylor}, - editor = {Coburn, Kathleen and Engell, James and Bate, W. Jackson}, - indextitle = {Biographia literaria}, - title = {Biographia literaria, or Biographical sketches of my literary life - and opinions}, - shorttitle = {Biographia literaria}, - maintitle = {The collected works of Samuel Taylor Coleridge}, - part = {2}, - volume = {7}, - series = {Bollingen Series}, - number = {75}, - publisher = {Routledge and Kegan Paul}, - location = {London}, - date = {1983}, - annotation = {One (partial) volume of a multivolume book. This is a - \texttt{book} entry with a \texttt{volume} and a \texttt{part} field - which explicitly refers to the second (physical) part of the seventh - (logical) volume. Also note the \texttt{series} and \texttt{number} - fields} -} -@book{companion, - hyphenation = {american}, - sorttitle = {LaTeX Companion}, - author = {Goossens, Michel and Mittelbach, Frank and Samarin, Alexander}, - indextitle = {LaTeX Companion, The}, - title = {The LaTeX Companion}, - shorttitle = {LaTeX Companion}, - edition = {1}, - publisher = {Addison-Wesley}, - location = {Reading, Mass.}, - date = {1994}, - pagetotal = {528}, - annotation = {A book with three authors. Note the formatting of the author - list. By default, only the first name is reversed in the bibliography} -} -@book{cotton, - hyphenation = {british}, - author = {Cotton, Frank Albert and Wilkinson, Geoffrey - and Murillio, Carlos A. and Bochmann, Manfred}, - title = {Advanced inorganic chemistry}, - edition = {6}, - publisher = {Wiley}, - location = {Chichester}, - date = {1999}, - annotation = {A \texttt{book} entry with \arabic{author} authors and an - \texttt{edition} field. By default, long \texttt{author} and - \texttt{editor} lists are automatically truncated. This is configurable} -} -@book{gerhardt, - hyphenation = {american}, - sorttitle = {Federal Appointments Process}, - author = {Gerhardt, Michael J.}, - indextitle = {Federal Appointments Process, The}, - title = {The Federal Appointments Process}, - subtitle = {A Constitutional and Historical Analysis}, - shorttitle = {Federal Appointments Process}, - publisher = {Duke University Press}, - location = {Durham and London}, - date = {2000}, - annotation = {This is a \texttt{book} entry. Note the format of the - \texttt{location} field as well as the \texttt{sorttitle} and - \texttt{indextitle} fields} -} -@book{gonzalez, - hyphenation = {american}, - sorttitle = {Ghost of John Wayne and Other Stories}, - author = {Gonzalez, Ray}, - indextitle = {Ghost of John Wayne and Other Stories, The}, - title = {The Ghost of John Wayne and Other Stories}, - shorttitle = {Ghost of John Wayne}, - publisher = {The University of Arizona Press}, - location = {Tucson}, - date = {2001}, - isbn = {0-816-52066-6}, - annotation = {A collection of short stories. This is a \texttt{book} entry. - Note the \texttt{sorttitle} and \texttt{indextitle} fields in the - database file. There's also an \texttt{isbn} field} -} -@book{hammond, - hyphenation = {british}, - sorttitle = {Basics of crystallography and diffraction}, - author = {Hammond, Christopher}, - indextitle = {Basics of crystallography and diffraction, The}, - title = {The basics of crystallography and diffraction}, - shorttitle = {Crystallography and diffraction}, - publisher = {International Union of Crystallography and Oxford University - Press}, - location = {Oxford}, - date = {1997}, - annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and - \texttt{indextitle} fields as well as the format of the - \texttt{publisher} field} -} -@book{iliad, - hyphenation = {german}, - sorttitle = {Ilias}, - author = {Homer}, - translator = {Schadewaldt, Wolfgang}, + date = 2006, + volume = 25, + number = 10, + pages = {2409-2411}, + indextitle = {Palladium pincer complexes}, +} + +@Book{aristotle:anima, + author = {Aristotle}, + title = {De Anima}, + date = 1907, + editor = {Hicks, Robert Drew}, + publisher = cup, + location = {Cambridge}, + keywords = {primary}, + hyphenation = {british}, + annotation = {A \texttt{book} entry with an \texttt{author} and an + \texttt{editor}}, +} + +@Book{aristotle:physics, + author = {Aristotle}, + title = {Physics}, + date = 1929, + translator = {Wicksteed, P. H. and Cornford, F. M.}, + publisher = {G. P. Putnam}, + location = {New York}, + keywords = {primary}, + hyphenation = {american}, + shorttitle = {Physics}, + annotation = {A \texttt{book} entry with a \texttt{translator} field}, +} + +@Book{aristotle:poetics, + author = {Aristotle}, + title = {Poetics}, + date = 1968, + editor = {Lucas, D. W.}, + series = {Clarendon Aristotle}, + publisher = {Clarendon Press}, + location = {Oxford}, + keywords = {primary}, + hyphenation = {british}, + shorttitle = {Poetics}, + annotation = {A \texttt{book} entry with an \texttt{author} and an + \texttt{editor} as well as a \texttt{series} field}, +} + +@Book{aristotle:rhetoric, + author = {Aristotle}, + title = {The Rhetoric of Aristotle with a commentary by the late Edward + Meredith Cope}, + date = 1877, + editor = {Cope, Edward Meredith}, + commentator = {Cope, Edward Meredith}, + volumes = 3, + publisher = cup, + keywords = {primary}, + hyphenation = {british}, + sorttitle = {Rhetoric of Aristotle}, + indextitle = {Rhetoric of Aristotle, The}, + shorttitle = {Rhetoric}, + annotation = {A commented edition. Note the concatenation of the + \texttt{editor} and \texttt{commentator} fields as well as the + \texttt{volumes}, \texttt{sorttitle}, and \texttt{indextitle} + fields}, +} + +@Book{augustine, + author = {Augustine, Robert L.}, + title = {Heterogeneous catalysis for the synthetic chemist}, + date = 1995, + publisher = {Marcel Dekker}, + location = {New York}, + hyphenation = {american}, + shorttitle = {Heterogeneous catalysis}, + annotation = {A plain \texttt{book} entry}, +} + +@Book{averroes/bland, + author = {Averroes}, + title = {The Epistle on the Possibility of Conjunction with the Active + Intellect by Ibn Rushd with the Commentary of Moses Narboni}, + date = 1982, + editor = {Bland, Kalman P.}, + translator = {Bland, Kalman P.}, + series = {Moreshet: Studies in Jewish History, Literature and Thought}, + number = 7, + publisher = {Jewish Theological Seminary of America}, + location = {New York}, + keywords = {primary}, + hyphenation = {american}, + indextitle = {Epistle on the Possibility of Conjunction, The}, + shorttitle = {Possibility of Conjunction}, + annotation = {A \texttt{book} entry with a \texttt{series} and a + \texttt{number}. Note the concatenation of the \texttt{editor} + and \texttt{translator} fields as well as the + \texttt{indextitle} field}, +} + +@Book{averroes/hannes, + author = {Averroes}, + title = {Des Averro{\"e}s Abhandlung: \mkbibquote{{\"U}ber die + M{\"o}glichkeit der Conjunktion} oder \mkbibquote{{\"U}ber den + materiellen Intellekt}}, + date = 1892, + editor = {Hannes, Ludwig}, + translator = {Hannes, Ludwig}, + annotator = {Hannes, Ludwig}, + publisher = {C.~A. Kaemmerer}, + location = {Halle an der Saale}, + keywords = {primary}, + hyphenation = {german}, + sorttitle = {Uber die Moglichkeit der Conjunktion}, + indexsorttitle= {Uber die Moglichkeit der Conjunktion}, + indextitle = {{\"U}ber die M{\"o}glichkeit der Conjunktion}, + shorttitle = {{\"U}ber die M{\"o}glichkeit der Conjunktion}, + annotation = {An annotated edition. Note the concatenation of the + \texttt{editor}, \texttt{translator}, and \texttt{annotator} + fields. Also note the \texttt{shorttitle}, + \texttt{indextitle}, \texttt{sorttitle}, and + \texttt{indexsorttitle} fields}, +} + +@Book{averroes/hercz, + author = {Averroes}, + title = {Drei Abhandlungen {\"u}ber die Conjunction des separaten + Intellects mit dem Menschen}, + date = 1869, + editor = {Hercz, J.}, + translator = {Hercz, J.}, + publisher = {S.~Hermann}, + location = {Berlin}, + keywords = {primary}, + hyphenation = {german}, + indexsorttitle= {Drei Abhandlungen uber die Conjunction}, + indextitle = {Drei Abhandlungen {\"u}ber die Conjunction}, + subtitle = {Von Averroes (Vater und Sohn), aus dem Arabischen + {\"u}bersetzt von Samuel Ibn Tibbon}, + shorttitle = {Drei Abhandlungen}, + annotation = {A \texttt{book} entry. Note the concatenation of the + \texttt{editor} and \texttt{translator} fields as well as the + \texttt{indextitle} and \texttt{indexsorttitle} fields}, +} + +@Book{cicero, + author = {Cicero, Marcus Tullius}, + title = {De natura deorum. {\"U}ber das Wesen der G{\"o}tter}, + date = 1995, + editor = {Blank-Sangmeister, Ursula}, + translator = {Blank-Sangmeister, Ursula}, + afterword = {Thraede, Klaus}, + language = {langlatin and langgerman}, + publisher = {Reclam}, + location = {Stuttgart}, + hyphenation = {german}, + indextitle = {De natura deorum}, + shorttitle = {De natura deorum}, + annotation = {A bilingual edition of Cicero's \emph{De natura deorum}, with + a German translation. Note the format of the \texttt{language} + field in the database file, the concatenation of the + \texttt{editor} and \texttt{translator} fields, and the + \texttt{afterword} field}, +} + +@Book{coleridge, + author = {Coleridge, Samuel Taylor}, + title = {Biographia literaria, or Biographical sketches of my literary + life and opinions}, + date = 1983, + editor = {Coburn, Kathleen and Engell, James and Bate, W. Jackson}, + maintitle = {The collected works of Samuel Taylor Coleridge}, + volume = 7, + part = 2, + series = {Bollingen Series}, + number = 75, + publisher = {Routledge and Kegan Paul}, + location = {London}, + hyphenation = {british}, + indextitle = {Biographia literaria}, + shorttitle = {Biographia literaria}, + annotation = {One (partial) volume of a multivolume book. This is a + \texttt{book} entry with a \texttt{volume} and a \texttt{part} + field which explicitly refers to the second (physical) part of + the seventh (logical) volume. Also note the \texttt{series} + and \texttt{number} fields}, +} + +@Book{companion, + author = {Goossens, Michel and Mittelbach, Frank and Samarin, Alexander}, + title = {The LaTeX Companion}, + date = 1994, + edition = 1, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + pagetotal = 528, + hyphenation = {american}, + sorttitle = {LaTeX Companion}, + indextitle = {LaTeX Companion, The}, + shorttitle = {LaTeX Companion}, + annotation = {A book with three authors. Note the formatting of the author + list. By default, only the first name is reversed in the + bibliography}, +} + +@Book{cotton, + author = {Cotton, Frank Albert and Wilkinson, Geoffrey and Murillio, + Carlos A. and Bochmann, Manfred}, + title = {Advanced inorganic chemistry}, + date = 1999, + edition = 6, + publisher = {Wiley}, + location = {Chichester}, + hyphenation = {british}, + annotation = {A \texttt{book} entry with \arabic{author} authors and an + \texttt{edition} field. By default, long \texttt{author} and + \texttt{editor} lists are automatically truncated. This is + configurable}, +} + +@Book{gerhardt, + author = {Gerhardt, Michael J.}, + title = {The Federal Appointments Process}, + date = 2000, + publisher = {Duke University Press}, + location = {Durham and London}, + hyphenation = {american}, + sorttitle = {Federal Appointments Process}, + indextitle = {Federal Appointments Process, The}, + subtitle = {A Constitutional and Historical Analysis}, + shorttitle = {Federal Appointments Process}, + annotation = {This is a \texttt{book} entry. Note the format of the + \texttt{location} field as well as the \texttt{sorttitle} and + \texttt{indextitle} fields}, +} + +@Book{gonzalez, + author = {Gonzalez, Ray}, + title = {The Ghost of John Wayne and Other Stories}, + date = 2001, + publisher = {The University of Arizona Press}, + location = {Tucson}, + isbn = {0-816-52066-6}, + hyphenation = {american}, + sorttitle = {Ghost of John Wayne and Other Stories}, + indextitle = {Ghost of John Wayne and Other Stories, The}, + shorttitle = {Ghost of John Wayne}, + annotation = {A collection of short stories. This is a \texttt{book} entry. + Note the \texttt{sorttitle} and \texttt{indextitle} fields in + the database file. There's also an \texttt{isbn} field}, +} + +@Book{hammond, + author = {Hammond, Christopher}, + title = {The basics of crystallography and diffraction}, + date = 1997, + publisher = {International Union of Crystallography and Oxford University + Press}, + location = {Oxford}, + hyphenation = {british}, + sorttitle = {Basics of crystallography and diffraction}, + indextitle = {Basics of crystallography and diffraction, The}, + shorttitle = {Crystallography and diffraction}, + annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and + \texttt{indextitle} fields as well as the format of the + \texttt{publisher} field}, +} + +@Book{iliad, + author = {Homer}, + title = {Die Ilias}, + date = 2004, + translator = {Schadewaldt, Wolfgang}, introduction = {Latacz, Joachim}, - indextitle = {Ilias, Die}, - title = {Die Ilias}, - shorttitle = {Ilias}, - edition = {3}, - publisher = {Artemis \& Winkler}, - location = {D{\"u}sseldorf and Z{\"u}rich}, - date = {2004}, - annotation = {A German translation of the \emph{Iliad}. Note the - \texttt{translator} and \texttt{introduction} fields and the format of - the \texttt{location} field in the database file. Also note the - \texttt{sorttitle} and \texttt{indextitle} fields} -} -@book{knuth:ct, - hyphenation = {american}, - sortyear = {1984-0}, - sorttitle = {Computers & Typesetting}, - indexsorttitle = {Computers & Typesetting}, - author = {Knuth, Donald E.}, - title = {Computers \& Typesetting}, - volumes = {5}, - publisher = {Addison-Wesley}, - location = {Reading, Mass.}, - date = {1984/1986}, - annotation = {A five-volume book cited as a whole. This is a \texttt{book} - entry, note the \texttt{volumes} field} -} -@book{knuth:ct:a, - hyphenation = {american}, - sortyear = {1984-1}, - sorttitle = {Computers & Typesetting A}, - indexsorttitle = {The TeXbook}, - author = {Knuth, Donald E.}, - indextitle = {\protect\TeX book, The}, - title = {The \TeX book}, - shorttitle = {\TeX book}, - maintitle = {Computers \& Typesetting}, - volume = {A}, - publisher = {Addison-Wesley}, - location = {Reading, Mass.}, - date = {1984}, - annotation = {The first volume of a five-volume book. Note the - \texttt{sorttitle} and \texttt{sortyear} fields. We want this volume to - be listed after the entry referring to the entire five-volume set. Also - note the \texttt{indextitle} and \texttt{indexsorttitle} fields. Indexing - packages that don't generate robust index entries require some control - sequences to be protected from expansion} -} -@book{knuth:ct:b, - hyphenation = {american}, - sortyear = {1986-1}, - sorttitle = {Computers & Typesetting B}, - indexsorttitle = {TeX: The Program}, - author = {Knuth, Donald E.}, - title = {\TeX: The Program}, - shorttitle = {\TeX}, - maintitle = {Computers \& Typesetting}, - volume = {B}, - publisher = {Addison-Wesley}, - location = {Reading, Mass.}, - date = {1986}, - annotation = {The second volume of a five-volume book. Note the - \texttt{sorttitle} and \texttt{sortyear} fields. Also note the - \texttt{indexsorttitle} field} -} -@book{knuth:ct:c, - hyphenation = {american}, - sortyear = {1986-2}, - sorttitle = {Computers & Typesetting C}, - author = {Knuth, Donald E.}, - indextitle = {METAFONTbook, The}, - title = {The METAFONTbook}, - shorttitle = {METAFONTbook}, - maintitle = {Computers \& Typesetting}, - volume = {C}, - publisher = {Addison-Wesley}, - location = {Reading, Mass.}, - date = {1986}, - annotation = {The third volume of a five-volume book. Note the - \texttt{sorttitle} and \texttt{sortyear} fields as well as the - \texttt{indextitle} field} -} -@book{knuth:ct:d, - hyphenation = {american}, - sortyear = {1986-3}, - sorttitle = {Computers & Typesetting D}, - author = {Knuth, Donald E.}, - title = {METAFONT: The Program}, - shorttitle = {METAFONT}, - maintitle = {Computers \& Typesetting}, - volume = {D}, - publisher = {Addison-Wesley}, - location = {Reading, Mass.}, - date = {1986}, - annotation = {The fourth volume of a five-volume book. Note the - \texttt{sorttitle} and \texttt{sortyear} fields} -} -@book{knuth:ct:e, - hyphenation = {american}, - sortyear = {1986-4}, - sorttitle = {Computers & Typesetting E}, - author = {Knuth, Donald E.}, - title = {Computer Modern Typefaces}, - maintitle = {Computers \& Typesetting}, - volume = {E}, - publisher = {Addison-Wesley}, - location = {Reading, Mass.}, - date = {1986}, - annotation = {The fifth volume of a five-volume book. Note the - \texttt{sorttitle} and \texttt{sortyear} fields} -} -@book{knuth:ct:related, - hyphenation = {american}, - sortyear = {1984-0}, - sorttitle = {Computers & Typesetting}, - indexsorttitle = {Computers & Typesetting}, - author = {Knuth, Donald E.}, - title = {Computers \& Typesetting}, - volumes = {5}, - related = {knuth:ct:a,knuth:ct:b,knuth:ct:c,knuth:ct:d,knuth:ct:e}, - relatedtype = {multivolume}, - publisher = {Addison-Wesley}, - location = {Reading, Mass.}, - date = {1984/1986}, - annotation = {A five-volume book cited as a whole and related to its - individual volumes. Note the \texttt{related} and \texttt{relatedtype} - fields} -} -@book{kullback, - title = {Information Theory and Statistics}, - author = {Kullback, Solomon}, - year = {1959}, - publisher = {John Wiley \& Sons}, - location = {New York} -} -@book{kullback:reprint, - title = {Information Theory and Statistics}, - author = {Kullback, Solomon}, - year = {1997}, - origyear = {1959}, - publisher = {Dover Publications}, - origpublisher = {John Wiley \& Sons}, - location = {New York}, - annotation = {A reprint of the \texttt{kullback} entry. Note the format of - \texttt{origyear} and \texttt{origpublisher}. These fields are not used by - the standard bibliography styles} -} -@book{kullback:related, - title = {Information Theory and Statistics}, - author = {Kullback, Solomon}, - year = {1997}, - publisher = {Dover Publications}, - location = {New York}, - related = {kullback}, - relatedtype = {origpubin}, - annotation = {A reprint of the \texttt{kullback} entry. Note the format of - the \texttt{related} and \texttt{relatedtype} fields} -} -@book{malinowski, - hyphenation = {british}, - author = {Malinowski, Bronis{\l}aw}, - title = {Argonauts of the Western Pacific}, - subtitle = {An account of native enterprise and adventure in the - Archipelagoes of Melanesian New Guinea}, - shorttitle = {Argonauts}, - edition = {8}, - publisher = {Routledge and Kegan Paul}, - location = {London}, - date = {1972}, - annotation = {This is a \texttt{book} entry. Note the format of the - \texttt{publisher} and \texttt{edition} fields as well as the - \texttt{subtitle} field} -} -@book{maron, - hyphenation = {american}, - author = {Maron, Monika}, - translator = {Brigitte Goldstein}, - title = {Animal Triste}, - shorttitle = {Animal Triste}, - publisher = {University of Nebraska Press}, - location = {Lincoln}, - date = {2000}, + edition = 3, + publisher = {Artemis \& Winkler}, + location = {D{\"u}sseldorf and Z{\"u}rich}, + hyphenation = {german}, + sorttitle = {Ilias}, + indextitle = {Ilias, Die}, + shorttitle = {Ilias}, + annotation = {A German translation of the \emph{Iliad}. Note the + \texttt{translator} and \texttt{introduction} fields and the + format of the \texttt{location} field in the database + file. Also note the \texttt{sorttitle} and \texttt{indextitle} + fields}, +} + +@Book{knuth:ct, + author = {Knuth, Donald E.}, + title = {Computers \& Typesetting}, + date = {1984/1986}, + volumes = 5, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + hyphenation = {american}, + sortyear = {1984-0}, + sorttitle = {Computers & Typesetting}, + indexsorttitle= {Computers & Typesetting}, + annotation = {A five-volume book cited as a whole. This is a \texttt{book} + entry, note the \texttt{volumes} field}, +} + +@Book{knuth:ct:a, + author = {Knuth, Donald E.}, + title = {The \TeX book}, + date = 1984, + maintitle = {Computers \& Typesetting}, + volume = {A}, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + hyphenation = {american}, + sortyear = {1984-1}, + sorttitle = {Computers & Typesetting A}, + indexsorttitle= {The TeXbook}, + indextitle = {\protect\TeX book, The}, + shorttitle = {\TeX book}, + annotation = {The first volume of a five-volume book. Note the + \texttt{sorttitle} and \texttt{sortyear} fields. We want this + volume to be listed after the entry referring to the entire + five-volume set. Also note the \texttt{indextitle} and + \texttt{indexsorttitle} fields. Indexing packages that don't + generate robust index entries require some control sequences + to be protected from expansion}, +} + +@Book{knuth:ct:b, + author = {Knuth, Donald E.}, + title = {\TeX: The Program}, + date = 1986, + maintitle = {Computers \& Typesetting}, + volume = {B}, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + hyphenation = {american}, + sortyear = {1986-1}, + sorttitle = {Computers & Typesetting B}, + indexsorttitle= {TeX: The Program}, + shorttitle = {\TeX}, + annotation = {The second volume of a five-volume book. Note the + \texttt{sorttitle} and \texttt{sortyear} fields. Also note the + \texttt{indexsorttitle} field}, +} + +@Book{knuth:ct:c, + author = {Knuth, Donald E.}, + title = {The METAFONTbook}, + date = 1986, + maintitle = {Computers \& Typesetting}, + volume = {C}, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + hyphenation = {american}, + sortyear = {1986-2}, + sorttitle = {Computers & Typesetting C}, + indextitle = {METAFONTbook, The}, + shorttitle = {METAFONTbook}, + annotation = {The third volume of a five-volume book. Note the + \texttt{sorttitle} and \texttt{sortyear} fields as well as the + \texttt{indextitle} field}, +} + +@Book{knuth:ct:d, + author = {Knuth, Donald E.}, + title = {METAFONT: The Program}, + date = 1986, + maintitle = {Computers \& Typesetting}, + volume = {D}, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + hyphenation = {american}, + sortyear = {1986-3}, + sorttitle = {Computers & Typesetting D}, + shorttitle = {METAFONT}, + annotation = {The fourth volume of a five-volume book. Note the + \texttt{sorttitle} and \texttt{sortyear} fields}, +} + +@Book{knuth:ct:e, + author = {Knuth, Donald E.}, + title = {Computer Modern Typefaces}, + date = 1986, + maintitle = {Computers \& Typesetting}, + volume = {E}, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + hyphenation = {american}, + sortyear = {1986-4}, + sorttitle = {Computers & Typesetting E}, + annotation = {The fifth volume of a five-volume book. Note the + \texttt{sorttitle} and \texttt{sortyear} fields}, +} + +@Book{knuth:ct:related, + author = {Knuth, Donald E.}, + title = {Computers \& Typesetting}, + date = {1984/1986}, + volumes = 5, + publisher = {Addison-Wesley}, + location = {Reading, Mass.}, + hyphenation = {american}, + sortyear = {1984-0}, + sorttitle = {Computers & Typesetting}, + indexsorttitle= {Computers & Typesetting}, + related = {knuth:ct:a,knuth:ct:b,knuth:ct:c,knuth:ct:d,knuth:ct:e}, + relatedtype = {multivolume}, + annotation = {A five-volume book cited as a whole and related to its + individual volumes. Note the \texttt{related} and + \texttt{relatedtype} fields}, +} + +@Book{kullback, + author = {Kullback, Solomon}, + title = {Information Theory and Statistics}, + year = 1959, + publisher = {John Wiley \& Sons}, + location = {New York}, + hyphenation = {american}, +} + +@Book{kullback:reprint, + author = {Kullback, Solomon}, + title = {Information Theory and Statistics}, + year = 1997, + publisher = {Dover Publications}, + location = {New York}, + origyear = 1959, + origpublisher= {John Wiley \& Sons}, + hyphenation = {american}, + annotation = {A reprint of the \texttt{kullback} entry. Note the format of + \texttt{origyear} and \texttt{origpublisher}. These fields are + not used by the standard bibliography styles}, +} + +@Book{kullback:related, + author = {Kullback, Solomon}, + title = {Information Theory and Statistics}, + year = 1997, + publisher = {Dover Publications}, + location = {New York}, + hyphenation = {american}, + related = {kullback}, + relatedtype = {origpubin}, + annotation = {A reprint of the \texttt{kullback} entry. Note the format of + the \texttt{related} and \texttt{relatedtype} fields}, +} + +@Book{malinowski, + author = {Malinowski, Bronis{\l}aw}, + title = {Argonauts of the Western Pacific}, + date = 1972, + edition = 8, + publisher = {Routledge and Kegan Paul}, + location = {London}, + hyphenation = {british}, + subtitle = {An account of native enterprise and adventure in the + Archipelagoes of Melanesian New Guinea}, + shorttitle = {Argonauts}, + annotation = {This is a \texttt{book} entry. Note the format of the + \texttt{publisher} and \texttt{edition} fields as well as the + \texttt{subtitle} field}, +} + +@Book{maron, + author = {Maron, Monika}, + title = {Animal Triste}, + date = 2000, + translator = {Brigitte Goldstein}, origlanguage = {german}, - annotation = {An English translation of a German novel with a French title. - In other words: a \texttt{book} entry with a \texttt{translator} field. - Note the \texttt{origlanguage} field which is concatenated with the - \texttt{translator}} -} -@book{massa, - hyphenation = {british}, - author = {Werner Massa}, - title = {Crystal structure determination}, - edition = {2}, - publisher = {Spinger}, - location = {Berlin}, - date = {2004}, - annotation = {A \texttt{book} entry with an \texttt{edition} field} -} -@book{nietzsche:ksa, - hyphenation = {german}, - sortyear = {1988-00-000}, - sorttitle = {Werke-00-000}, - indexsorttitle = {Samtliche Werke}, - author = {Nietzsche, Friedrich}, - editor = {Colli, Giorgio and Montinari, Mazzino}, - title = {S{\"a}mtliche Werke}, - subtitle = {Kritische Studienausgabe}, - volumes = {15}, - edition = {2}, - publisher = dtv # { and Walter de Gruyter}, - location = {M{\"u}nchen and Berlin and New York}, - date = {1988}, - annotation = {The critical edition of Nietzsche's works. This is a - \texttt{book} entry referring to a 15-volume work as a whole. Note the - \texttt{volumes} field and the format of the \texttt{publisher} and - \texttt{location} fields in the database file. Also note the - \texttt{sorttitle} and \texttt{sortyear} fields which are used to - fine-tune the sorting order of the bibliography. We want this item listed - first in the bibliography} -} -@book{nietzsche:ksa1, - hyphenation = {german}, - sortyear = {1988-01-000}, - sorttitle = {Werke-01-000}, - indexsorttitle = {Samtliche Werke I}, - author = {Nietzsche, Friedrich}, - bookauthor = {Nietzsche, Friedrich}, - editor = {Colli, Giorgio and Montinari, Mazzino}, - indextitle = {S{\"a}mtliche Werke I}, - title = {Die Geburt der Trag{\"o}die. Unzeitgem{\"a}{\ss}e Betrachtungen - I--IV. Nachgelassene Schriften 1870--1973}, - shorttitle = {S{\"a}mtliche Werke I}, - maintitle = {S{\"a}mtliche Werke}, + publisher = {University of Nebraska Press}, + location = {Lincoln}, + hyphenation = {american}, + shorttitle = {Animal Triste}, + annotation = {An English translation of a German novel with a French title. + In other words: a \texttt{book} entry with a + \texttt{translator} field. Note the \texttt{origlanguage} + field which is concatenated with the \texttt{translator}}, +} + +@Book{massa, + author = {Werner Massa}, + title = {Crystal structure determination}, + date = 2004, + edition = 2, + publisher = {Spinger}, + location = {Berlin}, + hyphenation = {british}, + annotation = {A \texttt{book} entry with an \texttt{edition} field}, +} + +@Article{moore, + author = {Moore, Gordon E.}, + title = {Cramming more components onto integrated circuits}, + journaltitle = {Electronics}, + year = 1965, + volume = 38, + number = 8, + pages = {114-117}, + hyphenation = {american}, +} + +@Article{moore:related, + author = {Moore, Gordon E.}, + title = {Cramming more components onto integrated circuits}, + journaltitle = {Proceedings of the {IEEE}}, + year = 1998, + volume = 86, + number = 1, + pages = {82-85}, + hyphenation = {american}, + related = {moore}, + relatedtype = {reprintfrom}, + annotation = {A reprint of Moore's law. Note the \texttt{related} and + \texttt{relatedtype} fields}, +} + +@Book{nietzsche:ksa, + author = {Nietzsche, Friedrich}, + title = {S{\"a}mtliche Werke}, + date = 1988, + editor = {Colli, Giorgio and Montinari, Mazzino}, + edition = 2, + volumes = 15, + publisher = dtv # { and Walter de Gruyter}, + location = {M{\"u}nchen and Berlin and New York}, + hyphenation = {german}, + sortyear = {1988-0}, + sorttitle = {Werke-00-000}, + indexsorttitle= {Samtliche Werke}, + subtitle = {Kritische Studienausgabe}, + annotation = {The critical edition of Nietzsche's works. This is a + \texttt{book} entry referring to a 15-volume work as a + whole. Note the \texttt{volumes} field and the format of the + \texttt{publisher} and \texttt{location} fields in the + database file. Also note the \texttt{sorttitle} and + \texttt{sortyear} fields which are used to fine-tune the + sorting order of the bibliography. We want this item listed + first in the bibliography}, +} + +@Book{nietzsche:ksa1, + author = {Nietzsche, Friedrich}, + title = {Die Geburt der Trag{\"o}die. Unzeitgem{\"a}{\ss}e + Betrachtungen I--IV. Nachgelassene Schriften 1870--1973}, + date = 1988, + editor = {Colli, Giorgio and Montinari, Mazzino}, + maintitle = {S{\"a}mtliche Werke}, mainsubtitle = {Kritische Studienausgabe}, - volume = {1}, - edition = {2}, - publisher = dtv # { and Walter de Gruyter}, - location = {M{\"u}nchen and Berlin and New York}, - date = {1988}, - annotation = {A single volume from the critical edition of Nietzsche's - works. This \texttt{book} entry explicitly refers to the first volume - only. Note the \texttt{title} and \texttt{maintitle} fields. Also note the - \texttt{sorttitle} and \texttt{sortyear} fields. We want this entry to be - listed after the entry referring to the entire edition} -} -@book{nussbaum, - keywords = {secondary}, - hyphenation = {american}, - sorttitle = {Aristotle's De Motu Animalium}, - indexsorttitle = {Aristotle's De Motu Animalium}, - author = {Nussbaum, Martha}, - title = {Aristotle's \mkbibquote{De Motu Animalium}}, - publisher = pup, - location = {Princeton}, - date = {1978}, - annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and - \texttt{indexsorttitle} fields and the markup of the quotes in the - database file} -} -@book{piccato, - hyphenation = {american}, - author = {Piccato, Pablo}, - title = {City of Suspects}, - subtitle = {Crime in Mexico City, 1900--1931}, - shorttitle = {City of Suspects}, - publisher = {Duke University Press}, - location = {Durham and London}, - date = {2001}, - annotation = {This is a \texttt{book} entry. Note the format of the - \texttt{location} field in the database file} -} -@book{vangennep, - options = {useprefix}, - hyphenation = {french}, - sorttitle = {Rites de passage}, - author = {van Gennep, Arnold}, - indextitle = {Rites de passage, Les}, - title = {Les rites de passage}, - shorttitle = {Rites de passage}, - publisher = {Nourry}, - location = {Paris}, - date = {1909}, - annotation = {A \texttt{book} entry. Note the format of the printed name and - compare the \texttt{useprefix} option in the \texttt{options} field as - well as \texttt{brandt} and \texttt{geer}} -} -@book{vangennep:trans, - options = {useprefix}, - author = {van Gennep, Arnold}, - translator = {Vizedom, Monika B. and Caffee, Gabrielle L.}, - title = {The Rites of Passage}, - indextitle = {Rites of Passage, The}, - sorttitle = {Rites of Passage}, - shorttitle = {Rites of Passage}, - language = {english}, + volume = 1, + edition = 2, + publisher = dtv # { and Walter de Gruyter}, + location = {M{\"u}nchen and Berlin and New York}, + hyphenation = {german}, + sortyear = {1988-1}, + sorttitle = {Werke-01-000}, + indexsorttitle= {Samtliche Werke I}, + bookauthor = {Nietzsche, Friedrich}, + indextitle = {S{\"a}mtliche Werke I}, + shorttitle = {S{\"a}mtliche Werke I}, + annotation = {A single volume from the critical edition of Nietzsche's + works. This \texttt{book} entry explicitly refers to the first + volume only. Note the \texttt{title} and \texttt{maintitle} + fields. Also note the \texttt{sorttitle} and \texttt{sortyear} + fields. We want this entry to be listed after the entry + referring to the entire edition}, +} + +@Book{nussbaum, + author = {Nussbaum, Martha}, + title = {Aristotle's \mkbibquote{De Motu Animalium}}, + date = 1978, + publisher = pup, + location = {Princeton}, + keywords = {secondary}, + hyphenation = {american}, + sorttitle = {Aristotle's De Motu Animalium}, + indexsorttitle= {Aristotle's De Motu Animalium}, + annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and + \texttt{indexsorttitle} fields and the markup of the quotes in + the database file}, +} + +@Book{piccato, + author = {Piccato, Pablo}, + title = {City of Suspects}, + date = 2001, + publisher = {Duke University Press}, + location = {Durham and London}, + hyphenation = {american}, + subtitle = {Crime in Mexico City, 1900--1931}, + shorttitle = {City of Suspects}, + annotation = {This is a \texttt{book} entry. Note the format of the + \texttt{location} field in the database file}, +} + +@Book{vangennep, + author = {van Gennep, Arnold}, + title = {Les rites de passage}, + date = 1909, + publisher = {Nourry}, + location = {Paris}, + options = {useprefix}, + hyphenation = {french}, + sorttitle = {Rites de passage}, + indextitle = {Rites de passage, Les}, + shorttitle = {Rites de passage}, + annotation = {A \texttt{book} entry. Note the format of the printed name and + compare the \texttt{useprefix} option in the \texttt{options} + field as well as \texttt{brandt} and \texttt{geer}}, +} + +@Book{vangennep:trans, + author = {van Gennep, Arnold}, + title = {The Rites of Passage}, + year = 1960, + translator = {Vizedom, Monika B. and Caffee, Gabrielle L.}, + language = {english}, origlanguage = {french}, - year = {1960}, - publisher = {University of Chicago Press}, - annotation = {A translation of the \texttt{vangennep} entry. Note the - \texttt{translator} and \texttt{origlanguage} fields. Compare with the - \texttt{vangennep:related} entry.} -} -@book{vangennep:related, - options = {useprefix}, - hyphenation = {french}, - author = {van Gennep, Arnold}, - related = {vizedom:related}, - relatedtype = {bytranslator}, - sorttitle = {Rites de passage}, - indextitle = {Rites de passage, Les}, - title = {Les rites de passage}, - shorttitle = {Rites de passage}, - publisher = {Nourry}, - location = {Paris}, - date = {1909}, - annotation = {A variant of the \texttt{vangennep} entry related to its - translation. Note the format of the \texttt{related} and - \texttt{relatedtype} fields} -} -@book{vizedom:related, - options = {usetranslator}, - translator = {Vizedom, Monika B. and Caffee, Gabrielle L.}, - related = {vangennep}, - relatedtype = {translationof}, - title = {The Rites of Passage}, - indextitle = {Rites of Passage, The}, - sorttitle = {Rites of Passage}, - shorttitle = {Rites of Passage}, - language = {english}, - year = {1960}, - publisher = {University of Chicago Press}, - annotation = {A translated work from \texttt{vangennep}. Note the format of - the \texttt{related} and \texttt{relatedtype} fields} -} -@book{vazques-de-parga, - hyphenation = {spanish}, - sorttitle = {Peregrinaciones a Santiago de Compostela}, - author = {V{\'a}zques{ de }Parga, Luis and Lacarra, Jos{\'e} Mar{\'i}a - and Ur{\'i}a R{\'i}u, Juan}, - indextitle = {Peregrinaciones a Santiago de Compostela, Las}, - title = {Las Peregrinaciones a Santiago de Compostela}, - shorttitle = {Peregrinaciones}, - volumes = {3}, - publisher = {Iberdrola}, - location = {Pamplona}, - date = {1993}, - note = {Ed. facs. de la realizada en 1948--49}, - annotation = {A multivolume book cited as a whole. This is a \texttt{book} - entry with \texttt{volumes}, \texttt{note}, \texttt{sorttitle}, and - \texttt{indextitle} fields} -} -@book{wilde, - title = {The Importance of Being Earnest: A Trivial Comedy for Serious - People}, - author = {Wilde, Oscar}, - series = {English and American drama of the Nineteenth Century}, - year = {1899}, - eprint ={4HIWAAAAYAAJ}, - eprinttype = {googlebooks}, - publisher = {Leonard Smithers and Company}, - annotation = {A \texttt{book} with \texttt{eprint} and \texttt{eprinttype} - fields.} -} -@book{worman, - hyphenation = {american}, - sorttitle = {Cast of Character}, - author = {Worman, Nancy}, - indextitle = {Cast of Character, The}, - title = {The Cast of Character}, - subtitle = {Style in Greek Literature}, - shorttitle = {Cast of Character}, - publisher = {University of Texas Press}, - location = {Austin}, - date = {2002}, - annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and - \texttt{indextitle} fields} -} -@collection{britannica, - options = {useeditor=false}, - label = {EB}, - hyphenation = {british}, - sorttitle = {Encyclop{\ae}dia Britannica}, - editor = {Preece, Warren E.}, - indextitle = {Encyclop{\ae}dia Britannica, The New}, - title = {The New Encyclop{\ae}dia Britannica}, - shorttitle = {Encyclop{\ae}dia Britannica}, - volumes = {32}, - edition = {15}, - publisher = {Encyclop{\ae}dia Britannica}, - location = {Chicago, Ill.}, - date = {2003}, - annotation = {This is a \texttt{collection} entry for an encyclopedia. Note - the \texttt{useeditor} option in the \texttt{options} field as well as the - \texttt{sorttitle} field. We want this entry to be cited and alphabetized - by title even though there is an editor. In addition to that, we want the - title to be alphabetized under \enquote*{E} rather than \enquote*{T}. Also - note the \texttt{label} field which is provided for author-year citation - styles} -} -@collection{gaonkar, - hyphenation = {american}, - editor = {Gaonkar, Dilip Parameshwar}, - title = {Alternative Modernities}, - publisher = {Duke University Press}, - location = {Durham and London}, - date = {2001}, - isbn = {0-822-32714-7}, - annotation = {This is a \texttt{collection} entry. Note the format of the - \texttt{location} field in the database file as well as the \texttt{isbn} - field} -} -@incollection{gaonkar:in, - author = {Gaonkar, Dilip Parameshwar}, - title = {On Alternative Modernities}, - pages = {1--23}, - editor = {Gaonkar, Dilip Parameshwar}, - booktitle = {Alternative Modernities}, - publisher = {Duke University Press}, - location = {Durham and London}, - date = {2001}, - isbn = {0-822-32714-7} -} -@collection{jaffe, - editor = {Jaff{\'e}, Philipp}, - editora = {Loewenfeld, Samuel and Kaltenbrunner, Ferdinand and Ewald, Paul}, - editoratype = {redactor}, - indextitle = {Regesta Pontificum Romanorum}, - title = {Regesta Pontificum Romanorum ab condita ecclesia ad annum post - Christum natum \textsc{mcxcviii}}, - shorttitle = {Regesta Pontificum Romanorum}, - volumes = {2}, - edition = {2}, - location = {Leipzig}, - date = {1885/1888}, - annotation = {A \texttt{collection} entry with \texttt{edition} and - \texttt{volumes} fields. Note the \texttt{editora} and - \texttt{editoratype} fields} -} -@collection{westfahl:frontier, - hyphenation = {american}, - editor = {Westfahl, Gary}, - title = {Space and Beyond}, - subtitle = {The Frontier Theme in Science Fiction}, - booktitle = {Space and Beyond}, + publisher = {University of Chicago Press}, + options = {useprefix}, + indextitle = {Rites of Passage, The}, + sorttitle = {Rites of Passage}, + shorttitle = {Rites of Passage}, + hyphenation = {american}, + annotation = {A translation of the \texttt{vangennep} entry. Note the + \texttt{translator} and \texttt{origlanguage} fields. Compare + with the \texttt{vangennep:related} entry.}, +} + +@Book{vangennep:related, + author = {van Gennep, Arnold}, + title = {Les rites de passage}, + date = 1909, + publisher = {Nourry}, + location = {Paris}, + options = {useprefix}, + hyphenation = {french}, + related = {vizedom:related}, + relatedtype = {bytranslator}, + sorttitle = {Rites de passage}, + indextitle = {Rites de passage, Les}, + shorttitle = {Rites de passage}, + annotation = {A variant of the \texttt{vangennep} entry related to its + translation. Note the format of the \texttt{related} and + \texttt{relatedtype} fields}, +} + +@Book{vizedom:related, + title = {The Rites of Passage}, + year = 1960, + translator = {Vizedom, Monika B. and Caffee, Gabrielle L.}, + language = {english}, + publisher = {University of Chicago Press}, + hyphenation = {american}, + options = {usetranslator}, + related = {vangennep}, + relatedtype = {translationof}, + indextitle = {Rites of Passage, The}, + sorttitle = {Rites of Passage}, + shorttitle = {Rites of Passage}, + annotation = {A translated work from \texttt{vangennep}. Note the format of + the \texttt{related} and \texttt{relatedtype} fields}, +} + +@Book{vazques-de-parga, + author = {V{\'a}zques{ de }Parga, Luis and Lacarra, Jos{\'e} Mar{\'i}a + and Ur{\'i}a R{\'i}u, Juan}, + title = {Las Peregrinaciones a Santiago de Compostela}, + date = 1993, + volumes = 3, + note = {Ed. facs. de la realizada en 1948--49}, + publisher = {Iberdrola}, + location = {Pamplona}, + hyphenation = {spanish}, + sorttitle = {Peregrinaciones a Santiago de Compostela}, + indextitle = {Peregrinaciones a Santiago de Compostela, Las}, + shorttitle = {Peregrinaciones}, + annotation = {A multivolume book cited as a whole. This is a \texttt{book} + entry with \texttt{volumes}, \texttt{note}, + \texttt{sorttitle}, and \texttt{indextitle} fields}, +} + +@Book{wilde, + author = {Wilde, Oscar}, + title = {The Importance of Being Earnest: A Trivial Comedy for Serious + People}, + year = 1899, + series = {English and American drama of the Nineteenth Century}, + publisher = {Leonard Smithers and Company}, + eprint = {4HIWAAAAYAAJ}, + eprinttype = {googlebooks}, + annotation = {A \texttt{book} with \texttt{eprint} and \texttt{eprinttype} + fields.}, +} + +@Book{worman, + author = {Worman, Nancy}, + title = {The Cast of Character}, + date = 2002, + publisher = {University of Texas Press}, + location = {Austin}, + hyphenation = {american}, + sorttitle = {Cast of Character}, + indextitle = {Cast of Character, The}, + subtitle = {Style in Greek Literature}, + shorttitle = {Cast of Character}, + annotation = {A \texttt{book} entry. Note the \texttt{sorttitle} and + \texttt{indextitle} fields}, +} + +@Collection{britannica, + editor = {Preece, Warren E.}, + title = {The New Encyclop{\ae}dia Britannica}, + date = 2003, + edition = 15, + volumes = 32, + publisher = {Encyclop{\ae}dia Britannica}, + location = {Chicago, Ill.}, + options = {useeditor=false}, + label = {EB}, + hyphenation = {british}, + sorttitle = {Encyclop{\ae}dia Britannica}, + indextitle = {Encyclop{\ae}dia Britannica, The New}, + shorttitle = {Encyclop{\ae}dia Britannica}, + annotation = {This is a \texttt{collection} entry for an encyclopedia. Note + the \texttt{useeditor} option in the \texttt{options} field as + well as the \texttt{sorttitle} field. We want this entry to be + cited and alphabetized by title even though there is an + editor. In addition to that, we want the title to be + alphabetized under \enquote*{E} rather than \enquote*{T}. Also + note the \texttt{label} field which is provided for + author-year citation styles}, +} + +@Collection{gaonkar, + editor = {Gaonkar, Dilip Parameshwar}, + title = {Alternative Modernities}, + date = 2001, + publisher = {Duke University Press}, + location = {Durham and London}, + isbn = {0-822-32714-7}, + hyphenation = {american}, + annotation = {This is a \texttt{collection} entry. Note the format of the + \texttt{location} field in the database file as well as the + \texttt{isbn} field}, +} + +@InCollection{gaonkar:in, + author = {Gaonkar, Dilip Parameshwar}, + editor = {Gaonkar, Dilip Parameshwar}, + title = {On Alternative Modernities}, + date = 2001, + booktitle = {Alternative Modernities}, + publisher = {Duke University Press}, + location = {Durham and London}, + isbn = {0-822-32714-7}, + pages = {1-23}, +} + +@Collection{jaffe, + editor = {Jaff{\'e}, Philipp}, + title = {Regesta Pontificum Romanorum ab condita ecclesia ad annum post + Christum natum \textsc{mcxcviii}}, + date = {1885/1888}, + editora = {Loewenfeld, Samuel and Kaltenbrunner, Ferdinand and Ewald, + Paul}, + edition = 2, + volumes = 2, + location = {Leipzig}, + editoratype = {redactor}, + indextitle = {Regesta Pontificum Romanorum}, + shorttitle = {Regesta Pontificum Romanorum}, + annotation = {A \texttt{collection} entry with \texttt{edition} and + \texttt{volumes} fields. Note the \texttt{editora} and + \texttt{editoratype} fields}, +} + +@Collection{westfahl:frontier, + editor = {Westfahl, Gary}, + title = {Space and Beyond}, + date = 2000, + subtitle = {The Frontier Theme in Science Fiction}, + publisher = {Greenwood}, + location = {Westport, Conn. and London}, + hyphenation = {american}, + booktitle = {Space and Beyond}, booksubtitle = {The Frontier Theme in Science Fiction}, - publisher = {Greenwood}, - location = {Westport, Conn. and London}, - date = {2000}, - annotation = {This is a \texttt{collection} entry. Note the format of the - \texttt{location} field as well as the \texttt{subtitle} and - \texttt{booksubtitle} fields} -} -@inbook{kant:kpv, - shorthand = {KpV}, - hyphenation = {german}, - author = {Kant, Immanuel}, - bookauthor = {Kant, Immanuel}, - title = {Kritik der praktischen Vernunft}, - shorttitle = {Kritik der praktischen Vernunft}, - booktitle = {Kritik der praktischen Vernunft. Kritik der Urtheilskraft}, - maintitle = {Kants Werke. Akademie Textausgabe}, - volume = {5}, - publisher = {Walter de Gruyter}, - location = {Berlin}, - date = {1968}, - pages = {1--163}, - annotation = {An edition of Kant's \emph{Collected Works}, volume five. This - is an \texttt{inbook} entry which explicitly refers to the \emph{Critique - of Practical Reason} only, not to the entire fifth volume. Note the - \texttt{author} and \texttt{bookauthor} fields in the database file. By - default, the \texttt{bookauthor} is omitted if the values of the - \texttt{author} and \texttt{bookauthor} fields are identical} -} -@inbook{kant:ku, - shorthand = {KU}, - hyphenation = {german}, - author = {Kant, Immanuel}, - bookauthor = {Kant, Immanuel}, - title = {Kritik der Urtheilskraft}, - booktitle = {Kritik der praktischen Vernunft. Kritik der Urtheilskraft}, - maintitle = {Kants Werke. Akademie Textausgabe}, - volume = {5}, - publisher = {Walter de Gruyter}, - location = {Berlin}, - date = {1968}, - pages = {165--485}, - annotation = {An edition of Kant's \emph{Collected Works}, volume five. This - is an \texttt{inbook} entry which explicitly refers to the \emph{Critique - of Judgment} only, not to the entire fifth volume} -} -@inbook{nietzsche:historie, - hyphenation = {german}, - sortyear = {1988-01-243}, - sorttitle = {Werke-01-243}, - indexsorttitle = {Vom Nutzen und Nachtheil der Historie fur das Leben}, - author = {Nietzsche, Friedrich}, - bookauthor = {Nietzsche, Friedrich}, - editor = {Colli, Giorgio and Montinari, Mazzino}, - indextitle = {Vom Nutzen und Nachtheil der Historie f{\"u}r das Leben}, - title = {Unzeitgem{\"a}sse Betrachtungen. Zweites St{\"u}ck}, - subtitle = {Vom Nutzen und Nachtheil der Historie f{\"u}r das Leben}, - shorttitle = {Vom Nutzen und Nachtheil der Historie}, - booktitle = {Die Geburt der Trag{\"o}die. Unzeitgem{\"a}{\ss}e Betrachtungen - I--IV. Nachgelassene Schriften 1870--1973}, - maintitle = {S{\"a}mtliche Werke}, + annotation = {This is a \texttt{collection} entry. Note the format of the + \texttt{location} field as well as the \texttt{subtitle} and + \texttt{booksubtitle} fields}, +} + +@InBook{kant:kpv, + title = {Kritik der praktischen Vernunft}, + date = 1968, + author = {Kant, Immanuel}, + booktitle = {Kritik der praktischen Vernunft. Kritik der Urtheilskraft}, + bookauthor = {Kant, Immanuel}, + maintitle = {Kants Werke. Akademie Textausgabe}, + volume = 5, + publisher = {Walter de Gruyter}, + location = {Berlin}, + pages = {1-163}, + shorthand = {KpV}, + hyphenation = {german}, + shorttitle = {Kritik der praktischen Vernunft}, + annotation = {An edition of Kant's \emph{Collected Works}, volume five. This + is an \texttt{inbook} entry which explicitly refers to the + \emph{Critique of Practical Reason} only, not to the entire + fifth volume. Note the \texttt{author} and \texttt{bookauthor} + fields in the database file. By default, the + \texttt{bookauthor} is omitted if the values of the + \texttt{author} and \texttt{bookauthor} fields are identical}, +} + +@InBook{kant:ku, + title = {Kritik der Urtheilskraft}, + date = 1968, + author = {Kant, Immanuel}, + booktitle = {Kritik der praktischen Vernunft. Kritik der Urtheilskraft}, + bookauthor = {Kant, Immanuel}, + maintitle = {Kants Werke. Akademie Textausgabe}, + volume = 5, + publisher = {Walter de Gruyter}, + location = {Berlin}, + pages = {165-485}, + shorthand = {KU}, + hyphenation = {german}, + annotation = {An edition of Kant's \emph{Collected Works}, volume five. This + is an \texttt{inbook} entry which explicitly refers to the + \emph{Critique of Judgment} only, not to the entire fifth + volume}, +} + +@InBook{nietzsche:historie, + title = {Unzeitgem{\"a}sse Betrachtungen. Zweites St{\"u}ck}, + date = 1988, + author = {Nietzsche, Friedrich}, + booktitle = {Die Geburt der Trag{\"o}die. Unzeitgem{\"a}{\ss}e + Betrachtungen I--IV. Nachgelassene Schriften 1870--1973}, + bookauthor = {Nietzsche, Friedrich}, + editor = {Colli, Giorgio and Montinari, Mazzino}, + subtitle = {Vom Nutzen und Nachtheil der Historie f{\"u}r das Leben}, + maintitle = {S{\"a}mtliche Werke}, mainsubtitle = {Kritische Studienausgabe}, - volume = {1}, - publisher = dtv # { and Walter de Gruyter}, - location = {M{\"u}nchen and Berlin and New York}, - date = {1988}, - pages = {243--334}, - annotation = {A single essay from the critical edition of Nietzsche's works. - This \texttt{inbook} entry explicitly refers to an essay found in the - first volume. Note the \texttt{title}, \texttt{booktitle}, and - \texttt{maintitle} fields. Also note the \texttt{sorttitle} and - \texttt{sortyear} fields. We want this entry to be listed after the entry - referring to the entire first volume} -} -@incollection{brandt, - options = {useprefix=false}, - hyphenation = {german}, - indexsorttitle = {Nordischen Lander von der Mitte des 11. Jahrhunderts bis - 1448}, - author = {von Brandt, Ahasver and Erich Hoffmann}, - editor = {Ferdinand Seibt}, - indextitle = {Nordischen L{\"a}nder von der Mitte des 11.~Jahrhunderts bis - 1448, Die}, - title = {Die nordischen L{\"a}nder von der Mitte des 11.~Jahrhunderts bis - 1448}, - shorttitle = {Die nordischen L{\"a}nder}, - booktitle = {Europa im Hoch- und Sp{\"a}tmittelalter}, - series = {Handbuch der europ{\"a}ischen Geschichte}, - number = {2}, - publisher = {Klett-Cotta}, - location = {Stuttgart}, - date = {1987}, - pages = {884--917}, - annotation = {An \texttt{incollection} entry with a \texttt{series} and a - \texttt{number}. Note the format of the printed name and compare the - \texttt{useprefix} option in the \texttt{options} field as well as - \texttt{vangennep}. Also note the \texttt{indextitle, and - \texttt{indexsorttitle} fields}} -} -@incollection{hyman, - keywords = {secondary}, - hyphenation = {american}, - author = {Arthur Hyman}, - editor = {O'Meara, Dominic J.}, - indextitle = {Aristotle's Theory of the Intellect}, - title = {Aristotle's Theory of the Intellect and its Interpretation by - Averroes}, - shorttitle = {Aristotle's Theory of the Intellect}, - booktitle = {Studies in Aristotle}, - series = {Studies in Philosophy and the History of Philosophy}, - number = {9}, - publisher = {The Catholic University of America Press}, - location = {Washington, D.C.}, - date = {1981}, - pages = {161--191}, - annotation = {An \texttt{incollection} entry with a \texttt{series} and - \texttt{number} field} -} -@incollection{pines, - keywords = {secondary}, - hyphenation = {american}, - author = {Pines, Shlomo}, - editor = {Twersky, Isadore}, - indextitle = {Limitations of Human Knowledge According to Al-Farabi, ibn - Bajja, and Maimonides, The}, - title = {The Limitations of Human Knowledge According to Al-Farabi, ibn - Bajja, and Maimonides}, - shorttitle = {Limitations of Human Knowledge}, - booktitle = {Studies in Medieval Jewish History and Literature}, - publisher = hup, - location = {Cambridge, Mass.}, - date = {1979}, - pages = {82--109}, - annotation = {A typical \texttt{incollection} entry. Note the - \texttt{indextitle} field} -} -@inproceedings{moraux, - keywords = {secondary}, - hyphenation = {french}, - indexsorttitle = {De Anima dans la tradition grecque}, - author = {Moraux, Paul}, - editor = {Lloyd, G. E. R. and Owen, G. E. L.}, - indextitle = {\emph{De Anima} dans la tradition gr{\`e}cque, Le}, - title = {Le \emph{De Anima} dans la tradition gr{\`e}cque}, - subtitle = {Quelques aspects de l'interpretation du trait{\'e}, de - Theophraste {\`a} Themistius}, - shorttitle = {\emph{De Anima} dans la tradition gr{\`e}cque}, - booktitle = {Aristotle on Mind and the Senses}, - booktitleaddon = {Proceedings of the Seventh Symposium Aristotelicum}, - eventdate = {1975}, - publisher = cup, - location = {Cambridge}, - date = {1979}, - pages = {281--324}, - annotation = {This is a typical \texttt{inproceedings} entry. Note the - \texttt{booksubtitle}, \texttt{shorttitle}, \texttt{indextitle}, and - \texttt{indexsorttitle} fields. Also note the \texttt{eventdate} field.} -} -@inproceedings{salam, - author = {Salam, Abdus}, - editor = {Svartholm, Nils}, - title = {Weak and Electromagnetic Interactions}, - booktitle = {Elementary particle theory}, + volume = 1, + publisher = dtv # { and Walter de Gruyter}, + location = {M{\"u}nchen and Berlin and New York}, + pages = {243-334}, + hyphenation = {german}, + sortyear = {1988-2}, + sorttitle = {Werke-01-243}, + indexsorttitle= {Vom Nutzen und Nachtheil der Historie fur das Leben}, + indextitle = {Vom Nutzen und Nachtheil der Historie f{\"u}r das Leben}, + shorttitle = {Vom Nutzen und Nachtheil der Historie}, + annotation = {A single essay from the critical edition of Nietzsche's works. + This \texttt{inbook} entry explicitly refers to an essay found + in the first volume. Note the \texttt{title}, + \texttt{booktitle}, and \texttt{maintitle} fields. Also note + the \texttt{sorttitle} and \texttt{sortyear} fields. We want + this entry to be listed after the entry referring to the + entire first volume}, +} + +@InCollection{brandt, + author = {von Brandt, Ahasver and Erich Hoffmann}, + editor = {Ferdinand Seibt}, + title = {Die nordischen L{\"a}nder von der Mitte des 11.~Jahrhunderts + bis 1448}, + date = 1987, + booktitle = {Europa im Hoch- und Sp{\"a}tmittelalter}, + series = {Handbuch der europ{\"a}ischen Geschichte}, + number = 2, + publisher = {Klett-Cotta}, + location = {Stuttgart}, + pages = {884-917}, + options = {useprefix=false}, + hyphenation = {german}, + indexsorttitle= {Nordischen Lander von der Mitte des 11. Jahrhunderts bis + 1448}, + indextitle = {Nordischen L{\"a}nder von der Mitte des 11.~Jahrhunderts bis + 1448, Die}, + shorttitle = {Die nordischen L{\"a}nder}, + annotation = {An \texttt{incollection} entry with a \texttt{series} and a + \texttt{number}. Note the format of the printed name and + compare the \texttt{useprefix} option in the \texttt{options} + field as well as \texttt{vangennep}. Also note the + \texttt{indextitle, and \texttt{indexsorttitle} fields}}, +} + +@InCollection{hyman, + author = {Arthur Hyman}, + editor = {O'Meara, Dominic J.}, + title = {Aristotle's Theory of the Intellect and its Interpretation by + Averroes}, + date = 1981, + booktitle = {Studies in Aristotle}, + series = {Studies in Philosophy and the History of Philosophy}, + number = 9, + publisher = {The Catholic University of America Press}, + location = {Washington, D.C.}, + pages = {161-191}, + keywords = {secondary}, + hyphenation = {american}, + indextitle = {Aristotle's Theory of the Intellect}, + shorttitle = {Aristotle's Theory of the Intellect}, + annotation = {An \texttt{incollection} entry with a \texttt{series} and + \texttt{number} field}, +} + +@InCollection{pines, + author = {Pines, Shlomo}, + editor = {Twersky, Isadore}, + title = {The Limitations of Human Knowledge According to Al-Farabi, ibn + Bajja, and Maimonides}, + date = 1979, + booktitle = {Studies in Medieval Jewish History and Literature}, + publisher = hup, + location = {Cambridge, Mass.}, + pages = {82-109}, + keywords = {secondary}, + hyphenation = {american}, + indextitle = {Limitations of Human Knowledge According to Al-Farabi, ibn + Bajja, and Maimonides, The}, + shorttitle = {Limitations of Human Knowledge}, + annotation = {A typical \texttt{incollection} entry. Note the + \texttt{indextitle} field}, +} + +@InProceedings{moraux, + author = {Moraux, Paul}, + editor = {Lloyd, G. E. R. and Owen, G. E. L.}, + title = {Le \emph{De Anima} dans la tradition gr{\`e}cque}, + date = 1979, + booktitle = {Aristotle on Mind and the Senses}, + subtitle = {Quelques aspects de l'interpretation du trait{\'e}, de + Theophraste {\`a} Themistius}, + booktitleaddon= {Proceedings of the Seventh Symposium Aristotelicum}, + eventdate = 1975, + publisher = cup, + location = {Cambridge}, + pages = {281-324}, + keywords = {secondary}, + hyphenation = {french}, + indexsorttitle= {De Anima dans la tradition grecque}, + indextitle = {\emph{De Anima} dans la tradition gr{\`e}cque, Le}, + shorttitle = {\emph{De Anima} dans la tradition gr{\`e}cque}, + annotation = {This is a typical \texttt{inproceedings} entry. Note the + \texttt{booksubtitle}, \texttt{shorttitle}, + \texttt{indextitle}, and \texttt{indexsorttitle} fields. Also + note the \texttt{eventdate} field.}, +} + +@InProceedings{salam, + author = {Salam, Abdus}, + editor = {Svartholm, Nils}, + title = {Weak and Electromagnetic Interactions}, + date = 1968, + booktitle = {Elementary particle theory}, booksubtitle = {Relativistic groups and analyticity}, - booktitleaddon = {Proceedings of the Eighth Nobel Symposium}, - eventdate = {1968-05-19/1968-05-25}, - venue = {Aspen{\"a}sgarden, Lerum}, - publisher = {Almquist \& Wiksell}, - location = {Stockholm}, - date = {1968}, - pages = {367--377} -} -@manual{cms, - label = {CMS}, - hyphenation = {american}, - sorttitle = {Chicago Manual of Style}, - indextitle = {Chicago Manual of Style, The}, - title = {The Chicago Manual of Style}, - subtitle = {The Essential Guide for Writers, Editors, and Publishers}, - shorttitle = {Chicago Manual of Style}, - edition = {15}, - publisher = {University of Chicago Press}, - location = {Chicago, Ill.}, - date = {2003}, - isbn = {0-226-10403-6}, - annotation = {This is a \texttt{manual} entry without an \texttt{author} or - \texttt{editor}. Note the \texttt{label} field in the database file which - is provided for author-year citation styles. Also note the - \texttt{sorttitle} and \texttt{indextitle} fields. By default, all entries - without an \texttt{author} or \texttt{editor} are alphabetized by - \texttt{title} but we want this entry to be alphabetized under - \enquote*{C} rather than \enquote*{T}. There's also an \texttt{isbn} - field} -} -@online{baez/online, - hyphenation = {american}, - author = {Baez, John C. and Lauda, Aaron D.}, - title = {Higher-Dimensional Algebra V: 2-Groups}, - version = {3}, - date = {2004-10-27}, - eprinttype = {arxiv}, - eprint = {math/0307200v3}, - annotation = {An \texttt{online} reference from arXiv. Note the - \texttt{eprint} and \texttt{eprinttype} fields. Compare \texttt{baez\slash - article} which is the same item given as an \texttt{article} entry with - eprint information} -} -@online{ctan, - label = {CTAN}, - hyphenation = {american}, - title = {CTAN}, - subtitle = {The Comprehensive TeX Archive Network}, - date = {2006}, - url = {http://www.ctan.org}, - urldate = {2006-10-01}, - annotation = {This is an \texttt{online} entry. The \textsc{url}, which is - given in the \texttt{url} field, is transformed into a clickable link if - \texttt{hyperref} support has been enabled. Note the format of the - \texttt{urldate} field (\texttt{yyyy-mm-dd}) in the database file. Also - note the \texttt{label} field which may be used as a fallback by citation - styles which need an \texttt{author} and\slash or a \texttt{year}} -} -@online{itzhaki, - hyphenation = {american}, - author = {Itzhaki, Nissan}, - title = {Some remarks on 't Hooft's S-matrix for black holes}, - version = {1}, - date = {1996-03-11}, - eprinttype = {arxiv}, - eprint = {hep-th/9603067}, - annotation = {An \texttt{online} reference from arXiv. Note the - \texttt{eprint} and \texttt{eprinttype} fields. Also note that the arXiv - reference is transformed into a clickable link if \texttt{hyperref} - support has been enabled}, - abstract = {We discuss the limitations of 't Hooft's proposal for the black - hole S-matrix. We find that the validity of the S-matrix implies violation - of the semi-classical approximation at scales large compared to the Planck - scale. We also show that the effect of the centrifugal barrier on the - S-matrix is crucial even for large transverse distances.} -} -@online{markey, - hyphenation = {american}, - sorttitle = {Tame the Beast}, - author = {Markey, Nicolas}, - title = {Tame the BeaST}, - subtitle = {The B to X of BibTeX}, - version = {1.3}, - date = {2005-10-16}, - url = {http://tug.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf}, - urldate = {2006-10-01}, - annotation = {An \texttt{online} entry for a tutorial. Note the format of - the \texttt{date} field (\texttt{yyyy-mm-dd}) in the database file.} -} -@online{wassenberg, - hyphenation = {american}, - author = {Wassenberg, Jan and Sanders, Peter}, - title = {Faster Radix Sort via Virtual Memory and Write-Combining}, - version = {1}, - date = {2010-08-17}, - eprinttype = {arxiv}, - eprintclass = {cs.DS}, - eprint = {1008.2849v1}, - annotation = {A recent \texttt{online} reference from arXiv using the new - (April 2007 onward) identifier format. Note the \texttt{eprint}, - \texttt{eprinttype}, and \texttt{eprintclass} fields. Also note that the - arXiv reference is transformed into a clickable link if \texttt{hyperref} - support has been enabled}, - abstract = {Sorting algorithms are the deciding factor for the performance - of common operations such as removal of duplicates or database sort-merge - joins. This work focuses on 32-bit integer keys, optionally paired with a - 32-bit value. We present a fast radix sorting algorithm that builds upon a - microarchitecture-aware variant of counting sort} -} -@patent{almendro, - hyphenation = {german}, - author = {Almendro, Jos{\'e} L. and Mart{\'i}n, Jacinto - and S{\'a}nchez, Alberto and Nozal, Fernando}, - title = {Elektromagnetisches Signalhorn}, - number = {EU-29702195U}, - location = {countryfr and countryuk and countryde}, - date = {1998}, - annotation = {This is a \texttt{patent} entry with a \texttt{location} - field. The number is given in the \texttt{number} field. Note the format - of the \texttt{location} field in the database file. Compare - \texttt{laufenberg}, \texttt{sorace}, and \texttt{kowalik}} -} -@patent{kowalik, - hyphenation = {french}, - author = {Kowalik, F. and Isard, M.}, - indextitle = {Estimateur d'un d{\'e}faut de fonctionnement}, - title = {Estimateur d'un d{\'e}faut de fonctionnement d'un modulateur en - quadrature et {\'e}tage de modulation l'utilisant}, - type = {patreqfr}, - number = {9500261}, - date = {1995-01-11}, - annotation = {This is a \texttt{patent} entry for a French patent request - with a full date. The number is given in the \texttt{number} field. Note - the format of the \texttt{type} and \texttt{date} fields in the database - file. Compare \texttt{almendro}, \texttt{laufenberg}, and \texttt{sorace}} -} -@patent{laufenberg, - hyphenation = {german}, - author = {Laufenberg, Xaver and Eynius, Dominique and Suelzle, Helmut - and Usbeck, Stephan and Spaeth, Matthias and Neuser-Hoffmann, Miriam - and Myrzik, Christian and Schmid, Manfred and Nietfeld, Franz - and Thiel, Alexander and Braun, Harald and Ebner, Norbert}, - holder = {{Robert Bosch GmbH} and {Daimler Chrysler AG} - and {Bayerische Motoren Werke AG}}, - title = {Elektrische Einrichtung und Betriebsverfahren}, - type = {patenteu}, - number = {1700367}, - date = {2006-09-13}, - annotation = {This is a \texttt{patent} entry with a \texttt{holder} field. - Note the format of the \texttt{type} and \texttt{location} fields in the - database file. Compare \texttt{almendro}, \texttt{sorace}, and - \texttt{kowalik}}, - abstract = {The invention relates to an electric device comprising a - generator, in particular for use in the vehicle electric system of a motor - vehicle and a controller for controlling the generator voltage. The device - is equipped with a control zone, in which the voltage is controlled and - zones, in which the torque is controlled. The invention also relates to - methods for operating a device of this type.}, - file = {http://v3.espacenet.com/textdoc?IDX=EP1700367} -} -@patent{sorace, - hyphenation = {american}, - author = {Sorace, Ronald E. and Reinhardt, Victor S. and Vaughn, Steven A.}, - holder = {{Hughes Aircraft Company}}, - title = {High-Speed Digital-to-RF Converter}, - type = {patentus}, - number = {5668842}, - date = {1997-09-16}, - annotation = {This is a \texttt{patent} entry with a \texttt{holder} field. - Note the format of the \texttt{type} and \texttt{date} fields in the - database file. Compare \texttt{almendro}, \texttt{laufenberg}, and - \texttt{kowalik}} -} -@periodical{jcg, - title = {Computers and Graphics}, - issuetitle = {Semantic {3D} Media and Content}, - volume = {35}, - number = {4}, - year = {2011}, - issn = {0097-8493}, - annotation = {This is a \texttt{periodical} entry with an \texttt{issn} - field.} -} -@report{chiu, - hyphenation = {american}, - sorttitle = {Hybrid Hierarchical Model of a Multiple Virtual Storage (MVS) - Operating System}, - author = {Chiu, Willy W. and Chow, We Min}, - indextitle = {Hybrid Hierarchical Model, A}, - title = {A Hybrid Hierarchical Model of a Multiple Virtual Storage (MVS) - Operating System}, - institution = {IBM}, - type = {resreport}, - number = {RC-6947}, - date = {1978}, - annotation = {This is a \texttt{report} entry for a research report. Note - the format of the \texttt{type} field in the database file which uses a - localization key. The number of the report is given in the \texttt{number} - field. Also note the \texttt{sorttitle} and \texttt{indextitle} fields} -} -@report{padhye, - hyphenation = {american}, - sorttitle = {A Stochastic Model of TCP Reno Congestion Avoidance and - Control}, - author = {Padhye, Jitendra and Firoiu, Victor and Towsley, Don}, - indextitle = {Stochastic Model of TCP Reno Congestion Avoidance and Control, - A}, - title = {A Stochastic Model of TCP Reno Congestion Avoidance and Control}, - institution = {University of Massachusetts}, - type = {techreport}, - number = {99-02}, - location = {Amherst, Mass.}, - date = {1999}, - annotation = {This is a \texttt{report} entry for a technical report. Note - the format of the \texttt{type} field in the database file which uses a - localization key. The number of the report is given in the \texttt{number} - field. Also note the \texttt{sorttitle} and \texttt{indextitle} fields}, - abstract = {The steady state performance of a bulk transfer TCP flow (i.e. a - flow with a large amount of data to send, such as FTP transfers) may be - characterized by three quantities. The first is the send rate, which is - the amount of data sent by the sender in unit time. The second is the - throughput, which is the amount of data received by the receiver in unit - time. Note that the throughput will always be less than or equal to the - send rate due to losses. Finally, the number of non-duplicate packets - received by the receiver in unit time gives us the goodput of the - connection. The goodput is always less than or equal to the throughput, - since the receiver may receive two copies of the same packet due to - retransmissions by the sender. In a previous paper, we presented a simple - model for predicting the steady state send rate of a bulk transfer TCP - flow as a function of loss rate and round trip time. In this paper, we - extend that work in two ways. First, we analyze the performance of bulk - transfer TCP flows using more precise, stochastic analysis. Second, we - build upon the previous analysis to provide both an approximate formula as - well as a more accurate stochastic model for the steady state throughput - of a bulk transfer TCP flow.}, - file = {ftp://gaia.cs.umass.edu/pub/Padhey99-markov.ps} -} -@thesis{geer, - options = {useprefix=false}, - hyphenation = {british}, - author = {de Geer, Ingrid}, - title = {Earl, Saint, Bishop, Skald~-- and Music}, - subtitle = {The Orkney Earldom of the Twelfth Century. A Musicological - Study}, - institution = {Uppsala Universitet}, - type = {phdthesis}, - location = {Uppsala}, - date = {1985}, - annotation = {This is a typical \texttt{thesis} entry for a PhD thesis. Note - the \texttt{type} field in the database file which uses a localization - key. Also note the format of the printed name and compare the - \texttt{useprefix} option in the \texttt{options} field as well as - \texttt{vangennep}} -} -@thesis{loh, - hyphenation = {american}, - author = {Loh, Nin C.}, - title = {High-Resolution Micromachined Interferometric Accelerometer}, - institution = {Massachusetts Institute of Technology}, - type = {mathesis}, - location = {Cambridge, Mass.}, - date = {1992}, - annotation = {This is a typical \texttt{thesis} entry for an MA thesis. Note - the \texttt{type} field in the database file which uses a localization - key}} + booktitleaddon= {Proceedings of the Eighth Nobel Symposium}, + eventdate = {1968-05-19/1968-05-25}, + venue = {Aspen{\"a}sgarden, Lerum}, + publisher = {Almquist \& Wiksell}, + location = {Stockholm}, + pages = {367-377}, +} + +@Manual{cms, + title = {The Chicago Manual of Style}, + date = 2003, + subtitle = {The Essential Guide for Writers, Editors, and Publishers}, + edition = 15, + publisher = {University of Chicago Press}, + location = {Chicago, Ill.}, + isbn = {0-226-10403-6}, + label = {CMS}, + hyphenation = {american}, + sorttitle = {Chicago Manual of Style}, + indextitle = {Chicago Manual of Style, The}, + shorttitle = {Chicago Manual of Style}, + annotation = {This is a \texttt{manual} entry without an \texttt{author} or + \texttt{editor}. Note the \texttt{label} field in the database + file which is provided for author-year citation styles. Also + note the \texttt{sorttitle} and \texttt{indextitle} fields. By + default, all entries without an \texttt{author} or + \texttt{editor} are alphabetized by \texttt{title} but we want + this entry to be alphabetized under \enquote*{C} rather than + \enquote*{T}. There's also an \texttt{isbn} field}, +} + +@Online{baez/online, + author = {Baez, John C. and Lauda, Aaron D.}, + title = {Higher-Dimensional Algebra V: 2-Groups}, + date = {2004-10-27}, + version = 3, + hyphenation = {american}, + eprinttype = {arxiv}, + eprint = {math/0307200v3}, + annotation = {An \texttt{online} reference from arXiv. Note the + \texttt{eprint} and \texttt{eprinttype} fields. Compare + \texttt{baez\slash article} which is the same item given as an + \texttt{article} entry with eprint information}, +} + +@Online{ctan, + title = {CTAN}, + date = 2006, + url = {http://www.ctan.org}, + subtitle = {The Comprehensive TeX Archive Network}, + urldate = {2006-10-01}, + label = {CTAN}, + hyphenation = {american}, + annotation = {This is an \texttt{online} entry. The \textsc{url}, which is + given in the \texttt{url} field, is transformed into a + clickable link if \texttt{hyperref} support has been + enabled. Note the format of the \texttt{urldate} field + (\texttt{yyyy-mm-dd}) in the database file. Also note the + \texttt{label} field which may be used as a fallback by + citation styles which need an \texttt{author} and\slash or a + \texttt{year}}, +} + +@Online{itzhaki, + author = {Itzhaki, Nissan}, + title = {Some remarks on 't Hooft's S-matrix for black holes}, + date = {1996-03-11}, + version = 1, + hyphenation = {american}, + eprinttype = {arxiv}, + eprint = {hep-th/9603067}, + annotation = {An \texttt{online} reference from arXiv. Note the + \texttt{eprint} and \texttt{eprinttype} fields. Also note that + the arXiv reference is transformed into a clickable link if + \texttt{hyperref} support has been enabled}, + abstract = {We discuss the limitations of 't Hooft's proposal for the + black hole S-matrix. We find that the validity of the S-matrix + implies violation of the semi-classical approximation at + scales large compared to the Planck scale. We also show that + the effect of the centrifugal barrier on the S-matrix is + crucial even for large transverse distances.}, +} + +@Online{markey, + author = {Markey, Nicolas}, + title = {Tame the BeaST}, + date = {2005-10-16}, + url = + {http://tug.ctan.org/tex-archive/info/bibtex/tamethebeast/ttb_en.pdf}, + subtitle = {The B to X of BibTeX}, + version = {1.3}, + urldate = {2006-10-01}, + hyphenation = {american}, + sorttitle = {Tame the Beast}, + annotation = {An \texttt{online} entry for a tutorial. Note the format of + the \texttt{date} field (\texttt{yyyy-mm-dd}) in the database + file.}, +} + +@Online{wassenberg, + author = {Wassenberg, Jan and Sanders, Peter}, + title = {Faster Radix Sort via Virtual Memory and Write-Combining}, + date = {2010-08-17}, + version = 1, + hyphenation = {american}, + eprinttype = {arxiv}, + eprintclass = {cs.DS}, + eprint = {1008.2849v1}, + annotation = {A recent \texttt{online} reference from arXiv using the new + (April 2007 onward) identifier format. Note the + \texttt{eprint}, \texttt{eprinttype}, and \texttt{eprintclass} + fields. Also note that the arXiv reference is transformed into + a clickable link if \texttt{hyperref} support has been + enabled}, + abstract = {Sorting algorithms are the deciding factor for the performance + of common operations such as removal of duplicates or database + sort-merge joins. This work focuses on 32-bit integer keys, + optionally paired with a 32-bit value. We present a fast radix + sorting algorithm that builds upon a microarchitecture-aware + variant of counting sort}, +} + +@Patent{almendro, + author = {Almendro, Jos{\'e} L. and Mart{\'i}n, Jacinto and S{\'a}nchez, + Alberto and Nozal, Fernando}, + title = {Elektromagnetisches Signalhorn}, + number = {EU-29702195U}, + date = 1998, + location = {countryfr and countryuk and countryde}, + hyphenation = {german}, + annotation = {This is a \texttt{patent} entry with a \texttt{location} + field. The number is given in the \texttt{number} field. Note + the format of the \texttt{location} field in the database + file. Compare \texttt{laufenberg}, \texttt{sorace}, and + \texttt{kowalik}}, +} + +@Patent{kowalik, + author = {Kowalik, F. and Isard, M.}, + title = {Estimateur d'un d{\'e}faut de fonctionnement d'un modulateur + en quadrature et {\'e}tage de modulation l'utilisant}, + number = 9500261, + date = {1995-01-11}, + type = {patreqfr}, + hyphenation = {french}, + indextitle = {Estimateur d'un d{\'e}faut de fonctionnement}, + annotation = {This is a \texttt{patent} entry for a French patent request + with a full date. The number is given in the \texttt{number} + field. Note the format of the \texttt{type} and \texttt{date} + fields in the database file. Compare \texttt{almendro}, + \texttt{laufenberg}, and \texttt{sorace}}, +} + +@Patent{laufenberg, + author = {Laufenberg, Xaver and Eynius, Dominique and Suelzle, Helmut + and Usbeck, Stephan and Spaeth, Matthias and Neuser-Hoffmann, + Miriam and Myrzik, Christian and Schmid, Manfred and Nietfeld, + Franz and Thiel, Alexander and Braun, Harald and Ebner, + Norbert}, + title = {Elektrische Einrichtung und Betriebsverfahren}, + number = 1700367, + date = {2006-09-13}, + holder = {{Robert Bosch GmbH} and {Daimler Chrysler AG} and {Bayerische + Motoren Werke AG}}, + type = {patenteu}, + hyphenation = {german}, + annotation = {This is a \texttt{patent} entry with a \texttt{holder} field. + Note the format of the \texttt{type} and \texttt{location} + fields in the database file. Compare \texttt{almendro}, + \texttt{sorace}, and \texttt{kowalik}}, + abstract = {The invention relates to an electric device comprising a + generator, in particular for use in the vehicle electric + system of a motor vehicle and a controller for controlling the + generator voltage. The device is equipped with a control zone, + in which the voltage is controlled and zones, in which the + torque is controlled. The invention also relates to methods + for operating a device of this type.}, + file = {http://v3.espacenet.com/textdoc?IDX=EP1700367}, +} + +@Patent{sorace, + author = {Sorace, Ronald E. and Reinhardt, Victor S. and Vaughn, Steven + A.}, + title = {High-Speed Digital-to-RF Converter}, + number = 5668842, + date = {1997-09-16}, + holder = {{Hughes Aircraft Company}}, + type = {patentus}, + hyphenation = {american}, + annotation = {This is a \texttt{patent} entry with a \texttt{holder} field. + Note the format of the \texttt{type} and \texttt{date} fields + in the database file. Compare \texttt{almendro}, + \texttt{laufenberg}, and \texttt{kowalik}}, +} + +@Periodical{jcg, + title = {Computers and Graphics}, + year = 2011, + issuetitle = {Semantic {3D} Media and Content}, + volume = 35, + number = 4, + issn = {0097-8493}, + annotation = {This is a \texttt{periodical} entry with an \texttt{issn} + field.}, +} + +@Report{chiu, + author = {Chiu, Willy W. and Chow, We Min}, + title = {A Hybrid Hierarchical Model of a Multiple Virtual Storage + (MVS) Operating System}, + type = {resreport}, + institution = {IBM}, + date = 1978, + number = {RC-6947}, + hyphenation = {american}, + sorttitle = {Hybrid Hierarchical Model of a Multiple Virtual Storage (MVS) + Operating System}, + indextitle = {Hybrid Hierarchical Model, A}, + annotation = {This is a \texttt{report} entry for a research report. Note + the format of the \texttt{type} field in the database file + which uses a localization key. The number of the report is + given in the \texttt{number} field. Also note the + \texttt{sorttitle} and \texttt{indextitle} fields}, +} + +@Report{padhye, + author = {Padhye, Jitendra and Firoiu, Victor and Towsley, Don}, + title = {A Stochastic Model of TCP Reno Congestion Avoidance and + Control}, + type = {techreport}, + institution = {University of Massachusetts}, + date = 1999, + number = {99-02}, + location = {Amherst, Mass.}, + hyphenation = {american}, + sorttitle = {A Stochastic Model of TCP Reno Congestion Avoidance and + Control}, + indextitle = {Stochastic Model of TCP Reno Congestion Avoidance and Control, + A}, + annotation = {This is a \texttt{report} entry for a technical report. Note + the format of the \texttt{type} field in the database file + which uses a localization key. The number of the report is + given in the \texttt{number} field. Also note the + \texttt{sorttitle} and \texttt{indextitle} fields}, + abstract = {The steady state performance of a bulk transfer TCP flow + (i.e. a flow with a large amount of data to send, such as FTP + transfers) may be characterized by three quantities. The first + is the send rate, which is the amount of data sent by the + sender in unit time. The second is the throughput, which is + the amount of data received by the receiver in unit time. Note + that the throughput will always be less than or equal to the + send rate due to losses. Finally, the number of non-duplicate + packets received by the receiver in unit time gives us the + goodput of the connection. The goodput is always less than or + equal to the throughput, since the receiver may receive two + copies of the same packet due to retransmissions by the + sender. In a previous paper, we presented a simple model for + predicting the steady state send rate of a bulk transfer TCP + flow as a function of loss rate and round trip time. In this + paper, we extend that work in two ways. First, we analyze the + performance of bulk transfer TCP flows using more precise, + stochastic analysis. Second, we build upon the previous + analysis to provide both an approximate formula as well as a + more accurate stochastic model for the steady state throughput + of a bulk transfer TCP flow.}, + file = {ftp://gaia.cs.umass.edu/pub/Padhey99-markov.ps}, +} + +@Thesis{geer, + author = {de Geer, Ingrid}, + title = {Earl, Saint, Bishop, Skald~-- and Music}, + type = {phdthesis}, + institution = {Uppsala Universitet}, + date = 1985, + subtitle = {The Orkney Earldom of the Twelfth Century. A Musicological + Study}, + location = {Uppsala}, + options = {useprefix=false}, + hyphenation = {british}, + annotation = {This is a typical \texttt{thesis} entry for a PhD thesis. Note + the \texttt{type} field in the database file which uses a + localization key. Also note the format of the printed name and + compare the \texttt{useprefix} option in the \texttt{options} + field as well as \texttt{vangennep}}, +} + +@Thesis{loh, + author = {Loh, Nin C.}, + title = {High-Resolution Micromachined Interferometric Accelerometer}, + type = {mathesis}, + institution = {Massachusetts Institute of Technology}, + date = 1992, + location = {Cambridge, Mass.}, + hyphenation = {american}, + annotation = {This is a typical \texttt{thesis} entry for an MA thesis. Note + the \texttt{type} field in the database file which uses a + localization key}, +} |