texlive[49283] Master/texmf-dist: biblatex-publist (30nov18)

commits+karl at tug.org commits+karl at tug.org
Fri Nov 30 22:48:16 CET 2018


Revision: 49283
          http://tug.org/svn/texlive?view=revision&revision=49283
Author:   karl
Date:     2018-11-30 22:48:16 +0100 (Fri, 30 Nov 2018)
Log Message:
-----------
biblatex-publist (30nov18)

Modified Paths:
--------------
    trunk/Master/texmf-dist/doc/latex/biblatex-publist/README
    trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf
    trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex
    trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx
    trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx

Modified: trunk/Master/texmf-dist/doc/latex/biblatex-publist/README
===================================================================
--- trunk/Master/texmf-dist/doc/latex/biblatex-publist/README	2018-11-30 21:48:04 UTC (rev 49282)
+++ trunk/Master/texmf-dist/doc/latex/biblatex-publist/README	2018-11-30 21:48:16 UTC (rev 49283)
@@ -45,6 +45,11 @@
 
 == CHANGES ==
 
+* V. 1.13 (2018-11-30):
+        - Introduce new sorting templates that ignore names.
+        - CHANGE OF OUTPUT! Use ydt tempate by default.
+        - Assign extralabel independent of author group with plauthorhandling=omit.
+
 * V. 1.12 (2018-11-25):
         - Switch name parsing toggles globally (fixes regression with biblatex 3.12).
         - Account for omitted author when adding \finalnamedelim.

Modified: trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf
===================================================================
(Binary files differ)

Modified: trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex
===================================================================
--- trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex	2018-11-30 21:48:04 UTC (rev 49282)
+++ trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex	2018-11-30 21:48:16 UTC (rev 49283)
@@ -89,7 +89,7 @@
 \thanks{Please report issues via \protect\url{https://github.com/jspitz/biblatex-publist}.}%
 }
 
-\date{Version 1.12, 2018/11/25}
+\date{Version 1.13, 2018/11/30}
 \maketitle
 
 \begin{abstract}
@@ -417,34 +417,80 @@
 
 \section{Sorting\label{sec:sorting}}
 
-The sorting of the items is done via \bibltx's sorting mechanism
-(please refer to the \bibltx\ manual for details). By default,
-\bpl\ uses the \jfmacro{ydnt} template, which sorts hierarchically
-by year (descending), name and title (both ascending). You can switch to another
-template via \bibltx's \jfmacro{sorting} option either globally (if you pass
-\joption{sorting=<template>} to the \bibltx\ options) or locally (if you pass
-\joption{sorting=<template>} to the \jfcsmacro{printbibliography} options).
 
-For convenience, \bpl\ provides 3 additional sorting templates, which might
-be particularly useful for sorting talks:
+\subsection{Sorting Publication Lists}
+
+The sorting conventions of publication lists differ from those of normal bibliographies.
+Publication lists are usually not sorted by author name, the prime criterion of normal
+bibliographies, but rather chronologically (usually \emph{descending} from the newest through
+the oldest publication). How to sub-sort within a year depends on the handling of author names.
+If you display all authors and only highlight your own (via \joption{plauthorhandling=highlight}),
+it probably makes sense to sub-sort first by author name, and then by title. If you omit your own name
+and just mention your co-authors (the default), it makes more sense to sub-sort by title right away,
+without taking the author names into account.
+
+To account for these needs, \bpl\ adds some sorting options on top of those that come with
+\bibltx\ itself.
+
+
+\subsection{Sorting Templates}\label{sec:sorttemplates}
+
+The sorting of items is done via \bibltx's sorting mechanism, via so called \emph{sorting templates}
+(please refer to the \bibltx\ manual for details). 
+
+By default, \bpl\ uses an own template, \joption{ydt}, which sorts hierarchically by \textbf{y}ear
+(\textbf{d}escending) and \textbf{t}itle (alphabetically ascending), ignoring author
+names. This default is used since author name sorting does not make much sense at least in
+the default configuration, where the own name is omitted and the list of co-authors is presented
+in a particular way.
+If you use \joption{plauthorhandling=highlight}, however, the default changes to \joption{ydnt}
+(a template provided by \bibltx\ itself) which sub-sorts by author names (alphabetically ascending)
+before sub-sorting by title.
+
+In addition to this default template, \bpl\ provides some sorting templates that account
+for the full date (rather than just the year).
+This is especially useful for sorting talks, since those usually do not only have a year, but a full
+date (day, month and year).
+The following templates, with and without author sorting, are provided:
 \begin{itemize}
