summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-apa6/biblatex-apa6-test.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-apa6/biblatex-apa6-test.tex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-apa6/biblatex-apa6-test.tex458
1 files changed, 458 insertions, 0 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-apa6/biblatex-apa6-test.tex b/macros/latex/contrib/biblatex-contrib/biblatex-apa6/biblatex-apa6-test.tex
new file mode 100644
index 0000000000..04ebcc67d4
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-apa6/biblatex-apa6-test.tex
@@ -0,0 +1,458 @@
+\documentclass[paper=a4]{article}
+\usepackage[american]{babel}
+\usepackage{csquotes}
+\usepackage{shortvrb}
+\usepackage{ifthen}
+\usepackage{color}
+\usepackage[retainmissing]{MnSymbol}
+\usepackage[top=2.5cm]{geometry}
+
+% Unicode
+\usepackage{fontspec}
+\setmainfont[Ligatures=TeX]{TeXGyrePagella}
+\setsansfont[Ligatures=TeX]{TexGyreHeros}
+\setmonofont[Ligatures=NoCommon]{TeXGyreCursor}
+\MakeAutoQuote{«}{»}
+
+% Biblatex
+\usepackage[style=apa6]{biblatex}
+
+% Custom settings for misc entries in order to format the table for 6.13*
+% This table implies that the examples on each line are in a separate
+% document but since we are generating the citations from a real data
+% source, we have to prevent the usual uniquelist processing by making
+% all of the examples MISC entrytypes and changing uniquelist
+% per-type. There is no point in just typesetting static data as this
+% wouldn't be a test of anything.
+\ExecuteBibliographyOptions[misc]{uniquelist=false}
+\DeclareNameFormat[misc]{labelname}{%
+ \ifthenelse{\value{listcount}=1\OR\value{listtotal}=2}
+ {\usebibmacro{labelname:doname}
+ {\namepartfamily}
+ {\namepartfamilyi}
+ {\namepartgiven}
+ {\namepartgiveni}
+ {\namepartprefix}
+ {\namepartprefixi}
+ {\namepartsuffix}
+ {\namepartsuffixi}}
+ {\ifthenelse{\value{listtotal}>5}
+ {\ifnum\value{listcount}=2 \andothersdelim\bibstring{andothers}\fi
+ \ifnum\value{listcount}>2 \relax\fi}
+ {\ifciteseen
+ {\ifnum\value{listcount}=2 \andothersdelim\bibstring{andothers}\fi
+ \ifnum\value{listcount}=3 \relax\fi
+ \ifnum\value{listcount}=4 \relax\fi
+ \ifnum\value{listcount}=5 \relax\fi}
+ {\usebibmacro{labelname:doname}
+ {\namepartfamily}
+ {\namepartfamilyi}
+ {\namepartgiven}
+ {\namepartgiveni}
+ {\namepartprefix}
+ {\namepartprefixi}
+ {\namepartsuffix}
+ {\namepartsuffixi}}}}}
+\MakeShortVerb{\|}
+
+\newcommand\apa[2][]{\ifthenelse{\equal{#1}{}}%
+ {\textcolor{blue}{\texttt{(APA #2)}}}%
+ {\textcolor{blue}{\texttt{(APA #2 Example #1)}}}}
+
+\setlength{\parskip}{3ex}
+
+\makeatletter
+% This solution to detokenize leaving a space after the command and
+% arguments is due to Bruno Le Floch on T.SE
+\long\def\apaexi#1{%
+ \catcode64=11
+ \begingroup
+ % Ensure that every character is preserved by \lowercase.
+ \count@\z@
+ \loop\ifnum\count@<256
+ \lccode\count@\z@
+ \advance\count@\@ne
+ \repeat
+ % Except spaces, changed to ^^A
+ \lccode32=\@ne
+ \lowercase{%
+ \endgroup
+ \expandafter\test@\detokenize{#1}\relax%
+ \catcode64=12}}
+% Then map {^^A => space, space =>} onto the string.
+\def\test@#1{%
+ \ifx#1\relax\test@end\fi
+ \ifnum`#1=\@ne\space\else#1\fi
+ \test@}
+\def\test@end\fi#1\test@{\fi}
+
+\def\apaex#1{\hbox{\hspace{-4em}\texttt{\small\apaexi{#1}}}\\$\rcurvearrowse$ \textbf{#1}}
+\def\apaexs#1{\hbox{\texttt{\footnotesize\apaexi{#1}}} \textbf{\small #1}}
+\makeatother
+
+% 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}}}}
+
+\usepackage[colorlinks=true]{hyperref}
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%% END PREAMBLE %%%%%%%%%%%%%%%%%%%%%%%%%
+
+\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}. Also included are some
+clarifications from the APA blog
+(\url{http://blog.apastyle.org/apastyle/}). Please refer to the
+|biblatex-apa6-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}
+\begin{refsection}[../bibtex/bib/biblatex-apa6-test-citations]
+\noindent Please see accompanying file |biblatex-apa6-test-citations.bib|
+for the bibliographic entries which these examples use.
+
+\noindent\apa{4.03}\\
+Oxford comma in citations for three or more names:\\
+\apaex{\textcite{oc1}}\\
+\apaex{\parencite{oc2}}
+
+\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{\autocite{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
+after the first mention 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 citations:\\
+\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 Automatic list disambiguation for ambiguous truncations after
+first cite. Note that «et al» is plural so
+it will only truncate two or more names. If it would truncate just one
+name, we just give the name:\\
+\apaex{\textcite{6.12c}}\\
+\apaex{\textcite{6.12d}}\\
+\apaex{\textcite{6.12c}}\footnote{This example is incorrect in the
+ APA 6th edition manual because «et al» is replacing only one name. This has been
+ verified with the APA and will be corrected in future editions.}\\
+\apaex{\textcite{6.12d}}
+
+\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 Automatic list disambiguation for ambiguous truncations again,
+this time the truncation is on first cite as there are more than 5 authors:\\
+\apaex{\textcite{6.12g}}\\
+\apaex{\textcite{6.12h}}
+
+\noindent Automatic list disambiguation is only for ambiguous author lists
+in the same year so these are not disambiguated:\\
+\apaex{\textcite{6.12i}}\\
+\apaex{\textcite{6.12j}}\\
+\apaex{\textcite{6.12i}}\\
+\apaex{\textcite{6.12j}}
+
+\noindent The following table replicates with real data the examples
+in Table 6.1, p.~177 of the APA 6th Edition manual. Note that this
+table in the APA manual essentially assumes that the citations on each
+line are in a separate document since there is no list disambiguation
+or repeated cite truncations between lines. To simulate this with real
+data, the source for this document uses |\citereset| between lines and
+makes all of the data entries of MISC type, unsetting «uniquelist» for
+this type and using a custom labelname style.
+
+\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}{\raggedright One work by one author}
+& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13a}}} &
+\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13a}}}\citereset
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13a}}}
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13a}}}\\\\
+\parbox{2cm}{\raggedright One work by two authors}
+& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13b}}} &
+\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13b}}}\citereset
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13b}}}
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13b}}}\\\\
+\parbox{2cm}{\raggedright One work by three authors}
+& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13c}}} &
+\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13c}}}\citereset
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13c}}}
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13c}}}\\\\
+\parbox{2cm}{\raggedright One work by four authors}
+& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13d}}} &
+\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13d}}}\citereset
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13d}}}
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13d}}}\\\\
+\parbox{2cm}{\raggedright One work by five authors}
+& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13e}}} &
+\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13e}}}\citereset
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13e}}}
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13e}}}\\\\
+\parbox{2cm}{\raggedright One work by six authors}
+& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13f}}} &
+\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13f}}}\citereset
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13f}}}
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13f}}}\\\\
+\parbox{2cm}{\raggedright Groups (readily identified through abbreviation) as authors}
+& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13g}}} &
+\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13g}}}\citereset\citeresetapa
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13g}}}
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13g}}}\\\\
+\parbox{2cm}{\raggedright Groups (no abbreviation) as authors}
+& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13h}}} &
+\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13h}}}\citereset
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13h}}}
+& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13h}}}\\\\
+\hline
+\end{tabular}
+\end{center}
+
+\noindent\apa{6.13}\\
+Author abbreviations should work between citations of different works by
+the author:\\
+\apaex{\parencite{6.13i}}\\
+\apaex{\parencite{6.13i}}\\
+\apaex{\parencite{6.13j}}
+
+\noindent\apa{6.14}\\
+Citations of an entry with an author who shares a
+surname with another entry always appears with initials when primary
+author. It is not explicit in the APA 6th edition manual but initials only
+appear with primary authors\footnote{\url{http://blog.apastyle.org/apastyle/2014/01/when-to-use-author-initials-for-text-citations.html}}:\\
+\apaex{\textcite{6.14}}\\
+\apaex{\textcite{7.01:3b}}
+
+\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 within 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{\parencites{6.16k,6.16l}}
+
+\noindent Compact citations with special order:\\
+\apaex{\parencites{6.16m}[see also][]{6.16n,6.16o}}
+
+\noindent «in press» should have hyphen before disambiguating part of label
+(also in references):\\
+\apaex{\parencite{6.16p,6.16q,6.16r}}
+
+\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 |ORIGDATE| 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-apa6| 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}}
+
+\noindent Some tests of uniqueness and uniquelist
+
+\noindent Two works by same authors in same year are disambiguated by extradate «a»
+and «b» and are truncated after first cite because it is the same author
+list and therefore not ambiguous:\\
+\apaex{\textcite{UL1}}\\
+\apaex{\textcite{UL1}}\\
+\apaex{\textcite{UL2}}\\
+\apaex{\textcite{UL2}}\\
+
+\noindent One author list is an ordered subset of the other and so both need fully
+expanding to be properly disambiguated. Truncating either would be ambiguous.\\
+\apaex{\textcite{UL3}}\\
+\apaex{\textcite{UL3}}\\
+\apaex{\textcite{UL4}}\\
+\apaex{\textcite{UL4}}
+
+\noindent Some misc citation cases\\
+\apaex{\textcite{6.16c,6.16d,6.16e}}\\
+\apaex{\textcite{6.16f,6.16g,6.16h}}\\
+\apaex{\textcite{6.16f,6.16g,6.16h,6.16i,6.16j}}\\
+Note here that the multicite delimiter is a comma as in running text, a
+semi-colon would be strange:
+\apaex{\textcites{6.16f}{6.16g}{6.16h}{6.16i}{6.16j}}\\
+\apaex{\cite{6.16f,6.16g,6.16h,6.16i,6.16j}}\\
+\apaex{\cite{6.16k,6.16l}}\\
+\apaex{\fullcite{FC1}}\\
+\apaex{\fullcitebib{FC1}}
+
+\noindent Testing «with»---should not be present in cites (APA 6.27)\\
+\apaex{\cite{with1}}\\
+\apaex{\textcite{with1}}
+
+\noindent Testing author name citing\\
+\apaex{\citeauthor{ca1}}\\
+\apaex{\citeauthor{ca1}}
+
+\noindent Testing nodate\\
+\apaex{\textcite{nodate1}}\\
+\apaex{\textcite{nodate2}}
+
+\noindent Testing full name expansion (APA 6.27). See citation refs for how
+these appear in references\\
+\apaex{\textcite{6.27a}}\\
+\apaex{\textcite{6.27b}}
+
+\noindent Testing suffices\\
+\apaex{\textcite{stest1}}\\
+\apaex{\textcite{stest2}}
+
+\noindent Testing prefices\\
+\apaex{\textcite{pretest}}\\
+\apaex{\textcite{nopretest}}
+
+% presufftest2 and nopresufftest are the same name and so even though
+% useprefix=false nopresufftest, hashes are the same so there is an extradate
+\noindent Testing prefices plus suffices\\
+\apaex{\textcite{presufftest}}\\
+\apaex{\textcite{presufftest2}}\\
+\apaex{\textcite{nopresufftest}}
+
+\noindent Testing «and others»\\
+\apaex{\textcite{ao1}}\\
+\apaex{\textcite{ao2}}
+
+\noindent Testing seasonal periodical citations\\
+\apaex{\textcite{season1}}
+
+\noindent Testing first list name initials only as per:\\
+\url{http://blog.apastyle.org/apastyle/2014/01/when-to-use-author-initials-for-text-citations.html}\\
+First citation:\\
+\apaex{\parencite{first,second,third,fourth,deutsch1963}}\\
+Second citation:\\
+\apaex{\parencite{first,second,third,fourth,deutsch1963}}
+
+% Testing name elision in cites
+% That is, \parencite{kingetal2005a,weissetal2007a,weissetal2009a}
+% Should give:
+% (King, Weiss, & Farmer, 2005; Weiss, King, & Hopkins, 2007; Weiss et al., 2009)
+% and not
+% (King, Weiss, & Farmer, 2005; Weiss, King, & Hopkins, 2007, 2009)
+% which happens if elision is based on namehash because the mincitenames
+% truncation of the 2007 and 2009 names is the same
+\noindent{Testing name elision in cites}\\
+\apaex{\parencite{kingetal2005a,weissetal2007a,weissetal2009a}}
+
+\noindent Testing circa/BCE/uncertain era format\\
+\apaex{\nptextcite{plato}}
+
+\noindent Testing citation formats for complete dates\\
+\apaex{\textcite{Ludwig2014}}
+
+\noindent Testing month ranges with same months, different days\\
+\apaex{\textcite{daterange1}}
+
+\noindent Testing month ranges with different months\\
+\apaex{\textcite{daterange2}}
+
+\end{refsection}
+\begin{refsection}[../bibtex/bib/biblatex-apa6-test-references]
+\nocite{*}
+\end{refsection}
+\newpage
+% Just (APA 7.x) real references and related entry examples here
+\printbibliography[section=2]
+\newpage
+% Include a references section for citation examples just so hyperref
+% targets can be checked
+\printbibliography[section=1,title=Misc citation references]
+\end{document}
+
+% Local Variables:
+% TeX-engine: luatex
+% End: