summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-07-14 23:29:42 +0000
committerKarl Berry <karl@freefriends.org>2012-07-14 23:29:42 +0000
commit9c45fe88cb4094081b2b1243cd17bcc43439c041 (patch)
tree7cc4b04347495547b4afce8a28ac028256eb69d9 /Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
parent9c2ad73f6c5870b83ac88537986c2bbb2294f7c4 (diff)
biblatex-apa (10jul12)
git-svn-id: svn://tug.org/texlive/trunk@27057 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex96
1 files changed, 51 insertions, 45 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
index 22d8f2b063e..291d65ce7be 100644
--- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa.tex
@@ -25,7 +25,7 @@
url={http://www.ctan.org/tex-archive/macros/latex/exptl/biblatex-contrib/biblatex-apa/},
author={Philip Kime},
email={Philip@kime.org.uk},
- revision={4.7},
+ revision={5.0},
date={\today}}
\hypersetup{%
@@ -45,6 +45,25 @@ Please see the revision history below (section \ref{rev}) for details on change
version. This section is just for important things like incompatible
changes which users should be aware of.
+\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
@@ -79,14 +98,15 @@ press».
This package is a Bib\LaTeX\ style for APA (American Psychological
Association) style compliant documents typeset in \latex. It implements a
-citation style (\path{apa.cbx}), a references section style
-(\path{apa.bbx}) 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.
+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
@@ -94,18 +114,15 @@ APA Style Guide (6th Edition).
\subsection{Requirements}\label{ref:req}
-You will need to be using \sty{csquotes} ($\geq$ 4.3) and Bib\LaTeX\
-($\geq$ 1.4). Some features will not work\footnote{Automatic name and name
- list uniqueness disambiguation, for example---see examples doc} without the
-Biber backend for Bib\LaTeX\ ($\geq$ 0.9.2) which is strongly
-recommended. If you want to take advantage of the Bib\LaTeX\
-|\DeclareQuotePunctuation| facility to enforce the APA required «American»
-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.
+You will need to be using \sty{csquotes} ($\geq$ 4.3), Bib\LaTeX\ ($\geq$
+2.0) and Biber ($\geq$ 1.0). 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
@@ -255,12 +272,6 @@ and references style is implemented, there are just a few exceptions which
are hardly worth the coding pain since they ambiguous and easily worked
around.
-\subsubsection{Reference Section Limitations}
-
-\begin{description}
-\item\apa{6.27} Can't deal yet with authors listed as «with».
-\end{description}
-
\section{Details}
The detailed information for this style is contained in the example document and
@@ -290,6 +301,9 @@ accompanying \path{.bib} files:
\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}
@@ -346,35 +360,27 @@ general notes:
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 There are occasions where there is no sensible \path{.bib} key to
- use. This applies to things like |AUDIO| and |VIDEO| entries mainly. The
- format of these requires that different roles (Director, Producer etc.)
- are separately specified for different names. This is not really possible
- for the usual |AUTHOR| or |EDITOR| fields. In such cases, I have resorted
- to the Bib\LaTeX\ custom |NAME| and |NAMETYPE| fields which are not
- very portable but until the Bib\TeX\ backend support is dropped in Bib\LaTeX\
- there is no way round this without making things very messy. This will
- happen around Bib\LaTeX\ version 2.0.
\item APA style sometimes refers to the «series» of a multi-volume work.
This corresponds to the |MAINTITLE| field in the \path{.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}.
-\item |USERB| is sometimes used to specify that a URL is for an abstract
- rather than the paper itself. Not very portable but that's because of Bib\TeX\ data
- model limtations.
-\item |USERD| is sometimes used to specify information that indicates
- special formatting. Not very portable but that's because of Bib\TeX\ data
- model limtations.
-\item |USERE| is sometimes used to specify questionable dates/authors for
- special formatting. Not very portable but that's because of Bib\TeX\ data
- model limtations.
\end{itemize}
\section{Revision history}\label{rev}
\begin{changelog}
+\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