diff options
Diffstat (limited to 'Master/texmf-dist/doc')
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/CHANGES.md | 57 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/README.md | 2 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.bib | 69 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.pdf | bin | 409884 -> 425304 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.tex | 862 |
5 files changed, 605 insertions, 385 deletions
diff --git a/Master/texmf-dist/doc/latex/windycity/CHANGES.md b/Master/texmf-dist/doc/latex/windycity/CHANGES.md index 45050c65fcf..cf718404ab0 100644 --- a/Master/texmf-dist/doc/latex/windycity/CHANGES.md +++ b/Master/texmf-dist/doc/latex/windycity/CHANGES.md @@ -8,21 +8,59 @@ indicate updates to Windy City's [repository on GitHub](https://github.com/brianchase/windycity "GitHub: brianchase/windycity"). +## 2020-11-10 + +* added support for updaters, which, like other editorial roles, you + can combine with any other role: + + - updated by... + - updated and compiled by... + - updated and edited by... + - updated and revised by... + - updated and translated by... + - compiled and updated by... + - edited and updated by... + - revised and updated by... + - translated and updated by... + +* when editors and translators are the same, and you haven't set the + `swaptrans` entry option, the value of the `editortype` field + determines which role goes first (example: `transrev` prints + "translated and revised by" without needing `swaptrans`) +* dropped the `anonauth` and `anonqauth` entry options; instead, use + the `authortype` field with values `anon` and `anon?`, respectively +* in addition to anonymous authors, `authortype` can handle some + pseudonymous authors with the value `pseudo` (the `nameaddon` field + still works for this and, in fact, remains the only way to list a + pseudonymous author's given name) +* added a `nopages` bibliography option to stop automatic printing of + the `pages` field on first citations of `@article` and `@review` + entries (and their aliases) when the `postnote` is blank +* added support for the `\fullcite` and `\footfullcite` citation + commands +* new citation commands: `idemcite`, `idemcites`, `footidemcite`, + `footidemcites` +* added support for printing ISSNs with `issn` entry and bibliography + options +* fixed `nameaddon` and `handle` fields printing in short citations +* fixed `autopunct` when `\footcites` follows `\cite` plus an + `autopunct` mark (e.g. `\cite{key1}?\footcites{key2}{key3}`) + ## 2020-09-29 * better punctuation handling in parenthetical citations, allowing -examples in *CMOS* 15.24 and 15.30 (17th ed.) + examples in *CMOS* 15.24 and 15.30 (17th ed.) * for `@reference` and `@inreference` entries, added support for -printing the `organization` field in the author's position of short -citations, fixing many of them (most of them? it was bad!) + printing the `organization` field in the author's position of short + citations, fixing many of them (most of them? it was bad!) * also for `@reference` and `@inreference` entries, allowed the -`author` field to substitute for `organization` (not recommended but -could prevent confusion in some cases) + `author` field to substitute for `organization` (not recommended but + could prevent confusion in some cases) * fixed `\cites` and `\parencites` for consecutive citations of the -same author (most seriously affecting parenthetical citations but also -standard and short citations in different ways) + same author (most seriously affecting parenthetical citations but + also standard and short citations in different ways) * fixed parenthetical citations not printing volume numbers for -certain collections + certain collections ## 2020-09-07 @@ -58,7 +96,8 @@ certain collections types * fixed `\parencite` failing to print names in `afterwords`, `forewords`, and `introduction` fields -* fixed printing `transcomp` and `transed` bibstrings when + +* fixed printing `transcomp` and `transed` bibliography strings when `transcomp+` and `transed+` were needed ## 2019-07-17 diff --git a/Master/texmf-dist/doc/latex/windycity/README.md b/Master/texmf-dist/doc/latex/windycity/README.md index f4c5df8cab1..a2ad25cd127 100644 --- a/Master/texmf-dist/doc/latex/windycity/README.md +++ b/Master/texmf-dist/doc/latex/windycity/README.md @@ -34,9 +34,9 @@ you might be able to skip this step. Windy City consists of four files: -* [windycity.dbx](https://github.com/brianchase/windycity/blob/master/windycity.dbx "windycity.dbx") * [windycity.bbx](https://github.com/brianchase/windycity/blob/master/bbx/windycity.bbx "windycity.bbx") * [windycity.cbx](https://github.com/brianchase/windycity/blob/master/cbx/windycity.cbx "windycity.cbx") +* [windycity.dbx](https://github.com/brianchase/windycity/blob/master/windycity.dbx "windycity.dbx") * [american-windycity.lbx](https://github.com/brianchase/windycity/blob/master/lbx/american-windycity.lbx "american-windycity.lbx") If you need to install Windy City on your system, you have several diff --git a/Master/texmf-dist/doc/latex/windycity/windycity.bib b/Master/texmf-dist/doc/latex/windycity/windycity.bib index ebbdc035299..9a7b80d5fcc 100644 --- a/Master/texmf-dist/doc/latex/windycity/windycity.bib +++ b/Master/texmf-dist/doc/latex/windycity/windycity.bib @@ -287,6 +287,70 @@ pages = {22–69} } +% 14.57 Several citations in one note + +@Article{sutton1959, + author = {Sutton, Walter}, + title = {The Analysis of Free Verse Form, Illustrated by a Reading of Whitman}, + journal = {Journal of Aesthetics and Art Criticism}, + volume = {18}, + number = {2}, + date = {1959-12}, + pages = {241-54} +} +@InCollection{fussell1962, + author = {Fussell, Paul}, + title = {Whitman's Curious Warble}, + subtitle = {Reminiscence and Reconciliation}, + pages = {28-51}, + crossref = {lewis1962} +} +@Collection{lewis1962, + title = {The Presence of Walt Whitman}, + editor = {Lewis, R. W. B.}, + address = {New York}, + publisher = {Columbia University Press}, + year = {1962}, +} +@Article{coffman1954, + author = {Coffman, S. K.}, + title = {`Crossing Brooklyn Ferry'}, + subtitle = {A Note on the Catalog Technique in Whitman's Poetry}, + journal = {Modern Philology}, + volume = {51}, + number = {4}, + date = {1954-05}, + pages = {225-32} +} +@Article{coffman1955, + author = {Coffman, S. K.}, + title = {Form and Meaning in Whitman's `Passage to India'}, + journal = {PMLA}, + volume = {70}, + number = {3}, + date = {1955-06}, + pages = {337-49} +} +@Article{rountree1958, + author = {Rountree, Thomas I.}, + title = {Whitman's Indirect Expression and Its Application to `Song of Myself'}, + journal = {PMLA}, + volume = {73}, + number = {5}, + date = {1958-12}, + pages = {549-55} +} +@Article{lovell1960, + author = {Lovell, John}, + title = {Appreciating Whitman}, + subtitle = {'Passage to India'}, + journal = {Modern Language Quarterly}, + volume = {21}, + number = {2}, + date = {1960-06}, + pages = {131-41} +} + % 14.59 Abbreviations for frequently cited works @Collection{shurtleff1853, @@ -455,15 +519,15 @@ year = {1547} } @Book{horsley1796, - options = {anonauth}, author = {Horsley, Samuel}, + authortype = {anon}, title = {On the Prosodies of the Greek and Latin Languages}, address = {London}, year = {1796} } @Book{hawkes1834, - options = {anonqauth}, author = {Hawkes, James}, + authortype = {anon?}, title = {A Retrospect of the Boston Tea-Party, with a Memoir of George R. T. Hewes}, note = {by a Citizen of New-York}, address = {New-York}, @@ -475,6 +539,7 @@ @Online{akmuckraker2008, author = {{AK Muckraker}}, +% authortype = {pseudo},% alternative nameaddon = {pseud.}, title = {Palin Is Back at Work}, blogtitle = {Mudflats}, diff --git a/Master/texmf-dist/doc/latex/windycity/windycity.pdf b/Master/texmf-dist/doc/latex/windycity/windycity.pdf Binary files differindex fe729f964a2..82c61cb5a59 100644 --- a/Master/texmf-dist/doc/latex/windycity/windycity.pdf +++ b/Master/texmf-dist/doc/latex/windycity/windycity.pdf diff --git a/Master/texmf-dist/doc/latex/windycity/windycity.tex b/Master/texmf-dist/doc/latex/windycity/windycity.tex index 6bd738fd12b..e69a97ac386 100644 --- a/Master/texmf-dist/doc/latex/windycity/windycity.tex +++ b/Master/texmf-dist/doc/latex/windycity/windycity.tex @@ -1,14 +1,14 @@ -% Last modified: Tue 29 Sep 2020 05:38:35 PM CDT +% Last modified: Tue 10 Nov 2020 05:20:31 PM CST \documentclass[11pt,letterpaper,oneside]{article} \usepackage{windycity} \begin{document} \title{Windy City} \subtitle{A Chicago Style for \texttt{\biblatex}} -\author{Brian Michael Chase} +\author{Brian Chase} \email{brianmichaelchase@gmail.com} \website{https://github.com/brianchase/windycity} -\version{2020-09-29} +\version{2020-11-10} \maketitle \begingroup \hypersetup{linkcolor=black} @@ -17,11 +17,11 @@ \section{Introduction} -\nfootnote{Copyright \textcopyright\ 2014--2020 Brian Michael Chase. -Under the terms of the \LaTeX\ Project Public License, version 1.3, -permission is granted to copy, distribute, or modify this software. -See \url{http://www.ctan.org/tex-archive/macros/latex/base/lppl.txt} -or \url{https://www.latex-project.org/lppl/}.} +\nfootnote{Copyright \textcopyright\ 2014--2020 Brian Chase. Under the +terms of the \LaTeX\ Project Public License, version 1.3, permission +is granted to copy, distribute, or modify this software. See +\url{http://www.ctan.org/tex-archive/macros/latex/base/lppl.txt} or +\url{https://www.latex-project.org/lppl/}.} Windy City is a style for \biblatex that formats notes, bibliographies, parenthetical citations, and reference lists according @@ -29,9 +29,9 @@ to the 17th edition of \textit{The Chicago Manual of Style} (\textit{CMOS}).\footnote{\cite{chicago2017}} It accurately handles a wide range of citations in different formats and includes a set of options and commands to support special circumstances. It also has -extensive support for citing and arranging different kinds of editors, -translators, compilers, and revisers within a single citation. These -features make Windy City especially suitable for academic work. +extensive support for citing and arranging different kinds of editors +and translators within a single citation. These features make Windy +City especially suitable for academic work. The following sections assume familiarity with \textit{CMOS} and \biblatex. Section \ref{overview} gives a brief overview of the @@ -50,7 +50,7 @@ Windy City requires \biblatex version 3.13 or later. This section covers basic information about Windy City. If you're completely new to \biblatex, you should probably glance at its -documentation. For the impatient, examples in sections \ref{default}, +documentation. For the impatient, examples in sections \ref{standard}, \ref{short}, \ref{notes}, and \ref{paren} might be of more immediate interest. @@ -71,9 +71,9 @@ GitHub}.\endgroup Windy City consists of four files: \begin{itemize}[before=\small] -\item \file{windycity.dbx} \item \file{windycity.bbx} \item \file{windycity.cbx} +\item \file{windycity.dbx} \item \file{american-windycity.lbx} \end{itemize} @@ -96,28 +96,28 @@ its style files. The localization file \file{american-windycity.lbx} is responsible for Windy City's American-style punctuation and dates and many of the -bibliography strings that appear in citations, such as \textit{edited +bibliography strings that print in citations, such as \textit{edited by}. Windy City loads this file if \biblatex determines that your -document's language is English---either due to settings in \sty{babel} -or \sty{polyglossia} or because neither \sty{babel} nor -\sty{polyglossia} has been loaded. You can prevent Windy City from -loading \file{american-windycity.lbx} by commenting the following line -in \file{windycity.bbx}: +document's language is English---either due to settings in \babel or +\polyglossia or because neither \babel nor \polyglossia has been +loaded. You can prevent Windy City from loading +\file{american-windycity.lbx} by commenting the following line in +\file{windycity.bbx}: \begin{verbatim} \DeclareLanguageMapping{english}{american-windycity} \end{verbatim} If you wish to use Windy City with a language other than English, set -it accordingly with \sty{babel} or \sty{polyglossia} before loading -\biblatex. Windy City will then try to load -\file{<language>-windycity.lbx} and, if it's available, use it to -override any other localization files that were loaded. This allows -you to make your own localization files for Windy City without needing -to edit other files. For example, if you load \sty{babel} with option -\sty{german}, Windy City will try to load \file{german-windycity.lbx}. -If it's available, it will override any other localization files that -were loaded, including \biblatex's own \file{german.lbx}. +it accordingly with \babel or \polyglossia before loading \biblatex. +Windy City will then try to load \file{<language>-windycity.lbx} and, +if it's available, use it to override any other localization files +that were loaded. This allows you to make your own localization files +for Windy City without needing to edit other files. For example, if +you load \babel with option \sty{german}, Windy City will try to load +\file{german-windycity.lbx}. If it's available, it will override any +other localization files that were loaded, including \biblatex's own +\file{german.lbx}. For some entries in your bibliography database, you may need to add fields or make other adjustments to get the right output. But since @@ -128,10 +128,10 @@ bibliography database, \file{windycity.bib}, should serve as a guide for how to manage your input for nearly every circumstance that the style is meant to handle. -\subsection{The Default Format} -\label{default} +\subsection{Standard Citations} +\label{standard} -For a first set of examples, consider a passage from \textit{CMOS} +For a first set of examples, consider this passage from \textit{CMOS} \ref{14.30}: \begin{citeonly} @@ -143,18 +143,16 @@ For a first set of examples, consider a passage from \textit{CMOS} \item \cite[189--90]{kaiser1964} \end{citeonly} -The output shows Windy City's default format. The first citation of a -work is similar to its entry in the bibliography. It includes all or -most of its bibliographic information. Subsequent citations are -shorter, usually consisting of a short form of the author's name and a -short form of the work's title. +A work's first citation is similar to its entry in the bibliography. +It includes all or most of its bibliographic information. Subsequent +citations are shorter, usually consisting of a short form of the +author's name and a short form of the work's title. Windy City supports variations on this format. For information on -short forms of citations, including the use of \textit{ibid.}, see -section \ref{short}. For options to skip parts of citations, change -the order of editors and translators, and more, see sections -\ref{preops} and \ref{entryops}. For parenthetical citations, see -section \ref{paren}. +short citations, including the use of \textit{ibid.}, see section +\ref{short}. For options to skip parts of citations, change the order +of editors and translators, and more, see sections \ref{preamble} and +\ref{entry}. For parenthetical citations, see section \ref{paren}. The block below shows Windy City's default bibliography for the previously cited works: @@ -163,8 +161,9 @@ previously cited works: \nocite{kaiser1964,morley1995,schwartz1992} \end{bibonly} -\noindent You may also print a bibliography in the author-date format, -what \textit{CMOS} calls a reference list: +You may also print a bibliography in the author-date format (what +\textit{CMOS} calls a reference list). The key difference is the +placement of the publication date after the author's name: \begin{refonly} \nocite{kaiser1964,morley1995,schwartz1992} @@ -177,7 +176,7 @@ To make \cmd{printbibliography} use the author-date format, load \usepackage[reflist,style=windycity]{biblatex} \end{verbatim} -\noindent Note that \opt{reflist=true} has the same effect: +\noindent Alternatively: \begin{verbatim} \usepackage[reflist=true,style=windycity]{biblatex} @@ -187,17 +186,17 @@ To use the author-date format on a case-by-case basis, run \cmd{printbibliography} with an appropriate \opt{env} option. With Windy City, a so-called ``bib environment'' must set the style's internal \opt{reflist} toggle to \opt{true}. Windy City's own such -environment is called \opt{reflist}, which you may use as follows: +environment is called \opt{reflist}. Use it as follows: \begin{verbatim} \printbibliography[env=reflist] \end{verbatim} -\noindent Unfortunately, while the \opt{env} option allows for -differently formatted bibliographies within the same document, the -reference lists may have problems with sorting. (You'll notice some in -\ref{ref}, at the end of this document.) For best results, use the -\opt{reflist} preamble option. +Unfortunately, while the \opt{env} option allows for differently +formatted bibliographies within the same document, the reference lists +may have problems with sorting. (You'll notice some in \ref{ref}, at +the end of this document.) For best results, use the \opt{reflist} +preamble option. As you proceed through the this guide, note that all examples of citations and bibliographies are outputs of the style from commands @@ -206,75 +205,81 @@ and in its style file, \file{windycity.sty}. Almost all citations are from \cmd{cite} or \cmd{parencite}. A few are from more specialized commands, such as \cmd{cite*} or \cmd{cites}. All example bibliographies are outputs of the style from \cmd{printbibliography}. -All bibliographic data resides in \file{windycity.bib}. +All bibliographic data reside in \file{windycity.bib}. \subsection{Short Citations} \label{short} -Aside from the author-date format, \textit{CMOS} offers scant -documentation of alternative formats. Nevertheless, there are -alternatives. Consider this example from \textit{CMOS} -\ref{14.34}:\footnote{Switching formats within a document isn't a -feature of the style. For demonstration purposes, though, it's -possible.} +Standard citations may take a variety of shorter forms. Windy City +offers several preamble options and other means for reproducing them. + +Let's start with another passage of default output: \begin{citeonly} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} \item \cite[3]{morrison2004a} -\AtNextCitekey{\toggletrue{short}} \item \cite[18]{morrison2004a} -\AtNextCitekey{\toggletrue{short}} \item \cite[18]{morrison2004a} -\AtNextCitekey{\toggletrue{short}} \item \cite[24--26]{morrison2004a} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} \item \cite[401-2]{morrison2004b} -\AtNextCitekey{\toggletrue{short}} \item \cite[433]{morrison2004b} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} \item \cite[37--38]{diaz2008} -\AtNextCitekey{\toggletrue{short}} \item \cite[403]{morrison2004b} -\AtNextCitekey{\toggletrue{short}} \item \cite[152]{diaz2008} -\AtNextCitekey{\toggletrue{short}} \item \cite[201-2]{diaz2008} -\AtNextMultiCite{\toggletrue{short}} \item \cites[240]{morrison2004b}[32]{morrison2004a} -\AtNextCitekey{\toggletrue{short}} \item \cite[33]{morrison2004a} \end{citeonly} -\noindent Compare that with the style's default output: +A shorter form of this passage appears in \textit{CMOS} +\ref{14.34}:\footnote{Switching forms within a document isn't a +feature of the style. For demonstration purposes, though, it's +possible.} + +% The use of 'firstshort' below might be confusing. It's necessary to +% simulate the effect of 'short' within a document that otherwise +% gives default output. \begin{citeonly} +\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} \item \cite[3]{morrison2004a} +\AtNextCitekey{\toggletrue{short}} \item \cite[18]{morrison2004a} +\AtNextCitekey{\toggletrue{short}} \item \cite[18]{morrison2004a} +\AtNextCitekey{\toggletrue{short}} \item \cite[24--26]{morrison2004a} +\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} \item \cite[401-2]{morrison2004b} +\AtNextCitekey{\toggletrue{short}} \item \cite[433]{morrison2004b} +\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} \item \cite[37--38]{diaz2008} +\AtNextCitekey{\toggletrue{short}} \item \cite[403]{morrison2004b} +\AtNextCitekey{\toggletrue{short}} \item \cite[152]{diaz2008} +\AtNextCitekey{\toggletrue{short}} \item \cite[201-2]{diaz2008} +\AtNextMultiCite{\toggletrue{short}} \item \cites[240]{morrison2004b}[32]{morrison2004a} +\AtNextCitekey{\toggletrue{short}} \item \cite[33]{morrison2004a} \end{citeonly} -\noindent In the short format, a work's first citation gives short -names and titles and omits all other publication information. -Consecutive citations of a work may omit the title or, as in the -eleventh note, where the title is the key mark of distinction, the -author's name. To use this format, start \biblatex with the preamble -option \opt{short}. See section \ref{preops} for more information. - -\textit{CMOS} \ref{14.34} also shows how to render the passage above -with \textit{ibid.} Unlike previous editions of \textit{CMOS}, the -17th edition discourages its use. As such, \textit{ibid.} is no longer -part of Windy City's default format. Enable it with the preamble -option \opt{ibid} (again, see section \ref{preops}). Options -\opt{short} and \opt{ibid} together give the following: +In this version, a work's first citation gives short names and titles +and omits all other publication information. Consecutive citations of +a work may omit the title or, as in the eleventh note, the author's +name. For citations in this form, use the preamble option \opt{short}. +See section \ref{preamble} for more information. + +\textit{CMOS} \ref{14.34} also shows how to render the passage with +\textit{ibid.} Unlike previous editions of \textit{CMOS}, the 17th +edition discourages its use. Windy City makes it available with the +preamble option \opt{ibid} (see section \ref{preamble}). Options +\opt{short} and \opt{ibid} together give the following:\footnote{As +explained in section \ref{preamble}, Windy City won't print +\textit{ibid.} in reference to a citation on a previous page. A page +break here may affect the output.} \begin{citeonly} \AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}\toggletrue{ibid}} @@ -303,19 +308,20 @@ option \opt{ibid} (again, see section \ref{preops}). Options \item \cite[33]{morrison2004a} \end{citeonly} -Other ways to make citations more concise: In the default format, you -can use the preamble option \opt{firstshort} to swap long first -citations for short ones (see section \ref{preops}). Also in the -default format, you can use the preamble option \opt{idemtracker} to -shorten the author's name in the first citation if the previous -citation is of the same author (see section \ref{preops}). The entry -option \opt{noauth} omits the author's name altogether (see section -\ref{entryops}). And the \bibfield{shorthand} field allows you to set -an abbreviation to stand in place of the author's name, the work's -title, and other elements of a citation (see \ref{14.59}). +Other ways to make citations more concise: For a compromise between +standard and short forms, try the preamble option \opt{firstshort}. +It swaps long first citations for short ones but otherwise follows the +standard (see section \ref{preamble}). Also with standard citations, +the preamble option \opt{idemtracker} shortens the author's name of a +work's first citation if the previous citation is of the same author +(see section \ref{preamble}). The entry option \opt{noauth} omits the +author's name altogether (see section \ref{entry}). And the +\bibfield{shorthand} field allows you to set an abbreviation to stand +in place of the author's name, the work's title, and other elements of +a citation (see sections \ref{otherfields} and \ref{14.59}). \subsection{Preamble Options} -\label{preops} +\label{preamble} A preamble option is an argument for the \cmd{usepackage} macro that loads \biblatex. Preamble options affect the format of notes, @@ -338,12 +344,12 @@ set in \file{windycity.bbx}. In particular, the style sets \opt{idemtracker} to \opt{false}. If you set it to \opt{true} (or to some value that implies \opt{true}), Windy City will detect when the first citation of a work follows another citation of a work by the -same author and print a short form of the author's name. Recall from -the previous section the citation of Toni Morrison's \textit{Song of -Solomon} immediately after a citation of her \textit{Beloved}. In a -context like that, do you really need to remind readers of the -author's full name? If you think not, change \opt{idemtracker} to an -appropriate value (see section 3.1.2.3 of \biblatex's user +same author and shorten the author's name. Recall from the previous +section the citation of Toni Morrison's \textit{Song of Solomon} +immediately after a citation of her \textit{Beloved}. In a context +like that, do you really need to remind readers of the author's full +name? If you think not, change \opt{idemtracker} to an appropriate +value (see section 3.1.2.3 of \biblatex's user guide).\footnote{\textit{CMOS} seems to have no policy on this point. In the 16th edition, however, Figure 14.3 shows consecutive citations of works by the same author, both of which give the author's full @@ -354,7 +360,7 @@ name.} \optitem[false]{annotate}{\opt{true}, \opt{false}} \noindent This option is for printing annotated bibliographies. -Annotations will print in block paragraphs below entries. To change +Annotations print in block paragraphs below entries. To change the spacing between entries and annotations, change the value of \cmd{bibitemsep}. Save an annotation in the \bibfield{annotation} field of a work's bibliography database entry. @@ -372,7 +378,7 @@ collections. For discussion of multivolume works, see section \optitem[false]{firstshort}{\opt{true}, \opt{false}} \noindent Use this option to shorten a work's first citation. The -resulting format consists mainly of the author's name and the work's +resulting output consists mainly of the author's name and the work's title. According to \textit{CMOS}, this approach is optional for documents with complete bibliographies. (See \textit{CMOS} \ref{14.23}, also 14.29--14.36.) You may use \opt{firstshort} in @@ -387,7 +393,7 @@ same page'' means that \textit{ibid.} always refers to a work cited on the current page without an \textit{ibid.} The latter isn't a requirement of \textit{CMOS} but seems reasonable, since it prevents readers from having to look at another page to find the referent of an -\textit{ibid.} For examples of its output, see section \ref{short} and +\textit{ibid}. For examples of its output, see section \ref{short} and \ref{14.34}. As of the 17th edition, \textit{CMOS} discourages the use of \textit{ibid.} (see \ref{14.34}). @@ -395,20 +401,22 @@ of \textit{ibid.} (see \ref{14.34}). \noindent Use this option to print ISBNs in bibliographies. A work's ISBN goes in the \bibfield{isbn} field of its bibliography database -entry. With this option, the style will print ISBNs at the end of -every entry in the bibliography, before annotations. To print the ISBN -of a particular work, use the \opt{isbn} entry option. Neither option -effects the output of entries without an \bibfield{isbn} field. +entry. With this option, the style prints ISBNs at the end of every +entry in the bibliography, before annotations. To print the ISBN of a +particular work, use the \opt{isbn} entry option. + +\optitem[false]{issn}{\opt{true}, \opt{false}} + +\noindent Similar to \opt{isbn} but for ISSNs. \optitem[false]{library}{\opt{true}, \opt{false}} -\noindent Like \opt{isbn}, this option prints the \bibfield{library} -field of every work in the bibliography. Use it to print information -about libraries, call numbers, and the like. If you use it with the -\opt{isbn} and \opt{annotation} options, it will print after the -former but before the latter. To print this information for selected -works, use the \opt{library} entry option. Neither option effects the -output of entries without a \bibfield{library} field. +\noindent Like \opt{isbn} and \opt{issn}, this option prints the +\bibfield{library} field of every work in the bibliography. Use it to +print information about libraries, call numbers, and the like. If you +use it with the \opt{isbn} and \opt{annotation} options, it prints +after the former but before the latter. To print this information for +selected works, use the \opt{library} entry option. \optitem[false]{nolos}{\opt{true}, \opt{false}} @@ -418,10 +426,19 @@ avoid duplication with the output of \cmd{printshorthands}, use \opt{nolos}. Since \opt{collsonly} also excludes works from the bibliography, their results may overlap. +\optitem[false]{nopages}{\opt{true}, \opt{false}} + +\noindent On the first citation of \bibtype{article} or +\bibtype{review} entries (and their aliases), Windy City prints the +\bibfield{pages} field if the \bibfield{postnote} field is blank. This +lets you cite the entirety of a work without having to duplicate the +content of the \bibfield{pages} field in the \bibfield{postnote}. To +override this feature, use the \opt{nopages} option. + \optitem[false]{reflist}{\opt{true}, \opt{false}} \noindent Use this option to print a bibliography in the author-date -format, what \textit{CMOS} calls a reference list. If you use +format (what \textit{CMOS} calls a reference list). If you use parenthetical citations, consider using \opt{reflist} to maintain consistency with \textit{CMOS}. Again, another way to print a reference list is to pass \opt{env=reflist} to @@ -430,23 +447,21 @@ information. \optitem[false]{short}{\opt{true}, \opt{false}} -\noindent As shown in section \ref{short}, this option prints -citations in a short format (see \textit{CMOS} \ref{14.34}). The use -of \opt{short} has one feature in common with \opt{ibid}: Just as -\textit{ibid.} appears only for consecutive citations of a work on the -same page, and so never refers to a citation on a previous page, -\opt{short} drops the title from consecutive citations of a work on -the same page, never in reference to a citation on a previous page. As -with \textit{ibid.}, this feature isn't required by \textit{CMOS}, but -it prevents readers from having to look at another page to find the -title of a citation. +\noindent As shown in section \ref{short}, this option prints short +citations (see \textit{CMOS} \ref{14.34}). The use of \opt{short} has +one feature in common with \opt{ibid}: Just as \textit{ibid.} appears +only for consecutive citations of a work on the same page, and so +never refers to a citation on a previous page, \opt{short} affects +consecutive citations of a work on the same page, never in reference +to a citation on a previous page. As with \textit{ibid.}, this feature +isn't required by \textit{CMOS}, but it prevents readers from having +to look at another page to find the title of a citation. In contexts where \opt{short} would drop a title from a citation, but -where no name occupies the author's position, it will print the work's +where no name occupies the author's position, it prints the work's \bibfield{labeltitle}. This can be a short form of the title, either -the title minus the subtitle or the \bibfield{shorttitle}, if -applicable. In those situations, the short format is no different from -the default. +the title minus the subtitle or the content of the +\bibfield{shorttitle} field, if available. As noted earlier, \opt{short} has the same effect on first citations as \opt{firstshort}. But recall from section \ref{short} that you can @@ -463,41 +478,26 @@ For more information, see section \ref{collorder}. \end{optionlist} \subsection{Entry Options} -\label{entryops} +\label{entry} An entry option is a value for the \bibfield{options} field of a work's database entry. It affects the format of that particular work. For options that affect the format of every work, see section -\ref{preops}. +\ref{preamble}. \begin{optionlist} -\optitem[false]{anonauth}{\opt{true}, \opt{false}} - -\noindent This option prints the author's name of an anonymously -published work in brackets, as in this example from \textit{CMOS} -\ref{14.79}: - -\begin{citebib} -\item \cite{horsley1796} -\end{citebib} - -\optitem[false]{anonqauth}{\opt{true}, \opt{false}} - -\noindent Like \opt{anonauth} but adds a question mark after the -author's name. From \textit{CMOS} \ref{14.79}: - -\begin{citebib} -\item \cite{hawkes1834} -\end{citebib} - \optitem[false]{isbn}{\opt{true}, \opt{false}} \noindent Use this option to print the ISBN of a particular work in a -bibliography. The ISBN will appear at the end of the work's entry (if +bibliography. The ISBN appears at the end of the work's entry (if applicable, before an annotation). To print ISBNs of every work in the bibliography, see the \bibfield{isbn} preamble option. +\optitem[false]{issn}{\opt{true}, \opt{false}} + +\noindent Similar to \opt{isbn} but for ISSNs. + \optitem[false]{library}{\opt{true}, \opt{false}} \noindent This option prints the \bibfield{library} field of a work's @@ -556,8 +556,8 @@ the option \bibfield{swaptrans} reverse this order: Their translators print first. If a work's translators and editors are the same, \bibfield{swaptrans} reverses the order of their roles, say, from \textit{edited and translated by} to \textit{translated and edited -by}. The same goes for compilers and revisers, which the style treats -as specialized editors. For more information, see section +by}. The same goes for compilers, revisers, and updaters, which the +style treats as specialized editors. For more information, see section \ref{edtranspos}. \optitem[false]{swapvol}{\opt{true}, \opt{false}} @@ -572,29 +572,51 @@ section \ref{collorder}. \end{optionlist} \subsection{Citation Commands} -\label{citecmds} Windy City supports most of the citation commands familiar from -\biblatex: +\biblatex, plus a small set of custom commands for tricky situations. + +\subsubsection{Standard Citation Commands} +\label{std.cmd} + +The following list, though not exhaustive, shows the most important +citation commands from \biblatex that Windy City supports: \begin{ltxsyntax} \cmditem{autocite}[prenote][postnote]{key} \cmditem{autocites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} \cmditem{cite}[prenote][postnote]{key} +\cmditem{cite*}[prenote][postnote]{key} \cmditem{cites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} +\cmditem{cites*}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} \cmditem{footcite}[prenote][postnote]{key} +\cmditem{footcite*}[prenote][postnote]{key} \cmditem{footcites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} -\cmditem{nocite}{key} \cmditem*{nocite}|\{*\}| +\cmditem{footcites*}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} +\cmditem{footfullcite}[prenote][postnote]{key} +\cmditem{footfullcite*}[prenote][postnote]{key} +\cmditem{fullcite}[prenote][postnote]{key} +\cmditem{fullcite*}[prenote][postnote]{key} +\cmditem{nocite}{key} +\cmditem*{nocite}|\{*\}| \cmditem{parencite}[prenote][postnote]{key} +\cmditem{parencite*}[prenote][postnote]{key} \cmditem{parencites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} \cmditem{smartcite}[prenote][postnote]{key} +\cmditem{smartcite*}[prenote][postnote]{key} \cmditem{smartcites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} +\cmditem{smartcites*}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} +\cmditem{textcite}[prenote][postnote]{key} +\cmditem{textcites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} +\cmditem{textcites*}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} \end{ltxsyntax} -\noindent New users should get comfortable first with \cmd{cite} and +\noindent New users should get comfortable with \cmd{cite} and \cmd{footcite} (for notes) and \cmd{parencite} (for parenthetical citations). Their multicite forms---\cmd{cites}, \cmd{footcites}, and -\cmd{parencites}---take a comma-separated list of entry keys. +\cmd{parencites}---take comma-separated lists of entry keys, while +allowing you to specify distinct \bibfield{prenote} and +\bibfield{postnote} fields for each work. Use \cmd{nocite} to add works to bibliographies even if you haven't cited them in the text with citations commands. Use it with an @@ -612,8 +634,6 @@ set the \opt{autocite} preamble option to \opt{inline}, \cmd{autocite} is equivalent to \cmd{parencite}. If you set it to \opt{plain}, \cmd{autocite} is equivalent to \cmd{cite}. -Other citation commands: - \begin{ltxsyntax} \cmditem{cite*}[prenote][postnote]{key} @@ -627,14 +647,6 @@ author's name clear. From \textit{CMOS} \ref{14.78}: \item \cite*[234]{franklin1868} \end{citebib} -\cmditem{cites*}[prenote][postnote]{key} - -Like \cmd{cites} but suppresses the author's position. - -\cmditem{footcite*}[prenote][postnote]{key} - -Like \cmd{footcite} but suppresses the author's position. - \cmditem{parencite*}[prenote][postnote]{key} Like \cmd{parencite} but suppresses the author's position---useful in @@ -655,23 +667,15 @@ The source for the passage above contains: \parencite*{abramowitz2005}... \end{quote} \end{verbatim} -\cmditem{smartcite*}[prenote][postnote]{key} - -Like \cmd{smartcite} but suppresses the author's position. - -\cmditem{smartcites*}[prenote][postnote]{key} - -Like \cmd{smartcites} but suppresses the author's position. - \cmditem{textcite}[prenote][postnote]{key} -Use \cmd{textcite} for in-text citations in the standard format. -Here's an example from \textit{CMOS} 13.65: +Use \cmd{textcite} for in-text citations. Here's an example from +\textit{CMOS} 13.65: \begin{quote} ``If an astronaut falls into a black hole, its mass will increase, but eventually the energy equivalent of that extra mass will be returned to the universe in the form of radiation. Thus, in a -sense, the astronaut will be {`recycled'}'' +sense, the astronaut will be `recycled''' \mkbibparens{\textcite[112]{hawking1988}}. \end{quote} The source for the passage above contains: @@ -704,16 +708,72 @@ The source for the passage above contains: ...\parencite[xvii]{tocqueville1999}. \end{quote} \end{verbatim} -\cmditem{textcites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} - -Like \cmd{textcite} but for multiple sources. +\end{ltxsyntax} -\cmditem{textcites*}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} +\subsubsection{Other Citation Commands} +\label{cust.cmd} -Like \cmd{textcites} but suppresses the author's position. +Windy City's custom citation commands are convenient but not strictly +necessary. They make certain citations simpler than they would be with +standard commands. +\begin{ltxsyntax} +\cmditem{idemcite}[prenote][postnote]{key} +\cmditem{idemcites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} +\cmditem{footidemcite}[prenote][postnote]{key} +\cmditem{footidemcites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} \end{ltxsyntax} +Perhaps the best use case for these commands is the example in +\textit{CMOS} \ref{14.57}. The sources mentioned in a passage receive +long citations with shortened names: + +\begin{quote} Only when we gather the work of several +scholars---Walter Sutton's explications of some of Whitman's shorter +poems; Paul Fussell's careful study of structure in ``Cradle''; S. K. +Coffman's close readings of ``Crossing Brooklyn Ferry'' and ``Passage +to India''; and the attempts of Thomas I. Rountree and John Lovell, +dealing with ``Song of Myself'' and ``Passage to India,'' +respectively, to elucidate the strategy in ``indirection''---do we +begin to get a sense of both the extent and the specificity of +Whitman's forms.\footnotemark[1] \end{quote} + +\begin{citeonly} +\item \idemcites{sutton1959,fussell1962,coffman1954,coffman1955,rountree1958}[and][]{lovell1960} +\end{citeonly} + +Without commands like \cmd{idemcite}, there's often no easy way to +tell Windy City to shorten names. The preamble option +\opt{idemtracker} helps with consecutive citations of the same author, +but that's no use when you want to shorten names because you've +mentioned them in the text. + +Nevertheless, standard commands can reproduce the example in at least +three ways: + +\begin{verbatim} + \footnote{\cites*[Sutton,][]{sutton1959}[Fussell,][]{fussell1962}... + \footcites*[Sutton,][]{sutton1959}[Fussell,][]{fussell1962}... + \footnote{Sutton, \cite*{sutton1959}; Fussell, \cite*{fussell1962}... +\end{verbatim} + +\noindent They're ugly workarounds, exploiting starred citations +commands to suppress the author's position while you add names +manually---but they do work. + +With \cmd{idemcites} and \cmd{footidemcites}, on the other hand, you +have simpler alternatives that make your intentions clearer and your +file easier to read: + +\begin{verbatim} + \footnote{\idemcites{sutton1959,fussell1962,...}[and][]{lovell1960}} + \footidemcites{sutton1959,fussell1962,...}[and][]{lovell1960} + \footnote{\idemcite{sutton1959}; ... and \idemcite{lovell1960}} +\end{verbatim} + +Notice that the only reason to use \cmd{footidemcites} rather than +\cmd{footidemcite} is to insert \textit{and} before the last citation. + \subsection{Entry Types} \label{entrytypes} @@ -766,8 +826,8 @@ City processes it as a book. One comment about \bibtype{reference} and \bibtype{inreference} entries: You may cross-reference \bibtype{inreference} entries to \bibtype{reference} entries, as with articles in books, but you can -get the same output using one or the other type alone. Take an example -from \textit{CMOS} \ref{14.232}: +get the same output with one or the other alone. Take an example from +\textit{CMOS} \ref{14.232}: \begin{citeonly} \item \cite{salvation1980} @@ -806,9 +866,8 @@ either type with the same data: For unusually complicated citations, or those just not supported by the style, consider using the \bibtype{misc} entry type. The style -formats these entries with a small number of fields but in way that -makes it a fallback for almost anything. The example below is from -\textit{CMOS} 14.264: +handles these entries in way that makes it a fallback for almost +anything. The example below is from \textit{CMOS} 14.264: \begin{citebib} \item \cite{roosevelt1959} @@ -861,8 +920,8 @@ from printing \textit{n.d.} (no date) after the name to indicate a missing publication date. After adding the \bibtype{misc} entries, use \cmd{nocite} with their entry keys to add them to your bibliography, and cite the remaining entries as usual. For examples of automatic -cross-referencing in notes and bibliographies see section \ref{notes}, -\ref{14.108}; section \ref{paren}, \ref{15.42}; and section +cross-referencing in notes and bibliographies see section \ref{notes} +(\ref{14.108}), section \ref{paren} (\ref{15.42}), and section \ref{collections}. For more discussion of entry types, see section \ref{datafields}. @@ -874,56 +933,29 @@ Windy City relies on a small number of data fields that aren't recognized by \BibTeX\ or \biblatex. It also uses some standard ones in perhaps unexpected ways. -\subsubsection{Additional Data Fields} -\label{datafields} +\subsubsection{Standard Data Fields} +\label{stdfields} -Some of Windy City's nonstandard data fields are for its internal -handling of cross-referencing. Those fields aren't listed below, as -they're not meant for use in a bibliography database. The rest store -information that's crucial for correct formatting. Without them, quite -a few citations in this document wouldn't match their counterparts in -\textit{CMOS}. +Examples in this document don't always make it clear how Windy City +uses standard data fields. The section discusses some of them. \begin{marglist} -\item[\smash{\tshortstack[l]{blogtitle\\blogsubtitle}}] The name of a -blog goes in \bibfield{blogtitle} and \bibfield{blogsubtitle}. Keep in -mind that blog posts take the usual \bibfield{title} and -\bibfield{subtitle} fields. - -\item[editoraddon] Use this field to include additional editorial -information about a book. It's available for \bibtype{book}, -\bibtype{incollection}, and \bibfield{review} entry types and their -aliases. (For information on aliases in Windy City, see section -\ref{entrytypes}.) When applicable, its content appears after the -names of a book's editors and translators without intervening -punctuation. For an example, see section \ref{entryops}, where the -citation of \textit{Chaucer Life-Records} prints this -\bibfield{editoraddon}: ``from materials compiled by John M. Manly and -Edith Richert, with the assistance of Lilian J. Redstone et al.'' - -\item[seriesaddon] This field is for additional information about a -book's series. That includes information about the run of a series, -such as \textit{2nd ser.} and \textit{n.s.} For examples, see -\textit{CMOS} \ref{14.123} and \ref{14.126}. Keep in mind that, for -journals, which occasionally have a series but no series name, -information like \textit{2nd ser.} and \textit{n.s.} go in the -\bibfield{series} field. - -\item[shortmaintitle] This field is for the short form of a -\bibfield{maintitle}. This should only be necessary for certain works -in collections. See the citation of \textit{The Complete Tales of -Henry James} in section \ref{multivolume}. - -\end{marglist} - -\subsubsection{Other Data Fields} -\label{fieldscon} +\item[authtype] This field takes three values: \textit{anon} (to print +an anonymous author's name in brackets), \textit{anon?} (to add a +question mark inside the brackets), and \textit{pseudo} (to print +\textit{pseud.} in brackets after the name of a pseudonymous author). +From \textit{CMOS} \ref{14.79}: -Examples in this document don't always make it clear how Windy City -uses standard data fields. The list below discusses some of them. +\begin{citebib} +\item \cite{horsley1796} +\item \cite{hawkes1834} +\end{citebib} -\begin{marglist} +With respect to pseudonymous authors, another solution is to use the +\bibfield{nameaddon} field. Unlike with \bibfield{authtype}, +\bibfield{nameaddon} allows you to include an author's given name in +the brackets. For examples, see \textit{CMOS} \ref{14.81}. \item[edition] To indicate a numbered edition of a work, put the edition's number in this field---for example, \textit{2} for a second @@ -931,7 +963,7 @@ edition. To indicate a revised edition, enter either \textit{revised} or \textit{rev. ed.} Both options give the same output. For expanded and updated editions, you may use \textit{expanded} or \textit{updated}. Add additional data as necessary. For the following -example from \textit{CMOS} Bibliography 2.4, \bibfield{edition} +example from \textit{CMOS} bibliography 2.4, \bibfield{edition} contains \textit{updated edition by Arlene O'Sean and Antoinette Schleyer}: @@ -972,9 +1004,21 @@ use the \bibfield{issue} field. In other words, for \textit{Fall \noindent Remember that when \bibfield{date} contains just a year of publication, you may use the classic \bibfield{year} field. -\item[series] See the comments for \bibfield{seriesaddon} in section +\item[pages] See comments on the \opt{nopages} bibliography +option in section \ref{preamble}. + +\item[series] See comments on \bibfield{seriesaddon} in section \ref{datafields}. +\item[titleaddon] Like \bibfield{nameaddon}, this field encloses its +content in brackets. This is especially useful for translated titles. +From \textit{CMOS} \ref{14.99}: + +\begin{citebib} +\item \cite{wereszycki1977}; includes a summary in German. +\item \cite{pirumova1977b} +\end{citebib} + \item[type] With the \bibtype{thesis} entry type, Windy City uses \bibfield{type} to distinguish a Master's thesis from a PhD dissertation. For the latter, \bibtype{type} should have the value @@ -997,7 +1041,63 @@ Beattie in \ref{14.171}. \end{marglist} -\section{Editors, Translators, Compilers, and Revisers} +\subsubsection{Other Data Fields} +\label{otherfields} + +Some of Windy City's nonstandard data fields are for its internal +handling of cross-referencing. Those fields aren't listed below, as +they're not meant for use in a bibliography database. The rest store +information that's crucial for correct formatting. Without them, quite +a few citations in this document wouldn't match their counterparts in +\textit{CMOS}. + +\begin{marglist} + +\item[\smash{\tshortstack[l]{blogtitle\\blogsubtitle}}] The name of a +blog goes in \bibfield{blogtitle} and \bibfield{blogsubtitle}. Keep in +mind that blog posts take the usual \bibfield{title} and +\bibfield{subtitle} fields. + +\item[editoraddon] Use this field to include additional editorial +information about a book. It's available for \bibtype{book}, +\bibtype{incollection}, and \bibfield{review} entry types and their +aliases. (For information on aliases in Windy City, see section +\ref{entrytypes}.) When applicable, its content appears after a book's +editors and translators without intervening punctuation. For an +example, see section \ref{entry}, where the citation of +\textit{Chaucer Life-Records} prints: ``from materials compiled by +John M. Manly and Edith Richert, with the assistance of Lilian J. +Redstone et al.'' + +\item[seriesaddon] This field is for additional information about a +book's series. That includes information about the run of a series, +such as \textit{2nd ser.} and \textit{n.s.} For examples, see +\textit{CMOS} \ref{14.123} and \ref{14.126}. Keep in mind that, for +journals, which occasionally have a series but no series name, +information like \textit{2nd ser.} and \textit{n.s.} go in the +\bibfield{series} field. + +\item[shorthand] Windy City doesn't automatically italicize a +\bibfield{shorthand}. Per \textit{CMOS} 14.60, a shorthand should be +italicized if the title that it abbreviates is italicized. Set it the +bibliography database with \cmd{emph} or \cmd{mkbibemph}. For examples +of a \bibfield{shorthand}, see section \ref{14.59} and the first +citation of \textit{CMOS} in this document's introduction. + +\item[shorthandintro] You may override the default announcement of a +\bibfield{shorthand} by adding your preferred content to +\bibfield{shorthandintro}. For an example, see the first citation of +\textit{CMOS} in this document's introduction, where the announcement +is a separate sentence, rather than in parentheses. + +\item[shortmaintitle] This field contains the short form of a +\bibfield{maintitle}. It should only be necessary for certain works in +collections. See the citation of \textit{The Complete Tales of Henry +James} in section \ref{multivolume}. + +\end{marglist} + +\section{Editors, Translators, and Friends} \label{edtrans} Windy City offers significant control over the handling of editors, @@ -1104,10 +1204,11 @@ scope of the \bibtype{incollection} entry: scope of \bibtype{collection}, the style associates it with \textit{The Renaissance Philosophy of Man}. -The style supports two other basic editorial roles: compiler and -reviser. To assign them, you need to use the \bibfield{editortype} -field. It may help to see the bibliography database entries for -examples in \textit{CMOS} \ref{14.103} and \ref{14.142}: +The style supports three more basic editorial roles: compiler, +reviser, and updater. To assign them, you need to use the +\bibfield{editortype} field. It may help to see the bibliography +database entries for examples in \textit{CMOS} \ref{14.103} and +\ref{14.142}: \begin{verbatim} @Book{schechter2011, @@ -1139,70 +1240,60 @@ examples in \textit{CMOS} \ref{14.103} and \ref{14.142}: \item \cite{turabian2013} \end{citebib} -In addition to the four basic roles (editor, translator, compiler, and -reviser), you may assign names to any pair of them. A work's editor, -for example, can also be its translator, or compiler, or reviser---but -no more than one of these. And just as you can swap the order of the -editor and translator roles (again, see section \ref{edtranspos}), you -can swap all other combinations, say, to identify a work as -\textit{compiled and edited by} Jane Doe rather than \textit{edited -and compiled by} her. Simply change the value of +In addition to the five basic roles (editor, translator, compiler, +reviser, and updater), you may assign names to any pair of them. A +work's editor, for example, can also be its translator, compiler, +reviser, or updater---but no more than one of these. And just as you +can swap the order of the editor and translator roles (again, see +section \ref{edtranspos}), you can swap all other combinations, say, +to identify a work as \textit{compiled and edited by} Jane Doe rather +than \textit{edited and compiled by} her. Simply change the value of \bibfield{editortype}. A summary of these values appears in Table \ref{table:ed}. \begin{table}[H] -\begin{tabular}{@{}r l@{}} -\bibfield{editortype} & Assignment\\ +\begin{tabular}{@{}r l r l@{}} +\bibfield{editortype} & Assignment & \bibfield{editortype} & Assignment\\ \toprule -compiler & compiler\\ -comped & compiler and editor\\ -comprev & compiler and reviser\\ -comptrans & compiler and translator\\ -edcomp & editor and compiler\\ -edrev & editor and reviser\\ -reviser & reviser\\ -revcomp & reviser and compiler\\ -reved & reviser and editor\\ -revtrans & reviser and translator\\ -transcomp & translator and compiler\\ -transrev & translator and reviser\\ +compiler & compiler & reviser & reviser\\ +comped & compiler and editor & revcomp & reviser and compiler\\ +comprev & compiler and reviser & reved & reviser and editor\\ +comptrans & compiler and translator & revtrans & reviser and translator\\ +compup & compiler and updater & revup & reviser and updater\\ +edcomp & editor and compiler & edrev & editor and reviser\\ +transcomp & translator and compiler & transrev & translator and reviser\\ +\midrule +updater & updater & uptrans & updater and translator\\ +upcomp & updater and compiler & edup & editor and updater\\ +uped & updater and editor & transup & translator and updater\\ +uprev & updater and reviser & &\\ \end{tabular} -\caption{} \label{table:ed} +\caption{}\label{table:ed} \end{table} -For an example in \textit{CMOS}, we need turn the bibliography. This -will do: - -\begin{verbatim} - @Book{fowler1965, - author = {Fowler, H. W.}, - title = {A Dictionary of Modern English Usage}, - edition = {2}, - editor = {Gowers, Sir Ernest}, - editortype = {reved}, - address = {Oxford}, - publisher = {Oxford University Press}, - year = {1965} - } -\end{verbatim} +For examples in \textit{CMOS}, we need to turn to the bibliography. +The first one below shows the output of \textit{reved} in the +\bibfield{editortype} field, the second of \textit{revup}. \begin{citebib} \item \cite{fowler1965} +\item \cite{gowers2015} \end{citebib} -Try swapping \textit{reved} in the entry above for other values in -Table \ref{table:ed}. Notice that \textit{edrev} is the reverse of -\textit{reved}---``edited and revised by'' instead of ``revised and -edited by.'' Similarly for \textit{comprev} and \textit{revcomp}, -\textit{comptrans} and \textit{transcomp}, and so on. +% Try swapping the editor type in the entries above for other values +% in Table \ref{table:ed}. Note that \textit{edrev} is the reverse of +% \textit{reved}---\textit{edited and revised by} instead of +% \textit{revised and edited by}. So, too, for \textit{comprev} and +% \textit{revcomp}, \textit{comptrans} and \textit{transcomp}, and so +% on. -Missing from the table are \textit{editor}, \textit{translator}, -\textit{edtrans}, and \textit{transed}. Windy City has bibstrings for -them, too, but they're strictly for the style's internal use. It -determines which of them applies, if any, based on the contents of the -\bibfield{editor} and \bibfield{translator} fields and the option -\opt{swaptrans}. You never need to use them in a bibliography -database. +Missing from Table \ref{table:ed} are \textit{editor}, +\textit{translator}, \textit{edtrans}, and \textit{transed}. Windy +City has bibliography strings for them, too, but they're meant for the +style's internal use. It determines which of them applies, if any, +based on the contents of the \bibfield{editor} and +\bibfield{translator} fields and the option \opt{swaptrans}. You never +need to use them in a bibliography database. Three more values of \bibfield{editortype} allow you to assign editors to higher level titles: \textit{maintitle}, \textit{series}, and @@ -1228,13 +1319,13 @@ to higher level titles: \textit{maintitle}, \textit{series}, and \end{citebib} \noindent If there were no \bibfield{editortype} assigning the editor -to the series, Windy City would take her as the book's editor. In -short, for a title's compilers and revisers and for any title at a +to the series, the output would list a book's editor. In short, for a +title's compilers, revisers, and updaters and for any title at a higher level than \bibfield{title}, you need to use \bibfield{editortype}. Combined with Windy City's support for citing articles, chapters, books, and other works within books, this scheme allows for several sets of editors per work, although it does limit -you to just one set of compilers and revisers. +you to just one set of compilers, revisers, and updaters. What about translators? Unless a work's bibliography database entry has a \bibfield{translatortype} field with the value @@ -1317,12 +1408,16 @@ translated by}. Reverse them with \opt{swaptrans}. From \textit{CMOS} \item \cite{menchu1999} \end{citebib} -Since Windy City treats a compiler as a kind of editor, the comments -above apply to compilers: If a work has compilers and translators, -compilers' names will print first, unless you use \opt{swaptrans}. +To make switching roles easier in these cases, you may also use the +relevant \bibfield{editortype} field with a bibliography string from +Table \ref{table:ed}. After all, for compilers, revisers, and +updaters, you need to put a value in \bibfield{editortype} anyway. So, +if you pick one that begins with \textit{trans} (\textit{transcomp}, +\textit{transed}, \textit{transrev}, or \textit{transup}), Windy City +will assume that the translator's role goes first. -In rare cases, you may want to swap the position of an author and an -editor or translator. \textit{CMOS} \ref{14.104} gives an example: +On rare occasions, you may want to swap the position of an author and +an editor or translator. \textit{CMOS} \ref{14.104} gives an example: \begin{citebib} \item \cite{pound1953} @@ -1387,11 +1482,11 @@ priority, the collection's or the volume's. Consider an example from \end{citebib} \noindent The editor and title of the volume precede the editor and -title of the collection. In notes and bibliographies in the default -format, \textit{CMOS} gives you the option of reversing this order. -(See especially \textit{CMOS} \ref{14.119}, \ref{14.121}, and -\ref{14.122}, and compare \ref{14.144} and \ref{15.41}.) Windy City -does as well, with the entry or preamble option \opt{swapvol}. +title of the collection. In standard notes and bibliographies, +\textit{CMOS} gives you the option of reversing this order. (See +especially \textit{CMOS} \ref{14.119}, \ref{14.121}, and \ref{14.122}, +and compare \ref{14.144} and \ref{15.41}.) Windy City does as well, +with the entry or preamble option \opt{swapvol}. \begin{citebib} \AtNextCitekey{\toggletrue{swapvol}} @@ -1419,8 +1514,8 @@ below, the volume has priority: \end{citeonly} Notice the volume number in the second note above, separated from the -page citation by a colon. When the collection has priority, the volume -number should appear in the citation. There are enough examples in +page by a colon. When the collection has priority, the volume number +should appear in the citation. There are enough examples in \textit{CMOS} to make that clear. But when the volume has priority, the volume number is at best optional but probably incorrect. (It could cause confusion, since the collection is what comes in volumes, @@ -1439,10 +1534,10 @@ option. A good candidate for the latter is this example from \item \cite*{james1963.5} \end{citebib} -\noindent The volume's title merely indicates a portion of the -collection, somewhat like the volume of an encyclopedia with the title -\textit{D–F}. There's nothing wrong with putting it first. But putting -it second seems more intuitive. +\noindent The volume's title (\textit{1883--1884}) merely indicates a +portion of the collection, somewhat like the volume of an encyclopedia +with the title \textit{D–F}. There's nothing wrong with putting it +first. But putting it second seems more intuitive. For other works, \opt{swapvol} may seem like a poor choice, even if the output is formally correct: @@ -1458,7 +1553,7 @@ the volume's title looks odd. But it's not wrong. The volume's author didn't write every volume of the collection. In giving priority to the collection, then, the first position, where an author's name normally goes, should go to the collection's editor, not to the volume's -author. By contrast, the default format looks more familiar: +author. By contrast, the default output looks more familiar: \begin{citebib} \item \cite{barrows1959} @@ -1476,7 +1571,7 @@ This drawback shouldn't affect \bibfield{bookinbook}, entries when they're cross-referenced to works that are changed by \opt{swapvol}. They should have their own authors or titles that Windy City can use for proper sorting. It seems that \textit{CMOS} gives -exactly such example one in \ref{14.120}: +exactly one such example in \ref{14.120}: \begin{citebib} \item \cite[169--71]{king2014} @@ -1617,13 +1712,13 @@ Certain entries cross-referenced to entries that work with \bibfield{armstrong2014} or \bibfield{carson2014}. The only difference is that, with \opt{swapvol}, cross-referencing to \bibfield{carson2014} once more gives the wrong publication date for -the collection. With many other collections, this wouldn't be an -issue. Convenience, then, is perhaps the only consideration in -choosing how you do it. If you plan to cite more than one volume of a -collection, and different works in those volumes or the collection as -a whole, cross-referencing to \bibtype{bookinbook} or \bibtype{inbook} -entries is probably simpler. The other way is simpler if you plan to -cite just one work in one volume. +the collection. With many collections, this wouldn't be an issue. +Convenience, then, is perhaps the only consideration in choosing how +you do it. If you plan to cite more than one volume of a collection, +and different works in those volumes or the collection as a whole, +cross-referencing to \bibtype{bookinbook} or \bibtype{inbook} entries +is probably simpler. The other way is simpler if you plan to cite just +one work in one volume. As mentioned in \textit{CMOS} \ref{15.41}, reference lists should give priority to the volume, not to the collection. Nevertheless, Windy @@ -1692,7 +1787,7 @@ James}, only the second citation follows this pattern. In the first, the volume number appears earlier, after the editor's name. Why? Apparently, \textit{The Lisle Letters} count as a single, multivolume work because every volume has the same title and publication date. Not -so \textit{The Complete Tales of Henry James}, in which volumes have +so \textit{The Complete Tales of Henry James}. Its volumes have different titles and publication dates. To get the right output, your bibliography database and citations need @@ -1735,10 +1830,10 @@ the appropriate abbreviations (for some examples, see \textit{CMOS} What if the \bibfield{postnote} is empty? Windy City assumes that you mean to cite the collection as a whole. As such, the first, long -citation of the work will print the collection's total number of -volumes. Subsequent entries will indicate the collection in whatever -short form corresponds to the preamble options. The following shows -the default output for two such citations of the collection: +citation of the work prints the collection's total number of volumes. +Subsequent entries indicate the collection in whatever short form +corresponds to the preamble options. The following shows the default +output for two such citations of the collection: \begin{citeonly} \item \cite{byrne1981} @@ -1855,15 +1950,14 @@ accordingly: \bibfield{spinoza1900.1.1}, Windy City would assume that \textit{A Theological-Political Treatise} is volume one of \textit{The Chief Works of Benedict de Spinoza}. The same error would occur if you put -all the data for the citation into, say, a \bibfield{collection} -entry. Windy City would associate \bibfield{volume} with -\bibfield{title}, not with \bibfield{maintitle}. The upshot is that -correctly citing a work like this requires cross-referencing an -\bibtype{inbook} or \bibtype{bookinbook} entry to a -\bibtype{collection}, \bibtype{book}, \bibtype{mvbook}, or -\bibtype{mvcollection} entry. (Again, the alternatives give the same -output.) Only then would Windy City associate \bibfield{volume} with -the right \bibfield{title}. +all the data for the citation into a \bibfield{collection} entry. +Windy City would associate \bibfield{volume} with \bibfield{title}, +not with \bibfield{maintitle}. The upshot is that correctly citing a +work like this requires cross-referencing an \bibtype{inbook} or +\bibtype{bookinbook} entry to a \bibtype{collection}, \bibtype{book}, +\bibtype{mvbook}, or \bibtype{mvcollection} entry. (Again, the +alternatives give the same output.) Only then would Windy City +associate \bibfield{volume} with the right \bibfield{title}. \section{Examples from \emph{CMOS} Chap. 14, ``Notes and Bibliography''} @@ -1873,6 +1967,7 @@ Examples in this section reproduce those in \textit{CMOS} chapter 14. To help with cross-checking, subsection numbers and headings are from \textit{CMOS}. +\titleformat{\subsubsection}{\normalsize\it}{\arabic{subsection}.\arabic{subsubsection}}{2ex}{} \subsection{Basic Format, with Examples and Variations} \setcounter{subsection}{14} @@ -1921,8 +2016,8 @@ To help with cross-checking, subsection numbers and headings are from % 14.34: \label{14.34} -See section \ref{short} for a discussion of how to enable the short -format and the use of \textit{ibid.} First, the short format: +On short citations and the \opt{short} and \opt{ibid} preamble +options, see sections \ref{short} and \ref{preamble}. \begin{citeonly} \AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} @@ -1950,7 +2045,7 @@ format and the use of \textit{ibid.} First, the short format: \AtNextCitekey{\toggletrue{short}} \item \cite[33]{morrison2004a} \end{citeonly} -\noindent With \textit{ibid.}: +\noindent With options \opt{short} and \opt{ibid}: \begin{citeonly} \AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}\toggletrue{ibid}} @@ -1989,20 +2084,33 @@ format and the use of \textit{ibid.} First, the short format: Chicago. All rights reserved. Reprinted by permission]{manet1992} \end{citebib} +\setcounter{subsubsection}{56} +\subsubsection{Several citations in one note} +% 14.57 Several citations in one note +\label{14.57} + +See \ref{cust.cmd} for information on how to reproduce this example. + +\begin{quote} Only when we gather the work of several +scholars---Walter Sutton's explications of some of Whitman's shorter +poems; Paul Fussell's careful study of structure in ``Cradle''; S. K. +Coffman's close readings of ``Crossing Brooklyn Ferry'' and ``Passage +to India''; and the attempts of Thomas I. Rountree and John Lovell, +dealing with ``Song of Myself'' and ``Passage to India,'' +respectively, to elucidate the strategy in ``indirection''---do we +begin to get a sense of both the extent and the specificity of +Whitman's forms.\footnotemark[1] \end{quote} + +\begin{citeonly} +\item \idemcites{sutton1959,fussell1962,coffman1954,coffman1955,rountree1958}[and][]{lovell1960} +\end{citeonly} + \setcounter{subsubsection}{58} \subsubsection{Abbreviations for frequently cited works} % 14.59 Abbreviations for frequently cited works \label{14.59} -You may override the default announcement of a \bibfield{shorthand} by -adding your preferred content to \bibfield{shorthandintro}. For an -example, one that prints the announcement in a separate sentence, see -the first citation of \textit{CMOS} in this document's introduction. - -Note that Windy City doesn't automatically italicize a -\bibfield{shorthand}. Per \textit{CMOS} 14.60, a shorthand should be -italicized if the title that it abbreviates is also italicized. Set -this in the bibliography database with \cmd{emph} or \cmd{mkbibemph}. +For information on shorthands, see section \ref{otherfields}. \begin{citebib} % There's no way to suppress these fields in the bibliography: @@ -2019,6 +2127,11 @@ this in the bibliography database with \cmd{emph} or \cmd{mkbibemph}. \subsubsection{The 3-em dash for one repeated name} % 14.68 The 3-em dash for one repeated name +A 3-em dash replaces names in the author's position of a citation in +consecutive citations on the same page. Thus, whether the example +below exactly reproduces that in \textit{CMOS} 14.68 depends in part +on whether a page break falls somewhere within the list. + \begin{bibonly} \nocite{judt1996,judt2008,judt1989,squire1983,squire1987} \end{bibonly} @@ -2065,6 +2178,8 @@ this in the bibliography database with \cmd{emph} or \cmd{mkbibemph}. % 14.78 Author's name in title \label{14.78} +On the use of starred citation commands, see section \ref{std.cmd}. + \begin{citebib} \item \cite*[233]{franklin1868} \item \cite*[234]{franklin1868} @@ -2074,8 +2189,8 @@ this in the bibliography database with \cmd{emph} or \cmd{mkbibemph}. % 14.79 No listed author (anonymous works) \label{14.79} -See section \ref{entryops} on the \opt{anonauth} and \opt{anonauthq} -entry options. +See section \ref{stdfields} on the use of the \bibfield{authtype} +field for anonymous works. \begin{citebib} \item \cite{anon1610} @@ -2097,10 +2212,9 @@ entry options. % 14.81 Cross-references for pseudonyms \label{14.81} -For information on how to add entries that cross-references others, -like several of those below, see section \ref{entrytypes}. For -examples of automatic cross-referencing in a bibliography, see -\ref{14.108} and \ref{15.42}. +For information on how to add entries that cross-reference others, see +section \ref{entrytypes}. For examples of automatic cross-referencing +in a bibliography, see \ref{14.108} and \ref{15.42}. \begin{bibonly} \nocite{ashe,creasey1976,creasey1978,creasey1966,morton,york} @@ -2204,6 +2318,7 @@ database. \setcounter{subsubsection}{98} \subsubsection{Translated titles of cited works} % 14.99 Translated titles of cited works +\label{14.99} \begin{citebib} \item \cite{wereszycki1977}; includes a summary in German. @@ -2429,15 +2544,15 @@ For a discussion of how to handle these types of works, see section % 14.120 Chapters and other parts of individual volumes \label{14.120} -There are some peculiarities with the first example. In the book, but -not online, \textit{CMOS} errs in printing `.ed' rather than `editeb -by' in the bibliography and neglects to invert the author's name. More -worrisome are the striking differences between the note and -bibliography. They may represent alternative ways of formatting the -data, as other examples do. But the note seems inconsistent with -\textit{CMOS} \ref{14.118}, and so doesn't make much sense as an -alternative. Windy City ignores it and in both cases follows the -example of the bibliography. +There are some peculiarities with the first example. In the printed +edition, but not online, \textit{CMOS} errs in having \textit{.ed} +rather than \textit{edited by} in the bibliography and neglects to +invert the author's name. More worrisome are the striking differences +between the note and bibliography. They may represent alternative ways +of formatting the data, as other examples do. But the note seems +inconsistent with \textit{CMOS} \ref{14.118}, and so doesn't make much +sense as an alternative. Windy City ignores it and in both cases +follows the example of the bibliography. \begin{citebib} \item \cite[180]{chen2010.3} @@ -2705,7 +2820,7 @@ the surname twice. Also, for Wilder's article, Windy City prints has it. To print the correct season, Wilder's entry in the bibliography database includes \textit{Fall} in the \bibfield{issue} field. Using the \bibfield{date} field with \textit{2013-23} would -give \textit{Autumn 2013}. +print \textit{Autumn 2013}. \begin{citebib} \item \cite[155]{lock2015} @@ -2759,9 +2874,9 @@ give \textit{Autumn 2013}. \subsubsection{Articles published in installments} % 14.180 Articles published in installments -By default, Windy City will print each installment as a separate -entry. To get the format for the series, you'd need to use the -\bibtype{misc} entry type. +By default, Windy City prints each installment as a separate entry. To +get the format for the series, you'd need to use the \bibtype{misc} +entry type. \begin{citebib} \item \cite[312]{brown1978} @@ -2893,7 +3008,7 @@ entry. To get the format for the series, you'd need to use the \label{14.204} On the use of the \bibfield{type} field to format this example -correctly, see section \ref{fieldscon}. +correctly, see section \ref{stdfields}. \begin{citebib} \item \cite{zeitung1828} @@ -2910,7 +3025,7 @@ correctly, see section \ref{fieldscon}. In \textit{CMOS}, one citation refers to \textit{The Chronicle of Higher Education} and another to \textit{Chronicle of Higher -Education}. The latter appears in \ref{15.51}, so it's probably +Education}. The latter also appears in \ref{15.51}, so it's probably correct. \begin{citebib} @@ -3184,8 +3299,8 @@ midst. \end{citeref} \subsubsection{Author-date format for anonymous works (no listed author)} % 15.34 Author-date format for anonymous works (no listed author) -See section \ref{entryops} on the \opt{anonauth} and \opt{anonauthq} -entry options. +See section \ref{stdfields} on the use of the \bibfield{authtype} +field for anonymous works. \begin{citeref} \item \parencite{anon1610} @@ -3212,8 +3327,9 @@ entry options. \subsubsection{Organization as author in author-date references} % 15.37 Organization as author in author-date references -In the reference list, \textit{CMOS} errs in printing `:1997' after -`ISO 4'. Compare it with the nearly identical example in \ref{14.84}. +In the reference list, \textit{CMOS} errs in printing \textit{:1997} +after \textit{ISO 4}. Compare it with the nearly identical example in +\ref{14.84}. \begin{citeref} \item \parencite{iso1997.ref} @@ -3340,7 +3456,7 @@ from the February 1931 issue of \textit{Poetry} magazine with the argument \opt{shorthand}. Running \cmd{printshorthands} produces the same output. By default, works in this list also appear in bibliographies. To exclude them, use the preamble option -\opt{nolos}. See section \ref{preops} for more information.\\}% +\opt{nolos}. See section \ref{preamble} for more information.\\}% \defbibnote{bib}{This section shows the default output of \cmd{printbibliography}. The next section shows the author-date @@ -3348,7 +3464,7 @@ format.\\}% \defbibnote{ref}{This section shows the output of \cmd{printbibliography} in the author-date format. For information on -how to produce this output, see section \ref{preops}. Issues with +how to produce this output, see section \ref{preamble}. Issues with sorting in this section are mentioned there. Creating a reference list in the preferred way, with the \opt{reflist} preamble option, should prevent those issues.\\}% |