summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-ms/doc/examples/74-style-verbose-trad1-ms.tex
blob: 733792a3d21756c1931bbc82d17ff9fcae6ae2a6 (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
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
%
% This file presents the 'verbose-trad1' style
%
\documentclass[a4paper]{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[german,american]{babel}
\usepackage{csquotes}
\usepackage[style=verbose-trad1,backend=biber]{biblatex-ms}
\usepackage{tabularx}
\usepackage{booktabs}
\addbibresource{biblatex-examples.bib}
% Some generic settings:
\newcommand*{\cmd}[1]{\texttt{\textbackslash #1}}
\newcolumntype{H}{>{\bfseries}l}
\newcolumntype{C}{>{\ttfamily}c}
\newcolumntype{V}{>{\ttfamily}l}
\newenvironment*{inlinetable}
  {\trivlist\footnotesize\item}
  {\endtrivlist}
\newcommand*{\code}[1]{%
  \detokenize\expandafter{\string#1}}
\newenvironment*{pseudofootnotes}
  {\list\labelenumi{%
     \def\makelabel##1{\hss\llap{##1}}%
     \def\labelenumi{\theenumi}%
     \usecounter{enumi}%
     \setlength{\leftmargin}{0pt}%
     \setlength{\labelsep}{0.75em}%
     \setlength{\itemsep}{0pt}%
     \setlength{\parsep}{0pt}}%
   \citereset
   \footnotesize
   \def\footcite##1{\item\Cite{##1}.}%
   \def\footnote##1{\item##1}}
  {\endlist}
\newenvironment*{pseudofootnotes*}
  {\pseudofootnotes
   \def\footnote##1{\item##1\mancite}}
  {\endpseudofootnotes}
\begin{document}

\section*{The \texttt{verbose-trad1} style}

This is a traditional citation style which uses scholarly
abbreviations like \emph{ibidem}, \emph{idem}, \emph{opere citato},
and \emph{loco citato} in a special way to replace recurrent
authors, titles, and page ranges across separate citation commands.
This style is best explained by example.

\subsection*{Outline}

Let's assume a \texttt{bib} file with the following entries:

\begin{inlinetable}
\begin{tabularx}{\linewidth}{@{}CX@{}}
\toprule
\multicolumn{1}{@{}H}{Entry Key} &
\multicolumn{1}{H}{Entry Data} \\
\cmidrule(r){1-1}\cmidrule(l){2-2}
a1 & Author A, Title 1 \\
a2 & Author A, Title 2 \\
a3 & Author A, Title 3 \\
b1 & Author B, Title 1 \\
\bottomrule
\end{tabularx}
\end{inlinetable}
%
Here's an example of how this citation scheme works:

\begin{inlinetable}
\begin{tabularx}{\linewidth}{@{}VlX@{}}
\toprule
\multicolumn{1}{@{}H}{Command} &
\multicolumn{1}{H}{Conditions} &
\multicolumn{1}{H}{Citation} \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite{a1}}        & Initial reference     & Verbose citation \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite{b1}}        & Initial reference     & Verbose citation \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite[26]{a1}}    & Author changed        & Author, \emph{op.~cit.}, page \\
                        & + Title is last title by \emph{this} author \\
                        & + Page is new/different from last page cited \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite[59]{b1}}    & Author changed        & Author, \emph{op.~cit.}, page \\
                        & + Title is last title by \emph{this} author \\
                        & + Page is new/different from last page cited \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite[26]{a1}}    & Author changed        & Author, \emph{loc.~cit.} \\
                        & + Title is last title by \emph{this} author \\
                        & + Page is last page cited from \emph{this} work \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite[59]{b1}}    & Author changed        & Author, \emph{loc.~cit.} \\
                        & + Title is last title by \emph{this} author \\
                        & + Page is last page cited from \emph{this} work \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite{a2}}        & Initial reference     & Verbose citation \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite{b1}}        & Author changed        & Author, \emph{op.~cit.} \\
                        & + Title is last title by \emph{this} author \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite{a1}}        & Author changed        & Author, Title \\
                        & + Title different from last title by \emph{this} author \\
                        & + Title has been cited before \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite[55]{a2}}    & Same author           & \emph{idem}, Title, page \\
                        & + Title different from last title by \emph{this} author \\
                        & + Title has been cited before \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite[25]{a2}}    & Same author and title & \emph{ibidem}, page \\
                        & + Page is different from last page cited \\
