biblatex-publist (10jul20)

git-svn-id: svn://tug.org/texlive/trunk@55801 c570f23f-e606-0410-a88d-b1316a301751

5 files changed, 163 insertions, 6 deletions

diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/README b/Master/texmf-dist/doc/latex/biblatex-publist/README
index d2ebc582588..cfc3c42f5ab 100644
--- a/Master/texmf-dist/doc/latex/biblatex-publist/README
+++ b/Master/texmf-dist/doc/latex/biblatex-publist/README
@@ -45,6 +45,9 @@ instructions.
 
 == CHANGES ==
 
+* V. 1.17 (2020-07-10):
+	- Add options to get clickable titles.
+
 * V. 1.16 (2019-04-16):
 	- Major code cleanup.
 
diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf
index 935fb576852..55ccaa2f3f6 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 cbd326deb08..001ee67721c 100644
--- a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex
@@ -102,7 +102,7 @@
 \thanks{Please report issues via \protect\url{https://github.com/jspitz/biblatex-publist}.}%
 }
 
-\date{Version 1.16, 2019/04/16}
+\date{Version 1.17, 2020/07/10}
 \maketitle
 
 \begin{abstract}
@@ -159,7 +159,7 @@ It informs the style file which name(s) it should suppress or highlight in the
 author\slash editor list (usually yours). 
 
 With the default settings, the author\slash editor name(s) will be omitted completely
-for all of publications which are authored or edited only by the specified person(s), as in:
+for all publications which are authored or edited only by the specified person(s), as in:
 \begin{quote}
 \textbf{2012.} Some recent trends in gardening. In: \emph{Gardening
 Practice} 56, pp.~34--86.
@@ -242,6 +242,38 @@ 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}).
 
+\end{description}
+%
+The following options are available if \textsf{hyperref} is loaded:
+
+\begin{description}
+
+\item [{\joption{linktitleall{[}=true|false{]}}}] default: \emph{false}.
+
+Turns the title (and subtitle, if available) into a clickable hyperlink to either the DOI, the URL, the ISBN,
+or the ISSN (the latter two via customizable search provider), if any of these is available. See section~\ref{sec:clicktitles}
+for details.
+
+\item [{\joption{linktitledoi{[}=true|false{]}}}] default: \emph{false}.
+
+Turns the title (and subtitle, if available) into a clickable hyperlink to the DOI, if available. See section~\ref{sec:clicktitles}
+for details.
+
+\item [{\joption{linktitleurl{[}=true|false{]}}}] default: \emph{false}.
+
+Turns the title (and subtitle, if available) into a clickable hyperlink to the URL, if available. See section~\ref{sec:clicktitles}
+for details.
+
+\item [{\joption{linktitleisbn{[}=true|false{]}}}] default: \emph{false}.
+
+Turns the title (and subtitle, if available) into a clickable hyperlink to the ISBN (via customizable search provider), if available.
+See section~\ref{sec:clicktitles} for details.
+
+\item [{\joption{linktitleissn{[}=true|false{]}}}] default: \emph{false}.
+
+Turns the title (and subtitle, if available) into a clickable hyperlink to the ISSN (via customizable search provider), if available.
+See section~\ref{sec:clicktitles} for details.
+
 
 \end{description}
 
@@ -328,6 +360,27 @@ differ from what you expect with specific base styles. To change the order,
 use the package option \joption{nameorder} (see sec.~\ref{sec:addopts}).
 
 
+\subsection{Clickable titles}\label{sec:clicktitles}
+
+With the options \joption{linktitledoi}, \joption{linktitleurl}, \joption{linktitleisbn}, \joption{linktitleissn}
+or the combining option \joption{linktitleall}, titles and subtitles are turned into clickable hyperlinks if
+the \textsf{hyperref} package is loaded, and the respective data is there, i.\,e., if either the DOI field,
+the URL field, the ISBN field or the ISSN field is defined for the given entry (checked in this order if multiple
+of these options or \joption{linktitleall} are used).
+
+With URL and DOI, direct links are created. With ISBN or ISSN, a link to a search provider is created instead
+(\textsf{worldcat} by default). The search provider can be customized by redefining the following macros:
+\begin{lstlisting}[moretexcs={[2]{plisbnlink,plissnlink}}]
+\newcommand*\plisbnlink[1]{https://www.worldcat.org/search?qt=worldcat_org_all&q=#1}
+\newcommand*\plissnlink[1]{https://www.worldcat.org/search?qt=worldcat_org_all&q=#1}
+\end{lstlisting}
+%
+where \verb|#1| is a placeholder for the ISBN or ISSN, respectively.
+
+Note that the output of URLs, DOIs, ISBNs and ISSNs is not affected by the \joption{linktitle} options,
+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}
 
 Since the package draws on \bibltx, it supports localization. 
@@ -539,6 +592,11 @@ or
 \section{Revision Log}
 
 \begin{description}
+	\item [{V. 1.17 (2020-07-10):}]~
+	\begin{itemize}
+		\item Add options to get clickable titles. See sec.~\ref{sec:clicktitles}.
+	\end{itemize}
+
 	\item [{V. 1.16 (2019-04-16):}]~
 	\begin{itemize}
 		\item Major code cleanup.
diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx
index 7ba7be52cee..4c8f91ff625 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{1.16}
-\def\bpl@rdate{2019/04/16}
+\def\bpl@version{1.17}
+\def\bpl@rdate{2020/07/10}
 
 \ProvidesFile{publist.bbx}[\bpl@rdate\space v.\bpl@version\space
                            biblatex bibliography style (JSP)]
@@ -127,6 +127,59 @@
 	}
 }
 
