summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-publist
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-01-06 03:00:48 +0000
committerNorbert Preining <norbert@preining.info>2022-01-06 03:00:48 +0000
commit55032f1ad7128dcf6493e798424f4ade02c923a7 (patch)
tree10ba73ec0f911b4bcf9947f34fda4efc3a9791b5 /macros/latex/contrib/biblatex-contrib/biblatex-publist
parentc03c0d515f1bfbd111d40e78805db4696e080fb8 (diff)
CTAN sync 202201060300
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-publist')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/README8
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.pdfbin371571 -> 374962 bytes
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex88
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.bbx143
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.cbx4
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.dbx29
6 files changed, 238 insertions, 34 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-publist/README b/macros/latex/contrib/biblatex-contrib/biblatex-publist/README
index 690c242cd6..03fc943a6a 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/README
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-publist/README
@@ -32,6 +32,7 @@ The package consists of the following files:
* publist.bbx (biblatex bibliography style file)
* publist.cbx (biblatex citation style file)
+* publist.dbx (biblatex database model file)
* biblatex-publist.pdf (package documentation)
* biblatex-publist.tex (documentation source)
* README (this very file)
@@ -45,6 +46,13 @@ instructions.
== CHANGES ==
+* V. 1.26 (2022-01-05):
+ - Provide means to add peer review information.
+ - Add a data model (*.dbx) file.
+ - Fix \textcite output at least for the standard cases (#36).
+ - Do not highlight/omit author/editor names in related entries.
+ - Rename bpl:review:* macros to bpl:plain:* and add bpl:plain:editor.
+
* V. 1.25 (2021-12-14):
- More robustification with names consisting of non-ASCII chars.
- With "pubstateextra", differentiate between pubstates.
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 2ea2539720..449d209f27 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 a925e0c0ae..d36ea6480b 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex
@@ -102,31 +102,30 @@
\thanks{Please report issues via \protect\url{https://github.com/jspitz/biblatex-publist}.}%
}
-\date{Version 1.25, 2021/12/14}
+\date{Version 1.26 2022/01/05}
\maketitle
\begin{abstract}
-\noindent The \bpl\ package provides a \bibltx\ style file
+\noindent The \bpl\ package provides a \bibltx\ \cite{bibltx} style file
for publication lists, i.\,e., a bibliography containing one's own
publications. It draws on \bibltx's \emph{authoryear} style by default
(which can be changed), but provides some extra features needed for publication lists,
such as the omission or highlighting of the own name from\slash in author or editor data.
-The package requires at least version 3.8 of the \bibltx\ package\footnote{For \bibltx, see
-\url{http://www.ctan.org/pkg/biblatex}.} and \texttt{biber} (the respective version as required by \bibltx).
+The package requires at least version 3.8 of \bibltx\ and \texttt{biber}
+(the respective version as required by \bibltx).
\end{abstract}
\tableofcontents
\section{Aim of the package}
-The \bpl\ package provides a \bibltx\ bibliography style for a specific task:
-academic publication lists. Such lists, which are a central
-part of the academic CV, contain all or selected publications of a specific
-author, usually sorted by genre and year. Even though publication lists are actually
-nothing else than (specific) bibliographies, they diverge from those in some
-respects. Most notably, it is widespread practice to omit your own name in
-your publication list and only list your co-authors, if there are any, or to
-highlight your own name (e.\,g., with bold face letters).
+The \bpl\ package provides a \bibltx\ bibliography style specifically for academic publication lists.
+Such lists, which are a central part of the academic CV, contain all or selected
+publications of a specific author, usually sorted by genre and year.
+Even though publication lists are actually nothing else than (specific) bibliographies,
+they diverge from those in some respects. Most notably, it is widespread practice
+to omit your own name in your publication list and only list your co-authors,
+if there are any, or to highlight your own name (e.\,g., with bold face letters).
If you want to follow this practice, a normal bibliography style does not
produce the desired result.
@@ -154,6 +153,7 @@ The list of features includes:
\item Highlight year of publication
\item Indicate year of publication (sets) in the margin
\item Clickable titles, linking to the URL, DOI, or a web catalog
+ \item Indicate if/how a title has been peer-reviewed
\item List reviews of specific titles
\item Adjustable base bibliography style
\end{itemize}
@@ -162,10 +162,18 @@ Many features have been suggested by users of the package.
If you miss a specific feature, feel free to suggest it via
\url{https://github.com/jspitz/biblatex-publist/issues}.
+\subsection*{Caveats}
+
Note that \bpl\ relies on rather advanced features of \bibltx\ for some of its own features.
These are only available with the \texttt{biber} backend of \bibltx. Hence \bpl\ requires
the use of \texttt{biber} as well -- the \texttt{bibtex} backend won't work!
+Also note that the aim of \bpl\ is to generate publication lists, so it is not suitable
+for normal bibliographies. Specifically, while basic citing works, more advanced
+forms of citing may break or not produce the expected result. The reason is that
+\bpl\ needs to perform internal tweaks (e.\,g., to \textsf{shortauthor} and
+\textsf{labelname}) which might bite you with customized cite formats.
+
\section{Usage}
@@ -267,7 +275,6 @@ If you prefer the numbering to start from 1 at each section instead, set this op
If you do not want to have any numbers at all, set this option to \joption{false}.
-
\item [{\joption{reversenumbering{[}=true|false{]}}}] default: \emph{false}.
If this option is \joption{true}, the entries will be numbered in descending order, starting from the total
@@ -283,6 +290,12 @@ 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{prinfo{[}=true|false{]}}}] default: \emph{true}.
+
+If this option is \joption{true}, peer review information, as specified via the \texttt{peerreview} field
+(see section~\ref{sec:peerreview}), will be appended to the entries.
+
\end{description}
%
The following options are available if \textsf{hyperref} is loaded:
@@ -377,7 +390,28 @@ The omission indicator, \jcsmacro*{plnameomission}, can be redefined. The defaul
\newcommand*\plnameomission{\bibellipsis\addcomma\addspace}
\end{lstlisting}
-\condbr{4}
+\subsection{Adding Peer Review Information}\label{sec:peerreview}
+
+It is common, and sometimes mandatory, to add information to publication list entries indicating if
+and how listed work has been subject to peer review.
+To this end, \bpl\ provides a specific database field, \texttt{peerreview}, in which you can use
+the following shorthands:
+
+\begin{itemize}\setlength{\itemsep}{0pt}
+ \item{\texttt{sb}} (=~single blind peer review)
+ \item{\texttt{db}} (=~double blind peer review)
+ \item{\texttt{op}} (=~open peer review)
+ \item{\texttt{co}} (=~collaborative peer review)
+ \item{\texttt{cc}} (=~cascading peer review)
+ \item{\texttt{tp}} (=~third-party peer review)
+ \item{\texttt{pp}} (=~post-publication peer review)
+ \item{\texttt{no}} (=~no peer review)
+\end{itemize}
+%
+If the option \joption{prinfo} 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}). Instead of
+the shorthands, you can also enter arbitrary text to the \texttt{peerreview} field, which is then output
+as is (and not localized).
\section{Customization}
@@ -456,17 +490,25 @@ Note that the output of URLs, DOIs, ISBNs and ISSNs is not affected by the \jopt
so you might get redundant output. To control (e.\,g., omit) them, use the \joption{url}, \joption{doi}
and \joption{isbn} biblatex options.
-\section{Localization}
+\section{Localization}\label{sec:localization}
Since the package draws on \bibltx, it supports localization.
The following additional localization keys (\jfcsmacro{bibstrings})
are added by the package:
\begin{itemize}
\item \emph{with}: the preposition ``with'' that precedes the list of
-co-authors by default (i.\,e., with \joption{plauthorhandling=omit}).
+ co-authors by default (i.\,e., with \joption{plauthorhandling=omit}).
\item \emph{parttranslationof}: the expression ``partial translation of''
-for entries referring to partially translated work via \bibltx's
-``related entries'' feature (see sec.~\ref{sec:partial-translations}).
+ for entries referring to partially translated work via \bibltx's
+ ``related entries'' feature (see sec.~\ref{sec:partial-translations}).
+\item \emph{peerreview:sb}: the phrase ``single blind peer review''.
+\item \emph{peerreview:db}: the phrase ``double blind peer review''.
+\item \emph{peerreview:op}: the phrase ``open peer review''.
+\item \emph{peerreview:co}: the phrase ``collaborative peer review''.
+\item \emph{peerreview:cc}: the phrase ``cascading peer review''.
+\item \emph{peerreview:tp}: the phrase ``third-party peer review''.
+\item \emph{peerreview:pp}: the phrase ``post-publication peer review''.
+\item \emph{peerreview:no}: the phrase ``no peer review''.
\end{itemize}
Currently, these additional localization keys are available in the following
languages: English, French and German.%
@@ -667,6 +709,16 @@ or
\begin{description}
+ \item [{V. 1.26 (2022-01-05):}]~
+ \begin{itemize}
+ \item Provide means to add peer review information (see section~\ref{sec:peerreview}).
+ \item Add a data model (\texttt{*.dbx}) file.
+ \item Fix \jcsmacro{textcite} output at least for the standard cases.
+ \item Do not highlight/omit author/editor names in related entries.
+ \item Rename \texttt{bpl:review:*} macros to \texttt{bpl:plain:*} and
+ add \texttt{bpl:plain:editor}.
+ \end{itemize}
+
\item [{V. 1.25 (2021-12-14):}]~
\begin{itemize}
\item More robustification with names consisting of non-ASCII chars.
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.bbx b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.bbx
index 100722aa9b..d8309df788 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{1.25}
-\def\bpl@rdate{2021/12/14}
+\def\bpl@version{1.26}
+\def\bpl@rdate{2022/01/05}
\ProvidesFile{publist.bbx}[\bpl@rdate\space v.\bpl@version\space
biblatex bibliography style (JSP)]
@@ -187,6 +187,12 @@
}%
}
+\newtoggle{bpl@prinfo}
+\toggletrue{bpl@prinfo}
+\DeclareBibliographyOption{prinfo}[true]{%
+ \ifstrequal{#1}{true}{\toggletrue{bpl@prinfo}}{\togglefalse{bpl@prinfo}}
+}
+
\newif\if@bpl@reversenum\@bpl@reversenumfalse
\DeclareBibliographyOption{reversenumbering}[true]{%
\ifstrequal{#1}{true}{\@bpl@reversenumtrue}{\@bpl@reversenumfalse}
@@ -531,6 +537,19 @@
%
+% Peer-review type
+%
+\newcommand\printprinfo[1]{%
+ \ifbibstring{peerreview:#1}%
+ {\bibstring{peerreview:#1}}%
+ {#1}%
+}
+
+\DeclareFieldFormat{peerreview}{%
+ \printtext[brackets]{\printprinfo{#1}}%
+}
+
+%
% Bibliography filter
%
% Inspired by http://tex.stackexchange.com/a/28555/19291
@@ -736,7 +755,7 @@
\else% \if@hlauthor false
\ifthenelse{\value{listcount}=1}%
{\ifthenelse{\value{nonpl#1s}>0\AND{\value{pl#1s}}>0}%
- {\bibopenparen\bibstring{with}\addspace}%
+ {\iftoggle{isinrelated}{}{\bibopenparen\bibstring{with}\addspace}}%
{}%
\iftoggle{isplauthor}%
{\global\toggletrue{plauthorprecedes}}%
@@ -776,7 +795,7 @@
%
\usebibmacro{bpl:name:andothers}%
\ifthenelse{\value{nonpl#1s}>0\AND{\value{pl#1s}}>0\AND\value{listcount}=\value{liststop}}%
- {\unspace\bibcloseparen}%
+ {\unspace\iftoggle{isinrelated}{}{\bibcloseparen}}%
{}%
\fi% end of \if@hlauthor else condition
}
@@ -817,6 +836,24 @@
%
\renewbibmacro*{author}{%
+ \iftoggle{isinrelated}{%
+ \usebibmacro{bpl:plain:author}%
+ }{%
+ \usebibmacro{bpl:author}%
+ }%
+}
+
+
+\renewbibmacro*{editor}{%
+ \iftoggle{isinrelated}{%
+ \usebibmacro{bpl:plain:editor}%
+ }{%
+ \usebibmacro{bpl:editor}%
+ }%
+}
+
+
+\newbibmacro*{bpl:author}{%
\if@hlauthor
\ifnameundef{author}
{}
@@ -854,7 +891,7 @@
\fi% end of \if@hlauthor else condition
}
-\renewbibmacro*{editor}{%
+\newbibmacro*{bpl:editor}{%
\if@hlauthor
\ifnameundef{editor}
{}
@@ -1026,13 +1063,13 @@
}%
}
-\newbibmacro*{bpl:review:author/label}{%
+\newbibmacro*{bpl:plain:author/label}{%
\ifnameundef{author}
{\usebibmacro{label}}
- {\usebibmacro{bpl:review:author}}
+ {\usebibmacro{bpl:plain:author}}
}
-\newbibmacro*{bpl:review:author}{%
+\newbibmacro*{bpl:plain:author}{%
\ifnameundef{author}
{\let\bbx@lasthash\undefined}
{%
@@ -1050,10 +1087,23 @@
\mkbibbrackets{\bibstring[\unspace]{alias}\addspace\printfield{nameaddon}}%
\addspace%
}%
- \usebibmacro{bpl:review:year+labelyear}%
+ \usebibmacro{bpl:plain:year+labelyear}%
+}
+
+\newbibmacro*{bpl:plain:editor}{%
+ \ifnameundef{editor}
+ {}
+ {%
+ \printnames{editor}%
+ \setunit{\printdelim{editortypedelim}}%
+ \usebibmacro{editorstrg}%
+ }%
+ \adddot\addspace%
+ \usebibmacro{bpl:plain:year+labelyear}%
+ \clearname{editor}%
}
-\newbibmacro*{bpl:review:year+labelyear}{%
+\newbibmacro*{bpl:plain:year+labelyear}{%
\iffieldundef{year}
{}
{%
@@ -1064,22 +1114,64 @@
}%
}
+\renewbibmacro*{addendum+pubstate}{%
+ \printfield{addendum}%
+ \newunit\newblock
+ \printfield{pubstate}%
+ \iftoggle{bpl@prinfo}{%
+ \newunit\newblock
+ \printfield{peerreview}%
+ }{}%
+}
+
%
% l7n
%
\NewBibliographyString{with}
\NewBibliographyString{parttranslationof}
+\NewBibliographyString{peerreview:sb}
+\NewBibliographyString{peerreview:db}
+\NewBibliographyString{peerreview:op}
+\NewBibliographyString{peerreview:co}
+\NewBibliographyString{peerreview:cc}
+\NewBibliographyString{peerreview:tp}
+\NewBibliographyString{peerreview:pp}
+\NewBibliographyString{peerreview:no}
\DefineBibliographyStrings{english}{%
parttranslationof = {partial translation of},
- with = {with}
+ with = {with},
+ peerreview:sb = {single blind peer review},
+ peerreview:db = {double blind peer review},
+ peerreview:op = {open peer review},
+ peerreview:co = {collaborative peer review},
+ peerreview:cc = {cascading peer review},
+ peerreview:tp = {third-party peer review},
+ peerreview:pp = {post-publication peer review},
+ peerreview:no = {no peer review}
}
\DefineBibliographyStrings{french}{%
parttranslationof = {traduction partielle de},
- with = {avec}
+ with = {avec},
+ peerreview:sb = {\'{e}valuation par des pairs anonymis\'{e}s},
+ peerreview:db = {\'{e}valuation par les pairs en double aveugle},
+ peerreview:op = {\'{e}valuation par les pairs ouverte},
+ peerreview:co = {\'{e}valuation par les pairs collaborative},
+ peerreview:cc = {\'{e}valuation par les pairs en cascade},
+ peerreview:tp = {\'{e}valuation par des pairs ext\'{e}rieurs},
+ peerreview:pp = {\'{e}valuation par les pairs apr\`{e}s publication},
+ peerreview:no = {pas d'\'{e}valuation par les pairs}
}
\DefineBibliographyStrings{german}{%
parttranslationof = {Teil\"ubersetzung von},
- with = {mit}
+ with = {mit},
+ peerreview:sb = {Blindbegutachtung},
+ peerreview:db = {Doppelblindbegutachtung},
+ peerreview:op = {Offene Begutachtung},
+ peerreview:co = {Kollaborative Begutachtung},
+ peerreview:cc = {Cascading-Begutachtung},
+ peerreview:tp = {Begutachtung durch Dritte},
+ peerreview:pp = {Post-Publication-Begutachtung},
+ peerreview:no = {keine Begutachtung}
}
@@ -1088,7 +1180,7 @@
%
\DeclareBibliographyDriver{review}{%
- \usebibmacro{bpl:review:author/label}%
+ \usebibmacro{bpl:plain:author/label}%
\setunit*{\addcolon\space}%
\usebibmacro{title}%
\newunit\newblock
@@ -1354,15 +1446,38 @@
% Add a dummy constant shortauthor in order to
% ignore author constellation on extralabel assignment.
+% Original entries are stored in namea.
\if@hlauthor
\else
\DeclareStyleSourcemap{
\maps[datatype=bibtex]{
+ \map{
+ \step[fieldsource=shortauthor]
+ \step[fieldset=namea, origfieldval]
+ }
\map[overwrite]{
\step[fieldset=shortauthor, fieldvalue={1111}]
}
}
}
+ % For proper labelname (e.g., \textcite), write back original
+ % shortauthor, author or editor after the extradate has been
+ % constructed.
+ \AtDataInput{%
+ \csgappto\blx@bbl@data{%
+ \let\c@shortauthor\c@namea
+ \let\abx@name@shortauthor\abx@name@namea
+ \ifdefstring\abx@field@labelnamesource{shortauthor}
+ {\ifundef\abx@name@shortauthor
+ {\ifundef\abx@name@author
+ {\def\abx@field@labelnamesource{editor}}
+ {\def\abx@field@labelnamesource{author}}%
+ }%
+ {}%
+ }%
+ {}%
+ }%
+ }%
\fi
% Correctly sort pubstates.
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.cbx b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.cbx
index 13c7945ed0..06b5b151c6 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{1.25}
-\def\bpl@rdate{2021/12/14}
+\def\bpl@version{1.26}
+\def\bpl@rdate{2022/01/05}
\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
new file mode 100644
index 0000000000..2248eece0b
--- /dev/null
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-publist/publist.dbx
@@ -0,0 +1,29 @@
+% publist.dbx, biblatex data model specification for the biblatex-publist
+% package, version 1.26 (2022-01-05).
+%
+% This work may be distributed and/or modified under the
+% conditions of the LaTeX Project Public License, either version 1.3
+% of this license or (at your option) any later version.
+% The latest version of this license is in
+% http://www.latex-project.org/lppl.txt
+% and version 1.3 or later is part of all distributions of LaTeX
+% version 2003/12/01 or later.
+%
+% This work has the LPPL maintenance status "maintained".
+%
+% This Current Maintainer of this work is Jürgen Spitzmüller.
+%
+%
+% Please send suggestions and bug reports to
+% https://github.com/jspitz/biblatex-publist
+%
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+
+% Add peerreview (literal) field
+\DeclareDatamodelFields[type=field, datatype=literal]{
+ peerreview}
+
+\DeclareDatamodelEntryfields{
+ peerreview}
+