From 5de83ec843cdc88e6adc42b1fe3f0ec48c52b7f3 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Wed, 9 Nov 2022 03:02:50 +0000 Subject: CTAN sync 202211090302 --- .../biblatex-unified/biblatex-unified.tex | 213 +++++++++++++-------- 1 file changed, 131 insertions(+), 82 deletions(-) (limited to 'macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex') 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 936bc27ad4..77a1323f9a 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex +++ b/macros/latex/contrib/biblatex-contrib/biblatex-unified/biblatex-unified.tex @@ -34,18 +34,6 @@ \KOMAoptions{parskip=half}} \makeatother \usepackage{xcolor} -\IfFileExists{xurl.sty}{\usepackage{xurl}}{} % add URL line breaks if available -\IfFileExists{bookmark.sty}{\usepackage{bookmark}}{\usepackage{hyperref}} -\hypersetup{ - pdftitle={biblatex-unified}, - pdfauthor={Kai von Fintel (fintel@mit.edu)}, - colorlinks=true, - linkcolor={Maroon}, - filecolor={Maroon}, - citecolor={Blue}, - urlcolor={Blue}, - pdfcreator={LaTeX via pandoc}} -\urlstyle{same} % disable monospaced font for URLs \usepackage{color} \usepackage{fancyvrb} \newcommand{\VerbBar}{|} @@ -93,10 +81,22 @@ \ifLuaTeX \usepackage{selnolig} % disable illegal ligatures \fi +\IfFileExists{bookmark.sty}{\usepackage{bookmark}}{\usepackage{hyperref}} +\IfFileExists{xurl.sty}{\usepackage{xurl}}{} % add URL line breaks if available +\urlstyle{same} % disable monospaced font for URLs +\hypersetup{ + pdftitle={biblatex-unified}, + pdfauthor={Kai von Fintel (fintel@mit.edu)}, + colorlinks=true, + linkcolor={Maroon}, + filecolor={Maroon}, + citecolor={Blue}, + urlcolor={Blue}, + pdfcreator={LaTeX via pandoc}} \title{biblatex-unified} \author{Kai von Fintel (fintel@mit.edu)} -\date{2022-02-05} +\date{2022-11-08 (v1.20)} \begin{document} \maketitle @@ -112,7 +112,7 @@ Stylesheet for Linguistics Journal}. The stylesheet was developed by the Committee of Editors of Linguistics Journals}. The first implementation of the stylesheet for LaTeX was -\href{https://raw.githubusercontent.com/semprag/tex/master/sp.cls}{\texttt{sp.bst}}, +\href{https://raw.githubusercontent.com/semprag/tex/master/sp.bst}{\texttt{sp.bst}}, developed for the house-style of the journal \href{http://semprag.org}{\emph{Semantics and Pragmatics}} (\emph{S\&P}). Bridget Samuels produced a revised version @@ -180,7 +180,7 @@ simply add the \texttt{biblatex} class option when importing \begin{Shaded} \begin{Highlighting}[] - \BuiltInTok{\textbackslash{}documentclass}\NormalTok{[biblatex]\{}\ExtensionTok{sp}\NormalTok{\}} +\BuiltInTok{\textbackslash{}documentclass}\NormalTok{[biblatex]\{}\ExtensionTok{sp}\NormalTok{\}} \end{Highlighting} \end{Shaded} @@ -192,10 +192,10 @@ but before \begin{Shaded} \begin{Highlighting}[] - \BuiltInTok{\textbackslash{}usepackage}\NormalTok{[backend=biber,} -\NormalTok{ style=unified,} -\NormalTok{ maxcitenames=3,} -\NormalTok{ maxbibnames=99]\{}\ExtensionTok{biblatex}\NormalTok{\}} +\BuiltInTok{\textbackslash{}usepackage}\NormalTok{[backend=biber,} +\NormalTok{ style=unified,} +\NormalTok{ maxcitenames=3,} +\NormalTok{ maxbibnames=99]\{}\ExtensionTok{biblatex}\NormalTok{\}} \end{Highlighting} \end{Shaded} @@ -361,17 +361,21 @@ other bibliography styles): Option 1 -\begin{verbatim} -title = {Government and Binding Theory and the Minimalist Program}, -subtitle = {Principles and Parameters in Syntactic Theory}, -\end{verbatim} +\begin{Shaded} +\begin{Highlighting}[] +\CommentTok{title = \{Government and Binding Theory and the Minimalist Program\},} +\CommentTok{subtitle = \{Principles and Parameters in Syntactic Theory\},} +\end{Highlighting} +\end{Shaded} Option 2 -\begin{verbatim} -title = {Government and Binding Theory and the Minimalist Program: - {Principles} and Parameters in Syntactic Theory}, -\end{verbatim} +\begin{Shaded} +\begin{Highlighting}[] +\CommentTok{title = \{Government and Binding Theory and the Minimalist Program: } +\CommentTok{ \{Principles\} and Parameters in Syntactic Theory\},} +\end{Highlighting} +\end{Shaded} \begin{quote} 4. \textbf{All author/editor first names should be spelled out.} Not @@ -483,17 +487,19 @@ hack than the other: \emph{Option 1}: Use the \texttt{@inproceedings} entry type and include the ISSN of the proceedings when available. Example: -\begin{verbatim} -@inproceedings{casali:1998a, - Author = {Casali, Roderic F.}, - Booktitle = {Chicago Linguistic Society (CLS)}, - ISSN = {0577-7240}, - Number = {1}, - Pages = {55-68}, - Title = {Predicting {ATR} Activity}, - Volume = {34}, - Year = {1998}} -\end{verbatim} +\begin{Shaded} +\begin{Highlighting}[] +\VariableTok{@inproceedings}\NormalTok{\{}\OtherTok{casali:1998a}\NormalTok{,} + \DataTypeTok{Author}\NormalTok{ = \{Casali, Roderic F.\},} + \DataTypeTok{Booktitle}\NormalTok{ = \{Chicago Linguistic Society (CLS)\},} + \DataTypeTok{ISSN}\NormalTok{ = \{0577{-}7240\},} + \DataTypeTok{Number}\NormalTok{ = \{1\},} + \DataTypeTok{Pages}\NormalTok{ = \{55{-}68\},} + \DataTypeTok{Title}\NormalTok{ = \{Predicting \{ATR\} Activity\},} + \DataTypeTok{Volume}\NormalTok{ = \{34\},} + \DataTypeTok{Year}\NormalTok{ = \{1998\}\}} +\end{Highlighting} +\end{Shaded} Comment: Following the Unified Style Sheet, we can let the presence of an ISSN control whether an article in conference proceedings is set like @@ -525,16 +531,18 @@ to use the \texttt{@article} entry type, putting the conference name since journal titles are set as is) in the \texttt{journal} field, and do not list the editors. Example: -\begin{verbatim} -@article{casali:1998b, - Author = {Casali, Roderic F.}, - Journal = {Chicago Linguistic Society (CLS)}, - Number = {1}, - Pages = {55-68}, - Title = {Predicting {ATR} Activity}, - Volume = {34}, - Year = {1998}} -\end{verbatim} +\begin{Shaded} +\begin{Highlighting}[] +\VariableTok{@article}\NormalTok{\{}\OtherTok{casali:1998b}\NormalTok{,} + \DataTypeTok{Author}\NormalTok{ = \{Casali, Roderic F.\},} + \DataTypeTok{Journal}\NormalTok{ = \{Chicago Linguistic Society (CLS)\},} + \DataTypeTok{Number}\NormalTok{ = \{1\},} + \DataTypeTok{Pages}\NormalTok{ = \{55{-}68\},} + \DataTypeTok{Title}\NormalTok{ = \{Predicting \{ATR\} Activity\},} + \DataTypeTok{Volume}\NormalTok{ = \{34\},} + \DataTypeTok{Year}\NormalTok{ = \{1998\}\}} +\end{Highlighting} +\end{Shaded} \begin{quote} 11. \textbf{Use ``edn.'' as an abbreviation for ``edition'', thus ``2nd @@ -699,53 +707,75 @@ pertain to any explicit guidelines. \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 +DOIs (digital object identifiers) are the best way to identify material +available online. 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: +can help. + +Another kind of link is to established eprint sources. \texttt{biblatex} +has built-in support for the following eprint-types: arxiv, jstor, +pubmed, hdl, googlebooks. \texttt{biblatex-unified} adds support for two +new eprint-types: \texttt{lingbuzz} (LingBuzz) and \texttt{roa} (Rutgers +Optimality Archive). Example: \begin{Shaded} \begin{Highlighting}[] - \BuiltInTok{\textbackslash{}usepackage}\NormalTok{[backend=biber,} -\NormalTok{ style=unified,} -\NormalTok{ maxcitenames=3,} -\NormalTok{ maxbibnames=99,} -\NormalTok{ compactdois]\{}\ExtensionTok{biblatex}\NormalTok{\}} +\VariableTok{@unpublished}\NormalTok{\{}\OtherTok{conrod}\NormalTok{{-}}\OtherTok{2021}\NormalTok{{-}}\OtherTok{VariationEnglishGenderedPronouns}\NormalTok{,} + \DataTypeTok{author}\NormalTok{ = \{Conrod, Kirby\},} + \DataTypeTok{date}\NormalTok{ = \{2021{-}08\},} + \DataTypeTok{eprint}\NormalTok{ = \{006452\},} + \DataTypeTok{eprinttype}\NormalTok{ = \{lingbuzz\},} + \DataTypeTok{subtitle}\NormalTok{ = \{Analysis and Recommendations for Ethics in Linguistics\},} + \DataTypeTok{title}\NormalTok{ = \{Variation in \{\{English\}\} Gendered Pronouns\},} +\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 +\href{https://www.crossref.org/display-guidelines/}{Crossref guidelines} +specify that DOIs should be displayed as full links (such as +\texttt{https://doi.org/10.3765/sp.10.1}). \texttt{biblatex-unified} +complies with this and extends the practice to the display of eprint +information. Furthermore, \texttt{biblatex-unified} displays only one +online link: DOI if available, eprint if there's no DOI, anything in the +\texttt{url} field otherwise. + +The user can override \texttt{biblatex-unified} defaults as follows: the +package option \texttt{compactlinks} displays DOIs and eprint info in a +compact way (\texttt{DOI:\ 10.3765/sp.10.1} or \texttt{JSTOR:\ 4178098}) +and the package option \texttt{alllinks} displays all available links +instead of just one. Example: -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}[] +\BuiltInTok{\textbackslash{}usepackage}\NormalTok{[backend=biber,} +\NormalTok{ style=unified,} +\NormalTok{ maxcitenames=3,} +\NormalTok{ maxbibnames=99,} +\NormalTok{ compactlinks, alllinks]\{}\ExtensionTok{biblatex}\NormalTok{\}} +\end{Highlighting} +\end{Shaded} + +If you're using the \texttt{sp.cls} document class with the +\texttt{biblatex} option and you want compact links and all links, you +should instead add this to the preamble: \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]\}\}\}} +\FunctionTok{\textbackslash{}ExecuteBibliographyOptions}\NormalTok{\{compactlinks, alllinks\}} \end{Highlighting} \end{Shaded} +If you're using the \texttt{compactlinks} option, you will notice that +\texttt{biblatex-unified} parses the \texttt{url} field and will format +any recognized eprint-links in the corresponding compact way. In other +words, if the url in a bibentry is +\texttt{http://www.jstor.org/stable/4178098}, the generated bibliography +will contain \texttt{JSTOR:\ 4178098}. + \hypertarget{guidelines-for-the-preparation-of-bib-files}{% \section{Guidelines for the preparation of bib files}\label{guidelines-for-the-preparation-of-bib-files}} @@ -839,9 +869,28 @@ notes}\label{changelog-and-release-notes}} \item Changed \texttt{\&} to be glued to previous author \item - Added \texttt{compactdois} option + Added \texttt{compactdois} option {[}now deprecated, superseded by + \texttt{compactlinks}{]} \item Added documentation on DOIs \end{itemize} +\hypertarget{v1.20-2022-11-08}{% +\subsection*{v1.20 (2022-11-08)}\label{v1.20-2022-11-08}} +\addcontentsline{toc}{subsection}{v1.20 (2022-11-08)} + +\begin{itemize} +\tightlist +\item + Better handling of links +\item + Added \texttt{compactlinks} and \texttt{alllinks} options +\item + Revised documentation on DOIs and other links +\item + Fixed punctuation before subtitle +\item + Improved handling of non-numerical dates (``forthcoming'' etc.) +\end{itemize} + \end{document} -- cgit v1.2.3