summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-dw/biblatex-dw.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-11-24 22:37:11 +0000
committerKarl Berry <karl@freefriends.org>2011-11-24 22:37:11 +0000
commit221e3f5a227809dc8ecae2d464966d254aecc46f (patch)
tree07c36b579d73f6533adfee2a8fd66a75b0764111 /Master/texmf-dist/doc/latex/biblatex-dw/biblatex-dw.tex
parent1766bcbd5d57f14320a8adcbed669b358001f8fc (diff)
biblatex 1.4 (21nov11)
git-svn-id: svn://tug.org/texlive/trunk@24647 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-dw/biblatex-dw.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-dw/biblatex-dw.tex108
1 files changed, 76 insertions, 32 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-dw/biblatex-dw.tex b/Master/texmf-dist/doc/latex/biblatex-dw/biblatex-dw.tex
index 4d376a853a2..f3e2663b1bc 100644
--- a/Master/texmf-dist/doc/latex/biblatex-dw/biblatex-dw.tex
+++ b/Master/texmf-dist/doc/latex/biblatex-dw/biblatex-dw.tex
@@ -1,5 +1,5 @@
% biblatex-dw
-% Copyright (c) Dominik Waßenhoven <domwass(at)web.de>, 2010
+% Copyright (c) Dominik Waßenhoven <domwass(at)web.de>, 2011
\documentclass[english]{scrartcl}
\input{biblatex-dw-preamble}% preamble
@@ -17,8 +17,8 @@
\bl{} package. It was designed for citations in the
Humanities and offers some features that are not provided
by the standard \bl{} styles. \bldw{} is dependent
- on \bl{}~-- version~\biblatexdwversion{} \Mindestanforderung{}
- (please note also the requirements of the \bl{} package itself).}
+ on \bl{}~-- version~\biblatexdwversion{} \Mindestanforderung{}\Testversion.
+ Please note also the requirements of the \bl{} package itself.}
\lizenz
\screenversion
@@ -58,19 +58,19 @@ or
\usepackage[style=footnote-dw]{biblatex}
\end{lstlisting}
The styles are built in a very entangled way which means that the combination of a \bldw\ style with another style is not possible without fail.
+For an overview of the styles see the examples \enquote{en-authortitle-dw}
+ and \enquote{en-footnote-dw} in the \texttt{examples} folder.
+\subsection{Global options and entry options}
The options provided by \bl{} are also available with \bldw{}.
The additional options provided by \bldw{} are described on the next pages.
There is a general difference between global options and entry options:
global options are valid for all references of a document; they are set
either as optional arguments when loading \bl{} or in a separate config
file (\texttt{biblatex.cfg}). Entry options are set in the field
-\texttt{options} of an entry in the bib file. Entry options may override
+\texttt{options} of an entry in the bib file. Entry options can sometimes override
global options for the respective entry.
-For an overview of the styles see the examples \enquote{en-authortitle-dw}
- and \enquote{en-footnote-dw} in the \texttt{examples} folder.
-
\subsection{Frequently asked Questions (FAQ)}
I answered some frequently asked questions concerning \bl{} and \bldw{} and made them
available online:\\
@@ -93,10 +93,16 @@ Besides some changes in punctuation, there are the following differences:
\item If\beschreibung{oldauthor} you set the \option{namefont}, but nevertheless need some
of the names being typeset in upright shape (e.g. medieval or
antique authors), you can add \texttt{options\,=\,\{oldauthor=true\}}
- or \texttt{options\,=\,\{oldauthor\}} to the respective entry of your
+ to the respective entry of your
bib file. If you have to switch back to the normal appearance also
for entries with this \texttt{oldauthor} flag, you can set the global
option \option{oldauthor=false} in order to override the entry option.
+ \item There\beschreibung{oldbookauthor} is also the entry option \option{oldbookauthor}
+ which is the same as \option{oldauthor} but for the bookauthor. This is
+ useful for \texttt{@inbook} entries representing, e.g., an introduction to an
+ edition of a work by an author that should not be typeset in the usual font
+ for last names. This option can be set on a per entry basis and can be
+ disabled with the global option \option{oldauthor=false}.
\item The\beschreibung{idemfont} font shape of the \enquote{idem} string (see below) can be set by
the option \option{idemfont} which can take the values
\wert{smallcaps}, \wert{italic}, \wert{bold} and \wert{normal}. If you
@@ -127,11 +133,27 @@ Besides some changes in punctuation, there are the following differences:
\wert{true}, the default value for \option{idembibformat} is
\wert{idem}.
\item When\beschreibung{edbyidem} \texttt{author} and \texttt{editor} are the same in
- \texttt{@incollection} or \texttt{@inbook} entries, the name is not
+ \texttt{@inbook}, \texttt{@incollection} or \texttt{@inreference} entries, the name is not
repeated but substituted by the string \enquote{idem}. This feature
is controled by the option \option{edbyidem} which can be set to
\wert{true} or \wert{false}; the default value is \wert{true}.
- \item Using\beschreibung{pseudoauthor} the entry option \option{pseudoauthor}, the author can be put
+ \item The\beschreibung{editorstring} option \option{editorstring} can take the values
+ \wert{parens}, \wert{brackets} and \wert{normal}; the default is
+ \wert{parens}. This option sets the string \enquote{editor}
+ (abbreviated \enquote{ed.}) in parentheses or in brackets. If you set
+ the option to \wert{normal}, the editor string is not
+ surrounded by parentheses or brackets. Instead, a comma is added after
+ the editor's name.
+ If \option{usetranslator=true} is used, the setting for
+ \option{editorstring} is also valid for the string
+ \enquote{translator} (abbreviated \enquote{trans.}).
+ \item The\beschreibung{editorstringfont} option \option{editorstringfont}
+ determines the font used for the editor string (and
+ translator string). With \wert{normal},
+ the normal font is used, with \wert{namefont}, the setting for the option
+ \option{namefont} is also used for the editor string. The default value for this
+ option is \wert{normal}.
+ \item Using\beschreibung{pseudoauthor} the entry option \option{pseudoauthor}, the author can be put
in brackets or omitted. This is useful for editions of works whose authors
are not named, but are known, for instance. If the global option \option{pseudoauthor}
is set to \wert{true} (and the entry option \option{pseudoauthor} is used), the author of this
@@ -185,9 +207,9 @@ Besides some changes in punctuation, there are the following differences:
\item The punctuation before \texttt{titleaddon}, \texttt{booktitleaddon}
and \texttt{maintitleaddon} is controlled by the new command
\cmd{titleaddonpunct}. The default is a period.
- \item The\beschreibung{edsuper} option \option{edsuper} is introduced. If it is set to \wert{true},
+ \item With\beschreibung{edsuper} \option{edsuper=true},
the edition is printed as superscript number (not as ordinal number)
- straight ahead of the year. The default value for this option is
+ just before the year. The default value for this option is
\wert{false}.\\
\achtung Note that this works only, if you have integers in the field
\texttt{edition}, and nothing but integers. Information like
@@ -197,16 +219,18 @@ Besides some changes in punctuation, there are the following differences:
option \option{edsuper} for one of your documents, you should ensure
that you put only integers into the \texttt{edition} field and use the
field \texttt{note} for more detailed information on editions.
- \item The\beschreibung{editorstring} option \option{editorstring} is introduced. It can take the values
- \wert{parens}, \wert{brackets} and \wert{normal}; the default is
- \wert{parens}. This option sets the string \enquote{editor}
- (abbreviated \enquote{ed.}) in parentheses or in brackets. If you set
- the option to \wert{normal}, the editor string is not
- surrounded by parentheses or brackets. Instead, a comma is added after
- the editor's name.
- If \option{usetranslator=true} is used, the setting for
- \option{editorstring} is also valid for the string
- \enquote{translator} (abbreviated \enquote{trans.}).
+ \item With\beschreibung{editionstring} \option{editionstring=true}, the
+ bibliography string \enquote{edition} will be added to the
+ \texttt{edition} field, even if it is not an integer. Thus,
+ you can type, e.g.,
+ \begin{lstlisting}
+edition = {2., revised}
+ \end{lstlisting}
+ in your bib file and you will get \enquote{2., revised ed.}
+ \option{editionstring=false} will give the additional bibliography
+ string only if there is an integer in the \texttt{edition} field
+ (which is \bl's standard behaviour).
+ The default for this option is \wert{false}.
\item If\beschreibung{shortjournal} the option \option{shortjournal} is set to \wert{true}, the
field \texttt{shortjournal} is used instead of \texttt{journaltitle}.
This is useful for journal abbreviations.
@@ -243,16 +267,20 @@ Besides some changes in punctuation, there are the following differences:
\renewcommand*{\jourvolstring}{%
\addspace vol\adddot\space}
\end{lstlisting}
- \item The fields \texttt{series} and \texttt{number} are put in
- parentheses.
\item The\beschreibung{series} option \option{series} affects the position of the \texttt{series}
field. If set to \wert{afteryear}, the series is printed after the
year. This affects the entry types \texttt{@book}, \texttt{@inbook},
\texttt{@collection}, \texttt{@incollection}, \texttt{@proceedings},
\texttt{@inproceedings} and \texttt{@manual}. The standard value for
this option is \wert{standard}.
+ \item The\beschreibung{seriesformat} option \option{seriesformat} can
+ take the values \wert{standard} and \wert{parens}. If set to
+ \wert{parens}, \texttt{series} and \texttt{number} (of a book etc.)
+ will be printed in parentheses, otherwise without (as is the biblatex
+ standard behaviour). The default value for this option is \wert{parens}.
\item The command \cmd{seriespunct} is the punctuation before the
- \texttt{series} (of a book etc.). This punctuation is set inside the
+ \texttt{series} (of a book etc.). With \option{seriesformat=parens},
+ this punctuation is set inside the
parentheses. You can set it e.g. to \wert{=\cmd{addspace}} which is
common in some fields. The default is empty, i.e.\ the series is
printed right after the opening round bracket.
@@ -485,7 +513,10 @@ Besides, there are the following differences between \xbx{footnote-dw} and
\begin{itemize}
\item Citations are \emph{only} possible inside footnotes. Citations
which are not inside footnotes will automatically be turned into
- a \cmd{footcite}.
+ a \cmd{footcite}. The only exception is \cmd{textcite} which will
+ give the author's name in the text and a footnote citation; when used inside
+ a footnote, \cmd{textcite} will give the author's name, followed by the
+ citation in parenthesis.
\item The first citation will give a full reference, following citations
will only use \texttt{author} and \texttt{shorttitle} (or
\texttt{title}, if no \texttt{shorttitle} is given) with the
@@ -501,8 +532,6 @@ Besides, there are the following differences between \xbx{footnote-dw} and
footnotes, the \cmd{parencite} command will work as expected. The
addition \enquote{see n.~\ldots} will be surrounded by brackets
instead of parentheses.
- \item The \cmd{textcite} command is not defined and will be
- replaced by a \cmd{cite} command.
\item If one or both of the options \option{annotation} and \option{library}
are set to \wert{true}, the annotations and library information
are only printed in the bibliography (if there is one), but not in the
@@ -621,11 +650,17 @@ file (\texttt{biblatex.cfg}). The value in parentheses shows the default.
will be printed or not.
\optlist{edbyidem}{true}
\enquote{ed. by idem} instead of \enquote{ed. by \emph{Editor}}.
+ \optlist{editionstring}{false}
+ Adds the string \enquote{ed.} to the edition, regardless of the content of the
+ \texttt{edition} field.
\optlist{editorstring}{parens}
Sets the editor string (with \option{usetranslator=true} also the
translator string) in parentheses (\wert{parens}) or brackets
(\wert{brackets}). If set to \wert{normal}, the editor string is
put after the editor's name and preceded by a comma.
+ \optlist{editorstringfont}{normal}
+ The editor\slash translator strings are typeset either in normal font (\wert{normal}) or
+ in the font used by \option{namefont} (\wert{namefont}).
\optlist{edstringincitations}{true}
In citations, the editor string (with \option{usetranslator=true}
also the translator string) is put after the editor's name (and the
@@ -635,8 +670,8 @@ file (\texttt{biblatex.cfg}). The value in parentheses shows the default.
\optlist[\xbx{authortitle-dw} only]{firstfull}{false}
The first citation is printed with full reference.
\optlist{firstfullname}{false}
- At the first citation with \cmd{citeauthor} or \cmd{textcite} (with
- footnote-dw: \cmd{citeauthor} only) the full name is printed, at all
+ At the first citation with \cmd{citeauthor} or \cmd{textcite}
+ the full name is printed, at all
subsequent citations only the last name is printed.
\optlist{firstnamefont}{normal}
Specifies the font shape of the first names of authors and editors as well
@@ -682,7 +717,8 @@ file (\texttt{biblatex.cfg}). The value in parentheses shows the default.
publisher is omitted, too, even if \option{nopublisher} is set to
\wert{false}.
\optlist{oldauthor}{true}
- If set to \wert{false}, the entry option \option{oldauthor} is ignored.
+ If set to \wert{false}, the entry options \option{oldauthor} and
+ \option{oldbookauthor} are ignored.
\optlist{omiteditor}{false}
If set to \wert{true}, the editor is omitted in citations.
\optlist{origfields}{true}
@@ -704,6 +740,9 @@ file (\texttt{biblatex.cfg}). The value in parentheses shows the default.
\optlist{series}{standard}
Position of a work's \texttt{series}: with \wert{standard} as in the
standard styles, with \wert{afteryear} after the \texttt{year}.
+ \optlist{seriesformat}{parens}
+ Format of a work's \texttt{series}: with \wert{standard} as in the
+ standard styles, with \wert{parens} in parentheses.
\optlist{shorthandibid}{true}
Immediately repeated citations of entries with \texttt{shorthand} are
replaced by \enquote{ibid.}
@@ -742,7 +781,10 @@ They may override global options for the respective entry.
with a \texttt{shorthand} is enforced (\wert{true}) or suppressed
(\wert{false}).
\opt{oldauthor}
- The author is not set in the font shape chosen by \option{namefont},
+ The \texttt{author} is not set in the font shape chosen by \option{namefont},
+ if the global option \option{oldauthor} is set to \wert{true}.
+ \opt{oldbookauthor}
+ The \texttt{bookauthor} is not set in the font shape chosen by \option{namefont},
if the global option \option{oldauthor} is set to \wert{true}.
\opt{pseudoauthor}
The author is printed between \cmd{bibleftpseudo} and \cmd{bibright\-pseudo},
@@ -1144,6 +1186,8 @@ The following list shows additional commands introduced by \bldw{}, along with t
of shorthands, if \option{shorthandwidth} is used.}
\befehl{shorthandsep}{3pt plus 0.5pt minus 0.5pt}{Length between the
shorthand and its description, if \option{shorthandwidth} is used.}
+ \befehl{textcitesdelim}{\cmd{addspace}\cmd{bibstring\{and\}}\cmd{space}}{Delimiter between
+ multiple authors when using \cmd{textcites}.}
\befehl{titleaddonpunct}{\cmd{addperiod}\cmd{space}}{Punctuation ahead of
\texttt{titleaddon}, \texttt{booktitleaddon} and
\texttt{maintitle\-addon}.}