summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2023-05-19 03:01:08 +0000
committerNorbert Preining <norbert@preining.info>2023-05-19 03:01:08 +0000
commitdd54bf2a9c9e985917ceb5ced412213cd44eaeae (patch)
tree0d0a94b7cad225ba7570c9ae16082392e2c41a2b /macros/latex/contrib/biblatex-contrib
parentb2f81626104e48abe103ae135fb0d538bb2de3cd (diff)
CTAN sync 202305190301
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/README4
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.pdfbin406636 -> 408650 bytes
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex60
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.bbx40
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.cbx4
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.dbx2
6 files changed, 83 insertions, 27 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-publist/README b/macros/latex/contrib/biblatex-contrib/biblatex-publist/README
index db58cebe33..7ba4c4a901 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/README
+++ b/macros/latex/contrib/biblatex-contrib/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/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.pdf b/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.pdf
index 3de8c85aaa..39a3d201f4 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.pdf
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.pdf
Binary files differ
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex b/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex
index 16c7241d6e..2f396bb757 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex
+++ b/macros/latex/contrib/biblatex-contrib/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}
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.bbx b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.bbx
index cdb4ea966f..4d9a50efa2 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.bbx
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.bbx
@@ -25,8 +25,8 @@
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\def\bpl@version{2.3}
-\def\bpl@rdate{2023/03/18}
+\def\bpl@version{2.4}
+\def\bpl@rdate{forthcoming}
\ProvidesFile{publist.bbx}[\bpl@rdate\space v.\bpl@version\space
biblatex bibliography style (JSP)]
@@ -49,6 +49,7 @@
%
\newif\if@marginyear\@marginyearfalse
\newif\if@hlyear\@hlyeartrue
+\newif\if@fixyear\@fixyeartrue
\newif\if@pubstateextra\@pubstateextrafalse
\newif\if@hlauthor\@hlauthorfalse
\newif\if@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@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@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@hlauthor else condition
}
@@ -1366,13 +1374,19 @@
}%
}%
}%
- \adddot\addspace\usebibmacro{bpl:year+labelyear}%
+ \if@fixyear%
+ \adddot\addspace%
+ \usebibmacro{bpl:year+labelyear}%
+ \fi%
\else% \if@hlauthor false
\ifnameundef{author}
{}
{%
\usebibmacro{bpl:marginyear}%
- \usebibmacro{bpl:year+labelyear}\addspace%
+ \if@fixyear%
+ \usebibmacro{bpl:year+labelyear}%
+ \addspace%
+ \fi%
\printnames[][-\value{listtotal}]{author}%
\setunit{\addspace}%
\iffieldundef{nameaddon}
@@ -1397,16 +1411,20 @@
\setunit{\printdelim{editortypedelim}}%
\usebibmacro{editorstrg}%
}%
- \adddot\addspace%
- \usebibmacro{bpl:year+labelyear}%
+ \if@fixyear%
+ \adddot\addspace%
+ \usebibmacro{bpl:year+labelyear}%
+ \fi%
\clearname{editor}%
\else% \if@hlauthor false
\ifnameundef{editor}
{}
{%
\usebibmacro{bpl:marginyear}%
- \usebibmacro{bpl:year+labelyear}%
- \addspace%
+ \if@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}%
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.cbx b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.cbx
index ee07e698c3..5587789cc4 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.cbx
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.cbx
@@ -26,8 +26,8 @@
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\def\bpl@version{2.3}
-\def\bpl@rdate{2023/03/18}
+\def\bpl@version{2.4}
+\def\bpl@rdate{forthcoming}
\ProvidesFile{publist.cbx}[\bpl@rdate\space v.\bpl@version\space
biblatex citation style (JSP)]
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.dbx b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.dbx
index 3ebf0da52e..ccc929ac45 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.dbx
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.dbx
@@ -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