diff options
author | Norbert Preining <norbert@preining.info> | 2023-05-05 03:01:19 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2023-05-05 03:01:19 +0000 |
commit | 3cf2e76fc502cb474081c80838c95ecaba2f386d (patch) | |
tree | 5a1423600de3117087ef17bf28f4120c8f6c9fd6 /macros/latex/contrib/biblatex-contrib/windycity/doc/windycity.tex | |
parent | f5c7c9695f181a8fd6e28b572edea03ffc59de93 (diff) |
CTAN sync 202305050301
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/windycity/doc/windycity.tex')
-rw-r--r-- | macros/latex/contrib/biblatex-contrib/windycity/doc/windycity.tex | 221 |
1 files changed, 165 insertions, 56 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/windycity/doc/windycity.tex b/macros/latex/contrib/biblatex-contrib/windycity/doc/windycity.tex index a4bc14d059..d81be4bee3 100644 --- a/macros/latex/contrib/biblatex-contrib/windycity/doc/windycity.tex +++ b/macros/latex/contrib/biblatex-contrib/windycity/doc/windycity.tex @@ -1,4 +1,4 @@ -% Last modified: Sat 04 Dec 2021 01:43:53 PM CST +% Last modified: Wed 03 May 2023 07:02:51 PM CDT \documentclass[11pt,letterpaper,oneside]{article} \usepackage{windycity} @@ -8,7 +8,7 @@ \author{Brian Chase} \email{brianmichaelchase@gmail.com} \website{https://github.com/brianchase/windycity} -\version{2021-12-04} +\version{2023-05-03} \maketitle \begingroup \hypersetup{linkcolor=black} @@ -17,7 +17,7 @@ \section{Introduction} -\nfootnote{Copyright \textcopyright\ 2014--2021 Brian Chase. Under the +\nfootnote{Copyright \textcopyright\ 2014--2023 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 @@ -136,14 +136,14 @@ style is meant to handle. For a first set of examples, consider this passage from \textit{CMOS} \ref{14.30}: -\begin{citeonly} +\begin{citenobib} \item \cite[24--25]{morley1995} \item \cite{schwartz1992} \item \cite{kaiser1964} \item \cite[43]{morley1995} \item \cite[138]{schwartz1992} \item \cite[189--90]{kaiser1964} -\end{citeonly} +\end{citenobib} A work's first citation is similar to its entry in the bibliography. It includes all or most of its bibliographic information. Subsequent @@ -217,7 +217,7 @@ offers several preamble options and other means for producing them. Let's start with another passage of default output: -\begin{citeonly} +\begin{citenobib} \item \cite[3]{morrison2004a} \item \cite[18]{morrison2004a} \item \cite[18]{morrison2004a} @@ -230,7 +230,7 @@ Let's start with another passage of default output: \item \cite[201-2]{diaz2007} \item \cites[240]{morrison2004b}[32]{morrison2004a} \item \cite[33]{morrison2004a} -\end{citeonly} +\end{citenobib} A shorter form of this passage appears in \textit{CMOS} \ref{14.34}:\footnote{Switching forms within a document isn't a @@ -240,7 +240,7 @@ possible.} % Preamble option 'short' sets 'short' and 'shortfirst' toggles to % true. Set them to true to simulate the 'short' preamble option. -\begin{citeonly} +\begin{citenobib} \AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}} @@ -265,7 +265,7 @@ possible.} \item \cites[240]{morrison2004b}[32]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[33]{morrison2004a} -\end{citeonly} +\end{citenobib} In this version, a work's first citation gives short names and titles and omits all other publication information. Consecutive citations of @@ -287,7 +287,7 @@ break here may affect the output.} % toggles to true. Set all those toggles to true to simulate the % 'short' and 'ibid' preamble options. -\begin{citeonly} +\begin{citenobib} \AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} @@ -312,7 +312,7 @@ break here may affect the output.} \item \cites[240]{morrison2004b}[32]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[33]{morrison2004a} -\end{citeonly} +\end{citenobib} For a compromise between standard and short forms, try the preamble option \opt{shortfirst}. It swaps long first citations for short ones @@ -495,6 +495,17 @@ reference list is to pass \opt{env=reflist} to \cmd{printbibliography}. See section \ref{overview} for more information. +\optitem[false]{sentencecase}{\opt{true}, \opt{false}} + +\noindent This option puts titles in sentence-style capitalization, +also called sentence case (see \textit{CMOS} 8.158), whereby the first +letter is uppercase and subsequent letters are lowercase. Affected +fields: \bibfield{title}, \bibfield{blogtitle}, +\bibfield{bookbooktitle}, \bibfield{booktitle}, \bibfield{issuetitle}, +\bibfield{journal}, \bibfield{journaltitle}, \bibfield{maintitle}, +\bibfield{origtitle}, \bibfield{shortbooktitle}, \bibfield{shorthand}, +\bibfield{shorttitle}, and \bibfield{shortmaintitle}. + \optitem[false]{short}{\opt{true}, \opt{false}} \noindent As shown in section \ref{short}, this option prints short @@ -524,7 +535,7 @@ in \textit{CMOS} \ref{14.34}: % 'shortafter' doesn't. Hence, to display the output of 'shortafter' % below, you need only toggle true 'short'. -\begin{citeonly} +\begin{citenobib} \AtNextCitekey{\toggletrue{short}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}} @@ -549,7 +560,7 @@ in \textit{CMOS} \ref{14.34}: \item \cites[240]{morrison2004b}[32]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[33]{morrison2004a} -\end{citeonly} +\end{citenobib} \optitem[false]{shortfirst}{\opt{true}, \opt{false}} @@ -573,18 +584,18 @@ the author's name, \textit{ibid.}, or a shorthand. For comparison, the blue text below shows default links: \hypersetup{citecolor=blue} -\begin{citeonly} +\begin{citenobib} \item \cite[24--25]{morley1995} \item \cite{schwartz1992} \item \cite{kaiser1964} \item \cite[43]{morley1995} \item \cite[138]{schwartz1992} \item \cite[189--90]{kaiser1964} -\end{citeonly} +\end{citenobib} \noindent And here they are with \opt{shortlinks}: -\begin{citeonly} +\begin{citenobib} \AtNextCitekey{\toggletrue{shortlinks}} \item \cite[24--25]{morley1995} \AtNextCitekey{\toggletrue{shortlinks}} @@ -597,7 +608,7 @@ blue text below shows default links: \item \cite[138]{schwartz1992} \AtNextCitekey{\toggletrue{shortlinks}} \item \cite[189--90]{kaiser1964} -\end{citeonly} +\end{citenobib} \hypersetup{citecolor=} \optitem[false]{swapvol}{\opt{true}, \opt{false}} @@ -654,12 +665,60 @@ the value of \cmd{bibitemsep}. \noindent Set \opt{false} to prevent the \bibfield{doi} field from printing. +\optitem[false]{emph}{\opt{true}, \opt{false}} + +\noindent Short for \opt{emph:title}. + +\optitem[false]{emph:<field>}{\opt{true}, \opt{false}} + +\noindent This option puts titles in italics. Supported values of +\bibfield{<field>}: \bibfield{title}, \bibfield{blogtitle}, +\bibfield{bookbooktitle}, \bibfield{booktitle}, \bibfield{issuetitle}, +\bibfield{journal}, \bibfield{journaltitle}, \bibfield{maintitle}, +\bibfield{origtitle}, \bibfield{shortbooktitle}, \bibfield{shorthand}, +\bibfield{shorttitle}, and \bibfield{shortmaintitle}. + \optitem[true]{eprint}{\opt{true}, \opt{false}} \noindent Set \opt{false} to prevent the \bibfield{eprint} field from printing. For more information about eprints, see section \ref{datafields}. +\optitem[false]{ifcapital}{\opt{true}, \opt{false}} + +\noindent Short for \opt{ifcapital:title}. + +\optitem[false]{ifcapital:<field>}{\opt{true}, \opt{false}} + +\noindent This option uppercases the first letter of titles when +\cmd{ifcapital} is true. Supported values of \bibfield{<field>}: +\bibfield{title}, \bibfield{blogtitle}, \bibfield{bookbooktitle}, +\bibfield{booktitle}, \bibfield{issuetitle}, \bibfield{journal}, +\bibfield{journaltitle}, \bibfield{maintitle}, \bibfield{origtitle}, +\bibfield{shortbooktitle}, \bibfield{shorthand}, +\bibfield{shorttitle}, and \bibfield{shortmaintitle}. + +In combination with \opt{noformat:<field>}, this option allows you to +work with complex titles, where different parts need different formats +in different contexts. From \textit{CMOS} \ref{14.210}: + +\begin{verbatim} + @Online{braun2016, + options = {noformat,ifcapital}, + author = {Braun, Caroline}, + title = {reply to \mkbibquote{How did the `cool kids' from high + school turn out?}}, + organization = {Quora}, + date = {2016-08-09}, + url = {https://www.quora.com/How-did-the-cool-kids-from-high + -school-turn-out/} + } +\end{verbatim} + +\begin{citebib} +\item \cite{braun2016} +\end{citebib} + \optitem[false]{isbn}{\opt{true}, \opt{false}} \noindent Use this option to print the ISBN of a particular work in a @@ -712,6 +771,19 @@ such as \cmd{cite*}, \cmd{footcite*}, and \cmd{parencite*}. citations and bibliography entries of specific works. To disable truncation in all works, use the \opt{noetal} preamble option. +\optitem[false]{noformat}{\opt{true}, \opt{false}} + +\noindent Short for \opt{noformat:title}. + +\optitem[false]{noformat:<field>}{\opt{true}, \opt{false}} + +\noindent This option removes formatting from titles. Supported values +of \bibfield{<field>}: \bibfield{title}, \bibfield{blogtitle}, +\bibfield{bookbooktitle}, \bibfield{booktitle}, \bibfield{issuetitle}, +\bibfield{journal}, \bibfield{journaltitle}, \bibfield{maintitle}, +\bibfield{origtitle}, \bibfield{shortbooktitle}, \bibfield{shorthand}, +\bibfield{shorttitle}, and \bibfield{shortmaintitle}. + \optitem[false]{noplace}{\opt{true}, \opt{false}} \noindent In contexts where Windy City expects to print a publisher's @@ -719,10 +791,10 @@ location, but no location is specified in the bibliography database, you can tell it to print \textit{n.p.} (for \textit{no place}) with this option. From \textit{CMOS} \ref{14.132}: -\begin{citeonly} +\begin{citenobib} %\begin{itemize}[before=\small,itemindent=0ex] \item[] \cite{windsor1910} -\end{citeonly} +\end{citenobib} %\end{itemize} \optitem[false]{noreprint}{\opt{true}, \opt{false}} @@ -745,6 +817,34 @@ the author-year format): \nocite{darwin1964} \end{refonly} +\optitem[false]{quotes}{\opt{true}, \opt{false}} + +\noindent Short for \opt{quotes:title}. + +\optitem[false]{quotes:<field>}{\opt{true}, \opt{false}} + +\noindent This option puts titles in quotes. Supported values of +\bibfield{<field>}: \bibfield{title}, \bibfield{blogtitle}, +\bibfield{bookbooktitle}, \bibfield{booktitle}, \bibfield{issuetitle}, +\bibfield{journal}, \bibfield{journaltitle}, \bibfield{maintitle}, +\bibfield{origtitle}, \bibfield{shortbooktitle}, \bibfield{shorthand}, +\bibfield{shorttitle}, and \bibfield{shortmaintitle}. + +\optitem[false]{sentencecase}{\opt{true}, \opt{false}} + +\noindent Short for \opt{sentencecase:title}. + +\optitem[false]{sentencecase:<field>}{\opt{true}, \opt{false}} + +\noindent This option puts titles in sentence-style capitalization, +also called sentence case (see \textit{CMOS} 8.158), whereby the first +letter is uppercase and subsequent letters are lowercase. Supported +values of \bibfield{<field>}: \bibfield{title}, \bibfield{blogtitle}, +\bibfield{bookbooktitle}, \bibfield{booktitle}, \bibfield{issuetitle}, +\bibfield{journal}, \bibfield{journaltitle}, \bibfield{maintitle}, +\bibfield{origtitle}, \bibfield{shortbooktitle}, \bibfield{shorthand}, +\bibfield{shorttitle}, and \bibfield{shortmaintitle}. + \optitem[false]{skipdate}{\opt{true}, \opt{false}} \noindent On rare occasions, you may need an entry in a reference list @@ -1007,9 +1107,9 @@ 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} +\begin{citenobib} \item \idemcites{sutton1959,fussell1962,coffman1954,coffman1955,rountree1958}[and][]{lovell1960} -\end{citeonly} +\end{citenobib} Without commands like \cmd{idemcite}, there's often no easy way to tell Windy City to shorten names. The preamble option @@ -1139,9 +1239,9 @@ entry types. You may cross-reference \bibtype{inreference} entries to \bibtype{reference} entries, but they're otherwise equivalent. Take an example from \textit{CMOS} \ref{14.232}: -\begin{citeonly} +\begin{citenobib} \item \cite{salvation1980} -\end{citeonly} +\end{citenobib} \noindent One way to get that output is to cross-reference an \bibtype{inreference} entry (for the article) to a \bibtype{reference} @@ -2162,19 +2262,19 @@ short citations), the one with priority determines which one identifies the work. By default, as you can see in the second note below, the volume has priority: -\begin{citeonly} +\begin{citenobib} \item \cite{armstrong2014} \item \cite[45]{armstrong2014} -\end{citeonly} +\end{citenobib} \noindent Whereas with \opt{swapvol}: -\begin{citeonly} +\begin{citenobib} \AtNextCitekey{\toggletrue{swapvol}} \item \cite{armstrong2014} \AtNextCitekey{\toggletrue{swapvol}} \item \cite[45]{armstrong2014} -\end{citeonly} +\end{citenobib} Notice the volume number in the second note above, separated from the page by a colon. When the collection has priority, the volume number @@ -2426,9 +2526,9 @@ without regard to the \bibfield{postnote}, use the entry option \opt{listvols}. Windy City uses it to match some examples in \textit{CMOS}, such as in \ref{14.59}: -\begin{citeonly} +\begin{citenobib} \item \cite[1:126]{shurtleff1853} -\end{citeonly} +\end{citenobib} \subsection{Collections as Single Works} \label{multivolume} @@ -2440,12 +2540,12 @@ illustrate the distinction between a collection that counts as a single work and one that doesn't, \textit{CMOS} gives the following examples in \ref{14.118}: -\begin{citeonly} +\begin{citenobib} \item \cite[4:243]{byrne1981} \item \cite*[32--33]{james1963.5} \item \cite[4:245]{byrne1981} \item \cite*[34]{james1963.5} -\end{citeonly} +\end{citenobib} In citations of \textit{The Lisle Letters}, volume numbers and pages are separated by a colon. With \textit{The Complete Tales of Henry @@ -2501,10 +2601,10 @@ 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} +\begin{citenobib} \item \cite{byrne1981} \item \cite{byrne1981} -\end{citeonly} +\end{citenobib} For collections like \textit{The Complete Tales of Henry James}, which don't count as single works, every volume needs to have its own entry @@ -2545,11 +2645,11 @@ editor's name, long before the \bibfield{postnote}. The second prints it just before the \bibfield{postnote}, separated from the page by a colon: -\begin{citeonly} +\begin{citenobib} \item[2.] \cite*[32--33]{james1963.5} \item[\ldots] \item[4.] \cite*[34]{james1963.5} -\end{citeonly} +\end{citenobib} Neither type of collection uses cross-referencing in the bibliography database. For \textit{The Lisle Letters}, cross-referencing would @@ -2685,7 +2785,7 @@ To help with cross-checking, subsection numbers and headings are from On short citations and the \opt{short} and \opt{ibid} preamble options, see sections \ref{short} and \ref{preamble}. -\begin{citeonly} +\begin{citenobib} \AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}} @@ -2709,11 +2809,11 @@ options, see sections \ref{short} and \ref{preamble}. \AtNextMultiCite{\toggletrue{short}} \item \cites[240]{morrison2004b}[32]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[33]{morrison2004a} -\end{citeonly} +\end{citenobib} \noindent With options \opt{short} and \opt{ibid}: -\begin{citeonly} +\begin{citenobib} \AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} @@ -2738,7 +2838,7 @@ options, see sections \ref{short} and \ref{preamble}. \item \cites[240]{morrison2004b}[32]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[33]{morrison2004a} -\end{citeonly} +\end{citenobib} \setcounter{subsubsection}{53} \subsubsection{Source notes for previously published material} @@ -2768,9 +2868,9 @@ 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} +\begin{citenobib} \item \idemcites{sutton1959,fussell1962,coffman1954,coffman1955,rountree1958}[and][]{lovell1960} -\end{citeonly} +\end{citenobib} \setcounter{subsubsection}{58} \subsubsection{Abbreviations for frequently cited works} @@ -3343,11 +3443,11 @@ field for the second example below contains \textit{vol. 6}. To insert \textit{n.p.} (for \textit{no place}), you need to use the entry option \opt{noplace}. See section \ref{entry}. -\begin{citeonly} +\begin{citenobib} %\begin{itemize}[before=\small,itemindent=0ex] \item[] \cite{windsor1910} \item[] \cite{vliet1890} -\end{citeonly} +\end{citenobib} %\end{itemize} \setcounter{subsubsection}{136} @@ -3729,6 +3829,15 @@ correct. \item \cite{licis2016} \end{citebib} +\subsubsection{Electronic mailing lists and forums} +% 14.210 Electronic mailing lists and forums +\label{14.210} + +\begin{citebib} +\item \cite{powell1998} +\item \cite{braun2016} +\end{citebib} + \setcounter{subsection}{7} \subsection{Papers, Contracts, and Reports} \setcounter{subsection}{14} @@ -3800,7 +3909,7 @@ correct. % 14.229 Examples of note forms for manuscript collections \label{14.229} -\begin{citeonly} +\begin{citenobib} \item \cite[Burton to Merriam, telegram, 26 January 1923, box 26, folder 17,][]{merriam} \item \cite[Minutes of the Committee for Improving the Condition of the Free @@ -3811,7 +3920,7 @@ Blacks, Pennsylvania Abolition Society, 1790--1803,][]{pasociety} (Scotland), Document 1359, fol. 1r,][MS-12-84]{morris} \item \cite[Daily Expenses, July 1787, images 7--8,][]{washington} \item \cite[Minutes, 15 April 1795,][]{pasociety} -\end{citeonly} +\end{citenobib} \setcounter{subsubsection}{229} \subsubsection{Examples of bibliography entries for manuscript collections} @@ -3866,12 +3975,12 @@ type. As odd as it may seem, but consistent with \textit{CMOS}, they, too, aren't included in bibliographies. See section \ref{entrytypes} for more information. -\begin{citeonly} +\begin{citenobib} \item \cite{toscanini2016} \item \cite{cairns2016} \item \cite{wikipedia2016} \item \cite{merriam2016} -\end{citeonly} +\end{citenobib} \subsubsection{Citing individual reference entries by author} % 14.234 Citing individual reference entries by author @@ -4006,9 +4115,9 @@ after the year, not before. \subsubsection{Additional material in text citations} % 15.24 Additional material in text citations -\begin{citeref} +\begin{citenoref} \item \parencite[; t-tests are used here]{mandolan2017} -\end{citeref} +\end{citenoref} \subsubsection{Text citations in relation to surrounding text and punctuation} % 15.25 Text citations in relation to surrounding text and punctuation @@ -4024,7 +4133,7 @@ blue states and between churchgoers and secular voters. \end{quote} \subsubsection{Several references to the same source} % 15.27 Several references to the same source -\begin{citeref}% 'even\-tanned' prevents even--[break]tanned +\begin{citenoref}% 'even\-tanned' prevents even--[break]tanned \item Complexion figures prominently in Morgan's descriptions. When Jasper compliments his mother's choice of car (a twelve-cylinder Mediterranean roadster with leather and wood-grained interior), ``his @@ -4034,26 +4143,26 @@ never changes, her ``even\-tanned good looks'' \parencite[56]{chaston2000}, ``burnished visage'' \parencite[101]{chaston2000}, and ``air-brushed confidence'' \parencite[211]{chaston2000} providing the foil to the drama in her -midst. \end{citeref} +midst. \end{citenoref} \setcounter{subsubsection}{28} \subsubsection{Text citations of works with more than three authors} % 15.29 Text citations of works with more than three authors -\begin{citeref} +\begin{citenoref} \item \parencite{schonen2017a} \item \parencite{schonen2017b} -\end{citeref} +\end{citenoref} \subsubsection{Multiple text references} % 15.30 Multiple text references -\begin{citeref} +\begin{citenoref} \item \parencite{armstrong1989,beigl1989,pickett1985} \item \parencites{whittaker1967,whittaker1975,wiens1989a,wiens1989b} \item \parencites[328]{wong1999}[475]{wong2000}[67]{garcia1998} \item \parencites{guest2006}[see also][]{stalle2008}{rahn2009} -\end{citeref} +\end{citenoref} \setcounter{subsection}{2} \subsection{Author-Date References: Special Cases} @@ -4198,7 +4307,7 @@ with \ref{14.208} and \ref{15.42}. \begin{citeref} \item \parencite{diaz2016} -\item \parencite{obrien2015} +\item \parencite{brien2015} \item \parencite{chicago2015} \end{citeref} |