diff options
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.tex | 110 |
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} |