summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-08-31 21:32:07 +0000
committerKarl Berry <karl@freefriends.org>2011-08-31 21:32:07 +0000
commit6a11d2c3656f990f59782df3b1eb5648660d8959 (patch)
tree5ae5c51da61e99a704486da854fc4fd17907f0d1 /Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex
parenta706eaebd9e859c2a4e3da9247666a364345b6e9 (diff)
biblatex-chicago (31aug11)
git-svn-id: svn://tug.org/texlive/trunk@23763 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex153
1 files changed, 107 insertions, 46 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex
index a32934bf262..2f3c49172af 100644
--- a/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex
@@ -6,10 +6,10 @@
\usepackage[german,french,american]{babel}
\usepackage[autostyle]{csquotes}
%\usepackage[document]{ragged2e}
-\usepackage[authordate,backend=bibtex8,babel=hyphen,%
-bibencoding=auto,strict]{biblatex-chicago}
-% \usepackage[style=chicago-authordate,backend=bibtex8,usecompiler=true,%
-% babel=other,bibencoding=inputenc,sorting=nyt,cmslos]{biblatex}
+\usepackage[authordate,backend=biber,babel=hyphen,%
+bibencoding=latin1,strict]{biblatex-chicago}
+% \usepackage[style=chicago-authordate,backend=biber,usecompiler=true,%
+% babel=hyphen,bibencoding=auto,sorting=nyt,cmslos,autocite=inline]{biblatex}
\DeclareLanguageMapping{german}{cms-german}
%\DeclareLanguageMapping{american}{cms-american}
\DeclareLanguageMapping{french}{cms-french}
@@ -18,13 +18,36 @@ bibencoding=auto,strict]{biblatex-chicago}
\usepackage{setspace}
\usepackage{vmargin} \setpapersize{A4}
\setmarginsrb{1in}{20pt}{1in}{.5in}{1pt}{2pt}{0pt}{2mm}
+% \renewcommand*{\biburlsetup}{%
+% \Urlmuskip=0mu plus 2mu\relax
+% \mathchardef\UrlBreakPenalty=200\relax
+% \mathchardef\UrlBigBreakPenalty=100\relax
+% \mathchardef\UrlEmergencyPenalty=9000\relax
+% \appto\UrlSpecials{%
+% \do\0{\mathchar`\0\penalty\UrlEmergencyPenalty}%
+% \do\1{\mathchar`\1\penalty\UrlEmergencyPenalty}%
+% \do\2{\mathchar`\2\penalty\UrlEmergencyPenalty}%
+% \do\3{\mathchar`\3\penalty\UrlEmergencyPenalty}%
+% \do\4{\mathchar`\4\penalty\UrlEmergencyPenalty}%
+% \do\5{\mathchar`\5\penalty\UrlEmergencyPenalty}%
+% \do\6{\mathchar`\6\penalty\UrlEmergencyPenalty}%
+% \do\7{\mathchar`\7\penalty\UrlEmergencyPenalty}%
+% \do\8{\mathchar`\8\penalty\UrlEmergencyPenalty}%
+% \do\9{\mathchar`\9\penalty\UrlEmergencyPenalty}}%
+% \def\UrlBreaks{%
+% \do\.\do\@\do\/\do\\\do\!\do\_\do\|\do\;\do\>\do\]\do\)\do\}%
+% \do\,\do\?\do\'\do\+\do\=\do\#\do\$\do\&\do\*\do\^\do\"}%
+% \def\UrlBigBreaks{\do\:\do\-}}
\usepackage{url}
\urlstyle{rm}
+\appto\bibsetup{\sloppy}
\hyphenation{evans-ton clem-ens}
\setlength{\dimen\footins}{9.5in}
\setlength{\parindent}{0pt}
\setlength{\parskip}{5pt}
\newcommand{\cmd}[1]{\texttt{\textbackslash #1}}
+\usepackage[colorlinks,urlcolor=blue,citecolor=black,
+plainpages=false,breaklinks=true]{hyperref}
\bibliography{dates-test}
%%\onehalfspacing
\begin{document}
@@ -32,6 +55,29 @@ bibencoding=auto,strict]{biblatex-chicago}
\section*{The Chicago Author-Date Specification}
\label{sec:spec}
+\subsection*{Important Note}
+\label{bibernote}
+
+Starting with \textsf{biblatex} version 1.5, in order to adhere to the
+author-date specification you will need to use \textsf{Biber} to
+process your .bib files, as \textsc{Bib}\TeX\ (and its more recent
+variants) will no longer provide all the features you need.
+Unfortunately, however, the current release of \textsf{Biber} (0.9.5)
+contains bugs that make it tricky to use with
+\textsf{biblatex-chicago}. These bugs have been addressed in 0.9.6
+beta, which is available for various operating systems in the
+\texttt{development} subdirectory of your SourceForge mirror, e.g.,
+\href{http://www.mirrorservice.org/sites/download.sourceforge.net/pub/sourceforge/b/project/bi/biblatex-biber/biblatex-biber/development/binaries/}{UK
+ mirror}. (If, by the time you read this, \textsf{Biber} 0.9.6 has
+already been released, then so much the better.) The advice that
+follows in this document assumes that you are using \textsf{Biber}; if
+you wish to continue using \textsc{Bib}\TeX\ then you need
+\textsf{biblatex} version 1.4c and, if you have any problems with the
+current release, possibly \textsf{biblatex-chicago} 0.9.7a.
+
+\subsection*{Usage}
+\label{usage}
+
As a general rule, you'll probably want to use the \cmd{autocite}
command for most citations. For most sources, the result will be
exactly as you expect it to be. A few examples:
@@ -116,15 +162,23 @@ known or can be guessed: \autocite{horsley:prosodies};
\enquote{\texttt{Anon.}}\ as author may be the simplest option:
\autocite{anon:stanze}; \autocite{virginia:plantation}.
-An absent date will, in most entry types, provoke the package into
-providing \enquote{\texttt{n.d.}\hspace{-2pt}}:
-\autocite{evanston:library}. You can also give it yourself in the
-form \cmd{bibstring\{nodate\}}: \autocite{ross:thesis}. A date that
-can be guessed should appear within square brackets:
-\autocite{clark:mesopot}. Forthcoming works are straightforward,
-assuming you remember to use the \cmd{autocap} macro so that the word
-appears correctly in both citations and the list of references:
-\autocite{author:forthcoming}; \autocite{contrib:contrib}.
+With \textsf{Biber}, an absent \textsf{date} will automatically
+provoke it into searching for other sorts of dates in the entry, in
+the order \textsf{year, eventyear, origyear, urlyear}: e.g.,
+\autocite{evanston:library}, which only has a \textsf{urlyear}. (You
+can eliminate some of these dates from the running, or change the
+search order, using the \cmd{DeclareLabelYear} command in your
+preamble. Please cf.\ section~4.5.2 in \textsf{biblatex.pdf} for the
+details.) In most entry types, the absence of all four possible dates
+will automatically produce \enquote{\texttt{n.d.}\hspace{-2pt}}
+instead: \autocite{bernstein:shostakovich}. You can also give it
+yourself in the form \cmd{bibstring\{nodate\}}:
+\autocite{ross:thesis}. A date that can be guessed should appear
+within square brackets: \autocite{clark:mesopot}. Forthcoming works
+are straightforward, assuming you remember to use the \cmd{autocap}
+macro so that the word appears correctly in both citations and the
+list of references: \autocite{author:forthcoming};
+\autocite{contrib:contrib}.
The \emph{Manual} outlines a series of options for entries with more
than one date \autocite[17.124--27]{chicago:manual}. All of these
@@ -180,9 +234,11 @@ place for it, making sure to include formatting:
\label{sec:misc}
When citing individual letter-like pieces from an unpublished archive
-using \textsf{origdate}, you need to set the \texttt{cmsdate=on}
-option so that the \textsf{origdate} appears in the citation and at
-the head of the entry in the list of references:
+using \textsf{origdate}, you can set the \texttt{cmsdate=on} option so
+that not only will the \textsf{origyear} appear in the citation and at
+the head of the entry in the list of references --- something
+\textsf{Biber} now does by default --- but that year also won't
+reappear in the body of the reference list entry:
\autocite{creel:house}. Non-letters, e.g., interviews, use the
\textsf{date} field, so you don't need \texttt{cmsdate};
\autocite{spock:interview}. For undated pieces you can put
@@ -238,37 +294,42 @@ text and the comment will do the trick, e.g.,
The default settings in \textsf{biblatex-chicago} are
\texttt{maxnames=3,minnames=1} in citations and
-\texttt{max\-names=10,minnames=7} in the list of references (see the
-\cmd{printbibliography} command in the .tex file). In practice, this
-means that an entry like hlatky:hrt, with 5 authors, will present all
-of them in the list of references but will truncate to one in
-citations, like so: \autocite{hlatky:hrt}. For the vast majority of
-circumstances, these settings are exactly right for the Chicago
-author-date specification. However, if \enquote{a reference list
- includes another work \emph{of the same date} that would also be
- abbreviated as [\enquote{Hlatky et al.}] but whose coauthors are
+\texttt{max\-bibnames=10,minbibnames=7} in the list of references
+(these latter parameters set in \textsf{biblatex-chicago.sty}). In
+practice, this means that an entry like hlatky:hrt, with 5 authors,
+will present all of them in the list of references but will truncate
+to one in citations, like so: \autocite{hlatky:hrt}. For the vast
+majority of circumstances, these settings are exactly right for the
+Chicago author-date specification. However, if \enquote{a reference
+ list includes another work \emph{of the same date} that would also
+ be abbreviated as [\enquote{Hlatky et al.}] but whose coauthors are
different persons or listed in a different order, the text citations
must distinguish between them} \autocite[16.118]{chicago:manual}.
-By default, \textsf{biblatex} would present such a work as, e.g.,
-(Hlatky et al. 2002b), while hlatky:hrt would be (Hlatky et
-al. 2002a). This does distinguish between them, but inaccurately, as
-it suggests that the two different author lists are exactly the same.
-
-The solution to this problem is the \textsf{shortauthor} field. For
-our two entries they might look like, e.g., \{\{Hlatky, Boothroyd et
-al.\}\} and \{\{Hlatky, Smith et al.\}\}. This will produce the two
-citations (Hlatky, Boothroyd et al.\ 2002) and (Hlatky, Smith et al.\
-2002), which is what the specification requires. If the
-distinguishing name occurs further down the author list --- in fourth
-or fifth position in our examples --- then you may have to use
-\textsf{shortauthor} fields that look like this: \{\{Hlatky et al.,
-\textbackslash mkbibquote\{Quality of Life,\}\}\} and \{\{Hlatky et
-al., \textbackslash mkbibquote\{Depressive Symptoms,\}\}\}, using a
-shortened title to distinguish the references. This would produce
-(Hlatky et al., \enquote{Quality of Life,} 2002) and (Hlatky et al.,
-\enquote{Depressive Symptoms,} 2002), again as the spec requires.
-There is, unfortunately, no simpler way that I know of to deal with
-this situation.
+The new (\textsf{Biber}-only) \textsf{biblatex} option
+\texttt{uniquelist}, set for you in \textsf{biblatex-chicago.sty},
+will automatically handle many of these situations for you, but it is
+as well to understand that it does so by temporarily suspending the
+limits, listed above, on how many names to print in a citation.
+Without \texttt{uniquelist}, \textsf{biblatex} would present such a
+work as, e.g., (Hlatky et al. 2002b), while hlatky:hrt would be
+(Hlatky et al. 2002a). This does distinguish between them, but
+inaccurately, as it suggests that the two different author lists are
+exactly the same. With \texttt{uniquelist}, the two citations might
+look like (Hlatky, Boothroyd et al.\ 2002) and (Hlatky, Smith et al.\
+2002), which is what the specification requires.
+
+If, however, the distinguishing name occurs further down the author
+list --- in fourth or fifth position in our examples --- then the
+default settings would produce citations with all 4 or 5 names
+printed, which can become awkwardly long. In such a situation, you
+can provide \textsf{shortauthor} fields that look like this:
+\{\{Hlatky et al., \textbackslash mkbibquote\{Quality of Life,\}\}\}
+and \{\{Hlatky et al., \textbackslash mkbibquote\{Depressive
+Symptoms,\}\}\}, using a shortened title to distinguish the
+references. This would produce (Hlatky et al., \enquote{Quality of
+ Life,} 2002) and (Hlatky et al., \enquote{Depressive Symptoms,}
+2002), as the spec recommends. There is, unfortunately, no simpler
+way that I know of to deal with this situation.
\subsubsection*{Audiovisual entries}
\label{sec:audiovisual}
@@ -368,7 +429,7 @@ Unpublished: \autocite{nass:address}.
% \printshorthands % No longer necessary in author-date.
\nocite{*}
-\printbibliography[title=References,maxnames=10,minnames=7]
+\printbibliography[title=References]
\end{document}
%%% Local Variables: