diff options
author | Karl Berry <karl@freefriends.org> | 2012-10-23 23:30:42 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-10-23 23:30:42 +0000 |
commit | 96c2f6d58f41753e3a725cd10e4ff646155e9017 (patch) | |
tree | 5b0ca0aca5ba23b0fce7f053731a898a384b49b6 /Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex | |
parent | 16bf9ff0d2574baf1055949532b3ac27c9e0c46b (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/biblatex-publist.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-publist/biblatex-publist.tex | 130 |
1 files changed, 96 insertions, 34 deletions
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 |