diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/README | 23 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-citations.bib | 17 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib | 209 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf | bin | 97382 -> 100393 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex | 48 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf | bin | 73998 -> 74095 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex | 96 |
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 Binary files differindex 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 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 Binary files differindex 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 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 |