diff options
author | Norbert Preining <norbert@preining.info> | 2022-02-06 03:01:17 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2022-02-06 03:01:17 +0000 |
commit | 350b3e35109171f0edd6fe9d697b91d5e76561f9 (patch) | |
tree | c6eac90d0b35dec36fa17ee58b736e55d6e42755 /macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex | |
parent | 08ccf305ee79ab8e5ba9d1a8f3d22e74dccedd80 (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.tex | 135 |
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} |