diff options
author | Karl Berry <karl@freefriends.org> | 2024-08-21 21:53:17 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2024-08-21 21:53:17 +0000 |
commit | 51d23d9c8e6ab2bf9976fcafb4fdf3be89f6f6b3 (patch) | |
tree | 0227ab125d24cbad39b0497f35588f4890bcb126 | |
parent | 050f9c9bbb2bdb6e48cf31c895923a17c5298cd7 (diff) |
biblatex-publist (21aug24)
git-svn-id: svn://tug.org/texlive/trunk@72079 c570f23f-e606-0410-a88d-b1316a301751
21 files changed, 343 insertions, 54 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/README b/Master/texmf-dist/doc/latex/biblatex-publist/README index f452a57a9f0..11885c99935 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/README +++ b/Master/texmf-dist/doc/latex/biblatex-publist/README @@ -46,6 +46,13 @@ instructions. == CHANGES == +* V. 2.13 (2024-08-21): + - Add basic support for author annotations. + - Add support for information about number of citations. + - Add support for \citesecitem and \citesecitem* in + descending order. + - Fix \citeitem in first refsection. + * V. 2.12 (2024-07-16): - Externalize localization to *.lbx files. - Add \citeitemrange and \citesecitemrange commands. 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 1d58e50fd55..fd041e59a8a 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 a140ad01331..241bba978e5 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex +++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex @@ -115,7 +115,7 @@ \thanks{Please report issues via \protect\url{https://github.com/jspitz/biblatex-publist}.}% } -\date{Version 2.12, 2024/07/16} +\date{Version 2.13, 2024/08/21} \maketitle \begin{abstract} @@ -162,6 +162,7 @@ The list of features includes: \begin{itemize} \setlength\itemsep{0pt} \item Omit or hide selected author names, with a specific indication of co-authors in the former case + \item Indicate author roles \item Filter publications of specific authors from heterogeneous bibliography databases \item Date-centric sorting (as typical for publication lists) \item Number items in ascending or descending order, globally or sectional @@ -226,7 +227,7 @@ out and the collaborators added in parentheses, as in: If \joption{plauthorhandling=highlight} is used (see next section), the plauthor(s) will be printed in bold face instead, as in: \begin{itemize} -\item[{[2]}] Doe, John, \textbf{Myself, Me} and Hall, Mary, \textbf{1987}. Are there new trends +\item[{[2]}] Doe, John, \textbf{Myself, Me}, and Hall, Mary. \textbf{1987}. Are there new trends in gardening? In: \emph{Gardening Practice} 24, pp.~10--15. \end{itemize} % @@ -258,6 +259,10 @@ By default, the publist author (as defined with \jcsmacro{plauthorname}) is omit the author or editor list. If you use the option \joption{plauthorhandling=highlight}, it is highlighted instead (set in bold face by default; see sec.~\ref{sec:auxmacros} how to change that). +\item [{\joption{annotations=\{comma-separated list\}}}] + +A list of data annotations that should be handled in output. See sec.~\ref{sec:annotations} for details. + \item [{\joption{nameorder{[}=family-given|given-family{]}}}] default: \emph{family-given}. By default, the author and editor names with \joption{plauthorhandling=highlight} are output in the order \enquote{Lastname, Given Names}. @@ -329,6 +334,11 @@ with abbreviated and full first name (\textsc{J. Doe} and well as \textsc{John D works of colleagues with the same surname (maybe your family members), which you will not want to mark as your own's. Of course, the solution does not help if there is an entry with same surname and same first name initial (such as \textsc{Jane Doe}). +\item [{\joption{citinfo{[}=true|false{]}}}] default: \emph{false}. + +If this option is \joption{true}, the number of citations, as specified via the \texttt{citations} field +(see section~\ref{sec:citinfo}), will be appended to the entries. + \item [{\joption{jifinfo{[}=true|false{]}}}] default: \emph{false}. If this option is \joption{true}, the journal impact factor, as specified via the \texttt{impactfactor} field @@ -591,6 +601,85 @@ The omission indicator, \jcsmacro*{plnameomission}, can be redefined. The defaul \newcommand*\plnameomission{\bibellipsis\addcomma\addspace} \end{lstlisting} + +\subsection{Indicating Author Roles}\label{sec:annotations} + +If you want to indicate author roles (e.\,g., signify who is corresponding or main author +of a paper), you need to add this information to the respective entries, +but you do not want to clutter the author data. +With \bibltx, separating such extra information from the actual data is well supported +via the data annotation feature, as in: +\begin{lstlisting}[morekeywords={[1]{author}}, otherkeywords={author+an}] +author = {John Doe and Mary Hall and Me Myself}, +author+an = {1=corresponding; 3=main}, +\end{lstlisting} +% +where the number (key) refers to the respective name in the list, and the value to the annotation category +which you can name as you wish. +Multiple annotations to a single person are possible if you pass multiple comma-separated categories to +one key, as in \texttt{1=corresponding,main} (please refer to the \bibltx\ manual \cite{bibltx} for details). + +To handle such annotations, however, the style file needs to know what to do with what kind of +annotation. Otherwise annotations are just ignored. + +For basic usage, \bpl\ provides some support for such annotations. +If you pass the annotation categories you have used in the \texttt{*.bib} file as a comma-separated list +to the \joption{annotations} option, +\bpl\ will go through these annotations and for each, it +will print a superscripted symbol in front of the author family name. +By default this uses a list similar\footnote{If have moved the single dagger (\textdagger) to a later place, + since some people associate this with the \enquote*{deceased} indicator.} +to the one you know from symbolic (\jfcsmacro{thanks}) footnotes +(in order of the passed category: \textasteriskcentered, \textdaggerdbl, \textsection, \textparagraph, +\textbardbl, \textdagger, {\textasteriskcentered\textasteriskcentered}, {\textdaggerdbl\textdaggerdbl}, +or {\textdagger\textdagger}). Nine different annotations are supported this way. + +With the example given above and \joption{annotations=\{main,correponding\}}, for instance, +you would get +\begin{itemize} + \item[{[4]}] \textsuperscript{\textdaggerdbl}Doe, John, Hall, Mary, and + \textbf{\textsuperscript{\textasteriskcentered}Myself, Me} \ldots +\end{itemize} +% +Of course, each category always gets the same symbol within a publication list, so you can add a caption +to explain those. For easy access to the symbols, you can use \jcsmacro*{GetAnnotSymbol}\jmacro{\{category\}}. +This prints the respective symbol in formatted way (superscripted with default settings). +A starred version of the command prints it without such formatting. + +If you want a different list of symbols, or need more, you can change it by means of the macro +\jcsmacro*{SetAnnotSymbols}\jmacro{\{comma-separated list of symbols/macros\}}. +This will overwrite the default list. + +You can also change the position of the symbol. The default definition is +\begin{lstlisting}[morekeywords={[1]{mkbibnamefamily,bplannot}}] +\renewcommand*{\mkbibnamefamily}[1]{\bplannot #1} +\end{lstlisting} +% +with \jcsmacro{bplannot} being the annotation. You can move it after the name, or to another name +part (e.g., \jfcsmacro{mkbibnamegiven}). + +To change the formatting, you can redefine +\begin{lstlisting}[morekeywords={[1]{mkbplannot,textsuperscript}}] +\newcommand*\mkbplannot[1]{\textsuperscript{#1}} +\end{lstlisting} +% +If you need a different markup (such as coloring or underlining) you need to set up +your own annotation handling as documented in the \bibltx\ manual. + +With \joption{plauthorhandling=omit}, the annotations of the omitted publist author(s) +are appended to the entry (as an annotation and with the specific entry-related information +discussed in the next section). If a \jfcsmacro{bibstring} +\texttt{annot:<category>} exists (predefined keys are \texttt{annot:main} and +\texttt{annot:corresponding}), the respective localized string is output, otherwise +the verbatim category. + +So, again with the example given above, you would get: +\begin{itemize} + \item[{[4]}] \ldots\ (with John \textsuperscript{\textdaggerdbl}Doe and Mary Hall) + \ldots\ [Main auth.]. +\end{itemize} + + \subsection{Adding Specific Entry-Related Information} Publication lists usually contain some information which is not commonly given in normal @@ -612,6 +701,17 @@ in a specific \texttt{@xdata} subset (please refer to the \bibltx\ documentation If the option \joption{jifinfo} is true, then \bpl\ will append the respective information to the entries. A specific localizable bibkey is used for this purpose (see section~\ref{sec:localization}). + +\subsubsection{Number of Citations}\label{sec:citinfo} + +Another common quantification of \enquote*{impact} is the number of citations of a publication +(by other publications). +To track this, \bpl\ provides a specific database field, \texttt{citations}. + +If the option \joption{citinfo} is true, then \bpl\ will append the respective information to the entries. +A specific localizable bibkey is used for this purpose (see section~\ref{sec:localization}). + + \subsubsection{Peer Review}\label{sec:peerreview} It is common, and sometimes mandatory, to add information to publication list entries indicating if @@ -780,6 +880,9 @@ on your setting of the \bibltx\ option \joption{abbreviate}): \begin{description} \setlength{\itemsep}{0pt} +\item[annot:corresponding] the expression \enquote{corresponding author} (short form: \enquote{corr. auth.}). +\item[annot:main] the expression \enquote{main author} (short form: \enquote{main auth.}). +\item[citations] the expression \enquote{citations} (short form: \enquote{cit.}). \item[impactfactor] the expression \enquote{impact factor} (short form: \enquote{JIF}). \item[openaccess:true] the expression \enquote{OpenAccess} (short form: \enquote{OA}). \item[openaccess:gold] the phrase \enquote{OpenAccess (gold)} (short form: \enquote{OA (gold)}). @@ -1059,6 +1162,15 @@ until further change). \section{Revision Log} \begin{description} + \item [{V. 2.13 (2024/08/21):}]~ + \begin{itemize} + \item Add basic support for author annotations (see sec.~\ref{sec:annotations}). + \item Add support for information about number of citations (see sec.~\ref{sec:citinfo}). + \item Add support for \jcsmacro{citesecitem} and \jcsmacro{citesecitem*} in descending + order. + \item Fix \jcsmacro{citeitem} in first refsection. + \end{itemize} + \item [{V. 2.12 (2024/07/16):}]~ \begin{itemize} \item Externalize localization to \texttt{*.lbx} files. diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/UKenglish-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/UKenglish-publist.lbx index 320c493f40f..0b5cce13f51 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/UKenglish-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/UKenglish-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{UKenglish-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist UK English localisation (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/USenglish-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/USenglish-publist.lbx index f20be86b76d..cc6526761d5 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/USenglish-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/USenglish-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{USenglish-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist US English localisation (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/american-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/american-publist.lbx index ae889e02167..5476f022ab0 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/american-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/american-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{american-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist US English localisation (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/australian-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/australian-publist.lbx index ae6d96e9326..0df359aa827 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/australian-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/australian-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{australian-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist AU English localisation (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/austrian-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/austrian-publist.lbx index 0ad5c4119e9..0a82a48b773 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/austrian-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/austrian-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{austrian-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist Austrian localisation (JSP)] @@ -35,8 +35,9 @@ % Localizations \DeclareBibliographyStrings{% inherit = {austrian}, - parttranslationof = {{Teil\"ubersetzung von}{Teil\"ubers\adddotspace von}}, + peerreview:pp = {{Post-Publication-Begutachtung}{Post-Pub\adddot-Beg\adddot}}, with = {{mit}{mit}}, + citations = {{Zitationen}{Zit\adddot}}, impactfactor = {{Impactfaktor}{JIF}}, openaccess:true = {{OpenAccess}{OA}}, openaccess:gold = {{OpenAccess (gold)}{OA (gold)}}, @@ -48,7 +49,9 @@ peerreview:cc = {{Cascading-Begutachtung}{Cascading-Beg\adddot}}, peerreview:tp = {{Begutachtung durch Dritte}{Beg\adddotspace durch Dritte}}, peerreview:pp = {{Post-Publication-Begutachtung}{Post-Pub\adddot-Beg\adddot}}, - peerreview:no = {{keine Begutachtung}{keine Beg\adddot}} + peerreview:no = {{keine Begutachtung}{keine Beg\adddot}}, + annot:main = {{Hauptautor}{Hauptaut\adddot}}, + annot:corresponding = {{Korrespondenzautor}{Korr.-aut\adddot}} } \endinput diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/british-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/british-publist.lbx index dbfe6131180..b1dbaea5be3 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/british-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/british-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{british-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist UK English localisation (JSP)] @@ -37,6 +37,7 @@ inherit = {british}, parttranslationof = {{partial translation of}{part\adddotspace trans\adddotspace of}}, with = {{with}{with}}, + citations = {{citations}{cit\adddot}}, impactfactor = {{impact factor}{JIF}}, openaccess:true = {{OpenAccess}{OA}}, openaccess:gold = {{OpenAccess (gold)}{OA (gold)}}, @@ -48,7 +49,9 @@ peerreview:cc = {{cascading peer review}{casc\adddotspace peer rev\adddot}}, peerreview:tp = {{third-party peer review}{3rd-party peer rev\adddot}}, peerreview:pp = {{post-publication peer review}{post-pub\adddotspace peer rev\adddot}}, - peerreview:no = {{no peer review}{no peer rev\adddot}} + peerreview:no = {{no peer review}{no peer rev\adddot}}, + annot:main = {{main author}{main auth\adddot}}, + annot:corresponding = {{corresponding author}{corr\adddotspace auth\adddot}} } \endinput diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/canadian-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/canadian-publist.lbx index f92334b5bae..288c6941558 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/canadian-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/canadian-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{canadian-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist CDN English localisation (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/english-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/english-publist.lbx index a51deb5583c..a9dc25db89f 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/english-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/english-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{english-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist English localisation (JSP)] @@ -37,6 +37,7 @@ inherit = {english}, parttranslationof = {{partial translation of}{part\adddotspace trans\adddotspace of}}, with = {{with}{with}}, + citations = {{citations}{cit\adddot}}, impactfactor = {{impact factor}{JIF}}, openaccess:true = {{OpenAccess}{OA}}, openaccess:gold = {{OpenAccess (gold)}{OA (gold)}}, @@ -48,7 +49,9 @@ peerreview:cc = {{cascading peer review}{casc\adddotspace peer rev\adddot}}, peerreview:tp = {{third-party peer review}{3rd-party peer rev\adddot}}, peerreview:pp = {{post-publication peer review}{post-pub\adddotspace peer rev\adddot}}, - peerreview:no = {{no peer review}{no peer rev\adddot}} + peerreview:no = {{no peer review}{no peer rev\adddot}}, + annot:main = {{main author}{main auth\adddot}}, + annot:corresponding = {{corresponding author}{corr\adddotspace auth\adddot}} } \endinput diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/french-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/french-publist.lbx index e49a00b8c8f..e2f982b03c6 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/french-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/french-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{french-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist French localisation (JSP)] @@ -37,6 +37,7 @@ inherit = {french}, parttranslationof = {{traduction partielle de}{trad\adddotspace part\adddotspace de}}, with = {{avec}{avec}}, + citations = {{citations}{cit\adddot}}, impactfactor = {{facteur d'impact}{FI}}, openaccess:true = {{libre acc\`es}{libre acc\`es}}, openaccess:gold = {{libre acc\`es (dorée)}{libre acc\`es (dorée)}}, @@ -48,7 +49,9 @@ peerreview:cc = {{\'{e}valuation par les pairs en cascade}{\'{e}val\adddotspace par les pairs en cascade}}, peerreview:tp = {{\'{e}valuation par des pairs ext\'{e}rieurs}{\'{e}val\adddotspace par des pairs ext\adddot}}, peerreview:pp = {{\'{e}valuation par les pairs apr\`{e}s publication}{\'{e}val\adddotspace par les pairs apr\`{e}s pub\adddot}}, - peerreview:no = {{pas d'\'{e}valuation par les pairs}{pas d'\'{e}val\adddotspace par les pairs}} + peerreview:no = {{pas d'\'{e}valuation par les pairs}{pas d'\'{e}val\adddotspace par les pairs}}, + annot:main = {{auteur principale}{aut\adddotspace princ\adddot}}, + annot:corresponding = {{auteur correspondant}{aut\adddotspace corr\adddot}} } \endinput diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/german-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/german-publist.lbx index c7b4570f06b..e67d8d44b10 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/german-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/german-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{german-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist German localisation (JSP)] @@ -37,6 +37,7 @@ inherit = {german}, parttranslationof = {{Teil\"ubersetzung von}{Teil\"ubers\adddotspace von}}, with = {{mit}{mit}}, + citations = {{Zitationen}{Zit\adddot}}, impactfactor = {{Impactfaktor}{JIF}}, openaccess:true = {{OpenAccess}{OA}}, openaccess:gold = {{OpenAccess (gold)}{OA (gold)}}, @@ -48,7 +49,9 @@ peerreview:cc = {{Cascading-Begutachtung}{Cascading-Beg\adddot}}, peerreview:tp = {{Begutachtung durch Dritte}{Beg\adddotspace durch Dritte}}, peerreview:pp = {{Post-Publication-Begutachtung}{Post-Pub\adddot-Beg\adddot}}, - peerreview:no = {{keine Begutachtung}{keine Beg\adddot}} + peerreview:no = {{keine Begutachtung}{keine Beg\adddot}}, + annot:main = {{Hauptautor}{Hauptaut\adddot}}, + annot:corresponding = {{Korrespondenzautor}{Korr.-aut\adddot}} } \endinput diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/naustrian-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/naustrian-publist.lbx index 85e0c9a92c7..3b202fe4594 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/naustrian-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/naustrian-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{naustrian-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist Austrian localisation (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/newzealand-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/newzealand-publist.lbx index 4f9d872e9d8..504410f851f 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/newzealand-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/newzealand-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{newzealand-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist NZ English localisation (JSP)] @@ -37,6 +37,7 @@ inherit = {newzealand}, parttranslationof = {{partial translation of}{part\adddotspace trans\adddotspace of}}, with = {{with}{with}}, + citations = {{citations}{cit\adddot}}, impactfactor = {{impact factor}{JIF}}, openaccess:true = {{OpenAccess}{OA}}, openaccess:gold = {{OpenAccess (gold)}{OA (gold)}}, @@ -48,7 +49,9 @@ peerreview:cc = {{cascading peer review}{casc\adddotspace peer rev\adddot}}, peerreview:tp = {{third-party peer review}{3rd-party peer rev\adddot}}, peerreview:pp = {{post-publication peer review}{post-pub\adddotspace peer rev\adddot}}, - peerreview:no = {{no peer review}{no peer rev\adddot}} + peerreview:no = {{no peer review}{no peer rev\adddot}}, + annot:main = {{main author}{main auth\adddot}}, + annot:corresponding = {{corresponding author}{corr\adddotspace auth\adddot}} } \endinput diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/ngerman-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/ngerman-publist.lbx index 54f65ef3838..185cbe903a6 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/ngerman-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/ngerman-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{ngerman-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist German localisation (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/nswissgerman-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/nswissgerman-publist.lbx index be8a9d148ad..a2f1813b38f 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/nswissgerman-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/nswissgerman-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{nswissgerman-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist Swiss German localisation (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/swissgerman-publist.lbx b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/swissgerman-publist.lbx index 5d4be275abd..9bc6f051187 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/lbx/swissgerman-publist.lbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/lbx/swissgerman-publist.lbx @@ -23,8 +23,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{swissgerman-publist.lbx}[\bpl@rdate\space v.\bpl@version\space biblatex-publist Swiss German localisation (JSP)] @@ -37,6 +37,7 @@ inherit = {swissgerman}, parttranslationof = {{Teil\"ubersetzung von}{Teil\"ubers\adddotspace von}}, with = {{mit}{mit}}, + citations = {{Zitationen}{Zit\adddot}}, impactfactor = {{Impactfaktor}{JIF}}, openaccess:true = {{OpenAccess}{OA}}, openaccess:gold = {{OpenAccess (gold)}{OA (gold)}}, @@ -48,7 +49,9 @@ peerreview:cc = {{Cascading-Begutachtung}{Cascading-Beg\adddot}}, peerreview:tp = {{Begutachtung durch Dritte}{Beg\adddotspace durch Dritte}}, peerreview:pp = {{Post-Publication-Begutachtung}{Post-Pub\adddot-Beg\adddot}}, - peerreview:no = {{keine Begutachtung}{keine Beg\adddot}} + peerreview:no = {{keine Begutachtung}{keine Beg\adddot}}, + annot:main = {{Hauptautor}{Hauptaut\adddot}}, + annot:corresponding = {{Korrespondenzautor}{Korr.-aut\adddot}} } \endinput diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx index 371a06232b1..d3f31a7a03c 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx @@ -25,8 +25,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{publist.bbx}[\bpl@rdate\space v.\bpl@version\space biblatex bibliography style (JSP)] @@ -61,13 +61,14 @@ \newtoggle{bpl@linktitleissn} \newtoggle{bpl@linktitleurl} \newtoggle{bpl@linktitledoi} +\newtoggle{bpl@citinfo} \newtoggle{bpl@jifinfo} \newtoggle{bpl@prinfo} \toggletrue{bpl@prinfo} \newtoggle{bpl@oainfo} \newtoggle{bpl@oainfosimple} \newif\if@bpl@reversenum\@bpl@reversenumfalse - +\def\bpl@annots{} % Valid options % @@ -188,6 +189,9 @@ }, plnumbering.default:n = { global }, plnumbering.usage:n = preamble, + % annotations=<csv> + % Store author name prefix + annotations.tl_set:N = \bpl@annots, % linktitles=<all|url|doi|isbn|issn|none> linktitles .multichoice:, % Link all titles @@ -233,6 +237,18 @@ \toggletrue{bpl@linktitle} }, linktitles.default:n = { all }, + % citinfo=<true|false> + % Information about citation numbers + citinfo.code:n = + { + \str_if_eq:nnTF { #1 } { true } + { + \toggletrue{bpl@citinfo} + }{ + \togglefalse{bpl@citinfo} + } + }, + citinfo.default:n = { true }, % jifinfo=<true|false> % Impact factor information jifinfo.code:n = @@ -428,6 +444,7 @@ \DeclareBibliographyOption{plauthorhandling}[omit]{\ExecutePublistOptions{plauthorhandling=#1}} \DeclareBibliographyOption{nameorder}[family-given]{\ExecutePublistOptions{nameorder=#1}} \DeclareBibliographyOption{plsorting}[ydt]{\ExecutePublistOptions{plsorting=#1}} +\DeclareBibliographyOption{annotations}{\ExecutePublistOptions{annotations={#1}}} \DeclareBibliographyOption{plnumbering}[global]{\ExecutePublistOptions{plnumbering=#1}} \DeclareBibliographyOption{marginyear}[true]{\ExecutePublistOptions{marginyear=#1}} @@ -437,6 +454,7 @@ \DeclareBibliographyOption{jifinfo}[true]{\ExecutePublistOptions{jifinfo=#1}} \DeclareBibliographyOption{oainfo}[simple]{\ExecutePublistOptions{oainfo=#1}} \DeclareBibliographyOption{prinfo}[true]{\ExecutePublistOptions{prinfo=#1}} +\DeclareBibliographyOption{citinfo}[true]{\ExecutePublistOptions{citinfo=#1}} \DeclareBibliographyOption{linktitles}[all]{\ExecutePublistOptions{linktitles={#1}}}% Extra braces needed (multichoice) @@ -986,23 +1004,37 @@ % Print the labelnumber as the total number of entries in the % current refsection, minus the actual labelnumber, plus one \ifbool{plnumgroup}{% - \number\numexpr\csuse{bpl@itemtotal}-#1+1\relax% + \xdef\bpl@current@item@no{\number\numexpr\csuse{bpl@itemtotal}-#1+1\relax}% + \bpl@current@item@no% }{% \ifcsdef{bpl@secitems:\therefsection}{% - \number\numexpr\csuse{bpl@secitems:\therefsection}-#1+1% - +\csuse{bpl@shift@itemtotal}\relax% + \xdef\bpl@current@item@no{\number\numexpr\csuse{bpl@secitems:\therefsection}-#1+1% + +\csuse{bpl@shift@itemtotal}\relax}% + \bpl@current@item@no% }{% - \number\numexpr\csuse{bpl@itemtotal}-#1+1\relax% + \xdef\bpl@current@item@no{\number\numexpr\csuse{bpl@itemtotal}-#1+1\relax}% + \bpl@current@item@no% }% }% }{% % Use decreasing counter \ifcsdef{bpl@items:\theprevrefsection}{% - \number\numexpr\csuse{bpl@itemtotal}-#1+1-\csuse{bpl@items:\theprevrefsection}\relax% + \xdef\bpl@current@item@no{\number\numexpr\csuse{bpl@itemtotal}-#1+1% + -\csuse{bpl@items:\theprevrefsection}\relax}% + \bpl@current@item@no% }{% - \number\numexpr\csuse{bpl@itemtotal}-#1+1\relax% + \xdef\bpl@current@item@no{\number\numexpr\csuse{bpl@itemtotal}-#1+1\relax}% + \bpl@current@item@no% }% }% + % Store number in pbx file + \if@filesw% + \protected@write\bpl@bpxfile{}{% + \csedef{bpl@itemnumber:\thefield{entrykey}}{\bpl@current@item@no}% + \csedef{bpl@itemsec:\thefield{entrykey}}{\therefsection}% + \csedef{bpl@itemtotal}{\csuse{bpl@itemtotal}}% + }% + \fi% }% \renewrobustcmd{\mkbibsecstart}[1]{% \setcounter{prevrefsection}{\therefsection}% @@ -1037,6 +1069,64 @@ \fi }% +% +% Data annotation +% + +\newcommand*\mkbplannot[1]{\textsuperscript{#1}} + +% Symbol helpers +\ExplSyntaxOn + \clist_new:N \l_bpl_annot_symbols + \cs_new_nopar:Npn \SetAnnotSymbols #1 + { + \clist_gset:Nn \l_bpl_annot_symbols { #1 } + } + \SetAnnotSymbols + { \textasteriskcentered, \textdaggerdbl, \textsection, \textparagraph, + \textbardbl, \textdagger, {\textasteriskcentered\textasteriskcentered}, + {\textdaggerdbl\textdaggerdbl}, {\textdagger\textdagger} + } + % get symbol by position (int) + \cs_new_nopar:Npn \bpl@get@annot@symbol #1 + { + \clist_item:Nn \l_bpl_annot_symbols { #1 } + } +\ExplSyntaxOff + +% get symbol by category name +\NewDocumentCommand\GetAnnotSymbol { s m }{ + \edef\tmpa{}% + \setcounter{annotsymb}{1}% + \renewcommand*{\do}[1]{% + \ifstrequal{#2}{##1} + {\edef\tmpa{\bpl@get@annot@symbol{\theannotsymb}}}% + {}% + \stepcounter{annotsymb}% + }% + \expandafter\docsvlist\expandafter{\bpl@annots}% + \IfBooleanTF{#1}{\tmpa}{\mkbplannot{\tmpa}}% +} + +% handle the annotations as passed by annotations option +\AtEndOfPackage{% +\ifx\bpl@annots\empty\else + % helper function for annotations + \newcounter{annotsymb} + \newcommand*\bplannot{% + \setcounter{annotsymb}{1}% + \renewcommand*{\do}[1]{% + \ifitemannotation{##1} + {\mkbplannot{\bpl@get@annot@symbol{\theannotsymb}}}% + {}% + \stepcounter{annotsymb}% + }% + \expandafter\docsvlist\expandafter{\bpl@annots}% + } + % do annotation in family names + \renewcommand*{\mkbibnamefamily}[1]{\bplannot #1} +\fi +} % % New environment for (foreign) reviews @@ -1078,6 +1168,13 @@ } % +% Citation info +% +\DeclareFieldFormat{citations}{% + \bibstring{citations}\addcolon\addspace#1% +} + +% % Impact factor % \DeclareFieldFormat{impactfactor}{% @@ -1379,6 +1476,26 @@ \iftoggle{isplauthor}% {% <- TRUE condition \global\toggletrue{hadplauthor}% + \ifx\bpl@annots\empty\else + \gdef\bpl@extra@annots{}% + \renewcommand*{\do}[1]{% + \ifitemannotation{##1} + {% + \iftoggle{bpl@have@extrainfo}% + {\gappto\bpl@extra@annots{\plextrainfosep\ifbibstring{annot:##1}% + {\bibstring{annot:##1}}% + {##1}}% + }% + {\gappto\bpl@extra@annots{\ifbibstring{annot:##1}% + {\bibstring{annot:##1}}% + {##1}}% + }% + \toggletrue{bpl@have@extrainfo}% + }% + {}% + }% + \expandafter\docsvlist\expandafter{\bpl@annots}% + \fi% }% <- end TRUE condition {% <- FALSE condition \stepcounter{nonpl#1}% @@ -1402,7 +1519,7 @@ {\ifdefvoid{\namepartgiven}{}{\mkbibnamegiven{\namepartgiven}\addspace}}% \ifdefvoid{\namepartprefix}{}{\mkbibnameprefix{\namepartprefix}\addspace}% \global\togglefalse{plauthorprecedes}% - \namepartfamily% + \mkbibnamefamily{\namepartfamily}% }% }% <- end FALSE condition % @@ -1741,6 +1858,12 @@ }% } +% +% Extra information +% + +\def\bpl@extra@annots{} + \newtoggle{bpl@have@extrainfo} \renewbibmacro*{addendum+pubstate}{% @@ -1762,14 +1885,35 @@ not test {\iffieldundef{impactfactor}} and test {\iftoggle{bpl@jifinfo}} ) + or + ( + not test {\iffieldundef{citations}} + and test {\iftoggle{bpl@citinfo}} + ) + or + ( + not test {\ifcsvoid{bpl@extra@annots}} + ) }{% \newunit\newblock% \printtext[plextrainfo]{% + \ifx\bpl@extra@annots\empty\else + \bpl@extra@annots% + \toggletrue{bpl@have@extrainfo}% + \fi \ifboolexpr{ not test {\iffieldundef{peerreview}} and test {\iftoggle{bpl@prinfo}} }{% - \toggletrue{bpl@have@extrainfo}% + \iftoggle{bpl@have@extrainfo}{\plextrainfosep}{}% \printfield{peerreview}% + \toggletrue{bpl@have@extrainfo}% + }{}% + \ifboolexpr{ not test {\iffieldundef{citations}} + and test {\iftoggle{bpl@citinfo}} + }{% + \iftoggle{bpl@have@extrainfo}{\plextrainfosep}{}% + \printfield{citations}% + \toggletrue{bpl@have@extrainfo}% }{}% \ifboolexpr{ not test {\iffieldundef{openaccess}} and test {\iftoggle{bpl@oainfo}} @@ -1795,6 +1939,7 @@ \DeclareLanguageMappingSuffix{-publist} % publist-specific bibstrings +\NewBibliographyString{citations} \NewBibliographyString{with} \NewBibliographyString{parttranslationof} \NewBibliographyString{impactfactor} @@ -1809,6 +1954,8 @@ \NewBibliographyString{peerreview:tp} \NewBibliographyString{peerreview:pp} \NewBibliographyString{peerreview:no} +\NewBibliographyString{annot:main} +\NewBibliographyString{annot:corresponding} % diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx index 8176810996a..d384445d635 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx @@ -26,8 +26,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{2.12} -\def\bpl@rdate{2024/07/16} +\def\bpl@version{2.13} +\def\bpl@rdate{2024/08/21} \ProvidesFile{publist.cbx}[\bpl@rdate\space v.\bpl@version\space biblatex citation style (JSP)] diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.dbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.dbx index 9e4b798f8c3..27cb4068f5f 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/publist.dbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/publist.dbx @@ -1,5 +1,5 @@ % publist.dbx, biblatex data model specification for the biblatex-publist -% package, version 2.12 (2024/07/16). +% package, version 2.13 (2024/08/21). % % This work may be distributed and/or modified under the % conditions of the LaTeX Project Public License, either version 1.3 @@ -22,11 +22,13 @@ % Add peerreview and openaccess (literal) field \DeclareDatamodelFields[type=field, datatype=literal]{ + citations, impactfactor, openaccess, peerreview} \DeclareDatamodelEntryfields{ + citations, impactfactor, openaccess, peerreview} |