From 80cb9c50ef0c7af421240024db2804123753d73b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 27 Nov 2019 22:06:27 +0000 Subject: biblatex-apa6 (27nov19) git-svn-id: svn://tug.org/texlive/trunk@52949 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/biblatex-apa6/README | 34 + .../biblatex-apa6/biblatex-apa6-test-citations.bib | 624 ++++++++++++ .../biblatex-apa6-test-references.bib | 1060 ++++++++++++++++++++ .../doc/latex/biblatex-apa6/biblatex-apa6-test.pdf | Bin 0 -> 38864 bytes .../doc/latex/biblatex-apa6/biblatex-apa6-test.tex | 458 +++++++++ .../doc/latex/biblatex-apa6/biblatex-apa6.pdf | Bin 0 -> 92348 bytes .../doc/latex/biblatex-apa6/biblatex-apa6.tex | 882 ++++++++++++++++ 7 files changed, 3058 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/biblatex-apa6/README create mode 100644 Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test-citations.bib create mode 100644 Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test-references.bib create mode 100644 Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test.pdf create mode 100644 Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6.pdf create mode 100644 Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6.tex (limited to 'Master/texmf-dist/doc/latex/biblatex-apa6') diff --git a/Master/texmf-dist/doc/latex/biblatex-apa6/README b/Master/texmf-dist/doc/latex/biblatex-apa6/README new file mode 100644 index 00000000000..e1c844da646 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-apa6/README @@ -0,0 +1,34 @@ +Permission is granted to copy, distribute and/or modify this software under +the terms of the LaTeX Project Public License, version +1.3c (http://www.latex-project.org/lppl.txt). The current +maintainer is Philip Kime (© 2018). + +This package is a biblatex style for APA (American Psychological +Association) 6th Edition style compliant documents typeset in LaTeX. It +implements a citation style (apa6.cbx) and a references section style +(apa6.bbx). The styles are loaded just like any other biblatex +styles but I wouldn't try to use the citation and references styles +separately as they rely on each other, macro-wise, in places. + +In this document and in the code, the specific APA requirements are +referred to by the section and (if appropriate) the example number of the +APA Style Guide 6th Edition). + +You will need to be using csquotes >= 4.3 and biblatex >= 3.4 The biber +backend for biblatex >= 2.5 is also required. This style will not work +correctly if using bibtex as the backend for biblatex. If you want to take +advantage of the biblatex \DeclareQuotePunctuation facility to enforce the +APA required "American punctuation", you should use the babel package with +the "american" option (see biblatex manual section |3.9.1|). You can of +course use other languages but in such cases, to adhere to APA "American" +punctuation rules (following commas moved inside closing quotes etc.), then +you should set up \DeclareQuotePunctuation yourself as per section 4.7.5 of +the biblatex manual. + +You can also use this with apa.cls version 1.3.4 or greater by using the +"noapacite" class option to that class package (which prevents it from +trying to use plain bibtex with the apacite package). + +Please refer first to biblatex-apa6.pdf for the main documentation. + + diff --git a/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test-citations.bib b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test-citations.bib new file mode 100644 index 00000000000..d0245f48c24 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test-citations.bib @@ -0,0 +1,624 @@ +% (APA 6.11) +@BOOK{6.11, + AUTHOR = {Kessler, Jr., A.}, + TITLE = {Title}, + DATE = {2003}, +} + +% (APA 6.12) +@BOOK{6.12a, + AUTHOR = {A. Smith and B. Jones}, + TITLE = {Title}, + DATE = {2007}, +} + +@BOOK{6.12b, + AUTHOR = {A. Kisangau and B. Lyaruu and C. Hosea and D. Joseph}, + TITLE = {Title}, + DATE = {2007}, +} + +@BOOK{6.12c, + AUTHOR = {A. Ireys and B. Chernoff and C. DeVet and D. Kim}, + TITLE = {Title}, + DATE = {2001}, +} + +@BOOK{6.12d, + AUTHOR = {A. Ireys and B. Chernoff and E. Stein and C. DeVet and F. Silver}, + TITLE = {Title}, + DATE = {2001}, +} + +@BOOK{6.12e, + AUTHOR = {A. Kurtines and B. Szapocznik}, + TITLE = {Title}, + DATE = {2003}, +} + +@BOOK{6.12f, + AUTHOR = {A. Jöreskog and B. Sörbon}, + TITLE = {Title}, + DATE = {2007}, +} + +@BOOK{6.12g, + AUTHOR = {A. Kosslyn and B. Koenig and C. Barrett and D. Cave and E. Tang and F. Gabrieli}, + TITLE = {Title}, + DATE = {1996}, +} + +@BOOK{6.12h, + AUTHOR = {A. Kosslyn and B. Koenig and F. Gabrieli and E. Tang and G. Marsolek and H. Daly}, + TITLE = {Title}, + DATE = {1996}, +} + +@BOOK{6.12i, + AUTHOR = {A. Albert and B. Bryant and C. Cuthbert and D. Dinge}, + TITLE = {Title}, + DATE = {1990}, +} + +@BOOK{6.12j, + AUTHOR = {A. Albert and B. Bryant and C. Cuthbert and E. Elide}, + TITLE = {Title 2}, + DATE = {1991}, +} + +% (APA 6.13) +% These are all misc so that we can turn off uniquelist because they all interact and +% break the examples otherwise. The reason is that we are generating these examples +% from a real datasource. The table as displayed in the APA 6th assumes that the examples +% are just static strings. +@MISC{6.13a, + AUTHOR = {A. Walker}, + TITLE = {Title}, + DATE = {2007}, +} + +@MISC{6.13b, + AUTHOR = {A. Walker and B. Allen}, + TITLE = {Title}, + DATE = {2004}, +} + +@MISC{6.13c, + AUTHOR = {A. Bradley and B. Ramirez and C. Soo}, + TITLE = {Title}, + DATE = {1999}, +} + +@MISC{6.13d, + AUTHOR = {A. Bradley and B. Ramirez and C. Soo and D. Walsh}, + TITLE = {Title}, + DATE = {2006}, +} + +@MISC{6.13e, + AUTHOR = {A. Walker and B. Allen and A. Bradley and B. Ramirez and C. Soo}, + TITLE = {Title}, + DATE = {2008}, +} + +@MISC{6.13f, + AUTHOR = {Z. Wasserstein and A. Walker and B. Allen and A. Bradley and B. Ramirez and C. Soo}, + TITLE = {Title}, + DATE = {2005}, +} + +@MISC{6.13g, + AUTHOR = {{National Institute of Mental Health}}, + SHORTAUTHOR = {NIMH}, + TITLE = {Title}, + DATE = {2003}, +} + +@MISC{6.13h, + AUTHOR = {{University of Pittsburgh}}, + TITLE = {Title}, + DATE = {2005}, +} + +@MISC{6.13i, + AUTHOR = {{The American Psychological Association}}, + SHORTAUTHOR = {APA}, + TITLE = {Title1}, + DATE = {2005}, +} + +@MISC{6.13j, + AUTHOR = {{The American Psychological Association}}, + SHORTAUTHOR = {APA}, + TITLE = {Title2}, + DATE = {2006}, +} + +% (APA 6.14) +@BOOK{6.14, + AUTHOR = {I. Light}, + TITLE = {Deflecting Immigration}, + SUBTITLE = {Networks, Markets, and Regulation in {L}os {A}ngeles}, + DATE = {2006}, + LOCATION = {New York, NY}, + PUBLISHER = {Russell Sage Foundation}, +} + +% (APA 6.15) +@ARTICLE{6.15a, + TITLE = {Study Finds Something Interesting}, + SHORTTITLE = {Study Finds}, + DATE = {2007}, +} + +@BOOK{6.15b, + TITLE = {College Bound Seniors}, + DATE = {2008}, +} + +@BOOK{6.15c, + AUTHOR = {Anonymous}, + TITLE = {Title}, + DATE = {1998}, +} + +% (APA 6.16) +@BOOK{6.16a, + AUTHOR = {{Department of Veterans Affairs}}, + TITLE = {Title1}, + DATE = {2001}, +} + +@BOOK{6.16b, + AUTHOR = {{Department of Veterans Affairs}}, + TITLE = {Title1}, + DATE = {2003}, +} + +@BOOK{6.16c, + AUTHOR = {A. Gogel}, + TITLE = {Title1}, + DATE = {1990}, +} + +@BOOK{6.16d, + AUTHOR = {A. Gogel}, + TITLE = {Title2}, + DATE = {2006}, +} + +@BOOK{6.16e, + AUTHOR = {A. Gogel}, + TITLE = {Title3}, + PUBSTATE = {inpress}, +} + +@BOOK{6.16f, + AUTHOR = {A. Derryberry and B. Reed}, + TITLE = {Title1}, + DATE = {2005}, +} + +@BOOK{6.16g, + AUTHOR = {A. Derryberry and B. Reed}, + TITLE = {Title2}, + DATE = {2005}, +} + +@BOOK{6.16h, + AUTHOR = {A. Derryberry and B. Reed}, + TITLE = {Title3}, + PUBSTATE = {inpress}, +} + +@BOOK{6.16i, + AUTHOR = {A. Rothbart}, + TITLE = {Title1}, + DATE = {2003}, +} + +@BOOK{6.16j, + AUTHOR = {A. Rothbart}, + TITLE = {Title2}, + DATE = {2003}, +} + +@BOOK{6.16k, + AUTHOR = {A. Miller}, + TITLE = {Title}, + DATE = {1999}, +} + +@BOOK{6.16l, + AUTHOR = {A. Shafrankse and B. Mahoney}, + TITLE = {Title}, + DATE = {1998}, +} + +@BOOK{6.16m, + AUTHOR = {A. Minor}, + TITLE = {Title}, + DATE = {2001}, +} + +@BOOK{6.16n, + AUTHOR = {A. Adams}, + TITLE = {Title}, + DATE = {1999}, +} + +@BOOK{6.16o, + AUTHOR = {A. Storandt}, + TITLE = {Title}, + DATE = {2007}, +} + +% PUBSTATE is not used as there is a year - enforces by a style source map in .bbx +@BOOK{6.16p, + AUTHOR = {Steven Smidge}, + TITLE = {Something 1}, + DATE = {2000}, + PUBSTATE = {inpress} +} + +@BOOK{6.16q, + AUTHOR = {Steven Smidge}, + TITLE = {Something 2}, + PUBSTATE = {inpress} +} + +@BOOK{6.16r, + AUTHOR = {Steven Smidge}, + TITLE = {Something 3}, + PUBSTATE = {inpress} +} + + +% (APA 6.17) +@BOOK{6.17, + AUTHOR = {A. Nicholson}, + TITLE = {Title}, + DATE = {2003}, +} + +% (APA 6.18) +@BOOK{6.18a, + AUTHOR = {Aristotle}, + TITLE = {Ethics}, + TRANSLATOR = {S. Translator}, + DATE = {1931}, +} + +@BOOK{6.18b, + AUTHOR = {H. James}, + TITLE = {Novel}, + ORIGDATE = {1890}, + DATE = {1983}, +} + +% Last two examples need no references entry + +% (APA 6.19) +@BOOK{6.19a, + AUTHOR = {{Centers for Disease Control and Prevention}}, + TITLE = {Title}, + DATE = {2005}, +} + +@BOOK{6.19b, + AUTHOR = {A. Shimamura}, + TITLE = {Title}, + DATE = {1989}, +} + +% (APA 6.20) - No examples need references entry + +% (APA 6.21) +@BOOK{6.21, + AUTHOR = {{U.S. Department of Labor}}, + TITLE = {Title}, + DATE = {2007}, +} + +% (APA 6.28a) +@BOOK{6.28a, + AUTHOR = {Arthur Somebody}, + TITLE = {Some Title}, +} + +% These are copied from the references .bib file just so the sections splitting works +@ARTICLE{7.01:3b, + AUTHOR = {M. A. Light and I. H. Light}, + TITLE = {The Geographic Expansion of Mexican Immigration in the United States and its Implications for Local Law Enforcement}, + DATE = {2008}, + JOURNALTITLE = {Law Enforcement Executive Forum Journal}, + VOLUME = {8}, + NUMBER = {1}, + PAGES = {73--82}, +} + +@ARTICLE{7.01:12c, + TITLE = {Capital Punishment in the United Kingdom}, + SHORTTITLE = {Capital Punishment}, + TITLEADDON = {Special issue}, + JOURNALTITLE = {Psychology, Public Policy and Law}, + VOLUME = {10}, + NUMBER = {4}, + DATE = {2004} +} + +@PATENT{A7.07, + AUTHOR = {I. M. Smith}, + TITLE = {{U}.{S}. {P}atent {N}o. 123,445}, + DATE = {1998}, + LOCATION = {Washington, DC}, + PUBLISHER = {U.S. Patent and Trademark Office} +} + +% Testing fullcite so make it nice and long +@ARTICLE{FC1, + AUTHOR = {Arthur Amorous and Brian Belligerent and Clive Clandestine}, + TITLE = {Names Which Inspire Envy}, + SUBTITLE = {The Fashions of Nominal Imprudence}, + DATE = {1923}, + JOURNALTITLE = {Journal of International Interest}, + VOLUME = {87}, + NUMBER = {12}, + PAGES = {1423--1458}, +} + +% Testing uniqueness for identical name lists and subset lists +@BOOK{UL1, + AUTHOR = {Jeremy Jester and Gregory Gesticulate and Randolf Rumble}, + TITLE = {Many Things and Other Topics}, + DATE = {2010} +} + +@BOOK{UL2, + AUTHOR = {Jeremy Jester and Gregory Gesticulate and Randolf Rumble}, + TITLE = {Random Articles Found Under Cats}, + DATE = {2010} +} + +@BOOK{UL3, + AUTHOR = {Patricia Petulant and Cloe Clueless and Brian Beffudled}, + TITLE = {Can You Say a Word?}, + DATE = {2010} +} + +@BOOK{UL4, + AUTHOR = {Patricia Petulant and Cloe Clueless and Brian Beffudled and Graham Grunt}, + TITLE = {Looking at Spiders}, + DATE = {2010} +} + +% Testing "with" +@BOOK{with1, + AUTHOR = {James Jaunty and Russell Rendition}, + WITH = {Alan Also}, + TITLE = {Look for Lost Limps}, + DATE = {2000} +} + +% Testing citeauthor +@BOOK{ca1, + AUTHOR = {Brian Blameless and Colin Careless and Derek Delusional}, + TITLE = {Three Modern Men}, + DATE = {2001} +} + +% Testing no date +@BOOK{nodate1, + AUTHOR = {Neil Nodate}, + TITLE = {Testing}, + URLDATE = {2012} +} + +@BOOK{nodate2, + AUTHOR = {Neil Nodate}, + TITLE = {Testing 2}, +} + +% Testing full name expansion (APA 6.27) +@ARTICLE{6.27a, + AUTHOR = {Paul Janet}, + TITLE = {The Notion of Personality}, + ORIGTITLE = {La notion de la personnalité}, + JOURNALTITLE = {Revue Scientifique}, + VOLUME = {10}, + PAGES = {574-575}, + DATE = {1876} +} + +@ARTICLE{6.27b, + AUTHOR = {Pierre Janet}, + TITLE = {The Pathogenesis of Some Impulsions}, + JOURNALTITLE = {Journal of Abnormal Psychology}, + VOLUME = {1}, + PAGES = {1-17}, + DATE = {1906} +} + +% Suffix test for first-last (editor) +@INCOLLECTION{stest1, + AUTHOR = {Gring, III, Alan J.}, + EDITOR = {Greaves, Jr., Percy L.}, + TITLE = {A test of suffix 1}, + DATE = {1968}, + LOCATION = {New York, NY}, + PUBLISHER = {Wiley}, + PAGES = {1--34} +} + +% Suffix test for first-last (editor) +@INCOLLECTION{stest2, + EDITOR = {Greaves, Jr., Percy L.}, + TITLE = {A test of suffix 2}, + DATE = {1968}, + LOCATION = {New York, NY}, + PUBLISHER = {Wiley}, + PAGES = {1--34} +} + +% Don't forget that useprefix=false doesn't ignore the prefix completely - it is still used in +% hash and uniqueness generation and so there are two different "Greaves" here - one von and one not +% Prefix test (useprefix=true) +@BOOK{pretest, + AUTHOR = {Luis von Mises}, + TITLE = {A Title}, + DATE = {2000} +} + +% Prefix test (useprefix=false) +@MISC{nopretest, + OPTIONS = {useprefix=false}, + AUTHOR = {Luis von Mises}, + TITLE = {Another Title}, + DATE = {2001} +} + +% Prefix + suffix test (useprefix=true) first-last +@INCOLLECTION{presufftest, + EDITOR = {von Greaves, Jr., Percy L.}, + TITLE = {A test of prefix 2}, + DATE = {1969}, +} + +% Prefix + suffix test (useprefix=false) +@MISC{nopresufftest, + OPTIONS = {useprefix=false}, + AUTHOR = {von Greaves, Jr., Percy L.}, + TITLE = {A test of noprefix 2}, + DATE = {2001} +} + +% Prefix + suffix test (useprefix=true) +@BOOK{presufftest2, + AUTHOR = {von Greaves, Jr., Percy L.}, + TITLE = {A test of noprefix 2}, + DATE = {2001} +} + +% Oxford comma tests +@BOOK{oc1, + AUTHOR = {Hilarious, Hillary and Mirthful, Malcolm and Chuckles, Charles}, + TITLE = {Laughter Through the Ages}, + DATE = {1987} +} + +@BOOK{oc2, + AUTHOR = {Miserable, Markus and Doleful, Derek and Bitter, Brian}, + TITLE = {Dictionary of Depressions}, + DATE = {1987} +} + +% Test "and others" +@ARTICLE{ao1, + AUTHOR = {Boker, S. and Neale, M. and Maes, H. and Wilde, M. and + Spiegel, M. and Brick, T. and Spies, J. and Estabrook, + R. and Kenny, S. and Bates, T. and others}, + TITLE = {Open{M}x: {A}n open source extended structural + equation modeling framework}, + JOURNAL = {Psychometrika}, + VOLUME = {76}, + NUMBER = {2}, + PAGES = {306--317}, + DATE = {2011} +} + +@ARTICLE{ao2, + AUTHOR = {Olive, K. A. and others}, + DATE = {2014} +} + +% Testing season +@ARTICLE{season1, + AUTHOR = {Terrence Test}, + TITLE = {Some Title}, + JOURNAL = {Jolly Journal}, + ISSUE = {Spring}, + PAGES = {100--103}, + DATE = {2001} +} +% Testing name initials as per: http://blog.apastyle.org/apastyle/2014/01/when-to-use-author-initials-for-text-citations.html +@BOOK{first, + AUTHOR = {Brown, Y. and Campbell, W. K.}, + DATE = {2004} +} + +@BOOK{second, + AUTHOR = {Campbell, A. and Muncer, M. and Gorman, B.}, + DATE = {1993} +} + +@BOOK{third, + AUTHOR = {Campbell, W. K. and Bush, C. P. and Brunell, A. B.}, + DATE = {2005} +} + +@BOOK{fourth, + AUTHOR = {Smyth, L. N. and Campbell, A. and Adams, K.}, + DATE = {1992} +} + +@ARTICLE{deutsch1963, + TITLE = {Attention: Some theoretical considerations}, + AUTHOR = {Deutsch, J. Anthony and Deutsch, Diana}, + JOURNAL = {Psychological Review}, + VOLUME = {70}, + NUMBER = {1}, + PAGES = {1--10}, + DATE = {1963}, +} + +% Testing multicite name elision +@ARTICLE{kingetal2005a, + AUTHOR = {King, J. E. and Weiss, A. and Farmer, K. H.}, + TITLE = {Title}, + DATE = {2005} +} + +@ARTICLE{weissetal2007a, + AUTHOR = {Weiss, A. and King, J. E. and Hopkins, W. D.}, + TITLE = {Title}, + DATE = {2007} +} + +@ARTICLE{weissetal2009a, + AUTHOR = {Weiss, A. and Inoue-Murayama, M. and Hong, K-W. and Inoue, E. and Udono, S. and Ochiai, T. and Matsuzawa, T. and Hirata, S. and King, J. E.}, + TITLE = {Title}, + DATE = {2009} +} + +% Testing era output +@BOOK{plato, + AUTHOR = {Plato}, + TITLE = {Meno}, + DATE = {-0379%} +} + +% Testing citation with complete dates +@ARTICLE{Ludwig2014, + ENTRYSUBTYPE = {nonacademic}, + AUTHOR = {Ludwig, Jan}, + TITLE = {Wenn nichts mehr geht}, + URL = {http://www.zeit.de/campus/2014/06/pruefungsergebnis-klage}, + JOURNALTITLE = {Zeit Campus}, + DATE = {2014-10-08}, + LANGUAGE = {de} +} + +% Testing date range with same months, different days +@BOOK{daterange1, + AUTHOR = {Freddy Furnishings}, + TITLE = {Authorship Provisions in Augment}, + DATE = {1984-02-01/1984-02-27}, +} + +% Testing date range with different months +@BOOK{daterange2, + AUTHOR = {Graham Granary}, + TITLE = {Authorship Provisions in Augment}, + DATE = {1984-02-27/1984-03-01}, +} + diff --git a/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test-references.bib b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test-references.bib new file mode 100644 index 00000000000..c6d6892f39e --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test-references.bib @@ -0,0 +1,1060 @@ +% (APA 7.01 Example 1) +% Note that the URL is suppressed if there is a DOI +@ARTICLE{7.01:1, + AUTHOR = {K. L. Herbst-Damm and J. A. Kulik}, + TITLE = {Volunteer Support, Marital Status, and the Survival Times of Terminally Ill Patients}, + JOURNALTITLE = {Health Psychology}, + VOLUME = {24}, + PAGES = {225--229}, + DATE = {2005}, + DOI = {10.1037/0278-6133.24.2.225}, + URL = {http://some.url} + +} + +% (APA 7.01 Example 2) +% Note here that there is a month but this should not be shown in ARTICLES +% as per 6.28 +@ARTICLE{7.01:2, + AUTHOR = {D. G. Gilbert and J. F. McClernon and N. E. Rabinovich and C. Sugai and L. C. Plath and G. Asgaard and D. Dickinson and N. Botros}, + TITLE = {Effects of Quitting Smoking and {EEG} Activation and Attention Last for More Than 31 Days and are More Severe With Stress, Dependence, {DRD2 A1} Allele, and Depressive Traits}, + JOURNALTITLE = {Nicotine and Tobacco Research}, + VOLUME = {6}, + PAGES = {249--267}, + DATE = {2004-06-22}, + DOI = {10.1080/14622200410001676305} +} + +% (APA 7.01 Example 3) +@ARTICLE{7.01:3a, + AUTHOR = {T. J. Sillick and N. S. Schutte}, + TITLE = {Emotional Intelligence and Self-esteem Mediate Between Perceived Early Parental Love and Adult Happiness}, + JOURNALTITLE = {E-Journal of Applied Psychology}, + VOLUME = {2}, + NUMBER = {2}, + PAGES = {38--48}, + DATE = {2006}, + URL = {http://ojs.lib.swin.edu.au/index.php/ejap} +} + +@ARTICLE{7.01:3b, + AUTHOR = {M. A. Light and I. H. Light}, + TITLE = {The Geographic Expansion of {M}exican Immigration in the {U}nited {S}tates and its Implications for Local Law Enforcement}, + DATE = {2008}, + JOURNALTITLE = {Law Enforcement Executive Forum Journal}, + VOLUME = {8}, + NUMBER = {1}, + PAGES = {73--82}, +} + +% (APA 7.01 Example 4) +@ARTICLE{7.01:4, + AUTHOR = {P. Guimard and A. Florin}, + ORIGTITLE = {Les évaluations des enseignants en grande section de maternelle sont-elles prédictives des difficultés de lecture au cours préparatoire?}, + TITLE = {Are Teacher Ratings in Kindergarten Predictive of Reading Difficulties in First Grade?}, + JOURNALTITLE = {Approche Neuropsychologique des Apprentissages chez l'Enfant}, + VOLUME = {19}, + PAGES = {5--17}, + DATE = {2007}, +} + +% (APA 7.01 Example 5) +% PUBSTATE field is reserved for biblatex defined keys so use NOTE for such non-standard +% things +@ARTICLE{7.01:5, + AUTHOR = {S. C. {Von Ledebur}}, + TITLE = {Optimizing Knowledge Transfer by New Employees in Companies}, + JOURNALTITLE = {Knowledge Management Research \& Practice}, + DATE = {2007}, + NOTE = {Advance online publication}, + DOI = {10.1057/palgrave.kmrp.8500141} +} + +% (APA 7.01 Example 6) +@ARTICLE{7.01:6, + AUTHOR = {R. Briscoe}, + PUBSTATE = {inpress}, + TITLE = {Egocentric Spatial Representation in Action and Perception}, + JOURNALTITLE = {Philosophy and Phenomenological Research}, + URL = {http://cogprints.org/5780/1/ECSRAP.F07.pdf} +} + +% (APA 7.01 Example 7) +% Note the use of "nonacademic" ENTRYSUBTYPE. This is a "Magazine Article" +% and has different date format requirements +@ARTICLE{7.01:7, + ENTRYSUBTYPE = {nonacademic}, + AUTHOR = {J. Chamberlin and A. Novotney and E. Packard and M. Price}, + TITLE = {Enhancing Worker Well-being}, + SUBTITLE = {Occupational Health Psychologists Convene to Share Their Research on Work, Stress, and Health}, + JOURNALTITLE = {Monitor on Psychology}, + VOLUME = {39}, + NUMBER = {5}, + PAGES = {26-29}, + DATE = {2008-05} +} + +% (APA 7.01 Example 8) +% Note the use of "nonacademic" ENTRYSUBTYPE. This is a "Online Magazine Article" +% and has different date format requirements +@ARTICLE{7.01:8, + ENTRYSUBTYPE = {nonacademic}, + AUTHOR = {Richard Clay}, + TITLE = {Science vs. Ideology}, + SUBTITLE = {Psychologists Fight Back About the Misuse of Research}, + JOURNALTITLE = {Monitor on Psychology}, + VOLUME = {39}, + NUMBER = {6}, + DATE = {2008-06}, + URL = {http://www.apa.org/monitor/} +} + +% (APA 7.01 Example 9) +% The date format in the formatted APA example is inconsistent with all other date +% range examples which have a '-' separating the range. We use '-' here too. +% Note the use of "nonacademic" ENTRYSUBTYPE. This is a "Newsletter Article" +% and has different date format requirements +@ARTICLE{7.01:9, + ENTRYSUBTYPE = {nonacademic}, + TITLE = {Six Sites Meet for Comprehensive Anti-gang Initiative Conference}, + SHORTTITLE = {Six Sites Meet}, + JOURNALTITLE = {OJJDP News {@} a Glance}, + DATE = {2006-11/2006-12}, + URL = {http://www.ncjrs.gov/html/ojjdp/news_at_glance/216684/topstory.html} +} + +% (APA 7.01 Example 10) +% Use entrytype "NEWSARTICLE" for newspaper articles so that the pages specification +% is formatted correctly (needs "p/pp" whereas normal articles don't) +% Use the "NEWSPAPER" field for the title of the paper, otherwise this entrytype +% is similar to ARTICLE +% Numeral format is redefined to allow page number starting in letters +% Discontinuous pages are ok +@NEWSARTICLE{7.01:10, + AUTHOR = {J. Schwartz}, + TITLE = {Obesity Affects Economic, Social Status}, + NEWSPAPER = {The Washington Post}, + PAGES = {A1, A4}, + DATE = {1993-09-30}, +} + +% (APA 7.01 Example 11) +@NEWSARTICLE{7.01:11, + AUTHOR = {J. E. Brody}, + TITLE = {Mental Reserves Keep Brain Agile}, + NEWSPAPER = {The New York Times}, + DATE = {2007-12-11}, + URL = {http://www.nytimes.com} +} + +% (APA 7.01 Example 12) +@PERIODICAL{7.01:12a, + EDITOR = {C. Haney and R. L. Wiener}, + TITLE = {Capital Punishment in the {United States}}, + ISSUETITLE = {Special issue}, + JOURNALTITLE = {Psychology, Public Policy, and Law}, + VOLUME = {10}, + NUMBER = {4}, + DATE = {2004} +} + +@PERIODICAL{7.01:12b, + EDITOR = {P. Greenfield and Z. Yan}, + TITLE = {Children, Adolescents, and the {I}nternet}, + ISSUETITLE = {Special section}, + JOURNALTITLE = {Developmental Psychology}, + VOLUME = {42}, + PAGES = {391--458}, + DATE = {2006} +} + +% APA manual implicit example made explicit - no editors +@PERIODICAL{7.01:12c, + TITLE = {Capital Punishment in the {United Kingdom}}, + SHORTTITLE = {Capital Punishment}, + ISSUETITLE = {Special issue}, + JOURNALTITLE = {Psychology, Public Policy, and Law}, + VOLUME = {10}, + NUMBER = {4}, + DATE = {2004} +} + +% (APA 7.01 Example 13) +% Monographs can be specified as articles with appropriate NUMBER fields +@ARTICLE{7.01:13a, + AUTHOR = {D. C. Ganster and J. Schaubroeck and W. E. Sime and B. T. Mayes}, + TITLE = {The Nomological Validity of the {T}ype {A} Personality Among Employed Adults}, + TITLEADDON = {Monograph}, + JOURNALTITLE = {Journal of Applied Psychology}, + VOLUME = {76}, + PAGES = {143--168}, + DATE = {1991}, + DOI = {10.1037/0021-9010.76.1.143} +} + +% Implicit example made explicit (Given in APA 5th Ed. Manual) +@ARTICLE{7.01:13b, + AUTHOR = {P. L. Harris and R. D. Kavanaugh}, + TITLE = {Young Children's Understanding of Pretense}, + JOURNALTITLE = {Monographs of the Society for Research in Child Development}, + VOLUME = {58}, + NUMBER = {1, Serial No. 231}, + DATE = {1993} +} + +% Implicit example made explicit (Given in APA 5th Ed. Manual) +@ARTICLE{7.01:13c, + AUTHOR = {W. F. Battig and W. E. Montague}, + TITLE = {Category Norms for Verbal Items in 56 Categories}, + SUBTITLE = {A Replication and Extension of the {C}onnecticut Category Norms}, + JOURNALTITLE = {Journal of Experimental Psychology Monographs}, + VOLUME = {80}, + NUMBER = {3, Pt. 2}, + DATE = {1969} +} + +% (APA 7.01 Example 14) +@ARTICLE{7.01:14, + TITLE = {Editorial: ``{W}hat a Disaster'' and Why Does This Question Matter?}, + TITLEADDON = {Editorial}, + JOURNALTITLE = {Journal of Contingencies and Crisis Management}, + VOLUME = {14}, + PAGES = {1--2}, + DATE = {2006} +} + +% (APA 7.01 Example 15) +% Note use of font change +@ARTICLE{7.01:15, + AUTHOR = {S. Marshall-Pescini and A. Whiten}, + TITLE = {Social Learning of Nut-Cracking Behaviour in {E}ast {A}frican Sanctuary-living Chimpanzees (\textsl{Pan troglodytes schweinfurthii})}, + TITLEADDON = {Supplemental material}, + JOURNALTITLE = {Journal of Comparitive Psychology}, + VOLUME = {122}, + PAGES = {186--194}, + DATE = {2008}, + DOI = {10.1037/0735-7036.122.2.186.supp} +} + +% (APA 7.01 Example 16) +@ARTICLE{7.01:16a, + AUTHOR = {N. J. Woolf and S. L. Young and M. S. Fanselow and L. L. Butcher}, + TITLE = {{MAP-2} Expression in Cholinoceptive Pyramidal Cells of Rodent Cortex and Hippocampus is Altered by {P}avlovian Conditioning}, + TITLEADDON = {Abstract}, + JOURNALTITLE = {Society for Neuroscience Abstracts}, + VOLUME = {17}, + PAGES = {480}, + DATE = {1991} +} + +% Note use of ABSTRACTURL field value to specify that the URL is for the abstract +% and so the entry gets "Abstract retrieved from" instead of just "retrieved from" +@ARTICLE{7.01:16b, + AUTHOR = {S. R. Lassen and M. M. Steele and W. Sailor}, + TITLE = {The Relationship of School-wide Positive Behavour Support to Academic Achievement in an Urban Middle School}, + JOURNALTITLE = {Psychology in the Schools}, + VOLUME = {43}, + PAGES = {701--712}, + DATE = {2006}, + ABSTRACTURL = {http://www.interscience.wiley.com} +} + +% (APA 7.01 Example 17) +% Such unstructured abstract information uses the ABSTRACTLOC field +% If the abstract/article was retreived from a standard online URI, things are little +% better defined - see examples 7.01:16*). +@ARTICLE{7.01:17, + AUTHOR = {L. R. Hare and K. O'Neill}, + TITLE = {Effectiveness and Efficiency in Small Academic Peer Groups}, + JOURNALTITLE = {Small Group Research}, + VOLUME = {31}, + PAGES = {24--53}, + DATE = {2000}, + ABSTRACTLOC = {{S}ociological {A}bstracts database. (Accession No. 200010185)} +} + +% (APA 7.02 Example 18) +@BOOK{7.02:18, + AUTHOR = {M. A. Shotton}, + TITLE = {Computer Addiction? {A} Study of Computer Dependency}, + LOCATION = {London, England}, + PUBLISHER = {Taylor \& Francis}, + DATE = {1989} +} + +% (APA 7.02 Example 19) +% Note the different year to the actual example to stop bibaltex generating extrayear +% since the APA examples pretend each example is effectively an entry from a +% different bibliography +@BOOK{7.02:19a, + AUTHOR = {M. A. Shotton}, + TITLE = {Computer Addiction? A Study of Computer Dependency}, + TITLEADDON = {{DX} {R}eader version}, + DATE = {1990}, + URL = {http://www.ebbokstore.tandf.co.uk/html/index.asp} +} + +@BOOK{7.02:19b, + AUTHOR = {G. R. Schiraldi}, + TITLE = {The Post-traumatic Stress Disorder Sourcebook}, + SUBTITLE = {A Guide to Healing, Recovery, and Growth}, + TITLEADDON = {{A}dobe {D}igital {E}ditions version}, + DATE = {2001}, + DOI = {10.1036/0071393722} +} + +% (APA 7.02 Example 20) +@BOOK{7.02:20, + AUTHOR = {E. O'Keefe}, + TITLE = {Egoism \& the Crisis in {W}estern Values}, + URL = {http://www.onlineoriginals.com/showitem.asp?itemID=135} +} + +% (APA 7.02 Example 21) +% NOTE is automatically generated from ORIGDATE +@INBOOK{7.02:21, + AUTHOR = {S. Freud}, + EDITOR = {J. Strachey}, + TRANSLATOR = {J. Strachey}, + TITLE = {The Method of Interpreting Dreams}, + BOOKTITLE = {The Standard Edition of the Complete Psychological Works of {S}igmund {F}reud}, + VOLUME = {4}, + PAGES = {96--121}, + SUBTITLE = {An Analysis of a Specimen Dream}, + DATE = {1953}, + ORIGDATE = {1900}, + URL = {http://books.google.com/books}, +} + +% (APA 7.02 Example 22) +@BOOK{7.02:22, + EDITOR = {N. Thomas}, + TITLE = {Perspectives on the Community College}, + SUBTITLE = {A Journey of Discovery}, + TITLEADDON = {Monograph}, + DATE = {2002}, + URL = {http://eric.ed.gov/} +} + +% (APA 7.02 Example 23) +@BOOK{7.02:23, + EDITOR = {S. Koch}, + TITLE = {Psychology}, + SUBTITLE = {A Study of Science}, + VOLUMES = {1--6}, + LOCATION = {New York, NY}, + PUBLISHER = {McGraw-Hill}, + DATE = {1959/1963} +} + +% (APA 7.02 Example 24) +@INBOOK{7.02:24, + AUTHOR = {Strong, Jr., E. K. and R. S. Uhrbrock}, + EDITORA = {L. Outhwaite}, + EDITORATYPE = {series}, + TITLE = {Bibliography in Job Analysis}, + BOOKTITLE = {Personnel {R}esearch {S}eries}, + BOOKSUBTITLE = {Vol. 1. {J}ob Analysis and the Curriculum}, + PAGES = {140--146}, + DATE = {1923}, + DOI = {10.1037/10762-000} +} + +% (APA 7.02 Example 25) +@INBOOK{7.02:25, + AUTHOR = {D. M. Haybron}, + EDITOR = {M. Eid and R. J. Larsen}, + TITLE = {Philosophy and the Science of Subjective Well-Being}, + BOOKTITLE = {The Science of Subjective Well-Being}, + LOCATION = {New York, NY}, + PUBLISHER = {Guildford Press}, + PAGES = {17-43}, + DATE = {2008}, +} + +% (APA 7.02 Example 26) +@INBOOK{7.02:26, + AUTHOR = {J. Piaget}, + EDITOR = {K. Richardson and S. Sheldon}, + TRANSLATOR = {G. Gellerier and J. Langer}, + TITLE = {Extracts From {P}iaget's Theory}, + BOOKTITLE = {Cognitive Development to Adolescence}, + BOOKSUBTITLE = {A Reader}, + PAGES = {3--18}, + LOCATION = {Hillsdale, NJ}, + PUBLISHER = {Erlbaum}, + DATE = {1988}, + RELATED = {mcppiaget}, + RELATEDTYPE = {reprintfrom} +} + +@INCOLLECTION{mcppiaget, + EDITOR = {P. H. Mussen}, + TITLE = {Manual of Child Psychology}, + DATE = {1970}, + LOCATION = {New York, NY}, + PUBLISHER = {Wiley}, + PAGES = {703--732} +} + +% (APA 7.02 Example 27) +@BOOK{7.02:27, + EDITOR = {G. R. VandenBos}, + TITLE = {{APA} Dictionary of Psychology}, + LOCATION = {Washington, DC}, + PUBLISHER = {American Psychological Association}, + DATE = {2007}, +} + +% (APA 7.02 Example 28) +@BOOK{7.02:28, + AUTHOR = {{Real Academia Española}}, + ORIGTITLE = {Diccionario de la lengua española}, + TITLE = {Dictionary of the {S}panish Language}, + EDITION = {22}, + LOCATION = {Madrid, Spain}, + PUBLISHER = {Author}, + DATE = {2001}, +} + +% (APA 7.02 Example 29) +% If the EDITION field is not just an edition number like "2" or "4" (which +% will be turned into an ordinal like "2nd" or "4th" by the style automatically), +% then make the EDITION field the exact string you need. +@INBOOK{7.02:29, + AUTHOR = {G. Graham}, + EDITOR = {E. N. Zalta}, + TITLE = {Behaviourism}, + BOOKTITLE = {The {S}tanford Encyclopedia of Philosophy}, + EDITION = {Fall 2007 ed.}, + DATE = {2005}, + URL = {http://plato.stanford.edu/entries/behaviourism/} +} + +% (APA 7.02 Example 30) +@INBOOK{7.02:30, + TITLE = {Heuristic}, + BOOKTITLE = {{M}erriam-{W}ebster's Online Dictionary}, + EDITION = {11}, + URL = {http://www.m-w.com/dicitonary/heuristic} +} + +% (APA 7.03 Example 31) +% NUMBER contains report number, "No." is added automatically and TYPE contains the +% report type +@REPORT{7.03:31, + AUTHOR = {{U.S. Department of Health and Human Services, National Institutes of Health, National Heart, Lung and Blood Institute}}, + TITLE = {Managing Asthma}, + SUBTITLE = {A Guide for Schools}, + TYPE = {NIH Publication}, + NUMBER = {02-2650}, + DATE = {2003}, + URL = {http://www.nhlbi.nih.gov/health/prof/lung/asthma/asth_sch.pdf} +} + +% (APA 7.03 Example 32) +@REPORT{7.03:32, + AUTHOR = {{American Psychological Association, Task Force on the Sexualization of Girls}}, + TITLE = {Report of the {APA} {T}ask {F}orce on the {S}exualization of {G}irls}, + DATE = {2007}, + URL = {http://www.apa.org/pi/wpo/sexualization.html} +} + +% (APA 7.03 Example 33) +% Use URLDESCRIPTION to introduce website address; defaults to just "Retreived from" +% if not present +@REPORT{7.03:33, + AUTHOR = {S. S. A. Kessy and F. M. Urio}, + TITLE = {The Contribution of Microfinance Institutions to Poverty Reduction in {T}anzania}, + TYPE = {Research Report}, + NUMBER = {06.3}, + DATE = {2006}, + URLDESCRIPTION = {Research on Poverty Alleviation website}, + URL = {http://www.repoa.or.tz/documents_storage/Publications/Reports/06.3_Kessey_and_Urio.pdf} +} + +% (APA 7.03 Example 34) +% This example is an anomaly as it doesnt' have "No." before the report number. +% This style does this consistently for all reports with numbers +@REPORT{7.03:34, + AUTHOR = {J. E. McDaniel and C. G. Miskel}, + TITLE = {The Effect of Groups and Individuals on National Decisionmaking}, + SUBTITLE = {Influence and Domination in the Reading Policymaking Environment}, + TYPE = {CIERA Report}, + NUMBER = {3-025}, + DATE = {2002}, + URLDESCRIPTION = {University of Michigan, Center for Improvement of Early Reading Achievement website}, + URL = {http://www.ciera.org/library/reports/inquiry-3/3-025/3-025.pdf} +} + +% (APA 7.03 Example 35) +@TECHREPORT{7.03:35, + AUTHOR = {{Employee Benefit Research Institute}}, + TITLE = {Sources of health Insurance and Characteristics of the Uninsured}, + TYPE = {Issue Brief}, + NUMBER = {123}, + DATE = {1992-02}, + LOCATION = {Washington, DC}, + PUBLISHER = {Author} +} + +% (APA 7.04 Example 36) +@INPROCEEDINGS{7.04:36, + AUTHOR = {J. Muellbauer}, + TITLE = {Housing, Credit and Consumer Expenditure}, + EDITORA = {S. C. Ludvigson}, + EDITORATYPE = {chair}, + BOOKTITLE = {Housing and Consumer Behaviour}, + EVENTTITLE = {Symposium Conducted at the Meeting of the {F}ederal {R}eserve {B}ank of {K}ansas {C}ity}, + LOCATION = {Jackson Hole, WY}, + DATE = {2007-09} +} + +% (APA 7.04 Example 37) +% Unpublished conference papers are UNPUBLISHED type +@UNPUBLISHED{7.04:37, + AUTHOR = {S. Liu}, + TITLE = {Defending Against Business Crises with the Help of Inteligent Agent Based Early Warning Solutions}, + DATE = {2005-05}, + LOCATION = {Miami, FL}, + NOTE = {Paper presented at the Seventh International Conferene on Enterprise Information Systems}, + ABSTRACTURL = {http://www.iceis.org/iceis2005/abstracts_2005.htm} +} + +% (APA 7.04 Example 38) +@PROCEEDINGS{7.04:38, + AUTHOR = {S. Herculano-Houzel and C. E. Collins and P. Wong and J. H. Kaas and R. Lent}, + TITLE = {The Basic Nonuniformity of the Cerebral Cortex}, + BOOKTITLE = {Proceedings of the {N}ational {A}cademy of {S}ciences, {USA}}, + VOLUME = {105}, + PAGES = {12593--12598}, + DATE = {2008}, + DOI = {10.1073/pnas.0805417105} +} + +% (APA 7.04 Example 39) +% Note that there is a LOCATION and PUBLISHER but these are ignored because +% there is a DOI. This is inconsistent in the 2nd printing of 6th Edition +% but is clear from the example formats at the beginning of 7.02 +@INPROCEEDINGS{7.04:39, + AUTHOR = {I. Katz and K. Gabayan and H. Aghajan}, + TITLE = {A Multi-touch Surface Using Multiple Cameras}, + EDITOR = {J. Blanc-Talon and W. Philips and D. Popescu and P. Scheunders}, + MAINTITLE = {Lecture {N}otes in {C}omputer {S}cience}, + VOLUME = {4678}, + BOOKTITLE = {Advanced {C}oncepts for {I}ntelligent {V}ision {S}ystems}, + PAGES = {97--108}, + LOCATION = {Berlin, Germany}, + PUBLISHER = {Springer-Verlag}, + DATE = {2007}, + DOI = {10.1007/978-3-540-74607-2_9} +} + +% (APA 7.05 Example 40) +% The PHDTHESIS and MASTERSTHESIS are the same as THESIS but they supply a default +% TYPE field automatically +@MASTERSTHESIS{7.05:40, + AUTHOR = {D. S. McNiel}, + TITLE = {Meaning Through Narrative}, + SUBTITLE = {A Personal Narrative Discussing Growing Up with an Alchoholic Mother}, + DATE = {2006}, + NOTE = {Available from ProQuest Dissertations and Theses database}, + ADDENDUM = {UMI No. 1434728} +} + +% (APA 7.05 Example 41) +@PHDTHESIS{7.05:41, + AUTHOR = {R. J. Adams}, + TITLE = {Building a Foundation for Evaluation of Instruction in Higher Education and Continuing Education}, + DATE = {1973}, + URL = {http://www.ohiolink.edu/etd/} +} + +% (APA 7.05 Example 42) +@PHDTHESIS{7.05:42, + AUTHOR = {A. Bruckman}, + TITLE = {{MOOSE Crossing}}, + SUBTITLE = {Construction, Community, and Learning in a Networked Virtual World for Kids}, + INSTITUTION = {Massachusetts Institute of Technology}, + DATE = {1977}, + URL = {http://www-static.cc.gatech.edu/~asb/thesis/} +} + +% (APA 7.05 Example 43) +% This example formats naturally as an article as it has VOLUME, NUMBER etc. +@ARTICLE{7.05:43, + AUTHOR = {L. G. Appelbaum}, + JOURNALTITLE = {Dissertation Abstracts International: Section B. Sciences and Engineering}, + TITLE = {Three Studies of Human Information Processing}, + SUBTITLE = {Texture Amplification, Motion Representation, and Figure-Ground Segregation}, + VOLUME = {65}, + NUMBER = {10}, + DATE = {2005}, + PAGES = {5428} +} + +% (APA 7.05 Example 44) +% Note we're overriding TYPE here which is usually automatically set for PHDTHESIS since, +% for some reason, this entry has "Doctoral thesis" instead of the usual "Doctoral +% dissertation" +@PHDTHESIS{7.05:44, + AUTHOR = {P. Carlbom}, + TITLE = {Carbody and Passengers in Rail Vehicle Dynamics}, + TYPE = {Doctoral thesis}, + INSTITUTION = {Royal Institute of Technology, Stockholm}, + LOCATION = {Sweden}, + DATE = {2000}, + URL = {http://urn.kb.se/resolve?urn=urn:nbn:se:kth:diva-3029} +} + +% (APA 7.06 Example 45) +% Note how this is handled by the biblatex/biber "related entries" functionality +% We have included the year in the reviewed item for consistency, as per 7.06:46 +% The comma after the reviewed title is ommited for consistency, as per 7.06:48 +@REVIEW{7.06:45, + AUTHOR = {B. R. Schatz}, + TITLE = {Learning By Text or Context?}, + REVIEWTEXT = {the book}, + RELATED = {brdu}, + RELATEDTYPE = {reviewof}, + RELATEDSTRING = {Review of the book}, + JOURNALTITLE = {Science}, + VOLUME = {290}, + PAGES = {1304}, + DATE = {2000-11-17}, + DOI = {10.1126/science.290.5495.1304}, +} + +@BOOK{brdu, + AUTHOR = {John Seely Brown and Paul Duguid}, + TITLE = {The Social Life of Information}, + DATE = {2000}, + PUBLISHER = {Harvard Business School Press} +} + +% (APA 7.06 Example 46) +% Note that this example drops the "produced" in the reviewed item. It's not worth +% automating this sort of verb as "by" is perfectly acceptable. +@REVIEW{7.06:46, + AUTHOR = {A. Axelman and J. L. Shapiro}, + TITLE = {Does the Solution Warrant the Problem?}, + RELATED = {apavid}, + RELATEDTYPE = {reviewof}, + RELATEDSTRING = {Review of the {DVD}}, + JOURNALTITLE = {PsycCRITIQUES}, + VOLUME = {52}, + NUMBER = {51}, + DATE = {2007}, + DOI = {10.1037/a0009036} +} + +@VIDEO{apavid, + PRODUCER = {{the American Psychological Association}}, + TITLE = {Brief Therapy With Adolescents}, + DATE = {2007} +} + +% (APA 7.06 Example 47) +% Again we drop the "produced" as with Example 46 +@REVIEW{7.06:47, + RELATED = {bioshock}, + RELATEDTYPE = {reviewof}, + RELATEDSTRING = {Review of the video game}, + URL = {http://www.whattheyplay.com/products/bioshock-for-xbox-360/?fm=3&ob=1&t=0#166}, +} + +@SOFTWARE{bioshock, + AUTHOR = {{2K Games}}, + ENTRYSUBTYPE = {Computer Game}, + TITLE = {Bio{S}hock}, + DATE = {2007} +} + +% (APA 7.06 Example 48) +@REVIEW{7.06:48, + AUTHOR = {K. S. Wolf}, + TITLE = {The Future for {D}eaf Individuals is Not That Bleak}, + RELATED = {deaf}, + RELATEDTYPE = {reviewof}, + RELATEDSTRING = {Peer commentary on the paper}, + DATE = {2005}, + URL = {http://www.personalityresearch.org/papers/hal.htm#wolf} +} + +@ARTICLE{deaf, + AUTHOR = {K. S. Wolf}, + TITLE = {``{D}ecrease of {D}eaf potential in a mainstreamed environment''}, + JOURNALTITLE = {Some Journal}, + VOLUME = {2}, + NUMBER = {1}, + PAGES = {1--10}, + DATE = {2003}, +} + +% (APA 7.07 Example 49) +% The "Available from" string is conditionalised by testing for "{DVD}" as +% the ENTRYSUBTYPE. A bit hacky but an edge case anyway. +% 3nd printing is incorrect as it has a period before the "(Producer)" +@VIDEO{7.07:49, + ENTRYSUBTYPE = {{DVD}}, + PRODUCER = {{American Psychological Association}}, + TITLE = {Responding Therapeutically to Patient Expressions of Sexual Attraction}, + DATE = {2000}, + URL = {http://www.apa.org/videos/} +} + +% (APA 7.07 Example 50) +@AUDIO{7.07:50, + ENTRYSUBTYPE = {Audio podcast}, + PRODUCER = {D. {Van Nuys}}, + TITLE = {Shrink Rap Radio}, + DATE = {2007-12-19}, + URL = {http://www.shrinkrapradio.com/} +} + +% (APA 7.07 Example 51) +@VIDEO{7.07:51, + ENTRYSUBTYPE = {Television series episode}, + WRITER = {D. Egan}, + DIRECTOR = {J. Alexander}, + EXECPRODUCER = {D. Shore}, + TITLE = {Failure to Communicate}, + MAINTITLE = {House}, + LOCATION = {New York, NY}, + PUBLISHER = {Fox Broadcasting}, + DATE = {2005}, +} + +% (APA 7.07 Example 52) +% Note use of SORTKEY to make sorting ignore the lower case AUTHOR +@MUSIC{7.07:52, + SORTKEY = {Lang, K. D.}, + ENTRYSUBTYPE = {{CD}}, + AUTHOR = {{lang}, {k} {d}}, + TITLE = {Shadow and the Frame}, + MAINTITLE = {Watershed}, + MAINTITLEADDON = {{CD}}, + LOCATION = {New York, NY}, + PUBLISHER = {Nonesuch Records}, + DATE = {2008}, +} + +% (APA 7.07 Example 53) +@MISC{7.07:53, + AUTHOR = {{Lewis County Geographic Information Services}}, + NAMEADDON = {Cartographer}, + TITLE = {Population Density, 2000 {U}.{S}. {C}ensus}, + ENTRYSUBTYPE = {Demographic map}, + DATE = {2002}, + URL = {http://www.co.lewis.wa.us/publicworks/maps/Demographics/census-pop-dens_2000.pdf} +} + +% (APA 7.08 Example 54) +@DATA{7.08:54, + ENTRYSUBTYPE = {Data file and code book}, + AUTHOR = {{Pew Hispanic Center}}, + TITLE = {Changing Channels and Crisscrossing Cultures}, + SUBTITLE = {A Survey of {L}atinos on the News Media}, + DATE = {2004}, + URL = {http://pewhispanic.org/datasets/} +} + +% (APA 7.08 Example 55) +@MISC{7.08:55, + AUTHOR = {M. L. Friedlander and V. Escudero and L. Heatherington}, + TITLE = {{E-SOFTA}}, + SUBTITLE = {System for Observing Family Therapy Alliances}, + ENTRYSUBTYPE = {Software and training videos}, + DATE = {2002}, + NOTE = {Unpublished instrument}, + URL = {http://www.softa-soatif.com/} +} + +% (APA 7.08 Example 56) +@SOFTWARE{7.08:56, + TITLE = {Comprehensive {M}eta-{A}nalysis}, + TITLEADDON = {Computer software}, + VERSION = {2}, + LOCATION = {Englewood, NJ}, + PUBLISHER = {Biostat} +} + +% (APA 7.08 Example 57) +@MISC{7.08:57, + TITLE = {{Eyelink II}}, + ENTRYSUBTYPE = {Apparatus and software}, + LOCATION = {Mississauga, Ontario, Canada}, + PUBLISHER = {SR Research}, + DATE = {2004}, +} + +% (APA 7.09 Example 58) +@UNPUBLISHED{7.09:58, + AUTHOR = {E. Blackwell and P. J. Conrod}, + TITLE = {A Five-Dimensional Measure of Drinking Motives}, + HOWPUBLISHED = {Unpublished manuscript}, + INSTITUTION = {Department of Psychology, University of British Columbia}, + LOCATION = {Vancouver, Canada}, + DATE = {2003}, +} + +% (APA 7.09 Example 59) +@UNPUBLISHED{7.09:59, + AUTHOR = {J. Y. Ting and P. Florsheim and W. Huang}, + TITLE = {Mental Health Help-Seeking in Ethnic Minority Populations}, + SUBTITLE = {A Theoretical Perspective}, + HOWPUBLISHED = {Manuscript submitted for publication}, + DATE = {2008}, +} + +% (APA 7.09 Example 60) +@DATA{7.09:60, + AUTHOR = {F. Bordi and J. E. LeDoux}, + ENTRYSUBTYPE = {Auditory response latencies in rat auditory cortex}, + NOTE = {Unpublished raw data}, + DATE = {1993}, +} + +% (APA 7.09 Example 61) +@UNPUBLISHED{7.09:61a, + AUTHOR = {S. D. Mitchell}, + TITLE = {The Import of Uncertainty}, + DATE = {2000}, + URL = {http://philsci-archive.pitt.edu/archive/00000162/} +} + +@ARTICLE{7.09:61b, + AUTHOR = {S. D. Mitchell}, + TITLE = {The Import of Uncertainty}, + JOURNALTITLE = {The Pluralist}, + VOLUME = {2}, + NUMBER = {1}, + PAGES = {58--71}, + DATE = {2007}, +} + +% (APA 7.09 Example 62) +% "eric" is defined as a recognised eprint type in the style and will be formatted as a +% localised version of "Retrieved from ERIC database ()" +@UNPUBLISHED{7.09:62, + AUTHOR = {K. Kubota}, + TITLE = {``{S}oaking'' Model for Learning}, + SUBTITLE = {Analyzing {J}apanese Learning/Teaching Process from a Socio-Historical Perspective}, + DATE = {2007}, + EPRINTTYPE = {eric}, + EPRINT = {ED498566} +} + +% (APA 7.10 Example 63) +@LETTER{7.10:63, + AUTHOR = {L. K. Frank}, + TITLE = {Letter to {R}obert {M}. {O}gden}, + INSTITUTION = {Rockerfeller Archive Center}, + NUMBER = {GEB series 1.3, Box 371, Folder 3877}, + LOCATION = {Tarrytown, NY}, + DATE = {1935-02-04}, +} + +% (APA 7.10 Example 64) +@LETTER{7.10:64, + AUTHOR = {G. P. Zacharius}, + TITLE = {Letter to {W}illiam {R}ickel ({W}. {R}ickel, {T}rans.)}, + DATE = {1953-08-15}, + NOTE = {Copy in possession of Hendrika Vande Kemp} +} + +% (APA 7.10 Example 65) +% Entrytype is "LETTERS" (plural) for a collection of letters +@LETTERS{7.10:65, + AUTHOR = {G. W. Allport}, + TITLE = {Correspondence}, + DATE = {1930/1967}, + INSTITUTION = {Gordon W. Allport Papers}, + NUMBER = {HUG 4118.10}, + LOCATION = {{Harvard University Archives, Cambridge}, MA}, +} + +% (APA 7.10 Example 66) +@UNPUBLISHED{7.10:66, + AUTHOR = {A. Berliner}, + TITLE = {Notes for a Lecture on Reminiscences of {W}undt and {L}epizig}, + DATE = {1959}, + HOWPUBLISHED = {Anna Berliner Memoirs (Box M50)}, + LOCATION = {{Archives of the History of American Psychology, University of Akron, Akron}, OH} +} + +% (APA 7.10 Example 67) +% biblatex 3.4+ supports data annotations which can be use to deal with uncertain authors +% biblatex 3.5+ supports uncertainty marker for dates +@UNPUBLISHED{7.10:67, + AUTHOR = {A. Allport}, + AUTHOR+an = {=uncertain}, + TITLE = {Marion {T}aylor Today---By the Biographer}, + DATE = {1937~}, + HOWPUBLISHED = {Unpublished manuscript, Marion Taylor Papers}, + LOCATION = {{Schlesinger Library, Radcliffe College, Cambridge}, MA} +} + +% (APA 7.10 Example 68) +@MISC{7.10:68, + AUTHOR = {{Subcommitee on Mental Hygiene Personnel in School Programs}}, + TITLE = {{Meeting of Subcommittee on Mental Hygiene Personnel in School Programs}}, + HOWPUBLISHED = {David Shakow Papers (M1360)}, + INSTITUTION = {Archives of the History of American Psychology}, + LOCATION = {University of Akron, Akron, OH}, + DATE = {1949-11-05/1949-11-06} +} + +% (APA 7.10 Example 69) +@MISC{7.10:69, + AUTHOR = {M. B. Smith}, + TITLE = {Interview by {C}. {A}. {K}iesler}, + ENTRYSUBTYPE = {Tape recording}, + HOWPUBLISHED = {President's Oral History Project, American Psychological Association}, + LOCATION = {APA Archives, Washington, DC}, + DATE = {1989-08-12}, +} + +% (APA 7.10 Example 70) +% Note that this example is inconsistent in the APA 6th Edition (2nd printing) manual +% with example 7.10:69. They differ in that 7.10:69 has a period before the location +% and 7.10:70 has a comma. I have chosen a period for consistency. +@UNPUBLISHED{7.10:70, + AUTHOR = {C. F. Sparkman}, + TITLE = {An Oral History with {D}r. {C}olley {F}. {S}parkman/{I}nterviewer: {O}rley {B}. {C}audill}, + HOWPUBLISHED = {Mississippi Oral History Program (Vol. 289)}, + INSTITUTION = {University of Southern Mississippi}, + LOCATION = {Hattiesburg}, + DATE = {1973} +} + +% (APA 7.10 Example 71) +% If no normal paper citation, use ENTRYSUBTYPE to say what this NEWSARTICLE is +@NEWSARTICLE{7.10:71, + TITLE = {Psychoanalysis Institute to Open}, + DATE = {1948-09-18}, + ENTRYSUBTYPE = {Clipping from an unidentified Dayton, OH newspaper}, + NOTE = {Copy in possession of author} +} + +% (APA 7.10 Example 72) +@UNPUBLISHED{7.10:72, + AUTHOR = {{Sci-Art Publishers}}, + TITLE = {Sci-{A}rt {P}ublications}, + TITLEADDON = {Brochure}, + HOWPUBLISHED = {Cambridge, MA: Author. A. A. Roback Papers (HUGFP 104.50, Box 2, Folder ``Miscellaneous Psychological Materials'')}, + LOCATION = {Harvard University Archives, Cambridge, MA}, + DATE = {1935} +} + +% (APA 7.10 Example 73) +% biblatex 3.5+ supports ISO8601 circa markers in dates +% Note that this example is inconsistent in the APA 6th Edition (2nd printing) manual +% with example 7.10:67. They differ in that 7.10:67 has brackets around the approximate +% date and 7.10:73 has parenthesis. I have chosen brackets for consistency. +% Use TITLEISDESCRIPTION to indicate a title that is really a description and not a real +% title +@MISC{7.10:73, + TITLEISDESCRIPTION = {true}, + TITLE = {{Photographs of Robert M. Yerkes}}, + DATE = {1917~/1954}, + HOWPUBLISHED = {Robert Mearns Yerkes Papers (Box 137, Folder 2292)}, + LOCATION = {{Manuscripts and Archives, Yale University Library, New Haven}, CT} +} + +% (APA 7.11 Example 74) +@ONLINE{7.11:74, + ENTRYSUBTYPE = {Online forum comment}, + AUTHOR = {T. Rampersad}, + TITLE = {Re: {T}raditional Knowledge and Traditional Cultural Expressions}, + DATE = {2005-06-08}, + URL = {http://www.wipo.int/roller/comments/ipisforum/Weblog/theme_eight_how_can_cultural#comments}, +} + +% (APA 7.11 Example 75) +@ONLINE{7.11:75, + ENTRYSUBTYPE = {Electronic mailing list message}, + AUTHOR = {S. Smith}, + TITLE = {Re: Disputed Estimates of {IQ}}, + DATE = {2006-01-05}, + URL = {http://tech.groups.yahoo.com/group/ForensicNetwork/message/670}, +} + +% (APA 7.11 Example 76) +@ONLINE{7.11:76a, + ENTRYSUBTYPE = {Web log post}, + AUTHOR = {{PZ Myers}}, + TITLE = {The Unfortunate Prerequisites and Consequences of Partitioning Your Mind}, + DATE = {2007-01-22}, + URL = {http://scienceblogs.com/pharyngula/2007/01/the_unfortunate_prerequisites.php}, +} + +@ONLINE{7.11:76b, + ENTRYSUBTYPE = {Web log comment}, + AUTHOR = {MiddleKid}, + TITLE = {Re: {T}he Unfortunate Prerequisites and Consequences of Partitioning Your Mind}, + DATE = {2007-01-22}, + URL = {http://scienceblogs.com/pharyngula/2007/01/the_unfortunate_prerequisites.php}, +} + +% (APA 7.11 Example 77) +@ONLINE{7.11:77, + ENTRYSUBTYPE = {Video file}, + AUTHOR = {R. Norton}, + TITLE = {How to Train a Cat to Operate a Light Switch}, + DATE = {2006-11-04}, + URL = {http://www.youtube.com/watch?v=Vja83KLQXZs}, +} + +% (APA A7.07) +@PATENT{A7.07, + AUTHOR = {I. M. Smith}, + TITLE = {{U}.{S}. {P}atent {N}o. 123,445}, + DATE = {1998}, + LOCATION = {Washington, DC}, + PUBLISHER = {U.S. Patent and Trademark Office} +} + +% APA 6th doesn't have any extended date format examples. +% Also test order of inpress and nodate, see +% http://blog.apastyle.org/apastyle/2013/01/alphabetizing-in-press-and-no-date-references.html +@ONLINE{habitat1, + TITLE = {Mission, Vision \& Values}, + URL = {http://www.tchabitat.org/missionvisionvalues}, + ORGANIZATION = {Twin Cities Habitat for Humanity website}, + URLDATE = {2011-09-15} +} + +@ONLINE{habitat2, + TITLE = {Mission, Vision \& Values}, + DATE = {2011}, + URL = {http://www.tchabitat.org/missionvisionvalues}, + ORGANIZATION = {Twin Cities Habitat for Humanity website}, + URLDATE = {2011-09} +} + +@ONLINE{habitat3, + TITLE = {Mission, Vision \& Values}, + DATE = {2012}, + URL = {http://www.tchabitat.org/missionvisionvalues}, + ORGANIZATION = {Twin Cities Habitat for Humanity website}, + URLDATE = {2012} +} + +@ONLINE{habitat4, + TITLE = {Mission, Vision \& Values}, + PUBSTATE = {inpress}, + URL = {http://www.tchabitat.org/missionvisionvalues}, + ORGANIZATION = {Twin Cities Habitat for Humanity website}, + URLDATE = {2011-09-15} +} + +@INPROCEEDINGS{proc1, + AUTHOR = {Anon, A. N.}, + TITLE = {A very interesting paper}, + BOOKTITLE = {Proc. {UKACC} International Conference on Control}, + DATE = {2010-09}, + EVENTDATE = {2010-09-07/2010-09-10}, + LOCATION = {Coventry}, + PAGES = {1--3} +} diff --git a/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test.pdf b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test.pdf new file mode 100644 index 00000000000..a314bcdaa11 Binary files /dev/null and b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test.tex b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6-test.tex new file mode 100644 index 00000000000..04ebcc67d4d --- /dev/null +++ b/Master/texmf-dist/doc/latex/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: diff --git a/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6.pdf b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6.pdf new file mode 100644 index 00000000000..c2fa6319271 Binary files /dev/null and b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6.pdf differ diff --git a/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6.tex b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6.tex new file mode 100644 index 00000000000..731be806277 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-apa6/biblatex-apa6.tex @@ -0,0 +1,882 @@ +\documentclass{ltxdockit} +\usepackage[british]{babel} +\usepackage[strict]{csquotes} +\usepackage{shortvrb} +\usepackage{ifthen} +\usepackage{listings} +\usepackage{metalogo} +\MakeAutoQuote{«}{»} +\MakeShortVerb{\|} + +% Unicode +\usepackage{fontspec} +\setmainfont[Ligatures=TeX]{TeXGyrePagella} +\setsansfont[Ligatures=TeX]{TexGyreHeros} +\setmonofont[Ligatures=NoCommon]{TeXGyreCursor} + +\newcommand\apa[2][]{\ifthenelse{\equal{#1}{}}% + {\texttt{(APA #2)}}% + {\texttt{(APA #2 Example #1)}}} + +\titlepage{% + title={APA 6th Edition Bib\LaTeX\ style}, + subtitle={Citation and References macros for Bib\LaTeX}, + url={http://mirror.ctan.org/macros/latex/exptl/biblatex-contrib/biblatex-apa/}, + author={Philip Kime}, + email={Philip@kime.org.uk}, + revision={8.0}, + date={\today}} + +\hypersetup{% + pdftitle={APA Bib\LaTeX\ style}, + pdfsubject={APA 6 Conformant Style for Bib\LaTeX}, + pdfauthor={Philip Kime}, + pdfkeywords={latex, biblatex, APA, style}} + +\begin{document} + +\printtitlepage +\tableofcontents + +\section{Important Changes}\label{special} + +\textbf{This is a legacy style for a previous edition of the APA guidelines. The +latest version is always on CTAN with the name |biblatex-apa|}.\\[2ex] + +Please see the revision history below (section \ref{rev}) for details on changes in each +version. This section is just for important things like incompatible +changes which users should be aware of. + +\minisec{7.8} +|ARTICLE| entries now correctly do not print month/day in the bibliography +as per APA 6.28. For non-academic articles (APA 7.01, examples 7, 8 and 9), +use the new: + +\begin{verbatim} + ENTRYSUBTYPE = {nonacademic} +\end{verbatim} + +This will allow month/day data in the bibliography. In the future, there +may be other differences for |ARTICLE| subtypes and it is better to keep +these semantically distinct from standard academic journal articles. + +\minisec{7.5} +This version requires |biblatex| $>=$3.8 and |biber| $>=$2.8. + +\minisec{7.1} +This version requires |biblatex| $>=$3.6 and |biber| $>=$2.6. + +\minisec{7.0} +This version requires |biblatex| $>=$3.5 and |biber| $>=$2.6. Uncertain, +approximate and era-marked dates are now supported in the |biblatex| core +and therefore special fields are no longer needed in the style. See example +files, in particular \texttt{7.10:67} entry in the references test +\file{.bib} and the \texttt{plato} entry in the citation test \file{.bib}. + +\minisec{7.0} +This version requires |biblatex| $>=$3.5 and |biber| $>=$2.6. + +\minisec{6.9} +This version requires |biblatex| $>=$3.4 and |biber| $>=$2.5. + +\minisec{6.8} +This version requires |biblatex| $>=$3.3 and |biber| $>=$2.4. + +\minisec{5.0} +The style now uses the customisable data model functionality of |biblatex| +2.0 and |biber| 1.0 and so these are now required. Several cases +which previously were forced to use custom fields like |USERA|, +|USERB| etc. can now be more naturally implemented with semantically +appropriate fields. See \file{biblatex-apa-references.bib} for +examples. This particularly aids the use of |VIDEO| entries, for +example which now support fields |DIRECTOR|, |PRODUCER|, +|WRITER| and |EXECPRODUCER|. + +Entries which relate to other entries like reviews and reprints are +now implemented more naturally using the |biblatex| 2 «related +entries» functionality. See entries with the |RELATED| field in +\file{biblatex-apa-references.bib} and the |biblatex| manual for +details and examples. + +Entries where authors are listed as «with» are now supported using the +name field |WITH|. See examples file. + +\minisec{4.5} +|biber| is now \emph{required}. This is because APA style needs a custom +sorting scheme and only |biber| supports this. |bibtex| support is going +away in |biblatex| eventually anyway so it's best to switch. + +\minisec{4.4} +The |\maxprtauth| command is now a package option called +«apamaxprtauth», see section \ref{opts}. + +\minisec{4.3} +Specifying entries as «in press» should now be done using the official |biblatex| +mechanism for this. Instead of, for example: + +\begin{verbatim} + YEAR = {in press} +\end{verbatim} + +\noindent you should use: + +\begin{verbatim} + PUBSTATE = {inpress} +\end{verbatim} + +\noindent as «|inpress|» is a |biblatex| localisation string which will +render correctly in supported languages. If you still use the older method, +it will still work but the string will always appear as the English «in +press». + +\section{Introduction}\label{int} + +\subsection{About} + +This package is a Bib\LaTeX\ style for APA (American Psychological +Association) 6th Edition style compliant documents typeset in \latex. It +implements a citation style (\file{apa.cbx}), a references section style +(\file{apa.bbx}), some data model enhancements (\file{apa.dbx}) and string +localisation files (\path{-apa.lbx}). Currently there are only +string localisations for a few languages---if you can help with any other +languages, please mail me; the localisation |.lbx| files are very small and +simple and it would be a small translation task for the few APA-specific +strings needed. The styles are loaded just like any other Bib\LaTeX\ styles +but I wouldn't try to use the citation and references styles separately as +they rely on each other, macro-wise, in places. + +In this document and in the code, the specific APA requirements are +referred to by the section and (if appropriate) the example number of the +APA Style Guide (6th Edition). + +\subsection{Requirements}\label{ref:req} + +You will need to be using \sty{csquotes} ($\geq$ 4.3), Bib\LaTeX\ ($\geq$ +3.4) and Biber ($\geq$ 2.5). If you want to take advantage of the +Bib\LaTeX\ |\DeclareQuotePunctuation| facility to enforce the APA required +«American» punctuation, you should normally use the \sty{babel} package +with the «american» option (see Bib\LaTeX\ manual section |3.9.1|). You can +of course use other languages but in such cases, to adhere to APA +«American» punctuation rules (following commas moved inside closing quotes +etc.), then you should set up |\DeclareQuotePunctuation| yourself as per +section |4.7.5| of the Bib\LaTeX\ manual. + +If you are using the |apa.cls| \latex class, you need be using version +$\geq$ 1.3.4. The class should be invoked with the |noapacite| class option +as per the |apa.cls| documentation. Without this class option, the +|apa.cls| class will automatically try to use plain Bib\TeX\ with the +|apacite| style which is completely incompatible with Bib\LaTeX. + +\subsection{License} + +Permission is granted to copy, distribute and/or modify this software under +the terms of the \latex Project Public License, version +1.3c\footnote{\url{http://www.latex-project.org/lppl.txt}}. The current +maintainer is Philip Kime (\textcopyright\ 2015). + +\subsection{History} + +When I started using Bib\LaTeX, I assumed there would be an APA style +when I went looking. I was wrong. I started to try to make one and realised +why there was none. The APA style manual is enormous; the citation and +references specifications run to about 60 pages and are very specific in +terms of formatting. They are also not entirely consistent but then again, +it is rare to have such a thorough specification to work from. +Inconsistencies in the manual and workarounds are noted in the examples +document. + +\subsection{Acknowledgments} + +Thanks to Philipp Lehman for Bib\LaTeX\ which really has been a major +advance over pure Bib\TeX. Thanks to Alexander van Loon for the Dutch +localisation. Thanks to Paul Thompson for the suggestion to +parameterise the max authors setting. Thanks to George Gkotsis for the +Greek localisation. Thanks to Erikson Kaszubowski for the Brazilian +localisation. Thanks to Braulio José Solano Rojas for the Spanish +localisation. Thanks to Stefan Mayer for the |subtitlepunct| suggestion. +Thanks to Håkon Malmedal for the Norwegian localisation. Thanks to +Johann Gründl for the Austrian localisation. Thanks to Svante Kvarnström +for the Swedish localisation. Thanks to Hendrik Maryns for further Dutch +localisation. Thanks to Tea Tušar and Bogdan Filipič for the Slovenian +localisation. Thanks to Sebastian Ørsted for the Danish localisation. +Thanks to Jürgen Spitzmüller for the DGPs localisation hints. Thanks to +Sergei Golovan for the Russian localisation. Thanks to Vítor Míguez for the +Galacian localisation. + +\section{Use}\label{ref:use} +\label{use} +This package is available via \TeX Live as |biblatex-apa|. You can find it +through the provided \TeX Live update utilities which will install it +automatically for you. If you need to install manually (to use a new +version which has not yet been published to the \TeX Live updaters, for +example), you can download it from CTAN and then, put the \path{.cbx}, +\path{.bbx} and \path{.lbx} files in your texmf tree, usually:\\ + +\noindent\path{/tex/latex/biblatex/cbx/apa.cbx}\\ +\path{/tex/latex/biblatex/bbx/apa.bbx}\\ +\path{/tex/latex/biblatex/lbx/-apa.lbx}\\ + +\noindent Specify the style in the usual way when loading Bib\LaTeX. If you +are using \sty{babel}: + +\begin{ltxcode} +\usepackage[american]{babel} +\usepackage{csquotes} +\usepackage[style=apa]{biblatex} +\end{ltxcode} + +or \sty{polyglossia}: + +\begin{ltxcode} +\usepackage{polyglossia} +\setdefaultlanguage[variant=american]{english} +\usepackage{csquotes} +\usepackage[style=apa]{biblatex} +\end{ltxcode} + +\noindent Note that the APA manual requires the forcing of titles into +«sentence case», that is, initial cap followed by lower case for sentence +units, with the exception of names and material from languages which do not +follow English capitalisation. As of version 0.8a, Bib\LaTeX\ has a +|\MakeSentenceCase| macro which deals with this. So, in the traditional +Bib\TeX\ way, capitalise correctly in the |.bib| file, protecting names etc. +with the usual brace pairs and the style will take care of forcing the +APA-style sentence case in the References section. Unlike the References +section, titles in citations in the APA style appear in normal case and the +style will ensure this too. + +\subsection{Package options}\label{opts} + +The following options are set as usual in the options passed to +|biblatex|. + +\begin{ltxcode} +apabackref=true|false +\end{ltxcode}% | stupid comment to stop emacs highlighting as verb due + % to single pipe + +\noindent It is not APA style to include backreferences in the References to +pages where citations of the entry occur. However, this is very +useful, especially in proofing and so if you set the |apabackref| +option to «true», these are enabled. The default is «false». + +\begin{ltxcode} +apamaxprtauth= +\end{ltxcode} + +\noindent This option controls the number of author/editor names which are +printed in the References. APA style defaults to 7. You can change this if +you really want to fully print all author list references in certain +contexts (for example in a CV where you are an author in position 8 \ldots) + +Setting Bib\LaTeX package options which change name processing +like \opt{uniquename} and \opt{uniquelist} is not supported as this style +does tricky things internally to match the peculiar APA standard. You +should not need to change them anyway as then you wouldn't be using APA +style anyway. + +\subsection{Localisation} + +Localisation is provided for APA-specific strings in the accompanying +|.lbx| files which are loaded automatically. + +Normal use will invoke \sty{babel} with the «american» language or +\sty{polyglossia} with «american» variant of «english». + +The \file{english-apa.lbx} is a copy of the \file{american-apa.lbx} since +the default is «American» English. + +The APA manual does not mention nor sanction any non «American» English +strings but it is quite common for non-English journals to ask for APA style +bibliographies and so this must be supported. + +If not using the \sty{babel} «american» option, it may be necessary to set up +the |\DeclareQuotePunctuation| option as mentioned in section \ref{ref:req} +above. You would only need to do this if, for some strange reason, a +non-american journal required the (unpleasant) american practice of moving +final punctuation marks inside closing quotes. + +\subsubsection{Date formats} + +Obviously, an American style uses month/day/year formats. European formats +are usually day/month/year. The APA style dictates long date formats and so +this is not really apparent in the bibliography. There is an APA standard +for long date formats which may not be correct for European journals using +roughly APA formatting standards (German journals tend to have a different +long date format, for example). The «american» babel option will give you +APA compliant US date formats. Default sensible date formats are included +for german, ngerman and french. You should redefine the |\mkbibdatelong| +macro in the relevant language |*-apa.lbx| file to change this if needed. + +A customisable macro \cmd{urldatecomma} determines what comes between the +date of a URL and the URL itself. This defaults to the standard comma and +space as per APA style but just a space in germanic localisations. + +\subsection{Limitations} +\label{use:limit} +There are certain limitations you need to bear in mind when using these +styles. The APA manual is written without much regard for automation of +citation and references processing---it just tells you how it wants things to +look and the implicit assumption is that you would type out everything by +hand if necessary. Having said that, the majority of the APA citation +and references style is implemented, there are just a few exceptions which +are hardly worth the coding pain since they are ambiguous and easily worked +around. + +\section{Details} + +The detailed information for this style is contained in the example document and +accompanying \path{.bib} files: +\begin{description} +\item[\path{biblatex-apa.tex}] This document. +\item[\path{biblatex-apa-test.tex}]\footnote{\path{biblatex-apa-test.pdf} + is also provided and is the typeset version of this \latex source + file.} This document typesets just about every useful example from + \apa{6.11}--\apa{6.21} and \apa{7.01}--\apa{7.11}. The examples in it + aim to look as much like the APA manual examples as possible. All + citation examples in the document are real examples using a \path{.bib} + file. +\item[\path{biblatex-apa-test-citations.bib}] This contains the \path{.bib} + entries for the citations examples. You won't find anything of interest + in this file---it's just used to provide real data for the citation + examples. +\item[\path{biblatex-apa-test-references.bib}] This contains the + \path{.bib} entries for all of the examples in \apa{7.x}. This file is + the main documentation for the |biblatex-apa| implementation of the APA + References section style. To see how the style deals with a particular + example from \apa{7.x}, look it up in here. Every example is marked with + the APA example number and has explanatory notes. +\item[\path{apa.cbx}] The |biblatex-apa| citations style. It is + decently structured with comments but shouldn't need to be read for + normal use. +\item[\path{apa.bbx}] The |biblatex-apa| references style. It is + decently structured with comments but shouldn't need to be read for + normal use. +\item[\path{apa.dbx}] The |biblatex-apa| data model additions. This allows + users to utilise more natural entry type and field names for certain + entries. See comments in the \path{biblatex-apa-test-references.bib}. +\item[\path{*.lbx}] The |biblatex-apa| localisation files. These files + override some language-specific macros for some fixed strings. +\end{description} + +\subsection{Citations} + +To specify something as «in press», use the |biblatex| |PUBSTATE| field +with the special key value of «|inpress|» (see |biblatex| manual, section +4.9.2.11). See the notes on the |PUBSTATE| field in section \ref{refs} +below. + +\apa{6.13} requires that there should be no parentheses around the year of +the citation when the citation itself occurs within parenthesis. This is +tricky to completely automate within the remit of a citation style since it +requires knowledge of the current typesetting state. So, the new citation +command + +\begin{ltxsyntax} +\cmditem{nptextcite}[prenote][postnote]{key} +\end{ltxsyntax} + +\noindent is provided for such situations. It is identical to |\textcite| +but does not put parentheses around the year and separates items with +commas. See examples using this command in \path{biblatex-apa-test.tex}. +There is also a multi-cite version |\nptextcites| that works in the same +way as |\textcites|. + +The |\fullcite| command uses ampersands, like the references section +and there is also a |\fullcitebib| command which is the same as +|\fullcite| but which fakes a mini references section with APA style +indentation and so is not intended to be used inline like +|\fullcite|. See examples in the test file. + +\subsection{References}\label{refs} + +The references style was based on the Bib\LaTeX\ default +|authoryear-comp| style but is heavily modified. If in doubt read the +example references |.bib| as it is commented and you can learn a lot from +the examples by picking something close to what you need from the APA +examples and then looking in this file to see how it was implemented. Some +general notes: + +\begin{itemize} +\setlength{\itemsep}{0pt} +\item The |PUBSTATE| field takes priority over any date field. If you specify + something with a |PUBSTATE| field like «inpress», then the year label in + citations and the references will be the localisation of the |PUBSTATE| + value key (|PUBSTATE| takes a pre-defined set of localisation keys as + values, see |biblatex| manual). +\item APA style sometimes refers to the «series» of a multi-volume work. + This corresponds to the |MAINTITLE| field in the \file{.bib} and + \emph{not} the |SERIES| field. +\item |VOLUME|, |NUMBER| and |CHAPTER| are forced into arabic numerals if + they are given as roman numerals, as required by \apa{6.22}. +\end{itemize} + +\subsubsection{Journal number for journals with per-issue pagination} +As per APA 6th edition section 6.30 and 7.01, journals which paginate by +issue need the volume number including in the reference section. Since +there is no way to automatically determine when this is the case, use the +|biber| sourcemap feature to implement this, removing the |NUMBER| field +from journals known to implement continuous pagination across volumes. For +example, with this in your preamble: + +\begin{lstlisting}[style=latex]{} +\DeclareSourcemap{ + \maps[datatype=bibtex]{ + \map{ + \step[fieldsource=journaltitle, + match=\regexp{(?:journal\stitle\sone|journal\stitle\stwo)}] + \step[fieldset=number, null] + } + } +} +\end{lstlisting} +% +Simply include |NUMBER| fields for all journals and entries with +|JOURNALTITLE| of «journal title one» or «journal title two» (which +are known to paginate across all numbers of a volume) will have +their |NUMBER| field dynamically removed at document compile time, as +required. + +\subsubsection{Retrieval dates for online items} + +APA 6th edition section 6.32 says «Do not include retrieval dates unless +the source material may change over time (e.g., Wikis)». This is open to +interpretation of what constitutes a Wiki and what counts as «changing over +time». The style does not implement anything for this requirement by +default but you can automate your own interpretation by putting this in +your preamble: + +\begin{lstlisting}[style=latex]{} +\DeclareSourcemap{ + \maps[datatype=bibtex]{ + \map{ + \step[fieldsource=url, + notmatch=\regexp{wiki}, + final=1] + \step[fieldset=urldate, null] + } + } +} +\end{lstlisting} + +\noindent This will dynamically remove the |URLDATE| field from any entry +where the |URL| field doesn't match the regular expression «wiki». Modify this +regular expression according to taste. This modification is dynamically +applied to the data stream by |biber| and does not change your \file{.bib}. + +\section{Revision history}\label{rev} + +\begin{changelog} + +\begin{release}{8.0}{2019-09-07} +\item Removed unused and unneeded use of NUMBER and SERIES fields +\end{release} + +\begin{release}{7.9}{2019-09-03} +\item Bugfix release +\end{release} + +\begin{release}{7.8}{2019-08-30} +\item Fixed date rules for |ARTICLE|s +\end{release} + +\begin{release}{7.7}{2018-04-02} +\item Bug fixes and example alignments +\end{release} + +\begin{release}{7.6}{2018-03-05} +\item Internal cleanup and bugfixes +\end{release} + +\begin{release}{7.5}{2017-11-05} +\item Compat for bibaltex 3.8 +\item |\DeclareLanguageMapping| is now no longer necessary due to the new + |\DeclareLanguageMappingSuffix| macro. +\end{release} + +\begin{release}{7.4}{2017-01-06} +\item Minor bugfix release +\end{release} + +\begin{release}{7.3}{2016-12-21} +\item Minor bugfix release +\end{release} + +\begin{release}{7.2}{2016-10-24} +\item Minor bugfix release for date fields +\end{release} + +\begin{release}{7.1}{2016-09-15} +\item Minor bugfix release for legacy YEAR fields and |inpress| strings +\item Requires |biblatex| 3.6+ and biber 2.6+ +\end{release} + +\begin{release}{7.0}{2016-09-14} +\item Added \cmd{urldatacomma} +\item Now following DGPs guidelines for some formatting in Germanic + locales. +\item Requires |biblatex| 3.5+ and biber 2.6+ +\end{release} + +\begin{release}{6.9}{2016-05-13} +\item Bug fixes +\item Requires |biblatex| 3.4+ and biber 2.5+ +\end{release} + +\begin{release}{6.8}{2016-03-01} +\item Bug fixes +\item Updated to use new \cmd{DeclareNameFormat} structure for |biblatex| + 3.3+ (which is now required) +\end{release} + +\begin{release}{6.7}{2015-01-23} +\item Bug fixes +\end{release} + +\begin{release}{6.6}{2014-10-23} +\item Bug fixes +\end{release} + +\begin{release}{6.5}{2014-04-16} +\item Bug fixes +\item Slovenian localisation +\end{release} + +\begin{release}{6.4}{2013-10-30} +\item Fixed explicit «and others» problem +\item Improved french localisation +\end{release} + +\begin{release}{6.3}{2013-10-28} +\item Fixed issue where |SHORTAUTHOR| was only being used for exact same citations. +\end{release} + +\begin{release}{6.2}{2013-10-19} +\item Corrected Dutch translations +\item Fixed Norwegian lbx corruption +\item Misc bugfixes +\end{release} + +\begin{release}{6.1}{2013-07-19} +\item Corrected APA 6.12 error and switched to uniquelist=minyear +\item Documented way of automating some APA 6.32 requirements +\end{release} + +\begin{release}{6.0}{2013-07-10} +\item Added Swedish localisation +\item Fixed useprefix=false issue +\end{release} + +\begin{release}{5.9}{2013-05-08} +\item Compatibility with |biblatex| 2.6--«nodate» is now part of core +\item autocite is set to inline +\end{release} + +\begin{release}{5.8}{2013-03-07} +\item Made BOOK like INBOOK for order of online/reprint information +\item Fixes for recursive RELATED fields +\end{release} + +\begin{release}{5.7}{2012-12-28} +\item New name code to allow full name disambiguation as per APA 6.27 +\item Fixes to IN* types +\end{release} + +\begin{release}{5.6}{2012-12-19} +\item Fixed problems with EVENTDATE format +\end{release} + +\begin{release}{5.5}{2012-12-17} +\item Fixed serial comma requirement (APA 4.03) +\end{release} + +\begin{release}{5.4}{2012-11-28} +\item Updated for |biblatex| 2.4 +\end{release} + +\begin{release}{5.3}{2012-11-21} +\item Updated for some |biblatex| changes. +\end{release} + +\begin{release}{5.2}{2012-09-30} +\item Entries with no YEAR no longer fall back on other date fields + and use «nodate» bibstring. +\item «nodate» bibstring no longer lowercased and supports extrayear +\end{release} + +\begin{release}{5.1}{2012-08-01} +\item Added Norwegian localisation (thanks to Håkon Malmedal) +\item Fixed some documentation issues +\end{release} + +\begin{release}{5.0}{2012-07-01} +\item Using |biblatex| 2.0/|biber 1.0| data model facility. +\end{release} + +\begin{release}{4.8}{2012-06-02} +\item Put in proper package version strings +\item Fixed a problem with \cmd{textcites} (thanks to Florian Sesser and + Cornielia Entner for reporting) +\end{release} + +\begin{release}{4.7}{2012-04-19} +\item Made |firstinits=false| possible +\item Fixed a problem with explicit «and others» with names (thanks to + George Pigman) +\end{release} + +\begin{release}{4.6}{2012-02-08} +\item Reduced the Biber requirement to a warning due to bug in |biblatex| 1.7 +\item Added Italian localisation (thanks to Luca Montanelli) +\end{release} + +\begin{release}{4.5}{2012-01-31} +\item Noted in manual that |biber| is now required due to custom sorting. +\item Added |INSTITUTION| field to |REPORT| entries +\end{release} + +\begin{release}{4.4}{2012-01-25} +\item |\maxprtauth| command is now a package option «apamaxprtauth» +\item New package option «apabackref» controlling whether + backreferences and links to citations appear in the References. +\end{release} + +\begin{release}{4.3}{2012-01-22} +\item «et al» now only replaces two or more names since it's plural +\item «in press» items now should use the |biblatex| |PUBSTATE| field +\item Fixed «in press» hyphenation issue for disambiguation in references +\item URLs are now by default in roman font as per APA style. +\end{release} + +\begin{release}{4.2}{2011-11-12} +\item Fixed macro name typo +\end{release} + +\begin{release}{4.1}{2011-11-02} +\item |subtitlepunct| now skips if following terminating punctuation +\end{release} + +\begin{release}{4.0}{2011-10-05} +\item Disabled «smart and» for spanish localisation as it breaks ampersands +\end{release} + +\begin{release}{3.9}{2011-10-03} +\item Fixed data format issue in localisations +\end{release} + +\begin{release}{3.8}{2011-09-25} +\item Fixed slanted/italic confusion in bibliography +\end{release} + +\begin{release}{3.7}{2011-09-23} +\item Fixed issue no dates when labelyear defined +\end{release} + +\begin{release}{3.6}{2011-09-20} +\item Fixed issue with American format long dates +\end{release} + +\begin{release}{3.5}{2011-09-05} +\item Fixed issue Editor name part order when in Author position (thanks to + Johann Bauer) +\end{release} + +\begin{release}{3.4}{2011-09-01} +\item Fixed issue with |\fullcite| not resetting |bbx| globals +\end{release} + +\begin{release}{3.3}{2011-08-23} +\item Spanish localisation +\end{release} + +\begin{release}{3.2}{2011-08-12} +\item Minor fix in |inbook| format +\item Doc clean up +\end{release} + +\begin{release}{3.1}{2011-07-31} +\item Made compatible with Bib\LaTeX\ 1.6 +\end{release} + +\begin{release}{3.0}{2011-05-06} +\item |maxnames| and |minnames| are now set to sensible things and actually + used. Biber $\geq$ 0.9.3 is now required as this implements a fix for + |uniquelist| in Bib\LaTeX\ which needs |maxnames| and |minnames| set to + real values. +\item Fixed bug with commas before «et al» not appearing in some cases. +\end{release} + +\begin{release}{2.9}{2011-05-03} +\item APA wants no space between volume and number for articles, even though it's + horribly ugly\ldots +\item Made urls not optional with Bib\LaTeX\ url toggle in |ONLINE| entrytype (thanks to Mattias Erll) +\end{release} + +\begin{release}{2.8}{2011-04-23} +\item Added a Greek localisation strings file. +\end{release} + +\begin{release}{2.7}{2011-04-1} +\item Biber is now a strongly recommended requirement due to APA name and + name list disambiguation requirements. +\item Updated for Bib\LaTeX\ 1.4/Biber 0.9 with automatic list + disambiguation. Package now deals with all APA 6th Edition citation examples. +\end{release} + +\begin{release}{2.6}{2011-03-15} +\item Made fullcite use ampersand +\item Added fullcitebib macro to allow fake bib citations +\end{release} + +\begin{release}{2.5}{2010-11-24} +\item Refactored hyperref to only link from years to make it + consistent across cite commands +\item Added hyperref target references section for citation examples +\item Fixed textcite multicite issue +\end{release} + +\begin{release}{2.4}{2010-11-14} +\item Fixed postnotes/hyperref for textcite +\end{release} + +\begin{release}{2.3}{2010-11-04} +\item Overhauled hyperref functionality and made more robust +\end{release} + +\begin{release}{2.2}{2010-10-15} +\item Parameterised max author/editor list (thanks to Paul Thompson) +\item Better rudimentary regression script +\item Completely reconfigured EPRINT/EPRINTTYPE +\end{release} + +\begin{release}{2.1}{2010-10-17} +\item New Dutch localisation (thanks to Alexander van Loon) +\end{release} + +\begin{release}{2.0}{2010-09-30} +\item Moved to new date format code internally +\end{release} + +\begin{release}{1.9}{2010-09-27} +\item Moved docs to LuaLaTeX compat +\item Fixed german/ngerman date formats +\item Cleaned up date format code +\end{release} + +\begin{release}{1.8}{2010-08-06} +\item Fixed seven author ellipsis bug +\end{release} + +\begin{release}{1.7}{2010-08-05} +\item Corrected dateless entry format, added examples to test doc +\item Corrected multi delim for |\citeyear| +\item Updated test doc for Bib\LaTeX\ 0.9b compat +\end{release} + +\begin{release}{1.6}{2010-07-19} +\item Added correct |\citeyear| definition +\end{release} + +\begin{release}{1.5}{2010-07-12} +\item Corrected |NOTE/ADDENDUM| examples +\item Made |\nptextcite| behave more consistently like |\textcite| for multi-cites. +\end{release} + +\begin{release}{1.4}{2010-07-07} +\item Removed extra space after DOI +\end{release} + +\begin{release}{1.3}{2010-07-05} +\item Fixed Oxford comma bug +\end{release} + +\begin{release}{1.2}{2010-06-18} +\item Made style arguments more explicit in |.bbx| +\item Fixed bad documentation due to beta Bib\LaTeX\ version. +\item Updated docs - minimum Bib\LaTeX\ version +\end{release} + +\begin{release}{1.1}{2010-05-28} +\item Fixed |INBOOK| |citetitle| format to match |BOOK|. +\item Fixed |extrayear| in entries with full date specifications. +\end{release} + +\begin{release}{1.0}{2010-05-12} +\item Fixed |TYPE| and |NUMBER| fields in |REPORT| entries. Now more + flexible. +\item |PUBSTATE| is now valid for articles. +\item |DOI|, if present, suppresses any |URL| field. +\item Abstract retrieval string is now conditional on |USERB| field, not on + the existence of an abstract. +\item Default strings for |PHDTHESIS| and |MASTERSTHESIS| entries corrected. +\item |LOCATION| is now valid for thesis entries and comes after |INSTITUTION|. +\end{release} + +\begin{release}{0.9}{2010-03-08} +\item Update for APA manual 6th edition and Bib\LaTeX\ 0.9 +\end{release} + +\begin{release}{0.8}{2010-02-15} +\item Fixed bug with spaces after nptextcite +\item Updated for Bib\LaTeX\ 0.9 +\end{release} + +\begin{release}{0.7}{2010-01-20} +\item Made hyperref links more consistent, using the whole citation and not + just the year. +\end{release} + +\begin{release}{0.6}{2009-11-20} +\item Corrected two bugs in |cite| macro which left a trailing space after + multiple cites and actually cited the year twice for multiple cite + commands in some circumstances. +\item Corrected bug where |\textcite| would leave a stray open bracket on + the stack when year was suppressed within a paragraph. +\end{release} + +\begin{release}{0.5}{2009-09-19} +\item Replaced literal string with localised form in url macro. +\item Moved localisation strings into \sty{.lbx} files. +\item |\DeclareLanguageMapping| is now needed in preamble. +\item Moved |\DeclareBibliographyExtras| into \sty{.lbx} files. +\item Some support for alternative localised date formats. +\item Fixed slant/italic font problem since the |\mkbibemph| macro had + changed in Bib\LaTeX\ 0.8e. +\item Fixed |liststop| error which was preventing name lists with two + entries from having the comma before the ampersand. +\end{release} + +\begin{release}{0.4}{2009-07-24} +\item Fixed bug where multiple year ranges were not displayed properly. +\item Updated to remove pre-Bib\LaTeX\ 0.8e macros error. +\end{release} + +\begin{release}{0.3}{2008-12-21} +\item Updated to use new fields (|EVENTTITLE|) and new options + (|usetranslator|) from Bib\LaTeX\ 0.8b. +\end{release} + +\begin{release}{0.2}{2008-12-06} +\item Added |noremoteinfo| option). +\item Fixed bbx bug with more than 7 authors still printing names after «et al». Was + due to resetting maxnames to 999. +\item Removed the customised (hacked) |apa-biblatex.cls| class from the package as + |apa.cls| version 1.3.4 is compatible with Bib\LaTeX\. +\item Altered documentation about requiring the «american» babel option. + This is not required if you set up |\DeclareQuotePunctuation| yourself. +\item Added minimum required version of \sty{csquotes}. +\item Minor doc tweaks. +\end{release} + +\begin{release}{0.1}{2008-12-01} +\item Initial release +\end{release} + + + +\end{changelog} +\end{document} + +% Local Variables: +% TeX-engine: luatex +% End: -- cgit v1.2.3