+ \item \jmacro{ddt}: Sort by full \textbf{d}ate (\textbf{d}escending)
+        and \textbf{t}itle (both ascending).
  \item \jmacro{ddnt}: Sort by full \textbf{d}ate (\textbf{d}escending),
-                      \textbf{n}ame and \textbf{t}itle (both ascending).
- \item \jmacro{ydmdnt}: Sort by \textbf{y}ear (\textbf{d}escending),
-                        \textbf{m}onth, \textbf{d}ay, \textbf{n}ame and \textbf{t}itle
-                        (all ascending).
- \item \jmacro{dnt}: Sort by full \textbf{d}ate, \textbf{n}ame and \textbf{t}itle
-                        (all ascending).
+        author \textbf{n}ame and \textbf{t}itle (both ascending).
+ \item \jmacro{dt}: Sort by full \textbf{d}ate and \textbf{t}itle (all ascending).
+ \item \jmacro{dnt}: Sort by full \textbf{d}ate, author \textbf{n}ame and \textbf{t}itle
+        (all ascending).
+ \item \jmacro{ydmdt}: Sort by \textbf{y}ear (\textbf{d}escending),
+	    \textbf{m}onth, \textbf{d}ay and \textbf{t}itle	(all ascending).
+\item \jmacro{ydmdnt}: Sort by \textbf{y}ear (\textbf{d}escending),
+       \textbf{m}onth, \textbf{d}ay, author \textbf{n}ame and \textbf{t}itle
+       (all ascending).
 \end{itemize}
-That is, to sort your talks in descending order by full date in your CV, use:
+In order to use any of these, or another sorting template provided by \bibltx\, 
+use \bibltx's \jfmacro{sorting} option, which can be passed either globally
+(via \joption{sorting=<template>} as a \bibltx\ option) or locally
+(via \joption{sorting=<template>} as a \jfcsmacro{printbibliography} option).
+So, to sort your talks in descending order by full date in your CV, you would
+use either
 \begin{lstlisting}[moretexcs={[1]{printbibliography}}]
-\printbibliography[heading=none,sorting=ddnt]
+\usepackage[style=publist,sorting=ddt]{biblatex}
 \end{lstlisting}
+or
+\begin{lstlisting}[moretexcs={[1]{printbibliography}}]
+\printbibliography[heading=none,sorting=ddt]
+\end{lstlisting}
 
+\clearpage
 
 \section{Revision Log}
 
 \begin{description}
+	\item [{V. 1.13 (2018-11-30):}]~
+	\begin{itemize}
+		\item Introduce new sorting templates that ignore names. See sec.~\ref{sec:sorttemplates}.
+		\item \textbf{Change of output!} Use \joption{ydt} template by default. See sec.~\ref{sec:sorttemplates}.
+		\item Assign extralabel independent of author group with \joption{plauthorhandling=omit}.
+	\end{itemize}
 	
 	\item [{V. 1.12 (2018-11-25):}]~
 	\begin{itemize}
@@ -490,7 +536,7 @@
 	    	\item \texttt{year+labelyear} $\Rightarrow$ \texttt{bpl:year+labelyear}
 				\end{itemize}
 	\end{itemize}
-
+\clearpage
 	\item [{V.~1.7 (2017-04-12):}]~
     \begin{itemize}
 	\item Output marginyear before the author list. This prevents it from being vertically
@@ -611,9 +657,11 @@
 
 Thanks go to Enrico Gregorio (egreg on \emph{tex.stackexchange.com})
 for helping me with correct name parsing (actually, the code the package
-uses is completely his), Marko Budi\xA8i\'{c}, Clea F. Rees and Yannick Kalff
-for testing and bug reports, Nicolas Markey for \emph{publist.bst} and of
-course Philipp Lehman (not only) for \bibltx.
+uses is completely his), user gusbrs on \emph{tex.stackexchange.com},
+Marko Budi\xA8i\'{c}, Clea F. Rees, Yannick Kalff and many other users for
+testing and bug reports, Nicolas Markey for \emph{publist.bst} and of
+course Philipp Lehman and the current \bibltx\ team (Philipp Kime,
+Moritz Wemheuer, Audrey Boruvka and Joseph Wright) for \bibltx.
 
 \begin{thebibliography}{1}
 \bibitem{bibltx}Lehman, Philipp (with Audrey Boruvka, Philip Kime

Modified: trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx
===================================================================
--- trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx	2018-11-30 21:48:04 UTC (rev 49282)
+++ trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx	2018-11-30 21:48:16 UTC (rev 49283)
@@ -25,8 +25,8 @@
 %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-\def\bpl at version{1.12}
-\def\bpl at rdate{2018/11/25}
+\def\bpl at version{1.13}
+\def\bpl at rdate{2018/11/30}
 
 \ProvidesFile{publist.bbx}[\bpl at rdate\space v.\bpl at version\space
                            biblatex bibliography style (JSP)]
@@ -137,9 +137,15 @@
     pagetracker=true,
     labelnumber,
     useprefix=false,
-    sorting=ydnt,
     defernumbers=true}
 
