texlive[41812] Master/texmf-dist: biblatex-publist (6aug16)
commits+karl at tug.org
commits+karl at tug.org
Sun Aug 7 00:38:19 CEST 2016
Revision: 41812
http://tug.org/svn/texlive?view=revision&revision=41812
Author: karl
Date: 2016-08-07 00:38:19 +0200 (Sun, 07 Aug 2016)
Log Message:
-----------
biblatex-publist (6aug16)
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 2016-08-06 22:38:07 UTC (rev 41811)
+++ trunk/Master/texmf-dist/doc/latex/biblatex-publist/README 2016-08-06 22:38:19 UTC (rev 41812)
@@ -18,9 +18,9 @@
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 @@
== 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).
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 2016-08-06 22:38:07 UTC (rev 41811)
+++ trunk/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex 2016-08-06 22:38:19 UTC (rev 41812)
@@ -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 @@
\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,7 +189,28 @@
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{<stylename>}
+ \end{lstlisting}\end{quote}
+where <stylename> 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}
Since the package draws on \bibltx, it supports localization.
@@ -370,14 +392,25 @@
\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.
Modified: trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx
===================================================================
--- trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx 2016-08-06 22:38:07 UTC (rev 41811)
+++ trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.bbx 2016-08-06 22:38:19 UTC (rev 41812)
@@ -25,8 +25,8 @@
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\def\bpl at version{1.2}
-\def\bpl at rdate{2016/05/12}
+\def\bpl at version{1.3}
+\def\bpl at rdate{2016/08/06}
\ProvidesFile{publist.bbx}[\bpl at rdate\space v.\bpl at version\space
biblatex bibliography style (JSP)]
@@ -40,18 +40,56 @@
This is a fatal error. I'm aborting now}%
\endinput}
-\RequireBibliographyStyle{authoryear}
+%
+% Bibliography Options and Base Style
+%
+
+\DeclareBibliographyOption{omitname}{\def\bpl at osurname{#1}}
+
+\DeclareBibliographyOption{omitfirstname}{\def\bpl at ofirstname{#1}}
+
+\DeclareBibliographyOption{omitnameprefix}{\def\bpl at ovonpart{#1}}
+
+\newif\if at marginyear\@marginyearfalse
+\DeclareBibliographyOption{marginyear}[true]{%
+ \ifstrequal{#1}{true}{\@marginyeartrue\reversemarginpar}{\@marginyearfalse}
+}
+
+\newif\if at unboldyear\@unboldyearfalse
+\DeclareBibliographyOption{boldyear}[true]{%
+ \ifstrequal{#1}{false}{\@unboldyeartrue}{\@unboldyearfalse}
+}
+
+% Check if users have defined different base styles
+% If not, use authoryear.
+\newif\ifbpl at standardbasestyle\bpl at standardbasestylefalse
+\@ifundefined{publistbasestyle}{%
+ \newcommand*\publistbasestyle{authoryear}
+ \bpl at 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 at 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
+
%
% Customization settings
%
@@ -88,27 +126,6 @@
%
-% Options
-%
-
-\DeclareBibliographyOption{omitname}{\def\bpl at osurname{#1}}
-
-\DeclareBibliographyOption{omitfirstname}{\def\bpl at ofirstname{#1}}
-
-\DeclareBibliographyOption{omitnameprefix}{\def\bpl at ovonpart{#1}}
-
-\newif\if at marginyear\@marginyearfalse
-\DeclareBibliographyOption{marginyear}[true]{%
- \ifstrequal{#1}{true}{\@marginyeartrue\reversemarginpar}{\@marginyearfalse}
-}
-
-\newif\if at unboldyear\@unboldyearfalse
-\DeclareBibliographyOption{boldyear}[true]{%
- \ifstrequal{#1}{false}{\@unboldyeartrue}{\@unboldyearfalse}
-}
-
-
-%
% Field format definitions
%
\DeclareFieldFormat{bibentrysetcount}{\mkbibparens{\mknumalph{#1}}}
@@ -127,8 +144,13 @@
\preto\blx at 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 at itemtotal}+#1\relax}
+% Way to manual shift the numbering (undocumented)
\newcommand*\decreasebbxnumbering[1]{\csnumgdef{bbx at itemtotal}{\csuse{bbx at itemtotal}-#1}}
@@ -438,6 +461,7 @@
}%
\fi
\savefield{labelyear}{\bbx at 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
Modified: trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx
===================================================================
--- trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx 2016-08-06 22:38:07 UTC (rev 41811)
+++ trunk/Master/texmf-dist/tex/latex/biblatex-publist/publist.cbx 2016-08-06 22:38:19 UTC (rev 41812)
@@ -26,8 +26,8 @@
%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
-\def\bpl at version{1.2}
-\def\bpl at rdate{2016/05/12}
+\def\bpl at version{1.3}
+\def\bpl at rdate{2016/08/06}
\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