summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-11-27 03:01:12 +0000
committerNorbert Preining <norbert@preining.info>2019-11-27 03:01:12 +0000
commit5142daa13e19b32afa064863e039da3afaf06e83 (patch)
treed8299dbf426b9b0e6cafacc4cbe5a6a762bf28a9 /macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex
parentbd1c54bb99e58d8c140acb0b0a536037f96349b4 (diff)
CTAN sync 201911270301
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex68
1 files changed, 37 insertions, 31 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex b/macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex
index 5202c2f914..eb9b13c115 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex
@@ -24,7 +24,7 @@
url={http://mirror.ctan.org/macros/latex/exptl/biblatex-contrib/biblatex-apa/},
author={Philip Kime},
email={Philip@kime.org.uk},
- revision={9.0},
+ revision={9.1},
date={\today}}
\hypersetup{%
@@ -67,14 +67,17 @@ your language, they are generally marked with ``\texttt{\%FIXME}``.
\subsection{About}
This package is a Bib\LaTeX\ style for APA (American Psychological
-Association) style compliant documents typeset in \latex. It implements a
-citation style (\file{apa.cbx}), a references section style
+Association) 7th Edition style compliant documents typeset in \latex. It
+implements a 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}). The style is loaded just
like any other Bib\LaTeX\ styles but don't try to use the citation and
references styles separately as they rely on each other, macro-wise, in
places.
+Please see the package |biblatex-apa6| on CTAN for the APA 6th edition
+conformant version of this style.
+
In general, there is no attempt to generalise this style for non-APA
requirements--it is written for APA compliance only. Having said that,
there are a few options which allow users to change the APA defaults.
@@ -179,18 +182,6 @@ style will ensure this too.
\subsection{Package options}\label{opts}
-The following options are set as usual in the options passed to
-|biblatex|.
-
-\begin{ltxcode}
-apabackref=true|false
-\end{ltxcode}%|
-
-\noindent It is not APA style to include backreferences in the References to
-pages where citations of the entry occur. However, this is very
-useful, especially in proofing and so if you set the |apabackref|
-option to «true», these are enabled. The default is «false».
-
\begin{ltxcode}
apamaxprtauth=<num>
\end{ltxcode}
@@ -198,7 +189,7 @@ apamaxprtauth=<num>
\noindent This option controls the number of author/editor names which are
printed in the References. APA style defaults to 20. You can change this if
you really want to fully print all author list references in certain
-contexts (for example in a CV where you are an author in position 21 \ldots)
+contexts (for example in a CV where you are an author in position 21 \ldots).
\subsection{Localisation}
@@ -237,17 +228,6 @@ A customisable macro \cmd{urldatecomma} determines what comes between the
date of a URL and the URL itself. This defaults to the standard comma and
space as per APA style but just a space in germanic localisations.
-\subsection{Limitations}
-\label{use:limit}
-There are certain limitations you need to bear in mind when using these
-styles. The APA manual is written without much regard for automation of
-citation and references processing---it just tells you how it wants things to
-look and the implicit assumption is that you would type out everything by
-hand if necessary. Having said that, the majority of the APA citation
-and references style is implemented, there are just a few exceptions which
-are hardly worth the coding pain since they are ambiguous and easily worked
-around.
-
\section{Details}
The detailed information for this style is contained in the example document and
@@ -257,7 +237,7 @@ accompanying \path{.bib} files:
\item[\path{biblatex-apa-test.tex}]\footnote{\path{biblatex-apa-test.pdf}
is also provided and is the typeset version of this \latex source
file.} This document typesets every useful example from
- \apa{8}--\apa{10}. The examples in it aim to look as much like the APA
+ \apa{8--10}. The examples in it aim to look as much like the APA
manual examples as possible. All citation examples in the document are
real examples using a \path{.bib} file.
\item[\path{biblatex-apa-test-citations.bib}] This contains the \path{.bib}
@@ -265,10 +245,10 @@ accompanying \path{.bib} files:
in this file---it's just used to provide real data for the citation
examples.
\item[\path{biblatex-apa-test-references.bib}] This contains the
- \path{.bib} entries for all of the examples in \apa{9} and \apa{10}. This
+ \path{.bib} entries for all of the examples in \apa{9--11}. This
file is the main documentation for the |biblatex-apa| implementation of
the APA References section style. To see how the style deals with a
- particular example from \apa{9} or \apa{10}, look it up in here. Every
+ particular example from \apa{9--11}, look it up in here. Every
example is marked with the APA example number and has explanatory notes
where necessary.
\item[\path{apa.cbx}] The |biblatex-apa| citations style. It is
@@ -388,11 +368,37 @@ because date formatting differs in the style between academic and
non-academic articles. This is a more general solution than introducing new
entry types which are not supported by other software.
+\subsubsection{Legal Entry Types}
+
+\apa{11} contains the format guidelines for legal references. This is fully
+implemented and the |biblatex-apa-test-references.bib| demonstrates which
+entry types and fields are used to produce the \apa{11} examples. There are
+some custom entry types and fields used to manage this, as you will see in
+the |.bib| file. Considerable use is made of localisation strings in legal
+entries due to the requirements that certain strings change their
+abbreviation status between citations and references (and even between
+parenthetical and narrative citations).
+
+The localisation strings for the U.S. specific elements of this section
+(most of it) are not provided in other languages as there is not much
+point. Feel free to copy them from |american-apa.lbx| if you really need
+to. Localisation strings for all 50 U.S. States are provided to support
+state constitution references.
+
+Pay attention to the |JURISDICTION| entries in the example |.bib| which use
+|biber|'s data annotation feature in order to match the required style
+elements. The names of the data annotations are not optional and must match
+the examples.
+
\section{Revision history}\label{rev}
\begin{changelog}
-\begin{release}{9.0}{2019-}
+\begin{release}{9.1}{2019-11-27}
+\item Bug fixes, internal improvements and implementation of \apa{11}.
+\end{release}
+
+\begin{release}{9.0}{2019-11-23}
\item First release (of APA 7th edition style)
\end{release}