+% Default sorting depends on plauthorhandling
+\if at hlauthor%
+  \ExecuteBibliographyOptions{sorting=ydnt}
+\else
+  \ExecuteBibliographyOptions{sorting=ydt}
+\fi
+
 % Execute these options only with the standard base style
 \ifbpl at standardbasestyle
     \ExecuteBibliographyOptions{%
@@ -927,12 +933,128 @@
   }
 }
 
+% Sorting schemes without name
+
+% Sorting year (descending), title
+\DeclareSortingTemplate{ydt}{
+  \sort{
+    \field{presort}
+  }
+  \sort[final]{
+    \field{sortkey}
+  }
+  \sort[direction=descending]{
+    \field[strside=left,strwidth=4]{sortyear}
+    \field[strside=left,strwidth=4]{year}
+    \literal{9999}
+  }
+  \sort{
+    \field{sorttitle}
+    \field{title}
+  }
+}
+
+% Consider the whole date (year-month-day)
+% Sorting date (descending), title
+\DeclareSortingTemplate{ddt}{
+  \sort{
+    \field{presort}
+  }
+  \sort[final]{
+    \field{sortkey}
+  }
+  \sort[direction=descending]{
+    \field[strside=left,strwidth=4]{sortyear}
+    \field[strside=left,strwidth=4]{year}
+    \literal{9999}
+  }
+  \sort[direction=descending]{
+    \field[padside=left,padwidth=2,padchar=0]{month}
+    \literal{00}
+  }
+  \sort[direction=descending]{
+    \field[padside=left,padwidth=2,padchar=0]{day}
+    \literal{00}
+  }
+  \sort{
+    \field{sorttitle}
+    \field{title}
+  }
+}
+
+% Sorting year (descending), month, day, title
+\DeclareSortingTemplate{ydmdt}{
+  \sort{
+    \field{presort}
+  }
+  \sort[final]{
+    \field{sortkey}
+  }
+  \sort[direction=descending]{
+    \field[strside=left,strwidth=4]{sortyear}
+    \field[strside=left,strwidth=4]{year}
+    \literal{9999}
+  }
+  \sort{
+    \field[padside=left,padwidth=2,padchar=0]{month}
+    \literal{00}
+  }
+  \sort{
+    \field[padside=left,padwidth=2,padchar=0]{day}
+    \literal{00}
+  }
+  \sort{
+    \field{sorttitle}
+    \field{title}
+  }
+}
+
+% Sorting date (ascending), title
+\DeclareSortingTemplate{dt}{
+  \sort{
+    \field{presort}
+  }
+  \sort[final]{
+    \field{sortkey}
+  }
+  \sort{
+    \field[strside=left,strwidth=4]{sortyear}
+    \field[strside=left,strwidth=4]{year}
+    \literal{9999}
+  }
+  \sort{
+    \field[padside=left,padwidth=2,padchar=0]{month}
+    \literal{00}
+  }
+  \sort{
+    \field[padside=left,padwidth=2,padchar=0]{day}
+    \literal{00}
+  }
+  \sort{
+    \field{sorttitle}
+    \field{title}
+  }
+}
+
+
 %
 % Mappings (biber)
 %
 
+% Add a dummy constant shortauthor in order to
+% ignore author constellation on extralabel assignment.
+\if at hlauthor
+\else
+\DeclareSourcemap{
+  \maps[datatype=bibtex]{
+    \map[overwrite]{
+       \step[fieldset=shortauthor, fieldvalue={1111}]
+    }
+  }
+}
+\fi
+
 % Correctly sort pubstates.
-
 \DeclareStyleSourcemap{
   \maps[datatype=bibtex]{
     \map{

Modified: trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx
===================================================================
--- trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx	2018-11-30 21:48:04 UTC (rev 49282)
+++ trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx	2018-11-30 21:48:16 UTC (rev 49283)
@@ -26,8 +26,8 @@
 %
 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
 
-\def\bpl at version{1.12}
-\def\bpl at rdate{2018/11/25}
+\def\bpl at version{1.13}
+\def\bpl at rdate{2018/11/30}
 
 \ProvidesFile{publist.cbx}[\bpl at rdate\space v.\bpl at version\space
                            biblatex citation style (JSP)]



More information about the tex-live-commits mailing list