diff options
author | Karl Berry <karl@freefriends.org> | 2022-03-06 21:11:12 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2022-03-06 21:11:12 +0000 |
commit | 6b6037cf4e9d2989bc67f6f59e4e63090a6772ba (patch) | |
tree | 5febfa196cb090256e5758ede07390eec6195420 /Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex | |
parent | 1db08b95850d57c8d6e06b2f2402ceadbf7aa20b (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.tex | 145 |
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} |