summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-ms/doc/examples/50-style-authoryear-ms.tex
blob: cb91530dc541cb6552bde2c7dd1da68ed03d0f9c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
%
% This file presents the 'authoryear' style
%
\documentclass[a4paper]{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[american]{babel}
\usepackage{csquotes}
\usepackage[style=authoryear,backend=biber]{biblatex-ms}
\usepackage{hyperref}
\addbibresource{biblatex-examples.bib}
\setlength{\parindent}{0pt}
% Some generic settings.
\newcommand{\cmd}[1]{\texttt{\textbackslash #1}}
\setlength{\parindent}{0pt}
\newenvironment{bibsample}
  {\trivlist\samepage
   \setlength{\itemsep}{0pt}}
  {\endtrivlist}
\begin{document}

\section*{The \texttt{authoryear} style}

This style implements the author-year citation scheme.

\subsection*{Additional package options}

\subsubsection*{The \texttt{dashed} option}

By default, this style replaces recurrent authors/editors in the
bibliography by a dash so that items by the same author or editor
are visually grouped. This feature is controlled by the package
option \texttt{dashed}. Setting \texttt{dashed=false} in the
preamble will disable this feature. The default setting is
\texttt{dashed=true}.

\subsubsection*{The \texttt{mergedate} option}

Since this style prints the date label after the author/editor in the
bibliography, there are effectively two dates in the bibliography:
the full date specification (e.g., \enquote{2001}, \enquote{June
2006}, \enquote{5th~Jan. 2008}, whose format is controlled by the
\texttt{date} option) and the date label (e.g., \enquote{2006a},
whose format is controlled with the \texttt{labeldate} option),
as found in citations. The \texttt{mergedate} option controls whether
or not date specifications are merged with the date label.
This option is best explained by example. Note that
it only affects the bibliography. Citations use the date label only.

\begin{bibsample}
\item Doe 2000
\item Doe 2003a
\item Doe 2003b
\item Doe 2006a
\item Doe 2006b
\item Doe 2017
\end{bibsample}

\texttt{mergedate=false} strictly separates the date specification
(following \texttt{date}) from the date label (following \texttt{labeldate}).
The year will always be printed twice:

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher, 2000.
\item Doe, John (2003a). \emph{Book~2}. Location: Publisher, 2003.
\item Doe, John (2003b). \emph{Book~3}. Location: Publisher, 2003.
\item Doe, John (2006a). \enquote{Article~1}. In: \emph{Monthly Journal} 25.6
(June~2006), pp.~70--85.
\item Doe, John (2006b). \enquote{Article~2}. In: \emph{Quarterly Journal} 14.3
(Fall~2006), pp.~5--25.
\item Doe, John (2017). \emph{Webpage}. 7th Aug. 2017.
\end{bibsample}

\texttt{mergedate=minimum} omits the date whenever the full date
and the date label have exactly the same precision (date-time granularity).

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher.
\item Doe, John (2003a). \emph{Book~2}. Location: Publisher, 2003.
\item Doe, John (2003b). \emph{Book~3}. Location: Publisher, 2003.
\item Doe, John (2006a). \enquote{Article~1}. In: \emph{Monthly Journal} 25.6
(June~2006), pp.~70--85.
\item Doe, John (2006b). \enquote{Article~2}. In: \emph{Quarterly Journal} 14.3
(Fall~2006), pp.~5--25.
\item Doe, John (2017). \emph{Webpage}. 7th Aug. 2017.
\end{bibsample}

\texttt{mergedate=basic} is similar in concept but more economical.
It will also omit the date if it differs from the date label only by
\texttt{extradate}.

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher.
\item Doe, John (2003a). \emph{Book~2}. Location: Publisher.
\item Doe, John (2003b). \emph{Book~3}. Location: Publisher.
\item Doe, John (2006a). \enquote{Article~1}. In: \emph{Monthly Journal} 25.6
(June~2006), pp.~70--85.
\item Doe, John (2006b). \enquote{Article~2}. In: \emph{Quarterly Journal} 14.3
(Fall~2006), pp.~5--25.
\item Doe, John (2017). \emph{Webpage}. 7th Aug. 2017.
\end{bibsample}

\texttt{mergedate=compact} merges all date specifications with the
date labels. The merged date is printed in \texttt{date} format,
not \texttt{labeldate}, even if it is printed in the position of
the date label. The \texttt{issue} field is still treated specially:

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher.
\item Doe, John (2003a). \emph{Book~2}. Location: Publisher.
\item Doe, John (2003b). \emph{Book~3}. Location: Publisher.
\item Doe, John (June 2006a). \enquote{Article~1}. In: \emph{Monthly Journal} 25.6, pp.~70--85.
\item Doe, John (2006b). \enquote{Article~2}. In: \emph{Quarterly Journal} 14.3
(Fall), pp.~5--25.
\item Doe, John (7th Aug. 2017).\emph{Webpage}.
\end{bibsample}

\texttt{mergedate=maximum} strives for maximum compactness.
Like \texttt{mergedate=compact} this option merges the date
into the date label.
Even the \texttt{issue} field is merged with the date label:

\begin{bibsample}
\item Doe, John (2000). \emph{Book~1}. Location: Publisher.
\item Doe, John (2003a). \emph{Book~2}. Location: Publisher.
\item Doe, John (2003b). \emph{Book~3}. Location: Publisher.
\item Doe, John (June 2006a). \enquote{Article~1}. In: \emph{Monthly Journal} 25.6, pp.~70--85.
\item Doe, John (Fall 2006b). \enquote{Article~2}. In: \emph{Quarterly Journal} 14.3, pp.~5--25.
\item Doe, John (7th Aug. 2017).\emph{Webpage}.
\end{bibsample}

\texttt{mergedate=true} is an alias for \texttt{mergedate=compact}.
This is the default setting.

\subsection*{\cmd{cite} examples}

\cite{companion}

\cite[59]{companion}

\cite[see][]{companion}

\cite[see][59--63]{companion}

\subsection*{\cmd{parencite} examples}

This is just filler text \parencite{companion}.

This is just filler text \parencite[59]{companion}.

This is just filler text \parencite[see][]{companion}.

This is just filler text \parencite[see][59--63]{companion}.

\subsection*{\cmd{parencite*} examples}

\citeauthor{companion} show that this is just filler
text \parencite*{companion}.

\subsection*{\cmd{footcite} examples}

% Even though the author-year scheme is usually employed in
% conjuntion with in-text citations, it works just fine in
% footnotes, too.

This is just filler text.\footcite{companion}

This is just filler text.\footcite[59]{companion}

This is just filler text.\footcite[See][]{companion}

This is just filler text.\footcite[See][59--63]{companion}

\subsection*{\cmd{textcite} examples}

\textcite{companion} show that this is just filler text.

\textcite[59]{companion} show that this is just filler text.

\textcite[see][]{companion} show that this is just filler text.

\textcite[see][59--63]{companion} show that this is just filler text.

\subsection*{\cmd{autocite} examples}

% By default, the \autocite command works like \parencite.
% The starred version works like \parencite*.

This is just filler text \autocite{companion}.

\citeauthor{companion} show that this is just filler
text \autocite*{companion}.

\subsection*{Multiple citations}

% By default, a list of multiple citations is not sorted. You can
% enable sorting by setting the 'sortcites' package option.

\cite{knuth:ct:c,aristotle:physics,knuth:ct:b,aristotle:poetics,aristotle:rhetoric,knuth:ct:d}

\subsection*{Shorthand examples}

% If an entry in the bib file includes a 'shorthand' field, the
% shorthand replaces the regular author-title citation.

\cite{kant:kpv,kant:ku}

\clearpage

% The list of shorthands.

\printshorthands

% The list of references. Note that the year is printed after the
% author or editor and that recurring author and editor names are
% replaced by a dash unless the entry is the first one on the
% current page or double page spread (depending on the setting of
% the 'pagetracker' package option). This style will implicitly set
% 'pagetracker=spread' at load time.

\nocite{*}
\printbibliography

\end{document}