diff options
author | Karl Berry <karl@freefriends.org> | 2017-01-16 23:12:25 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2017-01-16 23:12:25 +0000 |
commit | caa95c11d20fa882a04b0a0c8580e0015b840374 (patch) | |
tree | dbf1fb53b3fee11eb5121ed9af3a52ec186b7612 /Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex | |
parent | 4b61f97e62ad8f5277d9851da26809e8a080fa74 (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.tex | 410 |
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}} |