path: root/macros/latex/contrib/biblatex-contrib/biblatex-sbl/biblatex-sbl.tex

% imakeidx needs to be loaded before hyperref
\RequirePackage{scrlfile}\AfterPackage{textcomp}{\RequirePackage{imakeidx}}
\documentclass[a4paper]{ltxdockit}[2011/03/25]
\usepackage{microtype}
\usepackage{xcolor}
\makeindex[title=Author Index,intoc,options=-q]
\usepackage{btxdockit}
\usepackage{fontspec}
\usepackage{realscripts}
\usepackage{xparse}
\usepackage{framed}
\usepackage{enumitem}

\usepackage[style=sbl,indexing=cite]{biblatex}
\addbibresource{biblatex-sbl.bib}

\hypersetup{colorlinks,citecolor=spot}

\hyphenation{Prei-sen-daz}

\setmonofont{DejaVu Sans Mono}[Scale=MatchLowercase]
\setromanfont{Linux Libertine O}
\setsansfont{Linux Biolinum O}[
  BoldItalicFont={* Bold},
  BoldItalicFeatures={FakeSlant=0.2}
]

\newcommand*{\biblatexsbl}{\sty{biblatex-sbl}\xspace}
\newcommand*{\biblatexsblhome}{https://github.com/dcpurton/biblatex-sbl/}
\newcommand*{\biblatex}{\sty{biblatex}\xspace}

\ExplSyntaxOn
\NewDocumentCommand \samplemacro { m }
  {
    \texttt{#1}\par
  }
\NewDocumentCommand \sblrefsamplecite { s m m m o o m }
  {
    \IfNoValueTF { #5 }
      {
        \IfNoValueT { #6 }
          {
            \IfBooleanF { #1 }
              {
                \samplemacro{\textbackslash #2\{#7\}}
              }
            \hspace*{\bibindent}#4\csuse{#3}{#7}
          }
      }
      {
        \IfNoValueTF { #6 }
          {
            \IfBooleanF { #1 }
              {
                \samplemacro{\textbackslash #2[#5]\{#7\}}
              }
            \hspace*{\bibindent}#4\csuse{#3}[#5]{#7}
          }
          {
            \IfBooleanF { #1 }
              {
                \samplemacro{\textbackslash #2[#5][#6]\{#7\}}
              }
            \hspace*{\bibindent}#4\csuse{#3}[#5][#6]{#7}
          }
      }
  }
\NewDocumentCommand \samplecite { s m o o m }
  {
    \rmfamily
    \IfBooleanTF { #1 }
      {
        \sblrefsamplecite*{autocite}{cite}{#2.~}[#3][#4]{#5}.\par
      }
      {
        \sblrefsamplecite{autocite}{cite}{#2.~}[#3][#4]{#5}.\par
      }
  }
\NewDocumentCommand \sampleparencite { s o o m }
  {
    \rmfamily
    \IfBooleanTF { #1 }
      {
        \sblrefsamplecite*{parencite}{parencite}{}[#2][#3]{#4}\par
      }
      {
        \sblrefsamplecite{parencite}{parencite}{}[#2][#3]{#4}\par
      }
  }
\NewDocumentCommand \samplebib { s m }
  {
    \IfBooleanF { #1 }
      {
        \samplemacro{\textbackslash printbibliography}
      }
    \hangindent\bibindent\bibentrycite{#2}.\par
  }
\NewDocumentCommand \samplebiblist { s m }
  {
    \IfBooleanF { #1 }
      {
        \samplemacro{\textbackslash printbiblist\{abbreviations\}}
      }
    \biblistcite{#2}
  }
\ExplSyntaxOff

\lstset{%
  basicstyle=\displayverbfont\normalsize,
  keywordstyle=\bfseries
}

\makeatletter
\def\ltd@printarg@v<(#1)#2>{[(\prm{#1})\prm{#2}]\ltd@parseargs}
\makeatother

\titlepage{%
  title={\biblatexsbl},
  subtitle={SBL Style Using \biblatex},
  url={\biblatexsblhome},
  author={David Purton},
  email={dcpurton@marshwiggle.net},
  revision={\printsblversion},
  date={\printsbldate}}

\hypersetup{%
  pdftitle={biblatex-sbl},
  pdfsubject={SBL Style Using biblatex},
  pdfauthor={David Purton},
  pdfkeywords={sbl, biblatex, bibliography, citation}}

\definecolor{spot}{rgb}{0.25,0.25,0.65}
\colorlet{shadecolor}{black!15}

\begin{document}

\printtitlepage

\tableofcontents

\section{Introduction}

\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} 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}.

For anything not covered in this manual, please see the \biblatex
documentation. Bugs and feature requests can be submitted at
\url{\biblatexsblhome}.

\textbf{Note:} This package should be considered as beta software and its
output carefully checked when you use it.

\section{Requirements}

\biblatexsbl requires at least version 3.11 of \biblatex and the \sty{xparse}
package. \sty{biber} must be used. \sty{bibtex} is not supported. For
localization \sty{babel} (not \sty{polyglossia}) and \sty{csquotes} are
recommended.

\section{Usage}

The following minimal example will set up \biblatexsbl to conform to the
defaults of the \cite{SBLHS}.

\begin{quote}
\begin{lstlisting}[style=latex]{}
\documentclass{article}
\usepackage[style=sbl]{biblatex}
\addbibresource{<bibfile.bib>}
\begin{document}
\printbiblist{abbreviations}
\printbibliography
\end{document}
\end{lstlisting}
\end{quote}

\subsection{Localization}

By default \biblatexsbl uses American style punctuation and quotation marks.
You can choose a different style by including the
\sty{babel} and \sty{csquotes} packages in your
document preamble. \sty{polyglossia} is not well supported by \biblatex and
its use is discouraged.

\begin{quote}
\begin{lstlisting}[style=latex]{}
\usepackage[ngerman]{babel}
\usepackage{csquotes}
\usepackage[style=sbl]{biblatex}
\end{lstlisting}
\end{quote}

Currently \opt{english} (including variants such as \opt{british},
\opt{australian}, etc.), \opt{spanish}, and \opt{german} are supported.

For Greek and especially Hebrew, the set up is more complicated and you should
use \sty{xelatex} or \sty{lualatex}. See \sty{sbl-paper.pdf} for example Greek
and Hebrew usage with \sty{babel}.

\begin{quote}
\begin{lstlisting}[style=latex]{}
\usepackage[nil,bidi=default]{babel}% consider bidi=basic for lualatex
\usepackage{csquotes}
\babelprovide[import=en-US,main]{american}
\babelprovide[import=he]{hebrew}
\babelprovide[import=el]{polutonikogreek}
\babelfont[american]{rm}[Ligatures=TeX]{Linux Libertine O}
\babelfont[hebrew]{rm}%
  [Ligatures=TeX,Contextuals=Alternate]{SBL BibLit}
\babelfont[polutonikogreek]{rm}%
  [Ligatures=TeX,Contextuals=Alternate]{SBL BibLit}
\end{lstlisting}
\end{quote}

\subsection{Commands}

The standard commands for \biblatexsbl generally follow those defined by
\biblatex. Included below are the most typical commands. For more commands and
options, reference the \biblatex manual.

\begin{ltxsyntax}

\cmditem{autocite}[prenote]<(altpostnote)postnote>{key}
\cmditem{autocite*}[prenote]<(altpostnote)postnote>{key}

\cmd{autocite} inserts a citation as a footnote. If used in a footnote, the
citation is placed in parentheses. The starred variant suppresses the author,
editor, or translator (provided the entry options are set to use them). It
works as in the standard \biblatex styles, except that that
\bibfield{postnote} argument can be divided into two using parentheses. This
creates an \bibfield{altpostnote} field which is used in some of the examples
from §6.4 of the \cite{SBLHS}. e.g.,

\begin{snugshade}
  \samplecite{1}[See][(1.3)8:223]{clementinehomilies}
\end{snugshade}

To use only \bibfield{altpostnote} surround the whole argument in parentheses.
e.g.,

\begin{snugshade}
  \samplecite{1}[(III. 1-164)]{PGM:betz}
\end{snugshade}

\cmditem{cite}[prenote]<(altpostnote)postnote>{key}
\cmditem{cite*}[prenote]<(altpostnote)postnote>{key}

\cmd{cite} works in the same way as \cmd{autocite} except that the citation is
placed directly into the text instead of in a footnote. The starred variant
suppresses the author, editor, or translator (provided the entry options are
set to use them).

\cmditem{parencite}[prenote]<(altpostnote)postnote>{key}
\cmditem{parencite*}[prenote]<(altpostnote)postnote>{key}

\cmd{parencite} works in the same way as \cmd{autocite} except that the
citation is placed inside parentheses instead of in a footnote. The starred
variant suppresses the author, editor, or translator (provided the entry
options are set to use them). This is most useful for citing primary sources.
e.g.,

\begin{snugshade}
  \sampleparencite[2.233-235]{josephus:ant}
\end{snugshade}

\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 do not take a \bibfield{prenote} or \bibfield{postnote} field,
and can safely be used nested within a citation.

\cmditem{printbiblist}

This command prints a bibliography list. In \biblatexsbl all abbreviations
(journals, series, and shorthands) can be printed using the following command:

\begin{quote}
  \verb+\printbiblist[...]{abbreviations}+
\end{quote}

See the \biblatex manual for an explanation of available optional arguments.

\cmditem{printbibliography}

Inserts the bibliography. See the \biblatex manual for an explanation of
available optional arguments.

\end{ltxsyntax}

\subsection{Package Options}

\biblatexsbl defaults to the recommendations of the \citeshorthand{SBL}, but
it also supports many of the standard options from \biblatex as well as a few
custom ones outlined below.

\begin{optionlist}

\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.

\optitem[sbl]{citepages}{\opt{sbl}, \opt{permit}, \opt{omit}, \opt{separate}}

Use this option to fine-tune the formatting of the \bibfield{pages} field
the first time an entry is cited.

\begin{valuelist}
\item[sbl] The \bibfield{postnote} field is not printed for first citations.
  e.g.,

  \begin{snugshade}
    \samplecite{1}[159]{leyerle:1993}
  \end{snugshade}

  If \bibfield{postnote} is not a page range, then it is printed in
  parentheses after \bibfield{pages}. e.g.,

  \begin{snugshade}
    \samplecite{1}[a note]{irvine:2014}
  \end{snugshade}

  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}.

\item[permit] The \bibfield{postnote} is printed in parentheses after the
  \bibfield{pages} field. e.g.,

  \makeatletter\cbx@opt@citepages@permit\makeatother

  \begin{snugshade}
    \samplecite{1}[245]{wildberger:1965}
  \end{snugshade}

\item[omit] The \bibfield{pages} field is not printed unless
  \bibfield{postnote} is empty or not a page range (in which case behaviour
  matches \opt{citepages=sbl}). e.g.,

  \makeatletter\cbx@opt@citepages@omit\makeatother

  \begin{snugshade}
    \samplecite{1}[5]{freedman:1977}
  \end{snugshade}

\item[separate] The \bibfield{postnote} is printed in parentheses after the
  \bibfield{pages} field preceeded by the bibliography string \sty{thiscite}.
  e.g.,

  \makeatletter\cbx@opt@citepages@separate\makeatother

  \begin{snugshade}
    \samplecite{1}[1]{petersen:1988}
  \end{snugshade}

  If \bibfield{postnote} is not a page range, then \sty{firstcite} is not
  used and the behaviour matches \opt{citepages=sbl}.

  \makeatletter\cbx@opt@citepages@sbl\makeatother

\end{valuelist}

\boolitem[true]{dashed}

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 \opt{dashed}. Setting
\opt{dashed=false} in the preamble will disable this feature.

\optitem[comp]{eprintdate}{\opt{year}, \opt{short}, \opt{long}, \opt{terse,
\opt{comp}, \opt{iso8601}}}

Similar to the \opt{date} option (for details see the \biblatex manual) but
controls the format of the \bibfield{eprintdate}.

\boolitem[false]{fullbibrefs}

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}.

This option applies to \bibtype{inreference} and \bibtype{incommentary}
entry types.

\begin{valuelist}
\item[true] The bibliography entry is printed in long form. e.g.,

  \begin{snugshade}
    \toggletrue{fullbibrefs}
    \nocite{IDB}
    \samplebib*{stendahl:1962}
    \togglefalse{fullbibrefs}
  \end{snugshade}

\item[false] The bibliography entry is printed in a short form. e.g.,

  \begin{snugshade}
    \samplebib*{stendahl:1962}
  \end{snugshade}
\end{valuelist}

\optitem[false]{ibidtracker}{\opt{true}, \opt{false}, \opt{context},
\opt{strict}, \opt{constrict}}

This option controls the \emph{ibidem} tracker. The possible choices are:

\begin{valuelist}
\item[true] Enable the tracker in global mode.
  not tracked separately between text body and footnotes.
\item[false] Disable the tracker: \emph{ibid.}\ will not be used.
\item[context] Enable the tracker in context-sensitive mode. In this mode,
  citations in footnotes and in the body text are tracked separately.
\item[strict] Enable the tracker in strict mode. In this mode, potentially
  ambiguous references are suppressed. A reference is considered ambiguous if
  either the current citation (the one including the \emph{ibidem}) or the
  previous citation (the one the \emph{ibidem} refers to) consists of a list
  of references.
\item[constrict] This mode combines the features of \opt{context} and
  \opt{strict}. It also keeps track of footnote numbers and detects
  potentially ambiguous references in footnotes in a stricter way than the
  \opt{strict} option. In addition to the conditions imposed by the
  \opt{strict} option, 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 or in immediately consecutive footnotes.
\end{valuelist}

\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. 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[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:

\begin{valuelist}
\item[true] Enable the tracker in global mode.
\item[false] Disable the tracker: \emph{idem} will not be used.
\item[context] Enable the tracker in context-sensitive mode. In this mode,
  citations in footnotes and in the body text are tracked separately.
\item[strict] This is an alias for \opt{true}, provided only for consistency
  with the other trackers. Since \emph{idem} replacements do not get ambiguous
  in the same way as \emph{ibidem}, the strict tracking mode does not apply to
  them.
\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 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}}

This option controls whether \emph{ibidem} and \emph{idem} are used across
page breaks or not.

\begin{valuelist}
\item[true] Enable the tracker in automatic mode. This is like \opt{spread} if
  LaTeX is in twoside mode, and like \opt{page} otherwise.
\item[false] Disable the tracker.
\item[page] Enable the tracker in page mode. In this mode, tracking works on a
  per-page basis.
\item[spread] Enable the tracker in spread mode. In this mode, tracking works
  on a per-spread (double page) basis.
\end{valuelist}

\boolitem[true]{sblfootnotes}

This option controls the style of footnotes. This option is compatible with
the \sty{footmisc} package provided \sty{footmisc} is loaded before \biblatex.

\begin{valuelist}
\item[true] Footnotes are printed with a normal number followed by a period
  and the first line indented:

  \begin{snugshade}
    \samplecite*{1}{talbert:1992}
  \end{snugshade}

\item[false] Footnotes are printed with a superscript (or whatever other
  default has been set up by your style):

  \begin{snugshade}
    \hspace*{\bibindent}\llap{\textsuperscript{1}}\cite{robinson+koester:1971}.
  \end{snugshade}
\end{valuelist}

\optitem[true]{shorthand}{\opt{true}, \opt{false}, \opt{short}, \opt{intro}}

This option controls when and whether the \bibfield{shorthand} field is used
as a citation. This can also be used as a type option or entry option.
\bibtype{ancienttext} and \bibtype{classictext} entry types ignore this
option.

\begin{valuelist}
\item[true] Always use the \bibfield{shorthand} when citing the entry.
\item[false] Never use the \bibfield{shorthand} when citing the entry.
\item[short] Print the full citation the first time the entry is cited. Use
  the \bibfield{shorthand} on subsequent citations.
\item[intro] Print the full citation the first time the entry is cited
  followed by (henceforth cited as \bibfield{shorthand}). Use the
  \bibfield{shorthand} on subsequent citations.
\end{valuelist}


\end{optionlist}

\section{Database Guide}

\subsection{Entry Types}

All standard entry types of \biblatex{} are supported by \biblatexsbl. This
section gives an overview of entry types that are most relevant, unique to, or
treated in a custom way by \biblatexsbl{}.

\begin{typelist}

\typeitem{ancienttext}

This is a custom type for \biblatexsbl. It is used for the special examples in
\cite[§6.4.1, §6.4.3 and §6.4.8]{SBLHS}.

Unless \bibfield{options = \{skipbib=false\}} is set explicitly, an
\bibtype{ancienttext} entry will not appear in the bibliography. (Although,
see \opt{ANRW} \bibfield{entrysubtype} below for an exception.) The
\bibfield{related} field is used to refer to the entry which should appear in
the bibliography instead of the \bibtype{ancienttext} entry. Options can be
set on the related entry using the \bibfield{relatedoptions} field.

The entry pointed to by \bibfield{related} along with the \bibfield{postnote}
is printed in parentheses after the \bibfield{altpostnote}, \bibfield{editor},
and \bibfield{translator} fields if they are present. \bibfield{translator}
and \bibfield{editor} fields are omitted for subsequent citations. e.g.,

\begin{snugshade}
  \samplecite{1}[319]{suppiluliumas}
  \samplecite*{2}[319]{suppiluliumas}
  \samplebib{ANET}
\end{snugshade}

If the entry contains \bibfield{options = \{skipbib=false\}}, then the
bibliography entry will be like \bibtype{book}. Any shorthand is also
printed in the same way as a \bibtype{book} shorthand.

The following values for the \bibfield{entrysubtype} field are supported:

\begin{valuelist}

\item[ANRW]

The \opt{ANRW} \bibfield{entrysubtype} is particularly for citing \cite{ANRW}
as outlined in §6.4.8 of the \cite{SBLHS}. In this case, the entry \emph{will}
appear in the bibliography. See \sty{biblatex-sbl-examples.pdf} for full
details of the required database entry.

\item[chronicle]

Formats the \bibfield{title} using an upright shape font without quotation
marks. e.g.,

\begin{snugshade}
  \samplecite{1}[(lines 3--4)125]{esarhaddonchronicle}
\end{snugshade}

\item[COS]

Suppresses parentheses around \emph{COS} and the \bibfield{postnote} for
subsequent citations. e.g.,

\begin{snugshade}
  \samplecite{1}[44]{greathymnaten}
  \samplecite*{2}[44]{greathymnaten}
\end{snugshade}

\item[inscription]

  Similarly to \bibfield{entrysubtype = \{chronicle\}}, this formats the
  \bibfield{title} using an upright shape font without quotation marks.

\end{valuelist}

\typeitem{article}

An article in a journal or magazine. Also use this type for review articles
\parencite[§6.3.4]{SBLHS} and electronic journal articles
\parencite[§6.3.10]{SBLHS}.

\typeitem{book}

A single-volume book with one or more authors where the authors share credit
for the work as a whole.

\typeitem{inbook}

A part of a book which forms a self-contained unit with its own title.

\typeitem{bookinbook}

This type is similar to \bibtype{inbook} but intended for works originally
published as a stand-alone book. The main difference is that the title is
printed in italics instead of in quotation marks.

\typeitem{mvbook}

A multivolume \bibtype{book}.

There is one \bibfield{entrysubtype} supported:

\begin{valuelist}

\item[RIMA]

The citation for \citeseries{RIMA} \parencite[97]{SBLHS} is treated like a
series with a number when cited in full, but as a shorthand with a volume when
cited in short form. See \sty{biblatex-sbl-examples.pdf} for full details.

\end{valuelist}

\typeitem{suppbook}

Supplemental material in a \bibtype{book}. Use this for an introduction,
preface or foreword written by someone other than the author
\parencite[§6.2.14]{SBLHS}. The \bibfield{type} field is used to specify the
type of supplementary material. See §6.2.14 of
\sty{biblatex-sbl-examples.pdf}. If no \bibfield{type} is given, then this
behaves like an \bibtype{inbook}.

\typeitem{booklet}

A book-like work without a formal publisher or sponsoring institution.

\typeitem{classictext}

This type is a custom type for \biblatexsbl. It is used for the special
examples in \cite[§6.4.2 and §§6.4.4–6]{SBLHS}.

Unless \bibfield{options = \{skipbib=false\}} is set explicitly, a
\bibtype{classictext} entry will not appear in the bibliography. The
\bibfield{xref} field is used to refer to the entry which should appear in the
bibliography instead of the \bibtype{classictext} entry.

If present, the \bibfield{translator} and \bibfield{series} are printed in
parentheses following the \bibfield{postnote}. e.g.,

\begin{snugshade}
  \samplecite{1}[15.18-19]{tacitus:ann:jackson}
  \samplebib{tacitus}
\end{snugshade}

The \bibfield{series} can be suppressed by setting \bibfield{options =
\{useseries=false\}}.

If the entry contains \bibfield{options = \{skipbib=false\}}, then the
bibliography entry will be like \bibtype{incollection} except that the
\bibfield{title} is set in italics instead of within quotation marks.

The following values for the \bibfield{entrysubtype} field are supported:

\begin{valuelist}

\item[churchfather]

Entries using the \opt{churchfather} \bibfield{entrysubtype} print the entry
pointed to by \bibfield{related} within parentheses following the
\bibfield{altpostnote}. The \bibfield{postnote} field applies to the entry in
\bibfield{related}. \bibfield{relatedoptions} can be used to control some
aspects of the formatting for the related entry. \bibfield{altpostnote} is
always separated from the title by a space.

\begin{snugshade}
  \samplecite{1}[(28.3.5)252]{augustine:letters}
  \samplebib{augustine:letters}
\end{snugshade}

\end{valuelist}

\typeitem{collection}

A single-volume collection with multiple, self-contained contributions by
distinct authors which have their own title. The work as a whole has no
overall author but it will usually have an editor.

\typeitem{mvcollection}

A multi-volume \bibtype{collection}.

\typeitem{incollection}

A contribution to a collection which forms a self-contained unit with a
distinct author and title.

\typeitem{commentary}

A single-volume commentary on a book (or part of a book) of the Bible by one
or more authors. This entry type is similar to \bibtype{book}, except that any
\bibfield{volume} and \bibfield{maintitle} is only printed in the
bibliography, not the citation.

\typeitem{mvcommentary}

A multi-volume commentary on a single book of the Bible by one or more authors
or a multi-volume commentary on the whole Bible by multiple authors. Unlike
\bibtype{commentary}, this behaves exactly the same as a \bibtype{mvbook}.

\typeitem{incommentary}

A contribution to a commentary which forms a self-contained unit with a
distinct author and title. This is typically a commentary on a book of the
Bible appearing in a single or multi-volume commentary on the entire Bible.

If an entry contains an \bibfield{xref} field, then the bibliography entry is
printed in either short or long form as described above under
\opt{fullbibrefs}.

\typeitem{conferencepaper}

An unpublished paper presented at a professional society. Use the
\bibfield{eventtitle}, \bibfield{venue}, and \bibfield{date} fields to
specify detail for the conference. See §6.3.8 of
\sty{biblatex-sbl-examples.pdf} for and example.

\typeitem{lexicon}

A single-volume lexicon or theological dictionary. This is similar to a
\bibtype{book}.

\typeitem{mvlexicon}

A multi-volume lexicon or theological dictionary. This is similar to a
\bibtype{mvbook}.

\typeitem{inlexicon}

An article in a lexicon or theological dictionary. This is a custom type for
\biblatexsbl. The required \bibfield{xref} field must contain the entry name
of a \bibtype{lexicon} or \bibtype{mvlexicon}. The \bibtype{inlexicon} entry
does not appear in the bibliography. Instead the lexicon pointed to by
\bibfield{xref} appears in the bibliography.

Subsequent citations do not include the \bibfield{title}, only the name of the
lexicon (specified by the \bibfield{xref} entry). e.g.,

\begin{snugshade}
  \samplecite{1}[511]{dahn+liefeld:see+vision+eye}
  \samplecite{2}[511]{dahn+liefeld:see+vision+eye}
  \samplebib{NIDNTT}
\end{snugshade}

\typeitem{misc}

A fallback type for entries which do not fit into any other category. Use the
\bibfield{howpublished} field to supply publishing information in free format,
if applicable.

\typeitem{online}

An online resource without a print counterpart. This is similar to an
\bibtype{article}.

\typeitem{periodical}

A complete issue of a periodical, such as a special issue of a journal. The
title of the periodical is given in the \bibfield{title} field. If the issue
has its own title in addition to the main title of the periodical, it goes in
the \bibfield{issuetitle} field.

This type could also be used to insert a journal into the list of
abbreviations. In this case, just use \bibfield{title}, \bibfield{shorttitle},
and set \bibfield{options = \{skipbib\}}.

\typeitem{reference}

A single-volume encyclopaedia or dictionary. This is similar to a
\bibtype{book}.

\typeitem{mvreference}

A multi-volume \bibtype{reference}. This is similar to a \bibtype{mvbook}.

\typeitem{inreference}

An article in an encyclopaedia or dictionary. The required \bibfield{xref}
field must contain the entry name of a \bibtype{reference} or
\bibtype{mvreference}.

The bibliography entry is printed in either short or long form as described
above under \opt{fullbibrefs}.

\typeitem{review}

A book review in a journal. This is similar to an \bibtype{article}. Use the
\bibfield{revdauthor}\slash\bibfield{revdeditor} and \bibfield{revdtitle}
fields to specify the author\slash editor and title of the book being
reviewed.

Note that review articles are treated like articles and should use the
\bibtype{article} entry type.

\typeitem{seminarpaper}

An \citeshorthand{SBL} seminar paper. This is similar to an
\bibtype{incollection} except that \emph{in} is suppressed byfore the
\bibfield{booktitle}\slash\bibfield{maintitle}. See §6.4.11 of
\sty{biblatex-sbl-examples.pdf} for an example.

\typeitem{series}

A multi-volume series. This is similar to a \bibtype{mvbook} except that an
upright shaped font is used for the \bibfield{title} field and the
\bibfield{option} field is set to \bibfield{\{useauthor=false,}
\bibfield{useditor=false\}} by default.

This type could also be used to place a series in the list of abbreviations.
In this case, just use \bibfield{series}, \bibfield{shortseries}, and set
\bibfield{options = \{skipbib\}}.

\end{typelist}

\subsection{Entry Fields}

\biblatexsbl supports all entry fields from the \biblatex manual except for
\bibfield{pagetotal}. There are also a number of custom entry fields and
specially handled fields supported by \biblatexsbl. These are documented
below.

\begin{fieldlist}

\listitem{bookeditor}{name}

The editor(s) of the \bibfield{booktitle}.

The behaviour of \bibfield{editor}, \bibfield{bookeditor}, and
\bibfield{maineditor} is as follows (when \bibfield{editor} is not used as
the overall editor): \bibfield{editor} applies to \bibfield{maintitle} (if
set) unless \bibfield{maineditor} is set. In this case, \bibfield{editor}
applies to \bibfield{booktitle} (if set) unless \bibfield{bookeditor} is
set. In this case, \bibfield{editor} applies to \bibfield{title}.

\listitem{booktranslator}{name}

The translator(s) of the \bibfield{booktitle}.

The behaviour of \bibfield{translator}, \bibfield{booktranslator}, and
\bibfield{maintranslator} is the same as for \bibfield{editor},
\bibfield{bookeditor}, and \bibfield{maineditor}.

\fielditem{eprintdate}{date}

The date a text edition published online with no print counterpart or an
article in an online database is released. See §6.4.1 and §6.4.13 of
\sty{biblatex-sbl-examples.pdf}.

\fielditem{eprintday}{datepart}

This field holds the day component of the \bibfield{eprintdate} field.

\fielditem{eprintmonth}{datepart}

This field holds the month component of the \bibfield{eprintdate} field.

\fielditem{eprintyear}{datepart}

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}.

\listitem{maintranslator}{name}

The translator(s) of the \bibfield{maintitle}.

\listitem{revdauthor}{name}

The author(s) of the \bibfield{revdtitle}.

\listitem{revdeditor}{name}

The editor(s) of the \bibfield{revdtitle}.

\fielditem{revdshorttitle}{literal}

The title of a book being review in an abridged form. This field is used in
subsequent citations of \bibtype{review} entry types.

\fielditem{revdsubtitle}{literal}

The subtitle of a book being reviewed.

\fielditem{revdtitle}{literal}

The title of a book being reviewed.

\fielditem{revdtitleaddon}{literal}

An annex to the \bibfield{revdtitle}, to be printed in a different font.

\fielditem{seriesseries}{literal}

This field is used when a \bibfield{series} is begun anew to distinguish
between the old and new series. See \cite[§6.2.24]{SBLHS}.

\fielditem{shortbooktitle}{literal}

The \bibfield{booktitle} in abridged form.

\fielditem{shorthand}{literal}

A special short form printed instead of the usual citation. Sometimes the
\bibfield{shorthand} is short for the authors and should be printed in an
upright font shape. Other times it is short for the \bibfield{title} and
should be printed in italics. This behaviour is controlled using the
\bibfield{shorttitle} field. If the \bibfield{shorttitle} is the same as the
\bibfield{shorthand} then the \bibfield{shorthand} is assumed to be short for
the \bibfield{title} and printed in italics, otherwise it is printed in an
upright font. The \bibfield{shorthand} is automatically inserted into the list
of abbreviations.

The separator between the \bibfield{shorthand} and \bibfield{postnote} depends
on the content of the \bibfield{postnote}. If the \bibfield{postnote} contains
a ‘.’, ‘:’, or ‘§’, then the separator is a space, otherwise it is a comma.

\fielditem{shortjournal}{literal}

The \bibfield{journaltitle} in abridged form. This is always printed instead
of the \bibfield{journaltitle}. The \bibfield{shortjournal} and
\bibfield{journaltitle} is then automatically inserted into the list of
abbreviations.

\fielditem{shortmaintitle}{literal}

The \bibfield{maintitle} in abridged form.

\fielditem{shortseries}{literal}

The \bibfield{series} in abridged form. This is always printed instead of the
\bibfield{series}. The \bibfield{shortseries} and \bibfield{series} is then
automatically inserted into the list of abbreviations.

\fielditem{shorttitle}{literal}

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},
below, for an example.

\fielditem{withauthortype}{literal}

The type of \bibfield{withauthor}. This field will affect the string used to
introduce the author(s) who assist the author. If unspecified, the
bibliography string \sty{with} is used.

\listitem{witheditor}{name}

The editor(s) who assist the \bibfield{editor}.

\fielditem{witheditortype}{literal}

The type of \bibfield{witheditor}. This field will affect the string used to
introduce the editor(s) who assist the editor. If unspecified, the
bibliography string \sty{with} is used.

\begin{snugshade}
  \samplecite{1}[1:24]{TLOT}
  \samplebib{TLOT}
  \samplebiblist{TLOT}
\end{snugshade}

\listitem{withtranslator}{name}

The translator(s) who assist the \bibfield{translator}.

\fielditem{withtranslatortype}{literal}

The type of \bibfield{withtranslator}. This field will affect the string used
to introduce the translator(s) who assist the translator. If unspecified, the
bibliography string \sty{with} is used.

\listitem{withbookauthor}{name}

The author(s) who assist the \bibfield{bookauthor}.

\fielditem{withbookauthortype}{literal}

This field is analogous to the \bibfield{withauthortype}, but for the
\bibfield{bookauthor}.

\listitem{withbookeditor}{name}

The editor(s) who assist the \bibfield{bookeditor}.

\fielditem{withbookeditortype}{literal}

This field is analogous to the \bibfield{witheditortype}, but for the
\bibfield{bookeditor}.

\listitem{withbooktranslator}{name}

The translator(s) who assist the \bibfield{booktranslator}.

\fielditem{withbooktranslatortype}{literal}

This field is analogous to the \bibfield{withtranslatortype}, but for the
\bibfield{booktranslator}.

\listitem{withmainauthor}{name}

The author(s) who assist the \bibfield{mainauthor}.

\fielditem{withmainauthortype}{literal}

This field is analogous to the \bibfield{withauthortype}, but for the
\bibfield{mainauthor}.

\listitem{withmaineditor}{name}

The editor(s) who assist the \bibfield{maineditor}.

\fielditem{withmaineditortype}{literal}

This field is analogous to the \bibfield{witheditortype}, but for the
\bibfield{maineditor}.

\listitem{withmaintranslator}{name}

The translator(s) who assist the \bibfield{maintranslator}.

\fielditem{withmaintranslatortype}{literal}

This field is analogous to the \bibfield{withtranslatortype}, but for the
\bibfield{maintranslator}.

\end{fieldlist}

\subsection{Type and Entry Options}

\biblatexsbl supports many of the entry options outlined in the \biblatex
manual. There are also a number of custom entry options supported by
\biblatexsbl. These are documented below.

\begin{optionlist}

\optitem[false]{skipbiblistshorthand}{\opt{true}, \opt{false}}

This option controls what appears in the list of abbreviations for database
entries containing both a \bibfield{shorthand} and a \bibfield{shortseries}.
For entries not containing a \bibfield{shortseries} just use the option
\opt{skipbiblist}. The possible options are:

\begin{valuelist}
\item[true] Do not include the \bibfield{shorthand} in the list of
  abbreviations.
\item[false] Include the \bibfield{shorthand} in the list of abbreviations.
\end{valuelist}

\optitem[false]{skipbiblistshortseries}{\opt{true}, \opt{false}}

This option controls what appears in the list of abbreviations for database
entries containing both a \bibfield{shorthand} and a \bibfield{shortseries}.
For entries not containing a \bibfield{shorthand} just use the option
\opt{skipbiblist}. The possible options are:

\begin{valuelist}
\item[true] Do not include the \bibfield{shortseries} in the list of
  abbreviations.
\item[false] Include the \bibfield{shortseries} in the list of abbreviations.
\end{valuelist}

\optitem[true]{usefullcite}{\opt{true}, \opt{false}}

This options controls the format of first citations. The possible choices are:

\begin{valuelist}
\item[true] Use a full citation the first time the entry is cited.
\item[false] Use the short citation form the first time the entry is cited.
\end{valuelist}

\optitem[true]{useseries}{\opt{true}, \opt{false}}

This option controls whether the \bibfield{series} is printed in parentheses
following a \bibtype{classictext} citation. This does not affect other entry
types.

\begin{valuelist}
\item[true] Print the \bibfield{series}.
  \begin{snugshade}
    \samplecite{1}[2.233-235]{josephus:ant:thackery}
    \samplebib{josephus}
  \end{snugshade}
\item[false] Suppress printing the \bibfield{series}.
  \begin{snugshade}
    \samplecite{2}[10]{heraclitus:epistle1:worley}
    \samplebib{heraclitus:epistle1:worley}
  \end{snugshade}
\end{valuelist}

\optitem[true]{useshorttitle}{\opt{true}, \opt{false}}

This option controls the format of subsequent citations. The possible choices
are:

\begin{valuelist}
\item[true] Include the \bibfield{shorttitle} or \bibfield{title} in
  subsequent citations.
\item[false] Suppress the \bibfield{shorttitle} or \bibfield{title} in
  subsequent citations, so only the author(s) or editor(s) are printed.
\end{valuelist}

\optitem[true]{usevolume}{\opt{true}, \opt{false}}

This option controls whether the \bibfield{volume} is printed as part of the
citation text or as part of the \bibfield{postnote}.

\begin{valuelist}
\item[true] Print the \bibfield{volume} as part of the main citation
  information. e.g., “Vol.~1.”
\item[false] Print the \bibfield{volume} field as part of the
  \bibfield{postnote}. e.g., “1:”
\end{valuelist}

\end{optionlist}

\subsection{Reprints}

\biblatexsbl supports three different ways of doing reprints with varying
complexity.

If only the original publisher, location, and/or year are required, then use
the fields \bibfield{origpublisher}, \bibfield{origlocation}, and
\bibfield{origdate}. e.g.,

\begin{quote}
\begin{lstlisting}{}
@book{vanseters:1997,
    author = {Van Seters, John},
    title = {In Search of History: Histeriography in the Ancient
               World and the Origins of Biblical History},
    origlocation = {New Haven},
    origpublisher = {Yale University Press},
    origdate = {1983},
    location = {Winona Lake, IN},
    publisher = {Eisenbrauns},
    date = {1997}
}
\end{lstlisting}
\begin{snugshade}
  \samplecite{1}[90]{vanseters:1997}
  \samplebib{vanseters:1997}
\end{snugshade}
\end{quote}

When extra information is required, use a related entry with
\bibfield{relatedtype = \{reprint\}}. A custom string can be specified instead
of “Repr.” using the optional \bibfield{relatedstring} field. In this case no
punctuation is inserted after the \bibfield{relatedstring}. You could think of
the default being \bibfield{relatedstring = \{\cmd{bibstring}\{reprint\},\}}.
e.g.,

\begin{quote}
\begin{lstlisting}{}
@mvbook{sasson:2000,
    editor = {Sasson, Jack M.},
    title = {Civilizations of the Ancient Near East},
    volumes = {4},
    location = {New York},
    publisher = {Scribner's Sons},
    year = {1995},
    related = {sasson:repr},
    relatedtype = {reprint}
}
@mvbook{sasson:repr,
    volumes = {4~vols.\ in 2},
    location = {Peabody, MA},
    publisher = {Hendrickson},
    date = {2000}
}
\end{lstlisting}
\begin{snugshade}
  \samplecite{1}[1:40]{sasson:2000}
  \samplebib{sasson:2000}
\end{snugshade}
\end{quote}

A full reprint history also uses the \bibfield{related} field, but with some
other \bibfield{relatedtype} apart from \bibfield{relatedtype = \{reprint\}}.
e.g.,

\begin{quote}
\begin{lstlisting}{}
@book{wellhausen:1883,
    author = {Wellhausen, Julius},
    title = {Prolegomena zur Geschichte Israels},
    edition = {2},
    location = {Berlin},
    publisher = {Reimer},
    date = {1883}
}
@book{wellhausen:1885,
    author = {Wellhausen, Julius},
    title = {Prolegomena to the History of Israel},
    translator = {Black, J. Sutherland and Enzies, A.},
    preface = {Smith, W. Robertson},
    location = {Edinburgh},
    publisher = {Black},
    related = {wellhausen:1883},
    relatedtype = {translationof},
    date = {1885}
}
@book{wellhausen:1957,
    author = {Wellhausen, Julius},
    title = {Prolegomena to the History of Ancient Israel},
    location = {New York},
    publisher = {Meridian Books},
    related = {wellhausen:1885},
    relatedtype = {reprintof},
    date = {1957}
}
\end{lstlisting}
\begin{snugshade}
  \samplecite{1}[20]{wellhausen:1957}
  \samplebib{wellhausen:1957}
\end{snugshade}
\end{quote}

\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}
  \item Add abbreviations from related entries to the list of abbreviations.
  \item Add starred variants for citation commands.
\end{itemize}

\subsection*{0.10\quad 2018-05-24}

\begin{itemize}
  \item Add \opt{dashed} option.
  \item Fix list of abbreviations regression from v0.9.
\end{itemize}

\subsection*{0.9\quad 2018-05-20}

\begin{itemize}[itemsep=0pt]
  \item Support and require \biblatex 3.11.
  \item Use ibid.\@ and idem by default.
  \item \sty{polyglossia} is no longer supported. You should use \sty{babel}
    instead.
\end{itemize}

\subsection*{0.8.2\quad 2017-11-16}

\begin{itemize}[itemsep=0pt]
  \item Support and require \biblatex 3.8a
\end{itemize}

\printbiblist[heading=biblistintoc]{abbreviations}

\printbibliography[heading=bibintoc]

\printindex

\end{document}