diff options
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/cms-noteref-demo.tex')
-rw-r--r-- | macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/cms-noteref-demo.tex | 272 |
1 files changed, 272 insertions, 0 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/cms-noteref-demo.tex b/macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/cms-noteref-demo.tex new file mode 100644 index 0000000000..f2af81322b --- /dev/null +++ b/macros/latex/contrib/biblatex-contrib/biblatex-chicago/doc/cms-noteref-demo.tex @@ -0,0 +1,272 @@ +\documentclass[a4paper,12pt]{article} +\usepackage[T1]{fontenc} +\usepackage{textcomp} +\usepackage[latin1]{inputenc} +\usepackage[american]{babel} +\usepackage[autostyle]{csquotes} +%\usepackage[document]{ragged2e} +\usepackage[notes,strict,backend=biber,autolang=other,cmsbreakurl,% +bibencoding=latin1,booklongxref=false,compresspages,% +noteref=section,noterefintro=introduction]{biblatex-chicago} +\usepackage{lmodern} +\usepackage{gentium} +%\renewcommand*{\rmdefault}{fgn}% The font (gentium) used for pdf +\usepackage{ifthen} +\usepackage{setspace} +\usepackage{vmargin} \setpapersize{A4} +\setmarginsrb{1in}{20pt}{1in}{.5in}{1pt}{2pt}{0pt}{6mm} +\usepackage[split=section]{cmsendnotes} +% \renewcommand{\footnote}{\endnote} +\usepackage{multicol} +\hyphenation{tech-re-port Ap-ril} +\protected\def\onethird{{\mbox{\scriptsize\raisebox{.7ex}{1}% + \hspace{-0.1em}\raisebox{.2ex}{/}\hspace{-0.03em}3}}} +\setlength{\parindent}{0pt} +\setlength{\dimen\footins}{9.5in} +\newcommand{\mycolor}{}%[1]{\textcolor[HTML]{228B22}{#1}} +\usepackage{xr-hyper} +\externaldocument[cms-]{biblatex-chicago}% +\usepackage[pdftex,hyperref,svgnames]{xcolor} +\usepackage[pdftex,colorlinks,filecolor=Teal,citecolor=black, +plainpages=false,breaklinks=true,urlcolor=DarkSlateBlue, +linkcolor=DarkSlateBlue,baseurl=biblatex-chicago.pdf\#]{hyperref} +\makeatletter +\renewcommand{\section}{\@startsection{section}{1}{\z@}% + {-3.25ex\@plus -1ex \@minus -.2ex}% + {1.5ex \@plus .2ex}% + {\normalfont\large\bfseries}} +\newrobustcmd*{\cmssecref}[2][]{\marginpar{\href{\@baseurl% + \getrefbykeydefault{#2}{anchor}{}}{\small §\,\getrefnumber{#2}}% + \ifblank{#1}{}{\scriptsize,\, s.v.\\[1pt]\enquote{#1}}}}% +\makeatother +\newcommand{\cmd}[1]{\texttt{\textbackslash #1}} +\newcommand{\mylittlespace}{\vspace{5pt}}%.5\baselineskip}} +\bibliography{notes-test} +%%\onehalfspacing +%\tracingmacros=1 +\begin{document} + +{\Large\bfseries The \texttt{noteref} Option to the Notes \&\ + Bibliography Style}\label{cms:top} +\vspace*{1.5ex} + +Recent editions of the \emph{Chicago Manual of + Style}\autocite[14.31]{chicago:manual} have suggested that, in short +notes, it may sometimes be helpful to provide a cross-reference to the +work's initial presentation in a long note, \enquote{especially in the + absence of a full bibliography.} With this release, I have provided +for this purpose the \texttt{noteref} package option, which +additionally involves many sub-options and even a new dependent +\LaTeX\ package \textsf{cmsendnotes.sty} (with its own options) to +help those users who need the same functionality in endnotes instead +of footnotes (see page~\pageref{cms:endnotes}). The full +documentation in \cmssecref{cms-sec:noteref} +\textsf{biblatex-chicago.pdf} contains all of the murky details, but +in this document I wanted to provide straightforward examples so that +users could get a quick glimpse of the features provided. + +\mylittlespace By setting the following options when loading +\textsf{biblatex-chicago}: +\begin{verbatim} +noteref=section,noterefintro=introduction +\end{verbatim} +you'll get the following results, in what is obviously a rather +artificial setting. + +\section{Long notes} +\label{sec:one} + +Text\autocite{garaud:gatine} block\autocite{leo:madonna} +with\autocite{schubert:muellerin} a\autocite{mchugh:wake} +series\autocite{euripides:orestes} of\autocite{clark:mesopot} +footnotes\autocite{ashbrook:brain} chosen\autocite{contrib:contrib} +randomly.\autocite{frede:inproc} + +\section{Short notes on the same page} +\label{sec:two} + +New\autocite{chicago:manual} text\autocite{garaud:gatine} +block\autocite{leo:madonna} with\autocite{schubert:muellerin} +a\autocite{mchugh:wake} +series\footnote{\shortrefcite{euripides:orestes}. + \textcolor{DarkSlateBlue}{<--- \cmd{shortrefcite} produced this + \texttt{noteref} where by default one wouldn't have appeared.}} +of\autocite{clark:mesopot} footnotes\autocite{ashbrook:brain} +chosen\autocite{contrib:contrib} randomly.\autocite{frede:inproc} + +\mylittlespace Short notes on the same page, or in the same double-page +spread when in \texttt{twoside} mode, won't by default have a +\texttt{noteref} printed, though you can in fact alter this on a +note-by-note basis by using \cmd{shortrefcite} or +\cmd{shorthandrefcite} instead of your usual citation command, as I've +done with the Euripides example below. + +\clearpage + +\section{Short notes on a new page} +\label{sec:three} + +New\autocite{chicago:manual} text\autocite{garaud:gatine} +block\autocite{leo:madonna} with\autocite{schubert:muellerin} +a\autocite{mchugh:wake} +series\footnote{\shortcite*{euripides:orestes}. + \textcolor{DarkSlateBlue}{<--- \cmd{shortcite*} suppressed the + \texttt{noteref} where by default one would have appeared.}} +of\autocite{clark:mesopot} footnotes\autocite{ashbrook:brain} +chosen\autocite{contrib:contrib} randomly.\autocite{frede:inproc} + +\mylittlespace Here \cmssecref[Zero Sections]{cms-sec:zero} all of the +short notes will, by default, have a \texttt{noteref}. The first note +on this page refers back to a long note that occurred \emph{before} +section~1, technically therefore in section~0, which is what would +appear without further intervention. The intervention I have made is +the option \verb+noterefintro=introduction+, which tells +\textsf{biblatex-chicago} to print \cmd{bibstring\{introduc\-tion\}} +instead of \verb+\bibstring{section}+. The problem of section numbers +containing zero can be complicated, so once again the murky details +are in \textsf{biblatex-chicago.pdf}. + +\mylittlespace The main \texttt{noteref} option has six possible +values, four of which are, I would guess, those most likely to prove +useful: \texttt{none} (the default), \texttt{page}, \texttt{chapter}, +and \texttt{section}, with \texttt{subsection} and \texttt{part} as +additional possibilities. The names of the options correspond to the +\LaTeX\ counter tracked by that option in addition to the note number +itself, so that \texttt{none} produces a \texttt{noteref} that just +provides the note number, while \texttt{page} provides page and note +number, \texttt{chapter} gives chapter and note number, and so on. +Here, with \texttt{section} being the top-level division in the +\texttt{article} class, I've used that option. + +\mylittlespace You can suppress the appearance of a \texttt{noteref} +by using the \cmd{shortcite*} or \cmd{shorthandcite*} commands, as +I've shown with the Euripides citation below. You can also set the +\texttt{noterefin\-terval} option to a number greater than zero if you +want to make sure that a certain number of references have intervened +before printing a \texttt{noteref}, even if the short note is on a new +page. Because this mechanism tracks the \texttt{instcount} counter, +which is incremented by more things than just new citations, you may +have to experiment to find a value that suits your document. + +\section{A few extra subtleties} +\label{sec:four} + +Another\autocite{jackson:paulina:letter} new\autocite{holiday:fool} +text\autocite{garaud:gatine} block\autocite{leo:madonna} +with\autocite{schubert:muellerin} a\autocite{mchugh:wake} +series\footnote{\cite{euripides:orestes}. + \textcolor{DarkSlateBlue}{<--- The \texttt{noteref} does appear + here, following its suppression above.}} +of\autocite{clark:mesopot} footnotes\autocite{ashbrook:brain} +chosen\autocite{contrib:contrib} randomly.\autocite{frede:inproc} + +\mylittlespace When a \texttt{noteref} for a particular source has +already appeared on a page (or a double-page spread) then another +won't be printed after subsequent citations of the same source that +appear on that same page. With the second Euripides note below, the +\texttt{noteref} \emph{does} appear because it was suppressed after +the first reference. + +\clearpage + +Another\footnote{\cite{jackson:paulina:letter}. + \textcolor{DarkSlateBlue}{<--- The form of this \texttt{noteref} and + the next indicates that the short notes are in the same section as + the long notes to which they refer. Set \texttt{fullnoterefs=true} + to get the long form everywhere.}} new\autocite{holiday:fool} +text\autocite{garaud:gatine} block\autocite{leo:madonna} +with\autocite{schubert:muellerin} a\autocite{mchugh:wake} +series\autocite{euripides:orestes} of\autocite{clark:mesopot} +footnotes\autocite{ashbrook:brain} chosen\autocite{contrib:contrib} +randomly.\autocite{frede:inproc} + +\mylittlespace Once again, after a page break, the \texttt{noterefs} +appear after all of these short notes. Because the section number +hasn't changed, however, the first two footnotes on the page, which +refer back to long footnotes in the same section, have +\texttt{noterefs} containing only the note number. This more +compact form is the default, but you can set \texttt{fullnoterefs} to +\texttt{true} when loading \textsf{biblatex-chicago} to see the longer +form everywhere. +% and should be unambiguous unless you restart footnote +% numbering inside the section rather than at section boundaries. + +\section{Endnotes} +\label{cms:endnotes}\citereset + +Things are \cmssecref[Endnotes]{cms-sec:endnoterefs} +slightly more complicated when you are using endnotes instead of +footnotes, but in standard cases it's still fairly straightforward. +In this document I have added the line: +\begin{verbatim} +\usepackage[split=section]{cmsendnotes} +\end{verbatim} +to the preamble \emph{after} loading \textsf{biblatex-chicago} (with +the options shown on page~\pageref{cms:top}), then printed the +endnotes below with \textsf{cmsendnotes'} +\begin{verbatim} +\theendnotesbypart +\end{verbatim} +command. As this shows you can, as usual with \textsf{biblatex}, mix +foot- and endnotes in the same document, but if \texttt{noterefs} are +going to appear in both sorts of note --- surely this situation is +highly unlikely --- then you need to be careful that they refer back +\emph{only} to long references in the \emph{same} sort of note. A +\texttt{noteref} from an endnote to a long citation in a footnote will +be inaccurate, so careful use of the \cmd{citereset} command (as here) +or perhaps of the \textsf{biblatex} \texttt{citereset} option should +allow you to keep the two sorts of note distinct. + +\mylittlespace Text\endnote{\autocite{garaud:gatine}.} +block\endnote{\autocite{leo:madonna}.} +with\endnote{\autocite{schubert:muellerin}.} +a\endnote{\autocite{mchugh:wake}.} +series\endnote{\autocite{euripides:orestes}.} +of\endnote{\autocite{clark:mesopot}.} +endnotes\endnote{\autocite{ashbrook:brain}.} +chosen\endnote{\autocite{contrib:contrib}.} +randomly.\endnote{\autocite{frede:inproc}.} + +\section{More endnotes} +\label{sec:moreen} + +Text\endnote{\global\toggletrue{cms@forcenoteref}\autocite{garaud:gatine}. + \textcolor{DarkSlateBlue}{<--- Page \enquote{break} before this note.}} +block\endnote{\autocite{leo:madonna}.} +with\endnote{\autocite{schubert:muellerin}.} +a\endnote{\autocite{mchugh:wake}.} +series\endnote{\autocite{euripides:orestes}.} +of\endnote{\autocite{clark:mesopot}.} +endnotes\endnote{\autocite{ashbrook:brain}.} +chosen\endnote{\autocite{contrib:contrib}.} +randomly.\endnote{\autocite{frede:inproc}.} + +\mylittlespace When you peruse the endnotes on the next page, please +remember that I've simulated a page change in between the two +sections, thus allowing all the \texttt{noterefs} to appear as they +do. The rules about them appearing (or not) on the same page as the +long reference to which they point are the same as for footnotes, so +long as you keep in mind that the pages under consideration here are +those in the endnotes section itself, \emph{not} in the main text. +Also, in this case the standard \cmd{notesname} command provides +alternative text for the general header, but \textsf{cmsendnotes.sty} +organizes the subheaders and facilitates the \texttt{noterefs}, all +without further intervention from you beyond the single option already +given to that package. + +\mylittlespace I hope that this short demonstration is enough to get +you started using the \texttt{noteref} functionality. I admit that +the processing time for documents using it is somewhat increased, so +if you have a long document it may require some extra patience. If +something doesn't work properly for you, and the main documentation +doesn't clear up the issue, please let me know. + +\def\notesname{Endnotes to \S\S~5--6} +\theendnotesbypart + +\end{document} + +%%% Local Variables: +%%% mode: latex +%%% TeX-master: t +%%% End: |