diff options
author | Karl Berry <karl@freefriends.org> | 2011-08-31 21:32:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-08-31 21:32:07 +0000 |
commit | 6a11d2c3656f990f59782df3b1eb5648660d8959 (patch) | |
tree | 5ae5c51da61e99a704486da854fc4fd17907f0d1 /Master/texmf-dist/doc/latex/biblatex-chicago/cms-dates-sample.tex | |
parent | a706eaebd9e859c2a4e3da9247666a364345b6e9 (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.tex | 153 |
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: |