summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-05-20 21:24:30 +0000
committerKarl Berry <karl@freefriends.org>2018-05-20 21:24:30 +0000
commitad9c864ce4e52a636d20454491151145a174f4a6 (patch)
treee0fc97f051c60742dc88c8dbfdef54b67e774bee /Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
parent047296d0431e552d00d8de48124312fc45e5d3c2 (diff)
biblatex-sbl (20may18)
git-svn-id: svn://tug.org/texlive/trunk@47780 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.tex95
1 files changed, 46 insertions, 49 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 957491682d3..bd587669e74 100644
--- a/Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-sbl/biblatex-sbl.tex
@@ -9,8 +9,9 @@
\usepackage{realscripts}
\usepackage{xparse}
\usepackage{framed}
+\usepackage{enumitem}
-\usepackage[style=sbl,indexing=cite]{biblatex}
+\usepackage[style=sbl,indexing=cite,idemtracker=false,ibidtracker=false]{biblatex}
\addbibresource{biblatex-sbl.bib}
\hypersetup{colorlinks,citecolor=spot}
@@ -148,10 +149,11 @@ The style supports all examples given in the handbook (see
\sty{biblatex-sbl-test.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} is supported, but not enabled by default, as is indexing of
-names. 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}.
+\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
+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
@@ -162,9 +164,9 @@ output carefully checked when you use it.
\section{Requirements}
-\biblatexsbl requires at least version 3.5 of \biblatex and the \sty{xparse}
+\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}\slash\sty{polyglossia} and \sty{csquotes} are
+localization \sty{babel} (not \sty{polyglossia}) and \sty{csquotes} are
recommended.
\section{Usage}
@@ -175,7 +177,7 @@ defaults of the \cite{SBLHS}.
\begin{quote}
\begin{lstlisting}[style=latex]{}
\documentclass{article}
-\usepackage[style=sbl,backend=biber]{biblatex}
+\usepackage[style=sbl]{biblatex}
\addbibresource{<bibfile.bib>}
\begin{document}
\printbiblist{abbreviations}
@@ -188,57 +190,35 @@ defaults of the \cite{SBLHS}.
By default \biblatexsbl uses American style punctuation and quotation marks.
You can choose a different style by including the
-\sty{babel}\slash\sty{polyglossia} and \sty{csquotes} packages in your
-document preamble. e.g.,
+\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[german]{babel}
+\usepackage[ngerman]{babel}
\usepackage{csquotes}
-\usepackage[style=sbl,backend=biber]{biblatex}
+\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, you are probably better off with
-\sty{polyglossia} and \sty{xelatex} or \sty{lualatex}. e.g.,
+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{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}
+\usepackage[nil,bidi=default]{babel}
+\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,Scale=1.2]{SBL BibLit}
+\babelfont[polutonikogreek]{rm}[Ligatures=TeX,Contextuals=Alternate]{SBL BibLit}
\end{lstlisting}
\end{quote}
@@ -440,7 +420,7 @@ entry types.
\end{snugshade}
\end{valuelist}
-\optitem[false]{ibidtracker}{\opt{true}, \opt{false}, \opt{context},
+\optitem[constrict]{ibidtracker}{\opt{true}, \opt{false}, \opt{context},
\opt{strict}, \opt{constrict}}
This option controls the \emph{ibidem} tracker. The possible choices are:
@@ -474,7 +454,7 @@ 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}.
-\optitem[false]{idemtracker}{\opt{true}, \opt{false}, \opt{context},
+\optitem[constrict]{idemtracker}{\opt{true}, \opt{false}, \opt{context},
\opt{strict}, \opt{constrict}}
This option controls the \emph{idem} tracker. The possible choices are:
@@ -494,7 +474,7 @@ This option controls the \emph{idem} tracker. The possible choices are:
footnote.
\end{valuelist}
-\optitem[false]{pagetracker}{\opt{true}, \opt{false}}
+\optitem[true]{pagetracker}{\opt{true}, \opt{false}}
This option controls whether \emph{ibidem} and \emph{idem} are used across
page breaks or not.
@@ -1269,6 +1249,23 @@ e.g.,
\end{snugshade}
\end{quote}
+\section{Important Changes}
+
+\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]