From 4cf7d112766b5888982c9970e69c3763e69456a2 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Sat, 6 Aug 2016 22:38:19 +0000 Subject: biblatex-publist (6aug16) git-svn-id: svn://tug.org/texlive/trunk@41812 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/biblatex-publist/README | 14 ++- .../latex/biblatex-publist/biblatex-publist.pdf | Bin 293675 -> 297438 bytes .../latex/biblatex-publist/biblatex-publist.tex | 47 +++++++-- .../tex/latex/biblatex-publist/publist.bbx | 114 +++++++++++++++------ .../tex/latex/biblatex-publist/publist.cbx | 4 +- 5 files changed, 138 insertions(+), 41 deletions(-) diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/README b/Master/texmf-dist/doc/latex/biblatex-publist/README index afe68c76b2a..1340222fe1c 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/README +++ b/Master/texmf-dist/doc/latex/biblatex-publist/README @@ -18,9 +18,9 @@ See http://www.latex-project.org/lppl.txt The biblatex-publist package provides a biblatex bibliography style file (*.bbx) for publication lists, i.e. a bibliography containing one's own publications. The style file draws on -biblatex's authoryear style, but provides some extra features -needed for publication lists, such as the omission of the own -name from author or editor data. +biblatex's authoryear style per default (which can be changed), +but provides some extra features needed for publication lists, +such as the omission of the own name from author or editor data. The package requires at least version 3.4 of the biblatex package. @@ -45,6 +45,14 @@ instructions. == CHANGES == +* V. 1.3 (2016-08-06): + - It is now possible to change the base style that is used. + - Proper sorting of pubstates. + - Add possibility to increase the indentation of items (by means + of the length extralabelnumberwidth). + - Use pagetracker=true instead of pagetracker=spread by default + (avoids warning, no change in functionality). + * V. 1.2 (2016-05-12): - Accomodate to the backwards-incompatible changes of biblatex 3.4 (prefixnumber > labelprefix, \ifempty > \ifdefvoid). 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 05de362db46..f02e87c21f8 100644 Binary files a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf and b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf 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 b55b9adc92b..823fa7ea9b0 100644 --- a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex +++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex @@ -79,16 +79,15 @@ \thanks{Please report issues via \protect\url{https://github.com/jspitz/biblatex-publist}.}% } -\date{Version 1.2, 2016/05/12} +\date{Version 1.3, 2016/08/06} \maketitle \begin{abstract} \noindent The \bpl\ package provides a \emph{biblatex bibliography style file} ({*}.bbx) for publication lists, i.\,e.\ a bibliography containing one's own -publications. The style file draws on \bibltx's \emph{authoryear} style, but -provides some extra features needed for publication lists, such as the omission -of the own name from author or editor data. The package requires at least version -3.4 of the \bibltx\ package\footnote{For \bibltx, see +publications. The style file draws on \bibltx's \emph{authoryear} style per default +(which can be changed), but provides some extra features needed for publication lists, +such as the omission of the own name from author or editor data. The package requires at least version 3.4 of the \bibltx\ package\footnote{For \bibltx, see \url{http://www.ctan.org/pkg/biblatex}.} and \texttt{biber} (the respective version as required by \bibltx). \end{abstract} @@ -176,7 +175,9 @@ on the left side in one-sided documents (via \jfcsmacro{reversemarginpar}). \end{description} -\noindent The appearance of the \emph{marginyear} is controlled by the +\subsection{Auxiliary macros and lengths}\label{sec:auxmacros} + +The appearance of the \emph{marginyear} is controlled by the \jcsmacro*{plmarginyear} macro, which has the following default definition: \begin{quote} \begin{lstlisting}[language={[LaTeX]TeX}, @@ -188,6 +189,27 @@ on the left side in one-sided documents (via \jfcsmacro{reversemarginpar}). If you want to change the appearance, just redefine this macro via \jfcsmacro{renewcommand{*}}. +The indendation of the bibliographic entries (lines > 1) can be adjusted by setting the length +\jmacro*{extralabel\-numberwidth} via \jfcsmacro{setlength} (default is \texttt{0pt}). +This might be needed for long bibliographies (> 99 entries) in order to adjust to the extra +space the item number needs. + + +\subsection{Using a different base style}\label{sec:basestyle} + +By default, \bpl\ loads \bibltx's \emph{authoryear} style, and it has been written +to work with that style. However, it is possible to try a diffent base style, if +\emph{author\-year} does not fit your needs. + +In order to do so, enter the following \emph{before} loading \bibltx: +\begin{quote} + \begin{lstlisting}[language={[LaTeX]TeX}, + moretexcs={[2]{publistbasestyle}}] + \newcommand*\publistbasestyle{} + \end{lstlisting}\end{quote} +where is the name of the biblatex bibliography style (\emph{bbx}) you want to use, without the \emph{bbx} entension (e.\,g., \lstinline|\newcommand*\publistbasestyle{mla}|). + +Note, though, that there is (and can be) no guarantee that \bpl\ will work with all styles, although it has been successfully tested with several. Be prepared to bump into \LaTeX\ errors and carefully check the output for correctness if you try a different base style. \section{Localization} @@ -370,14 +392,25 @@ That is, to sort your talks in descending order by full date in your CV, use: \end{lstlisting} \end{quote} +\clearpage \section{Revision Log} \begin{description} +\item [{V.~1.3 (2016-08-05):}]~ + +\begin{itemize} + \item It is now possible to change the base style that is used by \bpl. See sec.~\ref{sec:basestyle}. + \item Proper sorting of pubstates. + \item Add possibility to increase the indentation of items (by means of the length \jmacro{extralabelnumberwidth}). See sec.~\ref{sec:auxmacros}. + \item Use \jfoption{pagetracker=true} instead of \jfoption{pagetracker=spread} + by default (avoids warning, no change in functionality). +\end{itemize} + \item [{V.~1.2 (2016-05-12):}]~ \begin{itemize} - \item Accomodate to the backwards-incompatible changes of \bibltx~3.4 + \item Accomodate to the backwards-incompatible changes of \bibltx~3.4\\ (\jfoption{prefixnumber} $\Rightarrow$ \jfoption{labelprefix}, \jfcsmacro{ifempty} $\Rightarrow$ \jfcsmacro{ifdefvoid}). This version of \bibltx\ is now required. diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx index 7735af60fc7..2f48be67bfe 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.2} -\def\bpl@rdate{2016/05/12} +\def\bpl@version{1.3} +\def\bpl@rdate{2016/08/06} \ProvidesFile{publist.bbx}[\bpl@rdate\space v.\bpl@version\space biblatex bibliography style (JSP)] @@ -40,16 +40,54 @@ This is a fatal error. I'm aborting now}% \endinput} -\RequireBibliographyStyle{authoryear} + +% +% Bibliography Options and Base Style +% + +\DeclareBibliographyOption{omitname}{\def\bpl@osurname{#1}} + +\DeclareBibliographyOption{omitfirstname}{\def\bpl@ofirstname{#1}} + +\DeclareBibliographyOption{omitnameprefix}{\def\bpl@ovonpart{#1}} + +\newif\if@marginyear\@marginyearfalse +\DeclareBibliographyOption{marginyear}[true]{% + \ifstrequal{#1}{true}{\@marginyeartrue\reversemarginpar}{\@marginyearfalse} +} + +\newif\if@unboldyear\@unboldyearfalse +\DeclareBibliographyOption{boldyear}[true]{% + \ifstrequal{#1}{false}{\@unboldyeartrue}{\@unboldyearfalse} +} + +% Check if users have defined different base styles +% If not, use authoryear. +\newif\ifbpl@standardbasestyle\bpl@standardbasestylefalse +\@ifundefined{publistbasestyle}{% + \newcommand*\publistbasestyle{authoryear} + \bpl@standardbasestyletrue}{} + +\RequireBibliographyStyle{\publistbasestyle} \ExecuteBibliographyOptions{% - pagetracker=spread, + pagetracker=true, labelnumber, useprefix=false, - dashed=false, sorting=ydnt, - defernumbers=true, - maxnames=4} + defernumbers=true} + +% Execute these options only with the standard base style +\ifbpl@standardbasestyle + \ExecuteBibliographyOptions{% + maxnames=4, + dashed=false} +\else + % This corresponds to bib option dashed=false + % (dashed option is not defined in every style) + \providebibmacro*{bbx:savehash}{}% + \renewbibmacro*{bbx:savehash}{}% +\fi % @@ -87,27 +125,6 @@ } -% -% Options -% - -\DeclareBibliographyOption{omitname}{\def\bpl@osurname{#1}} - -\DeclareBibliographyOption{omitfirstname}{\def\bpl@ofirstname{#1}} - -\DeclareBibliographyOption{omitnameprefix}{\def\bpl@ovonpart{#1}} - -\newif\if@marginyear\@marginyearfalse -\DeclareBibliographyOption{marginyear}[true]{% - \ifstrequal{#1}{true}{\@marginyeartrue\reversemarginpar}{\@marginyearfalse} -} - -\newif\if@unboldyear\@unboldyearfalse -\DeclareBibliographyOption{boldyear}[true]{% - \ifstrequal{#1}{false}{\@unboldyeartrue}{\@unboldyearfalse} -} - - % % Field format definitions % @@ -127,8 +144,13 @@ \preto\blx@refsection{\global\setbool{newsection}{true}} +% Possibility to manually make the space occupied by the label wider +\newlength\extralabelnumberwidth +\setlength\extralabelnumberwidth{0pt} + \defbibenvironment{bibliography} - {\list + {\addtolength{\labelnumberwidth}{\extralabelnumberwidth}% + \list {\printtext[labelnumberwidth]{% \printfield{labelprefix}% \printfield{labelnumber}}} @@ -160,6 +182,7 @@ \newrobustcmd{\mkbibdesc}[1]{% \number\numexpr\csuse{bbx@itemtotal}+#1\relax} +% Way to manual shift the numbering (undocumented) \newcommand*\decreasebbxnumbering[1]{\csnumgdef{bbx@itemtotal}{\csuse{bbx@itemtotal}-#1}} @@ -438,6 +461,7 @@ }% \fi \savefield{labelyear}{\bbx@lasthash}% + \clearfield{year}% }} \newbibmacro*{rauthor/label}{% @@ -626,4 +650,36 @@ } } +% +% Mappings (biber) +% + +% Correctly sort pubstates. + +\DeclareStyleSourcemap{ + \maps[datatype=bibtex]{ + \map{ + \step[fieldsource=year, final] + \step[fieldset=sortyear, origfieldval] + } + \map{ + \step[fieldsource=pubstate, match=\regexp{forthcoming}, final] + \step[fieldset=sortyear, fieldvalue={2222}] + } + \map{ + \step[fieldsource=pubstate, match=\regexp{inpress}, final] + \step[fieldset=sortyear, fieldvalue={3333}] + } + \map{ + \step[fieldsource=pubstate, match=\regexp{submitted}, final] + \step[fieldset=sortyear, fieldvalue={4444}] + } + \map{ + \step[fieldsource=pubstate, match=\regexp{inpreparation}, final] + \step[fieldset=sortyear, fieldvalue={5555}] + } + } +} + + \endinput diff --git a/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx b/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx index b5d8d939ad4..f5ba512492d 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.2} -\def\bpl@rdate{2016/05/12} +\def\bpl@version{1.3} +\def\bpl@rdate{2016/08/06} \ProvidesFile{publist.cbx}[\bpl@rdate\space v.\bpl@version\space biblatex citation style (JSP)] -- cgit v1.2.3