From 2fcb60fa8843870d9f3a90987498e5b775402258 Mon Sep 17 00:00:00 2001
From: Norbert Preining <norbert@preining.info>
Date: Wed, 24 Aug 2022 03:01:23 +0000
Subject: CTAN sync 202208240301

---
 .../doc/examples/72-style-verbose-note-ms.tex      | 169 +++++++++++++++++++++
 1 file changed, 169 insertions(+)
 create mode 100644 macros/latex/contrib/biblatex-ms/doc/examples/72-style-verbose-note-ms.tex

(limited to 'macros/latex/contrib/biblatex-ms/doc/examples/72-style-verbose-note-ms.tex')

diff --git a/macros/latex/contrib/biblatex-ms/doc/examples/72-style-verbose-note-ms.tex b/macros/latex/contrib/biblatex-ms/doc/examples/72-style-verbose-note-ms.tex
new file mode 100644
index 0000000000..7681bb2b94
--- /dev/null
+++ b/macros/latex/contrib/biblatex-ms/doc/examples/72-style-verbose-note-ms.tex
@@ -0,0 +1,169 @@
+%
+% This file presents the 'verbose-note' style
+%
+\documentclass[a4paper]{article}
+\usepackage[T1]{fontenc}
+\usepackage[utf8]{inputenc}
+\usepackage[american]{babel}
+\usepackage{csquotes}
+\usepackage[style=verbose-note,backend=biber]{biblatex-ms}
+\usepackage{hyperref}
+\addbibresource{biblatex-examples.bib}
+\newcommand{\cmd}[1]{\texttt{\textbackslash #1}}
+\begin{document}
+
+\section*{The \texttt{verbose-note} style}
+
+This citation style is similar to \texttt{verbose} in that it prints
+a verbose citation similar to the full bibliography entry when an
+item is cited for the first time. All subsequent citations are
+pointers to the footnote containing the verbose citation. This style
+is exclusively intended for citations given in footnotes.
+
+\subsection*{Additional package options}
+
+\subsubsection*{The \texttt{pageref} option}
+
+By default, this style does not add a page reference to the footnote
+pointers, i.e., they are rendered as `see note~3'. If you want such
+references to be rendered as `see note~3, page~5' instead, set the
+package option \texttt{pageref=true} or simply \texttt{pageref} in
+the preamble. This will add the page number to the footnote pointer
+whenever the footnote to which the pointer refers is located on a
+different page or page spread (depending on the setting of the
+\texttt{pagetracker} option). The default setting is
+\texttt{pageref=false}.
+
+\subsubsection*{The \texttt{citepages} option}
+
+Use this option to fine-tune the formatting of the \texttt{pages}
+and \texttt{pagetotal} fields in verbose citations. When an entry
+with a \texttt{pages} field is cited for the first time and the
+\texttt{postnote} is a page number or a page range, the citation
+will end with two page specifications:
+
+\begin{quote}
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, p.\,125.
+\end{quote}
+%
+In this example, \enquote{125} is the \texttt{postnote} and
+\enquote{100--150} is the \texttt{pages} field (there are similar
+issues with the \texttt{pagetotal} field). This may be confusing to
+the reader. The \texttt{citepages} option controls how to deal with
+these fields in this case. The option works as follows, given these
+citations as an example:
+
+\begin{verbatim}
+\cite{key}
+\cite[a note]{key}
+\cite[125]{key}
+\end{verbatim}
+%
+\texttt{citepages=permit} allows duplicates, i.e., the style will
+print both the \texttt{pages}\slash \texttt{pagetotal} and the
+\texttt{postnote}. This is the default setting:
+
+\begin{quote}
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150.
+
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, a note.
+
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, p.\,125.
+\end{quote}
+%
+\texttt{citepages=suppress} unconditionally suppresses the
+\texttt{pages}\slash \texttt{pagetotal} fields in citations,
+regardless of the \texttt{postnote}:
+
+\begin{quote}
+Author. \enquote{Title.} In: \emph{Book.}
+
+Author. \enquote{Title.} In: \emph{Book,} a note.
+
+Author. \enquote{Title.} In: \emph{Book,} p.\,125.
+\end{quote}
+%
+\texttt{citepages=omit} suppresses the \texttt{pages}\slash
+\texttt{pagetotal} in the third case only. They are still printed if
+there is no \texttt{postnote} or if the \texttt{postnote} is not a
+number or range:
+
+\begin{quote}
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150.
+
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, a note.
+
+Author. \enquote{Title.} In: \emph{Book,} p.\,125.
+\end{quote}
+%
+\texttt{citepages=separate} separates the \texttt{pages}\slash
+\texttt{pagetotal} from the \texttt{postnote} in the third case:
+
+\begin{quote}
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150.
+
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, a note.
+
+Author. \enquote{Title.} In: \emph{Book,} pp.\,100--150, esp. p.\,125.
+\end{quote}
+%
+The string \enquote{especially} in the third case is the bibliography
+string \texttt{thiscite}, which may be redefined.
+
+\subsubsection*{The \texttt{dashed} option}
+
+By default, this style replaces recurrent authors/editors in the
+bibliography by a dash so that items by the same author or editor
+are visually grouped. This feature is controlled by the package
+option \texttt{dashed}. Setting \texttt{dashed=false} in the
+preamble will disable this feature. The default setting is
+\texttt{dashed=true}.
+
+\clearpage
+
+\subsection*{\cmd{footcite} examples}
+
+% The initial citation of an entry includes all the data.
+This is just filler text.\footcite{aristotle:anima}
+This is just filler text.\footcite{aristotle:physics}
+This is just filler text \footcite{averroes/bland}.
+% Subsequent citations are pointers to the initial citation.
+This is just filler text.\footcite{aristotle:anima}
+This is just filler text.\footcite{aristotle:physics}
+% If there is only one work by an author in the bibliography, the
+% title is omitted from the pointer.
+This is just filler text \footcite{averroes/bland}.
+
+\clearpage
+
+% If the 'shorthand' field is defined, the shorthand is introduced
+% on the first citation.
+This is just filler text.\footcite{kant:kpv}
+This is just filler text.\footcite{kant:ku}
+% All subsequent citations will then use the shorthand.
+This is just filler text.\footcite[24]{kant:kpv}
+This is just filler text.\footcite[59--63]{kant:ku}
+
+\clearpage
+
+\subsection*{\cmd{autocite} examples}
+
+% The \autocite command works like \footcite. Note that
+% the period is moved and placed before the footnote.
+
+This is just filler text \autocite{aristotle:rhetoric}.
+This is just filler text \autocite{aristotle:rhetoric}.
+This is just filler text \autocite{aristotle:anima}.
+This is just filler text \autocite{aristotle:physics}.
+This is just filler text \autocite{averroes/bland}.
+
+\clearpage
+
+% Since all bibliographic data is provided on the first citation,
+% this style may be used without a list of references and
+% shorthands. Of course these lists may still be printed if desired.
+
+\printshorthands
+\printbibliography
+
+\end{document}
-- 
cgit v1.2.3

