diff options
author | Karl Berry <karl@freefriends.org> | 2012-12-08 17:16:40 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-12-08 17:16:40 +0000 |
commit | d5550a5b1dfc527de0b394ca1af3dff46548c6e3 (patch) | |
tree | c75e4296b600e2d2effb0dd168a9c3e6aacf229d /Master/texmf-dist/doc/latex/biblatex-chicago | |
parent | d70e4e2f7daa386b9f77c0ff1d5a61b0c2c4b7f3 (diff) |
biblatex-chicago (6dec12)
git-svn-id: svn://tug.org/texlive/trunk@28472 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chicago')
16 files changed, 1533 insertions, 614 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/README b/Master/texmf-dist/doc/latex/biblatex-chicago/README index 455231567f7..16edb477aee 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/README +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/README @@ -1,19 +1,19 @@ IMPORTANT NOTE: This is the package formerly known as biblatex-chicago-notes-df. It -has now been upgraded to work with version 2.0 of biblatex, which has +has now been upgraded to work with version 2.4 of biblatex, which has recently been released. It contains, for the first time, both the 15th- and 16th-edition Chicago style files. If you have used the package before, then you should be sure to consult the RELEASE file to find out what alterations you may need to make to your .bib files and document preambles to bring them up to date. Most particularly please -note that Biber is now required for the author-date style (version 1.0 +note that Biber is now required for the author-date style (version 1.4 if you are using the latest biblatex, 0.9.8 or 0.9.9 if you are still using biblatex 1.7). -README (version 0.9.9a, 2012-07-30): +README (version 0.9.9b, 2012-12-06): -Biblatex-chicago contains four biblatex styles implementing the +Biblatex-chicago contains five biblatex styles implementing the specifications of the Chicago Manual of Style in both its 15th and 16th editions. The "notes & bibliography" style was formerly available in the package biblatex-chicago-notes-df, and is intended @@ -27,13 +27,14 @@ of the Manual has brought the presentation of sources in this style much more into line with the notes & bibliography specification, especially regarding the formatting of titles. If you still require titles to be capitalized sentence style, and article titles, for -example, not to be enclosed in quotation marks, then you may wish to -continue using the 15th-edition files until I have provided, in the -next release, these features as an option to the 16th-edition style. -Other users should upgrade to the most recent specification. To -continue using the 15th-edition files, you'll need to specify -"notes15" or "authordate15" in the options when loading -biblatex-chicago. +example, not to be enclosed in quotation marks, then you may now use +the new, traditional author-date style ("authordate-trad"), which +provides these features while in all other respects following the +16th-edition specifications. I encourage all users to upgrade to one +of these three up-to-date styles, which should now cater to nearly all +needs. If you with to continue using the 15th-edition files, you'll +need to specify "notes15" or "authordate15" in the options when +loading biblatex-chicago. This is a beta release, but its feature set is already fairly extensive. If you have used the package before you may, after @@ -49,10 +50,10 @@ reference guide to both notes & bibliography and author-date styles demonstrating how to present a wide range of sources, nearly all of them taken from the Chicago Manual of Style itself, so that you can compare the output of your system (cms-notes-sample.tex, -cms-dates-sample.tex, cms15-notes-sample.tex, cms15-dates-sample.tex) -or my system (cms-notes-sample.pdf, cms-dates-sample.pdf, -cms15-notes-sample.pdf, cms15-dates-sample.pdf) with the actual -examples in the Manual. +cms-dates-sample.tex, cms-trad-sample.tex, cms15-notes-sample.tex, +cms15-dates-sample.tex) or my system (cms-notes-sample.pdf, +cms-dates-sample.pdf, cms-trad-sample.pdf, cms15-notes-sample.pdf, +cms15-dates-sample.pdf) with the actual examples in the Manual. I have, wherever possible, attempted to maintain backward compatibility with the standard biblatex styles, but there are a @@ -80,14 +81,16 @@ in your TeX directory tree instead of in your working directory, I recommend the following, which should be familiar from the main biblatex package: - - The thirteen files biblatex-chicago.sty, chicago-notes.cbx, + - The twenty files biblatex-chicago.sty, chicago-notes.cbx, chicago-notes.bbx, chicago-authordate.cbx, chicago-authordate.bbx, + chicago-authordate-trad.cbx, chicago-authordate-trad.bbx, chicago-notes15.cbx, chicago-notes15.bbx, chicago-authordate15.cbx, - chicago-authordate15.bbx, cms-american.lbx, cms-french.lbx, - cms-german.lbx, and cms-ngerman.lbx are located in the latex/ - subdirectory, itself further subdivided into bbx/, cbx/, and lbx/. - The entire contents of this latex/ directory, including its - subdirectories, can go in + chicago-authordate15.bbx, cms-american.lbx, cms-british.lbx, + cms-french.lbx, cms-german.lbx, cms-icelandic.lbx, cms-ngerman.lbx, + cms-norsk.lbx, cms-norwegian.lbx, and cms-nynorsk.lbx are located + in the latex/ subdirectory, itself further subdivided into bbx/, + cbx/, and lbx/. The entire contents of this latex/ directory, + including its subdirectories, can go in <TEXMFLOCAL>/tex/latex/biblatex-contrib/biblatex-chicago, where <TEXMFLOCAL> is the root of your local TeX installation -- for example, and depending on your system, /usr/share/texmf-local, @@ -96,14 +99,15 @@ biblatex package: remember to update your TeX file name database so that TeX can find them. - - The fourteen files biblatex-chicago.tex, biblatex-chicago.pdf, + - The sixteen files biblatex-chicago.tex, biblatex-chicago.pdf, biblatex-chicago15.tex, biblatex-chicago15.pdf - cms-notes-sample.tex, cms-dates-sample.tex, cms-notes-sample.pdf, - cms-dates.sample.pdf, cms15-notes-sample.tex, - cms15-dates-sample.tex, cms15-notes-sample.pdf, - cms15-dates.sample.pdf, notes-test.bib, and dates-test.bib can all - be found in the doc/ directory in the package archive, the last 10 - in the examples/ subdirectory. You can place all of this in + cms-notes-sample.tex, cms-dates-sample.tex, cms-trad-sample.tex, + cms-notes-sample.pdf, cms-dates.sample.pdf, cms-trad-sample.pdf, + cms15-notes-sample.tex, cms15-dates-sample.tex, + cms15-notes-sample.pdf, cms15-dates.sample.pdf, notes-test.bib, and + dates-test.bib can all be found in the doc/ directory in the + package archive, the last 10 in the examples/ subdirectory. You + can place all of this in <TEXMFLOCAL>/doc/latex/biblatex-contrib/biblatex-chicago. diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE b/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE index d31c2cf1770..47c547c7e35 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/RELEASE @@ -1,3 +1,59 @@ +Release notes for version 0.9.9b [2012-12-06]: + + - This release contains a new variant of the author-date style, + available as the "authordate-trad" option when loading + biblatex-chicago. This provides the traditional, plain, + pre-16th-edition Chicago title handling -- sentence-style + capitalization, absence of quotation marks in Article titles and + the like -- but in all other respects follows the 16th-edition + specification, as suggested by the Manual (15.45). Remember that + the "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 under "title" + in section 5.2 of biblatex-chicago.pdf for the details. + + - I have updated calls to \DeclareLabelname and \DeclareLabelyear in + several .cbx files so that the package works correctly with the + most recent version (2.4) of biblatex. + + - Following a request by Norman Gray, and adapting code by Audrey + Boruvka, I have included a \textcite (and a \textcites) command in + the notes & bibliography style for the first time. + + - Following a request by Daniel Possenriede, I have added in all + three 16th-edition styles a new switch, "only", to the "doi" + option, which prints the "doi" field when present and the "url" + field only when there is no "doi." The package default remains, + however, "true". + + - I am grateful to Baldur Kristinsson for providing an Icelandic + localization file for biblatex-chicago, called 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. + + - I am also grateful to Håkon Malmedal for providing Norwegian + localizations for biblatex-chicago, contained in the files + cms-norsk.lbx, cms-norwegian.lbx, and cms-nynorsk.lbx. + + - I have added a new British localization, cms-british.lbx. The + "british" option to babel should now work without further + intervention. For further details on the usage of all these + localizations please see section 6 of biblatex-chicago.pdf. + + - Several users have reported a bug that resulted in doubled + bibstrings in certain contexts. This happened only when using + localizations for which biblatex-chicago didn't have explicit + support, and it should now be fixed. + + - I have changed the way the 16th-edition author-date styles handle + the Ibidem mechanism. In the absence of a "postnote" field you no + longer get empty parentheses, but rather a standard in-text + citation. If you do have a "postnote" field, then only that will + appear. + Release notes for version 0.9.9a [2012-07-30]: - I have made a few changes to biblatex-chicago.sty to allow the diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.pdf Binary files differindex aa0e0f063a9..49826af7f1d 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.pdf 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. diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago15.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago15.pdf Binary files differindex 0c1af80fdfd..c468b340aea 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago15.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago15.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago15.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago15.tex index 7cf79353965..8e4ece31ecd 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago15.tex +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago15.tex @@ -56,7 +56,7 @@ 15th-edition 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,31 +73,30 @@ \textbf{This file documents the \textsf{biblatex} style files implementing the 15th edition of \emph{The Chicago Manual of Style}. This edition has been superseded by the 16th edition, documented in - \textsf{biblatex-chicago.pdf}. There will no doubt be many users, + \textsf{biblatex-chicago.pdf}. There may still be some users, however, who wish to continue using the 15th-edition styles, so I - shall, at least for the moment, carry on maintaining them. Reasons - to continue using these files may include, but are not limited to: - \begin{itemize} - \item A desire not to interrupt a work-in-progress. - \item A desire, sanctioned by the 16th edition itself, to continue - using an author-date style with the traditional sentence-style - capitalization (and absence of quotation marks) in titles. - \end{itemize} - I have not backported all improvements to the notes \&\ bibliography - style, as the 16th-edition specification represents in itself an - incremental upgrade which I encourage users of this style to adopt - in their own time. The author-date style is more complicated. I - have backported as many improvements as I can, and documented them - here, but it still isn't an implementation of the 16th-edition style - with 15th-edition title formatting, as envisaged by the 16th edition - itself. I intend to move the style in that direction in the future, - however, its current state, then, representing something of a - compromise aimed at creating the least disturbance for current users - in the middle of significant projects. \mylittlespace \\ The - package remains beta software. If it seems like it could be of use - to you, yet it doesn't do something you need/want it to do, please - feel free to let me know, and of course any suggestions for solving - problems more elegantly or accurately would be most welcome.} + shall, at least for the moment, carry on maintaining them, though I + am marking them as \enquote{mildly deprecated.} The main reason to + continue using these files is perhaps a desire not to interrupt a + work-in-progress. If you wish to use an author-date style with the + traditional sentence-style capitalization (and absence of quotation + marks) in titles, the new \mycolor{\textsf{authordate-trad}} style + provides this while in all other respects adhering to the + 16th-edition specification.\mylittlespace \\ I have not backported + all improvements to the notes \&\ bibliography style, as the + 16th-edition specification represents in itself an incremental + upgrade which I encourage users of this style to adopt in their own + time. The author-date style is more complicated. I have backported + as many improvements as I can, and documented them here, but it + still isn't an implementation of the 16th-edition style with + 15th-edition title formatting, as provided by + \mycolor{\textsf{authordate-trad}}. I encourage all author-date + users, therefore, to adopt one of the newer styles in their own + time. \mylittlespace \\ The package remains beta software. If it + seems like it could be of use to you, yet it doesn't do something + you need/want it to do, please feel free to let me know, and of + course any suggestions for solving problems more elegantly or + accurately would be most welcome.} \mylittlespace\textbf{Important Note:} If you have used \textsf{biblatex-chicago} before, please make sure you have read the @@ -144,7 +143,7 @@ release. \begin{itemize}{}{} \item Philipp Lehman's \textsf{biblatex} package, of course! You - should use the latest version(s) --- 1.7 or 2.0 --- as those + should use the latest version(s) --- 1.7 or 2.4 --- 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 tools require @@ -169,8 +168,8 @@ release. following: \item \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} 2.0, or 0.9.9 with \textsf{biblatex} 1.7, and it + SourceForge. You should use the latest version, 1.4, to work with + \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 style or processing a .bib file in Unicode. See \textsf{cms-dates-sample.pdf} for more details. @@ -319,13 +318,15 @@ 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 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 @@ -451,6 +452,8 @@ affairs which does sometimes occur. I have provided \textsf{notes-test.bib}, and I have also included the reference keys from the latter file below in parentheses. +%\enlargethispage{\baselineskip} + \subsection{Entry Types} \label{sec:entrytypes} @@ -589,7 +592,7 @@ than by \textsf{title}. The provision of a \textsf{shortauthor} field is no longer necessary, as in its absence the package automatically takes it from \textsf{journaltitle}. (See lakeforester:pushcarts.) -%\enlargethispage{-\baselineskip} +\enlargethispage{\baselineskip} \mylittlespace Fourth, if you've been using \textsf{biblatex-chicago-notes} for a while, you may remember using @@ -641,7 +644,7 @@ type would be the best place for it. (8.196, 17.207; see bundy:macneil for an example of how this all might look in a .bib file.) -\enlargethispage{\baselineskip} +%\enlargethispage{\baselineskip} \mylittlespace If you're still with me, allow me to recommend that you browse through \textsf{notes-test.bib} to get a feel for just how many @@ -724,7 +727,7 @@ elsewhere these sorts of material are presented as \textsf{music} and sorts of publication facts you wish to present --- cf.\ \emph{Manual} 17.269. -%\enlargethispage{-\baselineskip} +%\enlargethispage{\baselineskip} \mylittlespace Once you've accepted the analogy of composer to \textsf{author}, constructing an \textsf{audio} entry should be fairly @@ -1127,7 +1130,7 @@ automatic capitalization mechanism in the \textsf{title} field of below. (See 17.205-206, 17.220, 17.222-232; creel:house, dinkel:agassiz, spock:interview.) -\enlargethispage{-\baselineskip} +\enlargethispage{\baselineskip} \mylittlespace As in \textsf{letter} entries, the titles of unpublished letters are of the form \texttt{Author to Recipient}, and @@ -1261,6 +1264,8 @@ to why I'm wrong will, of course, be entertained. (Cf. 17.268; auden:reading, beethoven:sonata29, bernstein:shostakovich, nytrumpet:art:15.) +\enlargethispage{\baselineskip} + \mybigspace The \mymarginpar{\textbf{online}} \emph{Manual}'s instructions (17.142--147, 17.198, 17.234--237) for citing online materials are slightly different from those suggested by standard @@ -1291,8 +1296,6 @@ title should go in \textsf{titleaddon}, not forgetting to begin that field with a lowercase letter so that capitalization will work out correctly. -%\enlargethispage{\baselineskip} - \mybigspace The \mymarginpar{\textbf{patent}} \emph{Manual} is very brief on this subject (17.219), but very clear about which information it wants you to present, so such entries may not work well with other @@ -1802,7 +1805,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 @@ -1882,7 +1885,7 @@ entry type, if you don't use \textsf{collection} or name, so there may be corner cases where careful choice of the parent entry type gets you what you want. -% \enlargethispage{\baselineskip} +%\enlargethispage{-\baselineskip} \mylittlespace A published collection of letters requires a somewhat different treatment (17.78). If you cite more than one letter from @@ -1962,6 +1965,8 @@ making the conversion, though I'm retaining the right to revoke this if the code in question demonstrably interferes with the functioning of the notes \&\ bibliography style.) +\enlargethispage{\baselineskip} + \mybigspace This \mymarginpar{\textbf{day}} field, as of \textsf{biblatex} 0.9, is obsolete, and will be ignored if you use it in your .bib files. Use \textsf{date} instead. @@ -2039,7 +2044,7 @@ performers. To specify the role, use the fields \textsf{editoratype}, \textsf{editorbtype}, and \textsf{editorctype}, which see. (Cf.\ bernstein:shostakovich, handel:messiah.) -%\enlargethispage{-\baselineskip} +%\enlargethispage{\baselineskip} \mybigspace Normally, \mymarginpar{\textbf{editortype}} with the exception of the \textsf{article} and \textsf{review} types, @@ -2138,6 +2143,8 @@ to put the exact string \texttt{magazine} into the types of source, whereas if your source is a \enquote{journal,} then you need do nothing. +\enlargethispage{\baselineskip} + \mylittlespace The second use involves references to works from classical antiquity and, according to the \emph{Manual}, from the Middle Ages, as well. When you cite such a work using the traditional @@ -2198,7 +2205,7 @@ from the \textsf{author}. The \emph{Manual} has nothing to say on the subject, but \textsf{biblatex-chicago-notes} 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} @@ -2271,7 +2278,7 @@ the author. See above (section~\ref{sec:entrytypes}) under nyt:trevorobit entries in \textsf{notes-test.bib} will give you some idea of how this works. -\enlargethispage{\baselineskip} +%\enlargethispage{\baselineskip} \mybigspace This \mymarginpar{\textbf{keywords}} field is \textsf{biblatex}'s extremely powerful and flexible technique for @@ -2361,7 +2368,7 @@ cases this isn't strictly necessary (17.32--34; virginia:plantation). For all cities, you should use the common English version of the name, if such exists (17.101). -\enlargethispage{-\baselineskip} +%\enlargethispage{-\baselineskip} \mylittlespace Two more details need explanation here. In \textsf{article}, \textsf{periodical}, and \textsf{review} entries, @@ -2891,6 +2898,8 @@ most situations, but if you have set \texttt{useauthor=false} (and not only \textsf{shorteditor} will be recognized. Cf.\ \textsf{editortype}, above. +%\enlargethispage{\baselineskip} + \mybigspace This \mymarginpar{\textbf{shorthand}} is \textsf{biblatex}'s mechanism for using abbreviations in place of the usual short note form, and I've left it effectively unmodified in @@ -2941,8 +2950,6 @@ with a lowercase letter the style will do the right thing (barcott:review, bundy:macneil, Clemens:letter, kozinn:review, ratliff:review, unsigned:ranke:15). -%\enlargethispage{\baselineskip} - \mybigspace A \mymarginpar{\textbf{sortkey}} standard \textsf{biblatex} field, designed to allow you to specify how you want an entry alphabetized in a bibliography. In general, if an entry @@ -3039,6 +3046,8 @@ its own, require, then the following rules apply: osborne:poison, ratliff:review, unsigned:ranke:15). \end{enumerate} +\enlargethispage{-2\baselineskip} + The \emph{Manual} provides a few more rules, as well. A word normally italicized in text should also be italicized in a quoted or plain-text title, but should be in roman (\enquote{reverse italics}) in an @@ -3079,8 +3088,6 @@ example where the \textsf{titleaddon} field, holding the name of a regular column in a newspaper, is capitalized, a situation that is handled as you would expect.) -%\enlargethispage{\baselineskip} - \mybigspace As \mymarginpar{\textbf{translator}} far as possible, I have implemented this field as \textsf{biblatex}'s standard styles do, but the requirements specified by the \emph{Manual} present certain @@ -3346,6 +3353,8 @@ you toward a few such entries in what follows. \textbf{NB:} \textsf{biblatex's} \cmd{mkbibquote} command is now mandatory in some situations. See its entry below. +\enlargethispage{\baselineskip} + \mybigspace Version \mymarginpar{\textbf{\textbackslash autocap}} 0.8 of \textsf{biblatex} introduced the \cmd{autocap} command, which capitalizes a word inside a note or bibliography entry if that word @@ -3473,7 +3482,7 @@ instead of \cmd{enquote} or the usual \LaTeX\ mechanisms inside their .bib files. For further details, please see the \cmd{mkbibquote} entry below. -\enlargethispage{-\baselineskip} +%\enlargethispage{-\baselineskip} \mylittlespace I have retained the code for the \cmd{custpunct} commands in \textsf{chicago-notes.cbx}, in case a particularly gnarly @@ -3594,7 +3603,7 @@ originally I intended them for use when a particular name applied only to a specific \textsf{title}, rather than to a \textsf{maintitle} or \textsf{booktitle} (cf.\ \textbf{namea} and \textbf{nameb}, above). -%\enlargethispage{\baselineskip} +\enlargethispage{\baselineskip} \mylittlespace In the present instance, you can use \cmd{partcomp} to identify a compiler when \textsf{namec} won't do, e.g., in a @@ -3741,8 +3750,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} @@ -3763,6 +3770,8 @@ want something else. Again, I've provided only the most flexible form of the command, so you'll have to wrap it in a \cmd{footnote} manually. +\enlargethispage{\baselineskip} + \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 @@ -3813,6 +3822,8 @@ command to disable this functionality in any given reference, or indeed one of the \texttt{fullcite} commands if you need the long note form for any reason. +%\enlargethispage{\baselineskip} + \mylittlespace This \marginpar{\texttt{loccittracker\\=constrict}} allows the package to determine whether two consecutive citations of the same source also cite the same page of that source. In such a @@ -4028,7 +4039,7 @@ form. For more fine-grained control of individual citations you'll probably want to use specialized citation commands, instead. See section \ref{sec:citecommands}. -\enlargethispage{\baselineskip} +%\enlargethispage{\baselineskip} \mylittlespace This \mymarginpar{\texttt{short}} option means that your text will only use the short note form, even in the first @@ -4634,6 +4645,8 @@ a clone of \textsf{artwork}, so you should consult the latter's documentation above to see how to construct your .bib entry. (See \emph{Manual} 12.33; 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 @@ -5299,6 +5312,8 @@ undefined, and \textsf{biblatex-chicago} will do the rest. Cf.\ \textsf{foreword} and \textsf{introduction}. (See \emph{Manual} 17.46, 17.74; 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 @@ -6196,7 +6211,7 @@ language or a translation to either of the latter two, you could probably manage it with special formatting inside those fields themselves. -\enlargethispage{\baselineskip} +%\enlargethispage{\baselineskip} \mybigspace I \mymarginpar{\textbf{lista}} intend this field specifically for presenting citations from reference works that are @@ -6522,7 +6537,7 @@ be one of \texttt{american}, \texttt{brazilian}, \texttt{danish}, \texttt{portuguese}, \texttt{spanish}, or \texttt{swedish}, to which I've added \texttt{russian}. -\enlargethispage{\baselineskip} +%\enlargethispage{\baselineskip} \mybigspace At \colmarginpar{\textbf{origlocation}} least one notes \&\ bibliography example in the \emph{Manual} provides a more complete @@ -6990,6 +7005,8 @@ its own, require, then the following rules apply: white:\\callimachus.) \end{enumerate} +\enlargethispage{\baselineskip} + 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 @@ -7030,7 +7047,7 @@ provides an example where the \textsf{titleaddon} field, holding the name of a regular column in a newspaper, is capitalized, a situation that is handled as you would expect.) -\enlargethispage{\baselineskip} +%\enlargethispage{-\baselineskip} \mybigspace As \mymarginpar{\textbf{translator}} far as possible, I have implemented this field as \textsf{biblatex}'s standard styles do, @@ -7121,7 +7138,7 @@ provide one for all entry types. The required \LaTeX\ package \textsf{url} will ensure that your documents format such references properly, in the text and in the reference apparatus. -\enlargethispage{\baselineskip} +%\enlargethispage{\baselineskip} \mybigspace Standard \colmarginpar{\textbf{urldate}} \textsf{biblatex} field, it identifies exactly when you accessed a given url. This @@ -7200,7 +7217,7 @@ others being \textsf{crossref} and \textsf{xref}), and have chosen the name \textsf{userf} because it might act as a mnemonic for its function. -\enlargethispage{-\baselineskip} +%\enlargethispage{-\baselineskip} \mylittlespace In order to use this system, you should start by entering both the original and its translation into your .bib file, @@ -7565,7 +7582,7 @@ 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: (). -\enlargethispage{\baselineskip} +%\enlargethispage{\baselineskip} \mylittlespace This \mymarginpar{\texttt{labelyear=\\true}} option tells \textsf{biblatex} to provide the special \textsf{labelyear} and @@ -7927,7 +7944,7 @@ use the \cmd{citereset} command, allied possibly with the \textsf{biblatex}\ \texttt{citereset} option, on which see \textsf{biblatex.pdf} §3.1.2.1. -\enlargethispage{\baselineskip} +%\enlargethispage{\baselineskip} \mylittlespace Kenneth Pearce \colmarginpar{\texttt{shorthandfull}} has suggested that, in some fields of study, a list of shorthands @@ -8165,7 +8182,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 @@ -8193,22 +8210,32 @@ 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. @@ -8222,28 +8249,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 @@ -8257,11 +8278,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\}\{\%}\\ @@ -8289,9 +8311,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} @@ -8475,7 +8499,7 @@ all the citations together in parentheses at the end of the annotation, though on my machine this doesn't always work too well, either. -%\enlargethispage{\baselineskip} +\enlargethispage{\baselineskip} \mylittlespace Version 1.5 of \textsf{biblatex} revised the way the package deals with breaking long URLs and DOIs across lines. The new @@ -8512,8 +8536,6 @@ time required to implement the changes for the 16th edition, these types may make it into the package for the next major release, or they may have to wait until the one after. -%\enlargethispage{-2\baselineskip} - \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 @@ -8544,7 +8566,30 @@ 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 I have updated calls to \cmd{DeclareLabelname} and + \cmd{DeclareLabelyear} in .cbx files so that the package works + correctly with the most recent version (2.4) of \textsf{biblatex}. +\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. +\end{itemize} + +\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 diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.pdf Binary files differindex bd42b0c9669..f876dbbe978 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex index cf2189a331a..247d32c5e03 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex @@ -69,7 +69,7 @@ process your .bib files, as \textsc{Bib}\TeX\ (and its more recent variants) will no longer provide all the features you need. I highly recommend, therefore, that you upgrade either to \textsf{Biber} 0.9.9 and to \textsf{biblatex} 1.7, which are designed to work together, or -to \textsf{Biber} 1.0 and \textsf{biblatex} 2.0, which latter two are +to \textsf{Biber} 1.4 and \textsf{biblatex} 2.4, which latter two are the newest releases and are likewise designed to work as a matched pair. The advice that follows in this document assumes that you are using \textsf{Biber}; if you wish to continue using \textsc{Bib}\TeX\ @@ -87,14 +87,18 @@ This edition implements significant changes to what the specification has, historically, recommended, and there are certain to be users who prefer the older format with titles capitalized sentence-style and not, in the case of most un-book-like entries, enclosed in quotation -marks. You can still use the 15th-edition style files from -\textsf{biblatex-chicago}, which have been updated with improvements -borrowed from the 16th edition, but which shouldn't require any -changes to your current .bib files. (See -\textsf{biblatex-chicago15.pdf and cms15-dates-sample.pdf}.) I shall -also, in a future release, implement a full 16th-edition style with -15th-edition title formatting, as envisaged by the \emph{Manual} -\autocite*[15.45]{chicago:manual}. +marks. For such users, the new \textsf{authordate-trad} style, as +envisaged by the \emph{Manual} \autocite*[15.45]{chicago:manual}, +grafts the traditional Chicago author-date title formatting onto the +current recommendations for the remainder of the reference apparatus. +Please consult \textsf{cms-trad-sample.pdf} to see how this looks in +practice. You can also still use the 15th-edition style files from +\textsf{biblatex-chicago}, which have been updated with some +improvements borrowed from the 16th edition. (See +\textsf{biblatex-chicago15.pdf} and \textsf{cms15-dates-sample.pdf}.) +I would encourage all users, however, to switch to one of the +16th-edition styles as soon as possible, as I am concentrating nearly +all of my development time there. \subsection*{Usage} \label{usage} @@ -124,10 +128,12 @@ automatically resets the tracker at page breaks: \citereset\cmd{citereset}\ \autocite[15.27]{chicago:manual}. If you are going to repeat a source, make sure that the cite command provides -a 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: -\autocite{chicago:manual}. +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: +\autocite{chicago:manual}. If you don't need to cite a specific page, +then it may be better, or at least more concise, only to use one +citation command rather than two. \subsection*{Other citation commands} \label{sec:other} diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.pdf Binary files differindex 0fc044156fe..be59f305b60 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.tex index f02c88fa980..33c59badf64 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.tex +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-notes-sample.tex @@ -221,17 +221,17 @@ note\autocite{white:callimachus} note\autocite{white:ross:memo} note\autocite{warr:ellison} note\autocite{weed:flatiron} note\autocite{wikiped:bibtex} note\autocite{will:cohere}. -Note\autocite{wauchope:ceramics} note\autocite{zukowsky:chicago} -note\autocite{weresz} note\autocite{white:russ} +Note\autocite{wauchope:ceramics}. As \textcite{zukowsky:chicago} +says, note\autocite{weresz} note\autocite{white:russ} note\autocite{white:callimachus} note\autocite{white:ross:memo} note\autocite{white:russ} note\autocite[BibTeX]{wikiped:bibtex} -note\autocite{will:cohere} note\autocite{zukowsky:chicago} -note\autocites[See][3.2.996b5--8]{aristotle:metaphy:gr}[360e--361b] -{plato:republic:gr}[and also][for additional -information]{white:callimachus} -note\autocite{aristotle:metaphy:trans}. +note\autocite{will:cohere} +note.\footnote{\textcite{zukowsky:chicago}.} -Note\autocites[See][]{mchugh:wake}[and][569]{warr:ellison} +Note\autocites[See][3.2.996b5--8]{aristotle:metaphy:gr}[360e--361b] +{plato:republic:gr}[and also][for additional +information]{white:callimachus} note\autocite{aristotle:metaphy:trans} +note\autocites[See][]{mchugh:wake}[and][569]{warr:ellison} note\footnote{\citetitles{warr:ellison}{mchugh:wake}.} note\footnote{\Citetitle{powell:email}.} note\footnote{\headlessfullcite[3:126]{meredith:letters}.} diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.pdf Binary files differnew file mode 100644 index 00000000000..af5c6547def --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.tex new file mode 100644 index 00000000000..e63610c0f46 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-trad-sample.tex @@ -0,0 +1,510 @@ +\documentclass[a4paper,12pt]{report} +\usepackage[T1]{fontenc} +\usepackage{textcomp} +%\usepackage{endnotes} +\usepackage[latin1]{inputenc} +\usepackage[german,french,american]{babel} +\usepackage[autostyle]{csquotes} +%\usepackage[document]{ragged2e} +\usepackage[authordate-trad,backend=biber,babel=hyphen,% +bibencoding=latin1,strict]{biblatex-chicago} +% \usepackage[style=chicago-authordate,backend=biber,usecompiler=true,% +% babel=hyphen,bibencoding=auto,sorting=nyt,cmslos,autocite=inline]{biblatex} +%\DeclareLanguageMapping{german}{cms-german} +%\DeclareLanguageMapping{american}{cms-american} +%\DeclareLanguageMapping{french}{cms-french} +%\renewcommand*{\rmdefault}{fgn}% The font (gentium) used for pdf +\usepackage{ifthen} +\usepackage{setspace} +\usepackage{vmargin} \setpapersize{A4} +\setmarginsrb{1in}{20pt}{1in}{.5in}{1pt}{2pt}{0pt}{2mm} +% \renewcommand*{\biburlsetup}{% +% \Urlmuskip=0mu plus 2mu\relax +% \mathchardef\UrlBreakPenalty=200\relax +% \mathchardef\UrlBigBreakPenalty=100\relax +% \mathchardef\UrlEmergencyPenalty=9000\relax +% \appto\UrlSpecials{% +% \do\0{\mathchar`\0\penalty\UrlEmergencyPenalty}% +% \do\1{\mathchar`\1\penalty\UrlEmergencyPenalty}% +% \do\2{\mathchar`\2\penalty\UrlEmergencyPenalty}% +% \do\3{\mathchar`\3\penalty\UrlEmergencyPenalty}% +% \do\4{\mathchar`\4\penalty\UrlEmergencyPenalty}% +% \do\5{\mathchar`\5\penalty\UrlEmergencyPenalty}% +% \do\6{\mathchar`\6\penalty\UrlEmergencyPenalty}% +% \do\7{\mathchar`\7\penalty\UrlEmergencyPenalty}% +% \do\8{\mathchar`\8\penalty\UrlEmergencyPenalty}% +% \do\9{\mathchar`\9\penalty\UrlEmergencyPenalty}}% +% \def\UrlBreaks{% +% \do\.\do\@\do\/\do\\\do\!\do\_\do\|\do\;\do\>\do\]\do\)\do\}% +% \do\,\do\?\do\'\do\+\do\=\do\#\do\$\do\&\do\*\do\^\do\"}% +% \def\UrlBigBreaks{\do\:\do\-}} +\usepackage{url} +\urlstyle{rm} +\appto\bibsetup{\sloppy} +\hyphenation{evans-ton clem-ens} +\setlength{\dimen\footins}{9.5in} +\setlength{\parindent}{0pt} +\setlength{\parskip}{5pt} +\setcounter{biburlnumpenalty}{9000} +\setcounter{biburlucpenalty}{9000} +\setcounter{biburllcpenalty}{9000} +\protected\def\onethird{{\scriptsize\raisebox{.7ex}{1}% + \hspace{-0.1em}\raisebox{.2ex}{/}\hspace{-0.03em}3}} +\newcommand{\cmd}[1]{\texttt{\textbackslash #1}} +\usepackage[colorlinks,urlcolor=blue,citecolor=black, +plainpages=false,breaklinks=true]{hyperref} +\bibliography{dates-test} +%%\onehalfspacing +\begin{document} + +\section*{The Chicago authordate-trad Specification} +\label{sec:spec} + +\subsection*{Important Note} +\label{bibernote} + +Starting with \textsf{biblatex} version 1.5, in order to adhere to the +author-date specification you will need to use \textsf{Biber} to +process your .bib files, as \textsc{Bib}\TeX\ (and its more recent +variants) will no longer provide all the features you need. I highly +recommend, therefore, that you upgrade either to \textsf{Biber} 0.9.9 +and to \textsf{biblatex} 1.7, which are designed to work together, or +to \textsf{Biber} 1.4 and \textsf{biblatex} 2.4, which latter two are +the newest releases and are likewise designed to work as a matched +pair. The advice that follows in this document assumes that you are +using \textsf{Biber}; if you wish to continue using \textsc{Bib}\TeX\ +then you need \textsf{biblatex} version 1.4c and +\textsf{biblatex-chicago} 0.9.7a. (Please contact me at the email +address in \textsf{biblatex-chicago.pdf} if you have any difficulty +obtaining a copy of this earlier release.) + +\subsection*{Editions} +\label{editions} + +This file documents the \textsf{authordate-trad} specification which, +as envisaged by the \emph{Manual} \autocite*[15.45]{chicago:manual}, +grafts the traditional Chicago author-date title formatting onto the +current, 16th-edition recommendations for the remainder of the +reference apparatus. This newest edition implemented significant +changes to what the author-date specification has, historically, +recommended, and there are certain to be users who prefer the older +format with titles capitalized sentence-style and not, in the case of +most un-book-like entries, enclosed in quotation marks. I have +implemented the \textsf{authordate-trad} style for such users. To +compare it with the standard style, please see +\textsf{cms-dates-sample.pdf}. You can also still use the +15th-edition style files from \textsf{biblatex-chicago}, which have +been updated with some improvements borrowed from the 16th edition. +(See \textsf{biblatex-chicago15.pdf} and +\textsf{cms15-dates-sample.pdf}.) I would encourage all users, +however, to switch to one of the 16th-edition styles as soon as +possible, as I am concentrating nearly all of my development time +there. + +\subsection*{Usage} +\label{usage} + +As a general rule, you'll probably want to use the \cmd{autocite} +command for most citations. For most sources, the result will be +exactly as you expect it to be. A few examples: +\autocite{adorno:benj}; \autocite{ashbrook:brain}; +\autocite{babb:peru}; \autocite{barcott:review:15}. Any page +references should also appear as you expect: \autocite[338]{batson}; +\autocite[79]{beattie:crime}; \autocite[36]{boxer:china}. + +\subsection*{Repeated citations} +\label{sec:ibidem} + +Repeated citations are somewhat complicated. The Chicago author-date +style doesn't use \enquote{\emph{Ibid},} but in general a repeated +citation on the same page will print only the page reference: +\autocite{browning:aurora}; \autocite[45]{browning:aurora}. +Technically, this should only occur when a source is cited +\enquote{more than once in one paragraph} +\autocite[15.26]{chicago:manual}, so you can use the \cmd{citereset} +command from \textsf{biblatex} to achieve the greatest compliance, as +the package only offers automatic resetting on part, chapter, section, +and subsection boundaries, while \textsf{biblatex-chicago} +automatically resets the tracker at page breaks: + +\citereset\cmd{citereset}\ \autocite[15.27]{chicago:manual}. If you +are going to repeat a source, make sure that the 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: +\autocite{chicago:manual}. If you don't need to cite a specific page, +then it may be better, or at least more concise, only to use one +citation command rather than two. + +\subsection*{Other citation commands} +\label{sec:other} + +The other citation commands from \textsf{biblatex} also work fine: + +\cmd{textcite}: \textcite{conley:fifthgrade}; \cmd{autocite*}: +\autocite*{connell:chronic}; \cmd{cite}: \cite{conway:evolution}; +\cmd{cite*}: \cite*{davenport:attention}; \cmd{foot\-note} with +\cmd{autocite};\footnote{\autocite{donne:var:15}.}\ \cmd{footcite} +(=\cmd{cite} inside a \cmd{footnote}). \footcite{dunn:revolutions} + +Multicites should work as you expect, too: + +\cmd{autocites}: \autocites{dyna:browser}{eliot:pound}; +\cmd{autocites} by the same author: +\autocites{pirumova}{pirumova:russian}; \cmd{autocites} by the same +author with postnotes: \autocites{pirumova}[14]{pirumova:russian}; +\cmd{textcites} by the same author with postnotes: +\textcites[37]{pirumova}{pirumova:russian}. + +\subsection*{Shorthands} +\label{sec:shorthands} + +Chicago's author-date style only seems to recommend the use of +shorthands as abbreviations for long authors' names, particularly +institutional names \autocite[15.36]{chicago:manual}. By default, I +have followed this recommendation: \cmd{autocites}: +\autocites{bsi:abbreviation}{iso:electrodoc}; \cmd{textcites}: +\textcites{bsi:abbreviation}{iso:electrodoc}. This \textsf{shorthand} +will by default appear at the head of the entry in the list of +references, followed by the parenthesized expansion of the shorthand, +taken from the \textsf{author} field. (This is a change from the 15th +edition.) You will usually also need a \textsf{sortkey} field to make +sure that the entry is alphabetized by the \textsf{shorthand} rather +than by the \textsf{title}. If you use a \cmd{printshorthands} +command, the list of shorthands will still be printed, so you now have +a variety of options available for presenting the expansions depending +on your specific requirements. Please note, also, that you can get +back something approaching the \enquote{standard} behavior of +shorthands if you give the \texttt{cmslos=false} option to +\textsf{biblatex-chicago} in your document preamble. + +\subsection*{Mildly problematic entries} +\label{sec:problematic} + +In most entries, the absence of an author can be supplied by, e.g., an +editor or a translator: \autocite{chaucer:alt}; +\autocite{silver:gawain}. Sometimes an anonymous work's author is +known or can be guessed: \autocite{horsley:prosodies}; +\autocite{cook:sotweed}. Alternatively, in some cases the +\textsf{title} may appear in place of the \textsf{author}: +\autocite{anon:stanze}; \autocite{virginia:plantation}. The 16th +edition is less than enthusiastic about the use of +\enquote{\texttt{Anon.}}\ as author. + +With \textsf{Biber}, in most entry types, an absent \textsf{date} will +automatically provoke it into searching for other sorts of dates in +the entry, in the order \textsf{year, eventyear, origyear, urlyear}: +e.g., \autocite{evanston:library}, which only has a \textsf{urlyear}. +In three entry types --- \textsf{Music}, \textsf{Review}, and +\textsf{Video} --- this search order is \textsf{eventyear, origyear, + year, urlyear}, as in these types the earliest year should take +precedence (cf.\ page~\pageref{sec:audiovisual}, below). 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. +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} and section~5.2, s.v.\ \enquote{date} in +\textsf{biblatex-chicago.pdf} for the details.) + +In most entry types, the absence of all four possible dates will +automatically produce \mbox{\enquote{\texttt{n.d.}\hspace{-2pt}}} +instead: \autocite{bernstein:shostakovich}. You can also give it +yourself in the form \cmd{bibstring\{nodate\}}: +\autocite{ross:thesis}. A date that can be guessed should appear +within square brackets: \autocite{clark:mesopot}. Forthcoming works +are straightforward, assuming you remember to use the \cmd{autocap} +macro so that the word appears correctly in both citations and the +list of references: \autocite{author:forthcoming}; +\autocite{contrib:contrib}. + +The 16th edition of the \emph{Manual} has changed the rules for +entries with more than one date \autocite[15.38]{chicago:manual}. +First, \textsf{Music} and \textsf{Video} entries have their own rules, +which are applied automatically. (Once again, see +page~\pageref{sec:audiovisual}, below.) For other entry types, there +are two options, corresponding to two different states of the +\texttt{cmsdate} entry option. The default is \texttt{cmsdate=off}: +\autocite{maitland:equity}. Here, setting the \textsf{pubstate} field +to \texttt{reprint} ensures that a notice of the original publication +date will be printed at the end of the reference list entry. +Alternatively, you can use \texttt{cmsdate=both}: +\autocite{emerson:nature}; \autocite{maitland:canon}. +\texttt{cmsdate=new} and \texttt{cmsdate=old} are both now synonyms of +\texttt{both}, while \texttt{cmsdate=on} is still available even +though it falls outside the specification: +\autocite{james:ambassadors}. These options, in combination with +others available in your .bib files, can cover a wide range of +difficult cases. Please see the next section below, the documentation +in \textsf{biblatex-chicago.pdf}, and also the following entries in +\textsf{dates-test.bib}: +\autocites{schweitzer:bach}{white:russ}{white:ross:memo}. + +\subsection*{Corners of the specification} +\label{sec:corners} + +In some cases, the \emph{Manual} isn't altogether clear about how to +present entries in the author-date style. I'm pretty certain about +most of what follows, but if you interpret the specification +differently please let me know. + +\subsubsection*{InReference entries} +\label{sec:inref} + +These present several peculiarities: the title of the work should +always take the place of any author, no +\enquote{\texttt{n.d.}\hspace{-2pt}} will automatically be provided, +and any postnote field will be enclosed in quotation marks preceded by +\enquote{\texttt{s.v.}\hspace{-2pt}} for \enquote{\emph{sub verbo}.} +This allows you to refer to alphabetized articles in well-known +reference works: \autocite[Hume, David]{ency:britannica}; +\autocite[Sibelius, Jean]{grove:sibelius}; +\autocite[BibTeX]{wikiped:bibtex}. + +\subsubsection*{Author-less Article, Review, and Manual entries} +\label{sec:authless:art} + +In \textsf{Article} and \textsf{Review} entries with the +\texttt{magazine} entrysubtype, the absence of an author automatically +places the \textsf{journaltitle} of the periodical in citations and at +the head of the entry in the list of references: +\autocite{gourmet:052006}. You can cite newspaper and magazine +articles entirely within the text, i.e., without them appearing in the +reference list \autocite[15.47]{chicago:manual}, if you set the +\texttt{cmsdate=full} entry option: \autocite{lakeforester:pushcarts}; +\autocite{nyt:trevorobit}. In \textsf{Manual} entries, the +\textsf{organization} field does the same: \autocite{dyna:browser}. +If you wish to present an abbreviated form of the journal (or +organization) name only in citations, then the \textsf{shortauthor} +field --- or in other cases the \textsf{shorthand} field --- is the +place for it, making sure to include formatting: +\autocite{unsigned:ranke}; \autocite{bsi:abbreviation}. + +\subsubsection*{Misc entries with an entrysubtype} +\label{sec:misc} + +When citing individual letter-like pieces from an unpublished archive +where only an \textsf{origdate} is present, you no longer need to set +the \texttt{cmsdate} option in your .bib entry, as \textsf{Biber} and +\textsf{biblatex-chicago} now handle this automatically: +\autocite{creel:house}. Non-letters, e.g., interviews, use the +\textsf{date} field, so you don't need \texttt{cmsdate} there, either: +\autocite{spock:interview}. For undated pieces you can put +\cmd{bibstring\{nodate\}} in the \textsf{year} field: +\autocite{dinkel:agassiz}. For citing whole collections, see the next +section. + +\subsubsection*{entrysubtype = \{classical\}} +\label{sec:classical} + +This option's name derives from its use for citing texts from +classical antiquity, though in the author-date style especially it can +be put to use in several other contexts. In a nutshell, any entry +with such an \textsf{entrysubtype} will be treated, in citations only, +not as author-date but as author-title. (Entries in the list of +references, e.g., a particular edition of Aristotle, will still appear +in standard author-date format.) A \cmd{cite*} or \cmd{autocite*} +command will, in such a case, produce the title rather than the year. +Some examples should make this clearer: + +Classical works: without abbreviation: +\autocite{aristotle:metaphy:trans}; with abbreviation: +\autocite{aristotle:metaphy:gr}; \autocite{plato:republic:gr}; using +standard pagination: \autocite*[3.2.996b5--8]{aristotle:metaphy:gr}; +\autocite*[420e]{plato:republic:gr}; work cited by page of a modern +edition, i.e., without \textsf{entrysubtype}: +\autocite[198]{euripides:orestes}. + +Sacred works, e.g., the Bible and the Qur'an: +\autocite[25:19--36:43]{genesis}. + +An unpublished archive, from which more than one work has been cited: +\autocite[file 12]{house:papers}. (Both this and the previous example +use a Misc entry with \texttt{classical} \textsf{entrysubtype}.) + +\subsubsection*{Comments inside citations} +\label{sec:comments} + +If you wish to include a comment inside the parentheses of a citation, +it will need to be separated by a semicolon +\autocite[15.23]{chicago:manual}. If you have a \textsf{postnote}, +then you can manually provide the punctuation and comment in that +field, e.g., \autocite[4; the unrevised trans.]{stendhal:parma}. +Without a \textsf{postnote}, you'll need a separate \textsf{Misc} or +\textsf{CustomC} entry containing just the text of the comment in the +\textsf{title} field, \textsf{entrysubtype} \texttt{classical}, and +\textsf{options} \texttt{skipbib}. An \cmd{autocites} command calling +both the main text and the comment will do the trick, e.g., +\autocites{chicago:manual}{chicago:comment}. + +\subsubsection*{Multiple authors} +\label{sec:multiple} + +The default settings in \textsf{biblatex-chicago} are +\texttt{maxnames=3,minnames=1} in citations and +\texttt{max\-bibnames=10,minbibnames=7} in the list of references +(these latter parameters set in \textsf{biblatex-chicago.sty}). In +practice, this means that an entry like hlatky:hrt, with 5 authors, +will present all of them in the list of references but will truncate +to one in citations, like so: \autocite{hlatky:hrt}. For the vast +majority of circumstances, these settings are exactly right for the +Chicago author-date specification. However, if \enquote{a reference + list includes another work \emph{of the same date} that would also + be abbreviated as [\enquote{Hlatky et al.}] but whose coauthors are + different persons or listed in a different order, the text citations + must distinguish between them} \autocite[15.28]{chicago:manual}. +The new (\textsf{Biber}-only) \textsf{biblatex} option +\texttt{uniquelist}, set for you in \textsf{biblatex-chicago.sty}, +will automatically handle many of these situations for you, but it is +as well to understand that it does so by temporarily suspending the +limits, listed above, on how many names to print in a citation. +Without \texttt{uniquelist}, \textsf{biblatex} would present such a +work as, e.g., (Hlatky et al. 2002b), while hlatky:hrt would be +(Hlatky et al. 2002a). This does distinguish between them, but +inaccurately, as it suggests that the two different author lists are +exactly the same. With \texttt{uniquelist}, the two citations might +look like (Hlatky, Boothroyd et al.\ 2002) and (Hlatky, Smith et al.\ +2002), which is what the specification requires. + +If, however, the distinguishing name occurs further down the author +list --- in fourth or fifth position in our examples --- then the +default settings would produce citations with all 4 or 5 names +printed, which can become awkwardly long. In such a situation, you +can provide \textsf{shortauthor} fields that look like this: +\{\{Hlatky et al., Quality of life,\}\} and \{\{Hlatky et al., +Depressive symptoms,\}\}, using a shortened title to distinguish the +references. This would produce (Hlatky et al., Quality of life, 2002) +and (Hlatky et al., Depressive symptoms, 2002), as the spec +recommends. There is, unfortunately, no simpler way that I know of to +deal with this situation. + +\subsubsection*{Audiovisual entries} +\label{sec:audiovisual} + +According to the \emph{Manual}, \enquote{Chicago recommends a more + comprehensive approach to dating audiovisual materials than in + previous editions.} This means, for instance, that, even when +consulting a digital copy, \enquote{it is generally useful to give + information about the original source.} Also, \enquote{the date of + the original recording should be privileged in the citation} +\autocite[15.53]{chicago:manual}. The rather more book-like entries +are generally unaffected by these changes, so published +(\textsf{Audio}) and unpublished (\textsf{Misc}) scores are no problem +at all: \autocite{schubert:muellerin}; \autocite{verdi:corsaro}; +\autocite{shapey:partita:15}. The dating of online materials has been +enhanced: \autocite{coolidge:speech:trad}; +\autocite{horowitz:youtube}; \autocite{pollan:plant}. The most +significant changes, however, appear in \textsf{Music} and +\textsf{Video} entries, where every effort should be made to find +date(s) for sources: \autocite{auden:reading}; +\autocite{friends:leia}; \autocite{handel:messiah}; +\autocite{holiday:fool}; \autocite{nytrumpet:art}. Others perhaps +require further information in the entry or genuinely are better +suited to presentation in running text: \autocite{beethoven:sonata29}. +The standard \textsf{biblatex} tools for subdividing reference lists +are all available if you want to follow the \emph{Manual's} +recommendations on presenting this kind of material separately from +other sources. + +\subsection*{Further examples (mainly for testing purposes)} +\label{testing} + +Article: \autocite{assocpress:gun}; \autocite{brown:bremer}; +\autocite{chu:panda}; \autocite{conley:fifthgrade}; +\autocite{connell:chronic}; \autocite{ellis:blog}; +\autocite{friedman:learning}; \autocite{garaud:gatine}; +\autocite{garrett:15}; \autocite{gibbard:15}; \autocite{kern}; +\autocite{kimluu:diethyl:15}; \autocite{lewis:15}; +\autocite{loften:hamlet}; \autocite{loomis:structure:15}; +\autocite{morgenson:market}; \autocite{osborne:poison:15}; +\autocite{reaves:rosen}; \autocite{rozner:liberation}; +\autocite{schneider:mittelpleistozaene}; \autocite{sewall:letter}; +\autocite{stenger:privacy}; \autocite{terborgh:preservation}; +\autocite{wall:radio}; \autocite{warr:ellison}; +\autocite{white:callimachus}. + +Artwork: \autocite{leo:madonna}. + +Audio: \autocite{greek:filmstrip}; \autocite{weed:flatiron}. + +Book: \autocite{barrows:reading}; \autocite{churchill:letters}; +\autocite{cohen:schiff}; \autocite{cotton:manufacture}; +\autocite{creasey:ashe:blast}; \autocite{creasey:morton:hide}; +\autocite{creasey:york:death}; \autocite{davenport:attention}; +\autocite{feydeau:farces}; \autocite{furet:passing:eng}; +\autocite{furet:passing:fr}; \autocite{harley:cartography}; +\autocite{hopp:attalid}; \autocite{howell:marriage}; +\autocite{lach:asia}; \autocite{lecarre:quest}; +\autocite{levistrauss:savage}; \autocite{lynch:webstyle}; +\autocite{maisonneuve:relations}; \autocite{mchugh:wake:15}; +\autocite{menchu:crossing}; \autocite{meredith:letters}; +\autocite{michelangelo:poems}; \autocite{mla:style}; +\autocite{natrecoff:camera}; \autocite{palmatary:pottery}; +\autocite{pelikan:christian}; \autocite{rodman:walk}; +\autocite{schellinger:novel}; \autocite{sechzer:women}; +\autocite{sereny:cries}; \autocite{soltes:georgia}; +\autocite{stendhal:parma}; \autocite{suangtho:tectona}; +\autocite{thompson:making}; \autocite{tillich:system}; +\autocite{times:guide}; \autocite{turabian:manual}; +\autocite{walker:columbia}; \autocite{wauchope:ceramics}; +\autocite{weber:saugetiere}; \autocite{weresz}; +\autocite{white:total}; \autocite{wright:evolution}; +\autocite{wright:theory}. + +BookInBook: \autocite{bernard:boris}. + +Collection: \autocite{brush:ornithology}; \autocite{kamrany:economic}; +\autocite{prairie:state}; \autocite{zukowsky:chicago}. + +Image: \autocite{bedford:photo}. + +InBook: \autocite{ashbrook:brain}; \autocite{phibbs:diary}; +\autocite{will:cohere}. + +InCollection: \autocite{centinel:letters}; \autocite{ellet:galena}; +\autocite{keating:dearborn}; \autocite{lippincott:chicago}; +\autocite{sirosh:visualcortex}; \autocite{wiens:avian}. + +InProceedings: \autocite{frede:inproc}. + +InReference: \autocite[absolute]{oed:cdrom}. + +Manual: \autocite{dyna:browser}. + +Misc: \autocite{roosevelt:speech:trad}. + +Music: \autocite{floyd:atom}; \autocite{mozart:figaro}; +\autocite{rubinstein:chopin}. + +Online: \autocite{harwood:biden}; \autocite{powell:email}. + +Patent: \autocite{petroff:impurity}. + +Periodical: \autocite{good:wholeissue}; \autocite{whittington:water}. + +Report: \autocite{herwign:office}. + +Review: \autocite{ac:comment:trad}; \autocite{bundy:macneil}; +\autocite{Clemens:letter}; \autocite{kozinn:review}; +\autocite{ratliff:review:15}; \autocite{wallraff:word}. + +SuppBook: \autocite{friedman:intro}; \autocite{polakow:afterw}; +\autocite{prose:intro}. + +Thesis: \autocite{murphy:silent:15}. + +Unpublished: \autocite{nass:address}. + +Video: \autocite{cleese:holygrail}; \autocite{hitchcock:nbynw}. + + +% \printshorthands % No longer necessary in author-date. +% \nocite{*} +\printbibliography[title=References] + +\end{document} +%%% Local Variables: +%%% mode: latex +%%% TeX-master: t +%%% End: diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-dates-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-dates-sample.pdf Binary files differindex 0d78264d6d2..44d44f6343f 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-dates-sample.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-dates-sample.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-dates-sample.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-dates-sample.tex index c78a1fdf7b5..f1fb82488bd 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-dates-sample.tex +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-dates-sample.tex @@ -67,7 +67,7 @@ process your .bib files, as \textsc{Bib}\TeX\ (and its more recent variants) will no longer provide all the features you need. I highly recommend, therefore, that you upgrade either to \textsf{Biber} 0.9.9 and to \textsf{biblatex} 1.7, which are designed to work together, or -to \textsf{Biber} 1.0 and \textsf{biblatex} 2.0, which latter two are +to \textsf{Biber} 1.4 and \textsf{biblatex} 2.4, which latter two are the newest releases and are likewise designed to work as a matched pair. The advice that follows in this document assumes that you are using \textsf{Biber}; if you wish to continue using \textsc{Bib}\TeX\ diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-notes-sample.pdf b/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-notes-sample.pdf Binary files differindex be407912878..e1782a2dcbf 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-notes-sample.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms15-notes-sample.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/dates-test.bib b/Master/texmf-dist/doc/latex/biblatex-chicago/dates-test.bib index 46f6f7867dd..733174374b8 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/dates-test.bib +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/dates-test.bib @@ -72,6 +72,24 @@ parentheses.} } +@Review{ac:comment:trad, + entrysubtype = {magazine}, + author = {AC}, + eventdate = {2008-07-01}, + nameaddon = {(10:18 a.m.)}, + crossref = {ellis:blog}, + title = {comment on Rhian Ellis, Squatters' rights}, + annotation = {_authordate-trad only_. The 16th edition suggests a + format such as this for presenting comments on blogs + or other online material. Note the sentence-style + capitalization in the title field, and the crossref + field which points to the blog to which the comment + is attached. The eventdate gives the date of the + comment, and if additional temporal specificity is + required then you can use the nameaddon field to + give a timestamp, inside parentheses.} +} + @Book{adorno:benj, title = {The Complete Correspondence, 1928--1940}, publisher = hup, @@ -810,6 +828,20 @@ from an online archive, both using a Video entry.} } +@Misc{coolidge:speech:trad, + author = {Coolidge, Calvin}, + title = {Equal rights (speech)}, + entrysubtype = {speech}, + note = {copy of an undated 78 rpm disc}, + addendum = {from \fullcite{loc:leaders}}, + year = {[1920?]}, + annotation = {This is a recording from an online archive, using a + Misc entry with an entrysubtype, and intended for + _authordate-trad only_. The addendum cites the + archive itself using an Online entry. + Cp. weed:flatiron and loc:city, which cite a film + from an online archive, both using a Video entry.}} + @Book{cotton:manufacture, title = {An Inquiry into the Causes of the Present Long-Continued Depression in the Cotton Trade, with @@ -1248,7 +1280,7 @@ } @Video{friends:leia, - title = {The One with the Princess Leia Fantasy}, + title = {The One with the {Princess Leia} Fantasy}, date = 2003, booktitle = {Friends}, booktitleaddon = {season~3, episode~1}, @@ -1443,7 +1475,7 @@ } @Audio{greek:filmstrip, - title = {The Greek and Roman World}, + title = {The {Greek} and {Roman} World}, date = 1977, publisher = {Society for Visual Education}, type = {filmstrip, 44 min\adddot}, @@ -1561,7 +1593,7 @@ @Online{harwood:biden, author = {Harwood, John}, - title = {The Pros and Cons of Biden}, + title = {The Pros and Cons of {Biden}}, organization = {\mkbibemph{New York Times} video, 2:00}, date = {2008-08-23}, url = {http://video.on.nytimes.com/?fr_story=a425c9aca92f51bd19f2a621fd93b5e266507191}, @@ -1678,7 +1710,7 @@ } @Online{horowitz:youtube, - title = {HOROWITZ AT CARNEGIE HALL 2-Chopin Nocturne in Fm Op.55}, + title = {{HOROWITZ AT CARNEGIE HALL} 2-{Chopin Nocturne} in Fm Op.55}, organization = {YouTube video, 5:53}, sortkey = {Horowitz}, url = {http://www.youtube.com/watch?v=cDVBtuWkMS8}, @@ -2064,7 +2096,7 @@ @Online{loc:leaders, author = {Library of Congress}, title = {American Leaders Speak}, - subtitle = {Recordings from World War I and the 1920 Election, + subtitle = {Recordings from {World War I} and the 1920 Election, 1918--1920}, year = {\isdot}, url = {http://memory.loc.gov/ammem/nfhtml/nforSpeakers01.html}, @@ -2294,7 +2326,7 @@ } @Music{mozart:figaro, - title = {Le nozze di Figaro}, + title = {Le nozze di {Figaro}}, howpublished = {\textsf{\small\textcircledP}}, date = {1987}, author = {Mozart, Wolfgang Amadeus}, @@ -2657,7 +2689,7 @@ @Online{pollan:plant, author = {Pollan, Michael}, - title = {Michael Pollan Gives a Plant's-Eye View}, + title = {Michael {Pollan} Gives a Plant's-Eye View}, organization = {TED video, 17:31}, url = {http://www.ted.com/index.php/talks/michael_pollan_gives_a_plant_s_eye_view.html}, urldate = {2008-02}, @@ -2823,6 +2855,20 @@ formatting of the title. Cp. coolidge:speech.} } +@Misc{roosevelt:speech:trad, + author = {Roosevelt, Eleanor}, + title = {Is {America} facing world leadership?}, + entrysubtype = {speech}, + note = {radio broadcast, Windows Media Audio, 47:46}, + titleaddon = {convocation speech, Ball State Teacher's College}, + url = {http://libx.bsu.edu/cdm4/item_viewer.php?CISOROOT=/ElRoos&CISOPTR=0&CISOBOX=1&REC=2}, + date = {1959-05-06}, + annotation = {Another speech from an online archive, presented in + a Misc entry with an entrysubtype, and intended for + _authordate-trad only_. Note the formatting of the + title. Cp. coolidge:speech.} +} + @MastersThesis{ross:thesis, author = {Ross, Dorothy}, title = {The {Irish-Catholic} Immigrant, 1880--1900}, @@ -2840,6 +2886,7 @@ @Article{rozner:liberation, journaltitle = {Voprosy istorii}, year = 1979, + entrysubtype = {magazine}, author = {Rozner, I.~G.}, title = {The War of Liberation of the {Ukrainian} People in 1648--1654 and {Russia}}, @@ -2848,16 +2895,15 @@ pages = {51--64}, annotation = {This is a Russian journal, with its issues defined not by volume number but by year. For the - notes+bibliography style you need a "magazine" - entrysubtype, but for author-date it's not required. - The journaltitle is in transliterated Russian, but - the article title is translated into English, hence - the original language must be provided in the - language field.} + 16th-edition style you need a "magazine" + entrysubtype. The journaltitle is in transliterated + Russian, but the article title is translated into + English, hence the original language must be + provided in the language field.} } @Music{rubinstein:chopin, - title = {The Chopin Collection}, + title = {The {Chopin} Collection}, date = 1991, author = {Rubinstein, Artur}, publisher = {RCA Victor/BMG}, @@ -2998,7 +3044,7 @@ @Misc{shapey:partita:15, author = {Shapey, Ralph}, - title = {Partita for Violin and Thirteen Players}, + title = {Partita for violin and thirteen players}, titleaddon = {score}, entrysubtype = {music}, date = 1966, |