+\newtoggle{bpl@linktitle}
+\newtoggle{bpl@linktitleisbn}
+\newtoggle{bpl@linktitleissn}
+\newtoggle{bpl@linktitleurl}
+\newtoggle{bpl@linktitledoi}
+\DeclareBibliographyOption{linktitleall}[true]{%
+    \ifstrequal{#1}{true}{
+       \toggletrue{bpl@linktitleisbn}
+       \toggletrue{bpl@linktitleissn}
+       \toggletrue{bpl@linktitleurl}
+       \toggletrue{bpl@linktitledoi}
+       \toggletrue{bpl@linktitle}
+    }{%
+       \togglefalse{bpl@linktitleisbn}
+       \togglefalse{bpl@linktitleissn}
+       \togglefalse{bpl@linktitleurl}
+       \togglefalse{bpl@linktitledoi}
+       \togglefalse{bpl@linktitle}
+    }%
+}
+\DeclareBibliographyOption{linktitleurl}[true]{%
+    \ifstrequal{#1}{true}{%
+       \toggletrue{bpl@linktitleurl}
+       \toggletrue{bpl@linktitle}
+    }{%
+       \togglefalse{bpl@linktitleurl}
+    }%
+}
+\DeclareBibliographyOption{linktitledoi}[true]{%
+    \ifstrequal{#1}{true}{%
+       \toggletrue{bpl@linktitledoi}
+       \toggletrue{bpl@linktitle}
+    }{%
+       \togglefalse{bpl@linktitledoi}
+    }%
+}
+\DeclareBibliographyOption{linktitleisbn}[true]{%
+    \ifstrequal{#1}{true}{%
+       \toggletrue{bpl@linktitleisbn}
+       \toggletrue{bpl@linktitle}
+    }{%
+       \togglefalse{bpl@linktitleisbn}
+    }%
+}
+\DeclareBibliographyOption{linktitleissn}[true]{%
+    \ifstrequal{#1}{true}{%
+       \toggletrue{bpl@linktitleissn}
+       \toggletrue{bpl@linktitle}
+    }{%
+       \togglefalse{bpl@linktitleissn}
+    }%
+}
+
 % Check if users have defined different base styles
 % If not, use authoryear.
 \newif\ifbpl@standardbasestyle\bpl@standardbasestylefalse
@@ -1096,6 +1149,27 @@
 }
 
 
+% Define bibmacro that applies a hypertext reference
+% Inspired by https://tex.stackexchange.com/a/48506/19291
+\newbibmacro*{bpl:linked}[1]{%
+  \ifboolexpr{ test {\ifhyperref} and not test {\ifentrytype{online}} }
+    {\iffieldundef{doi}
+       {\iffieldundef{url}
+          {\iffieldundef{isbn}
+             {\iffieldundef{issn}
+                {#1}
+                {\iftoggle{bpl@linktitleissn}{\href{\plissnlink{\thefield{issn}}}{#1}}{#1}}}
+             {\iftoggle{bpl@linktitleisbn}{\href{\plisbnlink{\thefield{isbn}}}{#1}}{#1}}}
+          {\iftoggle{bpl@linktitleurl}{\href{\thefield{url}}{#1}}{#1}}}
+       {\iftoggle{bpl@linktitledoi}{\href{https://doi.org/\thefield{doi}}{#1}}{#1}}}
+    {#1}%
+}
+
+% URL for ISBN/ISSN queries
+\newcommand*\plisbnlink[1]{https://www.worldcat.org/search?qt=worldcat_org_all&q=#1}
+\newcommand*\plissnlink[1]{https://www.worldcat.org/search?qt=worldcat_org_all&q=#1}
+
+
 %
 % Mappings (biber)
 %
@@ -1139,6 +1213,28 @@
     }
 }
 
+% Link titles if so requested
+\AtBeginDocument{%
+\iftoggle{bpl@linktitle}{%
+  \DeclareStyleSourcemap{
+     \maps[datatype=bibtex]{
+        \map[overwrite=true]{
+            \step[fieldsource=title,
+                  match=\regexp{(.*)},
+                  replace=\regexp{\\usebibmacro{bpl:linked}{$1}},
+                  final=true]
+        }
+        \map[overwrite=true]{
+            \step[fieldsource=subtitle,
+                  match=\regexp{(.*)},
+                  replace=\regexp{\\usebibmacro{bpl:linked}{$1}},
+                  final=true]
+        }
+     }
+  }
+}{}
+}
+
 
 %
 % Deprecated stuff
diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx
index 2a18c9e50d8..d70ac4dbf5a 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{1.16}
-\def\bpl@rdate{2019/04/16}
+\def\bpl@version{1.17}
+\def\bpl@rdate{2020/07/10}
 
 \ProvidesFile{publist.cbx}[\bpl@rdate\space v.\bpl@version\space
                            biblatex citation style (JSP)]