summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex518
1 files changed, 442 insertions, 76 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
index b9af8f00077..faded946a33 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
@@ -36,6 +36,8 @@
\usepackage[listings, breakable, skins]{tcolorbox}%
\usetikzlibrary{arrows.meta}
\usetikzlibrary{shapes.geometric}
+\usetikzlibrary{fit}
+\usetikzlibrary{positioning}
\usepackage[style=ext-authoryear-iecomp, backend=biber]{biblatex}
\addbibresource{biblatex-examples.bib}
\addbibresource{biblatex-ext-examples.bib}
@@ -127,21 +129,25 @@
moretexcs = {
dimexpr,arraybackslash,newcolumntype,anchor,driver,plain,plainlang,
anchorlang,
- thefield,
+ thefield,bibstring,
+ addbibresource,
setlength,bibhang,addcomma,adddot,addperiod,addcolon,addspace,
addnbspace,
mkbibbold,mkbibemph,mkbibbrackets,mkbibparens,
usebibmacro,newbibmacro,renewbibmacro,setunit,newunit,printfield,printlist,
bibopenparen,bibcloseparen,bibopenbracket,bibclosebracket,
- iflistundef,iffieldundef,ifnameundef,
+ iflistundef,iffieldundef,ifnameundef,iffieldnums,
ExecuteBibliographyOptions,
defbibtabular,defbibtabulartwocolumn,defbibenvironment,
+ printbibliography,printbibtabular,
+ autocite,
DeclareFieldFormat,DeclareDelimFormat,DeclareDelimcontextAlias,
DeclareInnerCiteDelims,UndeclareInnerCiteDelims,DeclareInnerCiteDelimsAlias,
DeclareOuterCiteDelims,UndeclareOuterCiteDelims,DeclareOuterCiteDelimsAlias,
introcitepunct,volnumdelim,maintitletitledelim,voltitledelim,sernumdelim,
+ jourvoldelim,
volnumdatedelim,locdatedelim,locpubdelim,publocdelim,pubdatedelim,
- extradateonlycompcitedelim,introcitesep,introcitewidth,introcitesep,
+ extradateonlycompcitedelim,introcitesep,introcitewidth,introcitebreak,
DeclareOpenAccessFieldUrl,DeclareOpenAccessEprintUrl,
DeclareOpenAccessEprintAlias,DeclareOpenAccessUrlFieldPriority},
}
@@ -185,6 +191,10 @@
\newtcolorbox{warnbox}[1][]{%
enhanced,
+ before upper={
+ \parskip=0.5\baselineskip
+ \advance\parskip by 0pt plus 2pt
+ },
colframe=red, colback=red!5!white,
underlay={%
\path[draw=none] (interior.south east)
@@ -194,6 +204,10 @@
\newtcolorbox{remindbox}[1][]{%
enhanced,
+ before upper={
+ \parskip=0.5\baselineskip
+ \advance\parskip by 0pt plus 2pt
+ },
colframe=yellow, colback=yellow!5!white,
underlay={%
\path[draw=none] (interior.south east)
@@ -201,6 +215,10 @@
([xshift=15mm,yshift=.1cm]interior.north east);},
#1}
+\tikzset{
+ MWEcommentbox/.style={font=\sffamily\footnotesize, gray!60!darkgray},
+}
+
\AtUsedriver*{%
\let\newblock\relax
\let\abx@macro@bibindex\@empty
@@ -380,6 +398,8 @@
\AtEndPreamble{%
\deflength{\marglistwidth}{(\oddsidemargin+2cm)*85/100}}
+\newcommand{\tikzmark}[2][]{\tikz[overlay,remember picture] \node (#2) {#1};}
+
\newcommand*{\tikztextmark}[2]{%
\tikz[remember picture,baseline,inner sep=0pt]\node [anchor=base] (#1) {#2};}
@@ -455,7 +475,7 @@
\newcommand*{\ctan}{\mkbibacro{CTAN}}
\newcommand*{\gitbaseurl}{https://github.com/moewew/biblatex-ext}
-\newcommand*{\extblxversion}{0.8f}
+\newcommand*{\extblxversion}{0.8g}
\newcommand*{\biber}{Biber}
\newcommand*{\gitissuelink}[1]{%
\href{\gitbaseurl/issues/#1}{issue \##1 on github}}
@@ -528,7 +548,7 @@
author = {Moritz Wemheuer},
link = {mwemheu@gmail.com},%
revision = {\extblxversion},
- date = {\DTMDate{2020-05-09}},
+ date = {\DTMDate{2020-08-09}},
}
\hypersetup{%
@@ -617,7 +637,7 @@ applicable to the styles of this bundle, but you may break some of their
features if you happen to modify something that the \blxstyle{ext-} styles
redefine themselves.
While many contributed \sty{biblatex} styles are examples of good \sty{biblatex}
-style coding, this can not be said of all of the files included in this bundle.
+style coding, this cannot be said of all of the files included in this bundle.
Especially the citation styles for compact citations have to work harder
to implement the citation delimiter feature properly.
So if you want to get inspired for your \sty{biblatex} coding, be warned that
@@ -632,7 +652,7 @@ At the time of writing the latest version of \sty{biblatex} is
\biblatexversion{} (dated \biblatexdate),
that version is required for the styles to work properly.
A warning will be issued if you use an older version.
-You may choose to ignore that warning, but the styles can not be guaranteed to
+You may choose to ignore that warning, but the styles cannot be guaranteed to
work properly in that case:
you might get other warnings or errors, and some features of the style might
just fail silently.
@@ -763,7 +783,11 @@ The \blxstyle{ext-} styles only build on top of the standard files.
\styleitem{ext-numeric}
An extended version of the standard \blxstyle{numeric} style for citations with
numeric labels.
-\begin{bibexample}[]
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-numeric]{biblatex}
+\end{lstlisting}
+\tcblower
[1, 2, 5, 6, 7]
\end{bibexample}
@@ -771,7 +795,11 @@ numeric labels.
An extended version of the standard \blxstyle{numeric-comp} style.
Similar to \blxstyle{ext-numeric}, but citation labels are
compressed to give \enquote{[1--3]} instead of \enquote{[1, 2, 3]}.
-\begin{bibexample}[]
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-numeric-comp]{biblatex}
+\end{lstlisting}
+\tcblower
[1, 2, 5--7]
\end{bibexample}
@@ -779,14 +807,22 @@ compressed to give \enquote{[1--3]} instead of \enquote{[1, 2, 3]}.
An extended version of the standard \blxstyle{numeric-verb} style.
This style is similar to the \blxstyle{numeric} style, but each citation label
is in its own set of brackets: \enquote{[1], [2], [3]}.
-\begin{bibexample}[]
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-numeric-verb]{biblatex}
+\end{lstlisting}
+\tcblower
[1], [3], [5], [6], [7]
\end{bibexample}
\styleitem{ext-alphabetic}
An extended version of the standard \blxstyle{alphabetic} style for citations
with alphabetic labels derived from author name and year.
-\begin{bibexample}[]
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-alphabetic]{biblatex}
+\end{lstlisting}
+\tcblower
[SR98, Knu86c]
\end{bibexample}
@@ -795,7 +831,11 @@ An extended version of the standard \blxstyle{alphabetic-verb} style.
This style is based on \blxstyle{ext-alphabetic}, but like
\blxstyle{ext-numeric-verb} places each citation label in its own pair of
brackets: \enquote{[SR98], [Knu86c]}.
-\begin{bibexample}[]
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-alphabetic-verb]{biblatex}
+\end{lstlisting}
+\tcblower
[SR98], [Knu86c]
\end{bibexample}
@@ -803,6 +843,10 @@ brackets: \enquote{[SR98], [Knu86c]}.
An extended version of the standard \blxstyle{authoryear} style for citations
using author name and year.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde 1998
\end{bibexample}
@@ -813,6 +857,10 @@ but several works by the same author are compressed by not displaying the
author multiple times: \enquote{Knuth 1984, 1986} instead of
\enquote{Knuth 1984; Knuth 1986}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-comp]{biblatex}
+\end{lstlisting}
+\tcblower
Knuth 1984, 1986
\end{bibexample}
@@ -821,6 +869,10 @@ An extended version of the standard \blxstyle{authoryear-ibid} style.
This style is similar to \blxstyle{ext-authoryear}, but repeated citations are
replaced with \enquote{ibidem}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-ibid]{biblatex}
+\end{lstlisting}
+\tcblower
Knuth 1984\quad ibid.
\end{bibexample}
@@ -829,6 +881,10 @@ An extended version of the standard \blxstyle{authoryear-icomp} style.
This style combines the two styles \blxstyle{ext-authoryear-comp} and
\blxstyle{ext-authoryear-ibid}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-icomp]{biblatex}
+\end{lstlisting}
+\tcblower
Knuth 1984, 1986 \quad Sigfridsson and Ryde 1998 \quad ibid.
\end{bibexample}
@@ -836,6 +892,10 @@ Knuth 1984, 1986 \quad Sigfridsson and Ryde 1998 \quad ibid.
An extended version of the standard \blxstyle{authortitle} style for citations
by author and title.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authortitle]{biblatex}
+\end{lstlisting}
+\tcblower
Maron, \emph{Animal Triste}
\end{bibexample}
@@ -846,6 +906,10 @@ citations by the same author just like \blxstyle{ext-author\-year-comp}:
\enquote{Aristotle, \emph{Physics}, \emph{Poetics}} instead of
\enquote{Aristotle, \emph{Physics}; Aristotle, \emph{Poetics}}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authortitle-comp]{biblatex}
+\end{lstlisting}
+\tcblower
Aristotle, \emph{Physics}, \emph{Poetics}
\end{bibexample}
@@ -854,6 +918,10 @@ An extended version of the standard \blxstyle{authortitle-ibid} style.
This style is similar to \blxstyle{ext-authortitle}, but replaces repeated
citations of the same work with \enquote{ibidem}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authortitle-ibid]{biblatex}
+\end{lstlisting}
+\tcblower
Maron, \emph{Animal Triste}\quad ibid.
\end{bibexample}
@@ -862,6 +930,10 @@ An extended version of the standard \blxstyle{authortitle-icomp} style.
This style combines \blxstyle{ext-authortitle-comp} and
\blxstyle{ext-authortitle-ibid}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authortitle-icomp]{biblatex}
+\end{lstlisting}
+\tcblower
Aristotle, \emph{Physics}, \emph{Poetics}\quad Maron, \emph{Animal Triste}\quad
ibid.
\end{bibexample}
@@ -871,6 +943,10 @@ An extended version of the standard \blxstyle{authortitle-terse} style.
This style is similar to \blxstyle{ext-authortitle}, but the title is omitted
in citations if there is only one work by the relevant author.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authortitle-terse]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde \quad Aristotle, \emph{Physics}; Aristotle, \emph{Poetics}
\end{bibexample}
@@ -879,6 +955,10 @@ An extended version of the standard \blxstyle{authortitle-tcomp} style.
This style combines \blxstyle{ext-authortitle-terse} and
\blxstyle{ext-authortitle-comp}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authortitle-tcomp]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde \quad Aristotle, \emph{Physics}, \emph{Poetics}
\end{bibexample}
@@ -887,6 +967,10 @@ An extended version of the standard \blxstyle{authortitle-ticomp} style.
This style combines \blxstyle{ext-authortitle-terse},
\blxstyle{ext-authortitle-comp} and \blxstyle{ext-authortitle-ibid}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authortitle-ticomp]{biblatex}
+\end{lstlisting}
+\tcblower
Aristotle, \emph{Physics}, \emph{Poetics} \quad Sigfridsson and Ryde \quad ibid.
\end{bibexample}
@@ -935,6 +1019,10 @@ An author-year citation that is even more compact than
\blxstyle{ext-authoryear-comp}, it compresses lists of \bibfield{extradate}
letters from \enquote{Knuth 1986a,b,c} to \enquote{Knuth 1986a\bibrangedash c}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-ecomp]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde 1998 \quad Knuth 1986a\bibrangedash c
\end{bibexample}
@@ -943,6 +1031,10 @@ An author-year citation that is even more compact than
\blxstyle{ext-authoryear-icomp}, it compresses lists of \bibfield{extradate}
letters from \enquote{Knuth 1986a,b,c} to \enquote{Knuth 1986a\bibrangedash c}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-iecomp]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde 1998 \quad ibid.\quad Knuth 1986a\bibrangedash c
\end{bibexample}
@@ -952,6 +1044,10 @@ one work in the bibliography.
This style is like \blxstyle{ext-authortitle-terse}, but it is based on
\blxstyle{ext-authoryear} and not on \blxstyle{ext-authortitle}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-terse]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde \quad Knuth 1984 \quad Knuth 1986
\end{bibexample}
@@ -961,6 +1057,10 @@ with only one work in the bibliography.
This style is like \blxstyle{ext-authortitle-tcomp}, but it is based on
\blxstyle{ext-authoryear} and not on \blxstyle{ext-authortitle}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-tcomp]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde \quad Knuth 1984, 1986
\end{bibexample}
@@ -968,6 +1068,10 @@ Sigfridsson and Ryde \quad Knuth 1984, 1986
A compact author-year citation style that combines
\blxstyle{ext-authoryear-tcomp} and \blxstyle{ext-authoryear-ecomp}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-tecomp]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde \quad Knuth 1984, 1986a\bibrangedash c
\end{bibexample}
@@ -977,6 +1081,10 @@ suppresses years for author lists with only one work in the bibliography.
This style is like \blxstyle{ext-authortitle-ticomp}, but it is based on
\blxstyle{ext-authoryear} and not on \blxstyle{ext-authortitle}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-ticomp]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde \quad ibid. \quad Knuth 1984, 1986
\end{bibexample}
@@ -984,6 +1092,10 @@ Sigfridsson and Ryde \quad ibid. \quad Knuth 1984, 1986
A compact author-year citation style that combines
\blxstyle{ext-authoryear-ticomp} and \blxstyle{ext-authoryear-iecomp}.
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authoryear-tiecomp]{biblatex}
+\end{lstlisting}
+\tcblower
Sigfridsson and Ryde \quad ibid. \quad Knuth 1984, 1986a\bibrangedash c
\end{bibexample}
@@ -1039,15 +1151,20 @@ necessary to modify the bibmacro~\bibmacro{in:}.
\boolitem[false]{citexref}
This option controls if \bibtype{inbook}, \bibtype{incollection} and
\bibtype{inproceedings} entries that are tied to a parent entry with
-\bibfield{xref} or \bibfield{crossref} should cite their parent in the
-bibliography \emph{if} the parent is listed in the bibliography as a
+\bibfield{xref} or \bibfield{crossref} should show all data of their
+parent entry inline as usual or if they should cite their parent entry
+instead \emph{if} the parent is listed in the bibliography as a
separate entry.
With the default setting \kvopt{citexref}{false} the parent is not
cited, the entry is shown as in the standard styles.
If the option is set to \optval{true}, the block following the
-\enquote{in:} is replaced by a citation to the parent entry.
+\enquote{in:} with the parent data is replaced by a citation to the
+parent entry and thus becomes more compact.
\begin{remindbox}
+Parent entries will only be cited by this feature
+if they appear in the bibliography.
+
The option itself does \emph{not} cause the parent entry to be added
to the bibliography automatically.
This needs to happen either explicitly by citing the parent
@@ -1069,7 +1186,7 @@ or implicitly via the \opt{minxrefs} or \opt{mincrossrefs} option.
{\usebibmacro{#1}}}}
\makeatother
\toggletrue{bbx:citexref}
-\exampleprintbib{westfahl:space}
+\exampleprintbib{westfahl:space,westfahl:frontier}
\end{bibexample}
\begin{bibexample}[title={\kvopt{citexref}{false}}]
@@ -1085,7 +1202,7 @@ or implicitly via the \opt{minxrefs} or \opt{mincrossrefs} option.
{\usebibmacro{#1}}}}
\makeatother
\togglefalse{bbx:citexref}
-\exampleprintbib{westfahl:space}
+\exampleprintbib{westfahl:space,westfahl:frontier}
\end{bibexample}
\boolitem[false]{innamebeforetitle}
@@ -1347,7 +1464,7 @@ lists are only replaced if they are indistinguishable in the data source.
The \opt{introcite} option is available for the bibliography styles of the
\hyperblxstyle[ext-authoryear]{authoryear} and
\hyperblxstyle[ext-authortitle]{authortitle} family.
-It can not be used with citation styles of the
+It cannot be used with citation styles of the
\hyperblxstyle[ext-verbose]{verbose} family, where
it may produce undesired output or errors.
The option is available globally and on a per-type and per-entry level, where
@@ -1484,6 +1601,11 @@ overlay={%
\begin{bibexample}[enhanced, title={\kvopt{introcite}{label} with empty
\cs{introcitebreak}}]
+\begin{lstlisting}[style=extblxstylelatex]
+%\usepackage[..., introcite=label]{biblatex}
+\renewcommand*{\introcitebreak}{}
+\end{lstlisting}
+\tcblower
\renewcommand*{\introcitebreak}{}
\setlength{\introcitewidth}{1.8cm}
\csuse{extblx@opt@dashed@false}
@@ -1494,6 +1616,12 @@ overlay={%
\begin{bibexample}[enhanced, title={\kvopt{introcite}{label} with
\len{introcitewidth} set to zero and \len{introcitesep} equal to
\len{bibhang}}]
+\begin{lstlisting}[style=extblxstylelatex]
+%\usepackage[..., introcite=label]{biblatex}
+\setlength{\introcitewidth}{0pt}
+\setlength{\introcitesep}{\bibhang}
+\end{lstlisting}
+\tcblower
\setlength{\introcitewidth}{0pt}
\setlength{\introcitesep}{\bibhang}
\csuse{extblx@opt@dashed@false}
@@ -1530,6 +1658,7 @@ The default settings for \cmd{bbx@introcite} emulate the output of \cmd{cite}.
\begin{bibexample}[title={Example customisations for \kvopt{introcite}{plain}}]
\begin{lstlisting}[style=extblxstylelatex]
+%\usepackage[..., introcite=plain]{biblatex}
\DeclareFieldFormat{bbx@introcite}{\mkbibbrackets{#1}}
\DeclareDelimFormat[bbx@introcite]{nameyeardelim}{\addcomma\space}
\UndeclareInnerCiteDelims{bbx@introcite}
@@ -1545,8 +1674,23 @@ The default settings for \cmd{bbx@introcite} emulate the output of \cmd{cite}.
\exampleprintbib{sigfridsson}
\end{bibexample}
+\begin{bibexample}[title={Example customisations for \kvopt{introcite}{plain}}]
+\begin{lstlisting}[style=extblxstylelatex]
+%\usepackage[..., introcite=plain]{biblatex}
+\DeclareFieldFormat{bbx@introcite}{\mkbibbold{#1}}
+\renewcommand*{\introcitepunct}{\\}
+\end{lstlisting}
+\tcblower
+\DeclareFieldFormat{bbx@introcite}{\mkbibbold{#1}}
+\renewcommand*{\introcitepunct}{\\}
+\csuse{extblx@opt@dashed@false}
+\csletcs{extblx@introcite}{extblx@opt@introcite@plain}
+\exampleprintbib{sigfridsson}
+\end{bibexample}
+
\begin{bibexample}[title={Example customisations for \kvopt{introcite}{label}}]
\begin{lstlisting}[style=extblxstylelatex]
+%\usepackage[..., introcite=label]{biblatex}
\DeclareFieldFormat{bbx@introcite}{\mkbibbold{#1}}
\DeclareDelimFormat[bbx@introcite]{nameyeardelim}{\addspace}
\DeclareInnerCiteDelims{bbx@introcite}{\bibopenparen}{\bibcloseparen}
@@ -1574,6 +1718,18 @@ back to the end of the entry.
\makeatletter
\begin{bibexample}[enhanced, title={\kvopt{introcite}{label} with
\kvopt{style}{ext-authoryear} and \kvopt{bibstyle}{ext-authortitle}}]
+\begin{lstlisting}[style=extblxstylelatex]
+%\usepackage[
+% citestyle=ext-authoryear,
+% bibstyle=ext-authortitle,
+% sorting=nyt,
+% introcite=label,
+% ...
+%]{biblatex}
+\setlength{\introcitewidth}{0pt}
+\setlength{\introcitesep}{\bibhang}
+\end{lstlisting}
+\tcblower
\setlength{\introcitewidth}{0pt}
\setlength{\introcitesep}{\bibhang}
\bbx@opt@mergedate@false
@@ -1617,6 +1773,7 @@ directives instead.
Field formats can be modified with \cmd{DeclareFieldFormat}.
\begin{bibfieldformatlist}
+
\bibfieldformatitem{biblabeldate} The format for the labeldate in the
bibliography for \hyperblxstyle[ext-authoryear]{authoryear}-like styles.
The default is to wrap the date in round brackets.
@@ -1626,6 +1783,20 @@ Field formats can be modified with \cmd{DeclareFieldFormat}.
\highlight{\bibcloseparen}}
\exampleprintbib{sigfridsson}
\end{bibexample}
+\begin{bibexample}[title={Customisation example for
+ \bibfieldformat{biblabeldate}}]
+\begin{lstlisting}[style=extblxstylelatex]
+\DeclareFieldFormat{biblabeldate}{|1#11|}
+\DeclareDelimFormat[bib]{nameyeardelim}{|2\addperiod\space2|}
+\end{lstlisting}
+\tcblower
+\togglefalse{bbx:doi}
+\DeclareFieldFormat{biblabeldate}{\highlight[1]{#1}}
+\DeclareDelimFormat[bib]{nameyeardelim}{\highlight[2]{\textbf{%
+ \addperiod}\textvisiblespace}\bibsentence}
+\exampleprintbib{sigfridsson}
+\end{bibexample}
+
\bibfieldformatitem{biblistlabeldate} Like \bibfieldformat{biblabeldate},
but for bibliography lists created by \cmd{printbiblist}.
@@ -1635,7 +1806,7 @@ Field formats can be modified with \cmd{DeclareFieldFormat}.
\bibfield{date} information for \bibtype{article}s. By default this block is
wrapped in round brackets.
\begin{bibexample}
- \makeatletter\bbx@opt@mergedate@false\makeatother
+ \csuse{bbx@opt@mergedate@false}%
\togglefalse{bbx:doi}
\DeclareFieldFormat{issuedate}{\highlight{\bibopenparen}\highlight[2]{#1}%
\highlight{\bibcloseparen}}
@@ -1732,8 +1903,15 @@ It is probably too late now.}
\addperiod}\textvisiblespace}\bibsentence}% <- hacky & hard-coded!
\exampleprintbib{pines}
\end{bibexample}
+\begin{remindbox}
Note that \bibfieldformat{editortype} and \cmd{editortypedelim}
-were changed for this example to avoid punctuation clashes.
+were changed to
+\begin{biblatexcode}
+\DeclareFieldFormat{editortype}{\mkbibparens{#1}}
+\DeclareDelimFormat{editortypedelim}{\addspace}
+\end{biblatexcode}
+in this example to avoid punctuation clashes.
+\end{remindbox}
Since \cmd{nametitledelim} and \cmd{innametitledelim} are independent,
the following output is easily achieved.
@@ -1802,6 +1980,17 @@ The punctuation between \bibfield{title}\slash\bibfield{subtitle} and
\textvisiblespace}\bibsentence}%<- hacky & hard-coded!
\exampleprintbib{salam}
\end{bibexample}
+\begin{bibexample}[title={Example customisation of \cmd{titleaddonpunct}}]
+\begin{lstlisting}[style=extblxstylelatex]
+\DeclareFieldFormat{booktitleaddon}{\mkbibbrackets{#1}}
+\renewcommand*{\titleaddonpunct}{\addspace}
+\end{lstlisting}
+\tcblower
+\DeclareFieldFormat{booktitleaddon}{\mkbibbrackets{#1}}
+\renewcommand*{\titleaddonpunct}{\addspace}
+\renewbibmacro*{event+venue+date}{}
+\exampleprintbib{salam}
+\end{bibexample}
\csitem{jourvoldelim}
The delimiter between the \bibfield{journaltitle} and \bibfield{volume} fields
@@ -1810,7 +1999,25 @@ The default is a space.
\begin{bibexample}
\togglefalse{bbx:doi}
\renewcommand*{\jourvoldelim}{\highlight{\textvisiblespace}}
-\makeatletter\bbx@opt@mergedate@false\makeatother
+\csuse{bbx@opt@mergedate@false}%
+\exampleprintbib{sigfridsson}
+\end{bibexample}
+
+\begin{bibexample}[title={Example customisation of \cmd{jourvoldelim}
+ and \cmd{volnumdelim}}]
+\begin{lstlisting}[style=extblxstylelatex]
+\DeclareFieldFormat[article,periodical]{volume}{\bibstring{jourvol}~#1}
+\DeclareFieldFormat[article,periodical]{number}{\bibstring{number}~#1}
+\renewcommand*{\jourvoldelim}{\addcomma\space}
+\renewcommand*{\volnumdelim}{\addcomma\space}
+\end{lstlisting}
+\tcblower
+\togglefalse{bbx:doi}
+\DeclareFieldFormat[article,periodical]{volume}{\bibstring{jourvol}~#1}
+\DeclareFieldFormat[article,periodical]{number}{\bibstring{number}~#1}
+\renewcommand*{\jourvoldelim}{\addcomma\space}
+\renewcommand*{\volnumdelim}{\addcomma\space}
+\csuse{bbx@opt@mergedate@false}%
\exampleprintbib{sigfridsson}
\end{bibexample}
@@ -1820,10 +2027,10 @@ for \bibtype{article}.
The default is \cmd{newunitpunct}.
\begin{bibexample}
\togglefalse{bbx:doi}
+\csuse{bbx@opt@mergedate@false}%
\renewcommand*{\jourserdelim}{\highlight{\textbf{\addperiod}\textvisiblespace}%
\bibsentence% <- hacky ...
}% <- hard-coded!
-\makeatletter\bbx@opt@mergedate@false\makeatother
\exampleprintbib{reese,shore}
\end{bibexample}
@@ -1833,8 +2040,8 @@ for \bibtype{article}.
The default is \hypercmd{jourvoldelim}.
\begin{bibexample}
\togglefalse{bbx:doi}
+\csuse{bbx@opt@mergedate@false}%
\renewcommand*{\servoldelim}{\highlight{\textvisiblespace}}% <- hard-coded!
-\makeatletter\bbx@opt@mergedate@false\makeatother
\exampleprintbib{reese,shore}
\end{bibexample}
@@ -1844,8 +2051,20 @@ date information for \bibtype{article}.
The default is a space.
\begin{bibexample}
\togglefalse{bbx:doi}
+\csuse{bbx@opt@mergedate@false}%
\renewcommand*{\volnumdatedelim}{\highlight{\textvisiblespace}}
-\makeatletter\bbx@opt@mergedate@false\makeatother
+\exampleprintbib{sigfridsson}
+\end{bibexample}
+\begin{bibexample}[title={Example customisation of \cmd{volnumdatedelim}}]
+\begin{lstlisting}[style=extblxstylelatex]
+\DeclareFieldFormat{issuedate}{#1}
+\renewcommand*{\volnumdatedelim}{\addcomma\space}
+\end{lstlisting}
+\tcblower
+\togglefalse{bbx:doi}
+\csuse{bbx@opt@mergedate@false}%
+\DeclareFieldFormat{issuedate}{#1}
+\renewcommand*{\volnumdatedelim}{\addcomma\space}
\exampleprintbib{sigfridsson}
\end{bibexample}
@@ -1860,6 +2079,18 @@ The default is a dot.
\exampleprintbib{sigfridsson}
\end{bibexample}
+\begin{bibexample}[title={Example customisation of~\cmd{volnumdelim}}]
+\begin{lstlisting}[style=extblxstylelatex]
+\DeclareFieldFormat[article,periodical]{number}{\mkbibparens{#1}}
+\renewcommand*{\volnumdelim}{}
+\end{lstlisting}
+\tcblower
+\togglefalse{bbx:doi}
+\DeclareFieldFormat[article,periodical]{number}{\mkbibparens{#1}}
+\renewcommand*{\volnumdelim}{}
+\exampleprintbib{sigfridsson}
+\end{bibexample}
+
\csitem{sernumdelim}
The delimiter between \bibfield{series} and \bibfield{number} for
\bibtype{book}- and \bibtype{inbook}-like entries.
@@ -1874,7 +2105,7 @@ The delimiter between \bibfield{location} and \bibfield{date}.
The default is a comma followed by a space.
\begin{bibexample}
\renewcommand*{\locdatedelim}{\highlight{\textbf{\addcomma}\textvisiblespace}}
-\makeatletter\bbx@opt@mergedate@false\makeatother
+\csuse{bbx@opt@mergedate@false}%
\exampleprintbib{jaffe}
\end{bibexample}
@@ -1883,7 +2114,7 @@ The delimiter between \bibfield{location} and \bibfield{publisher}\slash%
\bibfield{organization}\slash\bibfield{institution}.
The default is a colon followed by a space.
\begin{bibexample}
-\makeatletter\bbx@opt@mergedate@false\makeatother
+\csuse{bbx@opt@mergedate@false}%
\renewcommand*{\locpubdelim}{\highlight{\textbf{\addcolon}\textvisiblespace}}
\exampleprintbib{knuth:ct:a}
\end{bibexample}
@@ -1901,7 +2132,9 @@ You could use \cmd{publocdelim} if you changed the order of these
fields to \bibfield{publisher}\slash\bibfield{organization}\slash
\bibfield{institution}, \bibfield{location} \bibfield{date} by
redefining the bibmacro~\bibmacro{pubinstorg+location+date} as follows.
-\begin{biblatexcode}
+\begin{bibexample}[title={Example use of \cmd{publocdelim}
+ and \cmd{locdatedelim}}]
+\begin{lstlisting}[style=extblxstylelatex]
\renewbibmacro*{pubinstorg+location+date}[1]{%
\printlist{#1}%
\setunit*{|1\publocdelim1|}%
@@ -1909,8 +2142,8 @@ redefining the bibmacro~\bibmacro{pubinstorg+location+date} as follows.
\setunit*{|2\locdatedelim2|}%
\usebibmacro{date}%
\newunit}
-\end{biblatexcode}
-\begin{bibexample}
+\end{lstlisting}
+\tcblower
\renewcommand*{\publocdelim}{\highlight[1]{\textbf{\addcomma}\textvisiblespace}}
\renewcommand*{\locdatedelim}{\highlight[2]{%
\textbf{\addcomma}\textvisiblespace}}
@@ -1921,7 +2154,7 @@ redefining the bibmacro~\bibmacro{pubinstorg+location+date} as follows.
\setunit*{\locdatedelim}%
\usebibmacro{date}%
\newunit}
-\makeatletter\bbx@opt@mergedate@false\makeatother
+\csuse{bbx@opt@mergedate@false}%
\exampleprintbib{knuth:ct:a}
\end{bibexample}
@@ -1932,7 +2165,15 @@ The delimiter between \bibfield{publisher}\slash\bibfield{organization}\slash
The default is a comma followed by a space.
\begin{bibexample}
\renewcommand*{\pubdatedelim}{\highlight{\textbf{\addcomma}\textvisiblespace}}
-\makeatletter\bbx@opt@mergedate@false\makeatother
+\csuse{bbx@opt@mergedate@false}%
+\exampleprintbib{knuth:ct:a}
+\end{bibexample}
+\begin{bibexample}[title={Example customisation of \cmd{pubdatedelim}}]
+\begin{lstlisting}[style=extblxstylelatex]
+\renewcommand*{\pubdatedelim}{\addspace}
+\end{lstlisting}
+\renewcommand*{\pubdatedelim}{\addspace}
+\csuse{bbx@opt@mergedate@false}%
\exampleprintbib{knuth:ct:a}
\end{bibexample}
@@ -2007,7 +2248,7 @@ Style family & \cmd{cite} & \cmd{parencite} & \cmd{textcite}\\
\midrule
\blxstyle{alphabetic} & \highlightbf[1]{[}Knu84\highlightbf[1]{]} &
\highlightbf[1]{[}Knu84\highlightbf[1]{]} & \highlightbf[1]{\hmpdl}Knuth
- \highlightbf[2]{[}2\highlightbf[2]{]}\highlightbf[1]{\hmpdr}\\
+ \highlightbf[2]{[}Knu84\highlightbf[2]{]}\highlightbf[1]{\hmpdr}\\
\blxstyle{numeric} & \highlightbf[1]{[}2\highlightbf[1]{]} &
\highlightbf[1]{[}2\highlightbf[1]{]} & \highlightbf[1]{\hmpdl}Knuth
\highlightbf[2]{[}2\highlightbf[2]{]}\highlightbf[1]{\hmpdr}\\
@@ -2051,7 +2292,7 @@ errors when arbitrary grouping such as
or \enquote{\prm{opening delimiter}\allowbreak text\allowbreak
\{\prm{closing delimiter}\}}
is introduced.
-It can not be guaranteed that the opening and closing delimiters are executed
+It cannot be guaranteed that the opening and closing delimiters are executed
at the same level of grouping, let alone in the same group.
As mentioned above, this approach is not suitable to wrap the citation up in a
wrapper command, i.e.\ to pass the entire output of the citation command as
@@ -2162,26 +2403,38 @@ Citation command & Outer & Inner\\
\end{table}
-The \hyperblxstyle[ext-authoryear]{authoryear} and
-\hyperblxstyle[ext-authortitle]{authortitle} styles have \cmd{parencite},
-e.g.\ \parencite{knuth:ct:a}, \parencite{sigfridsson}, set up with
-\begin{biblatexcode}
+The default setup for \hyperblxstyle{ext-authoryear} mirroring
+the standard \blxstyle{authoryear} is as follows.
+%
+\begin{bibexample}[title={\cmd{parencite} setup of
+ \blxstyle{ext-authoryear}}]
+\begin{lstlisting}[style=extblxstylelatex]
\DeclareOuterCiteDelims{parencite}{\bibopenparen}{\bibcloseparen}
\DeclareInnerCiteDelims{parencite}{}{}
-\end{biblatexcode}
-and \cmd{textcite}, e.g.\ \textcite{knuth:ct:a}, \textcite{sigfridsson}, with
-\begin{biblatexcode}
+\end{lstlisting}
+\tcblower
+lorem \parencite{knuth:ct:a} ipsum \parencite{sigfridsson}
+\end{bibexample}
+%
+\begin{bibexample}[title={\cmd{textcite} setup of
+ \blxstyle{ext-authoryear}}]
+\begin{lstlisting}[style=extblxstylelatex]
\DeclareOuterCiteDelims{textcite}{}{}
\DeclareInnerCiteDelims{textcite}{\bibopenparen}{\bibcloseparen}
-\end{biblatexcode}
-If you wanted \cmd{parencite} of \hyperblxstyle[ext-authoryear]{authoryear}
+\end{lstlisting}
+\tcblower
+lorem \textcite{knuth:ct:a} ipsum \textcite{sigfridsson}
+\end{bibexample}
+%
+If you wanted \cmd{parencite} of \hyperblxstyle{ext-authoryear}
to look like \enquote{[Sigfridsson and Worman (1998)]} you would use
-\begin{biblatexcode}
-\DeclareOuterCiteDelims{parencite}{|1\bibopenbracket1|}{|1\bibclosebracket1|}
-\DeclareInnerCiteDelims{parencite}{|2\bibopenparen2|}{|2\bibcloseparen2|}
-\end{biblatexcode}
\citereset
\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\DeclareOuterCiteDelims{parencite}{|1\bibopenbracket1|}{|1\bibclosebracket1|}
+\DeclareInnerCiteDelims{parencite}{|2\bibopenparen2|}{|2\bibcloseparen2|}
+\end{lstlisting}
+\tcblower
\DeclareOuterCiteDelims{parencite}{\highlightbf[1]{\bibopenbracket}}{%
\highlightbf[1]{\bibclosebracket}}
\DeclareInnerCiteDelims{parencite}{\highlightbf[2]{\bibopenparen}}{%
@@ -2216,12 +2469,64 @@ fields will be printed by \bibmacro{maintitle+title} or
{}%
\newunit
\printfield{volumes}}}
+\csuse{bbx@opt@mergedate@false}%
\exampleprintbib{knuth:ct,matuz:doody}
\end{bibexample}
\keyitem[edition]
A bibliography macro to print the \bibfield{edition} field, this avoids a direct
\lstinline|\printfield{edition}| in the bibliography drivers.
+This bibliography macro is particularly useful to suppress the
+\bibfield{edition} field in its standard position to print it elsewhere
+without having to use \cmd{clearfield}, \cmd{savefield} and \cmd{restorefield}.
+\begin{bibexample}[title={Example use of the \bibmacro{edition} bibmacro
+ for superscript edition before date}]
+\begin{lstlisting}[style=extblxstylelatex]
+\renewbibmacro*{edition}{}
+
+\DeclareFieldFormat{superedition}{\textsuperscript{#1}}
+\newbibmacro*{superedition}{%
+ \iffieldnums{edition}
+ {\printfield[superedition]{edition}}
+ {\printfield{edition}%
+ \setunit{\addspace}}}
+
+\renewcommand*{\pubdatedelim}{\addspace}
+\renewcommand*{\locdatedelim}{\pubdatedelim}
+\renewbibmacro*{pubinstorg+location+date}[1]{%
+ \printlist{location}%
+ \iflistundef{#1}
+ {\setunit*{\locdatedelim}}
+ {\setunit*{\locpubdelim}}%
+ \printlist{#1}%
+ \setunit*{\pubdatedelim}%
+ \usebibmacro{superedition}%
+ \usebibmacro{date}%
+ \newunit}
+\end{lstlisting}
+\tcblower
+\renewbibmacro*{edition}{}
+\DeclareFieldFormat{superedition}{\textsuperscript{#1}}
+\newbibmacro*{superedition}{%
+ \iffieldnums{edition}
+ {\printfield[superedition]{edition}}
+ {\printfield{edition}%
+ \setunit{\addspace}}}
+\renewcommand*{\pubdatedelim}{\addspace}
+\renewcommand*{\locdatedelim}{\pubdatedelim}
+\renewbibmacro*{pubinstorg+location+date}[1]{%
+ \printlist{location}%
+ \iflistundef{#1}
+ {\setunit*{\locdatedelim}}
+ {\setunit*{\locpubdelim}}%
+ \printlist{#1}%
+ \setunit*{\pubdatedelim}%
+ \usebibmacro{superedition}%
+ \usebibmacro{date}%
+ \newunit}
+\csuse{bbx@opt@mergedate@false}%
+\exampleprintbib{malinowski}
+\end{bibexample}
\keyitem[version]
Similar to the \hyperbibmacro{edition} bibliography macro, \bibmacro{version}
@@ -2409,13 +2714,22 @@ The package also defines two helpful bibliography macros.
\end{keymarglistbook}
A simple example of a useful tabular bibliography setup is
-\begin{biblatexcode}
-\usepackage{longtable}
+\begin{bibexample}[breakable,
+ title={Example document with tabular bibliography}]
+\begin{lstlisting}[style=extblxstylelatex]
+\documentclass[british]{article}
+\usepackage{babel}
+\usepackage{csquotes}
+
+(*@\tikzmark[\strut]{lblxs}@*)\usepackage[backend=biber, style=ext-authoryear]{biblatex}(*@\tikzmark{lblxe}@*)
+(*@\tikzmark[\strut]{ltblxs}@*)\usepackage{biblatex-ext-tabular}(*@\tikzmark{ltblxe}@*)
+
+(*@\tikzmark[\strut]{tabss}@*)\usepackage{longtable}
\usepackage{array}
\newcolumntype{L}[1]{%
- >{\raggedright\let\newline\\\arraybackslash\hspace{0pt}}p{#1}}
+ >{\raggedright\let\newline\\\arraybackslash\hspace{0pt}}p{#1}}(*@\tikzmark{tabse}@*)
-\defbibtabular{bibtabular}
+(*@\tikzmark[\strut]{dbtabs}@*)\defbibtabular{bibtabular}
{\setlength{\LTpre}{0pt}%
\setlength{\LTpost}{0pt}%
\renewcommand*{\arraystretch}{2}%
@@ -2426,16 +2740,40 @@ A simple example of a useful tabular bibliography setup is
@{}}}
{\end{longtable}}
{\anchorlang{\usebibmacro{tabular:sortname}} &
- \driver{\usebibmacro{tabular:omitsortname}} \\}
-\end{biblatexcode}
-This defines a two-column bibliography where the first column shows the
-primary name associated with the work (the labelname/sortname) and the
-second colum shows the bibliography data with the primary name suppressed
-to avoid duplication.
-The anchor is set to the first column, so that a viewer jumps there
-if a link to the entry is followed.
+ \driver{\usebibmacro{tabular:omitsortname}} \\}(*@\tikzmark{dbtabe}@*)
-\begin{bibexample}
+\addbibresource{biblatex-examples.bib}
+
+\begin{document}
+Lorem \autocite{sigfridsson,nussbaum}
+ipsum \autocite{geer}.
+
+(*@\tikzmark[\strut]{pbts}@*)\printbibtabular(*@\tikzmark{pbte}@*)
+\end{document}
+\end{lstlisting}%
+\tikz[overlay,remember picture]{%
+ \node[draw, rounded corners, highlight1, very thick,
+ fit=(lblxs.north west) (lblxe.south east)
+ (ltblxs.north west) (ltblxe.south east)] (lblxb) {};
+ \node (lblxt)[MWEcommentbox, right=0cm of lblxb, text width=3.25cm]
+ {Load \sty{biblatex} as usual,\\then load \hypersty{biblatex-ext-tabular}};
+
+ \node[draw, rounded corners, highlight2, very thick,
+ fit=(tabss.north west) (tabse.south east)] (tabsb) {};
+ \node (tabst)[MWEcommentbox, right=0em of tabsb, text width=2.36cm]
+ {Set up enhanced table support as desired};
+
+ \node[draw, rounded corners, highlight1, very thick,
+ fit=(dbtabs.north west) (dbtabe.south east)] (dbtabb) {};
+ \node (dbtabt)[MWEcommentbox, right=0em of dbtabb, text width=4.5cm]
+ {Set up a tabular bibliography with~\hypercmd{defbibtabular}};
+
+ \node[draw, rounded corners, highlight1, very thick, inner sep=0.1em,
+ fit=(pbts.north west) (pbte.south east)] (pbtb) {};
+ \node (pbtt)[MWEcommentbox, right=1em of pbtb, text width=7cm]
+ {Print bibliography table with~\hypercmd{printbibtabular}};
+}
+\tcblower
\defbibtabular{bibtabular}
{\setlength{\LTpre}{0pt}%
\setlength{\LTpost}{0pt}%
@@ -2451,6 +2789,12 @@ if a link to the entry is followed.
\exampleprintbibtab{sigfridsson,geer,nussbaum}
\end{bibexample}
+This defines a two-column bibliography where the first column shows the
+primary name associated with the work (the labelname/sortname) and the
+second colum shows the bibliography data with the primary name suppressed
+to avoid duplication.
+The anchor is set to the first column, so that a viewer jumps there
+if a link to the entry is followed.
For the common case of two-column tabular bibliographies there is a thin
wrapper around \hypercmd{defbibtabular} that might turn out a bit easier to use.
@@ -2479,6 +2823,13 @@ is equivalent to
Using \cmd{defbibtabulartwocolumn} the example from above could be written as
\begin{biblatexcode}
+\documentclass[british]{article}
+\usepackage{babel}
+\usepackage{csquotes}
+
+\usepackage[backend=biber, style=ext-authoryear]{biblatex}
+\usepackage{biblatex-ext-tabular}
+
\usepackage{longtable}
\usepackage{array}
\newcolumntype{L}[1]{%
@@ -2496,6 +2847,15 @@ Using \cmd{defbibtabulartwocolumn} the example from above could be written as
{\end{longtable}}
{\usebibmacro{tabular:sortname}}
{\usebibmacro{tabular:omitsortname}}
+
+\addbibresource{biblatex-examples.bib}
+
+\begin{document}
+Lorem \autocite{sigfridsson,nussbaum}
+ipsum \autocite{geer}.
+
+\printbibtabular
+\end{document}
\end{biblatexcode}
\end{ltxsyntax}
@@ -2509,7 +2869,7 @@ about promoting open access works by adding a small open access symbol into
the margin.
The package must be loaded after \sty{biblatex}.
-It is not tied to use with styles of this bundle, though it can not be
+It is not tied to use with styles of this bundle, though it cannot be
guaranteed that everything will work out of the box with all other styles.
The package works as expected with the standard styles and
should work with most contributed styles at least to some extent.
@@ -2572,18 +2932,16 @@ Load one of the available open access symbol support packages.
yourself if you don't load any of the symbol packages.
\end{warnbox}
\item[pict2e] Load \hypersty{biblatex-ext-oasymb-pict2e} to provide a
- definition for \hypercmd{oasymbol}.
+ definition for \hypercmd{oasymbol} drawn in \sty{pict2e}.
See \cref{sec:oa:symbol,sec:oa:symbol-pict2e}.
\item[l3draw] Load \hypersty{biblatex-ext-oasymb-l3draw} to provide a
- definition for \hypercmd{oasymbol}.
+ definition for \hypercmd{oasymbol} drawn in \sty{l3draw}.
See \cref{sec:oa:symbol,sec:oa:symbol-l3draw}.
\begin{remindbox}
- The package \hypersty{biblatex-ext-oasymb-l3draw} will load the entire
- \LaTeX3 core.
- Furthermore, \sty{l3draw} is still considered experimental.
+ Please keep in mind that \sty{l3draw} is still considered experimental.
\end{remindbox}
\item[tikz] Load \hypersty{biblatex-ext-oasymb-tikz} to provide a
- definition for \hypercmd{oasymbol}.
+ definition for \hypercmd{oasymbol} that is drawn with \pgftikz.
See \cref{sec:oa:symbol,sec:oa:symbol-tikz}.
\begin{remindbox}
The package \hypersty{biblatex-ext-oasymb-tikz} will load \pgftikz.
@@ -2601,7 +2959,10 @@ Load one of the available open access symbol support packages.
\endgroup
Set \hypercmd{oasymbol} to output the symbol identified as \prm{symbol}.
-The available options can be found in \cref{sec:oa:symbol}.
+This option is passed on to the \prm{symbolpackage} selected
+with the \hyperopt{symbolpackage} option.
+Possible values can be found in the respective subsections
+of \cref{sec:oa:symbol}.
\begin{warnbox}
Note that this option is only available if the
@@ -2624,7 +2985,6 @@ can only be used with \lualatex.
\end{warnbox}
\end{optionlist}
-\clearpage
The following macros in \sty{biblatex-ext-oa} are also of interest.
\begin{ltxsyntax}
@@ -2644,8 +3004,7 @@ loaded either explicitly or via the \hyperopt{symbolpackage} option.
This command is related to \hypercmd{DefineOASymbol} (see \cref{sec:oa:symbol}).
-\cmditem{oasymbol}
-
+\csitem{oasymbol}
This commands holds the little symbol that is going to be printed in the margin
to mark open access publications.
@@ -2708,7 +3067,7 @@ The heart of the package \sty{biblatex-ext-oa} is the bibliography option
A longer example document exploring various aspects of open access
detection can be found at
-\url{https://github.com/moewew/biblatex-ext/blob/master/oaslinks.tex}.
+\url{https://github.com/moewew/biblatex-ext/blob/release/oaslinks.tex}.
\begin{optionlist}
\optitem[auto {\normalfont(\optval{none})}]{openaccess}{\optval{auto},
@@ -3040,14 +3399,15 @@ The possible values are
Wikimedia claims the content does not meet the threshold of originality
for copyright protection.
Even if that is not the case, the legal notices on open-access.net%
- \fnurl{https://open-access.net/DE-EN/provider-legal-notices-and-terms/}
+ \fnurl{https://open-access.net/impressum}
place all contents under a Creative Commons 4.0 Attribution International
(CC BY 4.0) Licence\fnurl{https://creativecommons.org/licenses/by/4.0/}
unless stated otherwise.
The logo designer is listed as
- \emph{Medien + Design\fnurl{http://www.cedis.fu-berlin.de/mediendesign/},
- Center for Digital Systems,
- Competence Center for E-Learning and Multimedia, Freie Universität Berlin}.
+ \emph{Medien + Design,
+ Center für Digitale Systeme,
+ Kompetenzzentrum e-Learning / Multimedia,
+ Freie Universität Berlin}.
There is no implication that the open-access.net logo is not covered by
the CC BY 4.0 terms.
@@ -3058,7 +3418,7 @@ The possible values are
\fnurl{https://open-access.net/ueber-uns/}
The English version has \enquote{The logo of the information platform
may be reused with a link to open-access.net}%
- \fnurl{https://open-access.net/DE-EN/about-us/}.
+ \fnurl{https://open-access.net/en/about-us/}.
While the German version leaves some leeway as to whether or not a link is
required as attribution, the English version seems more explicit.
@@ -3155,6 +3515,8 @@ and \sty{l3keys2e}\fnurl{https://ctan.org/pkg/l3keys2e}.
Drawing is performed with the (still experimental)
\sty{l3draw}\fnurl{https://ctan.org/pkg/l3experimental} and
\sty{l3color}\fnurl{https://ctan.org/pkg/l3experimental} packages.
+The code works best with version 2020-08-07 or above
+of~\sty{l3draw}/\sty{l3color}.
If used as a stand-alone package, \sty{biblatex-ext-oasymb-l3draw} has one
load-time option, namely \hyperopt{symbol}, and defines one command besides
@@ -3176,6 +3538,10 @@ See also \filename{CHANGES.md}.
The numbers on the right indicate the relevant section of the manual.
\begin{changelog}
+\begin{release}{0.8g}{2020-08-09}
+ \item Synced \hypersty{biblatex-ext-oasymb-l3draw} with 2020-08-07
+ \sty{l3color}/\sty{l3draw} changes.\see{sec:oa:symbol-l3draw}
+\end{release}
\begin{release}{0.8f}{2020-05-09}
\item Fixed inner cite delimiters for \cmd{footcitetext}%
\see{sec:opt:citedelims}