summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex
diff options
context:
space:
mode:
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.tex62
1 files changed, 60 insertions, 2 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 cbd326deb0..001ee67721 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-publist/biblatex-publist.tex
+++ b/macros/latex/contrib/biblatex-contrib/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.