summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2022-03-06 21:11:12 +0000
committerKarl Berry <karl@freefriends.org>2022-03-06 21:11:12 +0000
commit6b6037cf4e9d2989bc67f6f59e4e63090a6772ba (patch)
tree5febfa196cb090256e5758ede07390eec6195420 /Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
parent1db08b95850d57c8d6e06b2f2402ceadbf7aa20b (diff)
biblatex-ext (6mar22) (branch)
git-svn-id: svn://tug.org/texlive/branches/branch2021.final@62472 c570f23f-e606-0410-a88d-b1316a301751
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.tex145
1 files changed, 137 insertions, 8 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 28969eb88c0..bc7c16c3ada 100644
--- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex
@@ -586,7 +586,7 @@
\newcommand*{\ctan}{\mkbibacro{CTAN}}
\newcommand*{\gitbaseurl}{https://github.com/moewew/biblatex-ext}
-\newcommand*{\extblxversion}{0.14}
+\newcommand*{\extblxversion}{0.15}
\newcommand*{\biber}{Biber}
\newcommand*{\gitissuelink}[1]{%
\href{\gitbaseurl/issues/#1}{issue \##1 on github}}
@@ -659,7 +659,7 @@
author = {Moritz Wemheuer},
email = {mwemheu@posteo.de},%
revision = {\extblxversion},
- date = {\DTMDate{2021-08-31}},
+ date = {\DTMDate{2022-03-06}},
}
\hypersetup{%
@@ -824,7 +824,7 @@ under the terms of the \lppl, version 1.3c%
\fnurl{https://www.latex-project.org/lppl/lppl-1-3c.txt}
or (at your option) any later version%
\fnurl{https://www.latex-project.org/lppl.txt}.
-This bundle is maintained by Moritz Wemheuer (\textcopyright 2017--2021).
+This bundle is maintained by Moritz Wemheuer (\textcopyright 2017--2022).
\subsection{Feedback}\label{sec:feedback}
@@ -1210,6 +1210,81 @@ A compact author-year citation style that combines
Sigfridsson and Ryde \quad ibid. \quad Knuth 1984, 1986a\bibrangedash c
\end{bibexample}
+
+\styleitem{ext-authornumber}
+An author-number citation style.
+The number is taken from the \bibfield{extraname} field
+which increases separately for each labelname list.
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authornumber]{biblatex}
+\end{lstlisting}
+\tcblower
+Knuth [1]; Knuth [2]; Knuth [3]; Sigfridsson and Ryde [1]
+\end{bibexample}
+
+\styleitem{ext-authornumber-comp}
+A more compact version of \blxstyle{ext-authornumber} that prints
+the author only once if subsequent references in the same citation
+share the same author.
+This style will print
+\enquote{Knuth [1, 2]} instead of
+\blxstyle{ext-authornumber}'s \enquote{Knuth [1]; Knuth [2]}.
+The style will enable the \opt{sortcites} option.
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authornumber-comp]{biblatex}
+\end{lstlisting}
+\tcblower
+Knuth [1, 2, 3]; Sigfridsson and Ryde [1]
+\end{bibexample}
+
+\styleitem{ext-authornumber-ecomp}
+An even more compact version of \blxstyle{ext-authornumber-comp}
+that also compresses the citation numbers if appropriate.
+\enquote{Knuth [1--3]} instead of
+\blxstyle{ext-authornumber-comp}'s \enquote{Knuth [1, 2, 3]}.
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=ext-authornumber-ecomp]{biblatex}
+\end{lstlisting}
+\tcblower
+Knuth [1--3]; Sigfridsson and Ryde [1]
+\end{bibexample}
+
+\styleitem{ext-authornumber-terse}
+A version of \blxstyle{ext-authornumber} which drops the number
+if there is only one work by that author.
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=authornumber-terse]{biblatex}
+\end{lstlisting}
+\tcblower
+Knuth [1]; Knuth [2]; Knuth [3]; Sigfridsson and Ryde
+\end{bibexample}
+
+\styleitem{ext-authornumber-tcomp}
+A combination of \blxstyle{ext-authornumber-terse}
+and \blxstyle{ext-authornumber-comp}.
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=authornumber-comp]{biblatex}
+\end{lstlisting}
+\tcblower
+Knuth [1, 2, 3]; Sigfridsson and Ryde
+\end{bibexample}
+
+\styleitem{ext-authornumber-tecomp}
+A combination of \blxstyle{ext-authornumber-terse}
+and \blxstyle{ext-authornumber-ecomp}.
+\begin{bibexample}
+\begin{lstlisting}[style=extblxstylelatex]
+\usepackage[style=authornumber-tecomp]{biblatex}
+\end{lstlisting}
+\tcblower
+Knuth [1--3]; Sigfridsson and Ryde
+\end{bibexample}
+
\end{stylelist}
\clearpage
@@ -1727,8 +1802,10 @@ be printed with the \hyperbibfieldformat{volumeof} format.
\optitem[true]{dashed}{\optval{true}, \optval{false}, \optval{fullhash},
\optval{bibnamehash}}
-The \opt{dashed} option of the \hyperblxstyle[ext-authoryear]{authoryear}- and
-\hyperblxstyle[ext-authortitle]{authortitle}-like bibliography styles allows for
+The \opt{dashed} option of the \hyperblxstyle[ext-authoryear]{authoryear}-,
+\hyperblxstyle[ext-authortitle]{authortitle}-
+and \hyperblxstyle[ext-authornumber]{ext-authornumber}-like
+bibliography styles allows for
finer control over the dashes than in the standard styles.
The option is available globally and additionally on a per-type and per-entry
level.
@@ -1819,8 +1896,9 @@ lists are only replaced if they are indistinguishable in the data source.
\begin{warnbox}
The \opt{introcite} option is available for the bibliography styles of the
-\hyperblxstyle[ext-authoryear]{authoryear} and
-\hyperblxstyle[ext-authortitle]{authortitle} family.
+\hyperblxstyle[ext-authoryear]{authoryear},
+\hyperblxstyle[ext-authortitle]{authortitle}
+and \hyperblxstyle[ext-authornumber]{ext-authornumber} family.
It cannot be used with citation styles of the
\hyperblxstyle[ext-verbose]{verbose} family, where
it may produce undesired output or errors.
@@ -2131,6 +2209,18 @@ Field formats can be modified with \cmd{DeclareFieldFormat}.
\begin{bibfieldformatlist}
+\bibfieldformatitem{bibextraname}
+The format for the number added to the name in
+\hyperblxstyle[ext-authornumber]{ext-authornumber}-like styles.
+The default is to wrap the number in square brackets.
+ \begin{bibexample}
+ \togglefalse{bbx:doi}
+ % VERY hacky, but we can't easily switch styles
+ \DeclareFieldFormat{biblabeldate}{\highlight{\bibopenbracket}\highlight[2]{1}%
+ \highlight{\bibclosebracket}}
+ \exampleprintbib{sigfridsson}
+ \end{bibexample}
+
\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.
@@ -2258,6 +2348,24 @@ A short overview over common punctuation commands defined by \sty{biblatex-ext}
as well as standard \sty{biblatex} in an example bibliography
can be found in \cref{sec:punctinuse}.
\begin{ltxsyntax}
+\csitem{namenumberdelim}\CSdelimMark
+Similar to \cmd{nametitledelim}, but for the punctuation between
+the name and the label number in
+\hyperblxstyle[ext-authornumber]{ext-authornumber} styles.
+The default is a space.
+ \begin{bibexample}
+ \togglefalse{bbx:doi}
+ % VERY hacky, but we can't easily switch styles
+ \DeclareFieldFormat{biblabeldate}{\mkbibbrackets{1}}
+ \DeclareDelimFormat[bib]{nameyeardelim}{\highlight{\textvisiblespace}}
+ \exampleprintbib{sigfridsson}
+ \end{bibexample}
+
+\csitem{nonamenumberdelim}\CSdelimMark
+The replacement for \hypercmd{namenumberdelim} if the labelname
+does not exist and is replaced by a fallback.
+By default this is an alias of \hypercmd{namenumberdelim}.
+
\csitem{innametitledelim}\CSdelimMark
Similar to \cmd{nametitledelim}, but for names after the \enquote{in:} if
\hyperopt{innamebeforetitle} is \optval{true}.
@@ -2555,7 +2663,7 @@ The default is a comma followed by a space.
\csitem{extradateonlycompcitedelim}\CSdelimMark
Similar to \cmd{compcitedelim}, but indended for use between compressed
-citations where the second is an \bibfield{extradate} only.
+author-year citations where the second is an \bibfield{extradate} only.
The default is a comma (\emph{not} followed by a space).
\begin{bibexample}
\DeclareDelimFormat{extradateonlycompcitedelim}{\highlightbf{\addcomma}}
@@ -2572,6 +2680,17 @@ The default is \cmd{bibrangedash}.
\highlightbf{\bibrangedash}}
\cite{knuth:ct:b,knuth:ct:c,knuth:ct:d}
\end{bibexample}
+
+
+\csitem{extranameonlycompcitedelim}\CSdelimMark
+Similar to \cmd{compcitedelim}, but indended for use between compressed
+author-number citations.
+The default is a comma (\emph{not} followed by a space).
+
+\csitem{extranameonlycompciterangedelim}\CSdelimMark
+Similar to \hypercmd{extranameonlycompcitedelim}, but indended for use in a
+compressed list of \bibfield{extraname}s in the \blxstyle{-ecomp} styles.
+The default is \cmd{bibrangedash}.
\end{ltxsyntax}
\subsection{Delimiters for citation commands}\label{sec:opt:citedelims}
@@ -2639,6 +2758,12 @@ Style family & \cmd{cite} & \cmd{parencite} & \cmd{textcite}\\
\highlightbf[2]{\hmpdl}1984\highlightbf[2]{\hmpdr}%
\highlightbf[1]{)} & \highlightbf[1]{\hmpdl}Knuth
\highlightbf[2]{(}1984\highlightbf[2]{)}\highlightbf[1]{\hmpdr}\\
+\blxstyle{authornumber} & \highlightbf[1]{\hmpdl}Knuth
+ \highlightbf[2]{[}1\highlightbf[2]{]}%
+ \highlightbf[1]{\hmpdr} & \highlightbf[1]{(}Knuth
+ \highlightbf[2]{\hmpdl}1\highlightbf[2]{\hmpdr}%
+ \highlightbf[1]{)} & \highlightbf[1]{\hmpdl}Knuth
+ \highlightbf[2]{[}1\highlightbf[2]{]}\highlightbf[1]{\hmpdr}\\
\bottomrule
\end{tabular}
\end{table}
@@ -3937,6 +4062,10 @@ See also \filename{CHANGES.md}.
The numbers on the right indicate the relevant section of the manual.
\begin{changelog}
+\begin{release}{0.15}{2022-03-06}
+ \item New \hyperblxstyle[ext-authornumber]{ext-authornumber-*} style
+ subfamily\see{sec:styles:new}
+\end{release}
\begin{release}{0.14}{2021-08-31}
\item Use \hyperbibmacro{language} bibmacro also in
\bibtype{dataset} driver\see{sec:opt:bibmacros}