summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-apa
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-01-23 23:08:57 +0000
committerKarl Berry <karl@freefriends.org>2012-01-23 23:08:57 +0000
commitfde9f1341f8b60d9193c41e45d1a5a43868f1757 (patch)
tree0df0d096c845dda13d863191b31c3385a6582d78 /Master/texmf-dist/doc/latex/biblatex-apa
parentbe9b9d7b5b951b901de6fe3252a27fcd11d9557b (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/README2
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-citations.bib25
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test-references.bib7
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.pdfbin98217 -> 97176 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex8
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.pdfbin68331 -> 70755 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex56
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
index 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
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 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
--- 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 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}