summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-sbl/biblatex-sbl.tex
diff options
context:
space:
mode:
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-sbl/biblatex-sbl.tex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-sbl/biblatex-sbl.tex110
1 files changed, 78 insertions, 32 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-sbl/biblatex-sbl.tex b/macros/latex/contrib/biblatex-contrib/biblatex-sbl/biblatex-sbl.tex
index 02ea67f292..35caf8365a 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-sbl/biblatex-sbl.tex
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-sbl/biblatex-sbl.tex
@@ -11,7 +11,7 @@
\usepackage{framed}
\usepackage{enumitem}
-\usepackage[style=sbl,indexing=cite,idemtracker=false,ibidtracker=false]{biblatex}
+\usepackage[style=sbl,indexing=cite]{biblatex}
\addbibresource{biblatex-sbl.bib}
\hypersetup{colorlinks,citecolor=spot}
@@ -143,15 +143,16 @@
\biblatexsbl provides support to \biblatex and LaTeX for citations,
bibliography, and a list of abbreviations in the style recommended by the
Society of Biblical Literature (\citeshorthand{SBL}). The style conforms to
-the second edition of the \cite{SBLHS}.
-
-The style supports all examples given in the handbook (see
-\sty{biblatex-sbl-examples.pdf}). Shorthand citations and a list of
-abbreviations containing journals, series, and shorthands are handled
-automatically. Repeated authors in the bibliography are replaced by a
-horizontal line. \emph{Ibidem} and \emph{idem} is enabled by default. Indexing
-of names is supported, but not enabled by default. Only note style citations,
-not Author-Date citations are supported. Primary sources can be cited in
+the second edition of the \cite{SBLHS} and includes updates from the
+\citetitle*{sblhs2.com} blog \autocite{sblhs2.com}.
+
+The style supports all examples given in the handbook and any relevant updates
+given on the Blog (see \sty{biblatex-sbl-examples.pdf}). Shorthand citations
+and a list of abbreviations containing journals, series, and shorthands are
+handled automatically. Repeated authors in the bibliography are replaced by a
+horizontal line. \emph{Ibidem}, \emph{idem} and indexing of names are
+supported, but not enabled by default. Only note style citations,
+not Author-Date citations, are supported. Primary sources can be cited in
parentheses. \biblatexsbl is compatible with \biblatex's support for
\sty{hyperref}.
@@ -211,7 +212,7 @@ and Hebrew usage with \sty{babel}.
\begin{quote}
\begin{lstlisting}[style=latex]{}
-\usepackage[nil,bidi=default]{babel}
+\usepackage[nil,bidi=default]{babel}% consider bidi=basic for lualatex
\usepackage{csquotes}
\babelprovide[import=en-US,main]{american}
\babelprovide[import=he]{hebrew}
@@ -275,17 +276,35 @@ e.g.,
\sampleparencite[2.233-235]{josephus:ant}
\end{snugshade}
-\cmditem{journalcite}{key}
-\cmditem{seriescite}{key}
-\cmditem{shorthandcite}{key}
-
-\cmd{journalcite}, \cmd{seriescite}, and \cmd{shorthandcite} inserts the
+\cmditem{citefullauthor}[prenote][postnote]{key}
+\cmditem{citefullauthor*}[prenote][postnote]{key}
+\cmditem{Citefullauthor}[prenote][postnote]{key}
+\cmditem{Citefullauthor*}[prenote][postnote]{key}
+
+These commands print the full names of the authors. Strictly speaking, it
+prints the \bibfield{labelname} list in the format of a first citation, which
+may be the \bibfield{author}, the \bibfield{editor}, or the
+\bibfield{translator}. \cmd{Citefullauthor} is similar to \cmd{citefullauthor}
+but capitalizes the name prefix of the first name in the citation if the
+\opt{useprefix} option is enabled, provided that there is a name prefix. The
+starred variants effectively force \opt{maxcitenames} to 1 for just this
+command on so only print the first name in the \bibfield{labelname} list
+(potentially followed by the “et al” string if there are more names). This
+allows more natural textual flow when referring to a paper in the singular
+when otherwise \cmd{citefullauthor} would generate a (naturally plural) list
+of names.
+
+\cmditem{citejournal}{key}
+\cmditem{citeseries}{key}
+\cmditem{citeshorthand}{key}
+
+\cmd{citejournal}, \cmd{citeseries}, and \cmd{citeshorthand} inserts the
respective abbreviation into the text and also adds it to the list of
abbreviations. The abbreviation is hyperlinked to the list of abbreviations if
the \sty{hyperref} package is loaded.
-These commands ignore the \bibfield{prenote} and \bibfield{postnote} fields,
-so can safely be used anywhere within a database entry.
+These commands do not take a \bibfield{prenote} or \bibfield{postnote} field,
+and can safely be used nested within a citation.
\cmditem{printbiblist}
@@ -316,8 +335,8 @@ custom ones outlined below.
\optitem[false]{accessdate}{\opt{true}, \opt{false}}
The \cite{SBLHS} discourages the use of access
-dates.\autocite[See][§6.1.6, 84]{SBLHS} If they are required this option can be
-passed to \biblatex.
+dates \autocite[See][§6.1.6, 84]{SBLHS}. If they are required this option can
+be passed to \biblatex.
\optitem[sbl]{citepages}{\opt{sbl}, \opt{permit}, \opt{omit}, \opt{separate}}
@@ -341,7 +360,7 @@ the first time an entry is cited.
The one exception to this is the \bibtype{incommentary} entry type which
always sets \opt{citepages} to \opt{omit} (see below) when \bibfield{volume}
- is defined.\autocite[See][§1.3.3.2]{SBLHS:studentsupp}
+ is defined \autocite[See][§1.3.3.2]{SBLHS:studentsupp}.
\item[permit] The \bibfield{postnote} is printed in parentheses after the
\bibfield{pages} field. e.g.,
@@ -397,7 +416,7 @@ controls the format of the \bibfield{eprintdate}.
The \emph{Student Supplement for the} \cite{SBLHS} permits two styles for the
bibliography entry for Bible dictionaries, encyclopaedias, and multivolume
commentaries for the entire Bible by multiple
-authors.\autocite[4–5]{SBLHS:studentsupp}
+authors \autocite[4–5]{SBLHS:studentsupp}.
This option applies to \bibtype{inreference} and \bibtype{incommentary}
entry types.
@@ -419,7 +438,7 @@ entry types.
\end{snugshade}
\end{valuelist}
-\optitem[constrict]{ibidtracker}{\opt{true}, \opt{false}, \opt{context},
+\optitem[false]{ibidtracker}{\opt{true}, \opt{false}, \opt{context},
\opt{strict}, \opt{constrict}}
This option controls the \emph{ibidem} tracker. The possible choices are:
@@ -444,17 +463,19 @@ This option controls the \emph{ibidem} tracker. The possible choices are:
the same footnote or in immediately consecutive footnotes.
\end{valuelist}
-\boolitem[false]{ibidpage}
+\boolitem[true]{ibidpage}
The scholarly abbreviation \emph{ibidem} is sometimes taken to mean both ‘same
author + same title’ and ‘same author + same title + same page’ in traditional
-citation schemes. By default, this is not the case with this style because it
-may lead to ambiguous citations. If you prefer the wider interpretation of
-\emph{ibidem}, set the package option \opt{ibidpage=true} or simply
-\opt{ibidpage} in the preamble. The default setting is \opt{ibidpage=false}.
+citation schemes. In line with SBL recommendations, this style uses the
+latter.\footnote{See
+\url{https://sblhs2.com/2017/01/05/subsequent-bibliographic-references/}.} If
+you prefer the narrower interpretation of \emph{ibidem}, set the package
+option \opt{ibidpage=false} in the preamble. The default setting is
+\opt{ibidpage=true}.
-\optitem[constrict]{idemtracker}{\opt{true}, \opt{false}, \opt{context},
-\opt{strict}, \opt{constrict}}
+\optitem[sbl]{idemtracker}{\opt{true}, \opt{false}, \opt{context},
+\opt{strict}, \opt{constrict}, \opt{citation}, \opt{sbl}}
This option controls the \emph{idem} tracker. The possible choices are:
@@ -470,7 +491,12 @@ This option controls the \emph{idem} tracker. The possible choices are:
\item[constrict] This mode is similar to \opt{context} with one additional
condition: a reference in a footnote will only be considered as unambiguous
if the current citation and the previous citation are given in the same
- footnote.
+ footnote or in immediately consecutive footnotes.
+\item[citation] This option only allows \emph{idem} within a citation or
+ footnote. This is the preferred option if you intend to use \emph{idem}.
+\item[sbl] This option is similar to \opt{citation}, but does not actually
+ use \emph{idem}. Rather, it uses the author family name in subsequent
+ citations. This is the default option to comply with SBL style.
\end{valuelist}
\optitem[true]{pagetracker}{\opt{true}, \opt{false}}
@@ -886,6 +912,10 @@ This field holds the month component of the \bibfield{eprintdate} field.
This field holds the year component of the \bibfield{eprintdate} field.
+\listitem{mainauthor}{name}
+
+The author(s) of the \bibfield{maintitle}.
+
\listitem{maineditor}{name}
The editor(s) of the \bibfield{maintitle}.
@@ -966,6 +996,14 @@ automatically inserted into the list of abbreviations.
The \bibfield{title} in abridged form. This is printed instead of the full
title on subsequent citations.
+\fielditem{sorttitle}{literal}
+
+A field used to modify the sorting order of the bibliography. If present, this
+field is used instead of the title field when sorting the bibliography. This
+field is automatically populated if it doesn't exist and the \bibfield{title}
+field begins with `A', `An', or `The' so that these articles do not affect
+sorting.
+
\listitem{withauthor}{name}
The author(s) who assist the \bibfield{author}. See \bibfield{witheditortype},
@@ -1251,6 +1289,14 @@ e.g.,
\section{Important Changes}
+\subsection*{0.12\quad 2020-11-04}
+
+\begin{itemize}
+ \item Ibid.\@ and idem are no longer used by default.
+ \item Only the author family name is printed for subsequent citations of a
+ different work by the same author within a footnote or citation.
+\end{itemize}
+
\subsection*{0.11\quad 2018-12-13}
\begin{itemize}
@@ -1269,7 +1315,7 @@ e.g.,
\begin{itemize}[itemsep=0pt]
\item Support and require \biblatex 3.11.
- \item Use ibid and idem by default.
+ \item Use ibid.\@ and idem by default.
\item \sty{polyglossia} is no longer supported. You should use \sty{babel}
instead.
\end{itemize}