diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/windycity/windycity.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/windycity/windycity.tex | 210 |
1 files changed, 156 insertions, 54 deletions
diff --git a/Master/texmf-dist/doc/latex/windycity/windycity.tex b/Master/texmf-dist/doc/latex/windycity/windycity.tex index e69a97ac386..f6ca4e64263 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 10 Nov 2020 05:20:31 PM CST +% Last modified: Sat 30 Jan 2021 06:32:36 PM CST \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{2020-11-10} +\version{2021-01-30} \maketitle \begingroup \hypersetup{linkcolor=black} @@ -17,7 +17,7 @@ \section{Introduction} -\nfootnote{Copyright \textcopyright\ 2014--2020 Brian Chase. Under the +\nfootnote{Copyright \textcopyright\ 2014--2021 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 @@ -235,12 +235,12 @@ A shorter form of this passage appears in \textit{CMOS} feature of the style. For demonstration purposes, though, it's possible.} -% The use of 'firstshort' below might be confusing. It's necessary to +% The use of 'shortfirst' below might be confusing. It's necessary to % simulate the effect of 'short' within a document that otherwise % gives default output. \begin{citeonly} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[18]{morrison2004a} @@ -248,11 +248,11 @@ possible.} \item \cite[18]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[24--26]{morrison2004a} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[401-2]{morrison2004b} \AtNextCitekey{\toggletrue{short}} \item \cite[433]{morrison2004b} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[37--38]{diaz2008} \AtNextCitekey{\toggletrue{short}} \item \cite[403]{morrison2004b} @@ -282,7 +282,7 @@ explained in section \ref{preamble}, Windy City won't print break here may affect the output.} \begin{citeonly} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}\toggletrue{ibid}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}\toggletrue{ibid}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[18]{morrison2004a} @@ -290,11 +290,11 @@ break here may affect the output.} \item \cite[18]{morrison2004a} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[24--26]{morrison2004a} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}\toggletrue{ibid}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}\toggletrue{ibid}} \item \cite[401-2]{morrison2004b} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[433]{morrison2004b} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}\toggletrue{ibid}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}\toggletrue{ibid}} \item \cite[37--38]{diaz2008} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[403]{morrison2004b} @@ -302,14 +302,14 @@ break here may affect the output.} \item \cite[152]{diaz2008} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[201-2]{diaz2008} -\AtNextMultiCite{\toggletrue{short}\toggletrue{firstshort}} +\AtNextMultiCite{\toggletrue{short}\toggletrue{shortfirst}} \item \cites[240]{morrison2004b}[32]{morrison2004a} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[33]{morrison2004a} \end{citeonly} Other ways to make citations more concise: For a compromise between -standard and short forms, try the preamble option \opt{firstshort}. +standard and short forms, try the preamble option \opt{shortfirst}. It swaps long first citations for short ones but otherwise follows the standard (see section \ref{preamble}). Also with standard citations, the preamble option \opt{idemtracker} shortens the author's name of a @@ -375,16 +375,6 @@ it does filter out chapters of books, books in books, and volumes of collections. For discussion of multivolume works, see section \ref{multivolume}. -\optitem[false]{firstshort}{\opt{true}, \opt{false}} - -\noindent Use this option to shorten a work's first citation. The -resulting output consists mainly of the author's name and the work's -title. According to \textit{CMOS}, this approach is optional for -documents with complete bibliographies. (See \textit{CMOS} -\ref{14.23}, also 14.29--14.36.) You may use \opt{firstshort} in -conjunction with \opt{ibid}. However, it adds nothing to \opt{short}, -which has the same effect on first citations. - \optitem[false]{ibid}{\opt{true}, \opt{false}} \noindent This option controls whether consecutive citations of a work @@ -464,9 +454,59 @@ the title minus the subtitle or the content of the \bibfield{shorttitle} field, if available. As noted earlier, \opt{short} has the same effect on first citations -as \opt{firstshort}. But recall from section \ref{short} that you can +as \opt{shortfirst}. But recall from section \ref{short} that you can combine \opt{short} and \opt{ibid} for more concise output. +\optitem[false]{shortfirst}{\opt{true}, \opt{false}} + +\noindent Use this option to shorten a work's first citation. The +resulting output consists mainly of the author's name and the work's +title. According to \textit{CMOS}, this approach is optional for +documents with complete bibliographies. (See \textit{CMOS} +\ref{14.23}, also 14.29--14.36.) You may use \opt{shortfirst} in +conjunction with \opt{ibid}. However, it adds nothing to \opt{short}, +which has the same effect on first citations. + +\optitem[false]{shortlinks}{\opt{true}, \opt{false}} + +\noindent If you use Windy City with +\href{http://www.ctan.org/pkg/hyperref}{\textcolor{blue}{hyerref}}, +citations contain embedded links to their respective entries in the +bibliography. In standard citations, these links encompass the entire +citation (minus some punctuation). With \opt{shortlinks}, they're +embedded in just one element: the title or, if no title is present, +whatever part of the citation occupies the author's position, such as +the author's name, \textit{ibid.}, or a shorthand. For comparison, +here's what default links are like in blue: + +\hypersetup{citecolor=blue} +\begin{citeonly} +\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} + +\noindent And here they are with \opt{shortlinks}: + +\begin{citeonly} +\AtNextCitekey{\toggletrue{shortlinks}} +\item \cite[24--25]{morley1995} +\AtNextCitekey{\toggletrue{shortlinks}} +\item \cite{schwartz1992} +\AtNextCitekey{\toggletrue{shortlinks}} +\item \cite{kaiser1964} +\AtNextCitekey{\toggletrue{shortlinks}} +\item \cite[43]{morley1995} +\AtNextCitekey{\toggletrue{shortlinks}} +\item \cite[138]{schwartz1992} +\AtNextCitekey{\toggletrue{shortlinks}} +\item \cite[189--90]{kaiser1964} +\end{citeonly} +\hypersetup{citecolor=} + \optitem[false]{swapvol}{\opt{true}, \opt{false}} \noindent In bibliographies and long citations, works in collections @@ -533,6 +573,26 @@ title's position. Below is an example from \textit{CMOS} \ref{14.105}: affecting the bibliography, use starred versions of citation commands, such as \cmd{cite*}, \cmd{footcite*}, and \cmd{parencite*}. +\optitem[false]{noreprint}{\opt{true}, \opt{false}} + +\noindent This option helps if you need to indicate a work's original +year of publication with the \bibfield{origdate} or +\bibfield{origyear} field but want to depart from the style's usual +output by excluding the \textit{reprint} bibliography string. First, +an example of the default output from \textit{CMOS} \ref{15.40} (in +the author-year format): + +\begin{refonly} +\nocite{maitland1998} +\end{refonly} + +\noindent Now, from the same section, an example that requires +\opt{noreprint}: + +\begin{refonly} +\nocite{darwin1964} +\end{refonly} + \optitem[false]{skipdate}{\opt{true}, \opt{false}} \noindent On rare occasions, you may need an entry in a reference list @@ -975,13 +1035,22 @@ Schleyer}: edition, 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 -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 the \bibfield{issue} field. In other words, for \textit{Fall -2013}, a work's bibliography database entry should contain: +\item[eprint] Windy City supports the built-in resources that +\biblatex provides for electronic publishing information, even though +the output doesn't conform to \textit{CMOS}. To that end, you may use +the \bibfield{eprint} field, along with its cousins +\bibfield{eprinttype} and \bibfield{eprintclass}, and all the +associated options (\opt{eprint}, \opt{doi}, and \opt{url}), which are +set to \textit{true} by default. + +\item[issue] Windy City uses this field with \bibtype{article}, +\bibtype{online}, and \bibtype{review} entry types (and their aliases) +to record a work's 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 the \bibfield{issue} field. In other words, for +\textit{Fall 2013}, a work's bibliography database entry should +contain: \begin{verbatim} issue = {Fall}, @@ -1001,11 +1070,28 @@ use the \bibfield{issue} field. In other words, for \textit{Fall date = {2013}, \end{verbatim} -\noindent Remember that when \bibfield{date} contains just a year of +\noindent Note that when \bibfield{date} contains just a year of publication, you may use the classic \bibfield{year} field. -\item[pages] See comments on the \opt{nopages} bibliography -option in section \ref{preamble}. +\item[pages] See comments on the \opt{nopages} bibliography option in +section \ref{preamble}. + +\item[pubstate] This fields indicates when a work is forthcoming (with +value \textit{forthcoming}), a preprint (with value +\textit{preprint}), a working paper (with value \textit{working}), or +an electronic article published ahead of the official publication date +(with value \textit{prepub}). A preprint or working paper needs an +\bibtype{unpublished} entry in your bibliography database (see +\textit{CMOS} \ref{14.173} and \ref{14.218}). A prepublication should +have an \bibtype{article} or \bibtype{periodical} entry (see +\textit{CMOS} \ref{14.172}). For forthcoming works, see \textit{CMOS} +\ref{14.146}, \ref{14.172}, and \ref{15.45}. Forthcoming works also +print correctly with \textit{forthcoming} in the \bibfield{year} +field, as previous versions of the style required. + +\begin{bibonly} +\nocite{faraday,huang2015,jubb2015,lucki1980} +\end{bibonly} \item[series] See comments on \bibfield{seriesaddon} in section \ref{datafields}. @@ -1027,17 +1113,17 @@ dissertation. For the latter, \bibtype{type} should have the value field is needed for the \bibtype{mathesis} and \bibtype{phdthesis} entry types. -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}. +In rare cases, \bibfield{type} is necessary for \bibtype{article} and +\bibtype{review} entry types (and their aliases) 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} @@ -2020,7 +2106,7 @@ On short citations and the \opt{short} and \opt{ibid} preamble options, see sections \ref{short} and \ref{preamble}. \begin{citeonly} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[18]{morrison2004a} @@ -2028,11 +2114,11 @@ options, see sections \ref{short} and \ref{preamble}. \item \cite[18]{morrison2004a} \AtNextCitekey{\toggletrue{short}} \item \cite[24--26]{morrison2004a} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[401-2]{morrison2004b} \AtNextCitekey{\toggletrue{short}} \item \cite[433]{morrison2004b} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}} \item \cite[37--38]{diaz2008} \AtNextCitekey{\toggletrue{short}} \item \cite[403]{morrison2004b} @@ -2048,7 +2134,7 @@ options, see sections \ref{short} and \ref{preamble}. \noindent With options \opt{short} and \opt{ibid}: \begin{citeonly} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}\toggletrue{ibid}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}\toggletrue{ibid}} \item \cite[3]{morrison2004a} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[18]{morrison2004a} @@ -2056,11 +2142,11 @@ options, see sections \ref{short} and \ref{preamble}. \item \cite[18]{morrison2004a} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[24--26]{morrison2004a} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}\toggletrue{ibid}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}\toggletrue{ibid}} \item \cite[401-2]{morrison2004b} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[433]{morrison2004b} -\AtNextCitekey{\toggletrue{short}\toggletrue{firstshort}\toggletrue{ibid}} +\AtNextCitekey{\toggletrue{short}\toggletrue{shortfirst}\toggletrue{ibid}} \item \cite[37--38]{diaz2008} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[403]{morrison2004b} @@ -2068,7 +2154,7 @@ options, see sections \ref{short} and \ref{preamble}. \item \cite[152]{diaz2008} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[201-2]{diaz2008} -\AtNextMultiCite{\toggletrue{short}\toggletrue{firstshort}} +\AtNextMultiCite{\toggletrue{short}\toggletrue{shortfirst}} \item \cites[240]{morrison2004b}[32]{morrison2004a} \AtNextCitekey{\toggletrue{short}\toggletrue{ibid}} \item \cite[33]{morrison2004a} @@ -2673,9 +2759,11 @@ field for the second example below contains \textit{vol. 6}. % 14.132 No place of publication \begin{citeonly} -\item \cite{windsor1910} -\item \cite{vliet1890} +%\begin{itemize}[before=\small,itemindent=0ex] +\item[] \cite{windsor1910} +\item[] \cite{vliet1890} \end{citeonly} +%\end{itemize} \setcounter{subsubsection}{136} \subsubsection{Self-published or privately published books} @@ -2740,6 +2828,7 @@ field for the second example below contains \textit{vol. 6}. \subsubsection{Forthcoming publications} % 14.146 Forthcoming publications +\label{14.146} \begin{citebib} \item \cite{author} @@ -2832,12 +2921,21 @@ print \textit{Autumn 2013}. \subsubsection{Forthcoming journal articles} % 14.172 Forthcoming journal articles +\label{14.172} \begin{citebib} \item \cite{authora} +\item \cite{jubb2015} +\end{citebib} + +\subsubsection{Journal article preprints} +% 14.173 Journal article preprints +\label{14.173} + +\begin{citebib} +\item \cite{huang2015} \end{citebib} -\setcounter{subsubsection}{173} \subsubsection{Journal page references} % 14.174 Journal page references @@ -3069,9 +3167,11 @@ correct. \subsubsection{Working papers and the like} % 14.218 Working papers and the like +\label{14.218} \begin{citebib} \item \cite{lucki1980} +\item \cite{bronfenbrenner2011} \end{citebib} \setcounter{subsubsection}{219} @@ -3342,6 +3442,7 @@ after \textit{ISO 4}. Compare it with the nearly identical example in \begin{citeref} \item \parencite{austen2003} +\item \parencite{darwin1964} \item \parencite{maitland1998} \end{citeref} @@ -3376,6 +3477,7 @@ after \textit{ISO 4}. Compare it with the nearly identical example in \subsubsection{``Forthcoming'' in author-date references} % 15.45 ``Forthcoming'' in author-date references +\label{15.45} \begin{citeref} \item \parencite{faraday} |