diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex | 75 |
1 files changed, 55 insertions, 20 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex index 03f2413a321..4d5632861e1 100644 --- a/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex +++ b/Master/texmf-dist/doc/latex/biblatex-chicago/biblatex-chicago.tex @@ -117,7 +117,7 @@ HyphenChar={-}] Style files for biblatex \vspace{.3\baselineskip} -\sffamily\normalsize\bfseries David Fussner\qquad Version 2.3a\\ +\sffamily\normalsize\bfseries David Fussner\qquad Version 2.3b\\ \href{mailto:djf027@googlemail.com}{djf027@googlemail.com}\\ \today \end{center} @@ -217,15 +217,16 @@ clickable link to an external document. \begin{itemize}{}{} \item The \textsf{biblatex} package, of course! The current version - --- 3.18b at the time of writing --- has received extensive testing, + --- 3.20 at the time of writing --- has received extensive testing, and contains features and bug fixes upon which my code relies. - Please don't use any earlier version. \textsf{Biblatex} requires - several packages, and it strongly recommends several more: + Earlier versions may work, but I recommend the latest. + \textsf{Biblatex} requires several packages, and it strongly + recommends several more: \begin{itemize}{}{} \item \textsf{biber} --- the next-generation \textsc{Bib}\TeX\ replacement by Philip Kime and Fran\c{c}ois Charette, available from SourceForge (required). You should use the latest version, - 2.18, to work with \textsf{biblatex} 3.18b and + 2.20, to work with \textsf{biblatex} 3.20 and \textsf{biblatex-chicago}; please note that any other backend will not produce accurate results. \item e-\TeX\ (required) @@ -240,7 +241,7 @@ clickable link to an external document. \item \textsf{babel} --- a standard package (\emph{strongly} recommended) \item \textsf{csquotes} --- available from CTAN (recommended). - Please upgrade to the latest version of \textsf{csquotes} (5.2n). + Please upgrade to the latest version of \textsf{csquotes} (5.2o). \end{itemize} \item The standard \textsf{expl3} and \textsf{xparse} packages are loaded automatically for most users, and if they aren't @@ -436,7 +437,7 @@ clickable link to an external document. \subsection{License} \label{sec:lppl} -Copyright \copyright\ 2008--2022 David Fussner. This package is +Copyright \copyright\ 2008--2024 David Fussner. This package is author-maintained. This work may be copied, distributed and/or modified under the conditions of the \LaTeX\ Project Public License, either version 1.3 of this license or (at your option) any later @@ -13147,19 +13148,18 @@ 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: -\mylittlespace\hspace*{1em}\texttt{title = \{}\cmd{bibstring\{reviewof\}} +\mylittlespace\hspace*{1em}\texttt{title = \{review of} \cmd{mkbibemph\{The Chicago manual of style\}\}} -\mylittlespace (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 (As\colmarginpar{\textsf{biblatex} 3.20} an aside, a +\cmd{bibstring} at the start of a title field no longer works as it +used to in the \textsf{trad} style, due to changes in the handling of +the \cmd{MakeSentenceCase} command. You can still use them if you set +the \texttt{casechanger} option to \texttt{latex2e}, but otherwise you +can just provide the actual string, as here. The lowercase letter at +the start isn't strictly necessary unless you're going to cite the +work by title instead of by author-date. [Compare the notes \&\ +bibliography style, and also the \textsf{*titleaddon} fields.]) \mylittlespace With regard to italics, the rules of \textsf{biblatex-chicago-authordate-trad} are as follows: @@ -16525,6 +16525,7 @@ to a specific naming scheme. You'll need at least: \begin{verbatim} \DeclareSortingNamekeyTemplate[<templatename>]{<specification>} \DeclareUniquenameTemplate[<templatename>]{<specification>} +\DeclareNamehashTemplate[<templatename>]{<specification>} \newbibmacro*{name:<templatename>}[<no. of nameparts as digit>]{<code>} \csdef{cmssort:<templatename>}{\usebibmacro{name:<templatename>}...} \csdef{cmslabel:<templatename>}{...\usebibmacro{name:<templatename>}...} @@ -16541,13 +16542,14 @@ then you'll also need: \end{verbatim}} If you want to be able to use the your new template name as the -default template, you'll need to wrap the first two declarations like +default template, you'll need to wrap the first three declarations like so: {\small \begin{verbatim} \cms@template@wrapper{\DeclareSortingNamekeyTemplate}[<templatename>]{<spec>} \cms@template@wrapper{\DeclareUniquenameTemplate}[<templatename>]{<spec>} +\cms@template@wrapper{\DeclareNamehashTemplate}[<templatename>]{<spec>} \end{verbatim}} If your specification requires new name parts, you can copy @@ -16752,6 +16754,13 @@ title, particularly Unicode ones. If you are using set of curly braces \{\}\ at the start of the field, but I shall look into this further. +\mylittlespace Please\colmarginpar{\textsf{biblatex} 3.20} note, also, +that in the \textsf{authordate-trad} style you can no longer by +default use a \cmd{bibstring} at the start of a \textsf{title} field, +due to the case-changing code in \cmd{MakeSentenceCase}. You can +either set \texttt{casechanger=latex2e} in the preamble or just write +the string you need in the\ .bib file. + \mylittlespace Patrick Danilevici's Romanian localization (\textsf{cms-romanian.lbx}) required some fairly extensive changes to the basic package code, so it's possible that I could improve the @@ -16770,7 +16779,33 @@ do my best to fix them. \section{Revision History} \label{sec:history} -\textbf{2.3a: Released \today} +\textbf{2.3b: Released \today} + +\mylittlespace This is an interim bug-fix release, mainly to address +the following breaking change: + +\begin{itemize} +\item The most recent \textsf{biblatex} (3.20) has added a new name + template (\mycolor{\cmd{DeclareNamehashTemplate}}) for users + requiring non-Western name handling in their reference apparatus, so + if you use \textsf{biblatex-chicago's} \texttt{cmsnameparts} option + then running \textsf{biber} will fail and \LaTeX\ will not process + your documents. This update should rectify that, while still being + compatible with earlier versions of \textsf{biblatex}. Thanks to + Philipp Immel for alerting me. +\item I have also added a package-specific definition of the standard + citation command \cmd{citetitle} to the author-date styles, as the + standard definition sometimes fails there. Thanks to Geoffery Zheng + for reporting this. +\item Users of the \textsf{authordate-trad} style may need to remove + some \cmd{bibstring} commands from the start of \textsf{title} + fields in their\ .bib files, or else set the \textsf{biblatex} + option \texttt{casechanger=latex2e}. Please see + section~\ref{sec:bugs} or section~\ref{sec:fields:authdate}, s.v.\ + \textsf{title}. +\end{itemize} + +\textbf{2.3a: Released November 11, 2022} \mylittlespace This release backports a bug-fix from the most recent \LaTeX 3 programming layer. If you are using \textsf{biblatex} 3.18b |