summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2022-02-06 03:01:17 +0000
committerNorbert Preining <norbert@preining.info>2022-02-06 03:01:17 +0000
commit350b3e35109171f0edd6fe9d697b91d5e76561f9 (patch)
treec6eac90d0b35dec36fa17ee58b736e55d6e42755 /macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex
parent08ccf305ee79ab8e5ba9d1a8f3d22e74dccedd80 (diff)
CTAN sync 202202060301
Diffstat (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex')
-rw-r--r--macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex135
1 files changed, 115 insertions, 20 deletions
diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex b/macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex
index 815f146267..936bc27ad4 100644
--- a/macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex
+++ b/macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex
@@ -1,14 +1,14 @@
% Options for packages loaded elsewhere
\PassOptionsToPackage{unicode}{hyperref}
\PassOptionsToPackage{hyphens}{url}
-\PassOptionsToPackage{dvipsnames,svgnames*,x11names*}{xcolor}
+\PassOptionsToPackage{dvipsnames,svgnames,x11names}{xcolor}
%
\documentclass[
]{article}
+\usepackage{amsmath,amssymb}
\usepackage{lmodern}
-\usepackage{amssymb,amsmath}
-\usepackage{ifxetex,ifluatex}
-\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
+\usepackage{iftex}
+\ifPDFTeX
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage{textcomp} % provide euro and other symbols
@@ -40,10 +40,10 @@
pdftitle={biblatex-unified},
pdfauthor={Kai von Fintel (fintel@mit.edu)},
colorlinks=true,
- linkcolor=Maroon,
- filecolor=Maroon,
- citecolor=Blue,
- urlcolor=Blue,
+ linkcolor={Maroon},
+ filecolor={Maroon},
+ citecolor={Blue},
+ urlcolor={Blue},
pdfcreator={LaTeX via pandoc}}
\urlstyle{same} % disable monospaced font for URLs
\usepackage{color}
@@ -90,10 +90,13 @@
\providecommand{\tightlist}{%
\setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
\setcounter{secnumdepth}{5}
+\ifLuaTeX
+ \usepackage{selnolig} % disable illegal ligatures
+\fi
\title{biblatex-unified}
\author{Kai von Fintel (fintel@mit.edu)}
-\date{2020-05-25}
+\date{2022-02-05}
\begin{document}
\maketitle
@@ -196,6 +199,13 @@ but before
\end{Highlighting}
\end{Shaded}
+The unified citation style relies on hyperlinking between in-text
+citations and the bibliography. So, the \texttt{hyperref} package is
+required. It is automatically loaded by \texttt{sp.cls} but if you use a
+different document class and \texttt{hyperref} is not loaded by that
+class, you need to add \texttt{\textbackslash{}usepackage\{hyperref\}}
+to your preamble as well.
+
If you were previously using \VERB|\NormalTok{natbib}|, remove
\VERB|\BuiltInTok{\textbackslash{}usepackage}\NormalTok{\{}\ExtensionTok{natbib}\NormalTok{\}}|
and any accompanying
@@ -246,17 +256,17 @@ to the sample bibliography in the Unified Stylesheet guidelines.
\subsection{Producing the
documentation}\label{producing-the-documentation}}
-The documentation consists of the \VERB|\NormalTok{README.md}| file and
-this PDF. The PDF can be regenerated by typesetting the
-\VERB|\NormalTok{tex}| source file with \VERB|\NormalTok{xelatex}|. The
-\VERB|\NormalTok{tex}| is actually itself generated from the underlying
-\VERB|\NormalTok{md}| markdown file via \VERB|\NormalTok{pandoc}| with
-the following incantation:
+The documentation consists of the \VERB|\ExtensionTok{README.md}| file
+and this PDF. The PDF can be regenerated by typesetting the
+\VERB|\ExtensionTok{tex}| source file with
+\VERB|\ExtensionTok{xelatex}|. The \VERB|\ExtensionTok{tex}| is actually
+itself generated from the underlying \VERB|\ExtensionTok{md}| markdown
+file via \VERB|\ExtensionTok{pandoc}| with the following incantation:
\begin{Shaded}
\begin{Highlighting}[]
-\NormalTok{pandoc {-}f markdown {-}t latex biblatex{-}unified.md {-}s}\DataTypeTok{\textbackslash{} }
-\NormalTok{{-}o biblatex{-}unified.tex {-}{-}highlight{-}style=kate}
+\ExtensionTok{pandoc} \AttributeTok{{-}f}\NormalTok{ markdown }\AttributeTok{{-}t}\NormalTok{ latex biblatex{-}unified.md }\AttributeTok{{-}s}\DataTypeTok{\textbackslash{} }
+\ExtensionTok{{-}o}\NormalTok{ biblatex{-}unified.tex }\AttributeTok{{-}{-}highlight{-}style}\OperatorTok{=}\NormalTok{kate}
\end{Highlighting}
\end{Shaded}
@@ -424,7 +434,7 @@ Sheet.
9. \textbf{Parentheses around ed.~makes sense.} Commas and periods
should be used exclusively to separate citation components (e.g.,
``Author. Year.''), or subcomponents (e.g.~``author1, author2 \&
-author3). Since''ed." is neither a component nor a subcomponent, but a
+author3). Since''ed.'' is neither a component nor a subcomponent, but a
modifier of a component, it should not be separated from the name by a
comma:
\end{quote}
@@ -685,6 +695,57 @@ pertain to any explicit guidelines.
\texttt{biblatex-unified} has a space.
\end{enumerate}
+\hypertarget{additional-remarks-on-dois-and-other-links}{%
+\section{Additional remarks on DOIs and other
+links}\label{additional-remarks-on-dois-and-other-links}}
+
+The Unified Style Sheet was devised before the widespread use of DOIs to
+identify the source of materials that are available electronically. It
+is good practice for authors to include DOIs in their bib-file for
+anything that has a DOI. Most modern publications prominently display
+the DOI on the first page of the work and/or in the metadata. Sometimes
+a DOI is harder to find, but \href{http://scholar.google.com/}{Google
+Scholar} and
+\href{http://crossref.org/SimpleTextQuery/}{crossref.org/SimpleTextQuery}
+can help. \texttt{biblatex-unified} displays DOIs as a full link (such
+as \texttt{https://doi.org/10.3765/sp.10.1}) in accordance with
+\href{https://www.crossref.org/display-guidelines/}{the guidelines
+imposed by Crossref}. If you would like a more compact display
+(\texttt{DOI:10.3765/sp.10.1}), you can achieve this by adding the
+\texttt{compactdois} package option to the
+\VERB|\BuiltInTok{\textbackslash{}usepackage}| command:
+
+\begin{Shaded}
+\begin{Highlighting}[]
+ \BuiltInTok{\textbackslash{}usepackage}\NormalTok{[backend=biber,}
+\NormalTok{ style=unified,}
+\NormalTok{ maxcitenames=3,}
+\NormalTok{ maxbibnames=99,}
+\NormalTok{ compactdois]\{}\ExtensionTok{biblatex}\NormalTok{\}}
+\end{Highlighting}
+\end{Shaded}
+
+If you're using the \texttt{sp.cls} document class with the
+\texttt{biblatex} option, you should instead add this to the preamble:
+\VERB|\FunctionTok{\textbackslash{}ExecuteBibliographyOptions}\NormalTok{\{compactdois\}}|,
+if you want compact DOIs
+
+When \texttt{biblatex-unified} is used with the up-todate version of the
+\texttt{sp.cls} documentclass, once a bibentry has a DOI, a link in the
+\texttt{url} field will not also be displayed. If you want to achieve
+this effect with other document classes, you can add the following to
+your preamble after loading \texttt{biblatex-unified}:
+
+\begin{Shaded}
+\begin{Highlighting}[]
+\FunctionTok{\textbackslash{}DeclareSourcemap}\NormalTok{\{}
+ \FunctionTok{\textbackslash{}maps}\NormalTok{[datatype=bibtex]\{}
+ \FunctionTok{\textbackslash{}map}\NormalTok{\{}\FunctionTok{\textbackslash{}step}\NormalTok{[fieldsource=doi,final]}
+ \FunctionTok{\textbackslash{}step}\NormalTok{[fieldset=url,null]}
+ \FunctionTok{\textbackslash{}step}\NormalTok{[fieldset=urldate,null]\}\}\}}
+\end{Highlighting}
+\end{Shaded}
+
\hypertarget{guidelines-for-the-preparation-of-bib-files}{%
\section{Guidelines for the preparation of bib
files}\label{guidelines-for-the-preparation-of-bib-files}}
@@ -733,7 +794,7 @@ file for use with \texttt{biblatex-unified}.
\hypertarget{license-and-copyright}{%
\section{License and copyright}\label{license-and-copyright}}
-Copyright ©2020 Kai von Fintel.
+Copyright ©2022 Kai von Fintel.
This package is author-maintained. Permission is granted to copy,
distribute and/or modify this software under the terms of the LaTeX
@@ -747,6 +808,40 @@ warranties of merchantability and fitness for a particular purpose.
\section{Changelog and release
notes}\label{changelog-and-release-notes}}
-\textbf{v1.00 (2020-05-25)} Initial CTAN release.
+\hypertarget{v1.00-2020-05-25}{%
+\subsection*{v1.00 (2020-05-25)}\label{v1.00-2020-05-25}}
+\addcontentsline{toc}{subsection}{v1.00 (2020-05-25)}
+
+\begin{itemize}
+\tightlist
+\item
+ Initial CTAN release.
+\end{itemize}
+
+\hypertarget{v1.01-2020-09-11}{%
+\subsection*{v1.01 (2020-09-11)}\label{v1.01-2020-09-11}}
+\addcontentsline{toc}{subsection}{v1.01 (2020-09-11)}
+
+\begin{itemize}
+\tightlist
+\item
+ Added note that \texttt{hyperref} is required.
+\end{itemize}
+
+\hypertarget{v1.10-2022-02-05}{%
+\subsection*{v1.10 (2022-02-05)}\label{v1.10-2022-02-05}}
+\addcontentsline{toc}{subsection}{v1.10 (2022-02-05)}
+
+\begin{itemize}
+\tightlist
+\item
+ Internal refactoring of handling of ``von''-names
+\item
+ Changed \texttt{\&} to be glued to previous author
+\item
+ Added \texttt{compactdois} option
+\item
+ Added documentation on DOIs
+\end{itemize}
\end{document}