diff options
author | Karl Berry <karl@freefriends.org> | 2020-09-08 21:07:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-09-08 21:07:25 +0000 |
commit | 351aeb2ecc8197c9a399ca8eb0b63f1b578b644d (patch) | |
tree | 004bc72ae6f726ce32cae6aa019355c27cbe99eb /Master/texmf-dist/doc/latex | |
parent | 3741b8b40f8f8c90286ae327cb29eadc441fb84e (diff) |
windycity (8sep20)
git-svn-id: svn://tug.org/texlive/trunk@56297 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/windycity/CHANGES.md | 37 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/windycity/README.md | 46 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.bib | 82 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.pdf | bin | 401582 -> 407030 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.tex | 432 |
5 files changed, 348 insertions, 249 deletions
diff --git a/Master/texmf-dist/doc/latex/windycity/CHANGES.md b/Master/texmf-dist/doc/latex/windycity/CHANGES.md index 11c6ddd25b5..86f7765a372 100644 --- a/Master/texmf-dist/doc/latex/windycity/CHANGES.md +++ b/Master/texmf-dist/doc/latex/windycity/CHANGES.md @@ -8,6 +8,43 @@ indicate updates to Windy City's [repository on GitHub](https://github.com/brianchase/windycity "GitHub: brianchase/windycity"). +## 2020-09-07 + +* added support for revisers and expanded combinations of editor and + translator types: + + - compiled by, comp., comps. + - compiled and edited by, comp. and ed., comps. and eds. + - compiled and revised by, comp. and rev., comps. and revs. + - compiled and translated by, comp. and trans., comps. and trans. + - edited by, ed., eds. + - edited and compiled by, ed. and comp., eds. and comps. + - edited and revised by, ed. and rev., eds. and revs. + - edited and translated by, ed. and trans., eds. and trans. + - revised by, rev., revs. + - revised and compiled by, rev. and comp., revs. and comps. + - revised and edited by, rev. and ed., revs. and eds. + - revised and translated by, rev. and trans., revs. and trans. + - translated by, trans. + - translated and compiled by, trans. and comp., trans and comps. + - translated and edited by, trans. and ed., trans. and eds. + - translated and revised by, trans. and rev., trans. and revs. + +* added support for citing prefaces (akin to citing afterwords, + forewords, and introductions) +* fixed placement of `edition` relative to editors, translators, and + such +* fixed short citations of @Review entries failing to print a review's + title +* fixed output of @InReference entries when they cross-reference a + previously cited @Reference entry +* fixed mismatch in output between `@Article` and `@Periodical` entry + types +* fixed `\parencite` failing to print names in `afterwords`, + `forewords`, and `introduction` fields +* fixed printing `transcomp` and `transed` bibstrings when + `transcomp+` and `transed+` were needed + ## 2019-07-17 * fixed always printing the `date` field in an American format, rather diff --git a/Master/texmf-dist/doc/latex/windycity/README.md b/Master/texmf-dist/doc/latex/windycity/README.md index 499b3cc1808..1c8cd656f6f 100644 --- a/Master/texmf-dist/doc/latex/windycity/README.md +++ b/Master/texmf-dist/doc/latex/windycity/README.md @@ -39,30 +39,12 @@ Windy City consists of four files: * [windycity.cbx](https://github.com/brianchase/windycity/blob/master/cbx/windycity.cbx "windycity.cbx") * [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 may copy its -files to one of several places. One option is to locate -[biblatex](http://www.ctan.org/pkg/biblatex "biblatex") on your system -and use its directories: - -* .../biblatex/[windycity.dbx](https://github.com/brianchase/windycity/blob/master/windycity.dbx "windycity.dbx") -* .../biblatex/bbx/[windycity.bbx](https://github.com/brianchase/windycity/blob/master/bbx/windycity.bbx "windycity.bbx") -* .../biblatex/cbx/[windycity.cbx](https://github.com/brianchase/windycity/blob/master/cbx/windycity.cbx "windycity.cbx") -* .../biblatex/lbx/[american-windycity.lbx](https://github.com/brianchase/windycity/blob/master/lbx/american-windycity.lbx "american-windycity.lbx") - -If you prefer not to mix Windy City's files with -[biblatex](http://www.ctan.org/pkg/biblatex "biblatex")'s, another -option is to find where your distribution of -[LaTeX](https://en.wikipedia.org/wiki/LaTeX "LaTeX") keeps -[biblatex](http://www.ctan.org/pkg/biblatex "biblatex")'s third-party -style files and proceed accordingly. Yet another option is to install -Windy City in your local `texmf`. Its location will depend on your -system and preferences. For a one-off compilation, say, to give Windy -City a trial run on a single document, you can copy Windy City's files -to the document's root directory. - -After copying the files to one of those places — or another of your -choosing — remember that for every option but the last (a document's -root directory), you need to update your `texmf` file name database. +If you need to install Windy City on your system, you have several +options. For a one-off compilation, say, to give Windy City a trial +run on a single document, you could copy Windy City's files to the +document's root directory. Beyond that, your best option is to install +it in your local \path{texmf}. Copy the files to a directory of your +choosing, then update your \path{texmf} file name database. To compile a document with Windy City, tell [biblatex](http://www.ctan.org/pkg/biblatex "biblatex") to load it @@ -77,14 +59,12 @@ files. For some entries in your bibliography database, you may need to add fields or make other adjustments to get the right output. But since -Windy City relies as much as possible on standard -[BibTeX](http://www.bibtex.org "BibTeX") fields, and secondarily on -[biblatex](http://www.ctan.org/pkg/biblatex "biblatex") fields, you -may not need to make major changes. The examples in this document and -its accompanying bibliography database, -[windycity.bib](https://github.com/brianchase/windycity/blob/master/doc/windycity.bib -"windycity.bib"), should serve as a guide for how to manage your input -for nearly every circumstance that the style is meant to handle. +Windy City relies as much as possible on standard \BibTeX\ fields, and +secondarily on \biblatex fields, you may not need to make major +changes. The examples in this document and its accompanying +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. ## License @@ -100,5 +80,5 @@ warranties of merchantability and fitness for a particular purpose. ## Requirements -* [biblatex](http://www.ctan.org/pkg/biblatex "biblatex") 3.8 or higher +* [biblatex](http://www.ctan.org/pkg/biblatex "biblatex") 3.13 or later diff --git a/Master/texmf-dist/doc/latex/windycity/windycity.bib b/Master/texmf-dist/doc/latex/windycity/windycity.bib index 7a06f00739a..a27b370d6de 100644 --- a/Master/texmf-dist/doc/latex/windycity/windycity.bib +++ b/Master/texmf-dist/doc/latex/windycity/windycity.bib @@ -14,7 +14,7 @@ % Examples not in CMOS @Book{doe2010a, - options = {skipbib}, + keywords = {notinbib,notinref}, author = {Doe, Jane}, title = {A Book's Title}, editor = {Smith, John}, @@ -24,7 +24,8 @@ year = {2010} } @Book{doe2010b, - options = {skipbib,swaptrans}, + keywords = {notinbib,notinref}, + options = {swaptrans}, author = {Doe, Jane}, title = {A Book's Title}, editor = {Smith, John}, @@ -34,7 +35,7 @@ year = {2010} } @Book{smith2002a, - options = {skipbib}, + keywords = {notinbib,notinref}, title = {A Book's Title}, editor = {Smith, John}, translator = {Doe, Jane}, @@ -43,7 +44,8 @@ year = {2002} } @Book{smith2002b, - options = {skipbib,swaptrans}, + keywords = {notinbib,notinref}, + options = {swaptrans}, title = {A Book's Title}, editor = {Smith, John}, translator = {Doe, Jane}, @@ -556,7 +558,7 @@ year = {2000} } @Misc{oflaherty, - keywords = {notinbib,notinref},% print in example bib only + keywords = {notinbib,notinref}, author = {Doniger, Wendy}, sorttitle = {See also}, userb = {\emph{See also} O'Flaherty, Wendy Doniger} @@ -1014,6 +1016,7 @@ year = {2004} } @InCollection{mansfield2000, + options = {swaptrans}, introduction = {Mansfield, Harvey, and Delba Winthrop}, pages = {xvii–lxxxvi}, crossref = {tocqueville2000} @@ -1488,6 +1491,27 @@ addendum = {Distributed by University of Chicago Press} } +% 14.142 Publication Date---General + +@Book{chicago2010, + author = {{University of Chicago Press}}, + title = {The Chicago Manual of Style}, + edition = {16}, + address = {Chicago}, + publisher = ucp, + year = {2010} +} +@Book{turabian2013, + author = {Turabian, Kate L.}, + title = {A Manual for Writers of Term Papers, Theses, and Dissertations}, + edition = {8}, + editor = {Booth, Wayne C. and Colomb, Gregory G. and Williams, Joseph M. and {the University of Chicago Press Staff}}, + editortype = {reviser}, + address = {Chicago}, + publisher = ucp, + year = {2013} +} + % 14.144 Multivolume works published over more than one year % 15.41 Multivolume works published over more than one year @@ -1519,16 +1543,16 @@ % 14.145 No date of publication @Book{boston, - options = {skipbib}, + keywords = {notinbib,notinref}, address = {Boston} } @Book{edinburgh1750, - options = {skipbib}, + keywords = {notinbib,notinref}, address = {Edinburgh}, year = {[1750?]} } @Book{edinburgh, - options = {skipbib}, + keywords = {notinbib,notinref}, address = {Edinburgh}, year = {n.d., ca. 1750} } @@ -1536,7 +1560,7 @@ % 14.146 Forthcoming publications @Book{author, - keywords = {notinbib,notinref},% print in example bib only + keywords = {notinbib,notinref}, author = {Author, Jane Q.}, title = {Book Title}, address = {Place}, @@ -1544,7 +1568,7 @@ year = {forthcoming} } @Book{writer, - keywords = {notinbib,notinref},% print in example bib only + keywords = {notinbib,notinref}, author = {Writer, John J.}, title = {Another Book Title}, address = {Place}, @@ -1552,13 +1576,13 @@ year = {forthcoming} } @InCollection{contributor, - keywords = {notinbib,notinref},% print in example bib only + keywords = {notinbib,notinref}, author = {Contributor, Anna}, title = {Contribution}, crossref = {editor} } @Collection{editor, - keywords = {notinbib,notinref},% print in example bib only + keywords = {notinbib,notinref}, title = {Edited Volume}, editor = {Editor, Ellen}, address = {Place}, @@ -1778,6 +1802,7 @@ volume = {21}, number = {2}, date = {2013-21}, + pages = {351--81}, url = {https://doi.org/10.1215/10679847-2018283} } @@ -2557,14 +2582,14 @@ % 15.44 No date of publication in author-date references @Book{nano1750, - keywords = {notinbib,notinref},% print in example bib only + keywords = {notinbib,notinref}, author = {Nano, Jasmine L.}, title = {Title of Work\ldots}, year = {[1750?]}, sortyear = {1750} } @Book{nano, - keywords = {notinbib,notinref},% print in example bib only + keywords = {notinbib,notinref}, author = {Nano, Jasmine L.}, title = {Title of Another Work\ldots}, sortkey = {nodate} @@ -2620,14 +2645,25 @@ doi = {https://doi.org/10.1086/680849} } -% 15.56 “Quoted in” in author-date references +% Bibliography 1.2 -@Book{costello1981, - author = {Costello, Bonnie}, - title = {Marianne Moore}, - subtitle = {Imaginary Possessions}, - address = {Cambridge, MA}, - publisher = {Harvard University Press}, - year = {1981} +@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} +} +@Book{gowers2015, + author = {Gowers, Ernest}, + title = {Plain Words}, + subtitle = {A Guide to the Use of English}, + editor = {Gowers, Rebecca}, + editortype = {revup}, + address = {London}, + publisher = {Penguin Books}, + year = {2015} } - diff --git a/Master/texmf-dist/doc/latex/windycity/windycity.pdf b/Master/texmf-dist/doc/latex/windycity/windycity.pdf Binary files differindex dee59d14cfb..b7edd45385a 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 26f7f47b9bb..4fb93bddf9c 100644 --- a/Master/texmf-dist/doc/latex/windycity/windycity.tex +++ b/Master/texmf-dist/doc/latex/windycity/windycity.tex @@ -1,4 +1,4 @@ -% Last modified: Wed 17 Jul 2019 09:36:07 AM CDT +% Last modified: Mon 07 Sep 2020 06:51:00 PM CDT \documentclass[11pt,letterpaper,oneside]{article} \usepackage{windycity} @@ -8,7 +8,7 @@ \author{Brian Michael Chase} \email{brianmichaelchase@gmail.com} \website{https://github.com/brianchase/windycity} -\version{2019-07-17} +\version{2020-09-07} \maketitle \begingroup \hypersetup{linkcolor=black} @@ -30,30 +30,29 @@ to the 17th edition of \textit{The Chicago Manual of Style} 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, and compilers within a single citation. These features -make Windy City especially suitable for academic work. +translators, compilers, and revisers 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 style's features. Section \ref{edtrans} discusses the assignment and -placement of editors, translators, and compilers. Section +placement of editors, translators, and the like. Section \ref{collections} discusses several issues with collections, including options for formatting citations of individual volumes. Sections \ref{notes} and \ref{paren} reproduce examples from \textit{CMOS} Chapters 14 and 15, respectively, with occasional commentary and references to other sections. -Windy City requires \biblatex version 3.8 or later. +Windy City requires \biblatex version 3.13 or later. \section{Overview} \label{overview} This section covers basic information about Windy City. If you're completely new to \biblatex, you should probably glance at its -documentation and try one of the styles that come with it, if only to -get a sense of the basic commands. For the impatient, examples in -Sections \ref{default}, \ref{short}, \ref{notes}, and \ref{paren} -might be of more immediate interest. +documentation. For the impatient, examples in Sections \ref{default}, +\ref{short}, \ref{notes}, and \ref{paren} might be of more immediate +interest. \subsection{Getting Started} @@ -78,29 +77,12 @@ Windy City consists of four files: \item \file{american-windycity.lbx} \end{itemize} -\noindent If you need to install Windy City on your system, you may -copy its files to one of several places. One option is to locate -\biblatex on your system and use its directories: - -\begin{itemize}[before=\small,label=] -\item \ldots\path{/biblatex/windycity.dbx} -\item \ldots\path{/biblatex/bbx/windycity.bbx} -\item \ldots\path{/biblatex/cbx/windycity.cbx} -\item \ldots\path{/biblatex/lbx/american-windycity.lbx} -\end{itemize} - -If you prefer not to mix Windy City's files with \biblatex's, another -option is to find where your distribution of \LaTeX\ keeps \biblatex's -third-party style files and proceed accordingly. Yet another option is -to install Windy City in your local \path{texmf}. Its location will -depend on your system and preferences. For a one-off compilation, say, -to give Windy City a trial run on a single document, you can copy -Windy City's files to the document's root directory. - -After copying the files to one of those places---or another of your -choosing---remember that for every option but the last (a document's -root directory), you need to update your \path{texmf} file name -database. +If you need to install Windy City on your system, you have several +options. For a one-off compilation, say, to give Windy City a trial +run on a single document, you could copy Windy City's files to the +document's root directory. Beyond that, your best option is to install +it in your local \path{texmf}. Copy the files to a directory of your +choosing, then update your \path{texmf} file name database. To compile a document with Windy City, tell \biblatex to load it with the load-time option \opt{style}: @@ -133,10 +115,9 @@ it accordingly with \sty{babel} or \sty{polyglossia} before loading 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}, perhaps as the last in a list of languages, 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}. +\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 @@ -390,10 +371,10 @@ discussion of multivolume works, see Section \ref{multivolume}. \optitem[false]{firstshort}{\opt{true}, \opt{false}} -\noindent Use this option to shorten the first citation of each work. -The resulting format 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} +\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 +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 conjunction with \opt{ibid}. However, it adds nothing to \opt{short}, which has the same effect on first citations. @@ -553,8 +534,8 @@ such as \cmd{cite*} and \cmd{footcite*}. \optitem[false]{skipdate}{\opt{true}, \opt{false}} \noindent On rare occasions, you may need an entry in a reference list -to skip the \textit{date} of the author-date format. For examples, see -Section \ref{entrytypes}. +to skip the \textit{date} of the author-date format. See Section +\ref{entrytypes} for examples. \optitem[false]{swapauth}{\opt{true}, \opt{false}} @@ -645,19 +626,17 @@ author's name clear. From \textit{CMOS} \ref{14.78}: \cmditem{cites*}[prenote][postnote]{key} -Like \cmd{cites} but, like \cmd{cite*}, suppresses the author's -position of a note. +Like \cmd{cites} but suppresses the author's position. \cmditem{footcite*}[prenote][postnote]{key} -Like \cmd{footcite} but suppresses the author's position of a note. +Like \cmd{footcite} but suppresses the author's position. \cmditem{parencite*}[prenote][postnote]{key} -Like \cmd{parencite} but suppresses the author's position of a -parenthetical citation. This is useful in passages where the author -receives explicit mention. Here's an example from \textit{CMOS} -\ref{15.25}: +Like \cmd{parencite} but suppresses the author's position. This is +useful in passages where the author receives explicit mention. Here's +an example from \textit{CMOS} \ref{15.25}: \begin{quote} Fiorina et al. \parencite*{fiorina2005} and Fischer and Hout \parencite*{fischer2006} reach more or less the same conclusions. @@ -675,13 +654,11 @@ The source for the passage above contains: \cmditem{smartcite*}[prenote][postnote]{key} -Like \cmd{smartcite} but suppresses the author's position of a -citation. +Like \cmd{smartcite} but suppresses the author's position. \cmditem{smartcites*}[prenote][postnote]{key} -Like \cmd{smartcites} but, like \cmd{smartcite*}, suppresses the -author's position of a citation. +Like \cmd{smartcites} but suppresses the author's position. \cmditem{textcite}[prenote][postnote]{key} @@ -708,8 +685,8 @@ the note's internal parentheses to brackets. \cmditem{textcite*}[prenote][postnote]{key} -Like \cmd{textcite} but suppresses the author's position of a note, as -in this passage from \textit{CMOS} 13.65: +Like \cmd{textcite} but suppresses the author's position, as in this +passage from \textit{CMOS} 13.65: \begin{quote} In their introduction to \textcite*{tocqueville1999}, translators Harvey Mansfield and Delba Winthrop write that Tocqueville @@ -726,13 +703,11 @@ The source for the passage above contains: \cmditem{textcites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} -Like \cmd{textcite} but for multiple sources in the same way as -\cmd{cites} and \cmd{smartcites}. +Like \cmd{textcite} but for multiple sources. \cmditem{textcites*}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} -Like \cmd{textcites} but, like \cmd{textcite*}, suppresses the author's -position of a note. +Like \cmd{textcites} but suppresses the author's position. \end{ltxsyntax} @@ -815,7 +790,7 @@ the article cross-ref\-er\-enc\-ed to a \bibtype{reference} entry for article from the source.\footnote{Incidentally, reference works don't always have titles in italics. As a result, you need to handle it in your bibliography database.} But you could also have a single entry of -either type with the same data, like this: +either type with the same data: \begin{verbatim} @Reference{salvation1980, @@ -888,33 +863,31 @@ cross-referencing in notes and bibliographies see Section \ref{notes}, \ref{collections}. For more information on entry types---specifically, on the use of -certain data fields with them---see Section \ref{datafields}. +certain data fields---see Section \ref{datafields}. \subsection{Data Fields} \label{datafields} -As Windy City has grown to support more citations, it has had to add -data fields that aren't recognized by \BibTeX\ or \biblatex. It also -uses some standard ones in perhaps unexpected ways. +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} -Some of Windy City's additional or 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}. +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}. Of -course, already existing fields would have been preferable for this -purpose. But since blog posts take the usual \bibfield{title} and -\bibfield{subtitle}, and since blogs may have host names of different -sorts, new fields seemed necessary. +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}, @@ -936,12 +909,9 @@ 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}. Use it in a bibliography database when a work's -\bibfield{maintitle} may occupy the position of a regular title in a -short citation and needs a short form. This should only happen with -certain works in collections. See, for example, the citation of -\textit{The Complete Tales of Henry James} in Section -\ref{multivolume}. +\bibfield{maintitle}. This should only be necessary for certain works +in collections. See, for example, the citation of \textit{The Complete +Tales of Henry James} in Section \ref{multivolume}. \end{marglist} @@ -957,7 +927,7 @@ uses standard data fields. The list below discusses some of them. number of the edition in this field---for example, \textit{2} for a second edition. To indicate a revised edition, enter either \textit{revised} or \textit{rev. ed.} Both options give the same -output. You may also use the field to indicate a newspaper's edition, +output. You may also use this field to indicate a newspaper's edition, such as \textit{Sunday Book Review} (see \textit{CMOS} \ref{14.202}). \item[issue] Windy City uses this field with the \bibtype{article}, @@ -965,9 +935,8 @@ such as \textit{Sunday Book Review} (see \textit{CMOS} \ref{14.202}). season of publication (spring, summer, autumn/fall, winter). The \bibtype{date} field also records seasons---but the value \textit{23}, for the third season, returns \textit{Autumn}. To print \textit{Fall}, -use an \bibfield{issue} field with that value. In other words, for the -output \textit{Fall 2013}, a work's bibliography database entry should -contain: +use the \bibfield{issue} field. In other words, for \textit{Fall +2013}, a work's bibliography database entry should contain: \begin{verbatim} issue = {Fall}, @@ -993,45 +962,45 @@ publication, you may use the classic \bibfield{year} field instead. \item[series] See the comments for \bibfield{seriesaddon} in Section \ref{datafields}. -\item[type] With the \bibtype{thesis} entry type, Windy City uses the -\bibfield{type} field to distinguish a Master's thesis from a PhD -dissertation. For the latter, \bibtype{type} should have the values +\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 \textit{phdthesis} or \textit{PhD diss.} For the former, use \textit{mathesis} or \textit{master's thesis}. No \bibfield{type} field is needed for the \bibtype{mathesis} and \bibtype{phdthesis} entry types. -In rare cases, the \bibfield{type} field is necessary for the -\bibtype{article} and \bibtype{review} entry types when a work's -bibliographic information doesn't allow Windy City to distinguish a -journal article from a magazine or newspaper article. This happens -when a magazine or newspaper article has an issue number. Normally, -Windy City would respond by printing the issue number before the date -and enclosing the date in parentheses. But the issue number needs to -go first, and the date shouldn't be in parentheses. The workaround is -to include a \bibfield{type} field with the value \textit{newsmag}. -For an example, see \textit{CMOS} \ref{14.204} and compare it with the -citation of Beattie in \ref{14.171}. +In rare cases, \bibfield{type} is necessary for the \bibtype{article} +and \bibtype{review} entry types when a work's bibliographic +information doesn't allow Windy City to distinguish a journal article +from a magazine or newspaper article. This happens when a magazine or +newspaper article has an issue number. Normally, Windy City would +respond by printing the issue number before the date and enclosing the +date in parentheses. But the issue number needs to go first, and the +date shouldn't be in parentheses. The workaround is to include a +\bibfield{type} field with the value \textit{newsmag}. For an example, +see \textit{CMOS} \ref{14.204} and compare it with the citation of +Beattie in \ref{14.171}. \end{marglist} -\section{Editors, Translators, and Compilers} +\section{Editors, Translators, Compilers, and Revisers} \label{edtrans} Windy City offers significant control over the handling of editors, -translators, and compilers. Taking advantage of it, however, may not +translators, and the like. Taking advantage of it, however, may not seem intuitive at first. This section covers the options and issues that you need to grasp in order to master this aspect of the style. -\subsection{Types of Editors, Translators, and Compilers} +\subsection{Types of Editors and Translators} \label{edtransnames} For the most part, Windy City associates the \bibfield{editor} and \bibfield{translator} fields with the lowest level title within the scope of an entry. In most cases, then, you can assign editors and translators simply by adding the \bibfield{editor} and -\bibfield{translator} fields to a database entry. Below is the entry -for an example in \textit{CMOS} \ref{14.104}: +\bibfield{translator} fields to a database entry. The entry below is +an example from \textit{CMOS} \ref{14.104}: \begin{verbatim} @Collection{adorno1999, @@ -1050,7 +1019,7 @@ for an example in \textit{CMOS} \ref{14.104}: \end{citebib} \noindent When the style processes this entry, it identifies the -editor and translator of the work with the names, respectively, in the +editor and translator of the work with the names in the \bibfield{editor} and \bibfield{translator} fields. Since the entry doesn't use the \opt{swaptrans} entry option (see Section \ref{edtranspos}), the resulting output lists the editor and @@ -1089,7 +1058,7 @@ with \textit{Harlem}. If you moved \bibfield{editor} from \bibtype{collection} to \bibtype{incollection}, the association would change to \textit{The Literature of Harlem}. -Consider another example, this one an essay in a collection: +Consider another example: \begin{citebib} \item \cite{petrarca1948} @@ -1113,7 +1082,7 @@ scope of the \bibtype{incollection} entry: Jr., John Herman}, title = {The Renaissance Philosophy of Man}, address = {Chicago}, - publisher = ucp, + publisher = {University of Chicago Press}, year = {1948} } \end{verbatim} @@ -1122,35 +1091,110 @@ scope of the \bibtype{incollection} entry: scope of \bibtype{collection}, the style associates it with \textit{The Renaissance Philosophy of Man}. -Sometimes, you need to designate the role of an editor with the field -\bibfield{editortype}. The values of \bibfield{editortype} are -\textit{maintitle}, \textit{series}, \textit{issuetitle}, and -\textit{compiler}. As for the latter, Windy City treats -\textit{compiler} as a kind of editor. So, if you need to add a -compiler to an entry, add the compiler's name to an available field -for an editor, then add an appropriate \bibfield{editortype} field -with the value \textit{compiler}. It may help to see the bibliography -database entry for an example in \textit{CMOS} \ref{14.103}: +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}: \begin{verbatim} @Book{schechter2011, - editor = {Schechter, Harold, and Kurt Brown}, - editortype = {compiler}, - title = {Killer Verse}, - subtitle = {Poems of Murder and Mayhem}, - address = {London}, - publisher = {Everyman Paperback Classics}, - year = {2011} + editor = {Schechter, Harold, and Kurt Brown}, + editortype = {compiler}, + title = {Killer Verse}, + subtitle = {Poems of Murder and Mayhem}, + address = {London}, + publisher = {Everyman Paperback Classics}, + year = {2011} + } + @Book{turabian2013, + author = {Turabian, Kate L.}, + title = {A Manual for Writers of Term Papers, Theses, and + Dissertations}, + edition = {8}, + editor = {Booth, Wayne C. and Colomb, Gregory G. and + Williams, Joseph M. and {the University of Chicago + Press Staff}}, + editortype = {reviser}, + address = {Chicago}, + publisher = {University of Chicago Press}, + year = {2013} } \end{verbatim} \begin{citebib} \item \cite{schechter2011} +\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 +not also its translator \textit{and} compiler or translator +\textit{and} reviser, and so on. And just as you can swap the order of +the editor and translator roles (again, see Section \ref{edtranspos}), +you can swap the other combinations, say, to identify a work as +``compiled and edited by'' Jane Doe rather than ``edited and compiled +by'' her. The output depends on the value of \bibfield{editortype}. +See Table \ref{table:ed} for a summary. + +\begin{table}[H] +\caption{} \label{table:ed} +\begin{tabular}{@{}r l@{}} +\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\\ +\end{tabular} +\end{table} + +For an example in \textit{CMOS} of a such a dual role, we need turn to +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} + +\begin{citebib} +\item \cite{fowler1965} \end{citebib} -Follow the same pattern for editors of a \bibfield{maintitle}, -\bibfield{series}, or \bibfield{issuetitle}. Here's an example from -\textit{CMOS} \ref{14.123}: +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. + +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. + +Three more values of \bibfield{editortype} allow you to assign editors +to higher level titles: \textit{maintitle}, \textit{series}, and +\textit{issuetitle}. Here's an example from \textit{CMOS} +\ref{14.123}: \begin{verbatim} @Book{allen2009, @@ -1161,7 +1205,7 @@ Follow the same pattern for editors of a \bibfield{maintitle}, editor = {Stimpson, Catharine R.}, editortype = {series}, address = {Chicago}, - publisher = ucp, + publisher = {University of Chicago Press}, year = {2009} } \end{verbatim} @@ -1171,36 +1215,32 @@ Follow the same pattern for editors of a \bibfield{maintitle}, \end{citebib} \noindent If there were no \bibfield{editortype} assigning the editor -to the series, Windy City would assume that she's the book's editor. -In short, for a title's compilers and for any title at a higher level -than the \bibfield{title} field, you need to use +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 +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. - -Windy City's support for translators falls between its support for -editors and compilers. Unless a work's bibliography database entry has -a \bibfield{translatortype} field with the value \textit{maintitle}, -Windy City associates the names in \bibfield{translator} with the -entry's lowest level title. (Recall ``The Ascent of Mont Ventoux'' -above.) You should rarely, and perhaps never, need more than one set -of translators per work. But if you do, Windy City lets you assign as -many as three, if you cross-reference a work with one set of -translators to another with two. Does any such work exist? Probably -not. Anyway, support for it is something of an accident, stemming in -large part from how the style handles cross-referencing with editors. - -One complication remains: There are other name lists for editors than -\bibfield{editor}. There's \bibfield{editora}, \bibfield{editorb}, and -\bibfield{editorc}. - -Reserve \bibfield{editor} for the lowest level title in a bibliography -database entry. That should be the \bibfield{title} field. The next -level up, as it were, is for \bibfield{editora}, followed by -\bibfield{editorb}, and so on. Remember to include the appropriate -\bibfield{type} field to indicate an editor's role. These fields are -\bibfield{editortype} (for \bibfield{editor}), +you to just one set of compilers and revisers. + +What about translators? Unless a work's bibliography database entry +has a \bibfield{translatortype} field with the value +\textit{maintitle}, Windy City associates the names in +\bibfield{translator} with the entry's lowest level title. (Recall +``The Ascent of Mont Ventoux'' above.) You should rarely, and perhaps +never, need more than one set of translators per work. But if you do, +Windy City lets you assign as many as three---as long as you +cross-reference a work with one set of translators to another with +two. + +The style has three other name lists for editors: \bibfield{editora}, +\bibfield{editorb}, and \bibfield{editorc}. If a work has more than +one set of editors, list editors of the lowest level title in +\bibfield{editor}. Usually, those are editors of a \bibfield{title}. +The next level up, as it were, is for \bibfield{editora}, followed by +\bibfield{editorb}, then \bibfield{editorc}. Remember to include the +appropriate \bibfield{type} field to indicate an editor's role. These +fields are \bibfield{editortype} (for \bibfield{editor}), \bibfield{editoratype} (for \bibfield{editora}), \bibfield{editorbtype} (for \bibfield{editorb}), and \bibfield{editorctype} (for \bibfield{editorc}). @@ -1212,7 +1252,7 @@ clever than the previous paragraph suggests. In particular, if you use \bibfield{maintitle} or some other higher level title, and have an \bibfield{editora} with no corresponding \bibfield{editoratype}, Windy City will assume that \bibfield{editora} is the editor of the -\bibfield{title}. Regardless, the best practice is the follow the rule +\bibfield{title}. Regardless, the best practice is to the follow the rule of thumb described above, reserving \bibfield{editor} for \bibfield{title} and working up from there. @@ -1423,8 +1463,8 @@ This drawback shouldn't affect \bibfield{bookinbook}, \bibfield{inbook}, \bibfield{incollection}, or \bibfield{letter} 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. As for examples, it seems that -\textit{CMOS} gives exactly one in \ref{14.120}: +City can use for proper sorting. It seems that \textit{CMOS} gives +exactly such example one in \ref{14.120}: \begin{citebib} \item \cite[169--71]{king2014} @@ -1442,13 +1482,12 @@ City can use for proper sorting. As for examples, it seems that \AtNextBibliography{\toggletrue{swapvol}} \end{citebib} -In neither set of examples does Windy City print the volume number -before the page reference. That's because, with or without -\opt{swapvol}, the citation is directly to the work's title, not to -the collection. The same goes for articles, chapters, books, and other -works of this type. Further, consistent with \textit{CMOS} -\ref{14.108} and \ref{15.42}, Windy City cross-references previously -cited volumes. +In neither case does Windy City print the volume number before the +page reference. That's because, with or without \opt{swapvol}, the +citation is directly to the work's title, not to the collection. The +same goes for articles, chapters, books, and other works of this type. +Further, consistent with \textit{CMOS} \ref{14.108} and \ref{15.42}, +Windy City cross-references previously cited volumes. % Due to 'mincrossrefs=2', jones2018 would be added automatically to % the bibliography at the end of the document because it's referenced @@ -1549,7 +1588,7 @@ however, has just one field for a publication date, so using can find examples of both approaches in \file{windycity.bib}. Certain entries cross-referenced to entries that work with -\opt{swapvol} also work with it. Those enty types are limited to +\opt{swapvol} also work with it. Those entry types are limited to \bibtype{bookinbook}, \bibtype{inbook}, \bibtype{incollection}, or \bibtype{letter}. For the letter cited above: @@ -1558,7 +1597,6 @@ Certain entries cross-referenced to entries that work with author = {King, Jr., Martin Luther}, title = {Unpublished letter to the editor of the \emph{Afro-American} (Washington, DC)}, -% crossref = {carson2014} crossref = {armstrong2014} } \end{verbatim} @@ -1659,7 +1697,7 @@ as a whole. Here's the entry for \textit{The Lisle Letters}: title = {The Lisle Letters}, volumes = {6}, address = {Chicago}, - publisher = ucp, + publisher = {University of Chicago Press}, year = {1981} } \end{verbatim} @@ -1683,12 +1721,12 @@ the appropriate abbreviations (for some examples, see \textit{CMOS} \cite[vol. 3, chap. 9]{byrne1981} \end{verbatim} -What if you leave the \bibfield{postnote} empty? In that case, 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: +What if you leave the \bibfield{postnote} 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: \begin{citeonly} \item \cite{byrne1981} @@ -1790,17 +1828,16 @@ accordingly: \noindent If \bibfield{volume} were within the scope of \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}, that it's a volume of a collection, -like other works in this section. 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}. +Works of Benedict de Spinoza}, that it's a volume of a collection. 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}. \section{Examples from \emph{CMOS} Chap. 14, ``Notes and Bibliography''} @@ -2494,10 +2531,10 @@ field for the second example below contains \textit{vol. 6}. \subsubsection{No place of publication} % 14.132 No place of publication -\begin{citebib} +\begin{citeonly} \item \cite{windsor1910} \item \cite{vliet1890} -\end{citebib} +\end{citeonly} \setcounter{subsubsection}{136} \subsubsection{Self-published or privately published books} @@ -2523,6 +2560,17 @@ field for the second example below contains \textit{vol. 6}. \item \cite{willke2007} \end{citebib} +\subsubsection{Publication Date---General} +% 14.142 Publication Date---General +\label{14.142} + +\begin{citebib} +\AtNextCitekey{\clearfield{shorthand}} +%\item \cite[6.56; cf. 16th ed. (2010), 6.54]{chicago2017} +\item \cite*[6.56]{chicago2017}; cf. 16th ed. \parencite*{chicago2010}, 6.54. +\item \cite{turabian2013} +\end{citebib} + \setcounter{subsubsection}{143} \subsubsection{Multivolume works published over more than one year} % 14.144 Multivolume works published over more than one year @@ -2545,11 +2593,9 @@ field for the second example below contains \textit{vol. 6}. \subsubsection{No date of publication} % 14.145 No date of publication -\begin{citebib} -\item \cite{boston} -\item \cite{edinburgh1750} -\item \cite{edinburgh} -\end{citebib} +\begin{bibonly} +\nocite{boston,edinburgh1750,edinburgh} +\end{bibonly} \subsubsection{Forthcoming publications} % 14.146 Forthcoming publications @@ -2680,7 +2726,7 @@ give \textit{Autumn 2013}. % 14.178 Journal special issues \begin{citebib} -\item \cite[351--81]{tezuka2013} +\item \cite{tezuka2013} \end{citebib} \setcounter{subsubsection}{179} |