diff options
Diffstat (limited to 'Master/texmf-dist/doc')
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/CHANGES.md | 177 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.bib | 40 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.pdf | bin | 397730 -> 401582 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.tex | 220 |
4 files changed, 279 insertions, 158 deletions
diff --git a/Master/texmf-dist/doc/latex/windycity/CHANGES.md b/Master/texmf-dist/doc/latex/windycity/CHANGES.md index f0a736b4913..11c6ddd25b5 100644 --- a/Master/texmf-dist/doc/latex/windycity/CHANGES.md +++ b/Master/texmf-dist/doc/latex/windycity/CHANGES.md @@ -8,23 +8,33 @@ indicate updates to Windy City's [repository on GitHub](https://github.com/brianchase/windycity "GitHub: brianchase/windycity"). +## 2019-07-17 + +* fixed always printing the `date` field in an American format, rather + than in formats set in localization files +* for documents not in English, check for `<language>-windycity.lbx` + and, if available, use it instead of `american-windycity.lbx` +* defined `\textcite`, `\texcite*`, `\textcites` and `\textcites*` + (useful for examples in *CMOS* 13.65) + ## 2019-04-02 -* fixed '\parencite' from printing a work's publication year twice - under the preamble option 'reflist' +* fixed `\parencite` from printing a work's publication year twice + under the preamble option `reflist` * fixed the failure of the 3-em dash to print in bibliographies when compiling with different languages -* fixed '\autocite'; it should work for options 'footnote', - 'inline', and 'plain' and with all preamble options -* defined '\smartcite', '\smartcite*', and '\smartcites' +* fixed `\autocite`; it should work for options `footnote`, + `inline`, and `plain` and with all preamble options +* defined `\smartcite`, `\smartcite*`, `\smartcites`, and + `\smartcites*` ## 2019-03-27 -* fixed a bug that could prevent names in the 'editora' field from +* fixed a bug that could prevent names in the `editora` field from printing in the author's position -* fixed typos that broke the 'mathesis' entry type -* fixed 'mathesis' and 'phdthesis' entry types so that they don't need - a 'type' field to distinguish the MA from the PhD (only the 'thesis' +* fixed typos that broke the `mathesis` entry type +* fixed `mathesis` and `phdthesis` entry types so that they don't need + a `type` field to distinguish the MA from the PhD (only the `thesis` entry type needs it) * improved support for newspapers and magazines with issue numbers (see updated documentation on how to implement it) @@ -34,50 +44,50 @@ brianchase/windycity"). ## 2019-02-21 * fixed reviews with titles -* in reference lists, fixed 'year' printing with 'season' or 'issue' +* in reference lists, fixed `year` printing with `season` or `issue` * much improved format of unsigned reviews in bibliographies and reference lists, in part restoring previous work set aside -* extended 'swapvol' option to work with 'letter', 'incollection', - 'inbook', and 'bookinbook' entries that are cross-referenced to - entries that work with 'swapvol' (in effect, you can use 'swapvol' not +* extended `swapvol` option to work with `letter`, `incollection`, + `inbook`, and `bookinbook` entries that are cross-referenced to + entries that work with `swapvol` (in effect, you can use `swapvol` not only with volumes in collections but with works in those volumes, such as chapters and articles) * improved handling of editors and translators, including support for - translators of a 'maintitle' -* added 'library' entry and preamble options to support the 'library' + translators of a `maintitle` +* added `library` entry and preamble options to support the `library` field -* extended 'swapauth' to work with 'mvbook' and 'mvcollection' entries -* added support for \iffieldbibstring in processing 'edition' and - 'type' fields +* extended `swapauth` to work with `mvbook` and `mvcollection` entries +* added support for `\iffieldbibstring` in processing `edition` and + `type` fields * other bug fixes ## 2019-01-31 * added limited support for citing web pages and social media content -* added 'listvols' entry option (see documentation) -* added 'skipdate' entry option (see documentation) +* added `listvols` entry option (see documentation) +* added `skipdate` entry option (see documentation) * significant changes for tighter control of punctuation, among - other things fixing the previous use of 'postpunct' + other things fixing the previous use of `postpunct` * fixed printing of publication dates for some reports -* fixed 'nameaddon' not printing after a 3-em dash in bibliographies +* fixed `nameaddon` not printing after a 3-em dash in bibliographies (presumably, screen names should also print in this context; they do now) * fixed a show-stopping bug in reference lists caused by the - previous fix to 'nameaddon' + previous fix to `nameaddon` * fixed reprints, cross-referencing in reference lists * other bug fixes ## 2019-01-18 * reversed default for collections, printing information for volumes - first; the option to reverse this is called 'swapvol' -* changed option name 'transfirst' to 'swaptrans' -* fixed punctuation before 'postnote' of articles and reviews (ugh!) -* changed processing of spacing and punctuation around 'postnote' for + first; the option to reverse this is called `swapvol` +* changed option name `transfirst` to `swaptrans` +* fixed punctuation before `postnote` of articles and reviews (ugh!) +* changed processing of spacing and punctuation around `postnote` for all citations * added support for swapping the place of an author with an editor or - translator, as in CMOS 14.104 -* extended the previous to cover a similar case in CMOS 14.122 + translator, as in *CMOS* 14.104 +* extended the previous to cover a similar case in *CMOS* 14.122 * improved handling of name lists and cross-referencing * removed no longer maintained citation commands * other bug fixes and housekeeping @@ -88,15 +98,15 @@ brianchase/windycity"). * fixed \parencite for unsigned articles * fixed \parencite for cross-referencing * fixed formatting of reviews -* added support for 'autopunct' option and 'postpunct' field for +* added support for `autopunct` option and `postpunct` field for better handling of punctuation after citation commands (e.g. - '\cite{something}' will end with a period, while '\cite{something};' + `\cite{something}` will end with a period, while `\cite{something};` will end with a semicolon) * in light of the previous, changed \reprint command -* added support for 'shortjournal' field for parenthetical citations -* simplified 'parencite' and related macros -* improved handling of 'year', 'endyear', 'bookyear', and - 'endbookyear' fields, ensuring that the publication date of the last +* added support for `shortjournal` field for parenthetical citations +* simplified `parencite` and related macros +* improved handling of `year`, `endyear`, `bookyear`, and + `endbookyear` fields, ensuring that the publication date of the last mentioned work gets printed in bibliographies and reference lists * many bug fixes @@ -105,7 +115,7 @@ brianchase/windycity"). * simpler processing of author's position * added support for common reference works, such as dictionaries and encyclopedias -* fixed \defbibcheck for reference works +* fixed `\defbibcheck` for reference works * fixed short option printing urls and related data on first citations * some fixes, though incomplete, for reviews * other fixes for spacing and punctuation @@ -115,35 +125,35 @@ brianchase/windycity"). * added much better support for cross-referencing collections in notes and bibliographies, including enhanced support for treating multivolume collections as a single work -* support for short format of citations, with 'short' and 'ibid' +* support for short format of citations, with `short` and `ibid` preamble options * added support for self-published books * added support for electronic article IDs -* added support for 'shortauthor' namelist +* added support for `shortauthor` namelist * better processing of reviews, though still limited * fixed and improved multicite output -* undid change to 'noauth' entry option (it was right the first time!) +* undid change to `noauth` entry option (it was right the first time!) * many bug fixes (mainly spacing, punctuation, and toggles) * new documentation ## 2018-11-26 -* fixed 'noauth' entry option (it should only affect notes) -* fixed 'inst+loc+date' -* following CMOS, made 'cite:short' print just a work's title without - the name of the collection +* fixed `noauth` entry option (it should only affect notes) +* fixed `inst+loc+date` +* following *CMOS*, made `cite:short` print just a work's title + without the name of the collection * fixed name formatting for affixes like 'Jr.' in notes (no comma before them, unlike in bibliographies, where names are inverted) * limited support for copublication * limited support for publication times -* added '\footcite*' command and updated documentation +* added `\footcite*` command and updated documentation ## 2018-11-23 * improved and in some cases fixed processing of numbers, dates, and issues of periodicals * much better support for unsigned articles -* fixed 'type' field format +* fixed `type` field format * fixed double printing of year for theses and dissertations in the author-date system * fixed punctuation after 'Special issue' in bibliographies @@ -154,98 +164,99 @@ brianchase/windycity"). ## 2018-11-17 -* replaced \ifthenelse with commands from etoolbox +* replaced `\ifthenelse` with commands from etoolbox * better handling of editors for a series, maintitle, or issuetitle -* limited support for 'endmonth' field for periodicals -* fixed extra space from multicitedelim +* limited support for `endmonth` field for periodicals +* fixed extra space from `multicitedelim` ## 2018-11-14 * finally got a handle on the author-date format for periodicals, rolling back some recent changes (ugh!) -* put back preamble options 'useeditor' and 'usetranslator', which +* put back preamble options `useeditor` and `usetranslator`, which are necessary after all (double ugh!) * more readable and arguably simpler date processing for periodicals -* added preamble option 'ibid' to prepare for the 17th edition of CMOS -* updated windycity.tex to reflect the last point, also to make use of - optionlist -* remove unused entries from windycity.bib for the 15th edition of - CMOS +* added preamble option `ibid` to prepare for the 17th edition of + *CMOS* +* updated `windycity.tex` to reflect the last point, also to make use + of `optionlist` +* remove unused entries from `windycity.bib` for the 15th edition of + *CMOS* ## 2018-11-13 * fixed spacing of date for periodicals (resulting from recent support - for endday field) + for `endday` field) * fixed spacing between volumes and pages in author-date system for periodicals -* support names of anonymous authors as in CMOS 14.80 (16th edition) - and CMOS 14.79 (17th edition) +* support names of anonymous authors as in *CMOS* 14.80 (16th edition) + and *CMOS* 14.79 (17th edition) ## 2018-11-09 -* for articles etc., limited support for 'season' field -* limited support for 'endyear' and 'endorigyear' fields +* for articles etc., limited support for `season` field +* limited support for `endyear` and `endorigyear` fields * removed unused preamble options and commented code -* fix 'inreference' bibliography alias +* fix `inreference` bibliography alias ## 2018-11-02 * fixed author-date system printing the year of many articles twice * fixed author-date system printing the year between an author's name - and the field 'nameaddon' + and the field `nameaddon` * fixed bibliography driver for shorthands that caused it to print just titles, rather than full entries -* added support for 'endday' field -* 'addendum' field prints only in bibliographies and reference +* added support for `endday` field +* `addendum` field prints only in bibliographies and reference lists, not in notes -* set 'parentracker' preamble option -* set minxrefs preamble option -* 'collsonly' preamble option sets 'minxrefs=1' -* changed 'pagetracker' preamble option from 'true' to 'page' -* edits and fixes to windycity.sty and windycity.tex +* set `parentracker` preamble option +* set `minxrefs` preamble option +* `collsonly` preamble option sets `minxrefs=1` +* changed `pagetracker` preamble option from `true` to `page` +* edits and fixes to `windycity.sty` and `windycity.tex` ## 2018-10-20 * fixed broken date formatting in author-date citations -* changed \DeclareSortingScheme to \DeclareSortingTemplate -* changed preamble option 'labeldate' to 'labeldateparts' -* changed special field 'extrayear' to 'extradate' +* changed `\DeclareSortingScheme` to `\DeclareSortingTemplate` +* changed preamble option `labeldate` to `labeldateparts` +* changed special field `extrayear` to `extradate` * bumped minimum compatible release to biblatex 3.8 * other minor changes for the version bump ## 2015-12-28 -* added missing \setunit for when bybookauthor prints an author's name - and the collection has an editor, translator, or compiler +* added missing `\setunit` for when `bybookauthor` prints an author's + name and the collection has an editor, translator, or compiler ## 2015-07-08 * removed an unused bibmacro -* minor edits and fixes to windycity.sty and windycity.tex +* minor edits and fixes to `windycity.sty` and `windycity.tex` * minor edits to readme -* removed an empty line from windycity.bib +* removed an empty line from `windycity.bib` * changed the version number format to match the release date ## 2014-03-21 * improved and fixed cross-referencing of collections to other collections -* fixed missing publication year in notes under option 'reflist' -* fixed incorrect printing of 'volumes' under option 'reflist' +* fixed missing publication year in notes under option `reflist` +* fixed incorrect printing of `volumes` under option `reflist` * minor fixes * updated documentation ## 2014-03-02 * greatly simplified the handling of editors and translators -* changes and fixes to 'incollections', 'ed+vol+part+etc', and +* changes and fixes to `incollections`, `ed+vol+part+etc`, and associated macros, especially affecting the placement of a book's series in relation to other elements -* added and changed placement of 'note' for some entry types -* added support for abstracts (via 'note' for @article) -* simplified 'reviews' -* made @unpublished an alias of @thesis +* added and changed placement of `note` for some entry types +* added support for abstracts (via `note` for `@article`) +* simplified `reviews` +* made `@unpublished` an alias of `@thesis` * other minor changes and fixes -* updated windycity.tex and windycity.bib +* updated `windycity.tex` and `windycity.bib` ## 2014-02-26 diff --git a/Master/texmf-dist/doc/latex/windycity/windycity.bib b/Master/texmf-dist/doc/latex/windycity/windycity.bib index ce666baf5c6..7a06f00739a 100644 --- a/Master/texmf-dist/doc/latex/windycity/windycity.bib +++ b/Master/texmf-dist/doc/latex/windycity/windycity.bib @@ -123,6 +123,25 @@ year = {2016–18} } +% 13.65 Full in-text citation + +@Book{hawking1988, + author = {Hawking, Stephen W.}, + title = {A Brief History of Time}, + subtitle = {From the Big Bang to Black Holes}, + address = {New York}, + publisher = {Bantam Books}, + year = {1988} +} +@Book{tocqueville1999, + options = {skipbib}, + author = {Tocqueville, Alexis de}, + title = {Democracy in America}, + address = {Chicago}, + publisher = ucp, + year = {1999} +} + % 14.23 Notes and bibliography—examples and variations % 15.9 Author-date references—examples and variations @@ -498,27 +517,27 @@ userb = {\emph{See} Creasey, John} } @Book{creasey1976, + sortname = {Creasey, Ashe}, author = {Creasey, John}, nameaddon = {Gordon Ashe, pseud.}, - sortname = {Creasey, Ashe}, title = {A Blast of Trumpets}, address = {New York}, publisher = {Rinehart {and} Winston}, year = {1976} } @Book{creasey1978, + sortname = {Creasey, Morton}, author = {Creasey, John}, nameaddon = {Anthony Morton, pseud.}, - sortname = {Creasey, Morton}, title = {Hide the Baron}, address = {New York}, publisher = {Walker}, year = {1978} } @Book{creasey1966, + sortname = {Creasey, York}, author = {Creasey, John}, nameaddon = {Jeremy York, pseud.}, - sortname = {Creasey, York}, title = {Death to My Killer}, address = {New York}, publisher = {Macmillan}, @@ -801,10 +820,10 @@ } @Book{pound1953, options = {swapauth}, + sortname = {Eliot, T. S.}, author = {Pound, Ezra}, title = {Literary Essays}, editor = {Eliot, T. S.}, - sortname = {Eliot, T. S.}, address = {New York}, publisher = {New Directions}, year = {1953} @@ -995,16 +1014,17 @@ year = {2004} } @InCollection{mansfield2000, - introduction = {Mansfield, Harvey, and Delba Win\-throp}, + introduction = {Mansfield, Harvey, and Delba Winthrop}, pages = {xvii–lxxxvi}, crossref = {tocqueville2000} } @Book{tocqueville2000, options = {swaptrans}, + sortname = {Mansfield, Harvey}, author = {Tocqueville, Alexis de}, title = {Democracy in America}, - editor = {Mansfield, Harvey, and Delba Win\-throp}, - translator = {Mansfield, Harvey, and Delba Win\-throp}, + editor = {Mansfield, Harvey, and Delba Winthrop}, + translator = {Mansfield, Harvey, and Delba Winthrop}, address = {Chicago}, publisher = ucp, year = {2000} @@ -1126,7 +1146,7 @@ author = {Tauber, Abraham}, title = {Spelling Reform in the United States}, type = {phdthesis}, - institution = {Colum\-bia University}, + institution = {Co\-lum\-bia University}, year = {1958}, howpublished = {microfilm} } @@ -1957,9 +1977,9 @@ url = {http://www.nytimes.com/2015/03/08/style/finding-equilibrium-in-seesawing-libidos.html} } @Article{editorial2015, + sortname = {{New York Times}}, title = {Junk Science at the F.B.I.}, journal = {New York Times}, - sortname = {{New York Times}}, note = {editorial}, date = {2015-04-27}, url = {http://www.nytimes.com/2015/04/27/opinion/junk-science-at-the-fbi.html} @@ -2239,8 +2259,8 @@ } @Book{timestyle2003, options = {noauth}, - title = {The Times Style and Usage Guide}, sortname = {{Times Style}}, + title = {The Times Style and Usage Guide}, editor = {Austin, Tim}, editortype = {compiler}, address = {London}, diff --git a/Master/texmf-dist/doc/latex/windycity/windycity.pdf b/Master/texmf-dist/doc/latex/windycity/windycity.pdf Binary files differindex bdf5861c3d9..dee59d14cfb 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 b5fbd41ad21..26f7f47b9bb 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: Tue 02 Apr 2019 01:31:48 PM CDT +% Last modified: Wed 17 Jul 2019 09:36:07 AM 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-04-02} +\version{2019-07-17} \maketitle \begingroup \hypersetup{linkcolor=black} @@ -112,6 +112,32 @@ the load-time option \opt{style}: \noindent Typically, this goes in a document's preamble or in one of 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 +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}: + +\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}, 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}. + 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\ fields, and @@ -143,7 +169,7 @@ 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 citation, including the use of \textit{ibid.}, see +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 @@ -186,10 +212,11 @@ environment is called \opt{reflist}, which you may use as follows: \printbibliography[env=reflist] \end{verbatim} -\noindent Unfortunately, while the \opt{env} option allows you to have +\noindent Unfortunately, while the \opt{env} option allows for differently formatted bibliographies within the same document, the -reference lists may have problems with sorting. For best results, use -the \opt{reflist} preamble option. +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 text, note that all examples of citations and bibliographies are outputs of the style from commands that you can @@ -520,7 +547,8 @@ title's position. Below is an example from \textit{CMOS} \ref{14.105}: \end{citebib} \noindent To bypass the author's position in a single note, without -affecting the bibliography, use \cmd{cite*} or \cmd{footcite*}. +affecting the bibliography, use starred versions of citation commands, +such as \cmd{cite*} and \cmd{footcite*}. \optitem[false]{skipdate}{\opt{true}, \opt{false}} @@ -543,7 +571,7 @@ translator, their names should appear in citations in the order in which they appear on the work's title page (\ref{14.104}). By default, the style lists editors first. Entries with the option \bibfield{swaptrans} reverse this order: Their translators print -first. If a work's translators and editors are identical, using +first. If a work's translators and editors are the same, using \bibfield{swaptrans} reverses the order of their roles, say, from \textit{edited and translated by} to \textit{translated and edited by}. For more information, see Section \ref{edtranspos}. @@ -562,13 +590,14 @@ Section \ref{collorder}. \subsection{Citation Commands} \label{citecmds} -The most important citation commands are familiar from \biblatex: +Windy City supports most of the citation commands familiar from +\biblatex: \begin{ltxsyntax} \cmditem{autocite}[prenote][postnote]{key} \cmditem{autocites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} \cmditem{cite}[prenote][postnote]{key} -\cmditem{cites}[prenote][postnote]{key} +\cmditem{cites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} \cmditem{footcite}[prenote][postnote]{key} \cmditem{footcites}(multiprenote)(multipostnote)[prenote][postnote]{key}|...|[prenote][postnote]{key} \cmditem{nocite}{key} \cmditem*{nocite}|\{*\}| @@ -585,7 +614,7 @@ citations). Their multicite forms---\cmd{cites}, \cmd{footcites}, and Use \cmd{nocite} to add works to bibliographies without citing them in the text. Use it with an asterisk to add every work in every -\file{bib} file that you've loaded with \cmd{addbibresource} or +\file{bib} file that was loaded with \cmd{addbibresource} or \cmd{bibliography}. Windy City sets the \opt{autocite} preamble option to \opt{footnote}, @@ -614,17 +643,21 @@ 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, like \cmd{cite*}, suppresses the author's +position of a note. + \cmditem{footcite*}[prenote][postnote]{key} -Like \cmd{cite*}, this command suppresses the author's position of a -note but otherwise functions like \cmd{footcite}. +Like \cmd{footcite} but suppresses the author's position of a note. \cmditem{parencite*}[prenote][postnote]{key} -Use this command to print a parenthetical citation without the -author's position. The most likely contexts for this are passages in -which the author receives explicit mention. Here's an example from -\textit{CMOS} \ref{15.25}: +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}: \begin{quote} Fiorina et al. \parencite*{fiorina2005} and Fischer and Hout \parencite*{fischer2006} reach more or less the same conclusions. @@ -642,7 +675,64 @@ The source for the passage above contains: \cmditem{smartcite*}[prenote][postnote]{key} -Like \cmd{smartcite} but suppresses the author's position of a note. +Like \cmd{smartcite} but suppresses the author's position of a +citation. + +\cmditem{smartcites*}[prenote][postnote]{key} + +Like \cmd{smartcites} but, like \cmd{smartcite*}, suppresses the +author's position of a citation. + +\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: + +\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'}'' +\mkbibparens{\textcite[112]{hawking1988}}. \end{quote} + +The source for the passage above contains: + +\begin{verbatim} + \begin{quote} ``If an astronaut falls into a black hole...'' + \mkbibparens{\textcite[112]{hawking1988}}. \end{quote} +\end{verbatim} + +Note that \cmd{textcite} doesn't enclose citations in parentheses but +does drop the final period that standard citations usually end with. +The parentheses above come from \cmd{mkbibparens}, which also switches +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: + +\begin{quote} In their introduction to \textcite*{tocqueville1999}, +translators Harvey Mansfield and Delba Winthrop write that Tocqueville +``shows that the people are sovereign, whether through the +Constitution or despite it, and he warns of the tyranny of the +majority'' \parencite[xvii]{tocqueville1999}. \end{quote} + +The source for the passage above contains: + +\begin{verbatim} + \begin{quote} In their introduction to \textcite*{tocqueville1999} + ...\parencite[xvii]{tocqueville1999}. \end{quote} +\end{verbatim} + +\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}. + +\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. \end{ltxsyntax} @@ -657,7 +747,7 @@ that are specific to \biblatex. \typeitem{article} -Aliases: \bibtype{periodical} +Alias: \bibtype{periodical} \typeitem{book} @@ -678,7 +768,7 @@ Aliases: \bibtype{bookinbook}, \bibtype{conference}, \typeitem{reference} -Aliases: \bibtype{inreference} +Alias: \bibtype{inreference} \typeitem{review} No aliases @@ -748,9 +838,9 @@ makes it a fallback for almost anything. The example below is from \noindent The database entry for this work contains most of the format in \bibfield{usera} (for notes) and \bibfield{userb} (for -bibliographies). In \bibfield{title}, the style needs manual -formatting, since works of this type may have titles in italics or -quotation marks. +bibliographies). The \bibfield{title} field needs manual formatting, +since works of this type may have titles in italics or quotation +marks. \begin{verbatim} @Misc{roosevelt1959, @@ -792,10 +882,10 @@ format your bibliography as a reference list. It prevents Windy City 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 in the usual way. 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 \ref{collections}. +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 +\ref{collections}. For more information on entry types---specifically, on the use of certain data fields with them---see Section \ref{datafields}. @@ -839,7 +929,7 @@ 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 +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 @@ -866,9 +956,9 @@ uses standard data fields. The list below discusses some of them. \item[edition] To indicate a numbered edition of a work, put the 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 +\textit{revised} or \textit{rev. ed.} Both options give the same output. You may also use the field to indicate a newspaper's edition, -such as\textit{Sunday Book Review} (see \textit{CMOS} \ref{14.202}). +such as \textit{Sunday Book Review} (see \textit{CMOS} \ref{14.202}). \item[issue] Windy City uses this field with the \bibtype{article}, \bibtype{online}, and \bibtype{review} entry types to record a work's @@ -906,7 +996,7 @@ publication, you may use the classic \bibfield{year} field instead. \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 -\textit{phdthesis} or \textit{PhD diss.}. For the former, use +\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. @@ -1141,7 +1231,7 @@ you may want to reverse the order. For that, use the entry option If a work has no author, but has an editor, the style will print the editor's name in the author's position. The same happens if a work has -no author but has a translator. The following are examples from +no author but does have a translator. The following are examples from \textit{CMOS} \ref{14.103}: \begin{citebib} @@ -1163,10 +1253,10 @@ in the author's position: \item \cite{smith2002b} \end{citebib} -Similarly, if a work's editors and translators are identical, the -style will print the editors' role first, as in \textit{edited and -translated by}\ldots Reverse them with \opt{swaptrans}. From -\textit{CMOS} \ref{14.104}: +Similarly, if a work's editors and translators are the same, the style +will print the editors' role first, as in \textit{edited and +translated by}. Reverse them with \opt{swaptrans}. From \textit{CMOS} +\ref{14.104}: \begin{citebib} \item \cite{menchu1999} @@ -1196,13 +1286,13 @@ author's position---again, giving priority to editors. If you want the translator's name in the author's position, use \opt{swapauth} with \opt{swaptrans}. -Another caveat: For correct sorting in a bibliography, a work that -uses \opt{swapauth} needs a field like \bibfield{sortname} to sort it -by the name of the editor or translator whose name will occupy the -author's position. It would be nice if Windy City could do this for -you, but at present no feature of \biblatex seems to allow the kind of -on-the-fly changes to sorting that \opt{swapauth} requires. Below is -the entry for the previous example: +For correct sorting in a bibliography, a work that uses \opt{swapauth} +needs a field like \bibfield{sortname} to sort it by the name of the +editor or translator whose name will occupy the author's position. It +would be nice if Windy City could do this for you, but at present no +feature of \biblatex seems to allow the kind of on-the-fly changes to +sorting that \opt{swapauth} requires. Below is the entry for the +previous example: \begin{verbatim} @Book{pound1953, @@ -1273,15 +1363,15 @@ below, the volume has priority: \item \cite[45]{armstrong2014} \end{citeonly} -Notice the appearance of 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 \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, not the volumes themselves.) In any event, -Windy City prints the volume number only when the collection has -priority, that is, when \opt{swapvol} is \textit{true}. +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 +\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, +not the volumes themselves.) In any event, Windy City prints the +volume number only when the collection has priority, that is, when +\opt{swapvol} is \textit{true}. Sometimes, you may want collections to have priority in every case. If so, compile documents with the \opt{swapvol} preamble option, @@ -1316,8 +1406,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 and so is -perhaps less likely to raise eyebrows: +author. By contrast, the default format looks more familiar: \begin{citebib} \item \cite{barrows1959} @@ -1353,15 +1442,15 @@ City can use for proper sorting. As for examples, it seems that \AtNextBibliography{\toggletrue{swapvol}} \end{citebib} -In the second set of examples above, Windy City doesn't 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} +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. -% Due to 'mincrossrefs=2', smith2018 would be added automatically to +% Due to 'mincrossrefs=2', jones2018 would be added automatically to % the bibliography at the end of the document because it's referenced % twice below. However, it wouldn't appear in the refsegment without % using \nocite. @@ -1369,7 +1458,7 @@ cited volumes. \begin{citebib} \item \cite[56]{doe2018} \item \cite[128]{edwards2018} -\nocite{smith2018} +\nocite{jones2018} \end{citebib} \noindent Now with \opt{swapvol}: @@ -1380,7 +1469,7 @@ cited volumes. \AtNextCitekey{\toggletrue{swapvol}} \item \cite[128]{edwards2018} \AtNextBibliography{\toggletrue{swapvol}} -\nocite{smith2018} +\nocite{jones2018} \end{citebib} How does Windy City determine which entries in a bibliography database @@ -2823,7 +2912,7 @@ citations below are different. They need the \bibtype{reference} or \bibtype{inreference} entry type. See Section \ref{entrytypes} for more information. Following the suggestion in \textit{CMOS} 14.232, \bibtype{reference} and \bibtype{inreference} works don't appear in -bibliographies and reference lists. +bibliographies or reference lists. \begin{citebib} \item \cite{salvation1980} @@ -3091,8 +3180,9 @@ In the reference list, \textit{CMOS} errs in printing `:1997' after \subsubsection{Parentheses or comma with issue number} % 15.47 Parentheses or comma with issue number -In the second example, Windy City prints a colon after the journal -number. \textit{CMOS} prints a comma there---likely an error. +In the second reference list entry below, Windy City prints a colon +after the journal number. \textit{CMOS} prints a comma there---likely +an error. \begin{citeref} \item \parencite{glass2014} |