summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-11-30 21:48:16 +0000
committerKarl Berry <karl@freefriends.org>2018-11-30 21:48:16 +0000
commit10b8702e8b19735324a53494aa3f9312147bf1e7 (patch)
tree1676d43265fa176b87292627ab0feb8e4c77a5eb /Master/texmf-dist/doc
parent6cb6bb4e14d1047d4c14719b41b3bdb09aafdaf1 (diff)
biblatex-publist (30nov18)
git-svn-id: svn://tug.org/texlive/trunk@49283 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-publist/README5
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdfbin308256 -> 311050 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex92
3 files changed, 75 insertions, 22 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
index 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
Binary files differ
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