summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex
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/biblatex-publist/biblatex-publist.tex
parentb2f81626104e48abe103ae135fb0d538bb2de3cd (diff)
CTAN sync 202305190301
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex60
1 files changed, 47 insertions, 13 deletions
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}