diff options
author | Karl Berry <karl@freefriends.org> | 2011-04-01 22:31:32 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-04-01 22:31:32 +0000 |
commit | e849d55f9355c10511f579270dd6ded13edee8cc (patch) | |
tree | be8e05a5e65c0290e38a07c925a6b8f0847a4b04 /Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex | |
parent | 6a818ea209bfd552cbcc9b8df8ea962299dd850d (diff) |
biblatex-apa (1apr11)
git-svn-id: svn://tug.org/texlive/trunk@21913 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex | 177 |
1 files changed, 101 insertions, 76 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex index a2c57f90f33..351eb3d1ff4 100644 --- a/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex +++ b/Master/texmf-dist/doc/latex/biblatex-apa/biblatex-apa-test.tex @@ -10,14 +10,36 @@ % Unicode \usepackage{fontspec} \setmainfont[Ligatures=TeX]{TeXGyrePagella} -\setsansfont{Arial} -\setmonofont{Courier New} +\setsansfont[Ligatures=TeX]{TexGyreHeros} +\setmonofont[Ligatures=NoCommon]{TeXGyreCursor} +\MakeAutoQuote{«}{»} % Biblatex \usepackage[style=apa,% backend=biber, bibencoding=utf8]{biblatex} +% Custom settings for misc entries in order to format the table for 6.13* +% This table implies that the examples on each line are in a seperate +% document but since we are generating the citations from a real data +% source, we have to prevent the usual uniquelist processing by making +% all of the examples MISC entrytypes and changing uniquelist +% per-type. There is no point in just typsetting static data as this +% wouldn't be a test of anything. +\ExecuteBibliographyOptions[misc]{uniquelist=false} +\DeclareNameFormat[misc]{labelname}{% + \ifthenelse{\value{listcount}=1\OR\value{listtotal}=2} + {\usebibmacro{labelname:doname}{#1}{#2}{#3}{#4}{#5}{#6}{#7}{#8}} + {\ifthenelse{\value{listtotal}>5} + {\ifnum\value{listcount}=2 \andothersdelim\bibstring{andothers}\fi + \ifnum\value{listcount}>2 \relax\fi} + {\ifciteseen + {\ifnum\value{listcount}=2 \andothersdelim\bibstring{andothers}\fi + \ifnum\value{listcount}=3 \relax\fi + \ifnum\value{listcount}=4 \relax\fi + \ifnum\value{listcount}=5 \relax\fi} + {\usebibmacro{labelname:doname}{#1}{#2}{#3}{#4}{#5}{#6}{#7}{#8}}}}} + \MakeShortVerb{\|} \newcommand\apa[2][]{\ifthenelse{\equal{#1}{}}% @@ -59,10 +81,10 @@ demonstrated. for the bibliographic entries which these examples use. \noindent\apa{6.11}\\ -Simple cite. ``Jr.'' suffix is not shown (bib entry for this example has a suffix):\\ +Simple cite. «Jr.» suffix is not shown (bib entry for this example has a suffix):\\ \apaex{\textcite{6.11}} -\noindent Within a paragraph, not in the ``narrative sense'':\\ +\noindent Within a paragraph, not in the «narrative sense»:\\ \apaex{\parencite{6.11}} \noindent To cite the parts separately:\\ @@ -71,7 +93,7 @@ Simple cite. ``Jr.'' suffix is not shown (bib entry for this example has a suffi \noindent The per-paragraph rules for elision of years are more flexible in APA 6th edition. There is more discretion to do this as the narrative consistency suggests and so this style no longer automatically elides years -aver mention after the first within a paragraph. Cases can be handled as +after the first mention within a paragraph. Cases can be handled as per the examples above. \noindent\apa{6.12} \apa{6.13}\\ @@ -92,27 +114,32 @@ Subsequent citations within a paragraph:\\ citations is not automatic as there may be cases where you don't want to do this (see APA 6.11). -\noindent\textcolor{red}{Note: The name list disambiguation required in the - \emph{Exception:} clause here in the APA manual cannot be automated - currently in |biblatex|. This is due to the underlying reliance on the - |bibtex| |.bib| data model. This will change in a future |biblatex| - release. See |biblatex-apa| docs.} +\noindent Automatic list disambiguation for ambiguous truncations after +first cite\footnote{This feature is fairly deep magic and only works when using + biblatex 1.4+ together with biber 0.9+}:\\ +\apaex{\textcite{6.12c}}\\ +\apaex{\textcite{6.12d}}\\ +\apaex{\textcite{6.12c}}\\ +\apaex{\textcite{6.12d}} -\noindent Multiple-authors in running text are separated by ``and''. -However, in parenthetical cites, multiple authors are separated by ``\&'':\\ +\noindent Multiple-authors in running text are separated by «and». +However, in parenthetical cites, multiple authors are separated by «\&»:\\ \apaex{\textcite{6.12e}}\\ \apaex{\parencite{6.12f}} -\noindent The following citation should be name truncated on first cite -since it has six or more authors:\\ -\apaex{\textcite{6.12g}} - -\noindent\textcolor{red}{Note: The note above applies to the disambiguation -of entries with six or more names} +\noindent Automatic list disambiguation for ambiguous truncations again, +this time the truncation is on first cite as there are more than 5 authors:\\ +\apaex{\textcite{6.12g}}\\ +\apaex{\textcite{6.12h}} -\noindent Now, following the examples in Table 6.1, p. 177 of the APA -manual. Note in the code that typesets these examples, |\citereset| is used -to pretend that the parenthetical examples are the first in the text. +\noindent The following table replicates with real data the examples +in Table 6.1, p.~177 of the APA 6th Edition manual. Note that this +table in the APA manual essentially assumes that the citations on each +line are in a separate document since there is no list disambiguation +or repeated cite truncations between lines. To simulate this with real +data, the source for this document uses |\citereset| between lines and +makes all of the data entries of MISC type, unsetting «uniquelist» for +this type and using a custom labelname style. \begin{center} \begin{tabular}{lllll} @@ -123,64 +150,62 @@ to pretend that the parenthetical examples are the first in the text. citations in text}}\\\\ \hline \\ -\parbox{2cm}{One work by one author} -& \parbox{2.4cm}{\apaexs{\textcite{6.13a}}} & -\parbox{2.4cm}{\apaexs{\textcite{6.13a}}}\citereset -& \parbox{2.4cm}{\apaexs{\parencite{6.13a}}} -& \parbox{2.4cm}{\apaexs{\parencite{6.13a}}}\\\\ -\parbox{2cm}{One work by two authors} -& \parbox{2.4cm}{\apaexs{\textcite{6.13b}}} & -\parbox{2.4cm}{\apaexs{\textcite{6.13b}}}\citereset -& \parbox{2.4cm}{\apaexs{\parencite{6.13b}}} -& \parbox{2.4cm}{\apaexs{\parencite{6.13b}}}\\\\ -\parbox{2cm}{One work by three authors} -& \parbox{2.4cm}{\apaexs{\textcite{6.13c}}} & -\parbox{2.4cm}{\apaexs{\textcite{6.13c}}}\citereset -& \parbox{2.4cm}{\apaexs{\parencite{6.13c}}} -& \parbox{2.4cm}{\apaexs{\parencite{6.13c}}}\\\\ -\parbox{2cm}{One work by four authors} -& \parbox{2.4cm}{\apaexs{\textcite{6.13d}}} & -\parbox{2.4cm}{\apaexs{\textcite{6.13d}}}\citereset -& \parbox{2.4cm}{\apaexs{\parencite{6.13d}}} -& \parbox{2.4cm}{\apaexs{\parencite{6.13d}}}\\\\ -\parbox{2cm}{One work by five authors} -& \parbox{2.4cm}{\apaexs{\textcite{6.13e}}} & -\parbox{2.4cm}{\apaexs{\textcite{6.13e}}}\citereset -& \parbox{2.4cm}{\apaexs{\parencite{6.13e}}} -& \parbox{2.4cm}{\apaexs{\parencite{6.13e}}}\\\\ -\parbox{2cm}{One work by six authors} -& \parbox{2.4cm}{\apaexs{\textcite{6.13f}}} & -\parbox{2.4cm}{\apaexs{\textcite{6.13f}}}\citereset -& \parbox{2.4cm}{\apaexs{\parencite{6.13f}}} -& \parbox{2.4cm}{\apaexs{\parencite{6.13f}}}\\\\ -\parbox{2cm}{Groups (readily identified through abbreviation) as authors} -& \parbox{2.4cm}{\apaexs{\textcite{6.13g}}} & -\parbox{2.4cm}{\apaexs{\textcite{6.13g}}}\citereset -& \parbox{2.4cm}{\apaexs{\parencite{6.13g}}} -& \parbox{2.4cm}{\apaexs{\parencite{6.13g}}}\\\\ -\parbox{2cm}{Groups (no abbreviation) as authors} -& \parbox{2.4cm}{\apaexs{\textcite{6.13h}}} & -\parbox{2.4cm}{\apaexs{\textcite{6.13h}}}\citereset -& \parbox{2.4cm}{\apaexs{\parencite{6.13h}}} -& \parbox{2.4cm}{\apaexs{\parencite{6.13h}}}\\\\ +\parbox{2cm}{\raggedright One work by one author} +& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13a}}} & +\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13a}}}\citereset +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13a}}} +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13a}}}\\\\ +\parbox{2cm}{\raggedright One work by two authors} +& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13b}}} & +\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13b}}}\citereset +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13b}}} +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13b}}}\\\\ +\parbox{2cm}{\raggedright One work by three authors} +& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13c}}} & +\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13c}}}\citereset +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13c}}} +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13c}}}\\\\ +\parbox{2cm}{\raggedright One work by four authors} +& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13d}}} & +\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13d}}}\citereset +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13d}}} +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13d}}}\\\\ +\parbox{2cm}{\raggedright One work by five authors} +& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13e}}} & +\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13e}}}\citereset +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13e}}} +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13e}}}\\\\ +\parbox{2cm}{\raggedright One work by six authors} +& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13f}}} & +\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13f}}}\citereset +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13f}}} +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13f}}}\\\\ +\parbox{2cm}{\raggedright Groups (readily identified through abbreviation) as authors} +& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13g}}} & +\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13g}}}\citereset +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13g}}} +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13g}}}\\\\ +\parbox{2cm}{\raggedright Groups (no abbreviation) as authors} +& \parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13h}}} & +\parbox{2.4cm}{\raggedright\apaexs{\textcite{6.13h}}}\citereset +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13h}}} +& \parbox{2.4cm}{\raggedright\apaexs{\parencite{6.13h}}}\\\\ \hline \end{tabular} \end{center} \noindent\apa{6.14}\\ Citations of an entry with an author who shares a -surname with another entry always appears with initials:\\ +surname with another entry always appears with initials\footnote{This is, + as with automatic name list disambiguation, fairly deep magic only + possible with biblatex 1.4+ and biber 0.9+}. Note that the APA example +for this is not really correct for any automated system as the ambiguous +surname should be disambiguated with initials in both cases---we still +don't really know in the APA example whether the Light in the 2008 paper is +the same as the Light in the 2006. The disambiguation performed by biblatex +makes this clear (or as clear as it can be):\\ \apaex{\textcite{6.14}}\\ -and\\ -\apaex{\textcite{7.01:3b}}\\\\ -\textcolor{red}{Note: The second citation key here is taken from the APA - references section as it is repeated there. This example is currently impossible to automate as - it is, due to the nature of name list parsing in BibTeX. Disambiguation - works between single names and not names within lists at the moment. The - first example works due to a dummy single-name entry with the same - surname in the |.bib| for the citation examples. See - |biblatex-apa| docs. This is planned to be fully supported with |biblatex| - 2.x which should include the necessary underlying functionality}. +\apaex{\textcite{7.01:3b}} \noindent\apa{6.15}\\ Use |SHORTTITLE| field of the entry if it exists:\\ @@ -197,9 +222,9 @@ Two or more works withing the same parentheses:\\ \noindent Citations of works by same authors in the same year:\\ \apaex{\parencite{6.16f,6.16g,6.16h,6.16i,6.16j}}\\\\ -\textcolor{red}{Note: This example, (p. 178 APA Manual 6th edition, 2nd - printing) is slightly odd as the ``in-press-a'' is not indicated and - should be ``in-press'' since no other in press items are listed for the +\textcolor{red}{Note: This example, (p.~178 APA Manual 6th edition, 2nd + printing) is slightly odd as the «in press-a» is not indicated and + should be «in press» since no other in press items are listed for the same authors in the example.} \noindent Compact citations in alphabetic order:\\ @@ -242,7 +267,7 @@ See the |biblatex-apa| docs.\\ \apaex{(\nptextcite[see Table 3 of][]{6.21} for complete data)} \noindent\apa{6.28}\\ -Entries with no date use ``n.d.''.\\ +Entries with no date use «n.d.».\\ \apaex{\textcite{6.28a}}\\ \apaex{\parencite{6.28a}}\\ \apaex{(\nptextcite{6.28a})} |