summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-apa
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-07-14 23:29:42 +0000
committerKarl Berry <karl@freefriends.org>2012-07-14 23:29:42 +0000
commit9c45fe88cb4094081b2b1243cd17bcc43439c041 (patch)
tree7cc4b04347495547b4afce8a28ac028256eb69d9 /Master/texmf-dist/doc/latex/biblatex-apa
parent9c2ad73f6c5870b83ac88537986c2bbb2294f7c4 (diff)
biblatex-apa (10jul12)
git-svn-id: svn://tug.org/texlive/trunk@27057 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-apa')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/README23
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-citations.bib17
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib209
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdfbin97382 -> 100393 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex48
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdfbin73998 -> 74095 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex96
7 files changed, 235 insertions, 158 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/README b/Master/texmf-dist/doc/latex/biblatex-apa/README
index ecd1a4adf83..d9074de689d 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/README
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/README
@@ -1,4 +1,4 @@
-Version 4.7
+Version 5.0
Permission is granted to copy, distribute and/or modify this software under
the terms of the LaTeX Project Public License, version
@@ -16,17 +16,16 @@ 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 >= 1.4.
-The biber backend for biblatex >= 0.9.2 is also strongly recommended and some
-functionality is unavailable without this (see docs). 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 will need to be using csquotes >= 4.3 and biblatex >= 2.0 The biber
+backend for biblatex >= 1.0 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
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-citations.bib b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-citations.bib
index 6891dc775e1..eacc8427a2a 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-citations.bib
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-citations.bib
@@ -365,3 +365,20 @@
TITLE = {Looking at Spiders},
YEAR = {2010}
}
+
+% Testing "with"
+@BOOK{with1,
+ AUTHOR = {James Jaunty and Russell Rendition},
+ WITH = {Alan Also},
+ TITLE = {Look for Lost Limps},
+ YEAR = {2000}
+}
+
+% Testing citeauthor
+@BOOK{ca1,
+ AUTHOR = {Brian Blameless and Colin Careless and Derek Delusional},
+ TITLE = {Three Modern Men},
+ YEAR = {2001}
+}
+
+
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib
index 53bfb6f55a0..3c8b9c97e14 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib
@@ -15,7 +15,7 @@
% (APA 7.01 Example 2)
@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, Depedence, {DRD2 A1} Allele, and Depressive Traits},
+ 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},
@@ -37,7 +37,7 @@
@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},
+ TITLE = {The Geographic Expansion of {M}exican Immigration in the {U}nited {S}tates and its Implications for Local Law Enforcement},
YEAR = {2008},
JOURNALTITLE = {Law Enforcement Executive Forum Journal},
VOLUME = {8},
@@ -49,7 +49,7 @@
@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 Rating in Kindergarten Predictive of Reading Dificulties in First Grade?},
+ TITLE = {Are Teacher Ratings in Kindergarten Predictive of Reading Dificulties in First Grade?},
JOURNALTITLE = {Approche Neuropsychologique des Apprentissages chez l'Enfant},
VOLUME = {19},
PAGES = {5--17},
@@ -113,25 +113,25 @@
}
% (APA 7.01 Example 10)
-% Use ENTRYSUBTYPE "newspaper" for newspaper articles so that the pages specification
+% 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
-@ARTICLE{7.01:10,
- ENTRYSUBTYPE = {newspaper},
+@NEWSARTICLE{7.01:10,
AUTHOR = {J. Schwartz},
TITLE = {Obesity Affects Economic, Social Status},
- JOURNALTITLE = {The Washington Post},
+ NEWSPAPER = {The Washington Post},
PAGES = {A1, A4},
DATE = {1993-09-30},
}
% (APA 7.01 Example 11)
-@ARTICLE{7.01:11,
- ENTRYSUBTYPE = {newspaper},
+@NEWSARTICLE{7.01:11,
AUTHOR = {J. E. Brody},
TITLE = {Mental Reserves Keep Brain Agile},
- JOURNALTITLE = {The New York Times},
+ NEWSPAPER = {The New York Times},
DATE = {2007-12-11},
URL = {http://www.nytimes.com}
}
@@ -174,7 +174,7 @@
% 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 Type A Personality Among Employed Adults},
+ TITLE = {The Nomological Validity of the {T}ype {A} Personality Among Employed Adults},
TITLEADDON = {Monograph},
JOURNALTITLE = {Journal of Applied Psychology},
VOLUME = {76},
@@ -238,22 +238,20 @@
YEAR = {1991}
}
-% Note use of special USERB field value to specify that the URL is for the abstract
+% 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"
-% USERB must equal "urlisabstract" to do this
@ARTICLE{7.01:16b,
- USERB = {urlisabstract},
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},
YEAR = {2006},
- URL = {http://www.interscience.wiley.com}
+ ABSTRACTURL = {http://www.interscience.wiley.com}
}
% (APA 7.01 Example 17)
-% It's a bit clumsy but such extra information can be included in the NOTE field.
+% Such unstructured extra information can be included in the NOTE 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,
@@ -299,7 +297,7 @@
% (APA 7.02 Example 20)
@BOOK{7.02:20,
AUTHOR = {E. O'Keefe},
- TITLE = {Egoism \& the Crisis in Western Values},
+ TITLE = {Egoism \& the Crisis in {W}estern Values},
URL = {http://www.onlineoriginals.com/showitem.asp?itemID=135}
}
@@ -377,13 +375,23 @@
LOCATION = {Hillsdale, NJ},
PUBLISHER = {Erlbaum},
YEAR = {1988},
- ADDENDUM = {Reprinted from Manual of child psychology, pp. 703--732, by P. H. Mussen, Ed., 1970, New York: Wiley}
+ 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},
+ TITLE = {{APA} Dictionary of Psychology},
LOCATION = {Washington, DC},
PUBLISHER = {American Psychological Association},
YEAR = {2007},
@@ -440,11 +448,11 @@
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},
YEAR = {2007},
- URL = {http://www.apa.org/pi/wpo/sexualizaion.html}
+ URL = {http://www.apa.org/pi/wpo/sexualization.html}
}
% (APA 7.03 Example 33)
-% Use ORGANIZATION to introduce website address defaults to "Retreived from"
+% 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},
@@ -452,12 +460,11 @@
TYPE = {Research Report},
NUMBER = {06.3},
YEAR = {2006},
- ORGANIZATION = {Poverty Alleviation website},
+ URLDESCRIPTION = {Poverty Alleviation website},
URL = {http://www.repoa.or.tz/documents_storage/Publications/Reports/06.3_Kessey_and_Urio.pdf}
}
% (APA 7.03 Example 34)
-% Use the ORGANIZATION field to describe the URL
% 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,
@@ -467,7 +474,7 @@
TYPE = {CIERA Report},
NUMBER = {3-025},
YEAR = {2002},
- ORGANIZATION = {University of Michigan, Center for Improvement of Early Reading Achievement website},
+ 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}
}
@@ -483,26 +490,27 @@
}
% (APA 7.04 Example 36)
+% Note this renders with a period before the LOCATION which is more consistent with other entries
@INPROCEEDINGS{7.04:36,
AUTHOR = {J. Muelbauer},
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, Jackson Hole, WY},
+ 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,
- USERB = {urlisabstract},
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},
- URL = {http://www.iceis.org/iceis2005/abstracts_2005.htm}
+ ABSTRACTURL = {http://www.iceis.org/iceis2005/abstracts_2005.htm}
}
% (APA 7.04 Example 38)
@@ -590,17 +598,16 @@
}
% (APA 7.06 Example 45)
-% Use ENTRYSUBTYPE to specify the reviewed item
-% Use ORIGTITLE to specify the reviewed item title
-% Use VERBA to specify the reviewed item original author until BibLaTeX gets a
-% ORIGAUTHOR or ORIGTITLEADDON or similar
-
+% 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?},
- ENTRYSUBTYPE = {Review of the book},
- ORIGTITLE = {The Social Life of Information},
- VERBA = {by J. S. Brown & P. Duguid},
+ REVIEWTEXT = {the book},
+ RELATED = {brdu},
+ RELATEDTYPE = {reviewof},
+ RELATEDSTRING = {Review of the book},
JOURNALTITLE = {Science},
VOLUME = {290},
PAGES = {1304},
@@ -608,68 +615,87 @@
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?},
- ENTRYSUBTYPE = {Review of the {DVD}},
- ORIGTITLE = {Brief Therapy With Adolescents},
- VERBA = {produced by the American Psychological Association, 2007},
+ RELATED = {apavid},
+ RELATEDTYPE = {reviewof},
+ RELATEDSTRING = {Review of the {DVD}},
JOURNALTITLE = {PsycCRITIQUES},
VOLUME = {52},
NUMBER = {51},
DATE = {2007},
- DOI = {10.1037/a0009036},
+ DOI = {10.1037/a0009036}
+}
+@VIDEO{apavid,
+ AUTHOR = {{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,
- ENTRYSUBTYPE = {Review of the video game},
- ORIGTITLE = {BioShock},
- VERBA = {produced by 2K Games, 2007},
+ 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 = {BioShock},
+ 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},
- ENTRYSUBTYPE = {Peer commentary on the paper},
- ORIGTITLE = {``{D}ecrease of {D}eaf potential in a mainstreamed environment''},
- VERBA = {by K. S. Wolf},
+ 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},
+ YEAR = {2003},
+}
+
% (APA 7.07 Example 49)
-% There is no way to format in the required manner without using custom fields currently.
-% This makes the .bib file unportable between styles but there is no clean way round this
-% until BibTeX is replaced in biblatex.
-% Use NAMEA/NAMEATYPE and NAMEB/NAMEBTYPE for the two main credits. Since these are not
-% recognised as sorting fields, be sure to specify how you want the entry sorted in the
-% References section using the SORTKEY field.
-% The default string before URLs is "Retrieved from". Use USERA to override
-% "Retrieved". The contents of USERA are a bibstring defined in the lbx so don't
-% capitalise or it won't match a localisable string
+% We render this with "retrieved from" instead of "available from" as this is arbitrary
+% and ugly to parameterise. Forcing this means we can use a localisable string for "retrieved"
@VIDEO{7.07:49,
ENTRYSUBTYPE = {{DVD}},
- SORTKEY = {American Psychological Association},
- NAMEA = {{American Psychological Association}},
- NAMEATYPE = {Producer},
+ PRODUCER = {{American Psychological Association}},
TITLE = {Responding Therapeutically to Patient Expressions of Sexual Attraction},
YEAR = {2000},
- USERA = {available},
URL = {http://www.apa.org/videos/}
}
% (APA 7.07 Example 50)
@AUDIO{7.07:50,
ENTRYSUBTYPE = {Audio Podcast},
- SORTKEY = {Van Nuys, D.},
- NAMEA = {D. {Van Nuys}},
- NAMEATYPE = {Producer},
+ PRODUCER = {D. {Van Nuys}},
TITLE = {Shrink Rap Radio},
DATE = {2007-12-19},
URL = {http://www.shrinkrapradio.com/}
@@ -678,13 +704,9 @@
% (APA 7.07 Example 51)
@VIDEO{7.07:51,
ENTRYSUBTYPE = {Television series episode},
- SORTKEY = {Egan, D.},
- NAMEA = {D. Egan},
- NAMEATYPE = {Writer},
- NAMEB = {J. Alexander},
- NAMEBTYPE = {Director},
- NAMEC = {D. Shore},
- NAMECTYPE = {Executive producer},
+ WRITER = {D. Egan},
+ DIRECTOR = {J. Alexander},
+ EXECPRODUCER = {D. Shore},
TITLE = {Failure to Communicate},
MAINTITLE = {House},
LOCATION = {New York, NY},
@@ -707,7 +729,6 @@
}
% (APA 7.07 Example 53)
-% Here, we use the flexible editor fields
@MISC{7.07:53,
AUTHOR = {{Lewis County Geographic Information Services}},
NAMEADDON = {Cartographer},
@@ -718,13 +739,11 @@
}
% (APA 7.08 Example 54)
-% Data sets need special formatting of name so we use USERD with "dataset" to specify them
-@MISC{7.08:54,
- USERD = {dataset},
+@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},
- ENTRYSUBTYPE = {Data file and code book},
YEAR = {2004},
URL = {http://pewhispanic.org/datasets/}
}
@@ -752,7 +771,7 @@
% (APA 7.08 Example 57)
@MISC{7.08:57,
TITLE = {{Eyelink II}},
- TITLEADDON = {Apparatus and software},
+ ENTRYSUBTYPE = {Apparatus and software},
LOCATION = {Mississauga, Ontario, Canada},
PUBLISHER = {SR Research},
YEAR = {2004},
@@ -773,17 +792,15 @@
AUTHOR = {J. Y. Ting and P. Florsheim and W. Huang},
TITLE = {Mental Health Help-Seeking in Ethnic Minority Populations},
SUBTITLE = {A Theoretical Perspective},
- HOWPUBLISHED = {Unpublished submitted for publication},
+ HOWPUBLISHED = {Manuscript submitted for publication},
YEAR = {2008},
}
% (APA 7.09 Example 60)
-% Have to trick BibTeX into thinking there is a title so you can add a TITLEADDON
-@UNPUBLISHED{7.09:60,
+@DATA{7.09:60,
AUTHOR = {F. Bordi and J. E. LeDoux},
- TITLE = {{}},
- TITLEADDON = {Auditory Response Latencies in Rat Auditory Cortex},
- HOWPUBLISHED = {Unpublished raw data},
+ ENTRYSUBTYPE = {Auditory Response Latencies in Rat Auditory Cortex},
+ NOTE = {Unpublished raw data},
YEAR = {1993},
}
@@ -805,7 +822,6 @@
YEAR = {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 (<eprintid>)"
@@ -819,9 +835,6 @@
}
% (APA 7.10 Example 63)
-% Note that this example is inconsistent in the APA 6th Edition (2nd printing) manual
-% with example 7.10:65. They differ in that 7.10:63 has a comma before the location
-% and 7.10:65 has a period. I have chosen a period for consistency.
@LETTER{7.10:63,
AUTHOR = {L. K. Frank},
TITLE = {Letter to {R}obert {M}. {O}gden},
@@ -840,9 +853,8 @@
}
% (APA 7.10 Example 65)
-% ENTRYSUBTYPE is "collection" for a collection of letters
-@LETTER{7.10:65,
- ENTRYSUBTYPE = {collection},
+% Entrytype is "LETTERS" (plural) for a collection of letters
+@LETTERS{7.10:65,
AUTHOR = {G. W. Allport},
TITLE = {Correspondence},
DATE = {1930/1967},
@@ -861,11 +873,11 @@
}
% (APA 7.10 Example 67)
-% Have to use USERE to specifiy the "known" status of the AUTHOR and/or DATE.
-% Defined types are "unkauth" for doubtful AUTHOR, "unkdate" for doubtful date,
-% "unkauthdate" for both doubtful.
+% Pseudo-boolean fields "DOUBTFULAUTHOR" and "DOUBTFULDATE" to specify doubtful information
+% to the drivers. Values should only ever be "true" if present.
@UNPUBLISHED{7.10:67,
- USERE = {unkauthdate},
+ DOUBTFULAUTHOR = {true},
+ DOUBTFULDATE = {true},
AUTHOR = {A. Allport},
TITLE = {Marion {T}aylor Today---By the Biographer},
YEAR = {1937},
@@ -905,10 +917,11 @@
}
% (APA 7.10 Example 71)
-@MISC{7.10:71,
+% If no normal paper citation, use ENTRYSUBTYPE to say what this NEWSARTICLE is
+@NEWSARTICLE{7.10:71,
TITLE = {Psychoanalysis Institute to Open},
- ENTRYSUBTYPE = {Clipping from an unidentified Dayton, OH newspaper},
DATE = {1948-09-18},
+ ENTRYSUBTYPE = {Clipping from an unidentified Dayton, OH newspaper},
NOTE = {Copy in possession of author}
}
@@ -923,15 +936,15 @@
}
% (APA 7.10 Example 73)
-% Use USERE to specifiy the "known" status of the AUTHOR and/or DATE (see Example 67)
+% Use DOUBTFULDATE to specifiy the "known" status of the DATE (see Example 67)
% 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 USERD as "description" to indicate that the title is a description and not a real
+% Use TITLEISDESCRIPTION to indicate a title that is really a description and not a real
% title
@MISC{7.10:73,
- USERE = {unkdate},
- USERD = {description},
+ DOUBTFULDATE = {true},
+ TITLEISDESCRIPTION = {true},
TITLE = {{Photographs of Robert M. Yerkes}},
DATE = {1917/1954},
HOWPUBLISHED = {Robert Mearns Yerkes Papers (Box 137, Folder 2292)},
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf
index b9f1eeed274..6e8f32521d3 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex
index a6db225eeeb..90310e25e7d 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex
@@ -47,8 +47,38 @@
\setlength{\parskip}{3ex}
\makeatletter
-\def\apaex#1{\hbox{\hspace{-4em}\texttt{\small\expandafter\zap@space\detokenize{#1} \@empty}}\\$\rcurvearrowse$ \textbf{#1}}
-\def\apaexs#1{\hbox{\texttt{\footnotesize\expandafter\zap@space\detokenize{#1} \@empty}} \textbf{\small #1}}
+% 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
@@ -308,18 +338,30 @@ expanding to be properly disambiguated. Truncating either would be ambiguous.\\
\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»\\
+\apaex{\cite{with1}}\\
+\apaex{\textcite{with1}}
+
+\noindent Testing author name citing\\
+\apaex{\citeauthor{ca1}}\\
+\apaex{\citeauthor{ca1}}
+
\end{refsection}
\begin{refsection}[biblatex-apa-test-references]
\nocite{*}
\end{refsection}
\newpage
-% Just (APA 7.x) real references examples here
+% 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
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf
index 38b0673d6b5..13e5992005b 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
index 22d8f2b063e..291d65ce7be 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
@@ -25,7 +25,7 @@
url={http://www.ctan.org/tex-archive/macros/latex/exptl/biblatex-contrib/biblatex-apa/},
author={Philip Kime},
email={Philip@kime.org.uk},
- revision={4.7},
+ revision={5.0},
date={\today}}
\hypersetup{%
@@ -45,6 +45,25 @@ Please see the revision history below (section \ref{rev}) for details on change
version. This section is just for important things like incompatible
changes which users should be aware of.
+\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
@@ -79,14 +98,15 @@ press».
This package is a Bib\LaTeX\ style for APA (American Psychological
Association) style compliant documents typeset in \latex. It implements a
-citation style (\path{apa.cbx}), a references section style
-(\path{apa.bbx}) and string localisation files (\path{<language>-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.
+citation style (\file{apa.cbx}), a references section style
+(\file{apa.bbx}), some data model enhancements (\file{apa.dbx}) and string
+localisation files (\path{<language>-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
@@ -94,18 +114,15 @@ APA Style Guide (6th Edition).
\subsection{Requirements}\label{ref:req}
-You will need to be using \sty{csquotes} ($\geq$ 4.3) and Bib\LaTeX\
-($\geq$ 1.4). Some features will not work\footnote{Automatic name and name
- list uniqueness disambiguation, for example---see examples doc} without the
-Biber backend for Bib\LaTeX\ ($\geq$ 0.9.2) which is strongly
-recommended. 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.
+You will need to be using \sty{csquotes} ($\geq$ 4.3), Bib\LaTeX\ ($\geq$
+2.0) and Biber ($\geq$ 1.0). 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
@@ -255,12 +272,6 @@ and references style is implemented, there are just a few exceptions which
are hardly worth the coding pain since they ambiguous and easily worked
around.
-\subsubsection{Reference Section Limitations}
-
-\begin{description}
-\item\apa{6.27} Can't deal yet with authors listed as «with».
-\end{description}
-
\section{Details}
The detailed information for this style is contained in the example document and
@@ -290,6 +301,9 @@ accompanying \path{.bib} files:
\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}
@@ -346,35 +360,27 @@ general notes:
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 There are occasions where there is no sensible \path{.bib} key to
- use. This applies to things like |AUDIO| and |VIDEO| entries mainly. The
- format of these requires that different roles (Director, Producer etc.)
- are separately specified for different names. This is not really possible
- for the usual |AUTHOR| or |EDITOR| fields. In such cases, I have resorted
- to the Bib\LaTeX\ custom |NAME| and |NAMETYPE| fields which are not
- very portable but until the Bib\TeX\ backend support is dropped in Bib\LaTeX\
- there is no way round this without making things very messy. This will
- happen around Bib\LaTeX\ version 2.0.
\item APA style sometimes refers to the «series» of a multi-volume work.
This corresponds to the |MAINTITLE| field in the \path{.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}.
-\item |USERB| is sometimes used to specify that a URL is for an abstract
- rather than the paper itself. Not very portable but that's because of Bib\TeX\ data
- model limtations.
-\item |USERD| is sometimes used to specify information that indicates
- special formatting. Not very portable but that's because of Bib\TeX\ data
- model limtations.
-\item |USERE| is sometimes used to specify questionable dates/authors for
- special formatting. Not very portable but that's because of Bib\TeX\ data
- model limtations.
\end{itemize}
\section{Revision history}\label{rev}
\begin{changelog}
+\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