diff options
author | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2019-09-02 13:46:59 +0900 |
commit | e0c6872cf40896c7be36b11dcc744620f10adf1d (patch) | |
tree | 60335e10d2f4354b0674ec22d7b53f0f8abee672 /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.tex | 870 |
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: |