texlive[67148] Master/texmf-dist: biblatex-publist (18may23)
commits+karl at tug.org
commits+karl at tug.org
Thu May 18 22:06:36 CEST 2023
Revision: 67148
http://tug.org/svn/texlive?view=revision&revision=67148
Author: karl
Date: 2023-05-18 22:06:36 +0200 (Thu, 18 May 2023)
Log Message:
-----------
biblatex-publist (18may23)
Modified Paths:
--------------
trunk/Master/texmf-dist/doc/latex/biblatex-publist/README
trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf
trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex
trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx
trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx
trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.dbx
Modified: trunk/Master/texmf-dist/doc/latex/biblatex-publist/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/biblatex-publist/README 2023-05-18 20:06:25 UTC (rev 67147)
+++ trunk/Master/texmf-dist/doc/latex/biblatex-publist/README 2023-05-18 20:06:36 UTC (rev 67148)
@@ -46,6 +46,10 @@
== 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.
Modified: trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf
===================================================================
(Binary files differ)
Modified: trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex 2023-05-18 20:06:25 UTC (rev 67147)
+++ trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex 2023-05-18 20:06:36 UTC (rev 67148)
@@ -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 @@
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 @@
\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 separator between extra information (peer review, OpenAccess) can be redefined.
+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\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 @@
\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,7 +670,11 @@
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}
With the option \joption{linktitles} (see sec.~\ref{sec:addopts}), titles and subtitles are turned into clickable
@@ -900,6 +927,13 @@
\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}
Modified: trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx
===================================================================
--- trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx 2023-05-18 20:06:25 UTC (rev 67147)
+++ trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx 2023-05-18 20:06:36 UTC (rev 67148)
@@ -25,8 +25,8 @@
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\def\bpl at version{2.3}
-\def\bpl at rdate{2023/03/18}
+\def\bpl at version{2.4}
+\def\bpl at rdate{forthcoming}
\ProvidesFile{publist.bbx}[\bpl at rdate\space v.\bpl at version\space
biblatex bibliography style (JSP)]
@@ -49,6 +49,7 @@
%
\newif\if at marginyear\@marginyearfalse
\newif\if at hlyear\@hlyeartrue
+\newif\if at fixyear\@fixyeartrue
\newif\if at pubstateextra\@pubstateextrafalse
\newif\if at hlauthor\@hlauthorfalse
\newif\if at givenfirst\@givenfirstfalse
@@ -101,6 +102,9 @@
% hlyear=<true|false>
% Set year highlighted
hlyear.legacy_if_set:n = @hlyear,
+ % fixyear=<true|false>
+ % Fix year at first position
+ fixyear.legacy_if_set:n = @fixyear,
% pubstateextra=<true|false>
% Extra label for pubstates
pubstateextra.legacy_if_set:n = @pubstateextra,
@@ -429,6 +433,7 @@
\DeclareBibliographyOption{plnumbering}[global]{\ExecutePublistOptions{plnumbering=#1}}
\DeclareBibliographyOption{marginyear}[true]{\ExecutePublistOptions{marginyear=#1}}
\DeclareBibliographyOption{hlyear}[true]{\ExecutePublistOptions{hlyear=#1}}
+\DeclareBibliographyOption{fixyear}[true]{\ExecutePublistOptions{fixyear=#1}}
\DeclareBibliographyOption{pubstateextra}[true]{\ExecutePublistOptions{pubstateextra=#1}}
\DeclareBibliographyOption{jifinfo}[true]{\ExecutePublistOptions{jifinfo=#1}}
\DeclareBibliographyOption{oainfo}[simple]{\ExecutePublistOptions{oainfo=#1}}
@@ -1185,6 +1190,9 @@
\apptocmd{\abx at macro@endrelated}{\global\togglefalse{isinrelated}}{}%
{\PackageWarning{biblatex-publist}{Patching endrelated failed!}}
+\providecommand*\bplopenoa{\bibopenparen}
+\providecommand*\bplcloseoa{\bibcloseparen}
+
% Omission/highlighting routine
% (common code for authors and editors)
% \usebibmacro{bpl:handlenames}[author|editor]
@@ -1251,7 +1259,7 @@
\else% \if at hlauthor false
\ifthenelse{\value{listcount}=1}%
{\ifthenelse{\value{nonpl#1s}>0\AND{\value{pl#1s}}>0}%
- {\iftoggle{isinrelated}{}{\bibopenparen\bibstring{with}\addspace}}%
+ {\iftoggle{isinrelated}{}{\bplopenoa\bibstring{with}\addspace}}%
{}%
\iftoggle{isplauthor}%
{\global\toggletrue{plauthorprecedes}}%
@@ -1291,7 +1299,7 @@
%
\usebibmacro{bpl:name:andothers}%
\ifthenelse{\value{nonpl#1s}>0\AND{\value{pl#1s}}>0\AND\value{listcount}=\value{liststop}}%
- {\unspace\iftoggle{isinrelated}{}{\bibcloseparen}}%
+ {\unspace\iftoggle{isinrelated}{}{\bplcloseoa}}%
{}%
\fi% end of \if at hlauthor else condition
}
@@ -1366,13 +1374,19 @@
}%
}%
}%
- \adddot\addspace\usebibmacro{bpl:year+labelyear}%
+ \if at fixyear%
+ \adddot\addspace%
+ \usebibmacro{bpl:year+labelyear}%
+ \fi%
\else% \if at hlauthor false
\ifnameundef{author}
{}
{%
\usebibmacro{bpl:marginyear}%
- \usebibmacro{bpl:year+labelyear}\addspace%
+ \if at fixyear%
+ \usebibmacro{bpl:year+labelyear}%
+ \addspace%
+ \fi%
\printnames[][-\value{listtotal}]{author}%
\setunit{\addspace}%
\iffieldundef{nameaddon}
@@ -1397,8 +1411,10 @@
\setunit{\printdelim{editortypedelim}}%
\usebibmacro{editorstrg}%
}%
- \adddot\addspace%
- \usebibmacro{bpl:year+labelyear}%
+ \if at fixyear%
+ \adddot\addspace%
+ \usebibmacro{bpl:year+labelyear}%
+ \fi%
\clearname{editor}%
\else% \if at hlauthor false
\ifnameundef{editor}
@@ -1405,8 +1421,10 @@
{}
{%
\usebibmacro{bpl:marginyear}%
- \usebibmacro{bpl:year+labelyear}%
- \addspace%
+ \if at fixyear
+ \usebibmacro{bpl:year+labelyear}%
+ \addspace%
+ \fi%
\printnames[][-\value{listtotal}]{editor}%
\setunit{\printdelim{editortypedelim}}%
\usebibmacro{editorstrg}%
@@ -1538,7 +1556,7 @@
}%
\fi
}
-
+
\newbibmacro*{bpl:year+labelyear}{%
\iffieldundef{year}{%
\iffieldundef{pubstate}%
Modified: trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx
===================================================================
--- trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx 2023-05-18 20:06:25 UTC (rev 67147)
+++ trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx 2023-05-18 20:06:36 UTC (rev 67148)
@@ -26,8 +26,8 @@
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\def\bpl at version{2.3}
-\def\bpl at rdate{2023/03/18}
+\def\bpl at version{2.4}
+\def\bpl at rdate{forthcoming}
\ProvidesFile{publist.cbx}[\bpl at rdate\space v.\bpl at version\space
biblatex citation style (JSP)]
Modified: trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.dbx
===================================================================
--- trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.dbx 2023-05-18 20:06:25 UTC (rev 67147)
+++ trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.dbx 2023-05-18 20:06:36 UTC (rev 67148)
@@ -1,5 +1,5 @@
% publist.dbx, biblatex data model specification for the biblatex-publist
-% package, version 2.3 (2023/03/18).
+% package, version 2.4 (2023/05/18).
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
More information about the tex-live-commits
mailing list.