summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-01-16 23:12:25 +0000
committerKarl Berry <karl@freefriends.org>2017-01-16 23:12:25 +0000
commitcaa95c11d20fa882a04b0a0c8580e0015b840374 (patch)
treedbf1fb53b3fee11eb5121ed9af3a52ec186b7612 /Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
parent4b61f97e62ad8f5277d9851da26809e8a080fa74 (diff)
biblatex-sbl (15jan17)
git-svn-id: svn://tug.org/texlive/trunk@42972 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex410
1 files changed, 256 insertions, 154 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex b/Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
index 00c49cabd2c..957491682d3 100644
--- a/Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
@@ -1,7 +1,8 @@
-\documentclass{ltxdockit}[2011/03/25]
+% imakeidx needs to be loaded before hyperref
+\RequirePackage{scrlfile}\AfterPackage{textcomp}{\RequirePackage{imakeidx}}
+\documentclass{ltxdockit}[2011/03/25]
\usepackage{microtype}
\usepackage{xcolor}
-\usepackage{imakeidx}
\makeindex[title=Author Index,intoc]
\usepackage{btxdockit}
\usepackage{fontspec}
@@ -9,7 +10,7 @@
\usepackage{xparse}
\usepackage{framed}
-\usepackage[style=sbl,indexing=cite,backend=biber]{biblatex}
+\usepackage[style=sbl,indexing=cite]{biblatex}
\addbibresource{biblatex-sbl.bib}
\hypersetup{colorlinks,citecolor=spot}
@@ -109,8 +110,7 @@
}
\makeatletter
-\def\ltd@printarg@iv(#1|#2){[\prm{#1}|\prm{#2}]\ltd@parseargs}
-\def\ltd@printarg@v<#1|>{[\prm{#1}|]\ltd@parseargs}
+\def\ltd@printarg@v<(#1)#2>{[(\prm{#1})\prm{#2}]\ltd@parseargs}
\titlepage{%
title={\biblatexsbl},
@@ -157,6 +157,9 @@ 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.5 of \biblatex and the \sty{xparse}
@@ -199,6 +202,46 @@ document preamble. e.g.,
Currently \opt{english} (including variants such as \opt{british},
\opt{australian}, etc.), \opt{spanish}, and \opt{german} are supported.
+For Greek and especially Hebrew, you are probably better off with
+\sty{polyglossia} and \sty{xelatex} or \sty{lualatex}. e.g.,
+
+\begin{quote}
+\begin{lstlisting}[style=latex]{}
+\usepackage{fontspec}
+\usepackage{polyglossia}
+\usepackage[style=australian]{csquotes}
+\setdefaultlanguage[variant=australian]{english}
+\setotherlanguage[variant=ancient]{greek}
+\setotherlanguage{hebrew}
+\ifxetex
+ \renewenvironment{hebrew}[1][]{%
+ \par
+ \raggedleft % add to right align paragraphs
+ \begin{otherlanguage}[#1]{hebrew}}%
+ {\end{otherlanguage}\par}
+\else % luatex
+ \let\luatexpardir\pardir % luabidi needs this
+ \let\luatextextdir\textdir % luabidi needs this
+ % text direction gets stuffed up without these workarounds
+ \let\luatextextgreek\textgreek
+ \let\luatextextenglish\textenglish
+ \AtBeginDocument{%
+ \renewcommand{\textgreek}[1]{%
+ \bgroup\luatextextgreek{#1}\egroup}
+ \renewcommand{\textenglish}[1]{%
+ \bgroup\setLTR\luatextextenglish{#1}\egroup}}
+\fi
+% set up fonts
+\newfontfamily\greekfont{SBL BibLit}%
+ [Script=Greek,Contextuals=Alternate]
+\newfontfamily\hebrewfont{SBL BibLit}%
+ [Script=Hebrew,Contextuals=Alternate,Scale=1.2]
+\usepackage[style=sbl,backend=biber]{biblatex}
+% update language mapping (biblatex can't do it using polyglossia)
+\DeclareLanguageMapping{english}{sbl-english}
+\end{lstlisting}
+\end{quote}
+
\subsection{Commands}
The standard commands for \biblatexsbl generally follow those defined by
@@ -207,32 +250,31 @@ 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. It works as in the standard \biblatex
styles, except that that \bibfield{postnote} argument can be divided into two
-using the pipe (\sty{|}) character. This creates an \bibfield{altpostnote}
-field which is used in some of the examples from §6.4 of the \cite{SBLHS}.
-e.g.,
+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}
+ \samplecite{1}[See][(1.3)8:223]{clementinehomilies}
\end{snugshade}
-To use only \bibfield{altpostnote} you must still include the pipe character.
+To use only \bibfield{altpostnote} surround the whole argument in parentheses.
e.g.,
\begin{snugshade}
- \samplecite{1}[III. 1-164|]{PGM:betz}
+ \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.
-\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. This is most
@@ -246,7 +288,7 @@ useful for citing primary sources. e.g.,
\cmditem{seriescite}{key}
\cmditem{shorthandcite}{key}
-\cmd{journalcite}, \cmd{seriescite},and \cmd{shorthandcite} inserts the
+\cmd{journalcite}, \cmd{seriescite}, and \cmd{shorthandcite} 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.
@@ -280,6 +322,12 @@ 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
@@ -303,6 +351,10 @@ the first time an entry is cited.
\samplecite{2}[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.,
@@ -355,14 +407,20 @@ the first time an entry is cited.
\end{valuelist}
+\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 and encyclopaedias, and multivolume
+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 \bibfield{@inreference} and \bibfield{@incommentary}
+This option applies to \bibtype{inreference} and \bibtype{incommentary}
entry types.
\begin{valuelist}
@@ -451,12 +509,6 @@ page breaks or not.
on a per-spread (double page) basis.
\end{valuelist}
-\optitem[comp]{releasedate}{\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{releasedate}.
-
\boolitem[true]{sblfootnotes}
This option controls the style of footnotes. This option is compatible with
@@ -478,15 +530,33 @@ the \sty{footmisc} package provided \sty{footmisc} is loaded before \biblatex.
\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}
-This section gives an overview of the entry types supported by \biblatexsbl.
-Many work in the same way as \biblatex. Some standard entry types have custom
-usage, and some are unique to \biblatexsbl. These are documented more fully.
+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}
@@ -495,7 +565,7 @@ usage, and some are unique to \biblatexsbl. These are documented more fully.
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 \opt{options = \{skipbib=false\}} is set explicitly, an
+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
@@ -513,9 +583,9 @@ and \bibfield{editor} fields are omitted for subsequent citations. e.g.,
\samplebib{ANET}
\end{snugshade}
-If the entry contains \opt{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.
+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:
@@ -534,7 +604,7 @@ Formats the \bibfield{title} using an upright shape font without quotation
marks. e.g.,
\begin{snugshade}
- \samplecite{1}[lines 3--4|125]{esarhaddonchronicle}
+ \samplecite{1}[(lines 3--4)125]{esarhaddonchronicle}
\end{snugshade}
\item[COS]
@@ -549,8 +619,8 @@ subsequent citations. e.g.,
\item[inscription]
- Similarly to \opt{chronicle}, this formats the \bibfield{title} using an
- upright shape font without quotation marks.
+ Similarly to \bibfield{entrysubtype = \{chronicle\}}, this formats the
+ \bibfield{title} using an upright shape font without quotation marks.
\end{valuelist}
@@ -562,12 +632,22 @@ An article in a journal or magazine. Also use this type for review articles
\typeitem{book}
-A single-volume book with one or more authors.
+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}. \biblatexsbl treats this as an alias for
-\bibtype{book}.
+A multivolume \bibtype{book}.
There is one \bibfield{entrysubtype} supported:
@@ -581,31 +661,24 @@ cited in short form. See \sty{biblatex-sbl-test.pdf} for full details.
\end{valuelist}
-\typeitem{inbook}
-
-A part of a book which forms a self-contained unit with its own title.
-\biblatexsbl treats this as an alias for \bibtype{incollection}.
-
-\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. See §6.4.4 in
-\sty{biblatex-sbl-test.pdf} for an example.
-
\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-test.pdf}.
+type of supplementary material. See §6.2.14 of \sty{biblatex-sbl-test.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 \opt{options = \{skipbib=false\}} is set explicitly, a
+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.
@@ -617,10 +690,13 @@ parentheses following the \bibfield{postnote}. e.g.,
\samplecite{1}[15.18-19]{tacitus:ann:jackson}
\samplebib{tacitus}
\end{snugshade}
-
-If the entry contains \opt{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 \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:
@@ -636,7 +712,7 @@ 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}
+ \samplecite{1}[(28.3.5)252]{augustine:letters}
\samplebib{augustine:letters}
\end{snugshade}
@@ -646,13 +722,11 @@ always separated from the title by a space.
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. \biblatexsbl treats this as
-an alias for \bibtype{book}.
+overall author but it will usually have an editor.
\typeitem{mvcollection}
-A multi-volume \bibtype{collection}. \biblatexsbl treats this as an alias for
-\bibtype{mvbook}.
+A multi-volume \bibtype{collection}.
\typeitem{incollection}
@@ -669,8 +743,8 @@ 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.
-\biblatexsbl treats this as an alias to \bibtype{mvbook}.
+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}
@@ -680,24 +754,24 @@ 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}. Otherwise this entry is treated as an alias for
-\bibtype{incollection}.
+\opt{fullbibrefs}.
\typeitem{conferencepaper}
An unpublished paper presented at a professional society. Use the
-\bibfield{eventtitle}, \bibfield{venue}, and \bibfield{eventdate} fields to
-specify relevant detail for the conference.
+\bibfield{eventtitle}, \bibfield{venue}, and \bibfield{date} fields to
+specify detail for the conference. See §6.3.8 of \sty{biblatex-sbl-test.pdf}
+for and example.
\typeitem{lexicon}
-A single-volume lexicon or theological dictionary. \biblatexsbl treats this as
-an alias for \bibtype{book}.
+A single-volume lexicon or theological dictionary. This is similar to a
+\bibtype{book}.
\typeitem{mvlexicon}
-A multi-volume lexicon or theological dictionary. \biblatex treats this as an
-alias for \bibtype{mvbook}.
+A multi-volume lexicon or theological dictionary. This is similar to a
+\bibtype{mvbook}.
\typeitem{inlexicon}
@@ -707,8 +781,8 @@ 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 article title, only the name of the
-lexicon. e.g.,
+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}
@@ -716,52 +790,36 @@ lexicon. e.g.,
\samplebib{NIDNTT}
\end{snugshade}
-\typeitem{manual}
-
-Technical or other documentation, not necessarily in printed form. \biblatexsbl
-treats this as an alias for \bibtype{book}.
-
\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.
-This type is also set up to be able to insert an item into the list of
-abbreviations. So it is permissible to include just \bibfield{journaltitle}
-and \bibfield{shortjournal} or \bibfield{series} and \bibfield{shortseries},
-or \bibfield{shorthand} and relevant fields. In this case ensure that
-\bibfield{options = \{skipbib\}} is set.
-
\typeitem{online}
-An online resource without a print counterpart. \biblatexsbl treats this as an
-alias for \bibtype{article}.
-
-\typeitem{proceedings}
+An online resource without a print counterpart. This is similar to an
+\bibtype{article}.
-A single-volume conference proceedings. In \biblatexsbl this as an alias for
-\bibtype{collection}.
+\typeitem{periodical}
-\typeitem{mvproceedings}
+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.
-A multi-volume \bibtype{proceedings} entry. In \biblatexsbl this as an alias
-for \bibtype{mvcollection}.
-
-\typeitem{inproceedings}
-
-An article in a conference proceedings. In \biblatexsbl this as an alias for
-\bibtype{incollection}.
+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. \biblatexsbl treats this as an
-alias for \bibtype{book}.
+A single-volume encyclopaedia or dictionary. This is similar to a
+\bibtype{book}.
\typeitem{mvreference}
-A multi-volume \bibtype{reference}. \biblatexsbl treats this as an alias for
-\bibtype{mvbook}.
+A multi-volume \bibtype{reference}. This is similar to a \bibtype{mvbook}.
\typeitem{inreference}
@@ -774,45 +832,40 @@ above under \opt{fullbibrefs}.
\typeitem{review}
-A book review in a journal. This is similar to the \bibtype{article} entry
-type. Use the \bibfield{revdauthor}\slash\bibfield{revdeditor} and
-\bibfield{revdtitle} fields to specify the author\slash editor and title of
-the book being reviewed.
+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 a custom entry type for
-\biblatexsbl. See §6.4.11 of \sty{biblatex-sbl-test} for an example.
-
-\typeitem{set}
-
-An entry set. This entry type is special. See the \biblatex manual for
-details.
-
-\typeitem{thesis}
+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-test} for an example.
-A unpublishes thesis written for an educational institution to satisfy the
-requirements for a degree. Use the \bibfield{type} field to specify the type of
-thesis and the \bibfield{institution} to specify the educational institution.
+\typeitem{series}
-\typeitem{unpublished}
+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.
-A work with an author and a title which has not been formally published, such
-as a manuscript or the script of a talk. Use the fields howpublished and note
-to supply additional information in free format, if applicable.
-
-See §6.3.8 of \sty{biblatex-sbl-test} for an example.
+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 many of the entry fields outlined in the \biblatex
-manual. There are also a number of custom entry fields supported by
-\biblatexsbl. These are documented below.
+\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}
@@ -820,34 +873,46 @@ manual. There are also a number of custom entry fields supported by
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}.
-\listitem{maineditor}{name}
+The behaviour of \bibfield{translator}, \bibfield{booktranslator}, and
+\bibfield{maintranslator} is the same as for \bibfield{editor},
+\bibfield{bookeditor}, and \bibfield{maineditor}.
-The editor(s) of the \bibfield{maintitle}.
+\fielditem{eprintdate}{date}
-\listitem{maintranslator}{name}
+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-test.pdf}.
-The translator(s) of the \bibfield{maintitle}.
+\fielditem{eprintday}{datepart}
-\fielditem{releasedate}{date}
+This field holds the day component of the \bibfield{eprintdate} field.
-The date a text edition published online with no print counterpart is
-released. See §6.4.13 of \sty{biblatex-sbl-test.pdf}.
+\fielditem{eprintmonth}{datepart}
-\fielditem{releaseday}{datepart}
+This field holds the month component of the \bibfield{eprintdate} field.
-This field holds the day component of the \bibfield{releasedate} field.
+\fielditem{eprintyear}{datepart}
-\fielditem{releasemonth}{datepart}
+This field holds the year component of the \bibfield{eprintdate} field.
-This field holds the month component of the \bibfield{releasedate} field.
+\listitem{maineditor}{name}
+
+The editor(s) of the \bibfield{maintitle}.
-\fielditem{releaseyear}{datepart}
+\listitem{maintranslator}{name}
-This field holds the year component of the \bibfield{releasedate} field.
+The translator(s) of the \bibfield{maintitle}.
\listitem{revdauthor}{name}
@@ -874,10 +939,6 @@ The title of a book being reviewed.
An annex to the \bibfield{revdtitle}, to be printed in a different font.
-\listitem{revdtranslator}{name}
-
-The translator(s) of the \bibfield{revdtitle}.
-
\fielditem{seriesseries}{literal}
This field is used when a \bibfield{series} is begun anew to distinguish
@@ -887,10 +948,44 @@ between the old and new series. See \cite[§6.2.24]{SBLHS}.
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.
+
\listitem{withauthor}{name}
The author(s) who assist the \bibfield{author}. See \bibfield{witheditortype},
@@ -984,7 +1079,7 @@ This field is analogous to the \bibfield{withtranslatortype}, but for the
\end{fieldlist}
-\subsection{Entry Options}
+\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
@@ -1018,25 +1113,32 @@ For entries not containing a \bibfield{shorthand} just use the option
\item[false] Include the \bibfield{shortseries} in the list of abbreviations.
\end{valuelist}
-\optitem[true]{shorthand}{\opt{true}, \opt{false}, \opt{short}}
+\optitem[true]{usefullcite}{\opt{true}, \opt{false}}
-This option controls when and whether the \bibfield{shorthand} field is used
-as a citation.
+This options controls the format of first citations. The possible choices are:
\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[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]{usefullcite}{\opt{true}, \opt{false}}
+\optitem[true]{useseries}{\opt{true}, \opt{false}}
-This options controls the format of first citations. The possible choices are:
+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] 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.
+\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}}