summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-apa6/biblatex-apa6.tex
blob: a197a6cfd45b4c4f7dd536e1d29cdb3aa3381511 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
\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 6th Edition 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={8.5},
  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}

\textbf{This is a legacy style for a previous edition of the APA guidelines. The
latest version is always on CTAN with the name |biblatex-apa|}.\\[2ex]

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) 6th 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}). 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. Thanks to Vítor Míguez for the
Galacian 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/apa6.cbx}\\
\path{<texmf>/tex/latex/biblatex/bbx/apa6.bbx}\\
\path{<texmf>/tex/latex/biblatex/lbx/<language>-apa6.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=apa6]{biblatex}
\end{ltxcode}

or \sty{polyglossia}:

\begin{ltxcode}
\usepackage{polyglossia}
\setdefaultlanguage[variant=american]{english}
\usepackage{csquotes}
\usepackage[style=apa6]{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}
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-apa6.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 |*-apa6.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-apa6.tex}] This document.
\item[\path{biblatex-apa6-test.tex}]\footnote{\path{biblatex-apa6-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-apa6-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-apa6-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{apa6.cbx}] The |biblatex-apa| citations style. It is
  decently structured with comments but shouldn't need to be read for
  normal use.
\item[\path{apa6.bbx}] The |biblatex-apa| references style. It is
  decently structured with comments but shouldn't need to be read for
  normal use.
\item[\path{apa6.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-apa6-test-references.bib}.
\item[\path{*-apa6.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-apa6-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}{8.5}{2020-08-28}
\item Misc bug fixes, compat with biblatex 3.15
\end{release}

\begin{release}{8.4}{2020-05-03}
\item Misc bug fixes
\end{release}

\begin{release}{8.3}{2019-12-02}
\item Misc bug fixes
\end{release}

  \begin{release}{8.2}{2019-12-01}
\item Removed |apabackref| option, use the standard
  |biblatex| |backref| option instead
\end{release}

\begin{release}{8.1}{2019-11-27}
\item Corrected documentation for legacy 6th edition style
\end{release}
  
\begin{release}{8.0}{2019-09-07}
\item Removed unused and unneeded use of NUMBER and SERIES fields
\end{release}

\begin{release}{7.9}{2019-09-03}
\item Bugfix release
\end{release}

\begin{release}{7.8}{2019-08-30}
\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: