summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/biblatex-chicago.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/biblatex-chicago.tex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/biblatex-chicago.tex126
1 files changed, 73 insertions, 53 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/biblatex-chicago.tex b/macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/biblatex-chicago.tex
index 96f26ac5ea..03f2413a32 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/biblatex-chicago.tex
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/biblatex-chicago.tex
@@ -26,10 +26,10 @@ filecolor=Teal]{hyperref}
% \usepackage[scaled=0.9]{ClearSans}
% \usepackage[p]{zlmtt}
% \usepackage{gentium}
-\setmainfont{GentiumPlus-R.ttf}[
-ItalicFont = GentiumPlus-I.ttf,
-BoldFont = GenBasB.ttf,
-BoldItalicFont = GenBasBI.ttf]
+\setmainfont{GentiumPlus-Regular.ttf}[
+ItalicFont = GentiumPlus-Italic.ttf,
+BoldFont = GentiumPlus-Bold.ttf,
+BoldItalicFont = GentiumPlus-BoldItalic.ttf]
\setsansfont{ClearSans-Regular.ttf}[
BoldFont = ClearSans-Bold.ttf,
ItalicFont = ClearSans-Italic.ttf,
@@ -117,7 +117,7 @@ HyphenChar={-}]
Style files for biblatex
\vspace{.3\baselineskip}
-\sffamily\normalsize\bfseries David Fussner\qquad Version 2.3\\
+\sffamily\normalsize\bfseries David Fussner\qquad Version 2.3a\\
\href{mailto:djf027@googlemail.com}{djf027@googlemail.com}\\ \today
\end{center}
@@ -150,6 +150,8 @@ HyphenChar={-}]
to let me know, and of course any suggestions for solving problems
more elegantly or accurately would be most welcome.}
+\enlargethispage{\baselineskip}
+
\mylittlespace\textbf{Important Note:} If you have used
\textsf{biblatex-chicago} before, especially if you've been using
anything earlier than version 2.0, please make sure you have read the
@@ -215,7 +217,7 @@ clickable link to an external document.
\begin{itemize}{}{}
\item The \textsf{biblatex} package, of course! The current version
- --- 3.18 at the time of writing --- has received extensive testing,
+ --- 3.18b 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:
@@ -223,7 +225,7 @@ clickable link to an external document.
\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.18 and
+ 2.18, to work with \textsf{biblatex} 3.18b and
\textsf{biblatex-chicago}; please note that any other backend will
not produce accurate results.
\item e-\TeX\ (required)
@@ -238,8 +240,11 @@ 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.2l).
+ Please upgrade to the latest version of \textsf{csquotes} (5.2n).
\end{itemize}
+\item The standard \textsf{expl3} and \textsf{xparse} packages are
+ loaded automatically for most users, and if they aren't
+ \textsf{biblatex-chicago} does it for you.
\item With recent changes both to \textsf{biblatex} and to
\textsf{biblatex-chicago}, \textsf{biblatex-chicago} itself now
requires two packages, which are both loaded for you if you load
@@ -1028,7 +1033,7 @@ the added fields \textsf{version} and \textsf{type} providing
information about the app's version and about the system on which it
runs (14.268; angry:birds).
-%\enlargethispage{-\baselineskip}
+%%\enlargethispage{-\baselineskip}
\mybigspace This \mymarginpar{\textbf{bookinbook}} type provides the
means of referring to parts of books that are considered, in other
@@ -1717,7 +1722,7 @@ wrongly-inherited fields. Other sorts of parent entries aren't
affected by this, and of course you must be using \textsf{Biber} for
the settings to apply.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace Should you wish to employ the new,
\textsf{maintitle}-first syntax, then you'll
@@ -1800,6 +1805,8 @@ mechanism's designed to save you some typing in common scenarios;
please see all of the (multifarious) details in
section~\ref{sec:related}, below.
+\enlargethispage{\baselineskip}
+
\paragraph*{\protect\mymarginpar{\textbf{online}}}
\label{sec:online}
@@ -1941,7 +1948,7 @@ deductively from the basic principles, I hope that the table might
simplify most of your choices. If something remains unclear, please
let me know and I'll see if I can improve it.
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mylittlespace A few more notes are in order. I designed the
\textsf{relatedtype} \texttt{commenton} to facilitate citation of
@@ -2000,7 +2007,7 @@ way, as it allows you to provide the initialisms that the
\textsf{timezone}, \textsf{urldate}, and \textsf{userd} in
section~\ref{sec:entryfields}, below.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mybigspace The \mymarginpar{\textbf{patent}} \emph{Manual} is very
brief on this subject (14.258), but very clear about which information
@@ -2567,7 +2574,7 @@ name given here exactly matches that of an editor and/or a translator,
then \textsf{biblatex-chicago-notes} will concatenate these fields in
the formatted references.
-%\enlargethispage{-\baselineskip}
+%%\enlargethispage{-\baselineskip}
\mylittlespace As noted above, however, this field has a special
meaning in the \textsf{suppbook} entry type, used to make an
@@ -2657,7 +2664,7 @@ present in the entry, but please remember to use the new option
latter doesn't work as smoothly and completely as \textsf{biblatex's}
own name toggles.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace This system of options, then, can turn off
\textsf{biblatex-chicago-notes}'s mechanism for finding a name to
@@ -2760,6 +2767,8 @@ entry type for introductions, forewords and afterwords
(\textsf{suppbook}) uses \textsf{bookauthor} as the author of
\textsf{title} (polakow:afterw, prose:intro).
+\enlargethispage{2\baselineskip}
+
\mybigspace This, \mymarginpar{\vspace{-8pt}\textbf{bookpagination}}
a standard \textsf{biblatex} field, allows you automatically to prefix
the appropriate string to information you provide in a \textsf{pages}
@@ -3038,7 +3047,7 @@ Please note that you can set both of these options either in the
preamble or in the \textsf{options} field of individual entries,
allowing you to change the settings on an entry-by-entry basis.
-\enlargethispage{2\baselineskip}
+%\enlargethispage{2\baselineskip}
\mylittlespace Please further note that in earlier releases of
\textsf{biblatex-chicago} I recommended against using
@@ -3422,7 +3431,7 @@ so these three fields now work more or less as they do in standard
abbreviated references to online content than conventional URLs,
though I can find no specific reference to them in the \emph{Manual}.
-% \enlargethispage{-\baselineskip}
+% %\enlargethispage{-\baselineskip}
\mybigspace This \mymarginpar{\textbf{eventdate}} is a standard
\textsf{biblatex} field which has gradually accumulated functions in
@@ -3530,7 +3539,7 @@ usually identify the university for which the thesis was written,
while in a \textsf{report} entry it may identify any sort of
institution issuing the report.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mybigspace As \mymarginpar{\textbf{introduction}} with the
\textsf{afterword} and \textsf{foreword} fields above,
@@ -3722,7 +3731,7 @@ this field to \textsf{article}, \textsf{periodical}, and
of those entry types in section~\ref{sec:entrytypes}, above, and also
table~\ref{tab:online:types} (14.208; amlen:hoot).
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mybigspace An \mymarginpar{\textbf{maintitleaddon}} annex to the
\textsf{maintitle}, for which see previous entry. Such an annex would
@@ -4157,7 +4166,7 @@ or enclose the whole name in additional braces. (See \emph{Manual}
14.133--41; aristotle:metaphy:gr, cohen:schiff, creasey:ashe:blast,
dunn:revolutions.)
-%\enlargethispage{.5\baselineskip}
+%%\enlargethispage{.5\baselineskip}
\mylittlespace There are, as one might expect, a few further
subtleties involved here. If you give two publishers in the field
@@ -4615,7 +4624,7 @@ assuming that such a \textsf{title} begins with a lowercase letter in
your .bib database. See\,\textbf{\textbackslash autocap} in
section~\ref{sec:formatcommands} below for more details.
-% \enlargethispage{-\baselineskip}
+% %\enlargethispage{-\baselineskip}
\mybigspace Standard \colmarginpar{\textbf{titleaddon}}
\textsf{biblatex} intends this field for use with additions to titles
@@ -4822,7 +4831,7 @@ entry in the bibliography to which the cross-reference will point.
(See 14.81--82; creasey:ashe:blast, creasey:morton:hide,
creasey:york:death, lecarre:quest.)
-%\enlargethispage{2\baselineskip}
+%%\enlargethispage{2\baselineskip}
\mybigspace The \mymarginpar{\textbf{userd}} \textsf{userd} field acts
as a sort of \enquote{\textsf{datetype}} field, allowing you in most
@@ -5098,7 +5107,7 @@ contrib:contrib, schweitzer:bach). \textbf{NB:} The \textsf{pubstate}
functionality currently has no equivalent using the \textsf{related}
field.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mybigspace This \mymarginpar{\textbf{related}} field is required to
use \textsf{biblatex's} \textsf{related} functionality, and it should
@@ -5737,6 +5746,8 @@ all entry types. There may be other places where \textsf{biblatex's}
standard styles support this feature, and I shall add them when they
come to my attention.
+\enlargethispage{\baselineskip}
+
\mybigspace These \mymarginpar{\textbf{\textbackslash
foottextcite\\\textbackslash foottextcites}} two commands look
like citation commands, but are in fact wrappers for customizing the
@@ -5758,8 +5769,6 @@ change the first to: \texttt{\{\textbackslash newcunit\textbackslash
\cmd{headlessparencite(s)} command if you want to retain the long
citations inside the parentheses.)
-\enlargethispage{\baselineskip}
-
\mybigspace I \mymarginpar{\textbf{\textbackslash letterdatelong}}
have provided this macro mainly for use in the optional postnote field
of the various citation commands. When citing a letter (published or
@@ -5992,7 +6001,7 @@ that \textsf{biblatex-chicago-notes} sets this command to use
the most common citation command you will use, and also works fine in
its multicite form, \textbf{\textbackslash autocites}.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mybigspace While \mymarginpar{\textbf{\textbackslash cite*}} the
\cmd{cite} command works just as you would expect it to, I have also
@@ -6492,7 +6501,7 @@ Please see the documentation of \textsf{shorthand} and
further options available to you for presenting and formatting these
two types of \texttt{biblist}.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace Formerly
\mymarginpar{\cmd{Declare-}\\\texttt{Labelname}} available only to
@@ -7435,7 +7444,7 @@ list. Please see the documentation of the \textbf{shorthand} field in
section~\ref{sec:entryfields} above for information on further options
available to you for presenting and formatting the list of shorthands.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace Chris Sparks \mymarginpar{\texttt{shorthandibid}}
pointed out that \textsf{biblatex-chicago-notes} would never use
@@ -7741,7 +7750,7 @@ Both will work, particularly because you don't need to worry too much
about capitalization because the word always appears after the
\verb+\bibstring{see}+.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace Now, it's perfectly possible for an introduction to
have numbered sections of its own, so a citation there may produce a
@@ -7990,7 +7999,7 @@ than the first, but in any case I'll start by explaining the automatic
provisions, then move on to the two handcrafted options, leaving you
to judge which seems best suited to your needs.
-%\enlargethispage{\baselineskip}
+%%\enlargethispage{\baselineskip}
\mylittlespace For \mymarginpar{\texttt{\textbf{split}}} the automatic
subdivision of an endnotes section I have borrowed a concept, if not
@@ -9057,7 +9066,7 @@ field helps \textsf{biblatex-chicago} know that the \textsf{audio}
entry is a podcast episode, and helps it construct the entry
appropriately (danforth:podcast).
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mybigspace This \mymarginpar{\textbf{book}} is the standard
\textsf{biblatex} and \textsc{Bib}\TeX\ entry type, but the package
@@ -9208,7 +9217,7 @@ entries by setting the \texttt{authortitle} option to \texttt{false}
either in individual entries or in the preamble for all examples of
the entry type.
-%\enlargethispage{\baselineskip}
+%%\enlargethispage{\baselineskip}
\mybigspace This \mymarginpar{\textbf{image}} entry type is now a
clone of the \textsf{artwork} type, which see. I retain it here for
@@ -9469,7 +9478,7 @@ date at all will be required for entries referring to entire archival
collections. In such entries, you may wish to use the word
\enquote{\texttt{classical}} as your \textsf{entrysubtype}, which will
have no effect on the list of references but will change the look of
-the in-text citations (house:papers). Instead of any date, the
+the in-text citations (house:\break papers). Instead of any date, the
citation will include the \textsf{title}, separated from the
\textsf{author's} name by a space, e.g., (House Papers). This same
arrangement, happily, allows you easily to cite individual books of
@@ -9875,7 +9884,7 @@ deductively from the basic principles, I hope that the table might
simplify most of your choices. If something remains unclear, please
let me know and I'll see if I can improve it.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace A few more notes are in order. I designed the new
\textsf{relatedtype} \texttt{commenton} to facilitate citation of
@@ -10166,7 +10175,7 @@ but if it's a fuller entry also containing an \textsf{author} then
you'll also need \texttt{useauthor=false} in the \textsf{options}
field. Other surplus fields will be ignored. (See osborne:poison.)
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace \textsf{Biblatex-chicago} also, at the behest of
Bertold Schweitzer, supports the \textsf{relatedtype}
@@ -10407,7 +10416,7 @@ entry, that is, in the \textsf{foreword}, \textsf{afterword}, or
\textsf{introduction} field. (See \emph{Manual} 14.110;
friedman:intro, polakow:afterw, prose:intro).
-%\enlargethispage{\baselineskip}
+%%\enlargethispage{\baselineskip}
\mybigspace This \mymarginpar{\textbf{suppcollection}} fulfills a
function analogous to \textsf{suppbook}. Indeed, I believe the
@@ -10481,7 +10490,7 @@ main guidelines:
provided here, and will be printed as-is, contextually capitalized.
(Cf.\ hitchcock:nbynw.)
\item[title, titleaddon, booktitle, booktitleaddon, maintitle:] As
- with the other two audiovisual types, \textsf{video} serves as an
+ with the other 2 audiovisual types, \textsf{video} serves as an
analogue both to books and to collections, so the \textsf{title} may
be of a whole film DVD or of a TV series, or it may identify one
episode in a series or one scene in a film. In the latter cases,
@@ -10730,7 +10739,7 @@ pseudonym, and also the package options \texttt{nameaddonformat} and
\texttt{nameaddonsep} in sections~\ref{sec:authuseropts} and
\ref{sec:authpreset}, below.
-%\enlargethispage{2\baselineskip}
+%%\enlargethispage{2\baselineskip}
\mylittlespace As its name suggests, the author-date style very much
wants to have a name of some sort present both for the entries in the
@@ -11657,7 +11666,7 @@ should ensure presents whichever of the two editors' names
(\textsf{namea} or \textsf{editor}) appears at the head of the
reference-list entry.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace In \textsf{biblatex} 0.9 Lehman reworked the string
concatenation mechanism, for reasons he outlines in his RELEASE file,
@@ -11928,7 +11937,7 @@ undefined) to make an introduction the focus of a citation.
field, for providing the International Standard Book Number of a
publication. Not typically required by the \emph{Manual}.
-%\enlargethispage{-2\baselineskip}
+%%\enlargethispage{-2\baselineskip}
\mybigspace Standard \mymarginpar{\textbf{isrn}} \textsf{biblatex}
field, for providing the International Standard Technical Report
@@ -12388,7 +12397,7 @@ organization sponsoring a conference in a \textsf{proceedings} or
\textsf{inproceedings} entry, and I have retained this as a
possibility, though the \emph{Manual} is silent on the matter.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mybigspace This \mymarginpar{\textbf{origdate}} is a standard
\textsf{biblatex} field which allows more than one full date
@@ -12555,7 +12564,7 @@ appropriate identifying string to information you provide in the
all the details on this functionality, as aside from the difference
just mentioned the two fields are equivalent.
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mybigspace Standard \mymarginpar{\textbf{part}} \textsf{biblatex}
field, which identifies physical parts of a single logical volume in
@@ -12664,7 +12673,7 @@ purposes. Cf.\ \textsf{annotator} and \textsf{commentator}.
\mybigspace See \mymarginpar{\textbf{reprinttitle}}
section~\ref{sec:authrelated}, below.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mybigspace A \mymarginpar{\textbf{series}} standard \textsf{biblatex}
field, usually just a number in an \textsf{article},
@@ -12770,7 +12779,7 @@ parseable by them, while with the latter you can either rely on the
conventions of your field or, alternately, provide a list of journal
abbreviations using \cmd{printbiblist\{shortjournal\}}.
-% \enlargethispage{-\baselineskip}
+% %\enlargethispage{-\baselineskip}
\mylittlespace For long institutional names the \emph{Manual's}
recommendation (15.37) involves using an abbreviation which will
@@ -13100,7 +13109,7 @@ serve to clarify them, and help you to understand when
\textsf{biblatex-chicago-authordate-trad} might need your help in
order to comply with them.
-%\enlargethispage{2\baselineskip}
+%%\enlargethispage{2\baselineskip}
\mylittlespace With regard to sentence-style capitalization, the rules
of the Chicago \textsf{authordate-trad} style are fairly simple:
@@ -13415,7 +13424,7 @@ part of an \textsf{urldate}. The \emph{Manual} prefers initialisms
like \enquote{EST} for this purpose, and you can provide parentheses
around it at your discretion (cp.\ 10.41 and 14.191).
-%\enlargethispage{\baselineskip}
+%%\enlargethispage{\baselineskip}
\mybigspace A \mymarginpar{\textbf{usera}} supplemental
\textsf{biblatex} field which in certain contexts in
@@ -13973,7 +13982,7 @@ Now, the Chicago-specific types:
and \textsf{review} entries (along with the latter's clone,
\textsf{suppperiodical}).
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
In \textsf{article} entries it replaces the \textsf{titleaddon} with
the \textsf{relatedstring} followed by the \textsf{title} of the
@@ -14547,7 +14556,7 @@ when presenting date ranges. The new style option
now compressed automatically according to the \emph{Manual's}
instructions (9.64; section~\ref{sec:authpreset}).
-\enlargethispage{\baselineskip}
+\enlargethispage{-\baselineskip}
\mylittlespace In \mymarginpar{\texttt{alltimes=12h}} entries which
print time stamps, they will, when the stamp is part of a
@@ -14617,7 +14626,7 @@ or whole spreads in twoside mode.
minor problem with punctuation in titles, ensuring that the colon
between a title and a subtitle appears in the correct, matching font.
-\enlargethispage{-\baselineskip}
+%\enlargethispage{-\baselineskip}
\mylittlespace This \mymarginpar{\texttt{related=true}} is the
standard \textsf{biblatex} bibliography option, and it enables the use
@@ -14701,6 +14710,8 @@ class, which I believe has its own commands for defining these
parameters. You can also disable it by using the \texttt{footmarkoff}
package option, on which see below.
+\enlargethispage{\baselineskip}
+
\mylittlespace Gildas Hamel pointed out that my default definition, in
\textsf{biblatex-chicago.sty}, of \textsf{biblatex's}
\cmd{bibnamedash} didn't work well with many fonts, leaving a line of
@@ -14817,7 +14828,7 @@ per-entry basis in the \textsf{options} field (though rather than use
this latter method it would make sense to eliminate the \textsf{pages}
field from the affected entries).
-\enlargethispage{\baselineskip}
+%\enlargethispage{\baselineskip}
\mylittlespace This \colmarginpar{\texttt{doi=true}} option controls
whether any \textsf{doi} fields present in the .bib file will be
@@ -15670,7 +15681,7 @@ which I haven't extensively tested, so I'm labeling this option
\textsf{postnote} field of citation commands, not the \textsf{pages}
field in your .bib file.
-% \enlargethispage{\baselineskip}
+% %\enlargethispage{\baselineskip}
\mylittlespace This \mymarginpar{\texttt{seriesabbrev}} option
controls the printing, in the reference list, of the
@@ -16164,7 +16175,7 @@ public and legal material.
commercial electronic database, of a legislative publication. It
will be associated with the \textsf{date} in long notes but won't
appear in short ones. (Cf.\ congress:debate:new and
- state:statute:ky.)%\enlargethispage{\baselineskip}
+ state:statute:ky.)%%\enlargethispage{\baselineskip}
\item[addendum] You can use this field to specify the speaker at
hearings or in debates, the Canadian or British jurisdiction of some
laws if not otherwise clear from the citation, or possibly simply
@@ -16759,7 +16770,16 @@ do my best to fix them.
\section{Revision History}
\label{sec:history}
-\textbf{2.3: Released \today}
+\textbf{2.3a: Released \today}
+
+\mylittlespace This release backports a bug-fix from the most recent
+\LaTeX 3 programming layer. If you are using \textsf{biblatex} 3.18b
+and an older L3 layer then the processing of your documents could fail
+and fall into an infinite loop, leaving behind an inscrutable message
+in your log file. This update should prevent that, and also fixes a
+few other minor glitches.
+
+\mybigspace\textbf{2.3: Released July 2, 2022}
\mylittlespace All styles require the current \textsf{biblatex} (3.18)
and \textsf{biber} (2.18).
@@ -18246,7 +18266,7 @@ 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.%%\enlargethispage{-2\baselineskip}
+ 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.