diff options
| -rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-publist/README | 5 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf | bin | 308256 -> 311050 bytes | |||
| -rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex | 92 | ||||
| -rw-r--r-- | Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx | 130 | ||||
| -rw-r--r-- | Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx | 4 |
5 files changed, 203 insertions, 28 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/README b/Master/texmf-dist/doc/latex/biblatex-publist/README index 5354840e430..cd816f0c81c 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/README +++ b/Master/texmf-dist/doc/latex/biblatex-publist/README @@ -45,6 +45,11 @@ instructions. == 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. diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf Binary files differindex 56ee7a2de59..e1cc9d86323 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf +++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex index b16b03c588e..02f0ce8d278 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex +++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex @@ -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 @@ Note that several reruns of \texttt{latex} might be required to fix the numberin \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 @@ That is, to sort your talks in descending order by full date in your CV, use: \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 @@ Gregorio.% 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Ļi\'{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Ļi\'{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 diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx index d86d8f5c3a5..4b61d0bfaa1 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx @@ -25,8 +25,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{1.12} -\def\bpl@rdate{2018/11/25} +\def\bpl@version{1.13} +\def\bpl@rdate{2018/11/30} \ProvidesFile{publist.bbx}[\bpl@rdate\space v.\bpl@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@hlauthor% + \ExecuteBibliographyOptions{sorting=ydnt} +\else + \ExecuteBibliographyOptions{sorting=ydt} +\fi + % Execute these options only with the standard base style \ifbpl@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) % -% Correctly sort pubstates. +% Add a dummy constant shortauthor in order to +% ignore author constellation on extralabel assignment. +\if@hlauthor +\else +\DeclareSourcemap{ + \maps[datatype=bibtex]{ + \map[overwrite]{ + \step[fieldset=shortauthor, fieldvalue={1111}] + } + } +} +\fi +% Correctly sort pubstates. \DeclareStyleSourcemap{ \maps[datatype=bibtex]{ \map{ diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx index 4ee28fe014a..a2a20dcfa26 100644 --- a/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx +++ b/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx @@ -26,8 +26,8 @@ % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% -\def\bpl@version{1.12} -\def\bpl@rdate{2018/11/25} +\def\bpl@version{1.13} +\def\bpl@rdate{2018/11/30} \ProvidesFile{publist.cbx}[\bpl@rdate\space v.\bpl@version\space biblatex citation style (JSP)] |