diff options
author | Karl Berry <karl@freefriends.org> | 2021-01-01 21:48:29 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2021-01-01 21:48:29 +0000 |
commit | bc3ac1f4926f4f76eccee767e9dce69c46b3715f (patch) | |
tree | 6b4e5768cdea66538b62021106af600bb7a6810a /Master/texmf-dist/doc/latex/biblatex-ext | |
parent | 68c1a17f849d37583f1467b9b806cbcc04474577 (diff) |
biblatex-ext (1jan21)
git-svn-id: svn://tug.org/texlive/trunk@57287 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-ext')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md | 10 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-ext/README.md | 5 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf | bin | 573680 -> 822652 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex | 157 |
4 files changed, 125 insertions, 47 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md b/Master/texmf-dist/doc/latex/biblatex-ext/CHANGES.md index 17f0f1fb521..0e216a50952 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.10 (2021-01-01) + +See <https://github.com/moewew/biblatex-ext/compare/v0.9...v0.10> + +### Changed +- Updated for `biblatex` v3.16 (2020/12/31). + This is now the recommended `biblatex` version. +- Separate out common code for verbose citation styles. +- Warn about `introcite=plain` with verbose citation styles. + ## Version 0.9 (2020-08-21) See <https://github.com/moewew/biblatex-ext/compare/v0.8g...v0.9> diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/README.md b/Master/texmf-dist/doc/latex/biblatex-ext/README.md index 589aca46bdd..17c9cb55e88 100644 --- a/Master/texmf-dist/doc/latex/biblatex-ext/README.md +++ b/Master/texmf-dist/doc/latex/biblatex-ext/README.md @@ -60,6 +60,7 @@ files - `ext-numeric-comp.bbx` and `ext-numeric-comp.cbx` - `ext-numeric-verb.bbx` and `ext-numeric-verb.cbx` - The `verbose` style family + - `ext-verbose-common.cbx` and `ext-verbose-note-common.cbx` - `ext-verbose.bbx` and `ext-verbose.cbx` - `ext-verbose-ibid.bbx` and `ext-verbose-ibid.cbx` - `ext-verbose-note.bbx` and `ext-verbose-note.cbx` @@ -83,7 +84,7 @@ installation instructions. ## Licence -Copyright 2017-2020 Moritz Wemheuer +Copyright 2017-2021 Moritz Wemheuer This work consists of the `.bbx`, `.cbx`, `.def`, `.sty` and `.lua` files mentioned above. @@ -99,7 +100,7 @@ version 2005/12/01 or later. This work has the LPPL maintenance status 'maintained'. The Current Maintainer of the work is Moritz Wemheuer - <mwemheu@gmail.com>. + <mwemheu@posteo.de>. The files `README.md`, `CHANGES.md`, `biblatex-ext.pdf`, `biblatex-ext.tex` and `biblatex-ext-examples.bib` in their entirety diff --git a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf Binary files differindex f59b6b68151..d827f6e77cf 100644 --- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.pdf 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 0390a822aeb..c0603c48561 100644 --- a/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex +++ b/Master/texmf-dist/doc/latex/biblatex-ext/biblatex-ext.tex @@ -1,4 +1,4 @@ -\documentclass[DIV=9]{scrartcl} +\documentclass[11pt,a4paper]{article} \usepackage{iftex} \iftutex \usepackage{fontspec} @@ -24,7 +24,12 @@ \usepackage[scaled=0.78]{beramono} \usepackage{bm} \fi +\usepackage[%verbose, + left=3.5cm, right=3.5cm, + marginparwidth=2.5cm +]{geometry} \usepackage{microtype} +\usepackage{ragged2e} \usepackage{hyphenat} \usepackage{booktabs} \usepackage{multicol} @@ -165,6 +170,7 @@ \newtcolorbox{bibexample}[1][]{enhanced, colframe=spot!75!black, colback=spot!5!white, + before title=\raggedright, #1} \newtcblisting{biblatexcode}{enhanced, colframe=black!75!white, colback=black!5!white, @@ -270,9 +276,27 @@ \end{multicols} \endgroup} -\BeforeStartingTOC[toc]{\begin{multicols}{2}} -\AfterStartingTOC[toc]{\end{multicols}} -\BeforeTOCHead[toc]{\pdfbookmark[1]{\contentsname}{contents}} + +\renewcommand\tableofcontents{% + \section*{\contentsname + \@mkboth{% + \MakeUppercase\contentsname}{\MakeUppercase\contentsname}}% + \pdfbookmark[1]{\contentsname}{contents}% + \@starttoc{toc}% + } +\def\@starttoc#1{% + \begingroup + \begin{multicols}{2} + \makeatletter + \RaggedRight + \@input{\jobname.#1}% + \if@filesw + \expandafter\newwrite\csname tf@#1\endcsname + \immediate\openout \csname tf@#1\endcsname \jobname.#1\relax + \fi + \end{multicols} + \@nobreakfalse + \endgroup} \newrobustcmd*{\tex}{\TeX} \newrobustcmd*{\etex}{\mbox{e-TeX}} @@ -305,9 +329,28 @@ \let\accentcolour\spotcolor -\addtokomafont{section}{\accentcolour} -\addtokomafont{subsection}{\accentcolour} -\addtokomafont{subsubsection}{\accentcolour} +\newcommand*{\allsectionsfont}{\sffamily\accentcolour} + +\renewcommand\section{\@startsection {section}{1}{\z@}% + {-3.5ex \@plus -1ex \@minus -.2ex}% + {2.3ex \@plus.2ex}% + {\normalfont\Large\bfseries\allsectionsfont}} +\renewcommand\subsection{\@startsection{subsection}{2}{\z@}% + {-3.25ex\@plus -1ex \@minus -.2ex}% + {1.5ex \@plus .2ex}% + {\normalfont\large\bfseries\allsectionsfont}} +\renewcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}% + {-3.25ex\@plus -1ex \@minus -.2ex}% + {1.5ex \@plus .2ex}% + {\normalfont\normalsize\bfseries\allsectionsfont}} +\renewcommand\paragraph{\@startsection{paragraph}{4}{\z@}% + {3.25ex \@plus1ex \@minus.2ex}% + {-1em}% + {\normalfont\normalsize\bfseries\allsectionsfont}} +\renewcommand\subparagraph{\@startsection{subparagraph}{5}{\parindent}% + {3.25ex \@plus1ex \@minus .2ex}% + {-1em}% + {\normalfont\normalsize\bfseries\allsectionsfont}} \renewcommand*{\verbatimfont}{\ttfamily} \renewcommand*{\displayverbfont}{\ttfamily} @@ -434,7 +477,7 @@ } % By Stefan Kottwitz, see https://tex.stackexchange.com/a/799/35864 -\newcommand*\justify{% +\newcommand*\ttjustify{% \fontdimen2\font=0.4em% interword space \fontdimen3\font=0.2em% interword stretch \fontdimen4\font=0.1em% interword shrink @@ -443,9 +486,9 @@ } % no \mbox here, we may have to break things -\renewrobustcmd*{\sty}[1]{{\verbatimfont\justify #1}} -\newrobustcmd*{\blxstyle}[1]{{\verbatimfont\justify #1}} -\newrobustcmd*{\filename}[1]{{\verbatimfont\justify #1}} +\renewrobustcmd*{\sty}[1]{{\verbatimfont\ttjustify #1}} +\newrobustcmd*{\blxstyle}[1]{{\verbatimfont\ttjustify #1}} +\newrobustcmd*{\filename}[1]{{\verbatimfont\ttjustify #1}} \renewrobustcmd*{\bibfield}[1]{\sty{#1}} \renewrobustcmd*{\opt}[1]{\sty{#1}} \newrobustcmd*{\optval}[1]{\sty{#1}} @@ -455,7 +498,7 @@ \let\cs\cmd \newrobustcmd*{\bibfieldformat}[1]{{\bibfieldformatfont #1}} -\newrobustcmd*{\gencode}[1]{{\verbatimfont\justify #1}} +\newrobustcmd*{\gencode}[1]{{\verbatimfont\ttjustify #1}} \def\exltd@buildhypercmd@i#1{% \expandafter\newrobustcmd\expandafter*\expandafter @@ -476,7 +519,7 @@ \newcommand*{\ctan}{\mkbibacro{CTAN}} \newcommand*{\gitbaseurl}{https://github.com/moewew/biblatex-ext} -\newcommand*{\extblxversion}{0.9} +\newcommand*{\extblxversion}{0.10} \newcommand*{\biber}{Biber} \newcommand*{\gitissuelink}[1]{% \href{\gitbaseurl/issues/#1}{issue \##1 on github}} @@ -547,9 +590,9 @@ subtitle = {Extensions for the \sty{biblatex} standard styles}, url = {\gitbaseurl}, author = {Moritz Wemheuer}, - link = {mwemheu@gmail.com},% + link = {mwemheu@posteo.de},% revision = {\extblxversion}, - date = {\DTMDate{2020-08-21}}, + date = {\DTMDate{2021-01-01}}, } \hypersetup{% @@ -714,7 +757,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--2020). +This bundle is maintained by Moritz Wemheuer (\textcopyright 2017--2021). \subsection{Feedback}\label{sec:feedback} @@ -1067,7 +1110,7 @@ Sigfridsson and Ryde \quad Knuth 1984, 1986 \styleitem{ext-authoryear-tecomp} A compact author-year citation style that combines -\blxstyle{ext-authoryear-tcomp} and \blxstyle{ext-authoryear-ecomp}. +\blxstyle{ext-authoryear-tcomp} and \blxstyle{ext-author\-year-ecomp}. \begin{bibexample} \begin{lstlisting}[style=extblxstylelatex] \usepackage[style=ext-authoryear-tecomp]{biblatex} @@ -1815,6 +1858,9 @@ Field formats can be modified with \cmd{DeclareFieldFormat}. \exampleprintbib{sigfridsson} \end{bibexample} +A customisation example for \bibfield{issuedate} can be found in the +\hypercmd{volnumdatedelim} description. + \bibfieldformatitem{volumeof} The format for the \bibfield{volume} of a \bibfield{maintitle} used when \hyperkvopt{maintitleaftertitle}{true}. \begin{bibexample} @@ -2174,6 +2220,7 @@ The default is a comma followed by a space. \begin{lstlisting}[style=extblxstylelatex] \renewcommand*{\pubdatedelim}{\addspace} \end{lstlisting} +\tcblower \renewcommand*{\pubdatedelim}{\addspace} \csuse{bbx@opt@mergedate@false}% \exampleprintbib{knuth:ct:a} @@ -2296,9 +2343,9 @@ or \enquote{\prm{opening delimiter}\allowbreak text\allowbreak is introduced. 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 -argument to a macro. +As mentioned above, citation delimiters cannot be used to introduce a +wrapper command for the citation output, i.e.\ to pass the entire output of the +citation command as argument to a macro. Instead of hard-coded \gencode{(}, \gencode{)}, \gencode{[} and \gencode{]} their \sty{biblatex} counterparts \cmd{bibopenparen}, \cmd{bibcloseparen}, @@ -2584,6 +2631,9 @@ By default the macro is defined and used as follows. \usebibmacro{pubinstorg+location+date}{|organization|}} \end{biblatexcode} +An example use of the \bibmacro{pubinstorg+location+date} is shown +in the descriotion of~\hypercmd{publocdelim}. + \keyitem[type+number] A bibliography macro to print the \bibfield{type} and \bibfield{number} fields. \end{keymarglistbook} @@ -2714,8 +2764,46 @@ The package also defines two helpful bibliography macros. \keyitem[tabular:omitsortname] Suppresses the labelname/sortname in the current group. \end{keymarglistbook} +\begin{remindbox} + These two bibliography macros have a fairly basic definition that should make + them compatible with most styles (not only \sty{biblatex-ext} + or standard styles). + Consequently, they may not be able to support all advanced features of + the style you are using. + + If you are missing anything, you will have to write versions of those macros + that are tailored to the specific style you are loading and the features you + want to use. +\end{remindbox} + +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. +\begin{ltxsyntax} + \cmditem{defbibtabulartwocolumn}{name}{begin code}{end code}% + {anchor code}{driver precode} + + This defines a two-column tabular bibliography environment with \prm{name}, + \prm{begin code} and \prm{end code} as for \hypercmd{defbibtabular}. + + The first column is an \hypercmd{anchorlang} column that executes + \prm{anchor code}, the second column executes a pre-code and + the bibliography driver. + +\begin{biblatexcode} +\defbibtabulartwocolumn{(*@\prm{name}@*)} + {(*@\prm{begin code}@*)}{(*@\prm{end code}@*)} + {(*@\prm{anchor code}@*)}{(*@\prm{driver precode}@*)} +\end{biblatexcode} +is equivalent to +\begin{biblatexcode} +\defbibtabular{(*@\prm{name}@*)} + {(*@\prm{begin code}@*)}{(*@\prm{end code}@*)} + {\anchorlang{(*@\prm{anchor code}@*)} & \driver{(*@\prm{driver precode}@*)} \\} +\end{biblatexcode} + +Usage examples are shown on the next page -A simple example of a useful tabular bibliography setup is +\clearpage \begin{bibexample}[breakable, title={Example document with tabular bibliography}] \begin{lstlisting}[style=extblxstylelatex] @@ -2798,30 +2886,6 @@ 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. -\begin{ltxsyntax} - \cmditem{defbibtabulartwocolumn}{name}{begin code}{end code}% - {anchor code}{driver precode} - - This defines a two-column tabular bibliography environment with \prm{name}, - \prm{begin code} and \prm{end code} as for \hypercmd{defbibtabular}. - - The first column is an \hypercmd{anchorlang} column that executes - \prm{anchor code}, the second column executes a pre-code and - the bibliography driver. - -\begin{biblatexcode} -\defbibtabulartwocolumn{(*@\prm{name}@*)} - {(*@\prm{begin code}@*)}{(*@\prm{end code}@*)} - {(*@\prm{anchor code}@*)}{(*@\prm{driver precode}@*)} -\end{biblatexcode} -is equivalent to -\begin{biblatexcode} -\defbibtabular{(*@\prm{name}@*)} - {(*@\prm{begin code}@*)}{(*@\prm{end code}@*)} - {\anchorlang{(*@\prm{anchor code}@*)} & \driver{(*@\prm{driver precode}@*)} \\} -\end{biblatexcode} Using \cmd{defbibtabulartwocolumn} the example from above could be written as \begin{biblatexcode} @@ -3540,6 +3604,9 @@ See also \filename{CHANGES.md}. The numbers on the right indicate the relevant section of the manual. \begin{changelog} +\begin{release}{0.10}{2021-01-01} + \item Synced with \sty{biblatex} 3.16 changes. +\end{release} \begin{release}{0.9}{2020-08-21} \item Synced with \sty{biblatex} 3.15 changes. \end{release} |