From daaeaf2b27cf6fd1376b8a0ab96409972fb5d58c Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 22 Oct 2012 23:27:48 +0000 Subject: new biblatex-publist (22oct12) git-svn-id: svn://tug.org/texlive/trunk@28050 c570f23f-e606-0410-a88d-b1316a301751 --- .../texmf-dist/doc/latex/biblatex-publist/README | 42 ++++ .../latex/biblatex-publist/biblatex-publist.pdf | Bin 0 -> 164707 bytes .../latex/biblatex-publist/biblatex-publist.tex | 248 +++++++++++++++++++++ 3 files changed, 290 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/biblatex-publist/README create mode 100644 Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf create mode 100644 Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex (limited to 'Master/texmf-dist/doc/latex/biblatex-publist') diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/README b/Master/texmf-dist/doc/latex/biblatex-publist/README new file mode 100644 index 00000000000..a601f8639fa --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-publist/README @@ -0,0 +1,42 @@ +---------------------------------------------------------------- +The biblatex-publist package + +A biblatex bibliography style file to produce academic +publication lists. + +Maintained by Jürgen Spitzmüller +E-mail: juergen (at) spitzmueller (dot) org + +Released under the LaTeX Project Public License v1.3 or later +See http://www.latex-project.org/lppl.txt +---------------------------------------------------------------- + +** PURPOSE ** + +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. + +The package requires at least version 1.7 of the biblatex +package. + + +** CONTENTS ** + +The package consists of the file biblatex-publist.bbx. + + +** DOCUMENTATION ** + +See the included manual biblatex-publist.pdf for usage +instructions. + + +** CHANGES ** + +* V. 0.2 (2012-10-21): Initial release on CTAN. + + diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdf new file mode 100644 index 00000000000..985f247b9f0 Binary files /dev/null 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 new file mode 100644 index 00000000000..7c707dc6400 --- /dev/null +++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex @@ -0,0 +1,248 @@ +\documentclass{article} +\usepackage{charter} +\usepackage[T1]{fontenc} +\usepackage[latin9]{inputenc} +\usepackage{listings} +\usepackage{url} + +\newcommand*\bpl{\texttt{biblatex-publist}} +\newcommand*\bibltx{\texttt{biblatex}} + +\begin{document} + +\title{biblatex-publist} +\author{Jürgen Spitzmüller}\thanks{juergen (at) spitzmueller (dot) org.} +\date{Version 0.2, 21/10/2012} +\maketitle + +\begin{abstract} +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 1.7 of the \bibltx\ package.% +\footnote{For \bibltx , see \url{http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex}.} +\end{abstract} + +\section{Aim of the package} + +The \bpl\ package ships a \emph{biblatex bibliography style file} +({*}.bbx) for a specific task: academic publication lists. Such lists, +usually part of the academic CV, contain all or selected publications +of a specific author, usually sorted by genre and year. Even though +publication lists are actually nothing else than (specific) bibliographies, +they diverge from those in some respects. Most notably, it is widespread +practice to omit your own name in your publication list and only list +your co-authors, if there are any. If you want to follow this practice, +a normal bibliography style does not produce the desired result. + +Given the fact that maintaining a publication list is a routine task +in an academian's life, it is surprising how few specified solutions +exist to generate such lists (particularly from Bib\TeX{} data). For +traditional Bib\TeX{}, Nicolas Markey has written a specific Bib\TeX{} +style file, \emph{publist.bst}% +\footnote{\url{http://www.lsv.ens-cachan.fr/~markey/BibTeX/publist/?lang=en}; +see also \cite{ttb}.}, which helps a lot if you want to produce a publication list with +Bib\TeX{}. For \bibltx , however, no equivalent solution exists yet. +The \bpl\ package is the result of the aim of emulating the features +of \emph{publist.bst} with \bibltx's means. It draws on Nicolas Markey's +conceptual ideas, and it is in an early stage of development, being +tested only for the specific needs of the author. Of course, bug reports, +comments and ideas are welcome. + + +\section{Loading the package} + +\subsection{Standard usage} + +The standard way of using the package is to load the style file via + +\begin{quote} +\begin{lstlisting}[language={[LaTeX]TeX}] +\usepackage[bibstyle=publist, + omitname=MySurname]{biblatex} +\end{lstlisting} +\end{quote} + +The \emph{omitname} option should always be passed. It tells the style +file which surname it should suppress (usually yours). This means: +For all of your publications where you are the sole author (or editor), +the author name will be omitted completely, as in: +\begin{quote} +\textbf{2012.} Some recent trends in gardening. In: \emph{Gardening +Practice} 56, pp. 34--86. +\end{quote} +If there are co-authors, your name will be filtered out and the co-authors +added in parentheses, as in: +\begin{quote} +\textbf{1987} (with John Doe and Mary Hall). Are there new trends +in gardening? In: \emph{Gardening Practice} 24, pp. 10--15. +\end{quote} + +\subsection{Further options} + +Currently, there are the following further options (next to the options +provided by the \bibltx\ package itself% +\footnote{Please refer to the \bibltx\ manual for those.% +}): +\begin{description} +\item [{myfirstname}] = + + +If you need to disambiguate your name further, you can additionally +specify your first name. + +\item [{boldyear}] {[}=true|false{]} default: \emph{true}. + + +By default, the year is printed in bold. To prevent this, pass the +option \emph{boldyear=false} to \bibltx . + +\item [{marginyear}] {[}=true|false{]} default: \emph{false}. + + +With this option set to true, the publication year will be printed +in the margin once a new year starts. The option also has the effect +that all marginpars are printed ``reversed'', i.\,e. on the left +side in one-sided documents (via \texttt{\textbackslash{}reversemarginpar}). + +\end{description} +The appearance of the \emph{marginyear} is controlled by the \texttt{\textbackslash{}plmarginyear} +macro, which has the following default definition: +\begin{quote} +\begin{lstlisting}[language={[LaTeX]TeX}] +\providecommand*\plmarginyear[1]{% + \raggedleft\small\textbf{#1}% +} +\end{lstlisting} + +\end{quote} +If you want to change the appearance, just redefine this macro via +\texttt{\textbackslash{}renewcommand{*}}. + + +\section{Localization} + +Since the package draws on \bibltx , it supports localization. However, +currently only two languages are supported: English and German.% +\footnote{ Please send suggestions for other languages to the package author.% +} The following additional localization keys (\texttt{\textbackslash{}bibstrings}) +are added by the package: +\begin{itemize} +\item \emph{with}: the preposition ``with'' that precedes the list of +co-authors. +\item \emph{parttranslationof}: the expression ``partial translation of'' +for entries referring to partially translated work via \bibltx 's +``related entries'' feature (see sec.~\ref{sec:partial-translations}). +\end{itemize} + +\section{Further Extensions} + +The following extensions of standard \bibltx\ features are provided. + + +\subsection{Review bibliography type} + +Although a \emph{review} entry type is provided by \bibltx , this +type is treated as an alias for \emph{article}. The \bpl\ package +uses this entry type for a specific purpose: Foreign reviews of your +own work. It therefore defines a new bibliography environment \emph{review} +with a specific look (particularly as far as the author names are +concerned) and its own numbering; furthermore, it redefines the \emph{review} +bibliography driver. The purpose of this is that you can add other +people's reviews of your work to your publication list, while these +titles are clearly marked and do not interfere with the overall numbering +(see sec.~\ref{sec:example} for an example). + + +\subsection{Partial translations\label{sec:partial-translations}} + +A new ``related entry'' type \emph{parttranslationof} is provided. +This is an addition to the \emph{translationof} related entry type +\bibltx\ itself provides. Please refer to the \bibltx\ manual \cite{bibltx} +on what ``related entries'' are and how to use them. + + +\section{An example\label{sec:example}} + +Publication lists are usually categorized by genre (monographs, articles, +book chapters, etc.). For this task, we use \texttt{\textbackslash{}refsections}. +Other possibilities were not tested and might fail. + +The suggested procedure is to maintain separate bib files for each +category, say \emph{mymonographs.bib}, \emph{myarticles.bib}, \emph{myproceedings.bib}. +Then a typical file would look like this: +\begin{quote} +\begin{lstlisting}[float,frame=single,language={[LaTeX]TeX}] +\documentclass{article} +\usepackage[T1]{fontenc} +\usepackage[latin9]{inputenc} + +\usepackage{csquotes}% not required, but recommended +\usepackage[bibstyle=publist,omitname=Doe] + {biblatex} + +\addbibresource{% + mymonographs.bib, + myarticles.bib, + myproceedings.bib +} + +\begin{document} + +\title{John Doe's publications} +\date{\today} +\maketitle + +\section{Monographs} +\begin{refsection}[mymonographs] +\nocite{*} +\printbibliography[heading=none] +\end{refsection} + +\section{Proceedings} +\begin{refsection}[myproceedings] +\nocite{*} +\printbibliography[heading=none] +\end{refsection} + +\section{Articles} +\begin{refsection}[myarticles] +\nocite{*} +\printbibliography[heading=none] +\end{refsection} + +\end{document} +\end{lstlisting} + +\end{quote} +If you want to add other people's reviews of your work, add a sections +such as: +\begin{quote} +\begin{lstlisting}[frame=single,language={[LaTeX]TeX}] +\subsubsection*{Reviews of my thesis} +\begin{refsection}[mythesis_reviews] +\renewcommand\bibfont{\small} +\nocite{*} +\printbibliography[heading=none,env=reviews] +\end{refsection} +\end{lstlisting} + +\end{quote} +Note that the \emph{printbibliography} option \emph{env=reviews} is +crucial. + + +\section{Change Log} +\begin{description} +\item [{V.~0.2~(2012-10-21)}] Initial release on CTAN.\end{description} +\begin{thebibliography}{1} +\bibitem{bibltx}Lehman, Philipp (with Audrey Boruvka, Philip Kime +and Joseph Wright): \emph{The biblatex Package. Programmable Bibliographies +and Citations}. August 2012. \url{http://www.ctan.org/tex-archive/macros/latex/contrib/biblatex}. + +\bibitem{ttb}Markey, Nicolas: \emph{Tame the BeaST. The B to X of +BibTEX}. October 11, 2009. \url{http://www.ctan.org/tex-archive/info/bibtex/tamethebeast}.\end{thebibliography} + +\end{document} -- cgit v1.2.3