diff options
author | Karl Berry <karl@freefriends.org> | 2012-01-23 23:08:57 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-01-23 23:08:57 +0000 |
commit | fde9f1341f8b60d9193c41e45d1a5a43868f1757 (patch) | |
tree | 0df0d096c845dda13d863191b31c3385a6582d78 /Master/texmf-dist/doc/latex/biblatex-apa | |
parent | be9b9d7b5b951b901de6fe3252a27fcd11d9557b (diff) |
biblatex-apa (23jan12)
git-svn-id: svn://tug.org/texlive/trunk@25183 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/README | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-citations.bib | 25 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib | 7 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdf | bin | 98217 -> 97176 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex | 8 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdf | bin | 68331 -> 70755 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex | 56 |
7 files changed, 86 insertions, 12 deletions
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 Binary files differindex 1425f667863..e7400b0b65c 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 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 Binary files differindex aeb3c12f35a..bd6a588859f 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 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} |