summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-publist
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-10-23 23:30:42 +0000
committerKarl Berry <karl@freefriends.org>2012-10-23 23:30:42 +0000
commit96c2f6d58f41753e3a725cd10e4ff646155e9017 (patch)
tree5b0ca0aca5ba23b0fce7f053731a898a384b49b6 /Master/texmf-dist/doc/latex/biblatex-publist
parent16bf9ff0d2574baf1055949532b3ac27c9e0c46b (diff)
biblatex-publist (23oct12)
git-svn-id: svn://tug.org/texlive/trunk@28061 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-publist')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-publist/README14
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.pdfbin164707 -> 98763 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex130
3 files changed, 108 insertions, 36 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-publist/README b/Master/texmf-dist/doc/latex/biblatex-publist/README
index a601f8639fa..1661ce0dc77 100644
--- a/Master/texmf-dist/doc/latex/biblatex-publist/README
+++ b/Master/texmf-dist/doc/latex/biblatex-publist/README
@@ -20,7 +20,7 @@ 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
+The package requires at least version 2.0 of the biblatex
package.
@@ -37,6 +37,16 @@ instructions.
** CHANGES **
-* V. 0.2 (2012-10-21): Initial release on CTAN.
+V. 0.3 (2012-10-23):
+ - Bug fix: Add missing "and" if omitted name was last
+ minus one.
+ - Bug fix: Fix output with "et al." if omitted name is
+ first and liststop is 1.
+ - Set maxnames default to 4.
+ - Add filter possibility.
+ - Add French localization.
+ - Some corrections to the manual.
+
+* V. 0.2 (2012-10-21): Initial release to 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
index 985f247b9f0..2cbce9ae64f 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 7c707dc6400..f24b3657d4e 100644
--- a/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex
@@ -1,34 +1,55 @@
+%% LyX 2.0.5dev created this file. For more info, see http://www.lyx.org/.
+%% Do not edit unless you really know what you are doing.
\documentclass{article}
\usepackage{charter}
+\usepackage[scaled=0.87]{beramono}
\usepackage[T1]{fontenc}
\usepackage[latin9]{inputenc}
\usepackage{listings}
+\lstset{basicstyle={\ttfamily}}
\usepackage{url}
-
+\usepackage[unicode=true,
+ bookmarks=true,bookmarksnumbered=false,bookmarksopen=false,
+ breaklinks=false,pdfborder={0 0 0},backref=false,colorlinks=false]
+ {hyperref}
+\hypersetup{pdftitle={The biblatex-publist manual},
+ pdfauthor={Jürgen Spitzmüller},
+ pdfkeywords={biblatex,publication list}}
+
+\makeatletter
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% User specified LaTeX commands.
\newcommand*\bpl{\texttt{biblatex-publist}}
\newcommand*\bibltx{\texttt{biblatex}}
+\makeatother
+
\begin{document}
\title{biblatex-publist}
-\author{Jürgen Spitzmüller}\thanks{juergen (at) spitzmueller (dot) org.}
-\date{Version 0.2, 21/10/2012}
-\maketitle
+
+\author{Jürgen Spitzmüller%
+\thanks{\protect\href{mailto:juergen@spitzmueller.org}{juergen (at) spitzmueller (dot) org}.%
+}}
+
+
+\date{Version 0.3, 23/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}.}
+package requires at least version 2.0 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,
+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,
@@ -43,7 +64,8 @@ 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
+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
@@ -54,27 +76,28 @@ 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}
+ omitname=<surname>]{biblatex}
\end{lstlisting}
-\end{quote}
+\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:
+file, by surname, which person it should suppress in the author\slash{}editor
+list (usually you). That is to say: For all of your publications where
+you are the sole author or editor, the author\slash{}editor 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:
+If there are co-authors\slash{}co-editors, your name will be filtered
+out and the collaborators 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.
@@ -84,14 +107,14 @@ in gardening? In: \emph{Gardening Practice} 24, pp. 10--15.
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.%
+\footnote{Please refer to the \bibltx\ manual \cite{bibltx} for those.%
}):
\begin{description}
-\item [{myfirstname}] =<first name>
+\item [{omitfirstname}] =<first name>
-If you need to disambiguate your name further, you can additionally
-specify your first name.
+If you need to disambiguate your name, you can additionally specify
+your first name.
\item [{boldyear}] {[}=true|false{]} default: \emph{true}.
@@ -124,9 +147,9 @@ If you want to change the appearance, just redefine this macro via
\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.%
+Since the package draws on \bibltx , it supports localization. Currently,
+the following languages are supported: English, French 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}
@@ -142,12 +165,12 @@ for entries referring to partially translated work via \bibltx 's
The following extensions of standard \bibltx\ features are provided.
-\subsection{Review bibliography type}
+\subsection{Review bibliography type\label{sub: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}
+own work. It therefore defines a new bibliography environment \emph{reviews}
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
@@ -171,10 +194,11 @@ 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:
+category, say \emph{mymonographs.bib}, \emph{myarticles.bib}, \emph{myproceedings.bib}.%
+\footnote{But see sec.~\ref{sec:filtering} for an alternative.%
+} Then a typical file would look like in Listing~\ref{example}.
\begin{quote}
-\begin{lstlisting}[float,frame=single,language={[LaTeX]TeX}]
+\begin{lstlisting}[caption={Example document},float,frame=single,label={example},language={[LaTeX]TeX}]
\documentclass{article}
\usepackage[T1]{fontenc}
\usepackage[latin9]{inputenc}
@@ -217,12 +241,12 @@ Then a typical file would look like this:
\end{lstlisting}
\end{quote}
-If you want to add other people's reviews of your work, add a sections
+If you want to add other people's reviews of your work, add a section
such as:
\begin{quote}
\begin{lstlisting}[frame=single,language={[LaTeX]TeX}]
\subsubsection*{Reviews of my thesis}
-\begin{refsection}[mythesis_reviews]
+\begin{refsection}[mythesis-reviews]
\renewcommand\bibfont{\small}
\nocite{*}
\printbibliography[heading=none,env=reviews]
@@ -230,13 +254,51 @@ such as:
\end{lstlisting}
\end{quote}
-Note that the \emph{printbibliography} option \emph{env=reviews} is
-crucial.
+Note that the \texttt{\textbackslash{}printbibliography} option \emph{env=reviews}
+ is crucial if you want to use the specifics \bpl\ defines for reviews
+(see sec.~\ref{sub:review-bibliography-type}).
+\section{Filtering\label{sec:filtering}}
+
+If you have a bibliographic database consisting not only of your own
+publications, you can extract yours with the bibliography filter \emph{mine},
+which has to be passed to \texttt{\textbackslash{}printbibliography},
+as in:
+\begin{quote}
+\begin{lstlisting}[frame=single,language={[LaTeX]TeX}]
+\begin{refsection}[mybibliography]
+\nocite{*}
+\printbibliography[heading=none,filter=mine]
+\end{refsection}
+\end{lstlisting}
+
+\end{quote}
+Of course, you can also use other filter possibilities provided by
+\bibltx , such as filtering by type or by keyword. So if you want
+to extract all of your articles from a larger database with entries
+of diverse type and authors, specify:
+\begin{quote}
+\begin{lstlisting}[language={[LaTeX]TeX}]
+\printbibliography[heading=none,filter=mine,type=article]
+\end{lstlisting}
+
+\end{quote}
+
\section{Change Log}
\begin{description}
-\item [{V.~0.2~(2012-10-21)}] Initial release on CTAN.\end{description}
+\item [{V.~0.3~(2012-10-23):}]~
+
+\begin{itemize}
+\item Bug fix: Add missing ``and'' if omitted name was last minus one.
+\item Bug fix: Fix output with ``et al.'' if omitted name is first and
+\emph{liststop} is 1.
+\item Set \emph{maxnames} default to 4.
+\item Add filter possibility (see sec.~\ref{sec:filtering}).
+\item Add French localization.
+\item Some corrections to the manual.
+\end{itemize}
+\item [{V.~0.2~(2012-10-21):}] Initial release to CTAN.\end{description}
\begin{thebibliography}{1}
\bibitem{bibltx}Lehman, Philipp (with Audrey Boruvka, Philip Kime
and Joseph Wright): \emph{The biblatex Package. Programmable Bibliographies