summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex
Initial commit
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.tex870
1 files changed, 870 insertions, 0 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
new file mode 100644
index 0000000000..c8cd5abba3
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-apa/biblatex-apa.tex
@@ -0,0 +1,870 @@
+\documentclass{ltxdockit}
+\usepackage[british]{babel}
+\usepackage[strict]{csquotes}
+\usepackage{shortvrb}
+\usepackage{ifthen}
+\usepackage{listings}
+\usepackage{metalogo}
+\MakeAutoQuote{«}{»}
+\MakeShortVerb{\|}
+
+% Unicode
+\usepackage{fontspec}
+\setmainfont[Ligatures=TeX]{TeXGyrePagella}
+\setsansfont[Ligatures=TeX]{TexGyreHeros}
+\setmonofont[Ligatures=NoCommon]{TeXGyreCursor}
+
+\newcommand\apa[2][]{\ifthenelse{\equal{#1}{}}%
+ {\texttt{(APA #2)}}%
+ {\texttt{(APA #2 Example #1)}}}
+
+\titlepage{%
+ title={APA Bib\LaTeX\ style},
+ subtitle={Citation and References macros for Bib\LaTeX},
+ url={http://mirror.ctan.org/macros/latex/exptl/biblatex-contrib/biblatex-apa/},
+ author={Philip Kime},
+ email={Philip@kime.org.uk},
+ revision={7.8},
+ date={\today}}
+
+\hypersetup{%
+ pdftitle={APA Bib\LaTeX\ style},
+ pdfsubject={APA 6 Conformant Style for Bib\LaTeX},
+ pdfauthor={Philip Kime},
+ pdfkeywords={latex, biblatex, APA, style}}
+
+\begin{document}
+
+\printtitlepage
+\tableofcontents
+
+\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{7.8}
+|ARTICLE| entries now correctly do not print month/day in the bibliography
+as per APA 6.28. For non-academic articles (APA 7.01, examples 7, 8 and 9),
+use the new:
+
+\begin{verbatim}
+ ENTRYSUBTYPE = {nonacademic}
+\end{verbatim}
+
+This will allow month/day data in the bibliography. In the future, there
+may be other differences for |ARTICLE| subtypes and it is better to keep
+these semantically distinct from standard academic journal articles.
+
+\minisec{7.5}
+This version requires |biblatex| $>=$3.8 and |biber| $>=$2.8.
+
+\minisec{7.1}
+This version requires |biblatex| $>=$3.6 and |biber| $>=$2.6.
+
+\minisec{7.0}
+This version requires |biblatex| $>=$3.5 and |biber| $>=$2.6. Uncertain,
+approximate and era-marked dates are now supported in the |biblatex| core
+and therefore special fields are no longer needed in the style. See example
+files, in particular \texttt{7.10:67} entry in the references test
+\file{.bib} and the \texttt{plato} entry in the citation test \file{.bib}.
+
+\minisec{7.0}
+This version requires |biblatex| $>=$3.5 and |biber| $>=$2.6.
+
+\minisec{6.9}
+This version requires |biblatex| $>=$3.4 and |biber| $>=$2.5.
+
+\minisec{6.8}
+This version requires |biblatex| $>=$3.3 and |biber| $>=$2.4.
+
+\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
+away in |biblatex| eventually anyway so it's best to switch.
+
+\minisec{4.4}
+The |\maxprtauth| command is now a package option called
+«apamaxprtauth», see section \ref{opts}.
+
+\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}
+
+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
+(\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
+APA Style Guide (6th Edition).
+
+\subsection{Requirements}\label{ref:req}
+
+You will need to be using \sty{csquotes} ($\geq$ 4.3), Bib\LaTeX\ ($\geq$
+3.4) and Biber ($\geq$ 2.5). 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
+as per the |apa.cls| documentation. Without this class option, the
+|apa.cls| class will automatically try to use plain Bib\TeX\ with the
+|apacite| style which is completely incompatible with Bib\LaTeX.
+
+\subsection{License}
+
+Permission is granted to copy, distribute and/or modify this software under
+the terms of the \latex Project Public License, version
+1.3c\footnote{\url{http://www.latex-project.org/lppl.txt}}. The current
+maintainer is Philip Kime (\textcopyright\ 2015).
+
+\subsection{History}
+
+When I started using Bib\LaTeX, I assumed there would be an APA style
+when I went looking. I was wrong. I started to try to make one and realised
+why there was none. The APA style manual is enormous; the citation and
+references specifications run to about 60 pages and are very specific in
+terms of formatting. They are also not entirely consistent but then again,
+it is rare to have such a thorough specification to work from.
+Inconsistencies in the manual and workarounds are noted in the examples
+document.
+
+\subsection{Acknowledgments}
+
+Thanks to Philipp Lehman for Bib\LaTeX\ which really has been a major
+advance over pure Bib\TeX. Thanks to Alexander van Loon for the Dutch
+localisation. Thanks to Paul Thompson for the suggestion to
+parameterise the max authors setting. Thanks to George Gkotsis for the
+Greek localisation. Thanks to Erikson Kaszubowski for the Brazilian
+localisation. Thanks to Braulio José Solano Rojas for the Spanish
+localisation. Thanks to Stefan Mayer for the |subtitlepunct| suggestion.
+Thanks to Håkon Malmedal for the Norwegian localisation. Thanks to
+Johann Gründl for the Austrian localisation. Thanks to Svante Kvarnström
+for the Swedish localisation. Thanks to Hendrik Maryns for further Dutch
+localisation. Thanks to Tea Tušar and Bogdan Filipič for the Slovenian
+localisation. Thanks to Sebastian Ørsted for the Danish localisation.
+Thanks to Jürgen Spitzmüller for the DGPs localisation hints. Thanks to
+Sergei Golovan for the Russian localisation.
+
+\section{Use}\label{ref:use}
+\label{use}
+This package is available via \TeX Live as |biblatex-apa|. You can find it
+through the provided \TeX Live update utilities which will install it
+automatically for you. If you need to install manually (to use a new
+version which has not yet been published to the \TeX Live updaters, for
+example), you can download it from CTAN and then, put the \path{.cbx},
+\path{.bbx} and \path{.lbx} files in your texmf tree, usually:\\
+
+\noindent\path{<texmf>/tex/latex/biblatex/cbx/apa.cbx}\\
+\path{<texmf>/tex/latex/biblatex/bbx/apa.bbx}\\
+\path{<texmf>/tex/latex/biblatex/lbx/<language>-apa.lbx}\\
+
+\noindent Specify the style in the usual way when loading Bib\LaTeX. If you
+are using \sty{babel}:
+
+\begin{ltxcode}
+\usepackage[american]{babel}
+\usepackage{csquotes}
+\usepackage[style=apa]{biblatex}
+\end{ltxcode}
+
+or \sty{polyglossia}:
+
+\begin{ltxcode}
+\usepackage{polyglossia}
+\setdefaultlanguage[variant=american]{english}
+\usepackage{csquotes}
+\usepackage[style=apa]{biblatex}
+\end{ltxcode}
+
+\noindent Note that the APA manual requires the forcing of titles into
+«sentence case», that is, initial cap followed by lower case for sentence
+units, with the exception of names and material from languages which do not
+follow English capitalisation. As of version 0.8a, Bib\LaTeX\ has a
+|\MakeSentenceCase| macro which deals with this. So, in the traditional
+Bib\TeX\ way, capitalise correctly in the |.bib| file, protecting names etc.
+with the usual brace pairs and the style will take care of forcing the
+APA-style sentence case in the References section. Unlike the References
+section, titles in citations in the APA style appear in normal case and the
+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}% | stupid comment to stop emacs highlighting as verb due
+ % to single pipe
+
+\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}
+
+\noindent This option controls the number of author/editor names which are
+printed in the References. APA style defaults to 7. 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 8 \ldots)
+
+Setting Bib\LaTeX package options which change name processing
+like \opt{uniquename} and \opt{uniquelist} is not supported as this style
+does tricky things internally to match the peculiar APA standard. You
+should not need to change them anyway as then you wouldn't be using APA
+style anyway.
+
+\subsection{Localisation}
+
+Localisation is provided for APA-specific strings in the accompanying
+|.lbx| files which are loaded automatically.
+
+Normal use will invoke \sty{babel} with the «american» language or
+\sty{polyglossia} with «american» variant of «english».
+
+The \file{english-apa.lbx} is a copy of the \file{american-apa.lbx} since
+the default is «American» English.
+
+The APA manual does not mention nor sanction any non «American» English
+strings but it is quite common for non-English journals to ask for APA style
+bibliographies and so this must be supported.
+
+If not using the \sty{babel} «american» option, it may be necessary to set up
+the |\DeclareQuotePunctuation| option as mentioned in section \ref{ref:req}
+above. You would only need to do this if, for some strange reason, a
+non-american journal required the (unpleasant) american practice of moving
+final punctuation marks inside closing quotes.
+
+\subsubsection{Date formats}
+
+Obviously, an American style uses month/day/year formats. European formats
+are usually day/month/year. The APA style dictates long date formats and so
+this is not really apparent in the bibliography. There is an APA standard
+for long date formats which may not be correct for European journals using
+roughly APA formatting standards (German journals tend to have a different
+long date format, for example). The «american» babel option will give you
+APA compliant US date formats. Default sensible date formats are included
+for german, ngerman and french. You should redefine the |\mkbibdatelong|
+macro in the relevant language |*-apa.lbx| file to change this if needed.
+
+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
+accompanying \path{.bib} files:
+\begin{description}
+\item[\path{biblatex-apa.tex}] This document.
+\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 just about every useful example from
+ \apa{6.11}--\apa{6.21} and \apa{7.01}--\apa{7.11}. 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}
+ entries for the citations examples. You won't find anything of interest
+ 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{7.x}. 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{7.x}, look it up in here. Every example is marked with
+ the APA example number and has explanatory notes.
+\item[\path{apa.cbx}] The |biblatex-apa| citations style. It is
+ decently structured with comments but shouldn't need to be read for
+ normal use.
+\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}
+
+\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
+requires knowledge of the current typesetting state. So, the new citation
+command
+
+\begin{ltxsyntax}
+\cmditem{nptextcite}[prenote][postnote]{key}<punctuation>
+\end{ltxsyntax}
+
+\noindent is provided for such situations. It is identical to |\textcite|
+but does not put parentheses around the year and separates items with
+commas. See examples using this command in \path{biblatex-apa-test.tex}.
+There is also a multi-cite version |\nptextcites| that works in the same
+way as |\textcites|.
+
+The |\fullcite| command uses ampersands, like the references section
+and there is also a |\fullcitebib| command which is the same as
+|\fullcite| but which fakes a mini references section with APA style
+indentation and so is not intended to be used inline like
+|\fullcite|. See examples in the test file.
+
+\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
+example references |.bib| as it is commented and you can learn a lot from
+the examples by picking something close to what you need from the APA
+examples and then looking in this file to see how it was implemented. Some
+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 APA style sometimes refers to the «series» of a multi-volume work.
+ This corresponds to the |MAINTITLE| field in the \file{.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}.
+\end{itemize}
+
+\subsubsection{Journal number for journals with per-issue pagination}
+As per APA 6th edition section 6.30 and 7.01, journals which paginate by
+issue need the volume number including in the reference section. Since
+there is no way to automatically determine when this is the case, use the
+|biber| sourcemap feature to implement this, removing the |NUMBER| field
+from journals known to implement continuous pagination across volumes. For
+example, with this in your preamble:
+
+\begin{lstlisting}[style=latex]{}
+\DeclareSourcemap{
+ \maps[datatype=bibtex]{
+ \map{
+ \step[fieldsource=journaltitle,
+ match=\regexp{(?:journal\stitle\sone|journal\stitle\stwo)}]
+ \step[fieldset=number, null]
+ }
+ }
+}
+\end{lstlisting}
+%
+Simply include |NUMBER| fields for all journals and entries with
+|JOURNALTITLE| of «journal title one» or «journal title two» (which
+are known to paginate across all numbers of a volume) will have
+their |NUMBER| field dynamically removed at document compile time, as
+required.
+
+\subsubsection{Retrieval dates for online items}
+
+APA 6th edition section 6.32 says «Do not include retrieval dates unless
+the source material may change over time (e.g., Wikis)». This is open to
+interpretation of what constitutes a Wiki and what counts as «changing over
+time». The style does not implement anything for this requirement by
+default but you can automate your own interpretation by putting this in
+your preamble:
+
+\begin{lstlisting}[style=latex]{}
+\DeclareSourcemap{
+ \maps[datatype=bibtex]{
+ \map{
+ \step[fieldsource=url,
+ notmatch=\regexp{wiki},
+ final=1]
+ \step[fieldset=urldate, null]
+ }
+ }
+}
+\end{lstlisting}
+
+\noindent This will dynamically remove the |URLDATE| field from any entry
+where the |URL| field doesn't match the regular expression «wiki». Modify this
+regular expression according to taste. This modification is dynamically
+applied to the data stream by |biber| and does not change your \file{.bib}.
+
+\section{Revision history}\label{rev}
+
+\begin{changelog}
+
+\begin{release}{7.8}{2019}
+\item Fixed date rules for |ARTICLE|s
+\end{release}
+
+\begin{release}{7.7}{2018-04-02}
+\item Bug fixes and example alignments
+\end{release}
+
+\begin{release}{7.6}{2018-03-05}
+\item Internal cleanup and bugfixes
+\end{release}
+
+\begin{release}{7.5}{2017-11-05}
+\item Compat for bibaltex 3.8
+\item |\DeclareLanguageMapping| is now no longer necessary due to the new
+ |\DeclareLanguageMappingSuffix| macro.
+\end{release}
+
+\begin{release}{7.4}{2017-01-06}
+\item Minor bugfix release
+\end{release}
+
+\begin{release}{7.3}{2016-12-21}
+\item Minor bugfix release
+\end{release}
+
+\begin{release}{7.2}{2016-10-24}
+\item Minor bugfix release for date fields
+\end{release}
+
+\begin{release}{7.1}{2016-09-15}
+\item Minor bugfix release for legacy YEAR fields and |inpress| strings
+\item Requires |biblatex| 3.6+ and biber 2.6+
+\end{release}
+
+\begin{release}{7.0}{2016-09-14}
+\item Added \cmd{urldatacomma}
+\item Now following DGPs guidelines for some formatting in Germanic
+ locales.
+\item Requires |biblatex| 3.5+ and biber 2.6+
+\end{release}
+
+\begin{release}{6.9}{2016-05-13}
+\item Bug fixes
+\item Requires |biblatex| 3.4+ and biber 2.5+
+\end{release}
+
+\begin{release}{6.8}{2016-03-01}
+\item Bug fixes
+\item Updated to use new \cmd{DeclareNameFormat} structure for |biblatex|
+ 3.3+ (which is now required)
+\end{release}
+
+\begin{release}{6.7}{2015-01-23}
+\item Bug fixes
+\end{release}
+
+\begin{release}{6.6}{2014-10-23}
+\item Bug fixes
+\end{release}
+
+\begin{release}{6.5}{2014-04-16}
+\item Bug fixes
+\item Slovenian localisation
+\end{release}
+
+\begin{release}{6.4}{2013-10-30}
+\item Fixed explicit «and others» problem
+\item Improved french localisation
+\end{release}
+
+\begin{release}{6.3}{2013-10-28}
+\item Fixed issue where |SHORTAUTHOR| was only being used for exact same citations.
+\end{release}
+
+\begin{release}{6.2}{2013-10-19}
+\item Corrected Dutch translations
+\item Fixed Norwegian lbx corruption
+\item Misc bugfixes
+\end{release}
+
+\begin{release}{6.1}{2013-07-19}
+\item Corrected APA 6.12 error and switched to uniquelist=minyear
+\item Documented way of automating some APA 6.32 requirements
+\end{release}
+
+\begin{release}{6.0}{2013-07-10}
+\item Added Swedish localisation
+\item Fixed useprefix=false issue
+\end{release}
+
+\begin{release}{5.9}{2013-05-08}
+\item Compatibility with |biblatex| 2.6--«nodate» is now part of core
+\item autocite is set to inline
+\end{release}
+
+\begin{release}{5.8}{2013-03-07}
+\item Made BOOK like INBOOK for order of online/reprint information
+\item Fixes for recursive RELATED fields
+\end{release}
+
+\begin{release}{5.7}{2012-12-28}
+\item New name code to allow full name disambiguation as per APA 6.27
+\item Fixes to IN* types
+\end{release}
+
+\begin{release}{5.6}{2012-12-19}
+\item Fixed problems with EVENTDATE format
+\end{release}
+
+\begin{release}{5.5}{2012-12-17}
+\item Fixed serial comma requirement (APA 4.03)
+\end{release}
+
+\begin{release}{5.4}{2012-11-28}
+\item Updated for |biblatex| 2.4
+\end{release}
+
+\begin{release}{5.3}{2012-11-21}
+\item Updated for some |biblatex| changes.
+\end{release}
+
+\begin{release}{5.2}{2012-09-30}
+\item Entries with no YEAR no longer fall back on other date fields
+ and use «nodate» bibstring.
+\item «nodate» bibstring no longer lowercased and supports extrayear
+\end{release}
+
+\begin{release}{5.1}{2012-08-01}
+\item Added Norwegian localisation (thanks to Håkon Malmedal)
+\item Fixed some documentation issues
+\end{release}
+
+\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
+ George Pigman)
+\end{release}
+
+\begin{release}{4.6}{2012-02-08}
+\item Reduced the Biber requirement to a warning due to bug in |biblatex| 1.7
+\item Added Italian localisation (thanks to Luca Montanelli)
+\end{release}
+
+\begin{release}{4.5}{2012-01-31}
+\item Noted in manual that |biber| is now required due to custom sorting.
+\item Added |INSTITUTION| field to |REPORT| entries
+\end{release}
+
+\begin{release}{4.4}{2012-01-25}
+\item |\maxprtauth| command is now a package option «apamaxprtauth»
+\item New package option «apabackref» controlling whether
+ backreferences and links to citations appear in the References.
+\end{release}
+
+\begin{release}{4.3}{2012-01-22}
+\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
+\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}
+
+\begin{release}{4.1}{2011-11-02}
+\item |subtitlepunct| now skips if following terminating punctuation
+\end{release}
+
+\begin{release}{4.0}{2011-10-05}
+\item Disabled «smart and» for spanish localisation as it breaks ampersands
+\end{release}
+
+\begin{release}{3.9}{2011-10-03}
+\item Fixed data format issue in localisations
+\end{release}
+
+\begin{release}{3.8}{2011-09-25}
+\item Fixed slanted/italic confusion in bibliography
+\end{release}
+
+\begin{release}{3.7}{2011-09-23}
+\item Fixed issue no dates when labelyear defined
+\end{release}
+
+\begin{release}{3.6}{2011-09-20}
+\item Fixed issue with American format long dates
+\end{release}
+
+\begin{release}{3.5}{2011-09-05}
+\item Fixed issue Editor name part order when in Author position (thanks to
+ Johann Bauer)
+\end{release}
+
+\begin{release}{3.4}{2011-09-01}
+\item Fixed issue with |\fullcite| not resetting |bbx| globals
+\end{release}
+
+\begin{release}{3.3}{2011-08-23}
+\item Spanish localisation
+\end{release}
+
+\begin{release}{3.2}{2011-08-12}
+\item Minor fix in |inbook| format
+\item Doc clean up
+\end{release}
+
+\begin{release}{3.1}{2011-07-31}
+\item Made compatible with Bib\LaTeX\ 1.6
+\end{release}
+
+\begin{release}{3.0}{2011-05-06}
+\item |maxnames| and |minnames| are now set to sensible things and actually
+ used. Biber $\geq$ 0.9.3 is now required as this implements a fix for
+ |uniquelist| in Bib\LaTeX\ which needs |maxnames| and |minnames| set to
+ real values.
+\item Fixed bug with commas before «et al» not appearing in some cases.
+\end{release}
+
+\begin{release}{2.9}{2011-05-03}
+\item APA wants no space between volume and number for articles, even though it's
+ horribly ugly\ldots
+\item Made urls not optional with Bib\LaTeX\ url toggle in |ONLINE| entrytype (thanks to Mattias Erll)
+\end{release}
+
+\begin{release}{2.8}{2011-04-23}
+\item Added a Greek localisation strings file.
+\end{release}
+
+\begin{release}{2.7}{2011-04-1}
+\item Biber is now a strongly recommended requirement due to APA name and
+ name list disambiguation requirements.
+\item Updated for Bib\LaTeX\ 1.4/Biber 0.9 with automatic list
+ disambiguation. Package now deals with all APA 6th Edition citation examples.
+\end{release}
+
+\begin{release}{2.6}{2011-03-15}
+\item Made fullcite use ampersand
+\item Added fullcitebib macro to allow fake bib citations
+\end{release}
+
+\begin{release}{2.5}{2010-11-24}
+\item Refactored hyperref to only link from years to make it
+ consistent across cite commands
+\item Added hyperref target references section for citation examples
+\item Fixed textcite multicite issue
+\end{release}
+
+\begin{release}{2.4}{2010-11-14}
+\item Fixed postnotes/hyperref for textcite
+\end{release}
+
+\begin{release}{2.3}{2010-11-04}
+\item Overhauled hyperref functionality and made more robust
+\end{release}
+
+\begin{release}{2.2}{2010-10-15}
+\item Parameterised max author/editor list (thanks to Paul Thompson)
+\item Better rudimentary regression script
+\item Completely reconfigured EPRINT/EPRINTTYPE
+\end{release}
+
+\begin{release}{2.1}{2010-10-17}
+\item New Dutch localisation (thanks to Alexander van Loon)
+\end{release}
+
+\begin{release}{2.0}{2010-09-30}
+\item Moved to new date format code internally
+\end{release}
+
+\begin{release}{1.9}{2010-09-27}
+\item Moved docs to LuaLaTeX compat
+\item Fixed german/ngerman date formats
+\item Cleaned up date format code
+\end{release}
+
+\begin{release}{1.8}{2010-08-06}
+\item Fixed seven author ellipsis bug
+\end{release}
+
+\begin{release}{1.7}{2010-08-05}
+\item Corrected dateless entry format, added examples to test doc
+\item Corrected multi delim for |\citeyear|
+\item Updated test doc for Bib\LaTeX\ 0.9b compat
+\end{release}
+
+\begin{release}{1.6}{2010-07-19}
+\item Added correct |\citeyear| definition
+\end{release}
+
+\begin{release}{1.5}{2010-07-12}
+\item Corrected |NOTE/ADDENDUM| examples
+\item Made |\nptextcite| behave more consistently like |\textcite| for multi-cites.
+\end{release}
+
+\begin{release}{1.4}{2010-07-07}
+\item Removed extra space after DOI
+\end{release}
+
+\begin{release}{1.3}{2010-07-05}
+\item Fixed Oxford comma bug
+\end{release}
+
+\begin{release}{1.2}{2010-06-18}
+\item Made style arguments more explicit in |.bbx|
+\item Fixed bad documentation due to beta Bib\LaTeX\ version.
+\item Updated docs - minimum Bib\LaTeX\ version
+\end{release}
+
+\begin{release}{1.1}{2010-05-28}
+\item Fixed |INBOOK| |citetitle| format to match |BOOK|.
+\item Fixed |extrayear| in entries with full date specifications.
+\end{release}
+
+\begin{release}{1.0}{2010-05-12}
+\item Fixed |TYPE| and |NUMBER| fields in |REPORT| entries. Now more
+ flexible.
+\item |PUBSTATE| is now valid for articles.
+\item |DOI|, if present, suppresses any |URL| field.
+\item Abstract retrieval string is now conditional on |USERB| field, not on
+ the existence of an abstract.
+\item Default strings for |PHDTHESIS| and |MASTERSTHESIS| entries corrected.
+\item |LOCATION| is now valid for thesis entries and comes after |INSTITUTION|.
+\end{release}
+
+\begin{release}{0.9}{2010-03-08}
+\item Update for APA manual 6th edition and Bib\LaTeX\ 0.9
+\end{release}
+
+\begin{release}{0.8}{2010-02-15}
+\item Fixed bug with spaces after nptextcite
+\item Updated for Bib\LaTeX\ 0.9
+\end{release}
+
+\begin{release}{0.7}{2010-01-20}
+\item Made hyperref links more consistent, using the whole citation and not
+ just the year.
+\end{release}
+
+\begin{release}{0.6}{2009-11-20}
+\item Corrected two bugs in |cite| macro which left a trailing space after
+ multiple cites and actually cited the year twice for multiple cite
+ commands in some circumstances.
+\item Corrected bug where |\textcite| would leave a stray open bracket on
+ the stack when year was suppressed within a paragraph.
+\end{release}
+
+\begin{release}{0.5}{2009-09-19}
+\item Replaced literal string with localised form in url macro.
+\item Moved localisation strings into \sty{.lbx} files.
+\item |\DeclareLanguageMapping| is now needed in preamble.
+\item Moved |\DeclareBibliographyExtras| into \sty{.lbx} files.
+\item Some support for alternative localised date formats.
+\item Fixed slant/italic font problem since the |\mkbibemph| macro had
+ changed in Bib\LaTeX\ 0.8e.
+\item Fixed |liststop| error which was preventing name lists with two
+ entries from having the comma before the ampersand.
+\end{release}
+
+\begin{release}{0.4}{2009-07-24}
+\item Fixed bug where multiple year ranges were not displayed properly.
+\item Updated to remove pre-Bib\LaTeX\ 0.8e macros error.
+\end{release}
+
+\begin{release}{0.3}{2008-12-21}
+\item Updated to use new fields (|EVENTTITLE|) and new options
+ (|usetranslator|) from Bib\LaTeX\ 0.8b.
+\end{release}
+
+\begin{release}{0.2}{2008-12-06}
+\item Added |noremoteinfo| option).
+\item Fixed bbx bug with more than 7 authors still printing names after «et al». Was
+ due to resetting maxnames to 999.
+\item Removed the customised (hacked) |apa-biblatex.cls| class from the package as
+ |apa.cls| version 1.3.4 is compatible with Bib\LaTeX\.
+\item Altered documentation about requiring the «american» babel option.
+ This is not required if you set up |\DeclareQuotePunctuation| yourself.
+\item Added minimum required version of \sty{csquotes}.
+\item Minor doc tweaks.
+\end{release}
+
+\begin{release}{0.1}{2008-12-01}
+\item Initial release
+\end{release}
+
+
+
+\end{changelog}
+\end{document}
+
+% Local Variables:
+% TeX-engine: luatex
+% End: