From f2b6fed409ebbdf2f12db216597d5072b87c6212 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sun, 6 Mar 2022 21:10:52 +0000 Subject: biblatex-ext (6mar22) git-svn-id: svn://tug.org/texlive/trunk@62471 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/biblatex-ext/CHANGES.md | 10 ++ Master/texmf-dist/doc/latex/biblatex-ext/README.md | 11 +- .../doc/latex/biblatex-ext/biblatex-ext.pdf | Bin 834577 -> 841856 bytes .../doc/latex/biblatex-ext/biblatex-ext.tex | 145 +++++++++++++++++++-- 4 files changed, 156 insertions(+), 10 deletions(-) (limited to 'Master/texmf-dist/doc') diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md b/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md index 4eddff49312..c6a95f43519 100644 --- a/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md +++ b/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md @@ -1,5 +1,15 @@ # Changelog +## Version 0.15 (2022-03-06) + +See + +### Added +- New `authornumber` style family. + +### Changed +- Updated for `biblatex` v3.17 (2022/02/02). + ## Version 0.14 (2021-08-31) See diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/README.md b/Master/texmf-dist/doc/latex/biblatex-ext/README.md index 17c9cb55e88..12adbae3f80 100644 --- a/Master/texmf-dist/doc/latex/biblatex-ext/README.md +++ b/Master/texmf-dist/doc/latex/biblatex-ext/README.md @@ -32,7 +32,13 @@ files - The `alphabetic` style family - `ext-alphabetic.bbx` and `ext-alphabetic.cbx` - `ext-alphabetic-verb.bbx` and `ext-alphabetic-verb.cbx` -- The `authoryear`/`authortitle` helper file `ext-dashed-common.bbx` +- The `authornumber` style family + - `ext-authornumber.bbx` and `ext-authornumber.cbx` + - `ext-authornumber-comp.bbx` and `ext-authornumber-comp.cbx` + - `ext-authornumber-ecomp.bbx` and `ext-authornumber-ecomp.cbx` + - `ext-authornumber-terse.bbx` and `ext-authornumber-terse.cbx` + - `ext-authornumber-tcomp.bbx` and `ext-authornumber-tcomp.cbx` + - `ext-authornumber-tecomp.bbx` and `ext-authornumber-tecomp.cbx` - The `authortitle` style family - `ext-authortitle-common.bbx` - `ext-authortitle.bbx` and `ext-authortitle.cbx` @@ -42,6 +48,7 @@ files - `ext-authortitle-terse.bbx` and `ext-authortitle-terse.cbx` - `ext-authortitle-tcomp.bbx` and `ext-authortitle-tcomp.cbx` - `ext-authortitle-ticomp.bbx` and `ext-authortitle-ticomp.cbx` +- The `authoryear`/`authortitle` helper file `ext-dashed-common.bbx` - The `authoryear` style family - `ext-authoryear-common.bbx` - `ext-authoryear.bbx` and `ext-authoryear.cbx` @@ -84,7 +91,7 @@ installation instructions. ## Licence -Copyright 2017-2021 Moritz Wemheuer +Copyright 2017-2022 Moritz Wemheuer This work consists of the `.bbx`, `.cbx`, `.def`, `.sty` and `.lua` files mentioned above. diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf index 075c68cfcf4..f5d9a3af2b1 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf and b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf differ 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} -- cgit v1.2.3