diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/jurabib/docs/english/jbendoc.tex')
-rw-r--r-- | Master/texmf-dist/doc/latex/jurabib/docs/english/jbendoc.tex | 2254 |
1 files changed, 2254 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/jurabib/docs/english/jbendoc.tex b/Master/texmf-dist/doc/latex/jurabib/docs/english/jbendoc.tex new file mode 100644 index 00000000000..97bdb2c5c2f --- /dev/null +++ b/Master/texmf-dist/doc/latex/jurabib/docs/english/jbendoc.tex @@ -0,0 +1,2254 @@ +\documentclass[a4paper]{ltxdoc} +\usepackage[latin1]{inputenc} +\usepackage{longtable} +\usepackage[commabeforerest,titleformat=commasep]{jurabib} +\interfootnotelinepenalty=10000 \raggedbottom +\newif\ifHtml +\newcommand{\mymarginpar}[1]{\marginpar{\raggedleft\textsf{#1}}} +\newcommand{\NEW}[1]{\marginpar{\raggedleft\textsf{#1~{\large NEW\,!}}}} +\newcommand{\CH} [1]{\marginpar{\raggedleft\textsf{#1~{\large CHANGED\,!}}}} +\newcommand{\REM}[1]{\marginpar{\raggedleft\textsf{#1~{\large REMOVED\,!}}}} +\makeatletter + \@ifundefined{pdfoutput}{% + \let\pdfoutput\@undefined + \ExecuteOptions{dvips}% + }{% + \ifcase\pdfoutput + \let\pdfoutput\@undefined + \ExecuteOptions{dvips}% + \else + \usepackage[pdftex,colorlinks=true,plainpages=false,pdfpagelabels,linktocpage]{hyperref}% + \hypersetup{% + pdftitle={Documentation for jurabib package},% + pdfauthor={Jens Berger},% + }% + \fi + }% +\makeatother \pagestyle{headings} +\newcommand\bibentry[1]{\par\medskip{\renewcommand\jbauthorfont{\textbf}\renewcommand\jbauthorfnfont{\textbf}\noindent\qquad\fullcite{#1}}\par\medskip} +\AtEndDocument{\bibliography{jbtest,jbtesthu}} +\renewcommand{\contentsname}{Contents} +\providecommand{\url}[1]{\texttt{#1}} +\providecommand\href[2]{#2} +\providecommand\texorpdfstring[2]{#1} +\newenvironment{bibexample}{% + \begin{description}% + \setlength{\itemindent}{-2.5em} + \setlength{\leftmargin}{2.5em} + }{\end{description}} +\newenvironment{Options}% + {\begin{list}{}{% + \renewcommand{\makelabel}[1]{\texttt{##1}\hfill}% + \setlength{\itemsep}{-.5\parsep} + \settowidth{\labelwidth}{\texttt{xxx\space}}% + \setlength{\leftmargin}{\labelwidth}% + \addtolength{\leftmargin}{\labelsep}}% + } {\end{list}} +\def\jbfileversion{v0.6} +\def\jbfiledate{\today} +\title{The \textsf{jurabib} Package} +\author{{\Large Jens Berger}\thanks{Translated into English by Maarten Wisse.}\\ + \href{mailto:jb@jurabib.org}{\texttt{jb@jurabib.org}}\\[1.8ex] + {\small Stefan Ulrich}} +\date{\jbfiledate \qquad \textsf{\jbfileversion}\\[1ex] + {\footnotesize CTAN: + \href{ftp://ftp.dante.de/tex-archive/macros/latex/contrib/supported/jurabib/}{\texttt{macros/latex/contrib/supported/jurabib/}}}% +}% +\begin{document} + \ifHtml + \renewcommand{\href}[2]{\HCode{<a href=#1>}#2\HCode{</a>}} + \makeatletter + \let\DescribeMacro\@gobble + \let\NEW\@gobble + \let\CH\@gobble + \let\REM\@gobble + \let\mymarginpar\@gobble + \makeatother + \fi + +\maketitle + + \begin{abstract} + \noindent This package enables automated citation with \BibTeX{} for legal + studies and the humanities. In addition, the package provides commands for + specifying annotators in a commentary in a convenient way. Simplified + formatting of the citation as well as the bibliography entry is + also provided. It is possible to display the (short) title of a + work only if an authors is cited with multiple works. Giving a full + citation in the text, conforming to the bibliography entry, is + supported. Several options are provided which might be of special + interest for those outside legal studies---for instance, + displaying multiple full citations. In addition, the format of last + names and first names of authors may be changed easily. Cross + references to other footnotes are possible. Language dependent + handling of bibliography entries is possible by the special + \texttt{language} field. + \end{abstract}% + +\tableofcontents + +\section{Introduction}\setcounter{page}{1} + +Up till now, support for citation according to the rules used in legal studies +was only available by the environment \texttt{jurabibliography} from +\textsf{jura.cls}. However, this environment does not work with \BibTeX. +\textsf{jurabib.sty} should solve this problem. The package primarily counts as +an extension to \textsf{jura.cls}, but it is built in such a way that it works +well together with all \LaTeX\ standard classes and also with the +\textsf{KOMA-Script}-classes \texttt{scrbook}, \texttt{scrreprt} and +\texttt{scrartcl}. Hence, it is possible to use the package together with +\textsf{alphanum} and the \texttt{book}-class, for writing a doctoral +dissertation. + +\textsf{jurabib.sty} (re)defines \cs{[foot]cite} in such a way that it now +contains two optional arguments, so that possible annotators of a publication may +be specified in the second optional argument. Apart from this, the +\BibTeX-styles (\texttt{jurabib.bst} and \texttt{jureco.bst} which are +delivered with the package enable it to +\begin{enumerate} +\item automatically recognize the lastnames of the authors and cite + these accordingly in short citations. + +\item automatically generate short title information from article and + periodical citations. + +\item nevertheless explicitly specify a short form of the author's + name or title. + +\item (default) give the short title only if multiple works of the author are cited. +\end{enumerate} +The functionality described above is exclusively carried out by the +\BibTeX-styles \texttt{jurabib.bst}, \texttt{jurunsrt.bst} and \texttt{jureco.bst}. + +\section{Prequisities} +After processing \texttt{jurabib.ins} with \LaTeX{}, the following files should +be created at least: + +\begin{itemize} + \item \texttt{jurabib.sty} + \item \texttt{jurabib.bst} + \item \texttt{jureco.bst} + \item \texttt{jurunsrt.bst} + \item \texttt{jox.bst} + \item \texttt{jbtesthu.bib} + \item \texttt{jbtest.bib} + \item \texttt{jurabib.cfg} + \item some \texttt{.ldf} files + \item some \texttt{jbtest*.tex} files +\end{itemize} +In a TDS-conforming \TeX-System the \texttt{.sty}-files and the +\texttt{.ldf}-files should be in \texttt{\slash [local]texmf\slash tex\slash +latex\slash jurabib}, the \texttt{.bst}-files in \texttt{\slash +[local]texmf\slash bibtex\slash bst\slash jurabib} and the \texttt{.bib}-files in +\texttt{\slash [local]texmf\slash bibtex\slash bib\slash jurabib}. +May be it's necessary to update a ``Filename Database''. If you are using +teTeX, run \texttt{texhash}, if you are using MiKTeX, run \texttt{initexmf -u} +on a DOS prompt or the appropriate graphical frontends. All mentioned files +could also be placed in the directory in which \LaTeX\ is executed. The files +\texttt{jbtest.tex} and \texttt{jbtest.bib} demonstrate the use of the +\textsf{jurabib}-package. + +\texttt{jbtestbt.tex} serves as a demonstration of \textsf{jurabib.sty} in +cooperation with \textsf{bibtopic.sty} for generating bibliographies by topic. + +\texttt{jbtestmb.tex} serves as a demonstration of \textsf{jurabib.sty} in +cooperation with \textsf{multibib.sty} for generating multiple bibliographies. + +\texttt{jbtestcb.tex} serves as a demonstration of \textsf{jurabib.sty} in +cooperation with \textsf{chapterbib.sty} for generating bibliographies for each chapter. + +\texttt{jbtestbu.tex} serves as a demonstration of \textsf{jurabib.sty} in +cooperation with \textsf{bibunits.sty} for generating multiple bibliographies too. + +One enables the package in the following way: + +\begin{quote} + \cs{usepackage}\oarg{Options}\texttt{\{jurabib\}} + + \noindent{\footnotesize You can use \cs{jurabibsetup} in the preamble or in the + configurations file: + \begin{verbatim} + \jurabibsetup{ + authorformat=smallcaps, + commabeforerest, + titleformat=colonsep, + bibformat=tabular + } + \end{verbatim} + + You can place several values of some keys into a pair of braces: + \begin{verbatim} + \jurabibsetup{bibformat={tabular,ibidem,numbered}} + \end{verbatim}} + \end{quote} + +At the point where the bibliography should be placed, the following should be +specified: + +\begin{quote} + \cs{bibliography}\marg{{\upshape\BibTeX}-database} +\end{quote} +followed by +\begin{quote} + \cs{bibliographystyle}\marg{{\upshape\BibTeX}-stylefile} +\end{quote} + +Now, the package is ready to work. When you are new to \BibTeX{} please +remember that for \BibTeX{} working properly, a sequence of one \LaTeX{} run, one +\BibTeX{} run, and two subsequent \LaTeX{} runs are required: + +\begin{verbatim} + latex data + bibtex data + latex data + latex data +\end{verbatim} + +\subsection{If you are working with a Windows-Distribution} +You have to (!) use a large version of \BibTeX{} (\texttt{bibtex8}) with a huge +amount of memory enabled. \marginpar{\raggedleft\textsf{\Huge !!!}} You can achieve that by using a command-line +parameter like |--huge| or |--wolfgang|, otherwise you will get error +messages like that: + +\begin{verbatim} + The style file: jurabib.bst + 5017: Sorry---you've exceeded BibTeX's wizard-defined function space 3000 + (That was a fatal error) +\end{verbatim} + +This is problem can be solved by using one of the command line parameters of |bibtex8|: + +\begin{verbatim} + bibtex8 --wolfgang file +\end{verbatim} + +\subsection{If you are working with a Unix/Linux-Distribution} +As a user of the te\TeX- or \TeX Live-Distribution you do not need |bibtex8|, +because those Bib\TeX{} executables were compiled with enough memory enabled. +But it is not senseless to use |bibtex8|\,! If you are using author names or titles with umlauts, +|bibtex8| is able to handle this by default, the normal Bib\TeX{} requires +translation into |{\"u}| etc. At the moment only \TeX live comes with |bibtex8|, it is missed in te\TeX. +You would need to compile it yourself, you will find the sources on CTAN. + +\section[An Example]{An Example\footnotemark[1]} + +\footnotetext[1]{For all examples---if not explicitly specified +differently---the options \texttt{titleformat=commasep} and +\texttt{commabeforerest} as well as the command \cs{cite} have been used.} + +Suppose one wants to cite a juridical work. Then, the first thing to do is to +add the work to the bibliography database: + +\begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Kr{\"a}mer}, + title = {Stra{\ss}enrecht}, + shortauthor = {Kodal/Kr{\"a}mer}, + shorttitle = {StrR}, + year = 1995, + address = {M{\"u}nchen}, + edition = {5}, + pages = {30--34, \S~24} + } +\end{verbatim} + +Look at the fields \texttt{shortauthor} and \texttt{shorttitle}. These are +provided by the \BibTeX-styles belonging to the package. +\texttt{shortauthor} and \texttt{shorttitle} are the equivalent fields +available. There, the required short forms of the author and title +are provided. (on this, see section~\ref{auto} on page~\pageref{auto}). + +\section{The Tools} +\subsection{The \texorpdfstring{\cs{cite}}{cite} command} + +\DescribeMacro{\cite} +A citation is specified as usual: +\begin{verbatim} + \cite[\S~12]{kkstrr} +\end{verbatim} +Instead of the standard layout: + +\medskip + + [1, \S~12] + +\medskip\noindent +the citation now looks like: + +\cite[\S~12]{kkstrr} + +The short form of the title (StrR) would only be cited when Kodal and +Kr{\"a}mer were cited with another work or the option \texttt{titleformat=all} +is given. Then, the citation would look as follows: + +\citetitle[\S~12]{kkstrr} + +Because the command \cs{cite} is redefined by \textsf{jurabib.sty}, it has now +two optional arguments instead of one: + +\medskip + +\noindent\CH{0.6} +\fbox{\begin{minipage}{\textwidth} +{\Large\itshape Attention: since v0.6 the order of optional arguments has changed\,!} +\begin{quote} +\cs{cite}\oarg{page range}\marg{key}\\ +\cs{cite}\oarg{annotator}{\ttfamily[]}\marg{key}\\ +\cs{cite}\oarg{annotator}\oarg{page range}\marg{key}\\ + with \texttt{see}\\ +\cs{cite}{\ttfamily[Vgl.]}\oarg{page range}\marg{key} +\end{quote} +The compatibility option \texttt{jurabiborder} lets you compile old documents: +\begin{quote} +\cs{cite}\oarg{page range}\marg{key}\\ +\cs{cite}{\ttfamily[]}\oarg{annotator}\marg{key}\\ +\cs{cite}\oarg{page range}\oarg{annotator}\marg{key}\\ +with \texttt{see}\\ +\cs{cite}\oarg{page range}{\ttfamily[see]}\marg{key} +\end{quote} +\end{minipage}} + +\medskip + +Here's a short table with the new syntax: + +\medskip + +{\small +\begin{tabular}{ll} +\hline +Source & Output \\ +\hline +|\cite{broxbgb}| & \cite{broxbgb}\\ +|\cite[p.~12]{broxbgb}| & \cite[p.~12]{broxbgb}\\ +|\cite[Bassenge][]{broxbgb}| & \cite[Bassenge][]{broxbgb}\\ +|\cite[Bassenge][p.~12]{broxbgb}| & \cite[Bassenge][p.~12]{broxbgb}\\ +\hline +\end{tabular}} + +\bigskip + +So, a possible annotator will be specified as follows: + +\begin{verbatim} + \cite[Bassenge][\S~12]{kkstrr} +\end{verbatim} + The following citation would emerge from this cite +command---provided that multiple works by Kodal and Kr{\"a}mer are cited: + +\medskip + +\cite[Bassenge][\S~12]{kkstrr} % Kodal/Krämer/Bassenge, StrR, \S~12. + +\medskip + +\noindent The bibliography entry belonging to this citation would then be: \par + +\bibentry{kkstrr} + +If it might happen that one does not want to give pageranges, margin numbers or +the like, and \emph{nevertheless} wants to specify an annotator, then, the first +optional argument should be left empty: + +\begin{verbatim} + \cite[Bassenge][]{kkstrr}% before 0.6: \cite[][Bassenge]{kkstrr} +\end{verbatim} + +\DescribeMacro{\citetitle} The command \cs{citetitle} basically behaves like +\cs{cite}, but may be used for explicitly citing by short title, independent +from the author's being cited with multiple works. Otherwise, the same goes for +\cs{citetitle} as for \cs{cite}. + +\DescribeMacro{\cite*} This asterisk-from of the \cs{cite} command cites +\emph{always} without title. In this case, it doesn't matter whether the +\texttt{shorttitle}-field has been provided in the database. The options +\texttt{citefull=all} too, are deactivated in this case. (see +section~\ref{opt}). Note, however, that hereby, ambiguous\mymarginpar{!} +citations might occur, since the automatical specification of short title/full +title is deactivated for this citation. Therefore, this command should be used +with care. + +\DescribeMacro{\citetitlefortype} This command can be used to declare a list of +publication types, for those the titles should appear always: + +\begin{verbatim} + \citetitlefortype{article,book, ... } +\end{verbatim} + +\DescribeMacro{\citenotitlefortype} For use together with the option +\texttt{titleformat=all} to declare a list of publication types, for those the +titles shouldn't appear: + +\begin{verbatim} + \citenotitlefortype{article,book, ... } +\end{verbatim} + +\subsection{The \texorpdfstring{\cs{footcite}}{footcite} commands} + +\DescribeMacro{\footcite} \DescribeMacro{\footcite*} +\DescribeMacro{\footcitetitle} + These commands are different from the \cs{cite} commands, in that they + automatically generate a footnote and place a period at the end of + it. A space before the \cs{footcite} commands is ignored: +\begin{verbatim} + ... Annahme. \footcite[Rn.~357]{medicus} + ... Annahme.\footcite[Rn.~357]{medicus} +\end{verbatim} + +shows in both cases: + +\medskip +\dots{}~Annahme.\footnote{Medicus, Rn.~357.} + +\noindent However, a combination of multiple citations should be provided as +usual: +\begin{verbatim} + \footnote{\cite[S.~13--34]{brox:bgb}; \cite[S.~24]{canaris}.} +\end{verbatim} + +This results in: +\par\medskip +\dots{}~Annahme.\footnote{Brox, BGB, S.~13--34; Canaris, S.~24.} Here, people +should remember the period themselves, regrettably. + + If you are using some |\footcite| or |\footnote| commands \NEW{0.5f} subsequently, + \textsf{jurabib} is able to put a comma between the superscripted footnote marks. + This is the same behavior as known from the |multiple| option from the \textsf{footmisc} package. An example: + + \begin{verbatim} + ... \footcite{brox:bgb}\footcite{brox:schr}\footcite{brox:ja} + \end{verbatim} + \vspace{-1em} + produces: + + \medskip + \dots{}\textsuperscript{1,2,3} + +\subsection{The \texorpdfstring{\cs{fullcite}}{fullcite} commands} + +\DescribeMacro{\fullcite} \DescribeMacro{\footfullcite} These commands generate +a full citation, i.e., the complete entry from the bibliography is inserted +here. A possibly present annotator will be placed before the citation and +separated from the author by ``in''.\footnote{This reflects the automatic +activation of the option \texttt{annotatorfirstsep=in} for \emph{this} citation.} The +page range will be added at the end. + +\subsection{The \texorpdfstring{\cs{nextcite}}{nextcite} commands} + +\DescribeMacro{\nextciteshort} \DescribeMacro{\nextcitefull} + With these commands you can determine with a comma-separated (without whitespaces\,!) list of keys, how a cited work should appear + from now on: +\begin{verbatim} + \nextciteshort{brox:bgb,canaris, ... } +\end{verbatim} +in a short or +\begin{verbatim} + \nextcitefull{brox:bgb,canaris, ... } +\end{verbatim} +in a long kind. +\begin{verbatim} + \nextcitenotitle{brox:bgb,canaris, ... } +\end{verbatim} +With that command all given works appear from now on without title. \emph{All +three commands are overriding the \cs{fullcite}- and \cs{cite*} commands\,!} + +\smallskip +\noindent With \DescribeMacro{\nextcitereset} +\begin{verbatim} + \nextcitereset{brox:bgb,canaris, ... } +\end{verbatim} +you can switch back to the normal citation kind (specified by the chosen +options). + +\DescribeMacro{\citeswithoutentry} The new command \cs{citeswithoutentry} is +very similar to the \cs{nextcite} commands. You are able to specify a list of +works, which should not appear in the bibliography, but you can use all of the +\cs{cite} commands normally. Note, that the \cs{nextcitereset} command will not work here. + +\subsection{The \texorpdfstring{\cs{citefield}}{citefield} command} +With that command you have access to the contents of the fields +\texttt{author}, \texttt{shortauthor}, \texttt{title}, \texttt{shorttitle}, +\texttt{url}, \texttt{apy} (Address-Publisher-Year) and +\texttt{year}. You have to give the field name as the first mandatory argument, +the key as the second mandatory argument. Furthermore you can give a +page(range) with the optional argument: +\begin{quote} + {\small\cs{citefield}\oarg{pagerange}\marg{field}\marg{key}} +\end{quote} +With the following entry +\begin{verbatim} + @BOOK{brox:bgb, + author = {Hans Brox}, + title = {Allgemeiner Teil des B{\"u}rgerlichen Gesetzbuches}, + shorttitle = {BGB~AT}, + year = 1996, + language = {german}, + address = {K{\"o}ln, Berlin, Bonn, M{\"u}nchen}, + edition = 20 + } +\end{verbatim} +we get with a \verb+\citefield{title}{brox:bgb}+: Allgemeiner Teil des +B{\"u}rgerlichen Gesetzbuches. \verb+\citefield[\S~23]{shorttitle}{brox:bgb}+ +gives: BGB~AT,~\S~23. This command is especially for non-lawyers. It is +independent of all \textsf{jurabib}-specific automatisms, e.g. it is ignored by +the \texttt{ibidem}-options. If you are using the \textsf{hyperref}-package, a +link to the bibliography entry will be created. + +\textsf{jurabib} is able to emulate some basic citation commands of the \textsf{natbib} package: + +\medskip + +\begin{tabular}{@{}lll@{}}\hline\\[-2ex] +|\[foot]citep{Kraft74}| & $\rightarrow$ & (Kraft et al., 1937) \\ +|\[foot]citet{Kraft74}| & $\rightarrow$ & Kraft et al. (1937)\\ +|\[foot]citealt{Kraft74}| & $\rightarrow$ & Kraft et al. 1937\\ +|\[foot]citealp{Kraft74}| & $\rightarrow$ & Kraft et al., 1937\\ +|\[foot]citeauthor{Kraft74}| & $\rightarrow$ & Kraft et al.\\ +\hline +\end{tabular} + +\section{Automations}\label{auto} + +\subsection{Empty \texttt{shortauthor}-field} + +The package is now capable of automatically figuring out the lastname of the +author, in case of empty or failing \texttt{shortauthor}-field. Up till three +authors are typed out, separated by a slash. In case of more than three +authors, the name of the first author is typed out, along with ``et~al.''. So, +for instance, we leave the \texttt{shortauthor}-field out in our example entry +and add a third author: +\begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Kr{\"a}mer + and Hans Mustermann}, + title = {Stra{\ss}enrecht}, + shorttitle = {StrR}, + year = 1995, + address = {M{\"u}nchen}, + edition = {5.}, + pages = {S.\,30--34, \S~24} + } +\end{verbatim} +Then, the citation looks as follows: +\par\medskip +\qquad Kodal/Kr{\"a}mer/Mustermann, StrR, \S~12. +\par\medskip + +\noindent Separation marks may be modified in the following way. +\begin{verbatim} + \renewcommand{\jbbtasep}{ and } % bta = between two authors sep + \renewcommand{\jbbfsasep}{, } % bfsa = between first and second author sep + \renewcommand{\jbbstasep}{ and }% bsta = between second and third author sep +\end{verbatim} + +shows, for instance, instead of the example shown above: + +\par\medskip +\qquad Kodal, Kr{\"a}mer and Mustermann, StrR, \S~12. +\par\medskip + +\noindent Separation marks in the bibliography remain untouched by this +modification. Those can be modified by the following commands: +\begin{verbatim} + \renewcommand{\bibbtasep}{ and } % bta = between two authors sep + \renewcommand{\bibbfsasep}{, } % bfsa = between first and second author sep + \renewcommand{\bibbstasep}{ and }% bsta = between second and third author sep +and for the editors: + \renewcommand{\bibbtesep}{ and } % bte = between two editors sep + \renewcommand{\bibbfsesep}{, } % bfse = between first and second editor sep + \renewcommand{\bibbstesep}{ and }% bste = between second and third editor sep +\end{verbatim} + +If we add a fourth author (we save work by skipping the code), then the +citation looks like: +\par\medskip +\qquad Kodal et~al., StrR, \S~12. + +\subsection{Empty \texttt{shorttitle}-field} + +If the \texttt{shorttitle}-field is empty or nonexistent, the following happens: +The full title specified in the \texttt{title}-field will be +used\footnote{Exceptions are \texttt{@ARTICLE}- and \texttt{@PERIODICAL} +entries.}, if (locally) the command \cs{[foot]citetitle} or (global) the option +\texttt{citefull=all} is being used \emph{or multiple works of the author have +been cited}. + +In case one wants author's name only for a particular work---regardless what +kind of option have been activated---then, the command \cs{[foot]cite*} should +be used. This may lead to ambiguous citations, of which you will get a warning +in the \texttt{.log}-file. + +\begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Kr{\"a}mer + and Hans Mustermann}, + title = {Stra{\ss}enrecht}, + year = 1995, + address = {M{\"u}nchen}, + edition = {5.}, + pages = {S.\,30--34, \S~24} + } +\end{verbatim} +Result: +\par\medskip +\qquad Kodal/Kr{\"a}mer/Mustermann, Stra\ss{}enrecht, \S~12. +\par\medskip + +An alleviation should also be the fact that, in case of Article and Periodical +citations, \textsf{jurabib} now automatically cites (\meta{journal} +\meta{year}). Therefore, in these cases, specification of \texttt{shorttitle} is +no longer required---if no special requirements are present. In the following +example, neither + \texttt{shortauthor} nor +\texttt{shorttitle} has been specified: +\begin{verbatim} + @ARTICLE{brox:ja, + author = {Hans Brox}, + title = {Die Anfechtung bei der Stellvertretung}, + journal = {JA}, + year = 1980, + pages = {S.\,449ff}, + edition = {20.}, + address = {M{\"u}nchen} + } +\end{verbatim} + +Nevertheless, \cs{citetitle}\verb+{brox:ja}+ results in: +\par\medskip +\qquad Brox, JA 1980. +\par\medskip +\noindent If you want something different, you can use the \texttt{short*}-fields: +\begin{verbatim} + @ARTICLE{brox:ja, + author = {Hans Brox}, + title = {Die Anfechtung bei der Stellvertretung}, + journal = {JA}, + shortauthor = {Hans Brox}, + shorttitle = {JA}, + year = 1980, + pages = {S.\,449ff}, + edition = {20.}, + address = {M{\"u}nchen} + } +\end{verbatim} + +and you get: +\par\medskip +\qquad Hans Brox, JA. +\par\medskip + +\DescribeMacro{author = } You should notice that the dynamic generations of the +juridical short titles is possible only, when the contents of the +\texttt{author}-fields in the \texttt{.bib}-file are \emph{absolutely +identical}\,! Suppose \textsc{Kodal} and \textsc{Kr{\"a}mer} have published a +second work, then, the entries in the database should look as follows: +\begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Kr{\"a}mer}, + title = {Stra{\ss}enrecht} + } +\end{verbatim} + +\begin{verbatim} + @BOOK{kkanything, + author = {Kurt Kodal and Joachim Kr{\"a}mer}, + title = {anything} + } +\end{verbatim} + +\section{Options}\label{opt} +The following default behavior of the package has been implemented: The author +and editor in the citation are shown in normal font, in the bibliography, +however, in bold font. The editor is put after the author, separated by a +slash. This default behavior can be modified by the options of the package. + +\subsection{Tweaking the Format of the Citation in the Text} + +\subsubsection{Format of the Author and Editor} + +\begin{Options} +\item[authorformat=smallcaps] Puts author and annotator in small caps: + \textsc{Kodal\slash Kr{\"a}mer\slash Bassenge}, StrR, \S~12 + +\item[authorformat=italic] Puts author and annotator in italic font: + \textit{Kodal}\slash\textit{Kr{\"a}mer}\slash\textit{Bassenge}, StrR, + \S~12 + +\item[authorformat=dynamic] The font of the author depends on whether + an annotator is present or not. If not, the authors retain their font + as specified in the command \cs{jbactualauthorfont} as \cs{textit} + (default): \textit{Kodal\slash Kr{\"a}mer}, StrR, + \S~12. If an annotator has been specified, the annotator is formatted + according to the setting of \cs{jbactualauthorfont}, and the authors + are formatted according to \cs{jbauthorfontifcoauthor} ( + \cs{normalfont}): Kodal\slash Kr{\"a}mer\slash\textit{Bassenge}, StrR, + \S~12. + +\item[authorformat=citationreversed] Using this option together with options + \texttt{citefull=first}, \texttt{ibidem=name} and + \texttt{ibidem=name\&title} firstnames appear before last names: Hans + \textsc{Brox}: BGB~AT, S.~23. instead of \textsc{Brox}, Hans: BGB~AT, S.~23. + +\item[authorformat=allreversed] By this option, the behavior mentioned + in the previous option works also in the bibliography. + +\item[authorformat=firstnotreversed] Sometimes, strange requirements + are set on authors. Therefore, this option exists, which puts all + authors in \meta{Firstname} \meta{Lastname}, \emph{apart from the + first author}: \textsc{Kodal}, Kurt\slash Joachim \textsc{Kr{\"a}mer}\slash Hans \textsc{Mustermann}. + +\item[authorformat=reducedifibidem] If this option is active together + with \texttt{ibidem=name} only the last name of the author is shown + in recurring citations. + +\item[authorformat=and] Instead of the default slashes + the authors will be separated by ``,'' and ``, and''. + +\item[authorformat=year] The year will appear after the author name. \cs{jbyearaftertitle} puts the year after the title. + Formatting is possible by using \cs{jbcitationyearformat}: + \begin{verbatim} + \renewcommand{\jbcitationyearformat}[1]{(#1)} + \end{verbatim} + +\item[authorformat=indexed] All authors (independently) are indexed. + You have to use the \textsf{makeidx}-package correctly: + \begin{verbatim} + \usepackage{jurabib} % load before makeidx.sty! + \usepackage{makeidx} + \makeindex + \begin{document} + ... + \printindex + \end{document} + \end{verbatim} + This options works for |\nobibliography| too (since 0.51). + + If you want to have not cited authors (e.g. by using \cs{nocite}) indexed, you can use + \cs{jbindexbib} in your preamble. + + To emphasize the authors in the \NEW{0.52} index, you can determine the font of the indexed authors via |\jbauthorindexfont|: + \begin{verbatim} + \renewcommand{\jbauthorindexfont}{\textit}% or \textsf, + % \textsc, + % \textbf + \end{verbatim} + If you are using a non-standard |.ist| file (|makeindex| style file), it is possible + that you have to use |\jbmakeindexactual| to use the correct `actual' operator. The default is |@|. + If your |.ist| file contains + \begin{verbatim} + actual '=' + \end{verbatim} + you should use: + \begin{verbatim} + \renewcommand{\jbmakeindexactual}{\=}% + \end{verbatim} +% I don't know why the backslash is necessary. + +An often requested feature was \NEW{0.6} to provide some macros to tune the indexing of authors and editors. +Here it is, these commands should be used in the preamble as usual: + +{\small\begin{tabular}{ll} +\hline +|\jbdonotindexeditors| & Do not index editors\\ +|\jbdonotindexauthors| & Do not index authors\\ +|\jbdonotindexorganizations| & Do not index organizations\\ +|\jbindexolyfirsteditors| & Do index editors only for first citation\\ +|\jbindexonlyfirstauthors| & Do index authors only for first citation\\ +|\jbindexolyfirstorganizations| & Do index organizations only for first citation\\ +\hline +\end{tabular}} + +\medskip + +\item[authorformat=abbrv] Since version 0.5 the \BibTeX-styles + \texttt{jurplain.bst} and \texttt{jurabbrv.bst} + are obsolete, the abbreviated form can be determined by using this option. + +\item[annotatorformat=italic (formerly known as: coauthorformat=italic)] Puts the annotator in italics: Kodal\slash Kr{\"a}mer\slash \textit{Bassenge}. + +\item[annotatorformat=normal (formerly known as: coauthorformat=normal)] Puts the annotator upright: + \textit{Kodal}\slash \textit{Kr{\"a}mer}\slash Bassenge. + +\item[round] Round brackets around (non-footnote-) citation: + (\textsc{Kodal}\slash \textsc{Kr{\"a}mer}). + +\item[square] Square brackets around (non-footnote-) citation: + [\textsc{Kodal}\slash \textsc{Kr{\"a}mer}]. + +\item[superscriptedition=all] Places a superscripted edition number in the citation. + Some examples: + \par + Kodal/Kr{\"a}mer$^{3}$, \S~12.\\ + Kodal/Kr{\"a}mer, Stra"senrecht$^{3}$, \S~12.\\ + Kodal/Kr{\"a}mer$^{3}$--Bassenge, \S~12.\\ + Kodal/Kr{\"a}mer--Bassenge, Stra\ss{}enrecht$^{3}$, \S~12.\\ + Bassenge in Kodal/Kr{\"a}mer$^{3}$, \S~12. + \par\medskip + +\item[superscriptedition=commented] Same like above, but only for \texttt{@COMMENTED}. + +\item[superscriptedition=switch] With the new field \texttt{ssedition} you can specify + the appearence of the superscripted edition number explicitly: + \begin{verbatim} + @COMMENTED{soergel, + author = {Hans Theodor Soergel}, + title = {Kommentar zum B{\"u}rgerlichen Gesetzbuch}, + address = {Stuttgart, Berlin, K{\"o}ln, Mainz}, + year = 1987, + edition = 12, + ssedition = 1, <=== ! + } + \end{verbatim} + +\item[superscriptedition=kerning] This option\NEW{0.51h} replaces the command |\jbsseditionkerned| and does some kerning: + +Kodal/Kr{\"a}mer$^{3}$\kern-1ex, \S~12.\\ +Kodal/Kr{\"a}mer, Stra{\ss}enrecht$^{3}$\kern-1ex, \S~12.\\ +Kodal/Kr{\"a}mer$^{3}$--Bassenge, \S~12.\\ +Kodal/Kr{\"a}mer--Bassenge, Stra{\ss}enrecht$^{3}$\kern-1ex, \S~12.\\ +Bassenge in Kodal/Kr{\"a}mer$^{3}$\kern-1ex, \S~12. +\par\medskip +\item[superscriptedition=bib/address] superscripted edition numbers \CH{0.51j} in the bibliography (before address). +\item[superscriptedition=year] superscripted edition numbers \NEW{0.51j} in the bibliography (before year). +\item[superscriptedition=multiple] This option enables \NEW{0.51h} the output of a superscripted edition number +for the case that different editions of the same work were cited. The output of the shorttitle is suppressed. +\end{Options} + +If a coauthor was given via the second optional argument, the superscripted edition number +appears after the coauthor, as long as you are using the default or one of the |annotatorlastsep| options: + +\medskip + +Kodal/Kr{\"a}mer--Bassenge$^{3}$, \S~12. + +\medskip + +If you like to have the superscripted number immediately after the author, please use the +following command in the preamble of your document: + +\begin{verbatim} + \jbsuperscripteditionafterauthor +\end{verbatim} + +Should result in: + +\medskip + +Kodal/Kr{\"a}mer$^{3}$--Bassenge, \S~12. + +\begin{Options} +\item[biblikecite] Bibliography will be automatically formatted like the citations (as far as possible\,!). +\item[edby] (Only for \texttt{@INCOLLECTION}!) The sequence ``Lipcoll, David~J. (ed.)'' will be changed + to ``edited by Lipcoll, David~J.''\par +For redefinitions please use: + \begin{verbatim} + \AddTo\bibsgerman{% + \def\edbyname{ed. by}% + } + \end{verbatim} +\item[endnote] The \texttt{note} field appears at the end of the bibliographic entry, and if you are using +|dotafter=bibentry|, \emph{after} the closing period. +\end{Options} + +\DescribeMacro{\jbauthorfont} +\DescribeMacro{\jbcoauthorfont} + If these options do not generate the desired result, one can realize + many things by redefining several commands. + +The formats of the authors and annotators are directed by the commands + \cs{jbauthorfont} and \cs{jbcoauthorfont} and may be modified in the + following way (these examples presuppose the default values): +\begin{verbatim} + \renewcommand{\jbauthorfont}{\textit} + \renewcommand{\jbcoauthorfont}{\textsl} +\end{verbatim} + +\DescribeMacro{\jbactualauthorfont} \DescribeMacro{\jbauthorfontifcoauthor} +Analogically, the following commands exist \emph{only} if option +\texttt{authorformat=dynamic} is active: +\begin{verbatim} + \renewcommand{\jbactualauthorfont}{\textsc} + \renewcommand{\jbauthorfontifcoauthor}{\textsl} +\end{verbatim} + +These redefinitions should be placed in the preamble of the \TeX-file, i.e. +before \cs{begin}\verb+{document}+. One should notice that \cs{text} commands +should be used, for example, \cs{textit}, \cs{textbf} etc.), and \emph{not} +those starting with \texttt{series}, \texttt{family} or ending with +\texttt{shape} (declaration form, for instance, \cs{bfseries}, \cs{slshape}, +\cs{sffamily})! + +\subsubsection{Title Format} + +\begin{Options} +\item[titleformat=italic] Puts title in italics: Kodal\slash + Kr{\"a}mer\slash Bassenge, \textit{StrR}, \S~12. + +\item[titleformat=all] Provides short titles in \emph{all} cases, + regardless whether an author has been cited with multiple works. + +\item[titleformat=colonsep] Separates author and title by a colon + (only if a title is displayed): + Kodal\slash Kr{\"a}mer\slash Bassenge: StrR, \S~12. + +\item[titleformat=commasep] Separates author and title by a comma: + Kodal\slash Kr{\"a}mer\slash Bassenge, StrR, \S~12. + +\item[titleformat=noreplace] You can disable globally the + default replacement of the missing \texttt{shorttitle} by \texttt{title}. + See also the \cs{cite*}- and \cs{nextcitenotitle} commands. +\end{Options} + +\DescribeMacro{\jbtitlefont} For changing the format of the short title, the +command \cs{jbtitlefont} is available, which may be tweaked analogically: + +\begin{verbatim} + \renewcommand{\jbtitlefont}{\textit} +\end{verbatim} + +\DescribeMacro{\jbhowsepbeforetitle} For options \texttt{titleformat=commasep} +and \texttt{titleformat=colonsep} is specific formatting of the separation +marks possible by: +\begin{verbatim} + \renewcommand{\jbhowsepbeforetitle}{; } . +\end{verbatim} + +One of both options mentioned above should be active in this case. + +\subsubsection{Separation of the annotator} + +As explained above, the format of the annotator after the author(s) and the +separation by a slash have been set by default. These may be modified by +options. + +\begin{Options} +\item[annotatorlastsep=divis (formerly known as: colastsep=divis)] This option changes the slash as separation + mark to an (en)-dash: Kodal\slash Kr{\"a}mer--Bassenge StrR, \S~12. + +\item[annotatorfirstsep=in (formerly known as: cofirstsep=in)] The annotator appears first in the citation, + followed by `` in ''\,: Bassenge in Kodal\slash Kr{\"a}mer + StrR, \S~12. + +\item[annotatorfirstsep=comma (formerly known as: cofirstsep=comma)] This option works like \texttt{annotatorfirstsep=in}, + but `` in '' is now replaced by a comma: Bassenge, + Kodal\slash Kr{\"a}mer StrR, \S~12. +\end{Options} + +\subsubsection{Behaviour in Recurring Citations} + + \begin{Options} + \item[ibidem or ibidem=strict] If an author is cited several times + after each other, it may be useful to replace the short citation by + the shorthand ``ibid.'' \emph{The use of this shorthand is not + accepted by everyone because it does not improve readability of + the text.} In this respect, \textsf{jurabib} has been configured + in such a way that `ibid' will be displayed only if the recurrence + immediately follows the previous citation, and the recurring + citation is not the first on the actual page (see the examples). + By contrast, in the humanities the use of ``ibid.'' is often compulsory: + it can be an error to repeat a citation in full. Because of this fact, + \texttt{ibidem=strict} is the default for the humanities. + +\item[ibidem=nostrict] If one wants to suppress the settings mentioned + above, one could use this option, which allows the shorthand be + placed as the first on a page. One should be careful with this + option. It is useful only if one uses basically one author in the + document, so that it is clear to whom one refers. + +\item[ibidem=strictdoublepage] Granted, this option is of an academic + nature, because it quite carefully sorts out whether an first + citation or short citation occurs on the facing page of the + recurring citation.(Many thanks to \textsc{Stefan \mbox{Ulrich}}) If + so, ibidem is allowed as first citation on the page. If not, short + citation is used for recurring citations. Of course, this is useful + only when two-side printing is concerned, i.e. if the + \texttt{book}-class is used or the class option + \texttt{twoside}. Compare the following survey: +\end{Options}% + +\begin{center} +\noindent{\small +\begin{tabular}{@{}llll@{}}\hline\\[-2ex] +{\footnotesize\cs{footcite}|..|}& {\footnotesize|ibidem|/|ibidem=strict|}& +{\footnotesize|ibidem=strictdoublepage|} & +{\footnotesize|ibidem=nostrict|}\\\hline\\[-2ex] +|..[\S~12]{erm}| & $^{1}$\textsc{Erman}, \S~12. & $^{1}$\textsc{Erman}, \S~12. & $^{1}$\textsc{Erman}, \S~12.\\ +|..[\S~12]{erm}| & $^{2}$ibid. & $^{2}$ibid. & $^{2}$ibid.\\ +|..[\S~20]{erm}| & $^{3}$ibid., \S~20. & $^{3}$ibid., \S~20. & $^{3}$ibid., \S~20.\\ +|..{mueko}| & $^{4}$\textsc{M{\"u}Ko}. & $^{4}$\textsc{M{\"u}Ko}. & $^{4}$\textsc{M{\"u}Ko}.\\ +|..[\S~12]{erm}| & $^{5}$\textsc{Erman}, \S~12. & $^{5}$\textsc{Erman}, \S~12. & $^{5}$\textsc{Erman}, \S~12.\\ +|..[\S~12]{erm}| & $^{6}$ibid. & $^{6}$ibid. & $^{6}$ibid.\\[.8ex] +\multicolumn{4}{@{}c@{}}{\emph{Pagebreak from odd (right) to even (left)}}\\[1.6ex] +|..[\S~12]{erm}| & $^{7}$\textsc{Erman}, \S~12. & $^{7}$\textsc{Erman}, \S~12. $\longleftarrow$ \textsf{!!!} & $^{7}$ibid. $\longleftarrow$ \textsf{!!!}\\ +|..[\S~12]{erm}| & $^{8}$ibid. & $^{8}$ibid. & $^{8}$ibid.\\[.8ex] +\multicolumn{4}{@{}c@{}}{\emph{Pagebreak from even (left) to odd (right)}}\\[1.6ex] +|..[\S~12]{erm}| & $^{9}$\textsc{Erman}, \S~12. & $^{9}$ibid. $\longleftarrow$ \textsf{!!!} & $^{9}$ibid. $\longleftarrow$ \textsf{!!!}\\ +|..[\S~12]{erm}| & $^{10}$ibid. & $^{10}$ibid. & $^{10}$ibid.\\ +\hline +\end{tabular}} +\end{center} + +\DescribeMacro{\noibidem} Disables the \texttt{ibidem}-mechanism for the next +(\emph{and only for the next\,!}) citation. + +\subsubsection{Remaining Options} + +\begin{Options} +\item[commabeforerest] If active, a comma will be placed before page + ranges, margin numbers or the like: Kodal\slash + Kr{\"a}mer\slash Bassenge: StrR, \S~12. +\item[silent (formerly known as: \cs{jbsilent})] Suppresses all \textsf{jurabib} warnings. +\end{Options} + +\subsection{Tweaking the Format of the Bibliography} + +\subsubsection{Font Commands} + +\DescribeMacro{\biblnfont} +\DescribeMacro{\bibelnfont} +\DescribeMacro{\bibfnfont} +\DescribeMacro{\bibefnfont} +\DescribeMacro{\bibtfont} +\DescribeMacro{\bibbtfont} +\DescribeMacro{\bibjtfont} +\DescribeMacro{\bibapifont} +\DescribeMacro{\bibsnfont} + The possibilities for formatting are limited to the + modification of font formats of particular parts of entries in the + bibliography. For this purpose, the following commands are + available. \cs{biblnfont}, for formatting the last name of the + author and \cs{bibelnfont} for the last name of the editor. \cs{bibfnfont}, for formatting the first name of + author and \cs{bibefnfont} for the first name of editor. \cs{bibtfont}, for modification of the title of + books etc. \cs{bibbtfont}, for formatting the title of collections + of essays. \cs{bibjtfont}, for formatting the title of the journal + in article entries. With \cs{bibsnfont} you can determine the appearence of the series name. + +Additionally available are \cs{bibapifont}, for formatting the title of an +article or essay in a collection. This command is active for the entry types +\texttt{@ARTICLE}, \texttt{@PERIODICAL} and \texttt{@INCOLLECTION}. The default +format reflects the following definitions: + +\begin{verbatim} + \renewcommand{\biblnfont}{\bfseries} + \renewcommand{\bibfnfont}{\bfseries} + \renewcommand{\bibtfont}{} + \renewcommand{\bibbtfont}{} + \renewcommand{\bibjtfont}{} + \renewcommand{\bibapifont}{} +\end{verbatim} +Modification is possible analogically to the examples shown above. You should +notice here, too, that commands should be used which start with \cs{text} (Font +switch commands with arguments, for instance, \cs{textit}, \cs{textbf} etc.), +and \emph{not} those starting with \texttt{series}, \texttt{family} or ending +with \texttt{shape} (declaration form, for instance, \cs{bfseries}, +\cs{slshape}, \cs{sffamily})! + +\subsubsection{Options for the Bibliography} + + \begin{Options} + \item[bibformat=nohang] Hereby, the default indent of the second and + following lines in a bibliography entry will be suppressed. +\noindent If one wants to set the indent to a certain length, one should put +the following in the preamble of one's document: +\begin{verbatim} + \setlength{\jbbibhang}{1.5em} +\end{verbatim} + +An indent of 2.5\,em is the default. + \item[bibformat=tabular] In this case, the bibliography will be + displayed in two-column tabular form. The authors appear in the + left column, and the remainder of the entry in the right column. The + width of the columns may be customized by the following commands + (the values indicated are the defaults): +\begin{verbatim} + \renewcommand{\bibleftcolumn}{\textwidth/3} + \renewcommand{\bibrightcolumn}{\textwidth-\bibleftcolumn-1cm} +\end{verbatim} +Modification of the alignment within the columns is also possible by redefining +the following (defaults are displayed): +\begin{verbatim} + \renewcommand{\bibleftcolumnadjust}{\raggedright} + \renewcommand{\bibrightcolumnadjust}{\raggedright} +\end{verbatim} + For better hyphenation, use of the package \mbox{\textsf{ragged2e.sty}} is \emph{highly} recommended: + \begin{verbatim} + \usepackage{ragged2e} + \end{verbatim} + Loading the package \textsf{ragged2e} is sufficient. Redefinition of the necessary commands is + handled automatically. +\item[bibformat=numbered] This option results in a numbered bibliography. The format of the number can be determined by redefining |\bibnumberformat|: +\begin{verbatim} + \renewcommand{\bibnumberformat}[1]{(#1)} +\end{verbatim} +\item[bibformat=ibidem] Replaces recurring authors name(s) by a dash (or whatever you want), + if multiple works of the author appearing in the bibliography. \textsf{jurabib} is built in such a way, + that the replacement is suppressed, when a recurring entry lies on top of a page. Note that + it may be necessary to do several (up to four or more\,!) \LaTeX-runs to make this mechanism work. + + Modifications can be done by using (only an example\,!): +\begin{verbatim} + \renewcommand{\bibauthormultiple}{The same} +\end{verbatim} +\item[lookforgender] Uses the |gender|-field given in the |.bib| file.With these field you are able to determine gender-specific abbreviations while using |bibformat=ibidem|. Following abbreviations are defined: +\end{Options} +\noindent{\footnotesize + \begin{tabular}{@{}llllll@{}} + \hline\\[-2ex] + Abbrv. & Meaning & Citation & Defined by: & Bibliography & Defined by:\\ + \hline\\[-2ex] + |sf| & single female & Idem/idem & |\idem[S,s]fname| & Idem/idem & |\bibidem[S,s]fname|\\ + |sm| & single male & Idem/idem & |\idem[S,s]mname| & Idem/idem & |\bibidem[S,s]mname|\\ + |pf| & plural female & Idem/idem & |\idem[P,p]fname| & Idem/idem & |\bibidem[P,p]fname|\\ + |pm| & plural male & Idem/idem & |\idem[P,p]mname| & Idem/idem & |\bibidem[P,p]mname|\\ + |sn| & single neutrum & Idem/idem & |\idem[S,s]nname| & Idem/idem & |\bibidem[S,s]nname|\\ + |pn| & plural neutrum & Idem/idem & |\idem[P,p]nname| & Idem/idem & |\bibidem[P,p]nname|\\ + \hline\\[-2ex] + \end{tabular}} + +\medskip + +\noindent If you want to redefine the idem replacement for a single women author: +\begin{verbatim} + \AddTo\bibsenglish{% + \renewcommand\idemSfname{Eadem}% + \renewcommand\idemsfname{eadem}% + \renewcommand\bibidemSfname{Eadem}% + \renewcommand\bibidemsfname{eadem}% + } +\end{verbatim} + + +\begin{Options} +\item[bibformat=ibidemalt] An alternative format of the bibliography, especially for German law students. +\item[bibformat=compress] The bibliography will be printed more compact, i.\,e. the vertical space between the items will be reduced. +\item[bibformat=raggedright] The bibliography will be printed with right ragged margin. The use is recommended especially + when using |bibformat=tabular| too or when you are using a small textwidth. +\item[annote] The content of the |annote| field will be printed (only for the bibliography\,!). + It is possible -- similar to \textsf{natbib}~-- to leave the |annote| field empty + and let \textsf{jurabib} \NEW{0.51s} use an annote file instead. This file will be used + if it is named like the database entry key with |.tex| extension. + Nothing will be printed out, if |annote| field is empty and no annote file exists. + +\DescribeMacro{\bibAnnotePath} + With |\bibAnnotePath| you can specify a path to annote files. + The syntax is the same as for |\graphicspath|: |\bibAnnotePath{{annotes/}}| + uses the annote files from subdirectory |annotes| of the current directory. +\item[super] will convert all\NEW{0.6} |\cite| commands into |\footcite|'s, +\item[config=\meta{file}] you are able to use \NEW{0.6} several |.cfg| files. This option will load the named file. Please do not add the extension |.cfg|\,! +\item[dotafter=bibentry (formerly known as: \cs{jbdotafterbibentry})] places a dot at the end of each entry in the bibliography. +\item[dotafter=endnote (formerly known as: \cs{jbdotafterendnote})] places a dot at the end of each endnote (if you are using \textsf{endnotes.sty}). +\end{Options} + +\subsubsection{Further Possibilities for Customisation} + +\DescribeMacro{\bibbtsep} \DescribeMacro{\bibjtsep} Because of usually +different opinions about what citations should look like, the commands +\cs{bibbtsep} and \cs{bibjtsep} are available. They function as +``\textbf{b}ook\textbf{t}itle \textbf{sep}aration'' and +``\textbf{j}ournal\textbf{t}itle \textbf{sep}aration''. +\begin{bibexample} +\item \textbf{Brinkmann, Franz~Josef:} Der Zugang der + Willenserkl{\"a}rungen, M{\"u}nsterische Beitr{\"a}ge zur Rechtswissenschaft, + Bd.~3 Berlin, 1984 +\end{bibexample} +If one, for instance, wants ``in~'' preceding book titles or journal titles, +then, the following redefenitions are required: +\begin{verbatim} + \renewcommand{\bibbtsep}{in } + \renewcommand{\bibjtsep}{in } +\end{verbatim} + +After redefinition, the following comes out: +\begin{bibexample} +\item \textbf{Brinkmann, Franz~Josef:} Der Zugang der Willenserkl{\"a}rungen, in M{\"u}nsterische +Beitr{\"a}ge zur Rechtswissenschaft, Bd.~3 Berlin, 1984 +\end{bibexample} + +\DescribeMacro{\bibansep} \DescribeMacro{\bibatsep} \DescribeMacro{\bibbdsep} +The separation marks between authors, titles and between address and +month\slash\ year are a matter of discussion. This problem is countered by the +commands \cs{bibansep} (\textbf{a}fter \textbf{n}ame \textbf{sep}aration), +\cs{bibatsep} (\textbf{a}fter \textbf{t}itle \textbf{sep}aration) and +\cs{bibbdsep} (\textbf{b}efore \textbf{d}ate \textbf{sep}aration). + +If one, for instance, wants no colon after the author's name, a period after +the title and no comma between address and year, one could accomplish this by +the following redefinitions: +\begin{verbatim} + \renewcommand{\bibansep}{} + \renewcommand{\bibatsep}{.} + \renewcommand{\bibbdsep}{} +\end{verbatim} + +The result is as follows: +\begin{bibexample} +\item \textbf{Brinkmann, Franz~Josef} Der Zugang der + Willenserkl{\"a}rungen. M{\"u}nsterische Beitr{\"a}ge zur Rechtswissenschaft, + Bd.~3 Berlin 1984 +\end{bibexample} + +\subsubsection{Cited as \ldots} + +\DescribeMacro{howcited=normal} \DescribeMacro{howcited=multiple} +\DescribeMacro{howcited=compare} \DescribeMacro{howcited=all} The +\texttt{howcited}-options put (under certain conditions) a commentary behind +selected entries, which indicates how the work has been cited in the text. The +commentary changes dynamically, just as we know that from the citation itself, +i.e. the form in the bibliography always reflects the \emph{final} form of the +citation in the text. In case of article and periodical citations, the default +is that no indication of the way of citation is given---this is the default for +all \texttt{howcited}-options---except of \texttt{howcited=all}---because the +way of citation is in these cases always author's name and journal +title.\footnote{Special thanks to \textsc{Christian Meyn} for this suggestion.} + +If you want to have the howcited-remark for articles and periodicals too: +\begin{verbatim} + \makeatletter + \jb@allow@howcited@art@periodtrue + \makeatother +\end{verbatim} +These options can be enabled in the following way: + +\begin{Options} +\item[howcited=normal]\DescribeMacro{howcited=} + The option \texttt{howcited=normal} displays the remark + ``(cited: \meta{author})'', if in the \texttt{.bib}-file the + field \texttt{howcited} has been specified.\footnote{By this option, + one can avoid unwanted automation of howcited remarks which may occur + when using the option \texttt{howcited=compare}. Thus, it is possible + to specify for each work whether it should have a howcited remark and + if it must have, what it should look like.} + + Two possibilities exist for utilizing this field. The field functions as a switch when putting + \texttt{1} in the field. This results in displaying the original citation from the text in the + bibliography. An example: + \begin{verbatim} + @BOOK{enne:nipp, + author = {Ludwig Enneccerus and Hans Carl Nipperdey}, + title = {Allgemeiner Teil des B{\"u}rgerlichen Rechts}, + year = 1960, + volume = 1, + address = {T{\"u}bingen}, + edition = 15, + howcited = 1 + } + \end{verbatim} + Displays the following (use of \cs{[foot]cite} presupposed): + \begin{bibexample} + \item \textbf{Enneccerus, Ludwig\slash Nipperdey, Hans~Carl:} + Allgemeiner Teil des B{\"u}rgerlichen Rechts. Bd.~1, 15.~Auf\/lage, + T{\"u}bingen 1960 (cited: Eneccerus\slash Nipperdey) + \end{bibexample} + In case you want to let the howcited remark differ from the original citation, then, you should + simply put in the field what you want to be displayed. An example: + \begin{verbatim} + @BOOK{enne:nipp, + author = {Ludwig Enneccerus and Hans Carl Nipperdey}, + title = {Allgemeiner Teil des B{\"u}rgerlichen Rechts}, + year = 1960, + volume = 1, + volumetitle = {zweiter Halbband}, + address = {T{\"u}bingen}, + edition = {15.}, + howcited = {Enneccerus/Nipperdey, B{\"u}rgerliches Recht} + } + \end{verbatim} + Shows: + \begin{bibexample} + \item \textbf{Enneccerus, Ludwig\slash Nipperdey, Hans~Carl:} + Allgemeiner Teil des B{\"u}rgerlichen Rechts. Bd.~1, zweiter Halbband, 15.~Auf\/lage, + T{\"u}bingen 1960 (cited: Enneccerus\slash Nipperdey, B{\"u}rgerliches Recht) + \end{bibexample} + In order to ensure consequent layout when using options which affect font format of author's + names, one could insert fontcommands in the field. + +\item[howcited=compare]\DescribeMacro{howcited=compare} + Displays the additional ``(cited: \meta{author})'' only, + \emph{if an entry contains the field \texttt{shorttitle}}, \emph{and} the information in this field + differs from that specified in \texttt{title}. The field \texttt{howcited} in the + \texttt{.bib}-file will now be ignored. Decisive for displaying the remark is now only the + difference between \texttt{shorttitle} and \texttt{title}\,! That is the case in the following + example, cited with \cs{[foot]citetitle}: + \begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Kr{\"a}mer}, + title = {Stra{\ss}enrecht}, + shorttitle = {StrR}, + year = 1995, + address = {M{\"u}nchen}, + edition = {5.}, + pages = {S.\,30--34, \S~24} + } + \end{verbatim} + \begin{bibexample} + \item \textbf{Kodal, K.\slash Kr{\"a}mer, J.:} Stra\ss{}enrecht, 5.~Auf\/lage M{\"u}nchen, 1995 + (cited: Kodal\slash Kr{\"a}mer, StrR) + \end{bibexample} + +\item[howcited=multiple]\DescribeMacro{howcited=multiple} + This option places ``(cited: \meta{author})'', + if more than one work of an author is cited. There is an exception for commentaries by + default (the remark will be displayed always), but this could be changed + (\cs{jb@@arg}$=$\texttt{1}, if more than one work of the same author is cited): + \begin{verbatim} + \makeatletter + \renewcommand{\jb@make@howcited@multiple}{% + \jb@suppress@dot@for@howcitedtrue + \ifthenelse{\equal{\jb@@arg}{1}}{% + \jb@make@howcited + \jb@make@comment@howcited + \jb@make@artperiod@howcited + }{% + \let\bibhowcited\@empty + \let\bibcommenthowcited\@empty + \let\bibartperiodhowcited\@empty + }% + }% + \makeatother + \end{verbatim} + \item[howcited=all]\DescribeMacro{howcited=all} + The \texttt{howcited}-remark appears for all entries. +\end{Options} + +The default for the remark is ``(cited: \meta{author})''. Customization is +possible by the following commands: +\begin{verbatim} + \newcommand*{\bibhowcitedprefix}{-- as } + \newcommand*{\bibhowcitedsuffix}{ cited.} +\end{verbatim} + +Notice the spaces used. This results in: +\begin{bibexample} +\item \textbf{Kodal, K.\slash Kr{\"a}mer, J.:} Stra\ss{}enrecht, 5.~Auf\/lage M{\"u}nchen, 1995 +---as Kodal\slash Kr{\"a}mer, StrR cited. +\end{bibexample} +If you want to put something in the bibliography, but it has not been cited in +the text, you can use command \cs{nocite}: +\begin{verbatim} + \nocite{kkstrr} +\end{verbatim} + +Or, in order to put \emph{all} works which are not cited in the bibliography: +\begin{verbatim} + \nocite{*} +\end{verbatim} + +Then, the commentary contains the actual meaning of the command +\cs{bibnotcited}. This command is empty by default. It might easily be modified +by: +\begin{verbatim} + \renewcommand{\bibnotcited}{(not cited)} +\end{verbatim} + +Shows the following: +\begin{bibexample} +\item \textbf{Kodal, K.\slash Kr{\"a}mer, J.:} Stra\ss{}enrecht, 5.~Auf\/lage M{\"u}nchen, 1995 (not cited) +\end{bibexample} + +Of course, for this to happen, one of the two option \texttt{howcited=normal} +or \texttt{howcited=compare} should be active. + +Now \NEW{0.51} all useful combinations of |howcited| options are possible. + +Remark: using these options without using the option \texttt{citefull=all} or +for some citations the command \cs{[foot]citetitle}, seems not useful. + + +\subsubsection{More Entry Fields and Types} + +\DescribeMacro{url =} Although citing the World Wide Web is not widely +practised in law studies, I nevertheless added an extra field \texttt{url}. + +\DescribeMacro{urldate =} A field \texttt{urldate} is available, which enables one to specify the date on which +one visited the link which has been specified in \texttt{url}. The default for +this command is ``visited on '' and may be customized by redefining: +\begin{verbatim} + \AddTo\bibsenglish{\renewcommand*{\urldatecomment}{accessed on }} . +\end{verbatim} +The separation between URL and |\urldatecomment| is configurable and represented by |\bibbudcsep|. +It is defined as "` -- "' by default. + +\DescribeMacro{\biburlprefix} \DescribeMacro{\biburlsuffix} +\DescribeMacro{\biburlfont} One can customize the format of the +\texttt{url}-field in two ways. On + the one hand, by modifying \cs{biburlprefix}, which inserts the + prefix ``URL:'' before the link. On the other hand, by modifying + the command \cs{biburlfont}, which specifies the font format of the + link. Defaults are: + +\begin{verbatim} + \renewcommand*{\biburlprefix}{\jblangle{}URL:} + \renewcommand*{\biburlsuffix}{\jbrangle{}} +\end{verbatim} + +Customisation is analog to the other commands by using \cs{renewcommand}. In +order to properly break URLs and properly display characters like \verb+~+ and +\verb+_+, \textsf{jurabib} is loading the \textsf{url}-package. +The |\biburlfont| command was changed in version \CH{0.51}0.51. You can modify the url font +with the following syntax (only these four values are possible\,!) +\begin{verbatim} + \biburlfont{tt} % typewriter + \biburlfont{rm} % roman + \biburlfont{sf} % sans serif + \biburlfont{same} % same as text +\end{verbatim} + +\DescribeMacro{@WWW} +New entry type for URL's. Required is only +\texttt{url}, optional are \texttt{urldate}, \texttt{author}, and +\texttt{title}. + +\DescribeMacro{@PERIODICAL} After a suggestion by \textsc{Andreas Stefanski}, +I've added a new entry type \texttt{@PERIODICAL} for periodicals which are not +cited by year, but by volume number. This entry type satisfies the requirement +to put the year between square brackets. Additionally, the specification of the +volume is possible: +\begin{verbatim} + @PERIODICAL{oellers, + author = {Bernd Oellers}, + title = {Doppelwirkung im Recht?}, + journal = {AcP}, + year = 1969, + volume = 169, + pages = {S.\,67ff} + } +\end{verbatim} + +This shows the following: +\begin{bibexample} +\item \textbf{Oellers, Bernd:} Doppelwirkung im Recht? AcP 169 [1969], S.\,67ff +\end{bibexample} + +\DescribeMacro{\bibpldelim} \DescribeMacro{\bibprdelim} Changing the format of +the brackets is possible by redefining the commands \cs{bibpldelim} +(\textbf{p}eriodical \textbf{l}eft \textbf{delim}iter) and \cs{bibprdelim} +(\textbf{p}eriodical \textbf{r}ight \textbf{delim}iter): +\begin{verbatim} + \renewcommand{\bibpldelim}{(} + \renewcommand{\bibprdelim}{)} +\end{verbatim} + +\begin{bibexample} +\item \textbf{Oellers, Bernd:} Doppelwirkung im Recht? AcP 169 (1969), S.\,67ff +\end{bibexample} + +\DescribeMacro{@COMMENTED} By definition of the entry type \texttt{@COMMENTED} +it is possible to cite commentaries as such. In connection with the option +\texttt{howcited=normal} (cited as \meta{author}\slash annotator) or (cited as +annotator in \meta{author}) appears at the end of the bibliography entry. + +\begin{bibexample} +\item \textbf{M{\"u}nchener Kommentar:} Kommentar zum B{\"u}rgerlichen Gesetzbuch, Bd.~2, +\mbox{--~Schuldrecht~--} Allgemeiner Teil, 3.~Auf\/lage, M{\"u}nchen, 1994, +\S\kern-.8pt\S~241--432 (cited: M{\"u}Ko\slash annotator) +\end{bibexample} + +\DescribeMacro{updated =} This new field \NEW{0.51e} will be recognized while using |@COMMENTED| +to give the date of last update. +\begin{bibexample} +\item \textbf{M"unchener Kommentar:} Kommentar zum B"urgerlichen Gesetzbuch, Bd.~2, +\mbox{--~Schuldrecht~--} Allgemeiner Teil, 3rd edition, M"unchen, last update: May~1994 +\end{bibexample} +|updated| does not overwrite the |year| field\,! The separation from the +|address|\slash|publisher|/|year| block is done by the |\updatesep| macro, which is +defined as comma by default. +In front of the content of the |updated| field appears ``last update''. This is configurable via |\updatename|. +\begin{verbatim} + \AddTo\bibsenglish{% + \def\updatesep{.} + \def\updatename{updated:} + } +\end{verbatim} + +If one doesn't use this entry type, although the entry is a commentary, (cited +as \meta{author} appears, which is incorrect, because the actual citation looks +different. Those who do not use the option \texttt{howcited=normal} cannot +avoid using the entry type \texttt{@COMMENTED}. + +\DescribeMacro{volumetitle} By the field \texttt{volumetitle} it is possible +to specify a volume title which appears after the volume number. This field is +available for the entry types \texttt{@COMMENTED}, \texttt{@BOOK}, +\texttt{@INBOOK} and \texttt{@INCOLLECTION}. + +\DescribeMacro{titleaddon =} + This field can be used to place a commentary, a note, some remarks about translators, coauthors etc. after the title. +\begin{verbatim} + @COMMENTED{mueko, + [...] + title = {Kommentar zum B{\"u}rgerlichen Gesetzbuch}, + titleaddon = {Unter Mitarbeit von Hans Mustermann}, + [...] + } +\end{verbatim} +shows us: +\begin{bibexample} + \item \textbf{M{\"u}nchener Kommentar:} Kommentar zum B{\"u}rgerlichen Gesetzbuch, Unter Mitarbeit von Hans Mustermann, Bd.~2, + \mbox{--~Schuldrecht~--} Allgemeiner Teil, 3.~Auflage, M{\"u}nchen, 1994, \S\kern-.8pt\S~241--432 +\end{bibexample} + +\DescribeMacro{booktitleaddon =} + The same as |titleaddon| for booktitles in |@INCOLLECTION|'s. + +\DescribeMacro{editortype =} + If you want to place something other than ``(eds.)'' after a person, which isn't + really an editor, you can use the field |editortype|: +\begin{verbatim} + @COMMENTED{palandt, + editor = {Otto Palandt}, + editortype = {Begr.}, + title = {B{\"u}rgerliches Gesetzbuch mit Einf{\"u}hrungsgesetz [...]}, + [...] + } +\end{verbatim} +\begin{bibexample} + \item \textbf{Palandt, Otto (Begr.):} B{\"u}rgerliches Gesetzbuch mit Einf{\"u}hrungsgesetz [...], + 59.~Auflage, M{\"u}nchen, 2000 +\end{bibexample} + This works for |@INCOLLECTION| too. +\par\medskip\par +\DescribeMacro{sortkey =} + It seems to be required sometimes to determine the sorting of some works different from the normal sorting algorithm. + This problem can be solved with the |sortkey| field, which can be used to sort the work with highest priority -- contrary to + the standard |key| field, which is mostly a fallback if |author| and |editor| are missing. + +\DescribeMacro{annote =} + Some people wrote me they would need the |annote| field to give a short abstract or something similar at the end of the bibliographic entry. + This is working now. You are able to switch this feature on and off by using the |annote| option in the preamble or in your local |jurabib.cfg| file. +\begin{verbatim} + @COMMENTED{palandt, + editor = {Otto Palandt}, + title = {B{\"u}rgerliches Gesetzbuch mit Einf{\"u}hrungsgesetz [...]}, + annote = {Some people wrote me they ...}, + [...] + } +\end{verbatim} +\begin{bibexample} + \item \textbf{Palandt, Otto:} B{\"u}rgerliches Gesetzbuch mit Einf{\"u}hrungsgesetz [...], + 59.~Auflage, M{\"u}nchen, 2000 \par {\small Some people wrote me they would need the |annote| field to + give a short abstract or something similar at the end of the bibliographic entry. This is working now. + You are able to switch this feature on and off by using the |annote| option in the preamble or in your + local |jurabib.cfg| file.} +\end{bibexample} + The content of the field is printed out in |\small| by default. + If you want change that: +\begin{verbatim} + \renewcommand*{\jbannoteformat}[1]{{\footnotesize\begin{quote}#1\end{quote}}} +\end{verbatim} +\begin{bibexample} +\item \textbf{Palandt, Otto:} B{\"u}rgerliches Gesetzbuch mit Einf{\"u}hrungsgesetz [...], + 59.~Auflage, M{\"u}nchen, 2000 \par {\footnotesize\begin{quote} Some people wrote me they would need the |annote| + field to give a short abstract or something similar at the end of the bibliographic entry. + This is working now. You are able to switch this feature on and off by using the |annote| option + in the preamble or in your local |jurabib.cfg| file.\end{quote}} +\end{bibexample} + +\DescribeMacro{textedition =} + In v0.51e \CH{v0.51e} this field was removed again, because enclosing the |edition| in + curly brackets will have the same result. + +\subsubsection{Citing Juridical Dissertations and the Like} + +\DescribeMacro{dissyear =} Of course one can cite juridical dissertations as +normal dissertations, but a juridical dissertation may have been published as a +book as well. In the first case, the entry type \texttt{@JURTHESIS} (or +\texttt{@PHDTHESIS}/\texttt{@MASTERSTHESIS}) should be used. In the second +case, using the entry type \texttt{@BOOK} should be preferred. For this reason, +a new field \texttt{dissyear} has been created, which enables one to specify +the year in which a book appeared as doctoral dissertation. Furthermore, if +\texttt{dissyear} is present, fields \texttt{school} and \texttt{type} are +available for \texttt{@BOOK} as well. If \texttt{dissyear} is not present, +\texttt{type} and \texttt{school} are ignored. For example: +\begin{verbatim} + @BOOK{alexy, + author = {Alexy, Robert}, + title = {Theorie der Grundrechte}, + year = 1985, + address = {Baden-Baden}, + type = {Habil.}, + school = {G{\"o}ttingen}, + dissyear = 1984 + } +\end{verbatim} + +shows the following: +\begin{bibexample} +\item \textbf{Alexy, Robert:} Theorie der Grundrechte, Baden-Baden 1985 (also Habil. G{\"o}ttingen 1984) +\end{bibexample} + +Suppose this work had not been published as a book, the following entry would +have been appropriate:: +\begin{verbatim} + @PHDTHESIS{alexy, + author = {Alexy, Robert}, + title = {Theorie der Grundrechte}, + year = 1984, + type = {Habil.}, + school = {G{\"o}ttingen} + } +\end{verbatim} + +and would have shown the following: +\begin{bibexample} + \item \textbf{Alexy, Robert:} Theorie der Grundrechte, Habil. G{\"o}ttingen 1984 +\end{bibexample} +The default for this type is ``Jur. Diss.'': +\begin{verbatim} + @PHDTHESIS{alexy, + author = {Alexy, Robert}, + title = {Theorie der Grundrechte}, + year = 1984, + school = {G{\"o}ttingen} + } +\end{verbatim} +\begin{bibexample} +\item \textbf{Alexy, Robert:} Theorie der Grundrechte, Jur. Diss. G{\"o}ttingen 1984 +\end{bibexample} + +\DescribeMacro{\SSS} +The command \cs{SS} is no longer redefined by \textsf{jurabib}\,! +The new command \cs{SSS} defines two section marks with reduced space in +between the two. Compare \cs{S}\cs{S}: \S\S\ and \cs{SSS}: \S\kern-.8pt\S + +\section{Remaining things~\dots} + +Some helpful commands, which were introduced into the package without any +announcement. + +\begin{Options} + \item[pages=format] (Primarily for the humanities) You can switch on + preformatting of the pages given by the \texttt{pages}-field. + You are able to write \texttt{pages = \{22-34\}} instead of + \texttt{pages = \{pp.\~{}22-34\}}. Not enough, you are able to do + the same with the pages given by the optional argument of your + |\cite| command. If you want to give something else as page(ranges)s + or if you want to add something after a page(range), + please use the |\nopage| and |\pageadd| command (see below for an example). + \textsf{jurabib} will insert the appropriate and---if you are using babel---it + will use the chosen main document language. \textsf{jurabib} makes a + difference between a page and a pagerange. If you like to change the defaults: + \begin{verbatim} + \AddTo\bibsenglish{% + \def\jbpagename{page}% + \def\jbpagesname{pages}% + } + \end{verbatim} + +With version 0.51g \NEW{0.51g} you can use separate macros for the bibliography. The macros are named +|\bibpagename| and |\bibpagesname|. Please note that the definitions of |\bibpage[s]name| +are the same as for |\jbpage[s]name|. This means, if you are redefining |\jbpage[s]name|, this +will have effect on the meaning of |\bibpage[s]name| unless you are redefining +|\bibpage[s]name| separately. + + Let's take a look what \textsf{jurabib} can do to minimize your work\footnote{This rewritten option was + inspired by \textsf{pageranges.sty}, available at CTAN, and completely contributed by Stefan Ulrich. Thanks a lot.}: + \begin{center} + {\small + \begin{tabular}{@{}ll@{}} + \hline\\[-2ex] + |\cite[45]{<key>} |& \dots{}, p.~45\\ + |\cite[45--47]{<key>} |& \dots{}, pp.~45--47\\ + |\cite[45, 47 and 49]{<key>} |& \dots{}, pp.~45, 47 and 49\\ + |\cite[45f]{<key>} |& \dots{}, pp.~45f.\\ + |\cite[45ff]{<key>} |& \dots{}, pp.~45ff.\\ + |\cite[\nopage{I, III and IV}]{<key>} |& \dots{}, I, III and IV\\ + |\cite[13,\pageadd{something text}]{<key>} |& \dots{}, p.~13, something text\\ + | ^ No whitespace here!!! |& \\ + \hline\\[-2ex] + \end{tabular}} + \end{center} + +\item[pages=test] By default, page(range)s, which are given via the \texttt{pages}-field in + the \texttt{.bib}-file, are suppressed in the citation. With \texttt{pages=test} it will be tested, + if a page(range) is given by the optional argument of the \cs{cite} command. If so, that one will be used. + If there's no optional page(range) given, the one from the \texttt{.bib}-file will be used. +\item[pages=always] The page(range) given by the \texttt{.bib}-file are printed always. + +\item[hypercite=false] Disables the automated \NEW{0.51c} conversion of citations into hyperlinks when using the + \textsf{hyperref} package. + +\end{Options} + +\begin{description} +%\item[\cs{jbdotafterbibentry}] places a dot at the end of each entry in the bibliography. +%\item[\cs{jbdotafterendnote}] places a dot at the end of each endnote (if you are using \textsf{endnotes.sty}). +\item[\cs{jbedseplikecite}] Separation of the editors in the bibliography will be the same like in the citation. +\item[\cs{jbdisablecitationcrossref}] Disables crossrefs, which aren't \texttt{@INCOLLECTION}s. +%\item[\cs{jbsilent}] Suppresses all \textsf{jurabib} warnings. +\item[\cs{formatpages} \textit{formerly known as} \cs{formatarticlepages}] This command allows + you to determine the appearance of page(range)s of citations of all types. + \textsf{jurabib} is able to extract the starting page from a given pagerange (in the database). + Since v0.5f this command can be used with all publication types. + You can specify a list of publication types by using the first mandatory argument. + This command takes \textit{two\,!} \CH{0.51o} optional and three mandatory arguments: +\begin{center} + \small\cs{formatpages}\oarg{after start page separator}\oarg{before start page separator}% + \marg{typelist}\marg{left delim}\marg{right delim} +\end{center} + If you type |\formatpages[: ]{article,periodical}{(}{)}|, \textsf{jurabib} will format the citation |\cite[48]|\marg{key} + with the follwowing database entry: +\begin{verbatim} + @ARTICLE/PERIDOCAL{broxja, + author = {Hans Brox}, + title = {Die Anfechtung bei der Stellvertretung}, + journal = {JA}, + language = {german}, + year = 1980, + pages = {45--60}, + address = {M{\"u}nchen} + } +\end{verbatim} + like that: + \par\medskip + \qquad Brox, JA 1980, 45: (48). + \par\medskip + If you want format only the pages given by the optional argument of |\cite|, you can leave the optional arguments + empty: + \par\medskip + |\formatarticlepages{article}{[}{]}| + \par\medskip + \qquad Brox, JA 1980, [48]. + \par\medskip + +If you are using both |\formatpages| \NEW{0.52b} and |pages=format|, it is default now to suppress +formatting of pages given by the optional argument of |\cite|, e.g. you have written +|\formatpages[, ]{article}{}{}| into your preamble and you are using |pages=format| too, +then the ouput will look like: + +\par\medskip +\qquad Brox, JA 1980 p.~45, 48. +\par\medskip + +If you want to have a formatted second page number, you can use +|\jbnoformatafterstartpagefalse| in the preamble: + +\par\medskip +\qquad Brox, JA 1980 p.~45, p.~48. + + +\item[\cs{jbfirstcitepageranges}] If you have given \NEW{0.52h} a pagerange via the |pages|-field for + |@ARTICLE| or |@PERIODICAL| type, this pagerange will be printed out for first (using |citefull=first|) + and full citations done by using |\[foot]fullcite|. This works independently from the |pages| options\,! + If you add a page using the optional argument of the |\[foot]cite| command, this page will be added + after the pagerange, separated by ``here:'', which is represented by the macro |\herename|: + +\par\medskip +\qquad [\dots], p.~45, here: p.~48. +\par\medskip + +Redefinition as usual: + + \begin{verbatim} + \AddTo\bibsenglish{% + \def\herename{there:}% + } + \end{verbatim} + + +\end{description} + +\section{The Configuration file \texttt{jurabib.cfg}} + That file can be used to save redefinitions and options. The name has to be \texttt{jurabib.cfg} and + it has to live in the working directory or in the same directory where \textsf{jurabib} lives. + \begin{verbatim} + \jurabibsetup{% + authorformat=smallcaps, + commabeforerest, + titleformat=colonsep, + bibformat={tabular,ibidem,numbered} + } + \end{verbatim} + +\section{Options for Other Academic Disciplines}\label{sec:nichtjur} +The following options are not intended primarily for juridical work, but +satisfy the needs of, among others, historians, philosophers, etc. They are the +(provisional) answers to the most different questions which were proposed to +me. I hope them to be useful. Suggestions for improvement are welcome. + +\begin{Options} +\item[ibidem=name] By this option, more extensive data will be + inserted then by using \texttt{ibidem/ibidem=strict}. If this option + is active, the complete name of the author will be given (If not the + option \texttt{authorformat=reducedifibidem} is active, because then, only + the last name will be given). This option is intended for use + together with \texttt{citefull=first}, and therefor, that option + will be activated automatically. + +If an author is cited with multiple works, it may happen that \textsf{jurabib} +automatically switches to the next option, for guaranteeing the unambiguity of +the citation. You will find a hint to this in the \texttt{.log}-file. + +\item[ibidem=name\&title] Just like \texttt{ibidem=name}, but in this + case, the title will be given as well. Also here, the option + \texttt{citefull=first} will be active. +\end{Options} +This is a survey to the options explained above: +\begin{center} +{\small +\begin{tabular}{@{}lr@{}p{4.55cm}r@{}p{4.55cm}@{}}\hline\\[-2ex] +{\footnotesize\cs{footcite}|..|} & & {\footnotesize|ibidem=name|} & &{\footnotesize|ibidem=name&title|}\\\hline\\[-2ex] +|..{brox:bgb}| & $^{1}$ &\textsc{Brox}, Hans: \textit{Allgemeiner Teil des B{\"u}rgerlichen Gesetzbuches.} 20.\,Auf\/lage, K{\"o}ln, Berlin, Bonn, M{\"u}nchen 1996. + & $^{1}$ &\textsc{Brox}, Hans: \textit{Allgemeiner Teil des B{\"u}rgerlichen Gesetzbuches.} 20.\,Auf\/lage, K{\"o}ln, Berlin, Bonn, M{\"u}nchen 1996.\\[.3ex] +|..{brox:bgb}| & $^{2}$ &\textsc{Brox}, Hans, ibid. & $^{2}$&\textsc{Brox}, Hans: BGB AT, ibid. \\[.3ex] +|..{brox:bgb}| & $^{3}$ &\textsc{Brox}, Hans, ibid. & $^{3}$&\textsc{Brox}, Hans: BGB AT, ibid. \\[.3ex] +|..{oellers}| & $^{4}$ &\textsc{Oellers}, Bernd:\,\textit{Doppelwirkung im Recht\,?} AcP 169 [1969]. + & $^{4}$ &\textsc{Oellers}, Bernd:\,\textit{Doppelwirkung im Recht\,?} AcP 169 [1969]. \\[.5ex] +|..{brox:bgb}| & $^{5}$ &\textsc{Brox}, Hans, ibid. & $^{5}$&\textsc{Brox}, Hans: BGB AT, ibid. \\[.3ex] +|..{brox:bgb}| & $^{6}$ &\textsc{Brox}, Hans, ibid. & $^{6}$&\textsc{Brox}, Hans: BGB AT, ibid. \\[.8ex] + \multicolumn{5}{@{}c@{}}{\emph{Pagebreak}}\\[1.6ex] +|..{brox:bgb}| & $^{7}$ &\textsc{Brox}, Hans, ibid. & $^{7}$&\textsc{Brox}, Hans: BGB AT, ibid. \\[.3ex] +|..{brox:bgb}| & $^{8}$ &\textsc{Brox}, Hans, ibid. & $^{8}$&\textsc{Brox}, Hans: BGB AT, ibid. \\[.8ex] + \multicolumn{5}{@{}l@{}}{\emph{now with |authorformat=citationreversed|:}}\\[.8ex] +|..{brox:bgb}| & $^{9}$ & Hans \textsc{Brox}, ibid. & $^{9}$&Hans \textsc{Brox}: BGB AT, ibid. \\[.8ex] + \multicolumn{5}{@{}l@{}}{\emph{or with |authorformat=reducedifibidem|:}}\\[.8ex] +|..{brox:bgb}| & $^{10}$ &\textsc{Brox}, ibid. & $^{10}$&\textsc{Brox}: BGB AT, ibid. \\[.3ex] +\hline +\end{tabular}} +\end{center} + + \begin{Options} + \item[\texttt{ibidem=name\&title\&auto}] + This option \NEW{0.5f} can be useful for often repeated citations of different work of the same author. + For the first citation the full entry is printed (|citefull=first| is automatically used). + As long as the same work from an author is cited, only the name of the author will be used + (this is equal to |ibidem=name|). + + If the work is cited again some footnotes later, + name and title will be printed out (|ibidem=name&title|). + This will avoid ambiguity if an author is cited with more than one work. + If the immediately following citations are from the same author, only the name will be printed out. + + If you are using |ibidem=name| only, \textsf{jurabib} will check if the citations + seems to be ambiguous and then, |ibidem=name&title&auto| will be used automatically. You will find a + remark in the |.log| file. + \end{Options} + Here a survey: + \begin{center} + {\small + \begin{tabular}{@{}lr@{}p{9.5cm}@{}}\hline\\[-2ex] + {\footnotesize\cs{footcite}|..|} & & {\footnotesize|ibidem=name&title&auto|}\\\hline\\[-2ex] + |..{brox:bgb}| & $^{1}$&\textsc{Brox}: \textit{Allgemeiner Teil des B{\"u}rgerlichen Gesetzbuches.} 20.\,Auflage, K{\"o}ln, Berlin, Bonn, M{\"u}nchen 1996.\\[.3ex] + |..{brox:schr}| & $^{2}$&\textsc{Brox}: \textit{Besonderes Schuldrecht.} 20.\,Auf\/lage, M{\"u}nchen 1995.\\[.3ex] + |..{brox:bgb}| & $^{5}$&\textsc{Brox}, ibid.\\[.8ex] + \multicolumn{3}{@{}l@{}}{\hfill\emph{now another work is cited\,!}}\\[.8ex] + |..{brox:schr}| & $^{6}$&\textsc{Brox}: SchR~BT, ibid.\\[.8ex] + |..{brox:schr}| & $^{7}$&\textsc{Brox}, ibid.\\[.8ex] + \multicolumn{3}{@{}l@{}}{\hfill\emph{\dots{} and we are switching back again\,!}}\\[.8ex] + |..{brox:bgb}| & $^{8}$&\textsc{Brox}: BGB AT, ibid.\\[.8ex] + |..{brox:bgb}| & $^{8}$&\textsc{Brox}, ibid.\\[.8ex] +\hline + \end{tabular}} + \end{center} + +\noindent Changing the sequence of ``ibid.'' is possible by redefining the +commands \cs{ibidemname} and \cs{ibidemmidname}: + \begin{verbatim} + \AddTo\bibsenglish{% + \renewcommand{\ibidemname}{Ibid.} + \renewcommand{\ibidemmidname}{ibid.} + } + \end{verbatim} +\cs{ibidemname} is used by the options \texttt{ibidem=strict}, +\texttt{ibidem=strictdoublepage} and \texttt{ibidem=nostrict} and appears at +the beginning of the---suppressed---citation (It is therefore possible to +capitalize it). \cs{ibidemmidname} however, appears together with the options +\texttt{ibidem=name} and \texttt{ibidem=name\&title} and can be written in +lowercase---which depends on your preference. + +Now it's possible to make a difference \NEW{0.51} between a subsequent citation +with same page(s) and a subsequent citation with different page(s). +For the first case, the macros |\samepageibidemname| or |\samepageibidemmidname| +will be used internally. Its definiton is the same as for |\ibidemname| or +|\ibidemmidname| by default. +For the second case, the macros |\diffpageibidemname| or |\diffpageibidemmidname| +are used. If you like to make a difference between these two cases, you can +redefine the macros to your needs. I don't know useful abbreviations for the +English language, so I will demonstrate it with a dummy: +\begin{verbatim} + \renewcommand*{\samepageibidemname}{[same pages]} +\end{verbatim} +A short table will explain more: +\begin{center} +{\small\begin{tabular}{@{}lcl@{}}\hline\\[-2ex] +|\footcite[45]{broxbgb}| & $\longrightarrow$ &\textsuperscript{1}Brox, 45.\\ +|\footcite[45--47]{broxbgb}| & $\longrightarrow$ &\textsuperscript{2}Ibid., 45--47.\\ +|\footcite[45--47]{broxbgb}| & $\longrightarrow$ &\textsuperscript{3}[same pages]\\ +|\footcite[45f]{broxbgb}| & $\longrightarrow$ &\textsuperscript{4}Ibid., 45\,f.\\ +\hline\\[-2ex] +\end{tabular}} +\end{center} + +\begin{Options} +\item[citefull=first] By aid of this option, it is possible to show + the full bibliography entry in the first citation. For all + subsequent citations, a short form will be used. To force a full + citation in later citations, use the commands \cs{fullcite} and + \cs{footfullcite}. With this option, annotators appear before author's + names, separated by `in''. In order to get uniform citation and to + avoid confusion of the reader, this option automatically activates + the option \texttt{annotatorfirstsep=in} and thus activates options + which are presupposed by that option. Apart from that, the + \texttt{howcited}-options are deactivated. +\item[citefull=chapter] switches on \texttt{citefull=first} automatically and resets each chapter. +\item[citefull=section] switches on \texttt{citefull=first} automatically and resets each section. +\item[citefull=all] This option shows all citations as full citations. + It switches also all separators to \texttt{annotatorfirstsep=in}. The + \texttt{howcited}-options are deactivated. However, combination + with \texttt{ibidem} is possible. +\item[see] Because those outside law studies don't need the second + optional argument of the \cs{cite*} commands, by this option, one + can add phrases like ``See'' or ``Compare'' before the citation. + This option works globally. +\item[natoptargorder] Hereby, the sequence of the optional parameters + is reversed, for instance because of making the document compatible + with \texttt{natbib.sty} (before writing it). +\item[crossref=dynamic] You can use the other \texttt{crossref}-options + together with that option to achieve crossrefs, which are different + in their length---longer, if a work is cited the first time---shorter + if it is cited again. + Please compare the lonely use of \texttt{crossref=dynamic} (for better + understanding you may find the crossrefs inside square brackets): + \begin{quote} + \small $^1$\,Lincoll, Daniel D.: Semigroups of Recurrences. In + [Lipcoll/Lawrie/Sameh: High Speed Computer and Algorithm Organization].\\ + $^2$\,Lincoll, Daniel D.: Semigroups of Recurrences. In [Lipcoll/Lawrie/Sameh]. + \end{quote} + with the combination of \texttt{crossref=dynamic} with \texttt{crossref=long}: + \begin{quote} + \small $^1$\,Lincoll, Daniel D.: Semigroups of Recurrences. In [Lipcoll, David~J./Lawrie, + D.~H./Sameh, A.~H. (eds.): + High Speed Computer and Algorithm Organization. + 3rd edition, New York: Academic Press, September 1977 (Fast Computers 23)].\\ + $^2$\,Lincoll, Daniel D.: Semigroups of Recurrences. In [Lipcoll/Lawrie/Sameh: + High Speed Computer and Algorithm Organization]. + \end{quote} + +\item[crossref=normal] (Default) Hereby, cross references specified by + the special field \texttt{crossref} in the + bibliography are displayed with author + (\texttt{shortauthor} prevailing over \texttt{author}) and title + (\texttt{shorttitle} if available, else + \texttt{title}). + +\item[crossref=short] If no ambiguities result, title is left out with + this option. In case a title is needed, \texttt{shorttitle} prevails + over \texttt{title}. + +\item[crossref=long] With this option, the cross reference will be + displayed as full citation. + +\item[lookat] Hereby, references to footnotes are enabled which + contain the full citation to which is referred. This is possible + \emph{only} when using the \cs{footcite} command in connection with + the option \texttt{citefull=first}. This may be useful for + articles which do not contain bibliographies. For this purpose, the command + \par\medskip + \qquad \cs{nobibliography}\marg{bibfile}\DescribeMacro{\nobibliography} + \par\medskip + is available, which suppresses bibliography generation.\footnote{This command is primarily for + use with \texttt{lookat}, but it doesn't require \texttt{lookat}. But one of the \texttt{citefull}-options + has to be enabled. Thanks to \textsc{Stefan Ulrich}.} + In later citations, short forms of citation are used, accompanied by a hint to the footnote in + which the full citation can be found.\footnote{Example: \textsc{Brox}: BGB AT (wie Anm. + \textit{$\langle$Nr.$\rangle$}), Rn.~168.} + + Please notice that for correct parsing of the references with + \texttt{lookat}, after running \BibTeX, \emph{three} \LaTeX-runs are + necessary! + + In case you want to use the package \textsf{varioref} or + \textsf{fancyref}, then instead of \cs{ref} the command + \cs{vref} will be used, resulting in different references, in + particular if the full citation is one or two pages away. + In case you want to use the package \textsf{varioref} or + \textsf{fancyref} in your document, without consequences for your + citations, you can put the command\DescribeMacro{\jbignorevarioref} + \cs{jbignorevarioref} in the preamble of your document. + + It is possible to customize the behavior of the \texttt{lookat} option by the following commands: + \begin{verbatim} + \renewcommand{\lookatprefix}{\space(see footnote~} + \renewcommand{\lookatsuffix}{)} + \end{verbatim} + + \texttt{lookat} \emph{may} be used in connection with the + {ibidem}-options, but such is not recommended.\par When using + \cs{cite} commands in the main text (outside footnotes!) \emph{and} \cs{footcite} + commands \mymarginpar{CAVE\,!} + (or \cs{cite} commands inside footnotes) + errors may occur from \textsf{alphanum} + or---if used---\textsf{varioref}. + \textsf{alphanum} may complain in the following way: + \begin{verbatim} + ! Package alphanum Error: Self-reference detected!. + [...] + ? + \end{verbatim} + + In this case, you have cited a work in the main text for the first time, to which one refers in the + same section by a \cs{footcite} command. Because the first citation is not inside a footnote, the + section number will be taken as reference label. Because by using the option \texttt{lookat}, + following citations refer to the first citation, and this citation is in the same section, + \textsf{alphanum} complains as mentioned above.\par Another error report which is caused by the + same problem might look as follows: + \begin{verbatim} + ! Extra }, or forgotten \endgroup. + \J@refP ...nta #1\,\J@INumberRoot {#1}{#2} + [...] + ? + \end{verbatim} + + The solution is to put at least the first citation inside a footnote (whether one uses + \cs{footcite} or \cs{cite} inside a \cs{footnote} makes no difference.). + + \emph{The \texttt{lookat}-option cannot be used with documents based + on the \texttt{book}- or \texttt{report}-class or their + derivatives.} Use of this option with the + \textsf{footnpag.sty}-package is equally impossible. + + Using \texttt{lookat} in connection with \texttt{book}- or \texttt{report}-classes is possible + by the \textsf{remreset}-package. This package disables resetting the footnote counter at the + start of a new chapter, thus enabling unambiguous references. In order to do so, you should insert + the following in your preamble: + \begin{verbatim} + \usepackage{remreset} + \makeatletter + \@removefromreset{footnote}{chapter} + \makeatother + \end{verbatim} + + In oder to gain consequent results, you should also properly set the counters of images and tables: + \begin{verbatim} + \usepackage{remreset} + \makeatletter + \@removefromreset{footnote}{chapter} + \@removefromreset{figure}{chapter} + \renewcommand{\thefigure}{\@arabic\c@figure} + \@removefromreset{table}{chapter} + \renewcommand{\thetable}{\@arabic\c@table} + \makeatother + \end{verbatim} +\end{Options} + + \begin{Options} + \item[\texttt{idem}] + This new option is very similar to the |ibidem| option, but there + is not the whole citation replaced by an abbreviation. If the author is cited + again, his name will be replaced by ``Idem'' or ``idem''. |idem| is working + together with all |ibidem| options. The following values are possible: |idem| + (same as |idem=strict|), |idem=strictdoublepage| and |idem=nostrict|. + The behavior of |idem| at page breaks is the same as for the |ibidem| options, therefore I did not make any survey. + + Redefinitions as usual: + \begin{verbatim} + \AddTo\bibsenglish{% + \renewcommand*{\idemname}{Eadem} + \renewcommand*{\idemmidname}{eadem} + } + \end{verbatim} + \end{Options} + + \DescribeMacro{\noidem} |\noidem| is working analogous to |\noibidem| and disables the |idem| mechanism for the following citation. + + \begin{Options} + \item[\texttt{opcit}] + This option is at experimental stage and places the abbreviation ``\textit{op.\,cit.}'' + (opere citato: already cited) in the citation. + An example:\\[1.5ex] + {\footnotesize\textsuperscript{1}\,Aamport, \textit{Gnats and Gnus} (1986), p.\,25.}\\ + {\footnotesize [\ldots]}\\ + {\footnotesize\textsuperscript{5}\,Aamport, \textit{op.\,cit.}, p.\,37.} + + If you like to modify: + + \begin{verbatim} + \renewcommand*{\opcit}{\textit{op.\,cit.}} + \end{verbatim} + + \DescribeMacro{opcit=chapter} + \DescribeMacro{opcit=section} + |opcit| can be resetted at the begin of each chapter/section with the values + |chapter|/|section|. This is analogous to |citefull=chapter| or |citefull=section|. + \end{Options} + +\section{Linguistic Stuff} + +Because of increasing use of the \textsf{jurabib} package by people outside +law studies, I have reworked the \BibTeX-styles in such a way that it is +possible to switch between different languages. + +\DescribeMacro{language =} It is now possible, to specify the language of a +certain \BibTeX-entry by providing the field \texttt{language} with the +appropriate language. At the moment, only English, German, French, Dutch, Spanish and Italian are +implemented: + \begin{verbatim} + @INCOLLECTION{incollection-crossref, + author = {Daniel D. Lincoll}, + title = {Semigroups of Recurrences}, + pages = {179--183}, + language = {english} + } + \end{verbatim} +If \texttt{language = \marg{other language}} is specified here, then the +\emph{hyphenation patterns} for that entry will be modified, not the keywords +like ``editor'' and so on\,! For the correct translation of the keywords +\textsf{jurabib} will detect the used main language (e.g. if you are using the +\textsf{babel}-package or one of the following packages: \textsf{german}, +\textsf{french}, \textsf{frenchle}, \textsf{pmfrench}, \textsf{mlp}). +\begin{quote} +\emph{\textsf{jurabib} doesn't switch the keywords, but the hyphenation +patterns for each bibliographic entry, for which a language is given\,!} +\end{quote} +You should notice, that (for German users: contrary to the +\texttt{bibgerm}-package) only the relevant entries (which differs from the +main language) should be provided with \texttt{language}-fields. You can modify +the defaults by using the \cs{AddTo} functionality: + \begin{verbatim} + \AddTo\bibsgerman{\def\editorname{ed.}} + \end{verbatim}\vspace{-1em} +The macro for English is \cs{bibsenglish}, for French \cs{bibsfrench}, for +Dutch \cs{bibsdutch}, for Spanish \cs{bibsspanish}. + +If I've forgotten something which has to do with language support, please +e-mail me. The same goes for supporting more languages. + +\section{Across the bounderies} + +\subsection{\textsf{jura.cls}} + +As I said already, use of \textsf{\mbox{jura.cls}} is possible. + +\subsection{\textsf{bibtopic.sty}} + +\textsf{jurabib.sty} is already for a long time---under certain +conditions---compatible with \textsf{bibtopic.sty}: All short titles should be +specified, because otherwise, ambiguous citations may occur. At this moment, it +is not possible to use automatic generation of short titles when separated +bibliography files are in use. Therefore, the option \texttt{titleformat=all} +is activated automatically, if \textsf{bibtopic.sty} has been loaded. Note: You +should use at least version \texttt{1.0j}. + +\subsection{\textsf{hyperref.sty}} + +\textsf{jurabib} is compatible with +\textsf{hyperref}.\footnote{ \textsc{Stefan Ulrich} was behind this + feature as well.} However, incompatibility still exists with +\textsf{alphanum}, of which the result is that the \cs{ref} mechanism of +\textsf{alphanum} functions only to a limited extent. That means primarily that +the command \cs{ref*} provides relative references only. If you want to use +\textsf{alphanum} and \textsf{hyperref} without \textsf{jurabib}, you should +put the following in your preamble: + \begin{verbatim} + \makeatletter + \let\J@SetCurrent\relax + \def\toclevel@lvla{0}\def\toclevel@lvlb{1} + \def\toclevel@lvlc{2}\def\toclevel@lvld{3} + \def\toclevel@lvle{4}\def\toclevel@lvlf{5} + \def\toclevel@lvlg{6}\def\toclevel@lvlh{7} + \def\toclevel@lvli{8}\def\toclevel@lvlj{9} + \def\toclevel@lvlj{10}\def\toclevel@lvll{11} + \newcommand*{\theHlvla}{\J@Number}\newcommand*{\theHlvlb}{\J@Number} + \newcommand*{\theHlvlc}{\J@Number}\newcommand*{\theHlvld}{\J@Number} + \newcommand*{\theHlvle}{\J@Number}\newcommand*{\theHlvlf}{\J@Number} + \newcommand*{\theHlvlg}{\J@Number}\newcommand*{\theHlvlh}{\J@Number} + \newcommand*{\theHlvli}{\J@Number}\newcommand*{\theHlvlj}{\J@Number} + \newcommand*{\theHlvlk}{\J@Number}\newcommand*{\theHlvll}{\J@Number} + \renewcommand{\J@LongToc}[2][]{ + \@startsection{lvl\alph{tiefe}}{\number\value{tiefe}}{0pt} + {\ifnum\value{tiefe}=1 -4ex plus-1,5ex minus-0,ex\else + -2,7ex plus-0,8ex minus-0,2ex\fi}{\ifnum\value{tiefe}>7 + -1em plus-0,5em\relax\else 0,6ex plus0,3ex minus0,1ex\fi} + {\sectfont\csname lvl\alph{tiefe}style\endcsname}[#1]{#2} + } + \makeatother + \end{verbatim} + +\subsection{\textsf{babel.sty}} + +\textsf{jurabib} is compatible with \textsf{babel}. Please make sure that \textsf{jurabib} is loaded after \textsf{babel}\,! + +\subsection{\textsf{chapterbib.sty}} + +\textsf{jurabib} is compatible with \textsf{chapterbib}. + +\subsection{\textsf{bibunits.sty}} + +\textsf{jurabib} is fully compatible with \textsf{bibunits}, you should use +v2.1n or higher. + + \subsection{\textsf{index.sty}} + + If you are using the \textsf{french}-, \textsf{pmfrench}- or the \textsf{frenchle}-packge, you are not + able to use this feature at the moment. + + With the option \texttt{authorformat=indexed} you can index all cited authors. + If you want to generate a separate author index, it's possible to use the \textsf{index} package by + \textsc{David M. Jones}, which is part of the \textsf{camel} bundle. + \begin{verbatim} + [...] + \usepackage{index} + \newindex{default}{idx}{ind}{Index} % for the normal Index + \newindex{aut}{adx}{and}{Authorindex} % for the new author Index + \renewcommand{\jbindextype}{aut} % + [...] + \begin{document} + [...] + \printindex % for the normal Index + \printindex[aut] % for the new author Index + \end{document} + \end{verbatim} + Please note that \cs{jbindextype} has to contain the same value as the first argument of \cs{newindex}. + + To generate the index, run: + \begin{verbatim} + makeindex -o datei.and datei.adx + \end{verbatim} + Then you have to run \LaTeX{} again. For further explanations please take a look at the + \textsf{index} package documentation. + +\subsection{\textsf{endnotes.sty}} +\textsf{jurabib} \NEW{0.51} is now compatible to \textsf{endnotes}. +With a simple |\usepackage{endnotes}| in your preamble all your |\foot[full]cite| citations +are converted into endnotes, which are appearing where you typed |\theendnotes|. +Citations, which are enclosed in |\footnote| commands or normal |\cite| commands, +were not converted by default\,! If you need this feature, please use the option +`|citetoend=true|' or consult the documentation of the \textsf{endnotes} package. + +Endnotes does not have a closing dot by default. If you would have a closing period, please use +|dotafter=endnote| in the preamble of your document. + +\section{Cooperators} +This package would have never been come into existence without the powerful +support of \textsc{Stefan Ulrich}, \textsc{Andreas Stefanski} and \textsc{Oren +Patashnik}. It is especially due to \textsc{Stefan Ulrich} that the package now +exists in its present form and not stumbled in its provisional stage of +development. To him, my special thanks. \textsc{Heiko Oberdiek} provided some +valuable hints. \textsc{Andreas Stefanski} was my unexhaustible tester and +advisor in juridical formalities. Not to omit \textsc{Oren Patashnik}, who +provided important parts of the \BibTeX-styles which enable the dynamic +generation of the juridical shorttitles. \textsc{Bernard Gaulle} has done a lot +for compatiblity with the french packages and gave many other helpful hints, +especially about the linguistic stuff. I want to thank \textsc{Maarten Wisse} +for translating the documentation, for his patience and for a lot of helpful +hints during implementation of the basic humanities features. \textsc{Peter +Flynn} and \textsc{P\'{a}draig de~Br\'{u}n} also suggested a lot of new +features for the humanities. And there are lots of people who worked as beta +testers and reported bugs: \textsc{Alexander Wisspeintner}, \textsc{Andreas K.~Foerster}, +\textsc{Arne Engels}, \textsc{Axel Sodtalbers}, \textsc{Bastian Kruse}, +\textsc{Christian Folini}, \textsc{Christian Meyn}, \textsc{David Feest}, +\textsc{Daniel M.~Grisworld}, \textsc{H\'{e}l\`{e}ne Fernandez}, \textsc{Henning Eiden}, +\textsc{Holger Pollmann}, \textsc{Hubert Selhofer}, \textsc{Ivan Blatter}, +\textsc{Jean-Pierre Drucbert}, \textsc{Joachim Trinkwitz}, \textsc{Max Dornseif}, +\textsc{Moritz Moeller-Herrmann}, \textsc{Nikolai Warneke}, \textsc{Olaf Meltzer}, +\textsc{Oliver Schilling}, \textsc{Peter Wuesten}, \textsc{Ralph Sinkus}, +\textsc{Rebekka Rieger}, \textsc{Robert Goulding}, +\textsc{Thorsten Manegold} and \textsc{Tilman Finke}. + +\section{Response requested \dots} +Questions, recommendations and critique or the like can be sent to: +\texttt{jb <at> jurabib <dot> org} + +\newpage + +\bibliographystyle{jurabib} + +\end{document} |