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