diff options
author | Karl Berry <karl@freefriends.org> | 2023-05-18 20:06:36 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2023-05-18 20:06:36 +0000 |
commit | 8764827c580a6fc346b394ba3fae06d0a819dfaf (patch) | |
tree | 00ccdac65b2254ba75ce08bbd666dfdace6a1eb6 /Master/texmf-dist/doc/latex | |
parent | 7071b2a856a3fad52bed993cba367b9264dca238 (diff) |
biblatex-publist (18may23)
git-svn-id: svn://tug.org/texlive/trunk@67148 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-publist/README | 4 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf | bin | 406636 -> 408650 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex | 60 |
3 files changed, 51 insertions, 13 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/README b/Master/texmf-dist/doc/latex/biblatex-publist/README index db58cebe332..7ba4c4a901f 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/README +++ b/Master/texmf-dist/doc/latex/biblatex-publist/README @@ -46,6 +46,10 @@ instructions. == CHANGES == +* V. 2.4 (2023-05-18) + - New option "fixyear" to opt-out special year handling and positioning (#45). + - Make delimiters of author list with plauthorhandling=omit configurable. + * V. 2.3 (2023-03-18) - Change of sorting by means of \ExecutePublistOptions (via plsorting or plauthorhandling) now works for all subsequent refsections. diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf Binary files differindex 3de8c85aaa5..39a3d201f43 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex index 16c7241d6e6..2f396bb757a 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex +++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex @@ -84,6 +84,8 @@ \newcommand*\jfoption[1]{\texttt{#1}} \newcommand*\jfmacro[1]{\texttt{#1}} \newcommand*\jfcsmacro[1]{\jfmacro{\textbackslash{#1}}} +\newcommand*\jmmacro[1]{\@marginmacro{#1}} +\newcommand*\jmcsmacro[1]{\@marginmacro{\textbackslash{#1}}} \def\jenviron{\@ifstar\@@jenviron\@jenviron} \newcommand*\@jenviron[1]{\textbf{\texttt{#1}}} \newcommand*\@@jenviron[1]{\marginpar{\raggedleft\small\textcolor{Maroon}{\texttt{#1}}}% @@ -113,7 +115,7 @@ \thanks{Please report issues via \protect\url{https://github.com/jspitz/biblatex-publist}.}% } -\date{Version 2.3, 2023/03/18} +\date{Version 2.4, 2023/05/18} \maketitle \begin{abstract} @@ -265,12 +267,21 @@ it is highlighted instead (set in bold face by default; see sec.~\ref{sec:auxmac By default, the author and editor names with \joption{plauthorhandling=highlight} are output in the order \enquote{Lastname, Given Names}. To change the order to \enquote{Given Names Lastname}, pass the option \joption{nameorder=given-family} to \bibltx. +\item [{\joption{fixyear{[}=true|false{]}}}] default: \emph{true}. + +By default, the year (or pubstate, if no year is given) is positioned on a fixed slot +(at the very beginning with \joption{plauthorhandling=omit}, after the author list with +\joption{plauthorhandling=highlight}). If you want to have the year at the position determined +by your base style instead, use \joption{fixyear=false}. Note that this removes any highlighting +of the year, independent of \joption{hlyear}. + \item [{\joption{hlyear{[}=true|false{]}}}] default: \emph{true}.\footnote{% - Named \joption{boldyear} up to \bpl\ 1.27. The old option is till supported.} + Named \joption{boldyear} up to \bpl\ 1.27. The old option is still supported.} By default, the year (or pubstate, if no year is given) is highlighted (printed in bold face). To prevent this, pass the option \joption{hlyear=false} to \bibltx. The form of highlighting -can be customized as well (see sec.~\ref{sec:auxmacros}). +can be customized as well (see sec.~\ref{sec:auxmacros}). Note that this has no effect if +\joption{fixyear=false}. \item [{\joption{marginyear{[}=true|false{]}}}] default: \emph{false}. @@ -612,21 +623,33 @@ is controlled by the \jcsmacro*{plauthorhl} macro, which has the following defau \end{lstlisting} If you need another form of highlighting, redefine this macro via \jfcsmacro{renewcommand{*}}. -The indendation of the bibliographic entries (lines > 1) can be adjusted by setting the length -\jmacro*{extralabel\-numberwidth} via \jfcsmacro{setlength} (default is \texttt{0pt}). -This might be needed for long bibliographies (> 99 entries) in order to adjust to the extra -space the item number needs. +The embracing of authors with \joption{plauthorhandlung=omit} (by default: in parentheses) is +controlled by the two macros \jcsmacro*{bplopenoa} and \jcsmacro*{bplcloseoa} which are defined +by default as: +\begin{lstlisting}[moretexcs={[2]{providecommand,bplopenoa,bplcloseoa,bibopenparen,bibcloseparen}}] +\providecommand*{\bplopenoa}{\bibopenparen} +\providecommand*{\bplcloseoa}{\bibcloseparen} +\end{lstlisting} +You can remove the parentheses by redefining these macros with empty arguments, respectively, +or add other delimiters instead. Note that if you use \jfcsmacro{bibopenbracket} in \jfcsmacro{bplopenoa}, +you must also use \jfcsmacro{bibclosebracket} in \jfcsmacro{bplcloseoa} +to balance the delimitation (as with \jfcsmacro{bibopenparen} and \jfcsmacro{bibcloseparen}). + +The\jmmacro{plextrainfo} embracing of extra information (brackets by default) can be customized by changing +\begin{lstlisting}[moretexcs={[4]{DeclareFieldFormat,mkbibbrackets}}] +\DeclareFieldFormat{plextrainfo}{\mkbibbrackets{#1}} +\end{lstlisting} -The separator between extra information (peer review, OpenAccess) can be redefined. +The\jmcsmacro{plextrainfosep} separator between extra information (peer review, OpenAccess) can be redefined. The default definition is: \begin{lstlisting}[moretexcs={[4]{plextrainfosep,addsemicolon,addspace}}] \newcommand*\plextrainfosep{\addsemicolon\addspace} \end{lstlisting} % -The embracing of extra information (brackets by default) can be customized by changing -\begin{lstlisting}[moretexcs={[4]{DeclareFieldFormat,mkbibbrackets}}] -\DeclareFieldFormat{plextrainfo}{\mkbibbrackets{#1}} -\end{lstlisting} +The indendation of the bibliographic entries (lines > 1) can be adjusted by setting the length +\jmacro*{extralabel\-numberwidth} via \jfcsmacro{setlength} (default is \texttt{0pt}). +This might be needed for long bibliographies (> 99 entries) in order to adjust to the extra +space the item number needs. \subsection{Using a Different Base Style}\label{sec:basestyle} @@ -638,7 +661,7 @@ In order to do so, enter the following \emph{before} loading \bibltx: \begin{lstlisting}[moretexcs={[2]{publistbasestyle}}] \newcommand*\publistbasestyle{<stylename>} \end{lstlisting} -where <stylename> is the name of the biblatex bibliography style (\emph{bbx}) you want to use, without the \emph{bbx} entension (e.\,g., \lstinline|\newcommand*\publistbasestyle{mla}|). +where <stylename> is the name of the biblatex bibliography style (\emph{bbx}) you want to use, without the \emph{bbx} entension (e.\,g., \lstinline[moretexcs={[2]{publistbasestyle}}]|\newcommand*\publistbasestyle{mla}|). Note, though, that there is (and can be) no guarantee that \bpl\ will work with all styles, although it has been successfully tested with several. Be prepared to bump into \LaTeX\ errors and carefully check the output for correctness if you try a different base style. @@ -647,6 +670,10 @@ Note, further, that the order of author's and editor's given and family names is differ from what you expect with specific base styles. To change the order, use the package option \joption{nameorder} (see sec.~\ref{sec:addopts}). +The same applies to the position of the year, which is hardcoded to a specific position. +This can be opted out by the package option \joption{fixyear=false} +(see sec.~\ref{sec:addopts}). With this option, however, you lose the possibility to highlight the year. + \subsection{Clickable Titles}\label{sec:clicktitles} @@ -900,6 +927,13 @@ until further change). \begin{description} + \item [{V. 2.4 (2023/05/18):}]~ + \begin{itemize} + \item New option \joption{fixyear} to opt-out special year handling and positioning. + \item Make delimiters of author list with \joption{plauthorhandling=omit} configurable + (see sec.~\ref*{sec:auxmacros}). + \end{itemize} + \item [{V. 2.3 (2023/03/18):}]~ \begin{itemize} \item Change of sorting by means of \jcsmacro{ExecutePublistOptions} (via \joption{plsorting} |