\cmidrule(r){1-1}\cmidrule(lr){2-2}\cmidrule(l){3-3}
\code{\cite[25]{a2}}    & Same author and title and page
						& \emph{ibidem}, page \\
\code{\cite[25]{a2}}    & (with option \texttt{ibidpage=true})
						& \emph{ibidem} \\
\bottomrule
\end{tabularx}
\end{inlinetable}

\clearpage

\subsection*{Additional package options}

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

The scholarly abbreviation \emph{ibidem} is sometimes taken to mean
both `same author~+ same title' and `same author~+ same title~+ same
page' in traditional citation schemes. By default, this is not the
case with this style because it may lead to ambiguous citations.
With \texttt{ibidpage=true} a page range postnote will be suppressed
in an \emph{ibidem} citation if the last citation was to the same
page range. With \texttt{ibidpage=false} the postnote is not omitted.
Citations to different page ranges than the previous always produce
the page ranges with either setting.
The default setting is \texttt{ibidpage=false}.

Consider the following example citations
\begin{verbatim}
\cite[12]{cicero}
\cite[12]{cicero}
\cite[12]{worman}
\cite[13]{worman}
\end{verbatim}
%
If \texttt{ibidpage} is set to \texttt{true}, the citations
come out -- shortened -- as
\begin{quote}
Cicero, \emph{De natura deorum,} p.~12

ibid.

Worman, \emph{The Cast of Character,} p.~12

ibid., p.~13
\end{quote}
%
The shortened result for \texttt{ibidpage=false} is
\begin{quote}
Cicero, \emph{De natura deorum,} p.~12

ibid., p.~12

Worman, \emph{The Cast of Character,} p.~12

ibid., p.~13
\end{quote}

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

A case related to the definition of \emph{ibidem} is the scope of
the \emph{ibidem} and \emph{idem} replacements. By default, this
style will only use such abbreviations if the respective citations
are given in the same footnote or in consecutive footnotes. The
point of this restriction is also to avoid potentially ambiguous
citations. Here's an example:

\begin{verbatim}
...\footcite{aristotle:anima}
...\footcite{aristotle:anima}
...\footnote{Averroes touches upon this issue in his \emph{Epistle
             on the Possibility of Conjunction}.}
...\footcite{aristotle:anima}
\end{verbatim}
%
This could be rendered as follows:

\begin{pseudofootnotes}
\footcite{aristotle:anima}
\footcite{aristotle:anima}
\footnote{Averroes touches upon this issue in his \emph{Epistle on
the Possibility of Conjunction}.}
\footcite{aristotle:anima}
\end{pseudofootnotes}
%
What does the \emph{ibidem} in the last footnote refer to? The last
formal citation, as given in the first and the second footnote
(Aristotle), or the informal reference in the third one (Averroes)?
Too avoid such citations, this style will only use \emph{ibidem} and
\emph{idem} replacements if the respective citations are given in
the same footnote or in consecutive footnotes:

\begin{pseudofootnotes*}
\footcite{aristotle:anima}
\footcite{aristotle:anima}
\footnote{Averroes touches upon this issue in his \emph{Epistle on
the Possibility of Conjunction}.}
\footcite{aristotle:anima}
\end{pseudofootnotes*}
%
Depending on your writing and citing habits, however, you may prefer
the less strict \emph{ibidem} and \emph{idem} handling. You can
force that by setting the package option \texttt{strict=false} in
the preamble. It is still possible to mark a manually inserted
discursive citation with \cmd{mancite} when required:

\begin{verbatim}
...\footcite{aristotle:anima}
...\footnote{\mancite Averroes touches upon this issue in his
             \emph{Epistle on the Possibility of Conjunction}.}
...\footcite{aristotle:anima}
\end{verbatim}
%
This will suppress the \emph{ibidem} in the last footnote.

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

Use this option to fine-tune the formatting of the \texttt{pages}
and \texttt{pagetotal} fields in verbose citations. When an entry
with a \texttt{pages} field is cited for the first time and the
\texttt{postnote} is a page number or a page range, the citation
will end with two page specifications:

\begin{quote}
Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, p.\,125.
\end{quote}
%
In this example, \enquote{125} is the \texttt{postnote} and
\enquote{100--150} is the \texttt{pages} field (there are similar
issues with the \texttt{pagetotal} field). This may be confusing to
the reader. The \texttt{citepages} option controls how to deal with
these fields in this case. The option works as follows, given these
citations as an example:

