From fde9f1341f8b60d9193c41e45d1a5a43868f1757 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 23 Jan 2012 23:08:57 +0000 Subject: biblatex-apa (23jan12) git-svn-id: svn://tug.org/texlive/trunk@25183 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/biblatex-apa/README | 2 +- .../biblatex-apa/biblatex-apa-test-citations.bib | 25 ++++++++- .../biblatex-apa/biblatex-apa-test-references.bib | 7 ++- .../doc/latex/biblatex-apa/biblatex-apa-test.pdf | Bin 98217 -> 97176 bytes .../doc/latex/biblatex-apa/biblatex-apa-test.tex | 8 ++- .../doc/latex/biblatex-apa/biblatex-apa.pdf | Bin 68331 -> 70755 bytes .../doc/latex/biblatex-apa/biblatex-apa.tex | 56 ++++++++++++++++++--- 7 files changed, 86 insertions(+), 12 deletions(-) (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/README b/Master/texmf-dist/doc/latex/biblatex-apa/README index 41861efb437..acd4d0fecc5 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.2 +Version 4.3 Permission is granted to copy, distribute and/or modify this software under the terms of the LaTeX Project Public License, version 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 8460d484669..6891dc775e1 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 @@ -164,7 +164,7 @@ @BOOK{6.16e, AUTHOR = {A. Gogel}, TITLE = {Title3}, - YEAR = {in press}, + PUBSTATE = {inpress}, } @BOOK{6.16f, @@ -182,7 +182,7 @@ @BOOK{6.16h, AUTHOR = {A. Derryberry and B. Reed}, TITLE = {Title3}, - YEAR = {in press}, + PUBSTATE = {inpress}, } @BOOK{6.16i, @@ -227,6 +227,27 @@ YEAR = {2007}, } +% PUBSTATE is not used as there is a year +@BOOK{6.16p, + AUTHOR = {Steven Smidge}, + TITLE = {Something 1}, + YEAR = {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}, 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 a59583e5d12..df76978ca76 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 @@ -57,19 +57,21 @@ } % (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 and Practice}, YEAR = {2007}, - PUBSTATE = {Advance online publication}, + NOTE = {Advance online publication}, DOI = {10.1057/palgrave.kmrp.8500141} } % (APA 7.01 Example 6) @ARTICLE{7.01:6, AUTHOR = {R. Briscoe}, - YEAR = {in press}, + PUBSTATE = {inpress}, TITLE = {Egocentric Spatial Representation in Action and Perception}, JOURNALTITLE = {Philosophy and Phenomenological Research}, URL = {http://cogprints.org/5780/1/ECSRAP.F07.pdf} @@ -1012,3 +1014,4 @@ ORGANIZATION = {Twin Cities Habitat for Humanity website}, URLDATE = {2012} } + 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 1425f667863..e7400b0b65c 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf and b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf 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 ca38f3f3602..b46be700160 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 @@ -114,7 +114,9 @@ this (see APA 6.11). \noindent Automatic list disambiguation for ambiguous truncations after first cite\footnote{This feature is fairly deep magic and only works when using - biblatex 1.4+ together with biber 0.9+}:\\ + biblatex 1.4+ together with biber 0.9+}. 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}}\\ @@ -231,6 +233,10 @@ Two or more works withing the same parentheses:\\ \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}} 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 aeb3c12f35a..bd6a588859f 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf and b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf 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 7acd14d3d16..3709d7bee45 100644 --- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex +++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex @@ -3,6 +3,7 @@ \usepackage[strict]{csquotes} \usepackage{shortvrb} \usepackage{ifthen} +\usepackage{listings} \usepackage{metalogo} \MakeAutoQuote{«}{»} \MakeShortVerb{\|} @@ -24,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.2}, + revision={4.3}, date={\today}} \hypersetup{% @@ -38,8 +39,32 @@ \printtitlepage \tableofcontents -\section{Introduction} -\label{int} +\section{Important Changes}\label{special} + +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{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} @@ -62,7 +87,7 @@ APA Style Guide (6th Edition). 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---see examples doc} without the + 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» @@ -238,6 +263,11 @@ accompanying \path{.bib} files: \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 @@ -267,7 +297,7 @@ since the |sortcites| biblatex option is a package-level option. If you want to customise such a fake references section «citation», you should probably be using |\printbibliography| with a filter. -\subsection{References} +\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 @@ -278,6 +308,11 @@ 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 The |\maxprtauth| commands returns the number of author/editor names which are printed. APA style defaults to 7. You can reset this after loading biblatex with, for example, @@ -309,10 +344,19 @@ general notes: model limtations. \end{itemize} -\section{Revision history} +\section{Revision history}\label{rev} \begin{changelog} +\begin{release}{4.3}{2012-01-21} +\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 + (Requires |biber| $\geq$ 0.9.9 to fully support disambiguation of «in + press» items by the same author) +\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} -- cgit v1.2.3