summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/windycity/windycity.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/windycity/windycity.tex')
-rw-r--r--Master/texmf-dist/doc/latex/windycity/windycity.tex210
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}