\begin{verbatim}
\cite{key}
\cite[a note]{key}
\cite[125]{key}
\end{verbatim}
%
\texttt{citepages=permit} allows duplicates, i.e., the style will
print both the \texttt{pages}\slash \texttt{pagetotal} and the
\texttt{postnote}. This is the default setting:

\begin{quote}
Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150.

Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, a note.

Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, p.\,125.
\end{quote}
%
\texttt{citepages=suppress} unconditionally suppresses the
\texttt{pages}\slash \texttt{pagetotal} fields in citations,
regardless of the \texttt{postnote}:

\begin{quote}
Author. \enquote{Title.} In: \emph{Book.}

Author. \enquote{Title.} In: \emph{Book,} a note.

Author. \enquote{Title.} In: \emph{Book,} p.\,125.
\end{quote}
%
\texttt{citepages=omit} suppresses the \texttt{pages}\slash
\texttt{pagetotal} in the third case only. They are still printed if
there is no \texttt{postnote} or if the \texttt{postnote} is not a
number or range:

\begin{quote}
Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150.

Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, a note.

Author. \enquote{Title.} In: \emph{Book,} p.\,125.
\end{quote}
%
\texttt{citepages=separate} separates the \texttt{pages}\slash
\texttt{pagetotal} from the \texttt{postnote} in the third case:

\begin{quote}
Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150.

Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, a note.

Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, esp. p.\,125.
\end{quote}
%
The string \enquote{especially} in the third case is the bibliography
string \texttt{thiscite}, which may be redefined.

\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}.

\subsection*{Hints and caveats}

If you want terms such as \emph{ibidem} to be printed in italics,
redefine \cmd{mkibid} as follows:

\begin{verbatim}
\renewcommand*{\mkibid}{\emph}
\end{verbatim}
%
German users should note that the scholarly abbreviations typically
used in German do not make a clear distinction between
\emph{op.~cit.} and \emph{loc.~cit.} Both are rendered as
\emph{a.a.O.}, possibly causing some citations to be misleading. It
may be preferable to use the \texttt{verbose-trad2} style in German
documents. If you really want to use \texttt{verbose-trad1}, use the
Latin keywords. This is accomplished by putting the following in the
preamble or the configuration file:

\begin{verbatim}
\DefineBibliographyStrings{german}{%
  idem   = {idem},
  idemsm = {idem},
  idemsf = {eadem},
  idemsn = {idem},
  idempm = {eidem},
  idempf = {eaedem},
  idempn = {eadem},
  idempp = {eidem},
  ibidem = {ibid\adddot},
  opcit  = {op\adddotspace cit\adddot},
  loccit = {loc\adddotspace cit\adddot},
}
\end{verbatim}
%
Now let's go over the previous examples again, using real
bibliography entries this time.

\clearpage

\subsection*{\cmd{footcite} examples}

This is just filler text.\footcite{aristotle:anima}
This is just filler text.\footcite{averroes/bland}
This is just filler text.\footcite[26]{aristotle:anima}
This is just filler text.\footcite[59--61]{averroes/bland}
This is just filler text.\footcite[26]{aristotle:anima}
This is just filler text.\footcite[59--61]{averroes/bland}
This is just filler text.\footcite{aristotle:physics}
This is just filler text.\footcite{averroes/bland}
This is just filler text.\footcite{aristotle:anima}
This is just filler text.\footcite[55]{aristotle:physics}
This is just filler text.\footcite[25]{aristotle:physics}
% ibidpage=true would suppress the following page number:
This is just filler text.\footcite[25]{aristotle:physics}

\clearpage

% If the 'shorthand' field is defined, the shorthand is introduced
% on the first citation. All subsequent citations will then use the
% shorthand.

This is just filler text.\footcite{kant:kpv}
This is just filler text.\footcite{kant:ku}
This is just filler text.\footcite[24]{kant:kpv}
This is just filler text.\footcite[59--63]{kant:ku}

\clearpage

\subsection*{\cmd{autocite} examples}

% The \autocite command works like \footcite. Note that
% the period is moved and placed before the footnote.

This is just filler text \autocite{aristotle:rhetoric}.
This is just filler text \autocite{averroes/bland}.
This is just filler text \autocite{aristotle:rhetoric}.
This is just filler text \autocite{aristotle:anima}.
This is just filler text \autocite{aristotle:physics}.
This is just filler text \autocite{aristotle:physics}.

\clearpage

% Since all bibliographic data is provided on the first citation,
% this style may be used without a list of references and
% shorthands. Of course these lists may still be printed if desired.

\printshorthands
\printbibliography

\end{document}