summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex
blob: ec3faa2a575a5d3c4cb513cfb364858a81f9122f (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
\documentclass{article}
\usepackage[american]{babel}
\usepackage{csquotes}
\usepackage{shortvrb}
\usepackage{ifthen}
\usepackage{color}
\usepackage[retainmissing]{MnSymbol}

% Unicode
\usepackage{fontspec}
\setmainfont[Ligatures=TeX]{TeXGyrePagella}
\setsansfont{Arial}
\setmonofont{Courier New}

% Biblatex
\usepackage[style=apa,%
            backend=biber,
            bibencoding=utf8]{biblatex}

\MakeShortVerb{\|}

\newcommand\apa[2][]{\ifthenelse{\equal{#1}{}}%
                       {\textcolor{blue}{\texttt{(APA #2)}}}%
                       {\textcolor{blue}{\texttt{(APA #2 Example #1)}}}}

\setlength{\parskip}{3ex}
\bibliography{biblatex-apa-test-citations,biblatex-apa-test-references}

\def\apaex#1{\hbox{\hspace{-4em}\texttt{\small\detokenize{#1}}}\\$\rcurvearrowse$ \textbf{#1}}
\def\apaexs#1{\hbox{\texttt{\footnotesize\detokenize{#1}}} \textbf{\small #1}}

% This just makes it easier to find a specific (APA 7.x) example in the
% typeset references section
\reversemarginpar
\renewbibmacro*{begentry}{\marginpar{\footnotesize \textcolor{blue}{\thefield{entrykey}}}}

%%%%%%%%%%%%%%%%%%%%%%%%%%%% END PREAMBLE %%%%%%%%%%%%%%%%%%%%%%%%%
\DeclareLanguageMapping{american}{american-apa}

\begin{document}

\section*{|biblatex-apa| style examples}

This file typesets just about all useful examples from
\apa{6.11}--\apa{6.21} and \apa{7.01}--\apa{7.11}. Please refer to the
|biblatex-apa-test-references.bib| file for details on the references
entries. The |.bib| key for each entry in the References section is listed
for convenience in the left margin. The keys are not arbitrary and consist
of the APA section they are taken from (7.01--7.11), followed by a colon,
followed by the example number. This makes it easier to cross-reference
the typeset examples with the commented |.bib| file. I chose not to put the
examples in the References section in example number order so that the APA
requirements for References list alphabetisation and order could also be
demonstrated.

\section*{Citations}

\noindent Please see accompanying file |biblatex-apa-test-citations.bib|
for the bibliographic entries which these examples use.

\noindent\apa{6.11}\\
Simple cite. ``Jr.'' suffix is not shown (bib entry for this example has a suffix):\\
\apaex{\textcite{6.11}}

\noindent Within a paragraph, not in the ``narrative sense'':\\
\apaex{\parencite{6.11}}

\noindent To cite the parts separately:\\
\apaex{\citeyear{6.11}, \citeauthor{6.11}}

\noindent The per-paragraph rules for elision of years are more flexible in
APA 6th edition. There is more discretion to do this as the narrative
consistency suggests and so this style no longer automatically elides years
aver mention after the first within a paragraph. Cases can be handled as
per the examples above.

\noindent\apa{6.12} \apa{6.13}\\
Citations like\\
\apaex{\textcite{6.12a}}\\
which have two authors are never name-truncated after the first cite:\\
\apaex{\textcite{6.12a}}

\noindent First citation of 3--5 author entry:\\
\apaex{\textcite{6.12b}}

\noindent Subsequent first citations in a paragraph:\\
\apaex{\textcite{6.12b}}\\
Subsequent citations within a paragraph:\\
\apaex{\citeauthor{6.12b}}

\noindent Note that the dropping of the year for subsequent paragraph
citations is not automatic as there may be cases where you don't want to do
this (see APA 6.11).

\noindent\textcolor{red}{Note: The name list disambiguation required in the
  \emph{Exception:} clause here in the APA manual cannot be automated
  currently in |biblatex|. This is due to the underlying reliance on the
  |bibtex| |.bib| data model. This will change in a future |biblatex|
  release. See |biblatex-apa| docs.}

\noindent Multiple-authors in running text are separated by ``and''.
However, in parenthetical cites, multiple authors are separated by ``\&'':\\
\apaex{\textcite{6.12e}}\\
\apaex{\parencite{6.12f}}

\noindent The following citation should be name truncated on first cite
since it has six or more authors:\\
\apaex{\textcite{6.12g}}

\noindent\textcolor{red}{Note: The note above applies to the disambiguation
of entries with six or more names}

\noindent Now, following the examples in Table 6.1, p. 177 of the APA
manual. Note in the code that typesets these examples, |\citereset| is used
to pretend that the parenthetical examples are the first in the text.

\begin{center}
\begin{tabular}{lllll}
\textbf{\parbox{2cm}{\center Type of citation}} & \textbf{\parbox{2.4cm}{\center First
    citation in text}} & \textbf{\parbox{2.4cm}{\center Subsequent citations in
    text}} & \textbf{\parbox{2.4cm}{\center Parenthetical format, first citation
    in text}} & \textbf{\parbox{2.4cm}{\center Parenthetical format, subsequent
    citations in text}}\\\\
\hline
\\
\parbox{2cm}{One work by one author}
& \parbox{2.4cm}{\apaexs{\textcite{6.13a}}} &
\parbox{2.4cm}{\apaexs{\textcite{6.13a}}}\citereset
& \parbox{2.4cm}{\apaexs{\parencite{6.13a}}}
& \parbox{2.4cm}{\apaexs{\parencite{6.13a}}}\\\\
\parbox{2cm}{One work by two authors}
& \parbox{2.4cm}{\apaexs{\textcite{6.13b}}} & 
\parbox{2.4cm}{\apaexs{\textcite{6.13b}}}\citereset
& \parbox{2.4cm}{\apaexs{\parencite{6.13b}}}
& \parbox{2.4cm}{\apaexs{\parencite{6.13b}}}\\\\
\parbox{2cm}{One work by three authors}
& \parbox{2.4cm}{\apaexs{\textcite{6.13c}}} & 
\parbox{2.4cm}{\apaexs{\textcite{6.13c}}}\citereset
& \parbox{2.4cm}{\apaexs{\parencite{6.13c}}}
& \parbox{2.4cm}{\apaexs{\parencite{6.13c}}}\\\\
\parbox{2cm}{One work by four authors}
& \parbox{2.4cm}{\apaexs{\textcite{6.13d}}} & 
\parbox{2.4cm}{\apaexs{\textcite{6.13d}}}\citereset
& \parbox{2.4cm}{\apaexs{\parencite{6.13d}}}
& \parbox{2.4cm}{\apaexs{\parencite{6.13d}}}\\\\
\parbox{2cm}{One work by five authors}
& \parbox{2.4cm}{\apaexs{\textcite{6.13e}}} & 
\parbox{2.4cm}{\apaexs{\textcite{6.13e}}}\citereset
& \parbox{2.4cm}{\apaexs{\parencite{6.13e}}}
& \parbox{2.4cm}{\apaexs{\parencite{6.13e}}}\\\\
\parbox{2cm}{One work by six authors}
& \parbox{2.4cm}{\apaexs{\textcite{6.13f}}} & 
\parbox{2.4cm}{\apaexs{\textcite{6.13f}}}\citereset
& \parbox{2.4cm}{\apaexs{\parencite{6.13f}}}
& \parbox{2.4cm}{\apaexs{\parencite{6.13f}}}\\\\
\parbox{2cm}{Groups (readily identified through abbreviation) as authors}
& \parbox{2.4cm}{\apaexs{\textcite{6.13g}}} & 
\parbox{2.4cm}{\apaexs{\textcite{6.13g}}}\citereset
& \parbox{2.4cm}{\apaexs{\parencite{6.13g}}}
& \parbox{2.4cm}{\apaexs{\parencite{6.13g}}}\\\\
\parbox{2cm}{Groups (no abbreviation) as authors}
& \parbox{2.4cm}{\apaexs{\textcite{6.13h}}} & 
\parbox{2.4cm}{\apaexs{\textcite{6.13h}}}\citereset
& \parbox{2.4cm}{\apaexs{\parencite{6.13h}}}
& \parbox{2.4cm}{\apaexs{\parencite{6.13h}}}\\\\
\hline
\end{tabular}
\end{center}

\noindent\apa{6.14}\\
Citations of an entry with an author who shares a
surname with another entry always appears with initials:\\
\apaex{\textcite{6.14}}\\
and\\
\apaex{\textcite{7.01:3b}}\\\\
\textcolor{red}{Note: The second citation key here is taken from the APA
  references section as it is repeated there. This example is currently impossible to automate as
  it is, due to the nature of name list parsing in BibTeX. Disambiguation
  works between single names and not names within lists at the moment. The
  first example works due to a dummy single-name entry with the same
  surname in the |.bib| for the citation examples. See
 |biblatex-apa| docs. This is planned to be fully supported with |biblatex|
 2.x which should include the necessary underlying functionality}.

\noindent\apa{6.15}\\
Use |SHORTTITLE| field of the entry if it exists:\\
\apaex{\parencite{6.15a}}\\
Books, reports etc. use italics instead of quotes:\\
\apaex{\textcite{6.15b}}
Citing anonymous author:\\
\apaex{\textcite{6.15c}}

\noindent\apa{6.16}\\
Two or more works withing the same parentheses:\\
\apaex{\parencite{6.16a,6.16b}}\\
\apaex{\parencite{6.16c,6.16d,6.16e}}

\noindent Citations of works by same authors in the same  year:\\
\apaex{\parencite{6.16f,6.16g,6.16h,6.16i,6.16j}}\\\\
\textcolor{red}{Note: This example, (p. 178 APA Manual 6th edition, 2nd
  printing) is slightly odd as the ``in-press-a'' is not indicated and
  should be ``in-press'' since no other in press items are listed for the
  same authors in the example.}

\noindent Compact citations in alphabetic order:\\
\apaex{\parencite{6.16k,6.16l}}

\noindent Compact citations with special order:\\
\apaex{\parencites{6.16m}[see also][]{6.16n,6.16o}}

\noindent\apa{6.17}\\
Secondary sources:\\
\apaex{\parencite[as cited in][]{6.17}}\\

\noindent\apa{6.18}\\
Classical works:\\
\apaex{(\citeauthor{6.18a}, trans. \citeyear{6.18a})}\\
\textcolor{red}{Note: The example is managed using lower-level cite
  commands. This is another example of the APA not really thinking about
  automated processing and specifying an anomalous infix format. It would
  be better and probably acceptable for it to be:}\\
\apaex{\parencite[][trans.]{6.18a}}\\\\
Entries with an |ORIGYEAR| field will automatically use it:\\
\apaex{\textcite{6.18b}}\\\\
The other examples of standard classical texts in this section should just
be typed by hand--there is little benefit to automating these examples and
they wouldn't usually be in the References section anyway.

\noindent\apa{6.19}\\
These examples are easily dealt with using standard |biblatex| functionality.\\
\apaex{\parencite[][10]{6.19a}}\\
\apaex{\parencite[][Chapter 3]{6.19b}}\\

\noindent\apa{6.20}\\
Such cases are just typed out--they have no Reference section entry and
don't therefore have a bibliography database entry.

\noindent\apa{6.21}\\
Within parentheses, use the |\nptextcite| command which is equivalent to
the |\textcite| command but omits the parenthesis and uses commas instead.
See the |biblatex-apa| docs.\\
\apaex{(\nptextcite[see Table 3 of][]{6.21} for complete data)}

\noindent\apa{6.28}\\
Entries with no date use ``n.d.''.\\
\apaex{\textcite{6.28a}}\\
\apaex{\parencite{6.28a}}\\
\apaex{(\nptextcite{6.28a})}\\

\noindent\apa{7.01:12c}\\
Issue with no editors\\
\apaex{\parencite{7.01:12c}}\\

\noindent\apa{A7.07}\\
A patent citation uses the title but with no quotes\\
\apaex{\textcite{A7.07}}\\
\apaex{\parencite{A7.07}}\\


\newpage
\nocite{*}
% Exclude the citation examples from the References section - only want to
% see (APA 7.x) examples there.
\printbibliography[notkeyword=noinclude]
\end{document}