summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex1132
1 files changed, 692 insertions, 440 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
index 6220ad7ef71..297c4928601 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex
@@ -56,7 +56,7 @@
Style files for biblatex
\vspace{.3\baselineskip}
-\sffamily\normalsize\bfseries David Fussner\qquad Version 0.9.9a (beta) \\
+\sffamily\normalsize\bfseries David Fussner\qquad Version 0.9.9b (beta) \\
\href{mailto:djf027@googlemail.com}{djf027@googlemail.com}\\ \today
\end{center}
@@ -73,16 +73,17 @@
\textbf{Please be advised that this package is beta software. Philipp
Lehman's \textsf{biblatex} package has now reached a stable state,
and is unlikely to require wholesale changes to styles written for
- it, aside from those necessary for the upcoming switch to
- \textsf{Biber} as the required backend rather than an optional one.
- This release of \textsf{biblatex-chicago} implements, for the first
- time, the 16th edition of the \emph{Chicago Manual of Style}, but I
- shall continue to maintain the 15th-edition files for those who need
- or want them, a situation I anticipate being rather more common with
- the author-date style than with notes \&\ bibliography. I shall
- also continue to maintain the 15th-edition documentation, which you
- can find in \textsf{biblatex-chicago15.pdf}. I have summarized the
- changes between the two in section~\ref{sec:history} below,
+ it. This release of \textsf{biblatex-chicago} implements, for the
+ first time, the 16th edition of the \emph{Chicago Manual of Style}.
+ I shall continue, for the moment, to maintain the 15th-edition files
+ for those who need or want them, but I encourage all users to switch
+ to the newer specification. If the title-formatting changes in the
+ author-date style have been an obstacle, please note that the new
+ \textsf{authordate-trad} style keeps the traditional title
+ formatting but switches everything else to the 16th edition spec.
+ The 15th-edition documentation is still available, also, in
+ \textsf{biblatex-chicago15.pdf}. I have summarized the changes
+ between the two editions in section~\ref{sec:history} below,
especially the ones
that may require alterations to your .bib files.\mylittlespace\\
I have tried to implement as much of the \emph{Manual's}
@@ -110,37 +111,41 @@ read on.
The \textsf{biblatex-chicago} package is designed for writers who wish
to use \LaTeX\ and \textsf{biblatex}, and who either want or need to
format their references according to one of the specifications defined
-by the \emph{Chicago Manual of Style}. This package includes both the
-\emph{Manual's} \enquote{author-date} system, favored by many
-disciplines in the sciences and social sciences, and its
+by the \emph{Chicago Manual of Style}. This package includes two
+versions of the \emph{Manual's} \enquote{author-date} system, favored
+by many disciplines in the sciences and social sciences, and also its
\enquote{notes \&\ bibliography} style, generally favored in the
humanities. The latter code produces a full reference in a first
footnote, shorter references in subsequent notes, and a full reference
in the bibliography. Some authors prefer to use the shorter note form
even for the first occurrence, relying on the bibliography to provide
the full information. This, too, is supported by the code. The
-author-date style produces a short, in-text citation inside
+author-date styles produce a short, in-text citation inside
parentheses --- (Author Year) --- keyed to a list of references where
entries start with the same name and year.
-\mylittlespace The documentation you are reading covers both of these
-Chicago styles and their variants. Much of what follows is relevant
-to all users, but I have decided, after some experimentation, to keep
-the instructions for the two styles separate, at least in
+\mylittlespace The documentation you are reading covers all three of
+these Chicago styles and their variants. Much of what follows is
+relevant to all users, but I have decided, after some experimentation,
+to keep the instructions for the two author-date styles separate from
+those pertaining to the notes \&\ bibliography style, at least in
sections~\ref{sec:Spec} and \ref{sec:authdate}. Information provided
under one style will often duplicate that found under the other, but
efficiency's loss should, I hope, be clarity's gain, and much of what
you learn using one style will be applicable without alteration to the
-other. Throughout the documentation, any \mycolor{green} text
-\colmarginpar{\textsf{New!}} indicates something \mycolor{new} in this
-release.
+other. Within the author-date section, the
+\mycolor{\textsf{authordate-trad}} information really only appears
+separately in section~\ref{sec:fields:authdate}, s.v.\
+\enquote{title.} Throughout the documentation, any \mycolor{green}
+text \colmarginpar{\textsf{New!}} indicates something \mycolor{new} in
+this release.
\mylittlespace Here's a list of things you will need in order to use
\textsf{biblatex-chicago}:
\begin{itemize}{}{}
\item Philipp Lehman's \textsf{biblatex} package, of course! You
- should use the latest version(s) --- 1.7 or 2.0 at the time of
+ should use the latest version(s) --- 1.7 or 2.4 at the time of
writing --- as those versions have been tested more thoroughly than
any other, meaning that these style files may well not function
properly with some earlier iterations of \textsf{biblatex}. Lehman's
@@ -167,9 +172,9 @@ release.
\item \mycolor{\textsf{Biber}} --- the next-generation
\textsc{Bib}\TeX\ replacement, called \textsf{Biber}, which is
available from SourceForge. You should use the latest version,
- 1.0, to work with \textsf{biblatex-chicago} and \textsf{biblatex}
- 2.0, or 0.9.9 with \textsf{biblatex} 1.7, and it is required for
- users who are either using the author-date style or processing a
+ 1.4, to work with \textsf{biblatex-chicago} and \textsf{biblatex}
+ 2.4, or 0.9.9 with \textsf{biblatex} 1.7, and it is required for
+ users who are either using the author-date styles or processing a
.bib file in Unicode. See \textsf{cms-dates-sample.pdf} for more
details.
\end{itemize}
@@ -178,19 +183,24 @@ release.
\cmd{usepackage[notes]\{biblatex-chicago\}}
\end{quote}
in your document preamble to load the notes \&\ bibliography style,
- or the line:
+ the line:
\begin{quote}
\cmd{usepackage[authordate,backend=biber]\{biblatex-chicago\}}
\end{quote}
- to load the author-date style. (You can use
- \mycolor{\texttt{notes15}} or \mycolor{\texttt{authordate15}} to
+ to load the author-date style, or the line:
+ \begin{quote}
+ \cmd{usepackage[\mycolor{authordate-trad},backend=biber]\{biblatex-chicago\}}
+ \end{quote}
+
+ to load the traditional variant of the author-date style. (You can
+ use \mycolor{\texttt{notes15}} or \mycolor{\texttt{authordate15}} to
load the 15th-edition styles. Please see
\mycolor{\textsf{biblatex-chicago15.pdf}} for the details.) Any
other options you usually pass to \textsf{biblatex} can be given to
\textsf{biblatex-chicago} instead, but loading it this way sets up a
number of other parameters automatically. You can also load the
package via the usual \cmd{usepackage\{biblatex\}}, adding either
- \texttt{style=chicago-notes} or \texttt{style=chicago-authordate},
+ \texttt{style=chicago\-notes} or \texttt{style=chicago-authordate},
but this is mainly for those who wish to set much of the low-level
formatting of their document themselves. Please see
sections~\ref{sec:loading} and \ref{sec:loading:auth} below for a
@@ -211,14 +221,23 @@ release.
\texttt{american} as the main text language. As before,
\textsf{babel}-less setups, and also those choosing \texttt{english}
as the main text language, should work out of the box.
- \textsf{Biblatex-chicago} also now provides support for German and
- French. Please see below (section~\ref{sec:international}) for a
- fuller explanation of all the options.
-\item The \textsf{chicago-notes.bbx}, \textsf{chicago-notes.cbx},
- \textsf{chicago-authordate.cbx}, \textsf{chi\-cago-authordate.bbx},
- \textsf{biblatex-chicago.sty}, \textsf{cms-am\-erican.lbx},
- \textsf{cms-french.lbx}, \textsf{cms-german.lbx}, and
- \textsf{cms-ngerman.lbx} files from \textsf{biblatex-chicago},
+ \textsf{Biblatex-chicago} also now provides support for
+ \mycolor{British}, French, German, \mycolor{Icelandic}, and
+ \mycolor{Norwegian}. Please see below
+ (section~\ref{sec:international}) for a fuller explanation of all
+ the options.
+\item \textsf{chicago-auth\-ordate.cbx},
+ \textsf{chi\-cago-authordate.bbx},
+ \mycolor{\textsf{chi\-cago-authordate-trad.cbx}},
+ \mycolor{\textsf{chicago-auth\-ordate-trad.bbx}},
+ \textsf{chicago-notes.bbx}, \textsf{chi\-cago-notes.cbx},
+ \textsf{cms-am\-erican.lbx}, \mycolor{\textsf{cms-british.lbx}},
+ \textsf{cms-french.lbx}, \textsf{cms-ger\-man.lbx},
+ \mycolor{\textsf{cms-icelandic.lbx}}, \textsf{cms-ngerman.lbx},
+ \mycolor{\textsf{cms-norsk.lbx}},
+ \mycolor{\textsf{cms-norwe\-gian.lbx}},
+ \mycolor{\textsf{cms-nynorsk.lbx}}, and
+ \textsf{biblatex-chicago.sty}, all from \textsf{biblatex-chicago},
installed either in a system-wide \TeX\ directory, or in the working
directory where you keep your *.tex files. (To use the 15th-edition
styles, you'll also require \textsf{\mycolor{chicago-notes15.bbx}},
@@ -253,12 +272,14 @@ release.
\textsf{dates-test.bib}, which will acquaint you with most of the
details on how to get started constructing your own .bib files for
use with the two \textsf{biblatex-chicago} styles.
-\item The files \textsf{cms-notes-sample.pdf} and
- \textsf{cms-dates-sample.pdf}. The first shows how my system
- processes \textsf{notes-test.bib} and \textsf{cms-notes-sample.tex},
- in both footnotes and bibliography, the second is the result of
- processing \textsf{dates-test.bib} and
- \textsf{cms-dates-sample.tex}. All of these files are in
+\item The files \textsf{cms-notes-sample.pdf},
+ \textsf{cms-dates-sample.pdf}, and
+ \mycolor{\textsf{cms-trad-sam\-ple.pdf}}. The first shows how my
+ system processes \textsf{notes-test.bib} and
+ \textsf{cms-notes-sample.tex}, in both footnotes and bibliography,
+ the second and third are the result of processing
+ \textsf{dates-test.bib} with \textsf{cms-dates-sample.tex} or
+ \mycolor{\textsf{cms-trad-sample.tex}}. All of these files are in
\texttt{doc/examples/}.
\item The file you are reading, \textsf{biblatex-chicago.pdf}, which
aims to be as complete a description as possible of the rules for
@@ -269,13 +290,14 @@ release.
only need to read the part(s) that apply to the style in which you
are interested. Much of the information in section~\ref{sec:Spec}
is duplicated in section~\ref{sec:authdate}, so even if you have a
- need for both styles then using one will be excellent preparation
- for the other. If you have used a previous version of this package,
- please pay particular attention to the sections on Obsolete and
- Deprecated Features, starting on page~\pageref{deprec:obsol}. You
- will find the seven previous files in the \texttt{doc/} subdirectory
- once you've extracted \textsf{biblatex-chicago.zip}. If you wish to
- place them in a system-wide directory, I would recommend
+ need for multiple styles then using one will be excellent
+ preparation for the others. If you have used a previous version of
+ this package, please pay particular attention to the sections on
+ Obsolete and Deprecated Features, starting on
+ page~\pageref{deprec:obsol}. You will find the seven previous files
+ in the \texttt{doc/} subdirectory once you've extracted
+ \textsf{biblatex-chicago.zip}. If you wish to place them in a
+ system-wide directory, I would recommend
\texttt{<TEXMFLOCAL>/doc/latex/biblatex-contrib/biblatex-chicago},
all the while remembering, of course, to update the file name
database afterward. (Let me reiterate, also, that if you currently
@@ -318,13 +340,18 @@ for formatting the footnote marks, and that for printing the
separating rule only after a run-on note, I've adapted from the
\textsf{footmisc} package by Robin Fairbairns, and I've borrowed ideas
for the \texttt{shorthandibid} option from Dominik Waßenhoven's
-\textsf{biblatex-dw} package. Kazuo Teramoto and Gildas Hamel both
-sent patches to improve the package, and there may be other \LaTeX\
-code I've appropriated and forgotten, in which case please remind me.
-Finally, Charles Schaum and Joseph Reagle Jr.\ were both extremely
-generous with their help and advice during the development of this
-package, and have both continued indefatigably to test it and suggest
-needed improvements. They were particularly instrumental in
+\textsf{biblatex-dw} package. I've adapted Audrey Boruvka's
+\cmd{textcite} code from
+\href{http://tex/stackexchange.com/questions/67837/citations-as-nouns-in-biblatex-chicago}{Stackexchange}
+for the notes \&\ bibliography style. I am very grateful to Baldur
+Kristinsson for providing the Icelandic localization, and to Håkon
+Malmedal for the Norwegian localizations. Kazuo Teramoto and Gildas
+Hamel both sent patches to improve the package, and there may be other
+\LaTeX\ code I've appropriated and forgotten, in which case please
+remind me. Finally, Charles Schaum and Joseph Reagle Jr.\ were both
+extremely generous with their help and advice during the development
+of this package, and have both continued indefatigably to test it and
+suggest needed improvements. They were particularly instrumental in
encouraging the greatest possible degree of compatibility with other
\textsf{biblatex} styles. Indeed, if the task of adapting .bib files
for use with the Chicago style seems onerous now, you should have
@@ -374,18 +401,19 @@ utterly sacrificing the latter.
\label{sec:bltries}
In short, the \textsf{biblatex} style files in this package try to
-simplify the task of following the two Chicago specifications. In the
-notes \&\ bibliography style, the two sorts of reference are treated
-separately (as are the two different note forms, long and short), and
-you can choose always to use the short note form, even at the first
-citation. In the author-date style, a series of options allows you to
-choose which date (original printing, reprint, or both) appears in
-citations and at the head of entries in the list of references. In
-both styles, punctuation is placed within quotation marks when needed,
-and as a general rule as many parts of the style as possible are
-implemented as transparently as possible. Thanks to advice I received
-from Joseph Reagle Jr.\ and Charles Schaum while these files were a
-work in progress, I have attended as carefully as I can to backward
+simplify the task of following the two Chicago specifications along
+with their major variants. In the notes \&\ bibliography style, the
+two sorts of reference are treated separately (as are the two
+different note forms, long and short), and you can choose always to
+use the short note form, even at the first citation. In the two
+author-date styles, a series of options allows you to choose which
+date (original printing, reprint, or both) appears in citations and at
+the head of entries in the list of references. In all styles,
+punctuation is placed within quotation marks when needed, and as a
+general rule as many parts of the style as possible are implemented as
+transparently as possible. Thanks to advice I received from Joseph
+Reagle Jr.\ and Charles Schaum while these files were a work in
+progress, I have attended as carefully as I can to backward
compatibility with the standard \textsf{biblatex} styles, and have
attempted to minimize both any changes you need to make to achieve
compliance with the Chicago specification, and indeed also any changes
@@ -441,7 +469,7 @@ the system. Headings in \mycolor{green} \colmarginpar{\textsf{New in
this release}} indicate material new to this release, or
occasionally old material that has undergone significant revision.
Numbers in parentheses refer to sections of the \emph{Chicago Manual
- of Style}, 15th edition. The file \textsf{notes-test.bib} contains
+ of Style}, 16th edition. The file \textsf{notes-test.bib} contains
many examples from the \emph{Manual} which, when processed using
\textsf{biblatex-chicago-notes}, should produce the same output as you
see in the \emph{Manual} itself, or at least compliant output, where
@@ -808,7 +836,7 @@ obsolete, and any such entries in your .bib file will trigger an
error. Please use the standard \textsf{biblatex} \textbf{letter} type
instead.
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mybigspace This \mymarginpar{\textbf{customb}} entry type is now
obsolete, and any such entries in your .bib file will trigger an
@@ -843,6 +871,8 @@ key in a \cmd{nocite} command, or you can put that entry key in the
\textsf{biblatex-chicago} will print the expanded abbreviation if and
only if you cite the main entry. (Cf.\ \textsf{userc}, below.)
+\enlargethispage{\baselineskip}
+
\mylittlespace Under ordinary circumstances, \textsf{biblatex-chicago}
will connect the two parts of the cross-reference with the word
\enquote{\emph{See}} --- or its equivalent in the document's language
@@ -860,8 +890,6 @@ media. This means that this entry type is now a clone of the
for users migrating from the old to the new specification. (See 3.22,
8.193; bedford:photo.)
-\enlargethispage{\baselineskip}
-
\mybigspace These \mymarginpar{\textbf{inbook}\\\textbf{incollection}}
two standard \textsf{biblatex} types have very nearly identical
formatting requirements as far as the Chicago specification is
@@ -1445,7 +1473,7 @@ Technical Report Number of a technical report. As in standard
report type in \textsf{note} and the \textsf{institution} in
\textsf{publisher}. (See herwign:office.)
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mybigspace The \colmarginpar{\textbf{review}} \textsf{review} entry
type was added to \textsf{biblatex 0.7}, and it certainly eases the
@@ -1529,7 +1557,7 @@ providing pseudonyms in square brackets that is the standard function
of this field in all other entry types, and possibly in the the
\textsf{review} type as well.
-\enlargethispage{-\baselineskip}
+%\enlargethispage{-\baselineskip}
\mybigspace This \colmarginpar{\textbf{suppbook}} is the entry type to
use if the main focus of a reference is supplemental material in a
@@ -1937,7 +1965,7 @@ ordinarily only be capitalized at the beginning of a sentence, then
simply ensure that that word is in lowercase, and
\textsf{biblatex-chicago-notes} will automatically do the right thing.
-%\enlargethispage{-\baselineskip}
+\enlargethispage{\baselineskip}
\mybigspace This \mymarginpar{\textbf{chapter}} field holds the
chapter number, mainly useful only in an \textsf{inbook} or an
@@ -2416,6 +2444,8 @@ proper place to identify the type of issue, e.g.,\ \texttt{special
issue}, with the initial letter lower-cased to enable automatic
contextual capitalization.
+\enlargethispage{\baselineskip}
+
\mybigspace The \mymarginpar{\textbf{journalsubtitle}} subtitle for a
\textsf{journaltitle} --- see next entry.
@@ -2459,8 +2489,6 @@ with a \texttt{notkeyword=original} in the optional argument to the
\cmd{printbibliography} command, though of course you can choose any
key you wish.
-%\enlargethispage{\baselineskip}
-
\mybigspace A \mymarginpar{\textbf{language}} standard
\textsf{biblatex} field, designed to allow you to specify the
language(s) in which a work is written. As a general rule, the
@@ -2791,7 +2819,7 @@ numbers, some improvisation may be needed if you wish to include
\textsf{titleaddon}, but in other entry types you may need to use the
\textsf{location} field.
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mybigspace In \mymarginpar{\textbf{origlanguage}} keeping with the
\emph{Manual}'s specifications, I have fairly thoroughly redefined
@@ -3061,7 +3089,7 @@ need to provide these strings in such a citation, then you'll have to
do so by hand in the \textsf{shortauthor} field, or in the
\textsf{shorteditor} field, whichever you are using.
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mybigspace Like \mymarginpar{\textbf{shorteditor}}
\textsf{shortauthor}, a field to provide a name for a short footnote,
@@ -3378,7 +3406,7 @@ do the right thing in citations. Cf.\ \textsf{artwork},
above, for all the details. (See auden:reading, bedford:photo,
cleese:holygrail, leo:madonna, nytrumpet:art.)
-\enlargethispage{-\baselineskip}
+%\enlargethispage{-\baselineskip}
\mybigspace A standard \colmarginpar{\textbf{url}} \textsf{biblatex}
field, it holds the url of an online publication, though you can
@@ -3526,6 +3554,8 @@ field. It holds the volume of a \textsf{journaltitle} in
volume of a multi-volume work in many other sorts of entry. Cf.\
\textsf{part}.
+\enlargethispage{\baselineskip}
+
\mybigspace Standard \colmarginpar{\textbf{volumes}} \textsf{biblatex}
field. It holds the total number of volumes of a multi-volume work,
and in the 16th edition of the \emph{Manual} no longer triggers any
@@ -3858,17 +3888,15 @@ The \textsf{biblatex} package is particularly rich in citation
commands, some of which (e.g., \cmd{supercite(s)}, \cmd{citeyear})
provide functionality that isn't really needed by the Chicago notes
and bibliography style offered here. If you are getting unexpected
-behavior when using them please have a look in your .log file. A
-command like \cmd{textcite}, listed in §~3.6.2 of the
-\textsf{biblatex} manual but not defined by \textsf{biblatex-chicago},
-defaults to \cmd{cite}, and leaves a warning in the .log. Others
-(e.g., \cmd{cite\-author}), though I haven't tested them extensively,
-should pretty much work out of the box. What remains are the commands
-I have found most useful and necessary for following the
-\emph{Manual}'s specifications, and I document in this section any
-alterations I have made to these. As always, if there are standard
-commands that don't work for you, or new commands that would be
-useful, please let me know, and it should be possible to fix or add
+behavior when using them please have a look in your .log file ---
+there may be warnings there that alert you to undefined citation
+commands. Other \textsf{biblatex}-provided commands, though I haven't
+tested them extensively, should pretty much work out of the box. What
+remains are the commands I have found most useful and necessary for
+following the \emph{Manual}'s specifications, and I document in this
+section any alterations I have made to these. As always, if there are
+standard commands that don't work for you, or new commands that would
+be useful, please let me know, and it should be possible to fix or add
them.
\mylittlespace A number of users have run into a problem that appears
@@ -3954,6 +3982,8 @@ is a standard command, and it too provides a full citation, but unlike
the previous command it doesn't automatically place it in a footnote.
It may be useful within long textual notes.
+\enlargethispage{-\baselineskip}
+
\mybigspace Matthew \mymarginpar{\textbf{\textbackslash headlesscite}}
Lundin requested a more generalized \cmd{headlesscite} macro,
suppressing the author's name in specific contexts while allowing
@@ -3967,8 +3997,6 @@ only the most flexible form of the command, you'll have to wrap it in
a \cmd{footnote} yourself. Please see the next entry for further
discussion of some of the needs this command might help address.
-%\enlargethispage{-\baselineskip}
-
\mybigspace I \mymarginpar{\textbf{\textbackslash
headless-\\fullcite}} have provided this command in case you want
to print a full citation without the author's name. The \emph{Manual}
@@ -4006,6 +4034,29 @@ notes this falls back to the standard format, but in long notes it
simply omits the given names of the \textsf{author} and provides only
the surname, along with the full data of the entry. (Cf.\ 14.52.)
+\mybigspace Norman \colmarginpar{\textbf{\textbackslash textcite}}
+Gray started a discussion on
+\href{http://tex/stackexchange.com/questions/67837/citations-as-nouns-in-biblatex-chicago}{Stackexchange}
+which established both that \textsf{biblatex} had begun including a
+\cmd{textcite} command in its verbose styles and that
+\textsf{biblatex-chicago-notes} hadn't kept up. In that thread the
+user Audrey provided some code, adapted from \textsf{verbose.cbx}, to
+provide such a command for the Chicago notes \&\ bibliography style.
+I'm still not entirely certain how best to accommodate this request
+within the package, but there are now at least commands
+(\cmd{textcite} and \cmd{textcites}) for users to test. Their
+functionality is a little complicated. In the main text, they will
+provide an \textsf{author's} name, followed immediately by a foot- or
+endnote which contains the full (or short) reference, following the
+usual rules. If you use \cmd{textcite} inside a foot- or endnote,
+then you'll get the \textsf{author's} name followed by the bibstring
+\enquote{\texttt{in},} then the headless citation. This latter usage
+is slightly awkward when the citation is a full one, but works
+reasonably well for short notes, and I'm as yet unconvinced that
+putting the citation inside parentheses, generally discouraged by the
+\emph{Manual} (14.33), helps this situation much. If you disagree,
+please let me know.
+
\mylittlespace If you look at \textsf{chicago-notes.cbx}, you'll see a
number of other citation commands, but those are intended for internal
use only, mainly in cross-references of various sorts. Use at your
@@ -4175,6 +4226,8 @@ variant of the default \texttt{nty}. (You can find its definition in
\textsf{chicago-notes.cbx}.) Users of all other backends will still
be using \texttt{nty}.
+\enlargethispage{\baselineskip}
+
\mylittlespace The advantages of this scheme are, specifically, that
any entry headed by one of the supplemental name fields
(\textsf{name[a-c]}), a \textsf{manual} entry headed by an
@@ -4206,12 +4259,20 @@ the preamble, for the whole document, or on a per-entry basis in the
would make sense to eliminate the \textsf{pages} field from the
affected entries).
-\mylittlespace This \mymarginpar{\texttt{doi=true}} option controls
+\mylittlespace This \colmarginpar{\texttt{doi=true}} option controls
whether any \textsf{doi} fields present in the .bib file will be
-printed in notes and bibliography. It defaults to true, and can be
-set to false either in the preamble, for the whole document, or on a
-per-entry basis, in the \textsf{options} field. In \textsf{online}
-entries, the \textsf{doi} field will always be printed.
+printed in notes and bibliography. At the request of Daniel
+Possenriede, and keeping in mind the \emph{Manual's} preference for
+this field instead of a \textsf{url} (14.6), I have added a third
+switch, \mycolor{\texttt{only}}, which prints the \textsf{doi} if it
+is present and the \textsf{url} only if there is no \textsf{doi}. The
+package default remains the same, however --- it defaults to true,
+which will print both \textsf{doi} and \textsf{url} if both are
+present. The option can be set to \texttt{only} or to \texttt{false}
+either in the preamble, for the whole document, or on a per-entry
+basis in the \textsf{options} field. In \textsf{online} entries, the
+\textsf{doi} field will always be printed, but the \texttt{only}
+switch will still eliminate any \textsf{url}.
\mylittlespace This \colmarginpar{\texttt{eprint=true}} option controls
whether any \textsf{eprint} fields present in the .bib file will be
@@ -4593,45 +4654,70 @@ when your .bib file gets to a certain size.
\section{The Specification: Author-Date}
\label{sec:authdate}
-In what follows, I attempt to explain all the parts of
-\textsf{biblatex-chicago-authordate} that might be considered somehow
-\enquote{non standard,} at least with respect to the styles included
-with \textsf{biblatex} itself, though in the section on entry fields I
+The \textsf{biblatex-chicago} package now contains \emph{two}
+different author-date styles. The first,
+\textsf{biblatex-chicago-authordate}, implements the specifications of
+the 16th edition of the \emph{Chicago Manual of Style}. Numbers in
+parentheses refer to sections of the \emph{Manual}, though as this
+latest edition now recommends \enquote{a uniform treatment for the
+ main elements of citation in both of its systems of documentation}
+(15.2), many of these references will in fact be to the chapter on the
+notes \&\ bibliography style (chap.\ 14), which chapter is, by design,
+considerably more detailed than that devoted to the author-date style.
+The second, \mycolor{\textsf{biblatex-chicago-authordate-trad}},
+implements that same specification but with a markedly different style
+of title presentation, including sentence-style capitalization and an
+absence of quotation marks around the (plain-text) titles of
+\textsf{article} or \textsf{incollection} entries, \emph{inter alia}.
+The \textsf{trad} style is so named because older versions of the
+\emph{Manual}, up to and including the 15th edition, recommended this
+plainer style for author-date titles, and the 16th edition itself
+suggests the possibility, when needed, of retaining such title
+presentation in combination with its own recommendations for other
+parts of the reference apparatus (15.45). In practice, the
+differences between the two styles necessitate separate discussions of
+the \textsf{title} field and one extra package option
+(\mycolor{\texttt{headline}}), and that's about it.
+
+\mylittlespace Generally, then, the following documentation covers
+both Chicago author-date styles, and attempts to explain all the parts
+of the specification that might be considered somehow \enquote{non
+ standard,} at least with respect to the styles included with
+\textsf{biblatex} itself. In the section on entry fields I admit I
have also duplicated a lot of the information in
\textsf{biblatex.pdf}, which I hope won't badly annoy expert users of
-the system. Headings in \mycolor{green} \colmarginpar{\textsf{New in
- this release}} indicate material new to this release, or
-occasionally old material that has undergone significant revision.
-Numbers in parentheses refer to sections of the \emph{Chicago Manual
- of Style}, 16th edition. (As this latest edition now recommends
-\enquote{a uniform treatment for the main elements of citation in both
- of its systems of documentation} [15.2], many of these references
-will in fact be to the chapter on the notes \&\ bibliography style,
-which chapter is, by design, considerably more detailed than that
-devoted to the author-date style.) The file \textsf{dates-test.bib}
-contains many examples from the \emph{Manual} which, when processed
-using \textsf{biblatex-chicago-authordate}, should produce the same
-output as you see in the \emph{Manual} itself, or at least compliant
-output, where the specifications are vague or open to interpretation,
-a state of affairs which does sometimes occur. I have provided
-\textsf{cms-dates-sample.pdf}, which shows how my system processes
-\textsf{dates-test.bib}, and I have also included the reference keys
-from the latter file below in parentheses.
+the system. As usual, headings in \mycolor{green}
+\colmarginpar{\textsf{New in this release}} indicate material new to
+this release, or occasionally old material that has undergone
+significant revision. The file \textsf{dates-test.bib} contains many
+examples from the \emph{Manual} which, when processed using
+\textsf{biblatex-chicago-authordate}, should produce the same output
+as you see in the \emph{Manual} itself, or at least compliant output,
+where the specifications are vague or open to interpretation, a state
+of affairs which does sometimes occur. If you are using
+\mycolor{\textsf{biblatex-chicago-authordate-trad}} the same basically
+holds, but you'd have to keep one eye on the 15th edition of the
+\emph{Manual} (chap.\ 17) for the titles. I have provided
+\textsf{cms-dates-sample.pdf} and
+\mycolor{\textsf{cms-trad-sample.pdf}}, which show how my system
+processes \textsf{dates-test.bib}, and I have also included the
+reference keys from the latter file below in parentheses.
\subsection{Entry Types}
\label{sec:types:authdate}
The complete list of entry types currently available in
-\textsf{biblatex-chicago-authordate}, minus the odd \textsf{biblatex}
+\textsf{biblatex-chicago-authordate} and
+\mycolor{\textsf{authordate-trad}}, minus the odd \textsf{biblatex}
alias, is as follows: \textbf{article}, \textbf{artwork},
\textbf{audio}, \textbf{book}, \textbf{bookinbook}, \textbf{booklet},
\textbf{collection}, \textbf{customc}, \textbf{image},
\textbf{inbook}, \textbf{incollection}, \textbf{inproceedings},
-\textbf{inreference}, \mycolor{\textbf{letter}}, \textbf{manual},
-\mycolor{\textbf{misc}}, \textbf{music}, \textbf{online} (with its
-alias \textbf{www}), \textbf{patent}, \textbf{periodical},
-\textbf{proceedings}, \textbf{reference}, \textbf{report} (with its
-alias \textbf{techreport}), \textbf{review}, \textbf{suppbook},
+\textbf{inreference}, \textbf{letter}, \textbf{manual}, \textbf{misc},
+\textbf{music}, \textbf{online} (with its alias \textbf{www}),
+\textbf{patent}, \textbf{periodical}, \textbf{proceedings},
+\textbf{reference}, \textbf{report} (with its alias
+\textbf{techreport}), \textbf{review}, \textbf{suppbook},
\textbf{suppcollection}, \textbf{suppperiodical}, \textbf{thesis}
(with its aliases \textbf{mastersthesis} and \textbf{phdthesis}),
\textbf{unpublished}, and \textbf{video}.
@@ -4647,8 +4733,8 @@ very few fields when you use \textsf{biblatex-chicago-authordate}, so
it seemed to me better to gather information pertaining to fields in
the next section.
-\mybigspace The \colmarginpar{\textbf{article}} \emph{Chicago Manual
- of Style} (14.170) recognizes three different sorts of periodical
+\mybigspace The \mymarginpar{\textbf{article}} \emph{Chicago Manual of
+ Style} (14.170) recognizes three different sorts of periodical
publication, \enquote{journals,} \enquote{magazines,} and
\enquote{newspapers.} The first (14.172) includes \enquote{scholarly
or professional periodicals available mainly by subscription,} while
@@ -4689,7 +4775,7 @@ citation style you are using, it is \enquote{usually sufficient to
date of publication in a parenthetical reference, including any other
information in the main text (14.206), thereby obviating the need to
present such an entry in the list of references. To utilize this
-method in the author-date style, in addition to a \texttt{magazine}
+method in the author-date styles, in addition to a \texttt{magazine}
\textsf{entrysubtype}, you'll need to place
\mycolor{\texttt{cmsdate=full}} into the \textsf{options} field,
including \texttt{skipbib} there as well to stop the entry printing in
@@ -4705,8 +4791,8 @@ plays, performances, etc.) as a sort of recognizable subset of
\enquote{journals,} \enquote{magazines,} and \enquote{newspapers,}
distinguished mainly by the way one formats the title of the review
itself. With the 16th edition's changes to the way titles are
-presented in the author-date style, users need to learn how to present
-this sort of material, which involves using an entry type
+presented in the \textsf{authordate} style, users need to learn how to
+present this sort of material, which involves using an entry type
(\textsf{review}) that wasn't necessary in the 15th edition. The key
rule is this: if a review has a separate, non-generic title (gibbard;
osborne:poison) in addition to something that reads like
@@ -4785,7 +4871,7 @@ nyt:trevorobit, unsigned:ranke.)
\mylittlespace Fourth, in certain fields, just beginning your data
with a lowercase letter activates the mechanism for capitalizing that
letter depending on its context within a list of references entry.
-This is less important in the author-date style, where this
+This is less important in the author-date styles, where this
information only turns up in the reference list and not in citations,
but you can consult \textbf{\textbackslash autocap} below for all the
details. Both the \textsf{titleaddon} and \textsf{note} fields are
@@ -4837,7 +4923,7 @@ entry with the same \textsf{entrysubtype}. Such comments make
particular use of the \textsf{eventdate} and of the \textsf{nameaddon}
fields; please see the documentation of \textbf{review}, below.
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mylittlespace If you're still with me, allow me to recommend that you
browse through \textsf{dates-test.bib} to get a feel for just how many
@@ -4889,7 +4975,7 @@ type with an \textsf{entrysubtype}. Fortunately, in this instance the
other fields in a \textsf{misc} entry function pretty much as in
\textsf{artwork} or \textsf{image}.
-\mybigspace Following \colmarginpar{\textbf{audio}} the request of
+\mybigspace Following \mymarginpar{\textbf{audio}} the request of
Johan Nordstrom, I have included three entry types, all undefined by
the standard styles, designed to allow users to present audiovisual
sources in accordance with the Chicago specifications. The
@@ -4905,8 +4991,8 @@ though there are likely to be occasions when your choice of entry type
is not obvious, at the very least \textsf{biblatex-chicago} should
help you maintain consistency.
-\mylittlespace For users of the author-date style, the 16th edition of
-the \emph{Manual} (15.53) \enquote{recommends a more comprehensive
+\mylittlespace For users of the author-date styles, the 16th edition
+of the \emph{Manual} (15.53) \enquote{recommends a more comprehensive
approach to dating audiovisual materials than in previous editions,}
meaning that nearly all such entries will have some sort of dating
information and will therefore fit better stylistically with other
@@ -5004,7 +5090,7 @@ obsolete, and any such entries in your .bib file will trigger an
error. Please use the standard \textsf{biblatex} \textbf{bookinbook}
type instead.
-\mybigspace This \colmarginpar{\textbf{customc}} entry type allows you
+\mybigspace This \mymarginpar{\textbf{customc}} entry type allows you
to include alphabetized cross-references to other, separate entries in
the bibliography, particularly to other names or pseudonyms, as
recommended by the \emph{Manual}. (This is different from the usual
@@ -5062,7 +5148,7 @@ just the text of the comment in the \textsf{title} field,
text and the comment will do the trick, e.g.,
\cmd{autocites\{chicago:manual\}\{chicago:comment\}}.
-\mybigspace This \colmarginpar{\textbf{image}} entry type, left
+\mybigspace This \mymarginpar{\textbf{image}} entry type, left
undefined in the standard styles, was in previous releases of
\textsf{biblatex-chicago} intended for referring to photographs, but
the 16th edition of the \emph{Manual} has changed its specifications
@@ -5145,7 +5231,7 @@ latter was presented as an \textsf{inreference} entry for the notes
\&\ bibliography style, but because the \textsf{book} entry type can
also present references to alphabetized headings [see below], at least
in the list of references, then it seemed better just to choose a
-\textsf{book} entry for the author-date style.)
+\textsf{book} entry for the author-date styles.)
\mylittlespace If you simply cannot make your source fit the template
for a \textsf{book}, then you may need to use the \textsf{inreference}
@@ -5157,7 +5243,7 @@ keyword \enquote{\texttt{and}} if there is more than one, and
\textsf{biblatex-chicago-authordate} will provide the appropriate
prefatory string (\texttt{s.v.}, plural \texttt{s.vv.}), and enclose
each in its own set of quotation marks (times:guide). More relevant
-to the author-date style is the fact that the \textsf{postnote} field
+to the author-date styles is the fact that the \textsf{postnote} field
works the same way in \textsf{inreference} entries, the only
limitation on this system being that this field, unlike
\textsf{lista}, is not a list, and therefore for the formatting to
@@ -5193,7 +5279,7 @@ This name will be printed in parentheses after the entry's name
\mylittlespace All of these rules apply to online reference works, as
well, for which you need to provide not only a \textsf{url} but also,
always, a \textsf{urldate}, as these sources are in constant flux
-(wikiped:bibtex, grove:sibelius). The author-date style will
+(wikiped:bibtex, grove:sibelius). The author-date styles will
automatically use this as the identifying date in citations and the
list of references, assuming a more conventional \textsf{date} isn't
available. Please note, however, that the automatic provision of the
@@ -5255,7 +5341,7 @@ entry for such a reference, then you would need to define both
have put in \textsf{organization}. (See 14.92; chicago:manual,
dyna:browser, natrecoff:camera.)
-\mybigspace As \colmarginpar{\textbf{misc}} its name suggests, the
+\mybigspace As \mymarginpar{\textbf{misc}} its name suggests, the
\textsf{misc} entry type was designed as a hold-all for citations that
didn't quite fit into other categories. In \textsf{biblatex-chicago},
I have somewhat extended its applicability, while retaining its
@@ -5350,7 +5436,7 @@ within your own work than conformity to some external standard, so it
is the former which you should pursue. I hope that
\textsf{biblatex-chicago} proves helpful in this regard.
-\mybigspace The \colmarginpar{\textbf{music}} 16th edition of the
+\mybigspace The \mymarginpar{\textbf{music}} 16th edition of the
manual has revised its recommendations more for this type than for any
other, so the notes which follow present several large changes that
you'll need to make to your .bib files. The good news is that some,
@@ -5475,7 +5561,7 @@ section~\ref{sec:authpreset}; auden:reading, beethoven:sonata29,
bernstein:shostakovich, floyd:atom, holiday:fool, nytrumpet:art,
rubinstein:chopin.)
-\mybigspace The \colmarginpar{\textbf{online}} \emph{Manual}'s
+\mybigspace The \mymarginpar{\textbf{online}} \emph{Manual}'s
scattered instructions (14.4--13, 14.166--169, 14.184--185, 14.200,
14.223, 14.243--246, 15.4, 15.9) for citing online materials are
slightly different from those suggested by standard \textsf{biblatex}.
@@ -5519,7 +5605,7 @@ dates to access dates when documenting online material. See
%\enlargethispage{\baselineskip}
-\mybigspace The \colmarginpar{\textbf{patent}} \emph{Manual} is very
+\mybigspace The \mymarginpar{\textbf{patent}} \emph{Manual} is very
brief on the subject of patents (15.50), but very clear about which
information it wants you to present, so such entries may not work well
with other \textsf{biblatex} styles. In a change to previous
@@ -5558,7 +5644,7 @@ citing is a \enquote{newspaper} or \enquote{magazine} instead of a
place for identifying strings like \enquote{special issue,} with its
initial lowercase letter to activate the automatic capitalization
routines, though this isn't strictly necessary in the author-date
-style. (See \emph{Manual} 14.187; good:wholeissue.)
+styles. (See \emph{Manual} 14.187; good:wholeissue.)
\mybigspace This \mymarginpar{\textbf{reference}} entry type is
aliased to \textsf{collection} by the standard \textsf{biblatex}
@@ -5589,27 +5675,29 @@ Technical Report Number of a technical report. As in standard
report type in \textsf{note} and the \textsf{institution} in
\textsf{publisher}. (See herwign:office.)
-\mybigspace The \colmarginpar{\textbf{review}} \textsf{review} entry
+\mybigspace The \mymarginpar{\textbf{review}} \textsf{review} entry
type wasn't, strictly speaking, necessary for the 15th edition
author-date specification. With the major changes to the presentation
of the title fields in the 16th edition, however, it has now become
-necessary for author-date users to familiarize themselves with it as a
-means of coping with the \emph{Manual}'s complicated requirements for
-citing periodicals of all sorts. As its name suggests, this entry
-type was designed for reviews published in periodicals, and if you've
-already read the \textsf{article} instructions above --- if you
-haven't, I recommend doing so now --- you'll know that \textsf{review}
-serves as well for citing other sorts of material with generic titles,
-like letters to the editor, obituaries, interviews, online comments
-and the like. The primary rule is that any piece that has only a
-generic title, like \enquote{review of \ldots,} \enquote{interview
- with \ldots,} or \enquote{obituary of \ldots,} calls for the
-\textsf{review} type. Any piece that also has a specific title, e.g.,
-\enquote{\enquote{Lost in \textsc{Bib}\TeX,} an interview with
- \ldots,} requires an \textsf{article} entry. (This assumes the text
-is found in a periodical of some sort. Were it found in a book, then
-the \textsf{incollection} type would serve your needs, and you could
-use \textsf{title} and \textsf{titleaddon} there. While we're on the
+necessary for \textsf{authordate} users, if not
+\mycolor{\textsf{authordate-trad}} users, to familiarize themselves
+with it as a means of coping with the \emph{Manual}'s complicated
+requirements for citing periodicals of all sorts. As its name
+suggests, this entry type was designed for reviews published in
+periodicals, and if you've already read the \textsf{article}
+instructions above --- if you haven't, I recommend doing so now ---
+you'll know that \textsf{review} serves as well for citing other sorts
+of material with generic titles, like letters to the editor,
+obituaries, interviews, online comments and the like. The primary
+rule is that any piece that has only a generic title, like
+\enquote{review of \ldots,} \enquote{interview with \ldots,} or
+\enquote{obituary of \ldots,} calls for the \textsf{review} type. Any
+piece that also has a specific title, e.g., \enquote{\enquote{Lost in
+ \textsc{Bib}\TeX,} an interview with \ldots,} requires an
+\textsf{article} entry. (This assumes the text is found in a
+periodical of some sort. Were it found in a book, then the
+\textsf{incollection} type would serve your needs, and you could use
+\textsf{title} and \textsf{titleaddon} there. While we're on the
topic of exceptions, the \emph{Manual} includes an example --- 14.221
--- where the \enquote{Interview} part of the title is considered a
subtitle rather than a titleaddon, said part therefore being included
@@ -5642,7 +5730,7 @@ citation style you are using, it is \enquote{usually sufficient to
date of publication in a parenthetical reference, including any other
information in the main text (14.206), thereby obviating the need to
present such an entry in the list of references. To utilize this
-method in the author-date style, in addition to a \texttt{magazine}
+method in the author-date styles, in addition to a \texttt{magazine}
\textsf{entrysubtype}, you'll need to place
\mycolor{\texttt{cmsdate=full}} into the \textsf{options} field,
including \texttt{skipbib} there as well to stop the entry printing in
@@ -5719,7 +5807,7 @@ depending on the context. Examples might be \enquote{\texttt{preface
that unless you use a \cmd{bibstring} command in the \textsf{type}
field, the resultant entry will not be portable across languages.)
-\enlargethispage{-\baselineskip}
+\enlargethispage{\baselineskip}
\mylittlespace The other rules for constructing your .bib entry remain
the same. The \textsf{author} field refers to the author of the
@@ -5741,15 +5829,15 @@ function analogous to \textsf{suppbook}. Indeed, I believe the
both types of work, so this entry type is an alias to
\textsf{suppbook}, which see.
-\mybigspace This \colmarginpar{\textbf{suppperiodical}} type is
+\mybigspace This \mymarginpar{\textbf{suppperiodical}} type is
intended to allow reference to generically-titled works in
periodicals, such as regular columns or letters to the editor.
\textsf{Biblatex} also provides the \textsf{review} type for this
purpose, so in both Chicago styles \textsf{suppperiodical} is an alias
-of \textsf{review}. In the 16th edition of the author-date style, as
-discussed above, the use of this latter entry type has become
-necessary, so please see its documentation for instructions on how to
-construct a .bib entry for such works.
+of \textsf{review}. In the 16th edition of the \textsf{authordate}
+style, as discussed above, the use of this latter entry type has
+become necessary, so please see its documentation for instructions on
+how to construct a .bib entry for such works.
\mybigspace This \mymarginpar{\textbf{video}} is the last of the three
audiovisual entry types, and as its name suggests it is intended for
@@ -5884,6 +5972,8 @@ undefined, and \textsf{biblatex-chicago} will do the rest. Cf.\
\textsf{foreword} and \textsf{introduction}. (See \emph{Manual} 14.91,
14.116; polakow:afterw.)
+\enlargethispage{\baselineskip}
+
\mybigspace At \mymarginpar{\textbf{annotation}} the request of Emil
Salim, \textsf{biblatex-chicago} has, as of version 0.9, added a
package option (see \texttt{annotation} below, section
@@ -5980,6 +6070,8 @@ may be advantageous to provide a (formatted and abbreviated)
reasonable length, though not at the expense of making it hard to find
the relevant entries in the reference list.
+\enlargethispage{-\baselineskip}
+
\mylittlespace Recommendations \colmarginpar{New!} concerning
anonymous authors in other kinds of references have changed somewhat
in the 16th edition of the \emph{Manual} (15.32), placing greater
@@ -6118,7 +6210,8 @@ find a \textsf{booktitle} in other sorts of entries (e.g.,
invariably be providing information for the \textsc{Bib}\TeX\
cross-referencing apparatus (prairie:state), which I discuss below
(\textbf{crossref}). The \textsf{booktitle} no longer takes
-sentence-style capitalization in author-date.
+sentence-style capitalization in \textsf{authordate}, though it does
+in \mycolor{\textsf{authordate-trad}}.
%\enlargethispage{\baselineskip}
@@ -6213,7 +6306,7 @@ such cross-references, most especially in \textsf{letter},
state of \textsf{biblatex-chicago}, a bad idea.
\mybigspace Predictably, \colmarginpar{\textbf{date}} this is one of
-the key fields for the author-date style, and one which, as a general
+the key fields for the author-date styles, and one which, as a general
rule, every .bib entry designed for this system ought to contain. So
important is it, that \textsf{biblatex-chicago-authordate} will, in
most entry types, supply a missing \cmd{bibstring\{nodate\}} if there
@@ -6232,7 +6325,7 @@ year at all will it fall back on \cmd{bibstring\{nodate\}}. You can
eliminate some of these dates from the running, or change the search
order, using the \cmd{DeclareLabelyear} command in your preamble, but
please be aware that I have hard-coded this order into the author-date
-style in order to cope with some tricky corners of the specification.
+styles in order to cope with some tricky corners of the specification.
If you reorder these dates, and your references enter these tricky
corners, the results might be surprising. (Cf.\ section~4.5.2 in
\textsf{biblatex.pdf} for the \cmd{DeclareLabelyear} command, and
@@ -6403,6 +6496,8 @@ options often being required, but their presence at least should allow
maximum flexibility in reference lists that contain a lot of
\textsf{origdates}.
+\enlargethispage{\baselineskip}
+
\mylittlespace Finally, in the \textsf{misc} entry type this field can
help to distinguish between two classes of archival material, letters
and \enquote{letter-like} sources using \textsf{origdate} while others
@@ -6486,7 +6581,7 @@ field, in one of the \textsf{titleaddon} fields, or even in a
identifying an editor differ in notes and bibliography, one can't
simply write them out in such a field when using the notes \&\
bibliography style, but you can certainly do so in the author-date
-style, if you wish. Using the macros will make your .bib file more
+styles, if you wish. Using the macros will make your .bib file more
portable across both Chicago specifications, and also across multiple
languages, but they are otherwise unnecessary.
Cf. section~\ref{sec:international}, and also \textsf{namea},
@@ -6677,7 +6772,7 @@ performances (friends:leia, handel:messiah, holiday:fool).
\mylittlespace In the default configuration of \cmd{DeclareLabelyear},
dates for citations and for the head of reference list entries are
searched for in the order \textsf{date, eventdate, origdate, urldate}.
-This suits the Chicago author-date style very well, except for
+This suits the Chicago author-date styles very well, except for
\textsf{music} and \textsf{video} entries, where the general rule is
to emphasize the earliest date, whether that be, for example, the
recording date or original release date (15.53). For these two entry
@@ -6712,7 +6807,7 @@ from the \textsf{author}. The \emph{Manual} has nothing to say on the
subject, but \textsf{biblatex-chicago} prints it (them), in
parentheses, just after the author(s).
-%\enlargethispage{\baselineskip}
+\enlargethispage{\baselineskip}
\mybigspace Standard \mymarginpar{\textbf{howpublished}}
\textsf{biblatex} field, mainly applicable in the \textsf{booklet}
@@ -6886,8 +6981,10 @@ provide the parentheses (14.246; ellis:blog).
\mybigspace The \colmarginpar{\textbf{maintitle}} main title for a
multi-volume work, e.g., \enquote{Opera} or \enquote{Collected Works.}
-It no longer takes sentence-style capitalization in author-date. (See
-donne:var, euripides:\-orestes, harley:cartography, lach:asia,
+It no longer takes sentence-style capitalization in
+\textsf{authordate}, though it does in
+\mycolor{\textsf{authordate-trad}}. (See donne:var,
+euripides:\-orestes, harley:cartography, lach:asia,
pelikan:chris\-tian, and plato:re\-public:gr.)
\mybigspace An \mymarginpar{\textbf{maintitleaddon}} annex to the
@@ -7103,29 +7200,29 @@ entries can work; creel:house shows the field in action in a
instead.)
\mylittlespace Because of the importance of date specifications in the
-author-date style, \textsf{biblatex-chicago-authordate} provides
-options and automated behaviors that allow you to emphasize the
-\textsf{origdate} in citations and at the head of entries in the list
-of references. In entries which have \emph{only} an \textsf{origdate}
---- usually \textsf{misc} with an \textsf{entrysubtype} ---
-\textsf{Biber} and the default \cmd{DeclareLabelyear} configuration
-now make it possible to do without a \texttt{cmsdate} option, as the
-\textsf{origdate} will automatically appear where and as it should.
-In \textsf{book}-like entries with both a \textsf{date} and an
-\textsf{origdate}, and this has \colmarginpar{New!} changed from the
-15th edition, the 16th edition of the \emph{Manual} recommends that
-you present, in citations and at the head of reference list entries,
-only the \textsf{date} or both dates together. The latter is
-accomplished using the \texttt{cmsdate} entry option. In some cases
-it may even be necessary to reverse the two date fields, putting the
-earlier year in \textsf{date} and the later in \textsf{origdate}.
-Please see above under \textbf{date} for all the details on how these
-options interact.
+author-date styles, \textsf{bibla\-tex-chicago-authordate} and
+\mycolor{\textsf{authordate-trad}} provide options and automated
+behaviors that allow you to emphasize the \textsf{origdate} in
+citations and at the head of entries in the list of references. In
+entries which have \emph{only} an \textsf{origdate} --- usually
+\textsf{misc} with an \textsf{entrysubtype} --- \textsf{Biber} and the
+default \cmd{DeclareLabelyear} configuration now make it possible to
+do without a \texttt{cmsdate} option, as the \textsf{origdate} will
+automatically appear where and as it should. In \textsf{book}-like
+entries with both a \textsf{date} and an \textsf{origdate}, and this
+has \colmarginpar{New!} changed from the 15th edition, the 16th
+edition of the \emph{Manual} recommends that you present, in citations
+and at the head of reference list entries, only the \textsf{date} or
+both dates together. The latter is accomplished using the
+\texttt{cmsdate} entry option. In some cases it may even be necessary
+to reverse the two date fields, putting the earlier year in
+\textsf{date} and the later in \textsf{origdate}. Please see above
+under \textbf{date} for all the details on how these options interact.
\mylittlespace In the default configuration of \cmd{DeclareLabelyear},
dates for citations and for the head of reference list entries are
searched for in the order \textsf{date, eventdate, origdate, urldate}.
-This suits the Chicago author-date style very well, except for
+This suits the Chicago author-date styles very well, except for
\textsf{music} and \textsf{video} entries, and, exceptionally, some
\textsf{review} entries. Here the general rule is to emphasize the
earliest date. For these three entry types, then,
@@ -7368,7 +7465,7 @@ be \enquote{Orig.\ pub.\ in.} Please see the documentation on
\textsf{userf} below for all the details on how to create .bib entries
for presenting your data.
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mybigspace A \mymarginpar{\textbf{series}} standard \textsf{biblatex}
field, usually just a number in an \textsf{article},
@@ -7567,87 +7664,54 @@ present several reprinted books by the same author. See
%\enlargethispage{-\baselineskip}
-\mybigspace In \colmarginpar{\textbf{title}} the vast majority of
-cases, this field works just as it always has in \textsc{Bib}\TeX, and
-just as it does in \textsf{biblatex}. In a major change to previous
-editions of the \emph{Manual}, the 16th edition now recommends that
-\textsf{titles} be treated more or less identically across both its
-systems of documentation, whether with respect to headline-style
-capitalization or to the use of italics and quotation marks (15.2,
-15.6, 15.13). This means that users of the author-date style no
-longer need to worry about sentence-style capitalization when
-compiling their .bib databases, and so can eschew the extra curly
-braces needed to preserve uppercase letters in this context. The
-other new rules, however, mean that a few new complications, familiar
-to users of the notes \&\ bibliography style, will arise. First,
-although nearly every entry will have a \textsf{title}, there are some
-exceptions, particularly \textsf{incollection} or \textsf{online}
-entries with a merely generic title, instead of a specific one
-(centinel:letters, powell:email). Second, the \emph{Manual}'s rules
-for formatting \textsf{titles}, which also hold for
-\textsf{booktitles} and \textsf{maintitles}, require additional
-attention. The whole point of using a \textsc{Bib}\TeX-based system
-is for it to do the formatting for you, and in most cases
-\textsf{biblatex-chicago-authordate} does just that, surrounding
-titles with quotation marks, italicizing them, or occasionally just
-leaving them alone. When, however, a title is quoted within a title,
-then you need to know some of the rules. A summary here should serve
-to clarify them, and help you to understand when
-\textsf{biblatex-chicago-authordate} might need your help in order to
-comply with them.
-
-% \mylittlespace With regard to sentence-style capitalization, the rules
-% of the Chicago author-date style are fairly simple:
-
-% \begin{description}
-% \item[\qquad Headline Style:] \textsf{journaltitle} in all types,
-% \textsf{series} in all \textsf{book}-like entries (i.e., not in
-% \textsf{articles}), and \textsf{title} in \textsf{periodical}
-% entries.
-% \item[\qquad Sentence Style:] Every other \textsf{title},
-% \emph{except} in \textsf{letter} entries and in \textsf{misc}
-% entries with an \textsf{entrysubtype}. Also, the
-% \textsf{booktitle}, \textsf{issuetitle}, and \textsf{maintitle} in
-% all entry types.
-% \item[\qquad Contextual Capitalization of First Word:]
-% \textsf{titleaddon}, \textsf{booktitleaddon},
-% \textsf{maintitleaddon} in all entry types, and the \textsf{title}
-% of \textsf{misc} entries with an \textsf{entrysubtype}.
-% \item[\qquad Plain:] \textsf{title} in \textsf{letter} entries.
-% \end{description}
-
-% What this means in practice is that to get a title like \emph{The
-% Chicago manual of style}, your .bib entry needs to have a field that
-% looks something like this:
-% \begin{quote}
-% \texttt{title = \{The \{Chicago\} Manual of Style\}}
-% \end{quote}
-
-% This is completely straightforward, but remember that if an
-% \textsf{article} has a title like: Review of \emph{The Chicago manual
-% of style}, then the curly braces enclosing material to be formatted
-% in italics will cause the capitalization algorithm to stop and leave
-% all of that material as it is, so your .bib entry would need to have a
-% field something like this:
-
-% \begin{quote}
-% \texttt{title = \{}\cmd{bibstring\{reviewof\}} \cmd{mkbibemph\{The
-% Chicago manual of style\}\}}
-% \end{quote}
-
-% (As an aside, the use of the \texttt{reviewof} bibstring isn't
-% strictly necessary here, but it helps with portability across
-% languages and across the two Chicago styles. If you've noticed a lot
-% of lowercase letters starting fields in \textsf{dates-test.bib},
-% they're present because in the notes \&\ bibliography style
-% capitalization is complicated by notes using commas where the
-% bibliography uses periods, and words like \enquote{review} start in
-% uppercase only if the context demands it. There's considerably less
-% of this in the author-date style [note the \textsf{*titleaddon}
-% fields], but it still pays to be aware of the issue.)
+\mybigspace This \colmarginpar{\textbf{title}} release of
+\textsf{biblatex-chicago} now includes the
+\mycolor{\textsf{authordate-trad}} style, designed as a kind of hybrid
+style according to indications contained in the 16th edition of the
+\emph{Manual} (14.45). This \mycolor{\textsf{trad}} style differs
+\emph{only} in the way it treats the \textsf{title} and related
+fields, which retain the forms they have traditionally had in the
+Chicago author-date specifications prior to the latest edition. Where
+the new edition uses headline-style capitalization, the older editions
+used sentence-style; where the new edition places \textsf{article} or
+\textsf{incollection} \textsf{titles} within quotation marks, the
+older editions presented them in plain text. If you have been using
+the 15th-edition author-date style, then your \textsf{title} fields
+won't need any changes for \mycolor{\textsf{authordate-trad}}, but I
+shall include just below, under a separate rubric, full documentation
+for \mycolor{\textsf{trad}} \textsf{title} fields for those just
+coming to the package. First, though, I document the same field(s)
+for the standard author-date style.
+
+\mylittlespace In the vast majority of cases, this field works just as
+it always has in \textsc{Bib}\TeX, and just as it does in
+\textsf{biblatex}. In a major change to previous editions of the
+\emph{Manual}, the 16th edition now recommends that \textsf{titles} be
+treated more or less identically across both its systems of
+documentation (15.2, 15.6, 15.13). This means that users of the
+author-date style no longer need to worry about sentence-style
+capitalization when compiling their .bib databases, and so can eschew
+the extra curly braces needed to preserve uppercase letters in this
+context. The other new rules, however, mean that a few new
+complications, familiar to users of the notes \&\ bibliography style,
+will arise. First, although nearly every entry will have a
+\textsf{title}, there are some exceptions, particularly
+\textsf{incollection} or \textsf{online} entries with a merely generic
+title, instead of a specific one (centinel:letters, powell:email).
+Second, the \emph{Manual}'s rules for formatting \textsf{titles},
+which also hold for \textsf{booktitles} and \textsf{maintitles},
+require additional attention. The whole point of using a
+\textsc{Bib}\TeX-based system is for it to do the formatting for you,
+and in most cases \textsf{biblatex-chicago-authordate} does just that,
+surrounding titles with quotation marks, italicizing them, or
+occasionally just leaving them alone. When, however, a title is
+quoted within a title, then you need to know some of the rules. A
+summary here should serve to clarify them, and help you to understand
+when \textsf{biblatex-chicago-authordate} might need your help in
+order to comply with them.
-\mylittlespace The internal rules of \textsf{biblatex-chicago-notes}
-are as follows:
+\mylittlespace The internal rules of
+\textsf{biblatex-chicago-authordate} are as follows:
\begin{description}
\item[\qquad Italics:] \textsf{booktitle}, \textsf{maintitle}, and
@@ -7717,58 +7781,7 @@ retains them when the surrounding title is quoted or plain (14.104,
14.177; lewis). A word or phrase in quotation marks, but that isn't a
quotation, retains those marks in all title types (kimluu:diethyl).
-% \mylittlespace With regard to italics, the rules of
-% \textsf{biblatex-chicago-authordate} are as follows:
-
-% \begin{description}
-% \item[\qquad Italics:] \textsf{booktitle}, \textsf{maintitle}, and
-% \textsf{journaltitle} in all entry types; \textsf{title} of
-% \textsf{artwork}, \textsf{book}, \textsf{bookinbook},
-% \textsf{booklet}, \textsf{collection}, \textsf{inbook},
-% \textsf{manual}, \textsf{misc} (with no \textsf{entrysubtype}),
-% \textsf{periodical}, \textsf{proceedings}, \textsf{report},
-% \textsf{suppbook}, and \textsf{suppcollection} entry types.
-% \item[\qquad Main Text Font (Roman):] \textsf{title} of
-% \textsf{article}, \textsf{image}, \textsf{incollection},
-% \textsf{inproceedings}, \textsf{letter}, \textsf{misc} (with an
-% \textsf{entrysubtype}), \textsf{online}, \textsf{patent},
-% \textsf{periodical}, \textsf{suppperiodical}, \textsf{thesis}, and
-% \textsf{unpublished} entry types, \textsf{issuetitle} in
-% \textsf{article} and \textsf{periodical} entry types.
-% \textsf{booktitleaddon}, \textsf{maintitleaddon}, and
-% \textsf{titleaddon} in all entry types.
-% \item[\qquad Italics or Roman:] All of the audiovisual entry types ---
-% \textsf{audio}, \textsf{music}, and \textsf{video} --- have to serve
-% as analogues both to \textsf{book} and to \textsf{inbook}.
-% Therefore, if there is both a \textsf{title} and a
-% \textsf{booktitle}, then the \textsf{title} will be in the main text
-% font. If there is no \textsf{booktitle}, then the \textsf{title}
-% will be italicized.
-% \end{description}
-
-% \begin{enumerate}
-% \item Inside an italicized title, all other titles are enclosed in
-% quotation marks and italicized, so in such cases all you need to do
-% is provide the quotation marks using \cmd{mkbibquote}, which will
-% take care of any following punctuation that needs to be brought
-% within the closing quotation mark(s) (17.58; donne:var,
-% mchugh:wake).
-% \item Inside a plain-text title, you should present another title as
-% it would appear if it were on its own, so in such cases you'll need
-% to do the formatting yourself, using \cmd{mkbibemph} or
-% \cmd{mkbibquote}. (See 17.157; barcott:review, garrett, gibbard,
-% loften:hamlet, loomis:structure, murphy:silent, osborne:poi\-son,
-% ratliff:review, unsigned:ranke, white:callimachus.)
-% \end{enumerate}
-
-% The \emph{Manual} provides a few more rules, as well. A word normally
-% italicized in text should also be italicized in a plain-text title,
-% but should be in roman (\enquote{reverse italics}) in an italicized
-% title. A quotation used as a (whole) title (with or without a
-% subtitle) retains its quotation marks when it is plain, but loses them
-% when it is italicized (17.60, 17.157; lewis). A word or phrase in
-% quotation marks, but that isn't a quotation, retains those marks in
-% all title types (kimluu:diethyl).
+
\mylittlespace Finally, please note that in all \textsf{review} (and
\textsf{suppperiodical}) entries, and in \textsf{misc} entries with an
@@ -7781,6 +7794,149 @@ more details.
%\enlargethispage{\baselineskip}
+\mybigspace When \colmarginpar{\textbf{title (trad)}} you choose the
+new \mycolor{\textsf{authordate-trad}} style, your \textsf{title} and
+related fields will need extra care, familiar to users of the
+15th-edition author-date style. The whole point of using a
+\textsc{Bib}\TeX-based system is for it to do the formatting for you,
+and in most cases \mycolor{\textsf{biblatex-chicago-authordate-trad}}
+does just that, capitalizing them sentence-style, italicizing them,
+and sometimes both. There are two situations that require user
+intervention. First, in titles that take sentence-style
+capitalization, you need, as always in traditional \textsc{Bib}\TeX,
+to assist the algorithms by placing anything that needs to remain
+capitalized within an extra pair of curly braces. Second, when a
+title is quoted within a title, you need to know some of the rules of
+the Chicago style. A summary here should serve to clarify them, and
+help you to understand when
+\mycolor{\textsf{biblatex-chicago-authordate-trad}} might need your
+help in order to comply with them.
+
+\mylittlespace With regard to sentence-style capitalization, the rules
+of the Chicago \textsf{authordate-trad} style are fairly simple:
+
+\begin{description}
+\item[\qquad Headline Style:] \textsf{journaltitle} in all types,
+ \textsf{series} in all \textsf{book}-like entries (i.e., not in
+ \textsf{articles}), and \textsf{title} in \textsf{periodical}
+ entries.
+\item[\qquad Sentence Style:] every other \textsf{title},
+ \emph{except} in \textsf{letter} entries, \textsf{review} entries,
+ and in \textsf{misc} entries with an \textsf{entrysubtype}. Also,
+ the \textsf{booktitle}, \textsf{issuetitle}, and \textsf{maintitle}
+ in all entry types use sentence style.
+\item[\qquad Contextual Capitalization of First Word:]
+ \textsf{titleaddon}, \textsf{booktitleaddon},
+ \textsf{maintitleaddon} in all entry types, also the \textsf{title}
+ of \textsf{review} entries and of \textsf{misc} entries with an
+ \textsf{entrysubtype}.
+\item[\qquad Plain:] \textsf{title} in \textsf{letter} entries.
+\end{description}
+
+What this means in practice is that to get a title like \emph{The
+ Chicago manual of style}, your .bib entry needs to have a field that
+looks something like this:
+\begin{quote}
+ \texttt{title = \{The \{Chicago\} Manual of Style\}}
+\end{quote}
+
+This is completely straightforward, but remember that if an
+\textsf{article} has a title like: Review of \emph{The Chicago manual
+ of style}, then the curly braces enclosing material to be formatted
+in italics will cause the capitalization algorithm to stop and leave
+all of that material as it is, so your .bib entry would need to have a
+field something like this:
+
+\begin{quote}
+ \texttt{title = \{}\cmd{bibstring\{reviewof\}} \cmd{mkbibemph\{The
+ Chicago manual of style\}\}}
+\end{quote}
+
+(As an aside, the use of the \texttt{reviewof} bibstring isn't
+strictly necessary here, but it helps with portability across
+languages and across the two Chicago styles. If you've noticed a lot
+of lowercase letters starting fields in \textsf{dates-test.bib},
+they're present because in the notes \&\ bibliography style
+capitalization is complicated by notes using commas where the
+bibliography uses periods, and words like \enquote{review} start in
+uppercase only if the context demands it. There's considerably less
+of this in the author-date styles [note the \textsf{*titleaddon}
+fields], but it still pays to be aware of the issue.)
+
+\mylittlespace With regard to italics, the rules of
+\textsf{biblatex-chicago-authordate-trad} are as follows:
+
+\begin{description}
+\item[\qquad Italics:] \textsf{booktitle}, \textsf{maintitle}, and
+ \textsf{journaltitle} in all entry types; \textsf{title} of
+ \textsf{artwork}, \textsf{book}, \textsf{bookinbook},
+ \textsf{booklet}, \textsf{collection}, \textsf{inbook},
+ \textsf{manual}, \textsf{misc} (with no \textsf{entrysubtype}),
+ \textsf{periodical}, \textsf{proceedings}, \textsf{report},
+ \textsf{suppbook}, and \textsf{suppcollection} entry types.
+\item[\qquad Main Text Font (Roman):] \textsf{title} of
+ \textsf{article}, \textsf{image}, \textsf{incollection},
+ \textsf{inproceedings}, \textsf{letter}, \textsf{misc} (with an
+ \textsf{entrysubtype}), \textsf{online}, \textsf{patent},
+ \textsf{periodical}, \textsf{review}, \textsf{suppperiodical},
+ \textsf{thesis}, and \textsf{unpublished} entry types,
+ \textsf{issuetitle} in \textsf{article} and \textsf{periodical}
+ entry types. \textsf{booktitleaddon}, \textsf{maintitleaddon}, and
+ \textsf{titleaddon} in all entry types.
+\item[\qquad Italics or Roman:] All of the audiovisual entry types ---
+ \textsf{audio}, \textsf{music}, and \textsf{video} --- have to serve
+ as analogues both to \textsf{book} and to \textsf{inbook}.
+ Therefore, if there is both a \textsf{title} and a
+ \textsf{booktitle}, then the \textsf{title} will be in the main text
+ font. If there is no \textsf{booktitle}, then the \textsf{title}
+ will be italicized.
+\end{description}
+
+Now, the rules for which entry type to use for which sort of work tend
+to be fairly straightforward, but in cases of doubt you can consult
+section~\ref{sec:types:authdate} above, the examples in
+\textsf{dates-test.bib}, or go to the \emph{Manual} itself,
+8.154--195. Assuming, then, that you want to present a title within a
+title, and you know what sort of formatting each of the two would, on
+its own, require, then the following rules apply:
+
+\begin{enumerate}
+\item Inside an italicized title, all other titles are enclosed in
+ quotation marks and italicized, so in such cases all you need to do
+ is provide the quotation marks using \cmd{mkbibquote}, which will
+ take care of any following punctuation that needs to be brought
+ within the closing quotation mark(s) (14.102; donne:var,
+ mchugh:wake).
+\item Inside a plain-text title, you should set off other plain-text
+ titles with quotation marks, while italicized titles should appear
+ as they would if they were on their own. In such cases you'll need
+ to do the formatting yourself, using \cmd{mkbibemph} or
+ \cmd{mkbibquote}. (See barcott:review, garrett, gibbard,
+ loften:hamlet, loomis:structure, murphy:silent, osborne:poi\-son,
+ ratliff:review, unsigned:ranke, white:callimachus.)
+\end{enumerate}
+
+The \emph{Manual} provides a few more rules, as well. A word normally
+italicized in text should also be italicized in a plain-text title,
+but should be in roman (\enquote{reverse italics}) in an italicized
+title. A quotation used as a (whole) title (with or without a
+subtitle) retains its quotation marks when it is plain, but loses them
+when it is italicized, unless it specifically retains them in the
+source (14.104, 14.177; lewis). A word or phrase in quotation marks,
+but that isn't a quotation, retains those marks in all title types
+(kimluu:diethyl).
+
+\mylittlespace Finally, please note that there is also a preamble
+option --- \mycolor{\texttt{headline}} --- that disables the automatic
+sentence-style capitalization routines in \textsf{authordate-trad}.
+If you set this option, the word case in your title fields will not be
+changed in any way, that is, this doesn't automatically transform your
+titles into headline-style, but rather allows the .bib file to
+determine capitalization. It works by redefining the command
+\cmd{MakeSentenceCase}, so in the unlikely event you are using the
+latter anywhere in your document please be aware that it will also be
+turned off there. See section~\ref{sec:authuseropts}, below.
+
\mybigspace Standard \mymarginpar{\textbf{titleaddon}}
\textsf{biblatex} intends this field for use with additions to titles
that may need to be formatted differently from the titles themselves,
@@ -7837,7 +7993,7 @@ one of the \textsf{titleaddon} fields (ratliff:review). (Because the
strings identifying a translator differ in notes and bibliography, one
can't simply write them out in such a field when using the notes \&\
bibliography style, but you can certainly do so in the author-date
-style, if you wish. Using the macros will make your .bib file more
+styles, if you wish. Using the macros will make your .bib file more
portable across both Chicago specifications, and also across multiple
languages, but they are otherwise unnecessary. [See
section~\ref{sec:international}].)
@@ -7851,7 +8007,7 @@ translator's name, behavior that can be controlled with the
\textsf{author}, \textsf{editor}, \textsf{namea}, \textsf{nameb}, and
\textsf{namec}.
-% \enlargethispage{\baselineskip}
+\enlargethispage{\baselineskip}
\mybigspace This \mymarginpar{\textbf{type}} is a standard
\textsf{biblatex} field, and in its normal usage serves to identify
@@ -7911,7 +8067,7 @@ sirosh:visualcortex, wikiped:bibtex). In the default setting of
\textsf{urldate} to find a year for citations and the list of
references (grove:sibelius, wikiped:bibtex).
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mybigspace A \mymarginpar{\textbf{usera}} supplemental
\textsf{biblatex} field which functions in \textsf{biblatex-chicago}
@@ -8169,7 +8325,7 @@ though I have added the last, style-specific, one. If Lehman
generalizes it still further in a future release, I shall do the same,
if possible.
-%\enlargethispage{\baselineskip}
+\enlargethispage{-3\baselineskip}
\mybigspace This \mymarginpar{\textbf{\textbackslash mkbibquote}} is
the standard \textsf{biblatex} command, which requires attention here
@@ -8231,7 +8387,7 @@ the following 6 macros were all designed to help
the notes \&\ bibliography style differ between notes and
bibliography, the former sometimes using abbreviated forms when the
latter prints them in full. These problems do not arise in the
-author-date style, but using these macros will make your .bib database
+author-date styles, but using these macros will make your .bib database
more portable across languages and across both Chicago styles, and may
be slightly easier to remember than the strings themselves. On the
other hand, of course, they will make your .bib file less portable
@@ -8287,17 +8443,17 @@ compiler.
\label{sec:cite:authordate}
The \textsf{biblatex} package is particularly rich in citation
-commands, most of which, in \textsf{biblatex-chicago-authordate},
-function as they do in the standard author-date styles. If you are
-getting unexpected behavior when using them please have a look in your
-.log file. A command like \cmd{supercite}, listed in §~3.6.2 of the
-\textsf{biblatex} manual but not defined by
-\textsf{biblatex-chicago-authordate} or by core \textsf{biblatex},
-defaults to \cmd{cite}, and leaves a warning in the .log. The
-following commands may require some minimal explanation, but if there
-are standard commands that don't work for you, or new commands that
-would be useful, please let me know, and it should be possible to fix
-or add them.
+commands, most of which, in \textsf{biblatex-chicago-authordate} and
+\mycolor{\textsf{authordate-trad}}, function as they do in the
+standard author-date styles. If you are getting unexpected behavior
+when using them please have a look in your .log file. A command like
+\cmd{supercite}, listed in §~3.6.2 of the \textsf{biblatex} manual but
+not defined by \textsf{biblatex-chicago-authordate} or by core
+\textsf{biblatex}, defaults to \cmd{cite}, and leaves a warning in the
+.log. The following commands may require some minimal explanation,
+but if there are standard commands that don't work for you, or new
+commands that would be useful, please let me know, and it should be
+possible to fix or add them.
\mybigspace I \mymarginpar{\textbf{\textbackslash autocite}} haven't
adapted this in the slightest, but I thought it worth pointing out
@@ -8335,8 +8491,9 @@ you the \textsf{biblatex} defaults unless you redefine them yourself
inside the square brackets.
\mylittlespace \textsf{Biblatex-chicago-authordate}
-\mymarginpar{\texttt{autocite=\\inline}} places references in
-footnotes by default.
+\mymarginpar{\texttt{autocite=\\inline}} and
+\mycolor{\textsf{authordate-trad}} place references in parentheses by
+default.
\mybigspace The \mymarginpar{\texttt{citetracker=\\true}} citetracker
for the \cmd{ifciteseen} test is enabled globally.
@@ -8364,10 +8521,10 @@ ambiguity, \textsf{biblatex} should default to printing a more
informative reference.
\mylittlespace If you are going to repeat a source, make sure that the
-cite command provides a \textsf{postnote} --- if you don't need to cite a
-specific page, then it's better only to use one citation rather than
-two, as otherwise, in the current state of the code, you'll get empty
-parentheses, like so: ().
+cite command provides a postnote --- from this release of
+\textsf{biblatex-chicago} you'll no longer get any annoying empty
+parentheses, but you will get another standard citation, which may add
+too much clutter.
%\enlargethispage{\baselineskip}
@@ -8418,7 +8575,8 @@ which have more than three \textsf{authors}, but which differ
two such entries have the same \textsf{year} (15.28). The option is
\textsf{Biber}-only, like the following, which means that this
next-generation \textsc{Bib}\TeX\ replacement is required for the
-author-date style. Please see \textsf{cms-dates-sample.pdf} and
+author-date styles. Please see \textsf{cms-dates-sample.pdf} (or
+\mycolor{\textsf{cms-trad-sample.pdf}}) and
section~\ref{sec:otherhints:auth}, below, for further details.
\mylittlespace This \mymarginpar{\texttt{uniquename=\\minfull}}
@@ -8507,7 +8665,7 @@ year to which an alphabetical suffix will be appended when an author
has published more than one work in the same year.) In the default
configuration, a year will be searched for in the order \textsf{date,
eventdate, origdate, urldate}. This suits the Chicago author-date
-style very well, except for \textsf{music} and \textsf{video} entries,
+styles very well, except for \textsf{music} and \textsf{video} entries,
and, exceptionally, some \textsf{review} entries. Here the general
rule is to emphasize the earliest date. For these three entry types,
then, \cmd{DeclareLabelyear} uses the order \textsf{eventdate,
@@ -8558,12 +8716,20 @@ preamble, for the whole document, or on a per-entry basis in the
would make sense to eliminate the \textsf{pages} field from the
affected entries).
-\mylittlespace This \mymarginpar{\texttt{doi=true}} option controls
+\mylittlespace This \colmarginpar{\texttt{doi=true}} option controls
whether any \textsf{doi} fields present in the .bib file will be
-printed in the reference list. It defaults to true, and can be set to
-false either in the preamble, for the whole document, or on a
-per-entry basis, in the \textsf{options} field. In \textsf{online}
-entries, the \textsf{doi} field will always be printed.
+printed in the reference list. At the request of Daniel Possenriede,
+and keeping in mind the \emph{Manual's} preference for this field
+instead of a \textsf{url} (15.9), I have added a third switch,
+\mycolor{\texttt{only}}, which prints the \textsf{doi} if it is
+present and the \textsf{url} only if there is no \textsf{doi}. The
+package default remains the same, however --- it defaults to true,
+which will print both \textsf{doi} and \textsf{url} if both are
+present. The option can be set to \texttt{only} or to \texttt{false}
+either in the preamble, for the whole document, or on a per-entry
+basis in the \textsf{options} field. In \textsf{online} entries, the
+\textsf{doi} field will always be printed, but the \texttt{only}
+switch will still eliminate any \textsf{url}.
\mylittlespace This \colmarginpar{\texttt{eprint=true}} option controls
whether any \textsf{eprint} fields present in the .bib file will be
@@ -8723,6 +8889,19 @@ section~\ref{sec:loading:auth}, below.
\enlargethispage{\baselineskip}
+\mylittlespace Several \colmarginpar{\texttt{headline}\\\texttt{(trad
+ only)}} users requested an option that turned off the automatic
+transformations that produce sentence-style capitalization in the
+title fields of the 15th-edition author-date style. I have,
+therefore, also included it in \mycolor{\textsf{authordate-trad}}. If
+you set this option, the word case in your title fields will not be
+changed in any way, that is, this doesn't automatically transform your
+titles into headline-style, but rather allows the .bib file to
+determine capitalization. It works by redefining the command
+\cmd{MakeSentenceCase}, so in the unlikely event you are using the
+latter anywhere in your document please be aware that it will also be
+turned off there.
+
\mylittlespace The \mymarginpar{\texttt{juniorcomma}} \emph{Manual}
(6.47) states that \enquote{commas are not required around \emph{Jr.}\
and \emph{Sr.},} so by default \textsf{biblatex-chicago} has
@@ -8878,13 +9057,14 @@ for testing purposes.
\subsection{General Usage Hints}
\label{sec:hints:auth}
-\subsubsection{Loading the Style}
+\subsubsection{Loading the Styles}
\label{sec:loading:auth}
-With the addition of the author-date style to the package, I have
-provided two keys for choosing which style to load, \texttt{notes} and
-\texttt{authordate}, one of which you put in the options to the
-\cmd{usepackage} command. With early versions of
+With the addition of the \mycolor{\textsf{authordate-trad}} style to
+the package, there are now three keys for choosing which style to
+load, \texttt{notes}, \texttt{authordate}, and
+\mycolor{\textsf{authordate-trad}}, one of which you put in the
+options to the \cmd{usepackage} command. With early versions of
\textsf{biblatex-chicago}, the standard way of loading the package was
via a call to \textsf{biblatex}, e.g.:
\begin{quote}
@@ -8919,12 +9099,12 @@ then you may want to revert to the old style of invocation above.
You'll lose all the definitions in \textsf{biblatex-chicago.sty},
including those to which I've already alluded and also the code that
sets the note number in-line rather than superscript in endnotes or
-footnotes. Also in this file is the code that calls
-\textsf{cms-american.lbx}, which means that you'll lose all the
+footnotes. Also in this file is the code that calls all of the
+package's localization files, which means that you'll lose all the
Chicago-specific bibstrings I've defined unless you provide, in your
-preamble, a \cmd{DeclareLanguageMapping} command adapted for your
-setup, on which see section~\ref{sec:international} below and also
-§§~4.9.1 and 4.11.7 in Lehman's \textsf{biblatex.pdf}.
+preamble, a \cmd{DeclareLanguageMapping} command, or several, adapted
+for your setup, on which see section~\ref{sec:international} below and
+also §§~4.9.1 and 4.11.7 in Lehman's \textsf{biblatex.pdf}.
\mylittlespace What you \emph{will not} lose is the ability to call
the package options \texttt{annotation, strict, cmslos=false} and
@@ -9005,7 +9185,7 @@ reevaluate how much information you're providing. I've tried to make
data-rich citations, but there may be instances where you can save
yourself some typing by keeping it simple.
-%\enlargethispage{\baselineskip}
+\enlargethispage{\baselineskip}
\mylittlespace Scot Becker has pointed out to me that the inverse
problem not only exists but may well become increasingly common, to
@@ -9027,29 +9207,39 @@ in \textsf{biblatex.pdf}, to wit, if you aren't going to use
\textsc{Bib}\TeX, and avoid the cryptic errors that ensue when your
.bib file gets to a certain size.
-\section{Internationalization}
+\section{\mycolor{Internationalization}}
\label{sec:international}
Several users have requested that, in line with analogous provisions
in other \enquote{American} \textsf{biblatex} styles (e.g.,
\textsf{biblatex-apa} and \textsf{biblatex-mla}), I include facilities
for producing a Chicago-like style in other languages. I have
-supplied three new lbx files, \textsf{cms-german.lbx}, its clone
+supplied three lbx files, \textsf{cms-german.lbx}, its clone
\textsf{cms-ngerman.lbx}, and \textsf{cms-french.lbx}, in at least
-partial fulfillment of this request. This means that all of the
+partial fulfillment of this request. For this release, Baldur
+Kristinsson has very kindly provided
+\mycolor{\textsf{cms-icelandic.lbx}} for speakers of that language,
+while Håkon Malmedal has equally kindly provided
+\mycolor{\textsf{cms-norsk.lbx}},
+\mycolor{\textsf{cms-norwegian.lbx}}, and
+\mycolor{\textsf{cms-nynorsk.lbx}}. I have added
+\mycolor{\textsf{cms-british.lbx}} in order to simplify and to improve
+the package's handling of non-American typographical conventions in
+English. This means that all --- or at least most --- of the
Chicago-specific bibstrings are now available for documents and
-reference apparatuses written in French and German, with, as I intend,
+reference apparatuses written in these languages, with, as I intend,
more languages to follow, limited mainly by my finite time and
even-more-finite competence. (If you would like to provide bibstrings
for a language in which you want to work, or indeed correct
-deficiencies in the lbx files I have prepared, please contact me.)
-
-\mylittlespace Using \mymarginpar{\textbf{babel}} these new facilities
-is fairly simple. By default, and this functionality remains the same
-as it was in the previous release of \textsf{biblatex-chicago}, calls
-to \cmd{DeclareLanguage\-Mapping} in \textsf{biblatex-chicago.sty}
-will automatically load the American strings, and also
-\textsf{biblatex's} American-style punctuation tracking, when you:
+deficiencies in the lbx files contained in the package, please contact
+me.)
+
+\mylittlespace Using \mymarginpar{\textbf{babel}} these facilities is
+fairly simple. By default, and this functionality remains the same as
+it was in the previous release of \textsf{biblatex-chicago}, calls to
+\cmd{DeclareLanguage\-Mapping} in \textsf{biblatex-chicago.sty} will
+automatically load the American strings, and also \textsf{biblatex's}
+American-style punctuation tracking, when you:
\begin{enumerate}
\item Load \textsf{babel} with \texttt{american} as the main text
language.
@@ -9063,28 +9253,22 @@ will automatically load the American strings, and also
an American citation style, to expect this arrangement to work well
for the majority of users.)
-\mylittlespace If, for whatever reason, you wanted to use
-\textsf{biblatex-chicago} but retain British typographical conventions
---- punctuation outside of quotation marks, outer quotes single rather
-than double, etc.\ --- then one possible solution at least would be to
-follow these three steps:
-\begin{enumerate}
-\item Load \textsf{babel} with the \texttt{british} option.
-\item Put \cmd{DeclareLanguageMapping\{british\}\{cms-american\}} in
- your preamble.
-\item Edit \textsf{cms-american.lbx} so that the line reading:\\
- \cmd{InheritBibliographyExtras\{american\}}\\ instead reads:\\
- \cmd{InheritBibliographyExtras\{british\}}.
-\end{enumerate}
-
-If you want to use French or German strings in the reference
-apparatus, then you can load \textsf{babel} with \texttt{german} or
-\texttt{french} as the main document language. You no longer need
-\cmd{DeclareLanguageMapping\{german\}\{cms-german\}} or
-\cmd{Declare\-LanguageMapping\{french\}\{cms-french\}} in your
-document preamble, since \textsf{bib\-latex-chicago.sty} now
-automatically provides this if you load the package in the standard
-way.
+\mylittlespace If, \colmarginpar{New!} for whatever reason, you wanted
+to use \textsf{biblatex-chicago} but retain British typographical
+conventions --- punctuation outside of quotation marks, outer quotes
+single rather than double, etc.\ --- then you no longer need to follow
+the complicated rules outlined in previous releases of
+\textsf{biblatex-chicago}. Instead, simply load \textsf{babel} with
+the \texttt{british} option.
+
+\mylittlespace If you want to use French, German, Icelandic, or
+Norwegian strings in the reference apparatus, then you can load
+\textsf{babel} with \texttt{french}, \texttt{german},
+\texttt{icelandic}, \texttt{ngerman}, \texttt{norsk}, or
+\texttt{nynorsk} as the main document language. You no longer need
+any calls to \cmd{DeclareLanguageMapping} in your document preamble,
+since \textsf{bib\-latex-chicago.sty} now automatically provides these
+if you load the package in the standard way.
\mylittlespace You can also define which bibstrings to use on an
entry-by-entry basis by using the \textsf{hyphenation} field in your
@@ -9098,11 +9282,12 @@ preamble, as \textsf{biblatex-chicago.sty} won't load it for you.
\mylittlespace Three other hints may be in order here. Please note,
first, that I haven't altered the standard punctuation procedures used
-in German or French, so commas and full stops will appear outside of
-quotation marks, and those quotation marks themselves will be
-language-specific. If, for whatever reason, you wish to follow the
-Chicago specification and move punctuation inside quotation marks,
-then you'll need a declaration of this sort in your preamble:
+in any of the other available languages, so commas and full stops will
+appear outside of quotation marks, and those quotation marks
+themselves will be language-specific. If, for whatever reason, you
+wish to follow the Chicago specification and move punctuation inside
+quotation marks, then you'll need a declaration of this sort in your
+preamble:
\begin{quote}
\cmd{DefineBibliographyExtras\{german\}\{\%}\\
@@ -9130,9 +9315,11 @@ esp.\ s.v.\ \enquote{\cmd{partedit}.}
\mylittlespace Finally, the French and German bibstrings I have
provided may well break with established bibliographical traditions in
those languages, but my main concern when choosing them was to remain
-as close as possible to the quirks of the Chicago specification. If
-you have strong objections to any of the strings, or indeed to any of
-my formatting decisions, please let me know.
+as close as possible to the quirks of the Chicago specification. I
+have entirely relied on the judgment of the creators of the Icelandic
+and Norwegian localizations in those instances. If you have strong
+objections to any of the strings, or indeed to any of my formatting
+decisions, please let me know.
\section{One .bib Database, Two Chicago Styles}
\label{sec:twostyles}
@@ -9157,11 +9344,15 @@ This is, I believe, the simpler conversion, as most well-constructed
nonetheless:
\begin{enumerate}
-\item \textbf{NB: The formatting of titles in the two styles is now
- the same, which means you no longer need to worry about extra
- curly brackets and their affects on capitalization.}
+\item \mycolor{\textbf{NB:}} Unless you are using
+ \mycolor{\textsf{authordate-trad}}, the formatting of titles in the
+ two styles is now the same, which means you would no longer need to
+ worry about extra curly brackets and their affects on
+ capitalization. If you are using \textsf{authordate-trad}, please
+ see the caveats in the documentation of the \textsf{title} field in
+ section~\ref{sec:fields:authdate}, above.
\item You may need to reevaluate your use of shorthands, given that by
- default the author-date style uses them in place of authors rather
+ default the author-date styles use them in place of authors rather
than in place of the whole citation. The preamble option
\textsf{cmslos=false} may help, but this may leave your document
out-of-spec.
@@ -9265,14 +9456,16 @@ package.
\section{TODO \&\ Known Bugs}
\label{sec:bugs}
-This release now, belatedly, implements the 16th edition of the
-\emph{Chicago Manual of Style}. The next release will also contain a
-version of the author-date style with traditional title formatting
-alongside the current code which unifies the treatment of titles
-across the two styles. I hope that, in time, users will migrate to
-the most recent specification, so that I can focus my development
-there. If you still have feature requests for the older
-specification, I'll do what I can to include them.
+This release implements the 16th edition of the \emph{Chicago Manual
+ of Style}. It now also contains a version of the author-date style
+(\mycolor{\textsf{authordate-trad}}) with traditional title
+formatting, alongside the \textsf{authordate} code which unifies the
+treatment of titles between itself and the notes \&\ bibliography
+style. I hope that users will migrate to one of these styles
+implementing the most recent specification, so that I can focus my
+development and testing there. For the moment, I shall call the
+15th-edition styles \enquote{mildly deprecated,} but if you still have
+urgent feature requests for them, I'll do what I can.
\mylittlespace Regardless of which edition you are considering, there
are a number of things I haven't implemented. The solution in
@@ -9297,14 +9490,6 @@ it seems to me that the available entry types could be pressed into
service to address the vast majority of them. If this optimism proves
misguided, please let me know.
-\mylittlespace I am very grateful to Baldur Kristinsson for sending a
-Chicago-specific Icelandic localization file
-(\textsf{cms-icelandic.lbx}). This requires the file
-\textsf{icelandic.lbx}, which will be part of version 2.0 of
-\textsf{biblatex}. I shall incorporate the localization in the next
-release, when I expect the newest \textsf{biblatex} will have
-appeared.
-
\mylittlespace Kenneth L. Pearce has reported a bug that appears when
using multiple citation commands inside the \textsf{annotation} field
of annotated bibliographies. As late as I am with the file for the
@@ -9342,6 +9527,15 @@ above, but it's possible the package may need some changes to cope
with all the permutations. Please let me know if you find something
that looks like a bug.
+\mylittlespace Roger Hart, Pierric Sans, and a number of other users
+have reported a bug in the formatting of title fields. This, as far
+as I can tell, has to do with the interaction between
+\cmd{MakeSentenceCase} and certain characters at the start of the
+title, particularly Unicode ones. If you are using
+\mycolor{\textsf{authordate-trad}}, it may help for the moment to put
+an empty set of curly braces \{\}\ at the start of the field, but I
+shall look into this further.
+
\mylittlespace Recent versions of \textsf{biblatex} have introduced
some new entry types for citing multi-volume works. These are largely
aimed at those already using \textsf{Biber}, which provides
@@ -9359,7 +9553,7 @@ provide this in the next release. He has also requested, despite the
\texttt{Idem} and \texttt{Ibid.}\ in notes. I shall look into this
for the next release.
-\enlargethispage{-5\baselineskip}
+\enlargethispage{\baselineskip}
\mylittlespace This release fixes the formatting errors of which I am
aware, though users writing in French should be aware of problems with
@@ -9383,7 +9577,65 @@ code for it, let me know, and I'll look into it.
\section{Revision History}
\label{sec:history}
-\textbf{0.9.9a: Released \today}
+\textbf{0.9.9b: Released \today}
+\begin{itemize}
+\item This \label{deprec:obsol} release contains a new variant of the
+ author-date style, available as the
+ \mycolor{\texttt{authordate-trad}} option when loading
+ \textsf{biblatex-chicago}. This provides the traditional, plain,
+ pre-16th-edition Chicago title handling --- sentence-style
+ capitalization, absence of quotation marks in \textsf{article}
+ titles and the like --- but in all other respects follows the
+ 16th-edition specification, as suggested by the \emph{Manual}
+ (15.45). Remember that the \texttt{headline} package option can be
+ used to turn off the automatic sentence-style capitalization,
+ meaning that titles will appear as presented in the .bib file, at
+ least as far as capitalization is concerned. Please see especially
+ the documentation of \textsf{\textbf{title}} in
+ section~\ref{sec:fields:authdate}, above, for the details.
+\item I have updated calls to \cmd{DeclareLabelname} and
+ \cmd{DeclareLabelyear} in several .cbx files so that the package
+ works correctly with the most recent version (2.4) of
+ \textsf{biblatex}.
+\item Following a request by Norman Gray, I have included a
+ \cmd{textcite} (and a \cmd{textcites}) command in the notes \&\
+ bibliography style for the first time. Please see
+ section~\ref{sec:citecommands}, above, for the details.
+\item Following a request by Daniel Possenriede, I have added in all
+ three 16th-edition styles a new switch, \mycolor{\texttt{only}}, to
+ the \texttt{doi} option, which prints the \textsf{doi} when present
+ and the \textsf{url} only when there is no \textsf{doi}. The
+ package default remains, however, \texttt{true}.
+\item I am grateful to Baldur Kristinsson for providing an Icelandic
+ localization file for \textsf{biblatex-chicago}, called
+ \mycolor{\textsf{cms-icelandic.lbx}}. You'll see if you look
+ through it that it is still something of a work in progress, but it
+ should cover most needs in that language very well. If you would
+ like to fill in some of the gaps please let me know.
+\item I am also grateful to Håkon Malmedal for providing Norwegian
+ localizations for \textsf{biblatex-chicago}, contained in the files
+ \mycolor{\textsf{cms-norsk.lbx}},
+ \mycolor{\textsf{cms-norwe\-gian.lbx}}, and
+ \mycolor{\textsf{cms-nynorsk.lbx}}.
+\item I have added a new British localization
+ (\mycolor{\textsf{cms-british.lbx}}) that should make it much
+ simpler for users to produce documents adhering to that tradition.
+ For further details on the usage of all these localizations please
+ see section~\ref{sec:international}, above.
+\item Several users have reported a bug that resulted in doubled
+ bibstrings in certain contexts. This happened only when using
+ localizations for which \textsf{biblatex-chicago} didn't have
+ explicit support, and it should now be fixed.
+\item I have changed the way the 16th-edition author-date styles
+ handle the \emph{Ibidem} mechanism. In the absence of a
+ \textsf{postnote} field you no longer get empty parentheses, but
+ rather a standard in-text citation. If you do have a
+ \textsf{postnote} field, then only that will appear.
+\end{itemize}
+
+\enlargethispage{-2\baselineskip}
+
+\textbf{0.9.9a: Released July 30, 2012}
\begin{itemize}
\item I have made a few changes to \textsf{biblatex-chicago.sty} to
allow the package to work with the latest version (2.0) of
@@ -9395,8 +9647,8 @@ code for it, let me know, and I'll look into it.
\textbf{0.9.9: Released July 5, 2012}
-\mylittlespace \label{deprec:obsol} Converting 15th-Edition .bib Files
-to Use the 16th Edition:
+\mylittlespace Converting 15th-Edition .bib Files to Use the 16th
+Edition:
\mylittlespace \textbf{Notes and Bibliography Style}
@@ -9432,7 +9684,7 @@ to Use the 16th Edition:
\item In \textbf{suppbook} entries, the \emph{Manual} now requires you
to provide the page range (in the \textsf{pages} field) for the
specific part you are citing, e.g., an introduction, foreword, or
- afterword.
+ afterword.\enlargethispage{-2\baselineskip}
\item In \textbf{patent} entries, the \emph{Manual} now prefers
sentence-style capitalization for titles, which you'll need to
provide yourself by hand.