From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- macros/latex/contrib/jurabib/changes.txt | 718 + .../latex/contrib/jurabib/docs/english/jbendoc.pdf | Bin 0 -> 298791 bytes .../latex/contrib/jurabib/docs/english/jbendoc.tex | 2254 +++ .../latex/contrib/jurabib/docs/german/jbgerdoc.pdf | Bin 0 -> 328758 bytes .../latex/contrib/jurabib/docs/german/jbgerdoc.tex | 2422 ++++ macros/latex/contrib/jurabib/jurabib.dtx | 14030 +++++++++++++++++++ macros/latex/contrib/jurabib/jurabib.ins | 202 + 7 files changed, 19626 insertions(+) create mode 100644 macros/latex/contrib/jurabib/changes.txt create mode 100644 macros/latex/contrib/jurabib/docs/english/jbendoc.pdf create mode 100644 macros/latex/contrib/jurabib/docs/english/jbendoc.tex create mode 100644 macros/latex/contrib/jurabib/docs/german/jbgerdoc.pdf create mode 100644 macros/latex/contrib/jurabib/docs/german/jbgerdoc.tex create mode 100644 macros/latex/contrib/jurabib/jurabib.dtx create mode 100644 macros/latex/contrib/jurabib/jurabib.ins (limited to 'macros/latex/contrib/jurabib') diff --git a/macros/latex/contrib/jurabib/changes.txt b/macros/latex/contrib/jurabib/changes.txt new file mode 100644 index 0000000000..e8da3a562f --- /dev/null +++ b/macros/latex/contrib/jurabib/changes.txt @@ -0,0 +1,718 @@ +0.6 + NEW: + o IMPORTANT: The order of optional arguments has changed! + `natoptargorder' option removed, natbib order of optional + arguments is now NEW DEFAULT! There is a compatibility + option `jurabiborder' for old documents. + o jox.bst is part of jurabib.dtx. + o Indexing code completely rewritten (contributed by Stefan Ulrich). + o Danish language support added (contributed by Mads Munch Hansen). + o Finnish language support added (contributed by Harri Kiiskinen). + o Portuguese language support (contributed by Eva and Miguel Costa). + o new option `silent', replaces \jbsilent. + o new option `dotafter=bibentry' replaces \jbdotafterbibentry. + o new option `dotafter=endnote' replaces \jbdotafterendnote. + o new option `lookforgender', replaces \jblookforgender. + o new option `annotatorlastsep', replaces `colastsep' option. + o new option `annotatorfirstsep', replaces `cofirstsep' option. + o new option `annotatorformat', replaces `coauthorformat' options. + o new option `super' transforms \cite commands to footnotes, + suggested by Frank Mittelbach. + o new option `config=', allows to + switch between configfiles, suggested by Frank Mittelbach. + o new command \lookatfortype, allows to determine a list of entry types + for which the lookat feature should be used (suggested by David Feest). + o \footcitetitleonly introduced, suggested by Frank Mittelbach. + o New commands to tune indexing introduced: + \jbdonotindexeditors (suppress editor-indexing). + \jbdonotindexauthors (suppress author-indexing). + \jbdonotindexorganizations (suppress org-indexing). + \jbindexonlyfirstauthors (to index authors only at first appearence). + \jbindexolyfirsteditors (to index editors only at first appearence). + \jbindexolyfirstorganizations (to index organizations only at first appearence). + Known Problem: Authors with special characters (umlauts etc.) + aren't sorted properly (makeindex-problem). + o Oyear support for citations added, can be switched on by using + \jboyearincitation. + o Implemented \numberandseries and some periodical formatting specials for jox.bst. + o loading of config files rewritten. The loading is now as follows: + 1. \usepackage option overwrites values given by config files. + 2. option placed in \jurabibsetup (in the preamble) overwrites + values given by \usepackage. + 3. last \jurabibsetup overwrites values of preceding \jurabibsetup. + o Some hooks for multibib.sty compatibility implemented, testfiles + added for multibib compatibility (jbtestmb.tex) and for + bibunits compatibility (jbtestbu.tex), thanks to Thorsten Hansen + for adapting his packages. + o new commands \bibleftcolumnstretch, \bibrightcolumnstretch and + \bibtabularitemsep introduced to adjust linestretch and + itemsep in 'bibformat=tabular' mode. + o \bibnotcited, \howcitedprefix and \lookatprefix contains now space + to make redefinition (e.g. with comma) easier, + suggested by Frank Mittelbach. + o new entry type @ARCHIVAL for historical documents introduced (alpha stage!), + (suggested by Jan Nikolas Dicke). + o Warning for missing pageranges limited to @ARTICLE and @PERIODICAL. + o \citep{key1,key2} now generates (author1; author2) + o new command introduced to make the page separator configurable: \jbpagesep + REMOVED: + 'multiple'-functionality removed! To have the same feature you + have to load footmisc.sty with option 'multiple' now, + suggested by Frank Mittelbach. + BUGFIXES: + o editortype bugfix, @incollection did not recognize the `editortype' field + if there were more than one editor, reported by David Krebs. + o '\def\cite' replaced by '\DeclareRobustCommand\cite', bug fixed by Stefan Ulrich. + o Bugfix regarding extra labels, reported by Dominik Waßenhoven, solved by Robert Schlicht. + o Bugfix regarding configuration commands in the jurabib.cfg file + (reported by Dominik Waßenhoven). + o Some fixes regarding the extra label stuff for artical and periodical + (reported by Dominik Waßenhoven). + o When using natbib commands with year output, printout of bibliography extra + label is automatically switched on (bug reported by Patrick Hausmann). + o Bugfix for generated cite, forgotten \space in \jbsy. + o Bugfix for preceding whitespace in front of all cite commands + (forgotten percent at line end), both reported by Klaus Hellermann. + o Small bugfixes regarding `howcited=multiple' (1. forgotten command + to call howcited for @commented, 2. forgot to reverse order + of optional arguments), both reported by Holger Pollmann. + o \jbindexbib works correctly again. + o Problem with natbib commands and optional arguments solved + (reported by Mads Munch Hansen). + o small bugfix concerning interaction with alphanum.sty, (reported by Michael Below). + o some improvements and bugfixes in jurabib.sty and .bst files added, + suggested by Robert Schlicht. + o added some alternative babel main language values, initially + suggested by Harri Kiiskinen. + o Hook for memoir.cls bibliography added, suggested by Robert Schlicht + (requires mempatch.sty!). + o small typo in frjbbib.ldf fixed, reported by Thomas Crulli. + o small bugfix for loaded hyperref and tabularx packages + (hyperref turns off hyperfootnotes internally), + bug reported by Maarten Wisse. + o small bugfix regarding @PERIODICALS in .bst files, contributed + by Tilman Finke. + o some bugfixes in the .bst files regarding dissyear and year. + o @INCOLLECTION added to the command \jbfirstcitepageranges + (suggested by David Feest). + o check for more than one author/editor introduced, + requires new function `count.authors.or.editors' + in .bst file (bug reported by Maarten Wisse). + o bugfix for @manual function, did not recognize organization as + fallback for missing author, reported by Frank Mittelbach. + o bugfix for `ibidem=name&title&auto', reported by Frank Mittelbach. + o \nextcite-commands are working for first citation now while + using `citefull=first', reported by Frank Mittelbach. + o bug regarding endnotes.sty fixed, reported by Frank Mittelbach. + o language bug in \citefield fixed, reported by Frank Mittelbach. + o again some bugfixes regarding footnote stuff and interaction with + footmisc.sty (espescially para option) reported and + suggested by Frank Mittelbach. + o new integer 'extra.extra.num', new function 'make.extra.label' and + some modifications on 'forward.pass' (suggested by Robert Schlicht + in d.c.t.t.) + o empty default for \ajtsep for some languages removed (bug reported + by Olaf Meltzer). + o some changes in jurabib.ins (suggested by Heiko Oberdiek). + o bugfix for hyperref users -- wrapper for hyperref's footnote definition + inserted (suggested by Heiko Oberdiek in d.c.t.t.). + o several bugfixes, some reported by Frank Mittelbach (empty default for + \jbhowsepcoauthorfirst and some forgotten \unskips). + o small bugfix regarding wrong warnings for @ARTICLE, bugfix for + interaction between \jbusehowcitedforcite and `ibidem' (bugs reported + by Jan Nikolas Dicke). + o small bugfix regarding `authorformat=and' (bugfix contributed by Robert Schlicht). + o small bugfixes in .bst files. + o adapted version of \ProcessOptionsWithKV, after discussion in d.c.t.t. + o .dtx file cleaned. +0.52p + natbib commands are working with `authorformat=index' now + (bug reported by Jose Ignacio Sanchez-Macias). + some changes in spjbbib.ldf (suggested by Jose Ignacio Sanchez-Macias). + bugfix for missing \endgroup (double \begingroup!) while + calling \jbcitenotitle. + removed doubled comma, if number and volume are given, + while \artnumberformat prints out a comma by itself + (reported by Kai Kramer and Jose Ignacio Sanchez-Macias). + no longer double output of year for @article type (generated + shorttitle contains `journal year'). + fallback to url (if url given and neither shortauthor or shorttitle + are given) removed, because of problems of detecting + not given url. + check for `commabeforerest' introduced for \citefield. + no longer additional shorttitle, if `authorformat=year' is used. + `\bfseries ?' replaced by `{\bfseries ?, #1}' (suggested by Tilman Finke). +0.52o + hardcoded `in:' removed (reported by Peter Flynn). + No longer warnings about ambiguous citations if + `authorformat=year' is used. + New entry type @LEXICON introduced (alpha stage!). +0.52n + bugfix regarding babel's french options (reported by Peter Flynn). + sort.format.names removed for sortkey. All spaces are ignored now. + natbib-emulated command `\citet' improved (bug reported by Klaus Hellermann). + \citeworkwithtitle{} allows to specify a list of works (keys), for those the + title should always be printed (suggested by Till A. Heilmann) + natbib emulation commands using the first optional argument for pages now + (bug reported by Bear F. Braumoeller). +0.52m + rewritten macro \jbfirstcitepageranges. Documentation added. +0.52l + Counting of citations inside \footnote's introduced to avoid lowercase ibidem + at the begin of the footnote. + `pages=always' includes no longer the pagerange in the short citation. +0.52k + lowercase ibidem for inline citations or \cite's inside the same footnote + (reported by Matthias Damm). + some \def's replaced by \DeclareRobustCommand's. +0.52j + bugfix for indexing with `index' package, reported by Dirk Steinmeyer. + No special code for loaded footmisc, exceeded TeX capacity if + `multiple' option was used (reported by Thorsten Manegold). +0.52i + Printout no title, if `authorformat=year' is used + and no shorttitle is given (reported by Carsten Mennenoeh). + output of startpage for ibidem citations is suppressed now + (suggested by Benjamin von Engelhardt). +0.52h + bugfix regarding starred \cite-commands, produced fatal error, + reported by Jan Reidar Oeverland. +0.52g + small bugfix regarding \jbfirstcitepageranges. + wrong order of publisher and address in jureco.bst corrected + (reported by Klaus Hellermann), all hardcoded ": " + replaced by \bpubaddr. + some improvements on norwegian language file nojbbib.ldf, + contributed by Jan Reidar Oeverland. + bugfix for indexing macros, reported by Andrea Rossato. + bugfix for ibidem, reported by Matthias Steinbrink. +0.52f + command \jbfirstcitepageranges introduced, it enables the output + of pageranges for first citation of @ARTICLE and @PERIODICAL + and adds an `here' before the page given via the optional + argument of the cite command: + + `Author: Title [...], p. 192-225, here: p. 200' + +0.52e + \jbbookedaftertitle introduced, for a @BOOK-entry with author + and editor you are able to switch from + `author; editor (ed): title ...' + to + `author: title, ed. by editor, ...' + this command is experimental! + Markup for volume improved, it's possible to set a (globally) + separation command after volume: \aftervolsep. + New field `totalpages' for @BOOK type introduced, produces + `n pages' at the end of the bibliographic entry. A new + macro called \bibtotalpagesname can be used to adapt + the sequence after the total pages number, but beware + of using abbreviations with a period at the end, this + can result in unwanted double dots! This feature is + experimental too. +0.52d + again minor bugfix regarding \formatpages and `pages=format'. + jurunsrt.bst reintroduced. +0.52c + small bugfix regarding \formatpages and `pages=format', + reported by Klaus Hellermann. +0.52b + automatic formatting of second page removed, when using + \formatpages and `pages=format' (suggested + by Benjamin von Engelhardt). +0.52a + bugfix for \jblookforgender, reported by Benedikt Welter. +0.52 + markup for volume and indexed authors introduced, both + suggested by Otto Janschek. +0.51z + small bugfix regarding `annote' option and `bibformat=tabular'. + markup for ISBN and ISSN introduced. + some modifications in frjbbib.ldf, contributed by Hélène Fernandez. + some modifications in spjbbib.ldf and itjbbib.ldf, + contributed by Pablo Rodriguez. + some bugfixes for missing author in @COMMENTED. +0.51y + markup for numbered bibliography introduced (\bibnumberformat). +0.51x + \bibbudcsep added, configurable separation of \urldatecomment + (suggested by Carsten Mennenoeh), docs adapted. + minor bugfixes +0.51w + some bugfixes regarding gender handling: you have to use + \jblookforgender explicitely in the preamble now. + again bugfix regarding `bibformat=ibidemalt', \fsted and + \snded macros rewritten. +0.51v + hardcoded dot replaced by \bibatsep in \incolledformat + check for jhuman.bst reintroduced. + bugfix for `bibformat=ibidemalt', reported by Matthias Damm. + \jbshowbibextralabel introduced to show extra label for + works from same year in the bibliography. +0.51u + bugfix for `pages=format', wrong `s' removed (reported by Maarten Wisse). + bugfix for `hypercite=false'; check for loaded hyperref package removed, + caused wrong hyperlinks (reported by Maarten Wisse). +0.51t + \par added in \jbannoteformat (suggested by Robert Schlicht). + \bib[e]imfont is using \bib[e]fnfont instead of + \bib[e]lnfont by default (suggested by Robert Schlicht). +0.51s + minor bugfixes, some reported by Robert Schlicht. + annote files for bibliography are useable now. These files + have to be named like the bibliography database entry + with .tex extension and are used if the annote field + is empty. With \bibAnnotePath you can give a path + to your annote files (suggested by Robert Schlicht). +0.51r + dummy year reintroduced, needed for correct label generating. + superfluous whitespace in \cite removed. + natbib emulation commands bug fixed and improved, much + better endnotes-support now. + natbib emulation commands are able to recognize a second + optional argument. + tilde removed from \jb@deactivate@babel. + \citefield knows value `url' now. + \cite command can print out url, if no shortauthor and + shorttitle is given. + jurabib speaks now italian, first trial. (Thanks to Pablo Rodriguez). +0.51q + small bug inside jurabib.bst fixed, reported by Tilman Finke. +0.51p + bugfix regarding \formatpages and `commabeforerest', found by Tilman Finke. + again some definitions changed in spjbbib.ldf (thanks to Pablo Rodriguez). +0.51o + \formatpages has now two optional arguments, I added one to make the + separation before the start page configurable; is influenced by + `commabeforerest' by default. + new commands added to adapt the separation of \formatpages automatically +0.51n + Bugfix regarding `bibformat=ibidemalt' and usage of \typearea from + the KOMA-bundle after loading jurabib.sty, contributed by + Tilman Finke. + again some definitions changed in spjbbib.ldf (thanks to Pablo Rodriguez). +0.51m + some definitions changed in spjbbib.ldf (thanks to Pablo Rodriguez). + more spaces added for better line breaking, regarding the well + known BibTeX bug. + `superscriptedition=multiple' should work with german umlauts. +0.51l + \bibimfont improved. + `superscriptedition=multiple' should work now as expected (only for + @COMMENTED at the moment!). VERY special thanks to Stefan Ulrich! +0.51k + `superscriptedition=multiple' will not work correctly now, because I + had to remove the code from jurabib.bst, which does the main work + to mark the entries which have same title but different editions. + I have to rebuild the mechanism in LaTeX, which can take some time. + Lot of people have reported errors with long title fields and + BibTeX error messages. That's the reason to remove the code from + the .bst. + A small bug was found by Andreas Altenburger, the combination of + `authorformat=year' and `titleformat=all' has not worked correctly, + the titles were not printed out. This (new bug) was introduced in + beta 23, trying to remove wrong warning about ambiguous citations. + It should work now (while introducing \ifjb@starred@cite). + First trial for spanish support. Special thanks to Pablo Rodriguez + for first translation. Bug reports welcome. +0.51j + new option `superscriptedition=year' places the superscripted edition + number before the year. `superscriptedition=bib' is also available + with `superscriptedition=address'. These options are working only + for jurabib.bst and jureco.bst! There are no plans to implement + them for jox.bst or jchic.bst. +0.51i + some improvements on `authorformat=indexed'. +0.51h + juratitle field in jurabib.bst was missing, reintroduced; new options + `superscriptedition=multiple' (superscripted edition number instead of + title for same work with different edition numbers) and + `superscriptedition=kerning' (replaces \jbsseditionkerned) introduced. +0.51g + \bibpagename and \bibpagesname introduced for separate + formatting of pages in the bibliography +0.51f + configurable commands added to format author names and order of + name parts in bibliography, e.g.: + \renewcommand\jbRevedFirstVonNoJr{% + \biblnfmt{\jbVon\space\jbLast, }\bibfnfmt{\jbCheckedFirst}} + changes format from `last, first, von' to `von last, first' + for the case that a `von' part is given, but no `jr' part. +0.51e + year after label (`}% ') removed in jurabib.bst. + new field `updated' for @commented introduced, `suggested' by + Holger Pollmann in dctt. +0.51d + @phdthesis function rewritten. `format.mthesis' and `format.juradiss.thesis' + removed. Now only one generic function `format.thesis'. + Bug reported by Marco Kuhlmann. + German documentation extracted to jbgerdoc.tex. `latex jurabib.dtx' + will no longer produce any documentation. + TEXTEDITION FIELD REMOVED, same behavior is available by enclosing the + edition in braces. +0.51c + new option `hypercite=false' for disabling automated hyperlinks when + using hyperref package, suggested by Tilman Finke. +0.51b + mixed series and title in FUNCTION {format.btitle.vol} in jurabib.bst + and jureco.bst corrected. +0.51a + \nopage and \pageadd can be used in pages field, Bug reported by + Sönke Schaal (), solution suggested by + Stefan Ulrich. +0.51 + changed version numbering because of increasing numbers of `beta' versions + (v0.5f beta 27 = v0.51), new minor releases will have an additional + lower case letter (the next minor release will will be v0.51a). + Ibidem/Idem-bugfix. Bug reported by Sönke Schaal () + When German, `ibidem' and `idem' are used together, it appears + `A.a.O.Ders.' because of ``hardcoded'' gender macros for German in + dejbbib.ldf. +v0.5f + beta 26 + bugfix regarding `superscriptedition=bib', the normal edition number + was not suppressed for the first entry in the bibliography, + bug reported by Andrea Heilmann () + beta 25 + jurabib.sty now removes `%' at the line end similar to hyperref.sty. + (special thanks to Stefan Ulrich!) + beta 24 + new option `citetoend' introduced, converts \cite's (= non-footcite's) + into endnotes (endnotes.sty has to be loaded). + check for chapter numbers > 1 removed (options `citefull=chapter' and + `opcit=chapter') + beta 23 + wrong warnings about ambiguous citations while using `authorformat=year' + removed (bug reported by Anneke Emse). + french and dutch translations for translator stuff inserted, + contributed by Hélène Fernandez (french) and Maarten Wisse (dutch). + beta 22 + once again \biburlfont command rewritten, hyperlinks were missing. + beta 21 + new url-interface, contributed by Stefan Ulrich, solves problems + with url.sty and hyperref.sty. + some additions in (German) documentation. + beta 20 + some code for `idem' options rewritten + beta 19 + some code for `bibformat=ibidem' rewritten + beta 18 + some improvements for oxford, \or replaced by \TE@or again. + beta 17 + `authorformat=indexed' is working for \nobibliography now + (suggested by Thomas Rahlf). Thanks to Stefan Ulrich. + beta 16 + undo of improvements for jox.bst + ibidem options are able to make a difference between same/different + pages for subsequent citations by \samepageibidemname or + \samepageibidemmidname and \diffpageibidemname or + \diffpageibidemmidname + beta 15 + some improvements for the new jox.bst + beta 14 + endnotes-support: non-\footcite-commands are no longer automatically + converted into endnotes + beta 13 + \formatarticlepages[]{}{} + changed to + \formatpages[]{}{}{} + The allows you to specify any publication type for which + you want to print out a starting page + internal improvements (\jb@@title@switch (aka \jb@@arg) introduced to make a + difference between the multiple switch and the `titleformat=all' switch, + which has produced wrong warnings about ambiguous citations. + Multiple switching now with \jb@@mult@switch=1. Please report errors + regarding this changed feature) + improved endnotes-support + beta 12 + new command \jbdotafterendnote places dot after endnote, analogous + \jbdotafterbibentry + improved endotes.sty support -- emulated natbib cite commands are + translated into endnotes too + some internal improvements ... + beta 11 + new option `ibidem=name&title&auto' (suggested by Wolfgang Lange ) + built-in footmisc's `multiple'-option (comma between subsequent \footnotes) + (suggested by Wolfgang Lange ) + \jbPage and \jbartPage removed, formatting via \jbprformat now + beta 10 + `format.title' replaced by `format.artperiodincoll.title' for @inproceedings + (suggested by Olaf Meltzer) + beta 9 + known error message problem with url's and hyperref/url-package: + We have to wait for a general solution, coming + from url.sty and/or hyperref.sty. + special macros for gender-dependent i(bi)dem introduced -- separately for + bibliography (long) and citations (shorter). + some internal corrections and bug fixes. (regarding the footnote period problem). + a set of natbib emulating citation commands (without starred variants and + not so nifty) introduced. + beta 8 + \par's are possible inside the annote field + `opcit' no longer switches `authorformat=year' automatically, the + shorttitle will be used now to avoid ambiguous citations. + `gender'-field for German users of the `idem' option added. This field + can be used with six possible values:`sf'= singular female, + `pf'= plural male, `sm'=singular male,`pf'=plural male, + `sn'= singular neutrum and `pn'=plural neutrum. + new command \citetitleonly{} added, this command doesn't print the + author. + beta 7 + correction of some french macros + undocumented option `footnotes=marginal' is working now also when using endnotes.sty + `idem' is working properly for multiple keys (e.g. \footcite{,>key2>} will + produce `Author, title; idem, other title'). + beta 6 + `annote' option added. Enables output of the annote field. + For commented bibliographies. + `et al.'-generating mechanism for full names (non-labels) in jurabib.bst + and jureco.bst is now the same as for the label (more than three + authors/editors ==> et al.; this is already standard for jhuman.bst) + [...] + beta 1 + jurabib should work well now with endnotes.sty. You can use all cite + commands like before, the simple loading of endnotes.sty will print + all your citations as endnotes (well, you have to place \theendnotes + appropriate yourself). + Any `howcited'-option can be used with any other (except of `howcited=all'). + `howcited=compare' places the remark only, if the shorttitle was used + at least one time. + Missing documentation of some v0.5e features (new entry fields) added. + no longer LaTeX error message, if `authorformat=indexed' is used + without using makeidx.sty. You will get a warning from jurabib instead. + babel option `ngerman' is handled correct now (Thanks to Robert Schlicht). + `idem' is working now inside a bibliographic entry (i. e. if the editor + `edited a collection of articles and he himself wrote an article in it'). + small bug in definition of \bibimfont and \edfont removed. +v0.5e + Known Problem: Hyperref causes problems with the new url-interface. + New option `opcit'. Values: `true', `section' and `chapter'; + New option `idem' with values `strict', `strictdoublepage' + and `nostrict' implemented, places `idem' for same authors in + subsequent citations; + Bug with \formatarticlepages removed; + Some `authorformat=indexed'-related code rewritten by Stefan Ulrich; + German code documentation cancelled, English code documentation will + follow if I have more time; + jureco.bst is now part of the .dtx file, will be extracted with + `latex jurabib.ins'; + \Edbyname added for capitalized `Edited by'; + `von' part placement changed from `Last von, First' to `Last, First von'; + new command \jbannote to format the new annote field; + jurabib is working well now with TeX4ht, thanks to Eitan Gurari and + Maarten Wisse; + title check added for \citefield command to avoid ambiguous citations; + Sorting bug for @COMMENTED with editor only removed and et.~al-Bug removed; + Completely rewritten `bibformat=ibidem'; + Bug removed for `authorformat=and' and `authorformat=firstnotreversed'; + Wrong `Th\'ese' removed; + \jbformattedpages changed to option `pages=format', + \jbtestedpageranges changed to option `pages=test', + \jbalwayspageranges changed to option `pages=always'; + Bug removed for \jb@checkperiod (`natoptargorder' was ignored); + New fields shortauthor and shorttitle introduced, they can be + used like (i.e. instead of) the jura*-fields; + Bug removed for `crossref=short'; + \space-bug removed for crossrefs; + `pages=format' is working also for citations now, you can use some + shorthands as illustrated here: + \cite[45]{} ===> p.~45 + \cite[45--47]{} ===> pp.~45--47 + \cite[45, 47 and 49]{} ===> pp.~45, 47 and 49 + \cite[45f]{} ===> pp.~45f. + \cite[45ff]{} ===> pp.~45ff. + \cite[\nopage{I, III and IV}]{} ===> I, III and IV + \cite[13,\pageadd{something text}]{ p.~13, something text + This rewritten option was inspired by pageranges.sty, available at + , + and completely contributed by Stefan Ulrich. Thanks a lot. + It's possible to format editors independently from authors via: + \renewcommand\bibelnf{} + \renewcommand\bibefnf{}; + New options: + `crossref=dynamic' (first crossref long, the following short) + `edby' (switches from `Doe, John (editor)' to + `edited by Doe, John'---ONLY FOR @INCOLLECTIONS!), + `endnote', (note field at the end of the entry) + `biblikecite', (author and title format in bibliography like + author and title format in citation) + `citefull=chapter', (`citefull=first' per chapter) + `citefull=section', (`citefull=first' per section) + `superscriptedition=bib', (experimental!, superscripted edition + numbers in bibliography---for humanities) + `bibformat=ibidemalt', (experimental!, for german law students) + `bibformat=compress', (less vertical space between bibitems) + `human', (alpha stage option for the humanities) + `chicago', (alpha stage option for the humanities) + `oxford', (alpha stage option for the humanities) + `idem', (beta stage option for the humanities) + `idem=strict', + `idem=strictdoublepage', + `idem=nostrict', + `opcit', (alpha stage option for the humanities) + `opcit=chapter', (`opcit' per chapter) + `opcit=section', (`opcit' per section) + New commands: + \formatarticlepages[]{}{} + This command allows you to print out a (addtional) startpage + of a given pagerange, before the ``normal'' page(range), given + by the optional argument of \cite. + Assumed, you used \formatarticlepages[: ]{(}{)} + in the preamble, you typed `pages = {40--60}' in the .bib + file and you wrote \cite[45 and 47]{} in the text, + the output will look like that: + ..., 40: (45 and 47) + or with option `pages=format': + ..., p. 40: (pp. 45 and 47) + New fields in jurabib.bst: + titleaddon (adds the given sequence after title, e.g for remarks) + booktitleaddon (same as titleaddon, for booktitles) + editortype (use that field if you don't want to have `(ed.)') + sortkey (the entry will be sorted under that key) + annote (to put out a short abstract below the bib entry) + textedition (to use for a `commented' edition entry) + New BibTeX-styles for the humanities---compatible with jurabib.sty (alpha/beta stage!): + jchicago.bst (derivative of chicago.bst) alpha + jachicago.bst (derivative of achicago.bst) alpha + jhuman.bst (derivative of oxford.bst) beta + These styles doesn't contain all of the functionality known by jurabib.bst! + They are available only (as long as they are in beta stage) at + http://userpage.fu-berlin.de/~jberger +v0.5d \@lbibitem-Argumente auf zwei reduziert -- french.sty-Kompatibilität; + Zusammenfassung von Werten für Optionen möglich, z.B.: + `bibformat={tabular,numbered,ibidem} + erneute Überarbeitung der Sprachbehandlung, sprachspezifische Dateien + eingeführt; Änderung fast aller Makronamen innerhalb der \bibs-Definitionen; + Englische Dokumentation (größtenteils übersetzt von Maarten Wisse) eingefügt; + minimales Beispieldokument für Nicht-Juristen eingeführt +v0.5c `oldstyle' entfernt, `jurabibliography'-Umgebung ebenfalls entfernt + Handhabung des year-Feldes überarbeitet, neuen Befehl \jbyearaftertitle definiert + \citefield eingeführt, damit ist die Extraktion einzelner Felder aus einem + Eintrag möglich, die zu extrahierenden Felder werden als Parameter angegeben, + möglich sind: author, title, juraauthor, juratitle, year; + \nocitebuthowcited für Werke, die nicht zitiert wurden, die aber zusammen mit + einem howcited-Vermerk (der via howcited-Feld angegeben werden kann) im + Literaturverzeichnis erscheinen sollen, z.B. für Sammelwerke +v0.5b \cite[no]titlefortype eingeführt, damit ist die Angabe der Publikationstypen + möglich, bei denen der Titel immer erscheinen soll +v0.5a \jb@only@for@citations in \jbonlyforcitations umbenannt und hinter Definition von + \jb@tempa verlagert, so daß Zugriff auf \jb@@author etc. möglich ist; + Wiederherstellung von \ExecuteOptions wieder unmittelbar hinter \ProcessOptions + plaziert, sonst Probleme mit \makeat... in .cfg-Datei +v0.5 `authorformat=abbrv' eingeführt, jurabbrv.bst nun überflüssig (entfernt) +v0.4p \jurabibsetup zur Angabe der Optionen in Präambel oder Konfigurationsdatei eingeführt +v0.4o Kompatibilität mit index hergestellt; + Fehler in jurabib.dtx beseitigt +v0.4n \jbPage und \jbPages verbessert (reagieren jetzt auf `commabeforerest'); + bei Ausgabe der Warnung über mehrere `~et~al.' zusätzliche Prüfung eingefügt, + ob betreffendes Werk überhaupt zitiert wurde; + neuer Befehl \jb@do@if@multiple@bibetal zur leichteren Umdefinition + (wenn mehrere `$~et~al.' existieren) geschaffen; + \space-Befehl in \jb@makecheckednameibidem entfernt +v0.4m babel-Support verbessert, veränderte Sprachunterstützung (nun abhängig von der Hauptsprache) + `superscriptedition=switch' und \jbsseditionkerned implementiert; + Für Nicht-Juristen jbformattedpages implementiert; + in .bst innerhalb von output.bibitem missing$ durch empty$ ersetzt, da Fehlermeldungen bei leeren Feldern + \citeswithoutentry implementiert -- zur Angabe einzelner Werke, die nicht im Literaturverzeichnis + erscheinen sollen; + Möglichkeit einer lokalen Konfigurationsdatei geschaffen +v0.4l Bug bei `howcited' beseitigt (gemeldet von Christian.Meyn@gmx.de); + Optionen authorformat=year/indexed/and eingeführt; + auf mehrfachen Wunsch `titleformat=noreplace' eingeführt; + \Bibetal optimiert; + `backref'-Option von hyperref funktioniert nun auch bei bibformat=tabular vernünftig; + Ausrichtung der Autoren bei bibformat=tabular verbessert + Optionen `superscriptedition=commented|all' und `bibformat=ibidem' auf Anregung von + Tilman Finke (Tilman.Finke@web.de) implementiert; + Sortierfehler in .bst korrigiert +v0.4k Fehlendes Leerzeichen zwischen \Bibvolume und Inhalt des volume-Feldes beseitigt; + Möglichkeit der Einstellung, ob in .bib-Datei eingetragene Seitenangaben im + Zitat erscheinen oder nicht (\jbalwayspageranges setzt immer Seitenzahlen, + \jbtestedpageranges dagegen nur dann, wenn das für die Fundstelle + vorgesehene optionale Argument leer ist); + IS[S/B]N-Handhabung überarbeitet (doppelte Angabe bei crossref entfernt); + \jb@only@for@citations eingeführt -- damit sind lokale Definitionen möglich, + die nur in den Zitaten wirken (z.B. zur individuellen Einstellung der Querverweise); + \nextcite-Befehle um \nextcitenotitle erweitert +v0.4j \nextcite-Befehle und \noibidem eingeführt; + kleinere Bugfixes +v0.4I Kompatibilität mit hyperref verbessert; + multiple-Wert für howcited eingeführt; + kleinere Bugs behoben; + Entfernung von Seitenzahl(en) im Zitat, die nur in der Bibliographie erscheinen sollen +v0.4i umfangreiche Überarbeitung insbesondere der BibTeX-Stile; +beta + korrekte Behandlung von Querverweisen (vollständig LaTeX-seitig; + formatierbar durch Markup -- neue Option `crossref' ermöglicht + Wahl des Ausmaßes des Querverweises); + `lookat'-Option implementiert (ermöglicht automatisierte Verweise + auf Fußnoten) und `english'-Option eingeführt; + `replace' entfernt (Ersetzung nun automatisch); + language-Feld hinzugefügt, nun sprachspezifische Umschaltung für + jeden einzelnen Eintrag möglich; + \nobibliography} eingeführt (unterdrückt Ausgabe der Bibliographie) + Kompatibilität mit chapterbib.sty (\b@citeb durch \b@citeb\@extra@b@citeb ersetzt) + und bibunits.sty hergestellt (dafür \jb@@cite durch \@citex ersetzt); + ibidem-Funktionalität erweitert (strictdoublepage- und nostrict-Werte eingefügt); + Warnungen bei Ersetzung von juratitle durch title eingeführt; + footcite*-Befehle innerhalb von footnote abgefangen; + babel-Kompatibilität verbessert +v0.4h kleinere Bugfixes in \thebibliography (bibtopic sucht nach bib@heading, + dieses muß am Anfang der thebibliography-Umgebung stehen, deshalb Leerung + von \jbatsep hinter \bib@heading verlagert) und \@lbibitem (Sollte ohne + Autor und Herausgeber zitiert werden, Leerung von \bibansep für diesen + Eintrag, danach Wiederherstellung von \bibansep) +v0.4g Mit Hilfe von Oren Patashnik Funktionalität von add.period$ durch + .bst-Funktionen ersetzt, nun keine Satzzeichen (\bibatsep) mehr, + wenn Titel mit Punkt, Ausrufezeichen oder Fragezeichen endet; + \jb*authorsep gekürzt +v0.4f Optionsnamen verändert, jetzt Benutzung von keyval.sty +v0.4e neue Befehle \fullcite und \footfullcite, erstellen Vollzitat aus der Bibliographie + Optionen `citefull', `bibformat' und `see' implementiert +v0.4d Option `ibidem' eingeführt und erweitert, kein "`a.a.O."' bei erstem Zitat + auf einer Seite +v0.4c BibTeX-Stile verbessert, Abfragen zum Setzen des Titels hinter eingefügte + Warnungen verlagert; + vorläufige, eingeschränkte Kompatibilität von alphanum mit hyperref + durch Definition von \toclevel@*-Makros, hyperref-spezifischen Zählern + und Leerung von \J@SetCurrent sowie Redefinition von \J@LongToc; + \Hy@backout und \backcite redefiniert; Zuweisung der \cite-Befehle geändert; + \biburlfont in Abhängigkeit von geladenem hyperref definiert; + Warnungen bei mehrdeutigen Zitaten und Benutzung von \[foot]cite* eingefügt; + Beispieldokument zu bibtopic bereinigt +v0.4b Testdokument verändert, Kompatibilität mit hyperref hergestellt; + neue Befehle \footcite*, generieren automatisch Fußnoten +v0.4a Automatisches Ersetzen von fehlenden juraauthor- oder juratitle-Feldern + durch Teile des author-Feldes (Detektion der Nachnamen) bzw. title-Feldes + (bei Büchern), bei Artikeln wird Kurztitel aus journal und year + zusammengesetzt; + neue Option `replace', ersetzt (fehlenden) juratitle durch title; + Ligaturauflösung bei "`Auflage"' verändert; + Formatierung bei Generation der Namenskürzel verbessert; + Bestimmung der verwendeten \cite-Befehle verbessert; + erheblich übersichtlicherer Code bei cite; neuer Befehl \cite*, + unterdrückt immer Ausgabe des Titels; + konfigurierbare Separationszeichen +v0.4 viele kleine Änderungen, CTAN-Update +v0.3f howcited-Flag eingeführt +v0.3e Option `howcited=compare' eingeführt -- diese vergleicht + *title-Felder, bevor Zitiervermerk gesetzt wird; + Problem mit entry-string-size behoben; + korrekte Behandlung von Dissertationen -- auch solchen, die + als Buch erschienen sind +v0.3c Halbwegs realistisches Beispieldokument eingefügt; + BibTeX-Stile an zahlreichen Stellen verbessert +v0.3b @COMMENTED für Kommentare eingeführt, `citedas' heißt + nun `howcited', dies effizienter implementiert; + Querverweise werden jetzt korrekt behandelt; + viele kleine Verbesserungen +v0.3a Neue Option `citedas' +v0.3 Dokumentation verbessert, erstmalig auf CTAN verfügbar +v0.2c @PERIODICAL ist nun benutzbar, Klammerung formatierbar +v0.2b viele marginale Änderungen +v0.2a Erstmals jurabib.dtx und jurabib.ins +v0.2 Dynamisches Setzen des Titels bei Zitaten mit + verschiedenen Werken implementiert; + überflüssiges entfernt +v0.1 Erste Version, alpha-Stadium + Kompatibilität mit bibtopic.sty hergestell diff --git a/macros/latex/contrib/jurabib/docs/english/jbendoc.pdf b/macros/latex/contrib/jurabib/docs/english/jbendoc.pdf new file mode 100644 index 0000000000..2aa9fcfbe3 Binary files /dev/null and b/macros/latex/contrib/jurabib/docs/english/jbendoc.pdf differ diff --git a/macros/latex/contrib/jurabib/docs/english/jbendoc.tex b/macros/latex/contrib/jurabib/docs/english/jbendoc.tex new file mode 100644 index 0000000000..97bdb2c5c2 --- /dev/null +++ b/macros/latex/contrib/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{}#2\HCode{}} + \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]{} |& \dots{}, p.~45\\ + |\cite[45--47]{} |& \dots{}, pp.~45--47\\ + |\cite[45, 47 and 49]{} |& \dots{}, pp.~45, 47 and 49\\ + |\cite[45f]{} |& \dots{}, pp.~45f.\\ + |\cite[45ff]{} |& \dots{}, pp.~45ff.\\ + |\cite[\nopage{I, III and IV}]{} |& \dots{}, I, III and IV\\ + |\cite[13,\pageadd{something text}]{} |& \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 jurabib org} + +\newpage + +\bibliographystyle{jurabib} + +\end{document} diff --git a/macros/latex/contrib/jurabib/docs/german/jbgerdoc.pdf b/macros/latex/contrib/jurabib/docs/german/jbgerdoc.pdf new file mode 100644 index 0000000000..db822a228c Binary files /dev/null and b/macros/latex/contrib/jurabib/docs/german/jbgerdoc.pdf differ diff --git a/macros/latex/contrib/jurabib/docs/german/jbgerdoc.tex b/macros/latex/contrib/jurabib/docs/german/jbgerdoc.tex new file mode 100644 index 0000000000..d194352e7e --- /dev/null +++ b/macros/latex/contrib/jurabib/docs/german/jbgerdoc.tex @@ -0,0 +1,2422 @@ +\documentclass[a4paper]{ltxdoc} +\usepackage[latin1]{inputenc} +\usepackage[T1]{fontenc} +\usepackage{ae} +\usepackage[commabeforerest,titleformat=commasep]{jurabib} +\usepackage{german} +\interfootnotelinepenalty=10000 +\raggedbottom +\newif\ifHtml +\newcommand{\mymarginpar}[1]{\marginpar{\raggedleft\textsf{#1}}} +\newcommand{\NEW}[1]{\marginpar{\raggedleft\textsf{#1~{\large NEU\,!}}}} +\newcommand{\CH} [1]{\marginpar{\raggedleft\textsf{#1~{\large ÄNDERUNG\,!}}}} +\newcommand{\REM}[1]{\marginpar{\raggedleft\textsf{#1~{\large ENTFERNT\,!}}}} +\makeatletter + \@ifundefined{pdfoutput}{% + \let\pdfoutput\@undefined + \ExecuteOptions{dvips}% + }{% + \ifcase\pdfoutput + \let\pdfoutput\@undefined + \ExecuteOptions{dvips}% + \else + \usepackage[pdftex,colorlinks=true]{hyperref}% + \hypersetup{% + pdftitle={Documentation for jurabib package},% + pdfauthor={Jens Berger},% + }% + \fi + }% +\makeatother \pagestyle{headings} +\providecommand\mymarg[1]{{\unskip\ttfamily\char`\{}{\ttfamily#1}{\ttfamily\char`\}}} +\newcommand\bibentry[1]{\par\medskip{\renewcommand\jbauthorfont{\textbf}\renewcommand\jbauthorfnfont{\textbf}\noindent\qquad\fullcite{#1}}\par\medskip} +\AtEndDocument{\bibliography{jbtest,jbtesthu}} +\renewcommand{\contentsname}{Inhalt} +\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{Das \textsf{jurabib}-Paket} +\author{{\Large Jens Berger}\\ + \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{}#2\HCode{}} + \makeatletter + \let\DescribeMacro\@gobble + \let\NEW\@gobble + \let\CH\@gobble + \let\REM\@gobble + \let\mymarginpar\@gobble + \let\marginpar\@gobble + \makeatother + \fi + +\maketitle +\begin{abstract} +\noindent Dieses Paket ermöglicht die automatisierte Erstellung in der +Rechtswissenschaft und in den Geisteswissenschaften üblicher Zitate mittels +\BibTeX. Es stellt Befehle zur Verfügung, die es Juristen ermöglichen, Bearbeiter in +Kommentaren komfortabel anzugeben. Desweiteren wird eine vereinfachte +Formatierung sowohl der Zitate als auch der Einträge im Literaturverzeichnis +unterstützt. Außerdem ist es möglich, den (Kurz)Titel eines Werkes erst im +Zitat erscheinen zu lassen, wenn ein Autor mehrfach mit verschiedenen Werken +zitiert wurde. Die Verwendung eines Vollzitates, welches identisch mit dem +Eintrag im Literaturverzeichnis ist, wird ebenfalls unterstützt. Es sind +diverse Optionen verfügbar, die insbesondere für Nicht-Juristen interessant +sind -- so z.\,B. die Möglichkeit, verschieden ausführliche Wiederholungszitate +ausgeben zu lassen. Desweiteren läßt sich die Formatierung von Namen und +Vornamen der Autoren bezüglich der Reihenfolge sehr einfach verändern. Es sind +Querverweise auf andere Fußnoten möglich. Eine sprachspezifische Behandlung von +Literatureinträgen ist über das \texttt{language}-Feld zugänglich. +\end{abstract} + +\tableofcontents + +\section{Einleitung}\setcounter{page}{1} + +Bislang gab es für Juristen als Unterstützung der juristischen Zitierweise nur die +Umgebung \texttt{jurabibliography} aus \textsf{jura.cls}. Diese ist jedoch +nicht auf eine Zusammenarbeit mit \BibTeX{} ausgelegt. Dieses Problem wird von +\textsf{jurabib.sty} behoben. + +\textsf{jurabib.sty} definiert \cs{[foot]cite} so (um), daß es nun zwei +optionale Argumente besitzt, so daß die Angabe eines evtl. Bearbeiters über +dieses zweite optionale Argument erfolgen kann. Außerdem werden von den +dazugehörigen \BibTeX-Stilen (\texttt{jurabib.bst}, \texttt{jurunsrt.bst}, +\texttt{jureco.bst} und \texttt{jox.bst}) +Funktionen bereitgestellt, die es ermöglichen, daß +\begin{enumerate} +\item das Paket selbständig die Nachnamen der Autoren erkennt und daraus die + übliche Kurzform für das Zitat generiert. +\item für Zitate aus Zeitschriften und Periodika zudem automatisch das + übliche Kürzel aus Zeitschriftentitel und Jahr generiert wird. +\item in der \texttt{.bib}-Datei trotzdem eine explizite Angabe der zu + verwendenden Abkürzung sowohl des Autorennamens als auch des + Titels gemacht werden kann. +\item ein Kurztitel erst dann im Zitat erscheint, wenn der Autor mit mehr als + einem Werk zitiert wurde. +\end{enumerate} +Alle Funktionen werden \emph{ausschließlich} von o.g. \BibTeX-Stilen unterstützt. + +\section{Startvorbereitungen} + +Nachdem Sie \texttt{jurabib.ins} mit \LaTeX{} bearbeitet haben, entstehen im +wesentlichen folgende Dateien: + +\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 diverse \texttt{.ldf} Dateien + \item diverse \texttt{jbtest*.tex} Dateien +\end{itemize} +In einem TDS-konformen \TeX-System sollten \texttt{.sty}-Dateien und +\texttt{.ldf}-Dateien in \texttt{\slash [local]texmf\slash tex\slash +latex\slash jurabib} liegen, die \texttt{.bst}-Datei in \texttt{\slash +[local]texmf\slash bibtex\slash bst\slash jurabib} und \texttt{.bib}-Dateien in +\texttt{\slash [local]texmf\slash bibtex\slash bib\slash jurabib}. Je nach +verwendetem System kann es erforderlich sein, eine eventuell vorhandene +"`Filename Database"' zu aktualisieren. Wenn Sie teTeX verwenden, müssen Sie +\texttt{texhash}, bei MiKTeX \texttt{initexmf -u} oder die jeweiligen +graphischen Pendants benutzen. Alle genannten Dateien können auch im aktuellen +Arbeitsverzeichnis liegen. Die Dateien \texttt{jbtest.tex} und +\texttt{jbtest.bib} sollen die Verwendung des \textsf{jurabib}-Paketes +demonstrieren. + +\texttt{jbtestbt.tex} dient der Demonstration von \textsf{jurabib.sty} mit +\textsf{bibtopic.sty} zur Erzeugung gegliederter Literaturverzeichnisse. + +\texttt{jbtestmb.tex} dient der Demonstration von \textsf{jurabib.sty} mit +\textsf{multibib.sty} zur Erzeugung mehrerer Literaturverzeichnisse. + +\texttt{jbtestcb.tex} dient der Demonstration von \textsf{jurabib.sty} mit +\textsf{chapterbib.sty} zur Erzeugung von Kapitel-Literaturverzeichnissen. + +\texttt{jbtestbu.tex} dient ebenfalls der Demonstration von \textsf{jurabib.sty} mit +\textsf{bibunits.sty} zur Erzeugung untergliederter Literaturverzeichnisse. + +\bigskip + +Das Paket wird folgendermaßen eingebunden: + +\begin{quote} +\cs{usepackage}\oarg{Optionen}\texttt{\{jurabib\}} + +\noindent Ein kleiner Vorgriff: + +\noindent{\footnotesize Optionen lassen sich via \cs{jurabibsetup} in der Präambel +oder in der Konfigurationsdatei ablegen: +\begin{verbatim} + \jurabibsetup{ + authorformat=smallcaps, + commabeforerest, + titleformat=colonsep, + bibformat=tabular + } +\end{verbatim} +Sie können verschiedene Werte für dieselbe Option +zusammenfassen: +\begin{verbatim} + \jurabibsetup{bibformat={tabular,ibidem,numbered}} +\end{verbatim}} +\end{quote} + +An der Stelle, wo später Ihr Literaturverzeichnis erscheinen soll, muß +folgendes stehen: + +\begin{quote} + \cs{bibliography}\marg{Datenbank} +\end{quote} +gefolgt von +\begin{quote} + \cs{bibliographystyle}\mymarg{jurabib} +\end{quote} + +Damit ist das Paket einsatzbereit. Sollten Sie bislang nicht mit \BibTeX{} +gearbeitet haben, beachten Sie bitte, daß zu einer korrekten Auflösung aller +Referenzen einmal \LaTeX{} aufgerufen werden muß, dann einmal \BibTeX{} und im +Anschluß noch zweimal \LaTeX: + +\begin{verbatim} + latex datei + bibtex datei + latex datei + latex datei +\end{verbatim} + +\subsection{Wenn Sie eine Windows-Distribution verwenden} +Sie müssen hier eine große Bib\TeX-Version (|bibtex8|) verwenden, bei der +der \marginpar{\raggedleft\textsf{\Huge !!!}} Speicher von vornherein sehr groß +oder zur Laufzeit erweiterbar ist. Anderenfalls werden Sie in etwa folgende +Fehlermeldung erhalten: +\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} +Dieses Problem beheben Sie durch Angabe des Parameters \texttt{--big} (bzw. +\texttt{--huge} oder \texttt{--wolfgang}), so daß Ihr BibTeX-Aufruf ungefähr so +aussehen sollte: +\begin{verbatim} + bibtex8 --wolfgang datei +\end{verbatim} + +\subsection{Wenn Sie eine Unix/Linux-Distribution verwenden} +Hier ist bei Verwendung von aktuellen te\TeX- oder \TeX Live-Distributionen keine Verwendung von +|bibtex8| nötig, da sie mit ausreichend großem Speicher kompiliert wurden. Trotzdem möchte die +Verwendung von |bibtex8| empfehlen, da es die korrekte Sortierung von Einträgen mit Umlauten +ermöglicht, ohne daß man diese in eine dem normalen Bib\TeX{} genehme Form (|{\"u}|) etc. bringen +muss. Dies ist demzufolge bei Verwendung des normalen Bib\TeX{} nötig\,! Leider ist bislang +|bibtex8| nur in der \TeX Live-Distribution enthalten, bei te\TeX{} fehlt es. Dort müssen Sie +sich die Sourcen selbst übersetzen, Sie finden sie im CTAN. + +\section[Ein Beispiel]{Ein Beispiel\footnotemark[1]} +\footnotetext[1]{Für alle Beispiele sind -- sofern nicht anders angegeben -- +die Optionen \texttt{titleformat=commasep} und \texttt{commabeforerest} sowie +der Befehl \cs{cite} verwendet worden.} + +Ein Werk soll zitiert werden. Dazu fügen Sie dieses Werk der +Literaturdatenbank hinzu: + +\begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Krämer}, + title = {Straßenrecht}, + shortauthor = {Kodal/Krämer}, + shorttitle = {StrR}, + year = 1995, + address = {München}, + edition = {5.}, + pages = {30--34, \S~24} + } +\end{verbatim} +Man beachte die Felder \texttt{shortauthor} und \texttt{shorttitle}. Sie werden +von dem zum \textsf{jurabib}-Paket gehörenden \BibTeX-Stil bereitgestellt. Dort +werden die gewünschten Kurzformen von Autor und Titel eingetragen (siehe dazu +auch Abschnitt~\ref{auto} auf Seite~\pageref{auto}). + +\section{Das Werkzeug} + +\subsection{Die \texorpdfstring{\cs{cite}}{cite}-Befehle} + +\DescribeMacro{\cite} +Ein Zitat wird wie gewohnt angegeben: +\begin{verbatim} + \cite[\S~12]{kkstrr} +\end{verbatim} +Anstelle dieses Erscheinungsbildes: + +\medskip + +[1, \S~12] + +\medskip + +\noindent sieht das Ergebnis nun so aus: + +\medskip + +\cite[\S~12]{kkstrr} + +\medskip + +\noindent Die Kurzform des Titels (StrR) würde hier erst zitiert werden, wenn Kodal und +Krämer mit einem anderen Werk zitiert werden. Dann sähe das Ganze so aus: + +\medskip + +\citetitle[\S~12]{kkstrr} + +\medskip + +\noindent Da der Befehl \cs{cite} durch \textsf{jurabib.sty} umdefiniert wird, besitzt er +jetzt statt einem optionalen Argument derer zwei: + +\medskip + +\noindent\CH{0.6} +\fbox{\begin{minipage}{\textwidth} +{\Large\itshape Achtung: Mit Version 0.6 ist die Reihenfolge der optionalen Argumente geändert worden\,!} +\begin{quote} +\cs{cite}\oarg{Fundstelle}\marg{Kürzel}\\ +\cs{cite}\oarg{Bearbeiter}{\ttfamily[]}\marg{Kürzel}\\ +\cs{cite}\oarg{Bearbeiter}\oarg{Fundstelle}\marg{Kürzel}\\ +bzw. (mit \texttt{see})\\ +\cs{cite}{\ttfamily[Vgl.]}\oarg{Fundstelle}\marg{Kürzel} +\end{quote} +Zur Abwärtskompatibilität wird mit der Option \texttt{jurabiborder} die alte Reihenfolge der optionalen +Argumente wiederhergestellt: +\begin{quote} +\cs{cite}\oarg{Fundstelle}\marg{Kürzel}\\ +\cs{cite}{\ttfamily[]}\oarg{Bearbeiter}\marg{Kürzel}\\ +\cs{cite}\oarg{Fundstelle}\oarg{Bearbeiter}\marg{Kürzel}\\ +bzw. (mit \texttt{see})\\ +\cs{cite}\oarg{Fundstelle}{\ttfamily[Vgl.]}\marg{Kürzel} +\end{quote} +\end{minipage}} + +\medskip + +\noindent Hier eine kleine Übersicht der ab Version 0.6 geltenden Verhältnisse: + +\medskip + +{\small +\begin{tabular}{ll} +\hline +Quellcode & Ausgabe\\ +\hline +|\cite{broxbgb}| & \cite{broxbgb}\\ +|\cite[S.~12]{broxbgb}| & \cite[S.~12]{broxbgb}\\ +|\cite[Bassenge][]{broxbgb}| & \cite[Bassenge][]{broxbgb}\\ +|\cite[Bassenge][S.~12]{broxbgb}| & \cite[Bassenge][S.~12]{broxbgb}\\ +\hline +\end{tabular}} + +\bigskip + +\noindent Ein eventuell vorhandener Bearbeiter wird also nun folgendermaßen angegeben: +\begin{verbatim} + \cite[Bassenge][\S~12]{kkstrr} +\end{verbatim} +Daraus würde --~eine mehrfache Zitierung von Kodal und Krämer vorausgesetzt~-- +folgendes Zitat entstehen: + +\medskip + +\cite[Bassenge][\S~12]{kkstrr} % Kodal/Krämer/Bassenge, StrR, \S~12. + +\medskip + +\noindent Der dazugehörige Eintrag im Literaturverzeichnis wäre dann: + +\bibentry{kkstrr} + +Möchten Sie ibn einem Zitat keine Seitenzahlen, Randnummern oder ähnliches, +jedoch einen Bearbeiter angeben, müssen Sie das zweite (neu\,!) optionale Argument von +\cs{cite} leer lassen: + +\begin{verbatim} + \cite[Bassenge][]{kkstrr}% vor 0.6: \cite[][Bassenge]{kkstrr} +\end{verbatim} + + \DescribeMacro{\citetitle} +Der Befehl \cs{citetitle} verhält sich prinzipiell wie \cs{cite}, kann aber +dazu benutzt werden, ein Werk explizit mit dem Kurztitel zu zitieren, +unabhängig davon, ob ein weiteres Werk dieses Autors zitiert wird. Ansonsten +gilt für diesen Befehl das zu \cs{cite} Gesagte. + + \DescribeMacro{\cite*} +Diese Sternform des \cs{cite}-Befehls zitiert \emph{grundsätzlich ohne} Titel. +Es ist dabei völlig unerheblich, ob das \texttt{shorttitle}-Feld besetzt ist. +Auch die Option \texttt{citefull=all} (siehe Abschnitt~\ref{opt}) zeigt hier +keinerlei Wirkung. Zu beachten ist hierbei jedoch, daß hierdurch bei Zitierung +mehrerer verschiedener Werke eines Autors +\emph{zweideutige\mymarginpar{\hfill\Large!} Zitate} entstehen können, da auch +das Feature des automatischen Setzens des Kurztitels/Volltitels für dieses +Zitat deaktiviert wird. Von daher sollte die Benutzung dieses Befehls die +Ausnahme sein und mit Bedacht gewählt werden. + +\DescribeMacro{\citetitlefortype} +Auf mehrfachen Wunsch hin ist nun mit diesem +Befehl die Angabe der Publikationstypen möglich, bei denen der Titel immer +erscheinen soll: +\begin{verbatim} + \citetitlefortype{article,commented, ... } +\end{verbatim} +Dies kann zum Beispiel sinnvoll sein, wenn man (nur) bei Aufsätzen den Titel +des Journals angeben möchte und ansonsten \textsf{jurabib} die Entscheidung +überlassen möchte, wann es den Titel eines Werkes setzt (nämlich erst, wenn ein +Zitat mehrdeutig zu werden droht). \DescribeMacro{\citenotitlefortype} Falls es +viele (aber eben nicht alle) Publikationstypen sind, bei denen Sie den Titel +auszugeben wünschen, können Sie nach Setzen der Option \texttt{titleformat=all} +mit +\begin{verbatim} + \citenotitlefortype{article,commented, ... } +\end{verbatim} +diejenigen Typen deklarieren, bei denen der Titel nicht erscheinen soll. + +\subsection{Die \texorpdfstring{\cs{footcite}}{footcite}-Befehle} +\DescribeMacro{\footcite} \DescribeMacro{\footcite*} +\DescribeMacro{\footcitetitle} Sie unterscheiden sich lediglich dadurch von den +\cs{cite}-Befehlen, daß sie automatisch eine Fußnote generieren und dabei am +Ende der Fußnote einen Punkt setzen. Ein Leerzeichen vor den +\cs{footcite}-Befehlen wird ignoriert: +\begin{verbatim} + ... Annahme. \footcite[Rn.~357]{medicus} + ... Annahme.\footcite[Rn.~357]{medicus} +\end{verbatim} +erzeugt in beiden Fällen: + +\medskip +\dots{}~Annahme.\footcite[Rn.~357]{medicus} +\medskip + +\noindent Eine Zusammenfassung mehrerer Zitate innerhalb einer Fußnote erfolgt +jedoch wie bisher: +\begin{verbatim} + \footnote{\cite[S.~13--34]{brox:bgb}; \cite[S.~24]{canaris}.} +\end{verbatim} +Dieses liefert uns: + +\medskip +\dots{}~Annahme.\footnote{\cite[S.~13--34]{broxbgb}; \cite[S.~24]{canaris}.} Hier muß man +leider selbst an den Punkt denken. + +Sollten Sie mehrere |\footcite|- oder |\footnote|-Befehle +unmittelbar hintereinander benutzen, ist \textsf{jurabib} in Verbindung +mit dem \textsf{footmisc}-Paket und dessen |multiple|-Option in der Lage, +automatisch ein Komma zwischen die Fußnotenmarken zu setzen. Ein Beispiel: + +\begin{verbatim} + ... zu finden\footcite{broxbgb}\footcite{broxschr}\footcite{broxja} +\end{verbatim} +erzeugt: + +\medskip +\dots{}~zu finden \textsuperscript{1,2,3} + + +\subsection{Die \texorpdfstring{\cs{fullcite}}{fullcite}-Befehle} + \DescribeMacro{\fullcite} + \DescribeMacro{\footfullcite} +Diese Befehle generieren ein Vollzitat, d.\,h. hier wird der komplette Eintrag +aus dem Literaturverzeichnis als Zitat verwendet. Ein eventuell vorhandener +Bearbeiter wird vor dem Zitat plaziert und mit "`in"' vom Autor +getrennt.\footnote{Dies entspricht der automatischen Aktivierung der Option +\texttt{annotatorfirstsep=in} für \emph{dieses} Zitat.} Die Fundstelle wird am Ende +angefügt. + +\subsection{Die \texorpdfstring{\cs{nextcite}}{nextcite}-Befehle} + \DescribeMacro{\nextciteshort} + \DescribeMacro{\nextcitefull} +Mit Hilfe dieser Befehle können Sie für bestimmte Werke festlegen, ob sie im +Weiteren in der Kurzform bzw. der Langform erscheinen sollen. Dazu können Sie +einfach eine kommaseparierte Liste (\emph{ohne Leerzeichen\,!}) als Argument +dieser Kommandos angeben: +\begin{verbatim} + \nextciteshort{brox:bgb,canaris, ... } +\end{verbatim} +läßt ab sofort \texttt{brox:bgb} und \texttt{canaris} als Kurzzitat erscheinen. +\begin{verbatim} + \nextcitefull{brox:bgb,canaris, ... } +\end{verbatim} +läßt alle weiteren Zitate von \texttt{brox:bgb} und \texttt{canaris} als +Vollzitat erscheinen. + +\begin{verbatim} + \nextcitenotitle{brox:bgb,canaris, ... } +\end{verbatim} +läßt alle weiteren Zitate von \texttt{brox:bgb} und \texttt{canaris} als Zitat +ohne Titel erscheinen. \emph{Den drei Kommandos ist gemein, daß sie die +\cs{fullcite}- und \cs{cite*}-Befehle übersteuern!} + +\smallskip +\noindent Mit \DescribeMacro{\nextcitereset} +\begin{verbatim} + \nextcitereset{brox:bgb,canaris, ... } +\end{verbatim} +schalten Sie für die angegebenen Werke wieder auf normale Zitierweise zurück. + +\DescribeMacro{\citeswithoutentry} Das neue Kommando \cs{citeswithoutentry} ist +eng verwandt mit den \cs{nextcite}-Befehlen. Mit ihm können Sie am Anfang des +Dokumentes die Werke angeben, die \emph{nicht} im Literaturverzeichnis +erscheinen sollen. Die Verwendung erfolgt analog zu den \cs{nextcite}-Befehlen. +Allerdings wirkt sich hier -- aus verständlichen Gründen~-- der +\cs{nextcitereset}-Befehl nicht aus. + +\subsection{Der \texorpdfstring{\cs{citefield}}{citefield}-Befehl} +Mit diesem Befehl haben Sie Zugriff auf den Inhalt der Felder \texttt{author}, +\texttt{shortauthor}, \texttt{title}, \texttt{shorttitle}, \texttt{url}, \texttt{apy} +(Address-Publisher-Year) und \texttt{year}. +Diesen Feldnamen (\emph{der in Kleinschreibung anzugeben ist\,!}) geben Sie als erstes obligatorisches Argument an, das Kürzel als zweites obligatorisches Argument. Die Angabe einer Fundstelle ist über den +optionalen Parameter möglich: +\begin{quote} + {\small\cs{citefield}\oarg{Fundstelle}\marg{Feldname}\marg{Kürzel}} +\end{quote} +Mit folgendem Eintrag +\begin{verbatim} + @BOOK{broxbgb, + author = {Hans Brox}, + title = {Allgemeiner Teil des Bürgerlichen Gesetzbuches}, + shorttitle = {BGB~AT}, + year = 1996, + language = {german}, + address = {Köln, Berlin, Bonn, München}, + edition = 20 + } +\end{verbatim} +liefert uns ein \verb+\citefield{title}{broxbgb}+: Allgemeiner Teil des +Bürgerlichen Gesetzbuches. \verb+\citefield[\S~23]{shorttitle}{broxbgb}+ +liefert: BGB~AT, \S~23. + +Dieser Befehl ist in erster Linie für Nicht-Juristen vorgesehen. Er ist von +allen \textsf{jurabib}-spezifischen Automatismen unabhängig, d.\,h. er wird +u.a. nicht von den \texttt{ibidem}-Optionen erfaßt, da er lediglich dazu dient, +auf einzelne Felder zuzugreifen. + +Bei Verwendung des \textsf{hyperref}-Paketes erzeugt dieser Befehl +jedoch einen Link ins Literaturverzeichnis. + +\textsf{jurabib} beherrscht auch einige grundlegende Befehle aus dem \textsf{natbib}-Paket: + +\medskip + +\begin{tabular}{@{}lll@{}}\hline\\[-2ex] +|\[foot]citep{Kraft74}| & $\rightarrow$ & \citep{Kraft74}\\ +|\[foot]citep{Kraft74,helm82}| & $\rightarrow$ & \citep{Kraft74,helm82}\\ +|\[foot]citep[][S.~34]{Kraft74}| & $\rightarrow$ & \citep[][S.~34]{Kraft74}\\ +|\[foot]citep[Vgl.][S.~34]{Kraft74}| & $\rightarrow$ & \citep[Vgl.][S.~34]{Kraft74}\\ +|\[foot]citet{Kraft74}| & $\rightarrow$ & \citet{Kraft74}\\ +|\[foot]citet{Kraft74,helm82}| & $\rightarrow$ & \citet{Kraft74,helm82}\\ +|\[foot]citealt{Kraft74}| & $\rightarrow$ & \citealt{Kraft74}\\ +|\[foot]citealt{Kraft74,helm82}| & $\rightarrow$ & \citealt{Kraft74,helm82}\\ +|\[foot]citealp{Kraft74}| & $\rightarrow$ & \citealp{Kraft74}\\ +|\[foot]citealp{Kraft74,helm82}| & $\rightarrow$ & \citealp{Kraft74,helm82}\\ +|\[foot]citeauthor{Kraft74}| & $\rightarrow$ & \citeauthor{Kraft74}\\ +\hline +\end{tabular} + +\section{Automatisierungen}\label{auto} + +\subsection{Leeres \texttt{shortauthor}-Feld} + +Bei einem nicht besetzten oder fehlenden \texttt{shortauthor}-Feld ist +\textsf{jurabib} in der Lage, die Nachnamen der Autoren selbständig zu erkennen +und als Ersatz zu verwenden. Dabei werden bis zu drei Autoren ausgeschrieben, +getrennt durch einen Schrägstrich. Bei mehr als drei Autoren wird der erste +Autor mit dem Kürzel "`et\,al."' versehen verwendet. Angenommen, in unserem +obigen Beispiel lassen wir das \texttt{shortauthor}-Feld weg und fügen einen +dritten Autor hinzu: +\begin{verbatim} +@BOOK{LunWalThis99, + editor = {Lundin, Roger and Walhout, Clarence and Thiselton, Anthony C.}, + gender = {pm}, + year = 1999, + title = {The Promise of Hermeneutics}, + publisher = {Eerdmans}, + address = {Grand Rapids}, +} +\end{verbatim} +dann sieht das Zitat folgendermaßen aus: + +\par\medskip +\cite{LunWalThis99} +\par\medskip + +\noindent Dabei lassen sich die Separationszeichen an eigene Vorstellungen +anpassen. +\begin{verbatim} + \renewcommand*{\jbbtasep}{ und } % bta = between two authors sep + \renewcommand*{\jbbfsasep}{, } % bfsa = between first and second author sep + \renewcommand*{\jbbstasep}{ und }% bsta = between second and third author sep +\end{verbatim} + +\noindent Die Separation der Autoren im Literaturverzeichnis bleibt davon +unberührt. Sie läßt sich über die folgenden Befehle beeinflussen: +\begin{verbatim} + \renewcommand*{\bibbtasep}{ und } % bta = between two authors sep + \renewcommand*{\bibbfsasep}{, } % bfsa = between first and second author sep + \renewcommand*{\bibbstasep}{ und }% bsta = between second and third author sep + ... und für die Herausgeber: + \renewcommand*{\bibbtesep}{ und } % bte = between two editors sep + \renewcommand*{\bibbfsesep}{, } % bfse = between first and second editor sep + \renewcommand*{\bibbstesep}{ und }% bste = between second and third editor sep +\end{verbatim} + +Fügen wir einen vierten Autor hinzu (den Quellcode dazu sparen wir uns), ändert +sich das Erscheinungsbild nochmals: +\par\medskip +\qquad Lundin~et\,al. + +\subsection{Leeres \texttt{shorttitle}-Feld} +Für ein leeres \texttt{shorttitle}-Feld gilt folgendes: Es wird als Ersatz der +\emph{volle} Inhalt des \texttt{title}-Feldes verwendet\footnote{Davon +ausgenommen sind Einträge des \texttt{@ARTICLE}- und \texttt{@PERIODICAL} +Typs.}, + sofern entweder (lokal) der Befehl \cs{[foot]citetitle} oder (global) die Option +\texttt{citefull=all} verwendet wird \emph{oder der betreffende Verfasser mit +noch weiteren Werken zitiert wird}. + +Möchte man, daß bei einem bestimmten Werk immer -- egal welche Optionen +aktiviert sind -- lediglich der Autorenname erscheint, dann ist der Befehl +\cs{[foot]cite*} zu verwenden. Allerdings kann dies zu zweideutigen Zitaten +führen. Sie werden jedoch dazu eine Warnung in der \texttt{.log}-Datei finden. + +\begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Krämer + and Hans Mustermann}, + title = {Straßenrecht}, + year = 1995, + address = {München}, + edition = {5.}, + pages = {30--34, \S~24} + } +\end{verbatim} +Ergebnis: +\par\medskip +\qquad Kodal/Krämer/Mustermann, Straßenrecht, \S~12. +\par\medskip + +Eine Erleichterung sollte auch die Tatsache sein, daß \textsf{jurabib} in +der Lage ist, die bei Artikeln und Periodika übliche Zitierung (\meta{journal} +\meta{year}) zu automatisieren. Daher ist eine Angabe von \texttt{shorttitle} +nunmehr nur noch nötig, wenn man davon abweichende Vorstellungen hat. Im folgenden +Beispiel ist weder \texttt{shortauthor} noch \texttt{shorttitle} angegeben: +\begin{verbatim} + @ARTICLE{broxja, + author = {Hans Brox}, + title = {Die Anfechtung bei der Stellvertretung}, + journal = {JA}, + year = 1980, + pages = {449ff}, + address = {München} + } +\end{verbatim} +Trotzdem erhält man mit \cs{citetitle}\verb+{brox:ja}+ folgendes Zitat: +\par\medskip +\qquad Brox, JA 1980. +\par\medskip +\noindent Möchte man dagegen etwas anderes verwenden, benutzt man die +\texttt{jura*}-Felder: +\begin{verbatim} + @ARTICLE{broxja, + author = {Hans Brox}, + title = {Die Anfechtung bei der Stellvertretung}, + journal = {JA}, + shortauthor = {Hans Brox}, + shorttitle = {JA}, + year = 1980, + pages = {449ff}, + address = {München} + } +\end{verbatim} +und man erhält: +\par\medskip +\qquad Hans Brox, JA. +\par\medskip + +\DescribeMacro{author = } Es ist zu beachten, daß das dynamische Setzen des +juristischen Kurztitels nur unterstützt werden kann, wenn die Inhalte der +\texttt{author}-Felder in der \texttt{.bib}-Datei \emph{absolut identisch} +sind! Angenommen, \textsc{Kodal} und \textsc{Krämer} haben ein zweites Werk +verfaßt, dann sollten die Einträge in der Literaturdatenbank so aussehen: +\begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Krämer}, + title = {Straßenrecht} + } +\end{verbatim} + +\begin{verbatim} + @BOOK{kkirgendwas, + author = {Kurt Kodal and Joachim Krämer}, + title = {irgendwas} + } +\end{verbatim} + +\section{Optionen}\label{opt} +Folgendes Erscheinungsbild ist voreingestellt: Die Autoren und Bearbeiter im +Zitat werden in Standardschrift, im Literaturverzeichnis fett gesetzt. Der +Bearbeiter ist dem Autor nachgestellt, die Trennung erfolgt durch einen +Schrägstrich. Diese Formatierungen lassen sich über Optionen beeinflussen. + +\subsection{Möglichkeiten der Formatierung des Zitates} + +\subsubsection{Formatierung von Autor und Bearbeiter} + + \begin{Options} + \item[authorformat=smallcaps] setzt Autoren (und Bearbeiter) in Kapitälchen: + \textsc{Kodal\slash Krämer\slash Bassenge}, StrR, \S~12 + \item[authorformat=italic] setzt Autoren (und Bearbeiter) kursiv: + \textit{Kodal}\slash\textit{Krämer}\slash\textit{Bassenge}, StrR, \S~12 + \item[authorformat=dynamic] die Autoren erhalten einen Schrift"-schnitt, der davon + beeinflußt wird, ob ein Bearbeiter angegeben wurde oder nicht. + Sofern kein Bearbeiter angegeben ist, erhalten die Autoren über den Befehl + \cs{jbactualauthorfont} den Font \cs{textit} (voreingestellt) zugewiesen: + \textit{Kodal\slash Krämer}, StrR, \S~12. + Ist ein Bearbeiter angegeben worden, erhält \emph{dieser} nun die + aktuelle Bedeutung + von \cs{jbactualauthorfont}, und die Autoren werden über den Befehl + \cs{jbauthorfontifcoauthor} formatiert (Voreinstellung \cs{normalfont}): + Kodal\slash Krämer\slash\textit{Bassenge}, StrR, \S~12. + \item[authorformat=citationreversed] Hier erscheinen \emph{im Zitat} bei den Optionen + \texttt{citefull=first}, \texttt{ibidem=name} und + \texttt{ibidem=name\&title} die Vornamen vor den Nachnamen: + Hans \textsc{Brox}: BGB~AT, S.~23. statt \textsc{Brox}, Hans: BGB~AT, S.~23. + \item[authorformat=allreversed] Mit dieser Option erstreckt sich obiges Verhalten auch auf + das Literaturverzeichnis. + \item[authorformat=firstnotreversed] Hiermit hat man die Möglichkeit, alle + Autorennamen \emph{nach} dem ersten Autor in der Form \meta{Vorname} + \meta{Name} zu setzen: \textsc{Kodal}, Kurt/Joachim + \textsc{Krämer}/Hans \textsc{Mustermann}. + \item[authorformat=reducedifibidem] Hier wird bei aktivierter Option \texttt{ibidem=name} im + Wiederholungszitat nur der Nachname ausgegeben. + \item[authorformat=and] Statt der voreingestellten Schrägstriche werden die Autoren + nun mit "`,"' und "`und"' getrennt. + \item[authorformat=year] Nach den Autoren wird die Jahreszahl ausgegeben. + Eine Formatierung ist möglich über \cs{jbcitationyearformat}: + \begin{verbatim} + \renewcommand*{\jbcitationyearformat}[1]{(#1)} + \end{verbatim} + Diese Option ist vorrangig für die Benutzung mit \texttt{jureco.bst} gedacht. + \item[authorformat=indexed] führt automatisch \emph{alle} Autoren unabhängig + voneinander im Index auf. Voraussetzung ist eine korrekte + Verwendung des \textsf{makeidx}-Paketes. + \begin{verbatim} + \usepackage{makeidx} + \makeindex + \begin{document} + ... + \printindex + \end{document} + \end{verbatim} + Eine Indizierung ist auch bei Verwendung des Befehls |\nobibliography| möglich. + + \emph{Nur} im Literaturverzeichnis genannte Autoren tauchen per Voreinstellung + nicht im Index auf. Möchte man dies ändern, benutzt man den Befehl + \cs{jbindexbib} am Anfang des Dokumentes. + + Um die Autoren im Index hervorzuheben ist es möglich, ihnen über den Befehl |\jbauthorindexfont| einen Font zuzuweisen: + \begin{verbatim} + \renewcommand{\jbauthorindexfont}{\textit}% oder \textsf, \textsc, \textbf + \end{verbatim} + Falls Sie eine angepasste |.ist|-Datei (|makeindex| style file) benutzen, kann es nötig sein, + den |makeindex|-eigenen `actual' operator über |\jbmakeindexactual| anzupassen. Die (englische) + Voreinstellung ist |@|. Sollte Ihre |.ist|-Datei folgende Zeile enthalten: + \begin{verbatim} + actual '=' + \end{verbatim} + sollten Sie folgendes benutzen: + \begin{verbatim} + \renewcommand{\jbmakeindexactual}{\=}% + \end{verbatim} +Es wurde vielfach der Wunsch geäußert, die \NEW{0.6} Indizierung genauer steuern zu können. Die folgenden Befehle leisten das hoffentlich: + +{\small\begin{tabular}{ll} +\hline +|\jbdonotindexeditors| & Herausgeber nicht indizieren\\ +|\jbdonotindexauthors| & Autoren nicht indizieren\\ +|\jbdonotindexorganizations| & Organisationen nicht indizieren\\ +|\jbindexolyfirsteditors| & Herausgeber nur für Erstzitat indizieren\\ +|\jbindexonlyfirstauthors| & Autoren nur für Erstzitat indizieren\\ +|\jbindexolyfirstorganizations| & Organisationen nur für Erstzitat indizieren\\ +\hline +\end{tabular}} + +\medskip + +% Ich weiß leider momentan noch nicht, warum ausgerechnet bei diesem Zeichen ein +% backslash nötig ist, da |makeindex| ohne ihn bei mir abstürzt (Mik\TeX{} 2.1). +% Über Meldungen, wie das unter anderen Systemen ist, würde ich mich freuen. + + \item[authorformat=abbrv] Abkürzung der Vornamen. + \item[annotatorformat=italic (früher: coauthorformat=italic)] setzt den Bearbeiter\CH{0.6} kursiv: + Kodal\slash Krämer\slash \textit{Bassenge}. + \item[annotatorformat=normal (früher: coauthorformat=normal)] setzt Bearbeiter\CH{0.6} aufrecht: + \textit{Kodal}\slash \textit{Krämer}\slash\/Bassenge. + \item[round] runde Klammern für das Zitat: (\textsc{Kodal}\slash + \textsc{Krämer}\slash\/\textsc{Bassenge}). + \item[square] setzt das Zitat in eckige Klammern: [\textsc{Kodal}\slash + \textsc{Krämer}\slash\/\textsc{Bassenge}]. + \item[superscriptedition=all] Hiermit wird die Auflage bei allen Werken + als hochgestellte Zahl ausgegeben, wobei dies nicht für Vollzitate gilt. +Hier ein paar Beispiele: +\par +Kodal/Krämer$^{3}$, \S~12.\\ +Kodal/Krämer, Straßenrecht$^{3}$, \S~12.\\ +Kodal/Krämer--Bassenge, Straßenrecht$^{3}$, \S~12.\\ +Bassenge in Kodal/Krämer$^{3}$, \S~12. +\par\medskip + \item[superscriptedition=commented] Damit schränkt man oben genanntes Verhalten + auf Publikationen vom Typ \texttt{@COMMENTED} ein. + \item[superscriptedition=switch] Man kann hiermit für jedes + Werk individuell angeben, ob die Auflage hochgestellt erscheinen soll. + Dazu dient das ebenfalls neu geschaffene \texttt{ssedition}-Feld, das + analog zum \texttt{howcited}-Feld mit dem Wert \texttt{1} als Schalter + fungiert: + \begin{verbatim} + @COMMENTED{soergel, + author = {Hans Theodor Soergel}, + title = {Kommentar zum Bürgerlichen Gesetzbuch}, + address = {Stuttgart, Berlin, Köln, Mainz}, + year = 1987, + edition = 12, + ssedition = 1, + } + \end{verbatim} + +% \item[superscriptedition=kerning] Die den hochgestellten Auflagen folgenden Zeichen werden +% unterschnitten: +% +% Kodal/Krämer$^{3}$\kern-1ex, \S~12.\\ +% Kodal/Krämer, Straßenrecht$^{3}$\kern-1ex, \S~12.\\ +% Kodal/Krämer$^{3}$--Bassenge, \S~12.\\ +% Kodal/Krämer--Bassenge, Straßenrecht$^{3}$\kern-1ex, \S~12.\\ +% Bassenge in Kodal/Krämer$^{3}$\kern-1ex, \S~12. +% \par\medskip + +\item[superscriptedition=bib/address] Hochgestellte Auflagen im Literaturverzeichnis + (vor address), für Nicht-Juristen. +\item[superscriptedition=year] Hochgestellte Auflagen im Literaturverzeichnis + (vor year), für Nicht-Juristen. +\item[superscriptedition=multiple] Mit Hilfe dieser Option wird die hochgestellte Auflage +nur dann ausgegeben, wenn von ein und demselben Werk (vorzugsweise juristische Kommentare) mehrere verschiedene Auflagen +zitiert werden. Bei diesen Fällen wird dann auf die Ausgabe des Kurz- oder Volltitels verzichtet, da dies hinreichend +eindeutig ist und für den Leser kein Problem darstellt. + +Sollte ein Bearbeiter angegeben worden sein, erscheint die hochgestellte +Auflage hinter dem Bearbeiter, sofern die Voreinstellung oder eine der +|annotatorlastsep|-Optionen benutzt wird: + +\medskip + +Kodal/Krämer--Bassenge$^{3}$, \S~12. + +\medskip + +Möchten sie dies ändern, so daß die hochgestellte Auflage direkt hinter +dem Autor erscheint, verwenden Sie folgendes in Ihrer Präambel +oder Konfigurationsdatei: + +\begin{verbatim} + \jbsuperscripteditionafterauthor +\end{verbatim} + +Dann sollten Sie folgendes Ergebnis erhalten: + +\medskip + +Kodal/Krämer$^{3}$--Bassenge, \S~12. +%\end{Options} +% +%\begin{Options} +\item[biblikecite] Die Formatierung des Literaturverzeichnisses folgt + (soweit wie möglich) automatisch der Formatierung der Zitate. +\item[edby] (Nur in \texttt{@INCOLLECTION}!) Die Sequenz "`Lipcoll, + David~J. (Hrsg.)"' wird geändert zu "`hrsg. v. Lipcoll, David~J."'\par +Anpassungen sind möglich über: + \begin{verbatim} + \AddTo\bibsgerman{% + \def\edbyname{herausgegeben von}% + } + \end{verbatim} +\item[endnote] Der Inhalt des \texttt{note}-Feldes erscheint am Ende des bibliographischen Eintrags und wenn Sie + |dotafter=bibentry| benutzen, \emph{nach} dem abschließenden Punkt. +\end{Options} + + \DescribeMacro{\jbauthorfont} + \DescribeMacro{\jbcoauthorfont} +Sollten diese Optionen nicht das Gewünschte leisten, besteht die Möglichkeit, +das angestrebte Ergebnis durch Umdefinieren von diversen Befehlen zu erreichen. + +Die Schriftarten der Autoren und Bearbeiter werden durch die Befehle +\cs{jbauthorfont} und \cs{jbcoauthorfont} bestimmt und können folgendermaßen +verändert werden (der typographische Wert dieser Beispiele geht gegen Null): +\begin{verbatim} + \renewcommand*{\jbauthorfont}{\textit} + \renewcommand*{\jbcoauthorfont}{\textsl} +\end{verbatim} + \DescribeMacro{\jbactualauthorfont} + \DescribeMacro{\jbauthorfontifcoauthor} +Analoges gilt für die folgenden Befehle, die \emph{nur} in Verbindung mit der +Option \texttt{authorformat=dynamic} wirksam sind: +\begin{verbatim} + \renewcommand*{\jbactualauthorfont}{\textsc} + \renewcommand*{\jbauthorfontifcoauthor}{\textsl} +\end{verbatim} + +Diese Redefinitionen sind in der Präambel vor \cs{begin}\verb+{document}+ +unterzubringen. Dabei ist zu beachten, daß Fontbefehle benutzt werden, die mit +\cs{text} beginnen (Fontwechselbefehle mit Argumenten, z.\,B. \cs{textit}, +\cs{textbf} usw.), und \emph{nicht} solche, die mit \texttt{series}, +\texttt{family} oder \texttt{shape} enden (Deklarationsform, z.\,B. +\cs{bfseries}, \cs{slshape}, \cs{sffamily})! + +\subsubsection{Formatierung des Titels} + \begin{Options} + \item[titleformat=italic] setzt Titel kursiv: Kodal\slash Krämer\slash Bassenge, \textit{StrR}, \S~12. + \item[titleformat=all] Mit dieser Option werden bei \emph{allen} Zitaten die + Kurztitel gesetzt, unabhängig davon, ob ein Autor mit verschiedenen + Werken zitiert wurde oder nicht. + \item[titleformat=colonsep] Diese Option plaziert einen Doppelpunkt zwischen Autor und Titel + (sofern ein Titel zitiert wird): + Kodal\slash Krämer\slash Bassenge: StrR, \S~12. + \item[titleformat=commasep] Diese Option plaziert ein Komma zwischen Autor und Titel: + Kodal\slash Krämer\slash Bassenge, StrR, \S~12. + \item[titleformat=noreplace] Auf mehrfachen Wunsch hin habe ich diese Option geschaffen, mit der sich + das Ersetzen eines fehlenden \texttt{shorttitle}s durch den Inhalt des + \texttt{title}-Feldes global unterbinden läßt. Siehe dazu auch die + \cs{cite*}- und die \cs{nextcitenotitle}-Befehle. + \end{Options} +\DescribeMacro{\jbtitlefont} Für eine Veränderung des Schriftschnittes des +Kurztitels steht der Befehl \cs{jbtitlefont} zur Verfügung, der ganz analog an +eigene Bedürfnisse angepaßt werden kann: + +\begin{verbatim} + \renewcommand*{\jbtitlefont}{\textit} +\end{verbatim} + + \DescribeMacro{\jbhowsepbeforetitle} +Für die Optionen \texttt{titleformat=commasep} und +\texttt{titleformat=colonsep} ist eine individuelle Formatierung des +Separationszeichens möglich mit +\begin{verbatim} + \renewcommand*{\jbhowsepbeforetitle}{; } . + Leerzeichen! ---------------^ +\end{verbatim} +Eine der beiden vorgenannten Optionen sollte dann allerdings aktiv sein. + +\subsubsection{Separation des Bearbeiters} + +Wie bereits erwähnt, ist das Erscheinen des Bearbeiters nach dem Autor\slash +den Autoren als auch die Trennung durch den Schrägstrich voreingestellt. Dies +läßt sich über Optionen ändern. + + \begin{Options} + \item[annotatorlastsep=divis (früher: colastsep=divis)] Diese Option ändert das voreingestellte Erscheinungsbild, + so daß der Schrägstrich durch einen Bindestrich ersetzt + wird: Kodal\slash Krämer--Bassenge StrR, \S~12. + \item[annotatorfirstsep=in (früher: cofirstsep=in)] Der Bearbeiter erscheint im Zitat zuerst, die Trennung erfolgt + durch "` in "'\,: Bassenge in Kodal\slash Krämer StrR, \S~12. + \item[annotatorfirstsep=comma (früher: cofirstsep=comma)] Diese Option wirkt wie \texttt{annotatorfirstsep=in}, allerdings + wird das "` in "' durch ein Komma ersetzt: + Bassenge, Kodal\slash Krämer StrR, \S~12. + \end{Options} + + +\subsubsection{Verhalten bei Wiederholungszitaten} + + \begin{Options} + \item[\texttt{ibidem} oder \texttt{ibidem=strict}] Sollte ein Autor mehrfach +nacheinander zitiert werden, kann es erwünscht sein, die Wiederholung des +Zitates durch das Kürzel "`a.\,a.\,O."' ersetzen zu lassen. \emph{Die +Verwendung dieses und ähnlicher Kürzel ist umstritten und man sollte, wenn +irgend möglich, auf die Verwendung dieser Option verzichten, da sie nicht dazu +angetan ist, Lesbarkeit oder Übersichtlichkeit zu verbessern.} Dabei ist +\textsf{jurabib} aus gutem Grund so konfiguriert, daß das Zitat nur dann durch +"`a.\,a.\,O."' ersetzt wird, wenn die Wiederholung unmittelbar auf das +Erstzitat folgt und wenn das Wiederholungszitat \emph{nicht} das erste auf der +aktuellen Seite ist (siehe Beispiele). + +\item[ibidem=nostrict] Möchte man obiges +Verhalten unterdrücken, bietet sich diese Option an, die es zuläßt, daß ein +Wiederholungszitat -- auch wenn es das Erste auf der Seite ist -- durch +"`a.\,a.\,O\kern-1.2pt."' ersetzt wird. Der Einsatz dieser Option sollte +wohlüberlegt sein. Er ist nur dann sinnvoll, wenn man im Dokument im +Wesentlichen einen Autor zitiert und der Leser somit durchaus weiß, wer sich +zuletzt hinter "`a.\,a.\,O\kern-1.2pt."' verbarg. + +\item[ibidem=strictdoublepage] Zugebenermaßen ist diese Option, sagen wir, +"`akademisch"', weil sie sehr spitzfindig unterscheidet, ob Erstzitat (bzw. +volles Wiederholungszitat) und potentiell abgekürztes Wiederholungszitat auf +gegenüberliegenden Seiten zu liegen kommen (Vielen Dank an \textsc{Stefan +\mbox{Ulrich}}). Sollte das der Fall sein, wird "`a.\,a.\,O\kern-1.2pt."' im +ersten Zitat auf der neuen (rechten) Seite zugelassen. Liegt ein Umbruch von +einer ungeraden (rechten) Seite auf eine gerade (linke) Seite vor, verhält sich +die Option wie \texttt{ibidem/ibidem=strict}. Dies ist selbstverständlich nur +bei zweiseitigem Druck von Interesse, also bei Benutzung einer +\texttt{book}-Klasse oder der Klassenoption \texttt{twoside}. Vergleichen Sie +in der folgenden Übersicht. \end{Options}% + +\begin{center} +\noindent{\small +\begin{tabular}{@{}llll@{}}\hline\\[-2ex] +{\footnotesize\cs{footcite}\texttt{..}}& {\footnotesize\texttt{ibidem}/\texttt{ibidem=strict}}& {\footnotesize\texttt{ibidem=strictdoublepage}} & {\footnotesize\texttt{ibidem=nostrict}}\\\hline\\[-2ex] +\texttt{..[S.~12]\mymarg{erm}} & $^{1}$\textsc{Erman}, S.\,12. & $^{1}$\textsc{Erman}, S.\,12. & $^{1}$\textsc{Erman}, S.\,12. \\ +\texttt{..[S.\,12]\mymarg{erm}} & $^{2}$a.\,a.\,O\kern-1.2pt. & $^{2}$a.\,a.\,O\kern-1.2pt. & $^{2}$a.\,a.\,O\kern-1.2pt. \\ +\texttt{..[S.\,20]\mymarg{erm}} & $^{3}$a.\,a.\,O\kern-1.2pt., S.\,20.& $^{3}$a.\,a.\,O\kern-1.2pt., S.\,20. & $^{3}$a.\,a.\,O\kern-1.2pt., S.\,20. \\ +\texttt{..\mymarg{mueko}} & $^{4}$\textsc{MüKo}. & $^{4}$\textsc{MüKo}. & $^{4}$\textsc{MüKo}. \\ +\texttt{..[S.\,12]\mymarg{erm}} & $^{5}$\textsc{Erman}, S.\,12. & $^{5}$\textsc{Erman}, S.\,12. & $^{5}$\textsc{Erman}, S.\,12. \\ +\texttt{..[S.\,12]\mymarg{erm}} & $^{6}$a.\,a.\,O\kern-1.2pt. & $^{6}$a.\,a.\,O\kern-1.2pt. & $^{6}$a.\,a.\,O\kern-1.2pt. \\[.8ex] +\multicolumn{4}{@{}c@{}}{\emph{Seitenumbruch von ungerade (rechts) auf gerade (links)}}\\[1.6ex] +\texttt{..[S.\,12]\mymarg{erm}} & $^{7}$\textsc{Erman}, S.\,12. & $^{7}$\textsc{Erman}, S.\,12. $\longleftarrow$ \textsf{!!!} & $^{7}$a.\,a.\,O\kern-1.2pt. $\longleftarrow$ \textsf{!!!}\\ +\texttt{..[S.\,12]\mymarg{erm}} & $^{8}$a.\,a.\,O\kern-1.2pt. & $^{8}$a.\,a.\,O\kern-1.2pt. & $^{8}$a.\,a.\,O\kern-1.2pt. \\[.8ex] +\multicolumn{4}{@{}c@{}}{\emph{Seitenumbruch von gerade (links) auf ungerade (rechts) = gegenüberliegende Seiten}}\\[1.6ex] +\texttt{..[S.\,12]\mymarg{erm}} & $^{9}$\textsc{Erman}, S.\,12. & $^{9}$a.\,a.\,O\kern-1.2pt. $\longleftarrow$ \textsf{!!!} & $^{9}$a.\,a.\,O\kern-1.2pt. $\longleftarrow$ \textsf{!!!}\\ +\texttt{..[S.\,12]\mymarg{erm}} & $^{10}$a.\,a.\,O\kern-1.2pt. & $^{10}$a.\,a.\,O\kern-1.2pt. & $^{10}$a.\,a.\,O\kern-1.2pt. \\ +\hline +\end{tabular}} +\end{center} + +\DescribeMacro{\noibidem} Mit Hilfe des Befehls \cs{noibidem} können Sie den +\texttt{ibidem}-Automatismus für das jeweils nächste (\emph{und nur für +dieses!}) Wiederholungszitat abschalten. + + +\subsubsection{Sonstiges} + + \begin{Options} + \item[commabeforerest] Hier wird ein Komma vor evtl. angegebene Seitenzahlen, Randnummern + und dergleichen gesetzt: \cite[S.\,12]{kkstrr}. + \item[silent] unterdrückt alle \textsf{jurabib}-spezifischen Warnungen. + \end{Options} + +\subsection[Formatierung des Literaturverzeichnisses] + {Möglichkeiten der Formatierung des\\ Literaturverzeichnisses} +\subsubsection{Schriftschnitte} +Die Möglichkeiten der Formatierung beschränken sich auf die Modifikation von +Schriftarten einzelner, ausgewählter Teile eines Eintrages im +Literaturverzeichnis. Dazu existieren die Befehle \cs{biblnfont} für die +Formatierung der Nachnamen der + \DescribeMacro{\biblnfont} + \DescribeMacro{\bibelnfont} + \DescribeMacro{\bibfnfont} + \DescribeMacro{\bibefnfont} + \DescribeMacro{\bibtfont} + \DescribeMacro{\bibbtfont} + \DescribeMacro{\bibjtfont} + \DescribeMacro{\bibapifont} + \DescribeMacro{\bibsnfont} +Autoren und \cs{bibelnfont} für die Herausgeber, \cs{bibfnfont} und \cs{bibefnfont} +für die Formatierung der Vornamen +selbiger, \cs{bibtfont} für die Anpassung der Titel von Büchern und anderem, +\cs{bibbtfont} für die Formatierung der Titel bei Sammelwerken und +\cs{bibjtfont} für die Modifizierung des Zeitschriftentitels bei Artikeln. Dazu +kommt \cs{bibapifont}, um den Titel eines Artikels, eines Beitrages in einem +Sammelwerk oder ähnliches zu formatieren. Dieser Befehl ist aktiv bei den +Eintragstypen \texttt{@ARTICLE}, \texttt{@PERIODICAL}, \texttt{@INBOOK} und +\texttt{@INCOLLECTION}, also bei unselbständigen Publikationsformen. +Mit \cs{bibsnfont} können Sie das Aussehen des |series| Feldes bestimmen. + +Die voreingestellte Formatierung entspricht diesen Redefinitionen: + +\begin{verbatim} + \renewcommand*{\biblnfont}{\bfseries} + \renewcommand*{\bibfnfont}{\bfseries} + \renewcommand*{\bibelnfont}{\bfseries} + \renewcommand*{\bibefnfont}{\bfseries} + \renewcommand*{\bibtfont}{} + \renewcommand*{\bibbtfont}{} + \renewcommand*{\bibjtfont}{} + \renewcommand*{\bibapifont}{} + \renewcommand*{\bibsnfont}{} +\end{verbatim} +Die Modifikation erfolgt analog zu den schon oben gezeigten Beispielen. Auch +hier ist zu beachten, daß Fontbefehle benutzt werden, die mit \cs{text} +beginnen (Fontwechselbefehle mit Argumenten, z.\,B. \cs{textit}, \cs{textbf} +usw.), und \emph{nicht} solche, die mit \texttt{series}, \texttt{family} oder +\texttt{shape} enden (Deklarationsform, z.\,B. \cs{bfseries}, \cs{slshape}, +\cs{sffamily})! + +\subsubsection{Optionen für das Literaturverzeichnis} + + \begin{Options} + \item[bibformat=nohang] Hiermit wird der voreingestellte Einzug der zweiten und + aller folgenden Zeilen in einem Eintrag im Literaturverzeichnis unterdrückt. +\noindent Möchten Sie den Einzug in seiner Größe beeinflussen, so mögen Sie +folgendes in die Präambel Ihres Dokumentes schreiben: +\begin{verbatim} + \setlength{\jbbibhang}{1.5em} +\end{verbatim} +Voreingestellt ist ein Einzug von 2.5\,em. + \item[bibformat=tabular] Das Literaturverzeichnis wird in Form einer zweispaltigen Tabelle + ausgegeben. Die Autoren erscheinen links, der Rest des biblio"-graphischen Eintrages rechts. +Die Breite der Spalten ist anpaßbar über folgende Befehle (die angegeben Werte +sind voreingestellt): +\begin{verbatim} + \renewcommand*{\bibleftcolumn}{\textwidth/3} + \renewcommand*{\bibrightcolumn}{\textwidth-\bibleftcolumn-1cm} +\end{verbatim} + Eine Einstellung der Ausrichtung innerhalb der Spalten ist ebenfalls möglich +(auch hier die Voreinstellungen): +\begin{verbatim} + \renewcommand*{\bibleftcolumnadjust}{\raggedright} + \renewcommand*{\bibrightcolumnadjust}{\raggedright} +\end{verbatim} +Für einen besseren Umbruch sei die Benutzung von \mbox{\textsf{ragged2e.sty}} +empfohlen: +\begin{verbatim} + \usepackage{ragged2e} +\end{verbatim} +Das oben gezeigte Laden des \textsf{ragged2e}-Paketes ist ausreichend. Es +erfolgt automatisch die Umdefinition der entsprechenden Befehle. Von Versuchen, +hier einen Blocksatz erzwingen zu wollen, rate ich ab. Für diesen speziellen +Fall ist Rauhsatz geeigneter. Wer trotzdem Blocksatz erreichen will: +\begin{verbatim} + \renewcommand*{\bibrightcolumnadjust}{} +\end{verbatim} + \item[bibformat=numbered] Hier werden die Einträge im Literaturverzeichnis numeriert. Das Format der Numerierung kann mit Hilfe von |\bibnumberformat| angepasst werden: +\begin{verbatim} + \renewcommand{\bibnumberformat}[1]{(#1)} +\end{verbatim} + \item[bibformat=ibidem] In -- nicht nur namentlicher -- Anlehnung an die "`großen"' + \texttt{ibidem}-Optionen kann diese Option + unmittelbare Wiederholungen von Autoren durch eine Linie (oder was auch immer) ersetzen. + Dabei testet \textsf{jurabib}, ob zwischen zwei Wiederholungen + ein Seitenumbruch liegt und verhindert entsprechend die Ausgabe der Ersetzung. Dabei können je + nach Umfang des Dokumentes auch drei, vier oder mehr(!) \LaTeX-Läufe nötig werden, bis dieser + Mechanismus vollständig greift. Also solange beim ersten Literaturverzeichniseintrag auf einer Seite + der Ersetzungstext erscheint, greift dieser Mechanismus noch nicht! (Dies gilt jedoch nicht + für gegenüberliegende Seiten bei Verwendung einer \texttt{*book}-Klasse oder der + \texttt{twoside}-Option.) +\item[lookforgender] Es ist möglich, die im Deutschen nötige +Unterscheidung zwischen männlichen und weiblichen Autoren durch Benutzung des +neuen |gender|-Feldes bereits in der \BibTeX-Datenbank zu treffen. Diese Option bewirkt die Auswertung dieses Feldes. +Dabei gelten folgende Abkürzungen: +\end{Options} +\noindent{\footnotesize + \begin{tabular}{@{}llllll@{}} + \hline\\[-2ex] + Abk. & Bedeutung & Zitatvariante & Definition über: & Bibliographievariante & Definition über: \\ + \hline\\[-2ex] + |sf| & single female & Dies./dies. & |\idem[S,s]fname| & Dieselbe/dieselbe & |\bibidem[S,s]fname|\\ + |sm| & single male & Ders./ders. & |\idem[S,s]mname| & Derselbe/derselbe & |\bibidem[S,s]mname|\\ + |pf| & plural female & Dies./dies. & |\idem[P,p]fname| & Dieselben/dieselben & |\bibidem[P,p]fname|\\ + |pm| & plural male & Dies./dies. & |\idem[P,p]mname| & Dieselben/dieselben & |\bibidem[P,p]mname|\\ + |sn| & single neutrum & Dass./dass. & |\idem[S,s]nname| & Dasselbe/dasselbe & |\bibidem[S,s]nname|\\ + |pn| & plural neutrum & Dies./dies. & |\idem[P,p]nname| & Dieselben/dieselben & |\bibidem[P,p]nname|\\ + \hline\\[-2ex] + \end{tabular}} + +\medskip + +\noindent Für eine einzelne Frau als Autorin wäre also für eine geänderte Darstellung ("`Dies."'/"`dies."' anstelle von "`Dieselbe"'/"`dieselbe"') im Literaturverzeichnis folgendes nötig: +\begin{verbatim} + \AddTo\bibsgerman{% + \renewcommand\bibidemSfname{Dies.}% + \renewcommand\bibidemsfname{dies.}% + } +\end{verbatim} + +\begin{Options} +\item[bibformat=ibidemalt] Eine alternative Darstellung des Literaturverzeichnisses, + speziell für Juristen. Diese Option geht auf Vorschläge von Tilman Finke zurück. +\item[bibformat=compress] Das Literaturverzeichnis wird etwas kompakter gesetzt, + d.\,h. der Abstand zwischen den einzelnen Einträgen wird verringert. +\item[bibformat=raggedright] Das Literaturverzeichnis wird mit Flattersatz gesetzt. + Diese sei speziell bei Benutzung von |bibformat=tabular| oder + bei geringer Textbreite empfohlen. +\item[annote] Der Inhalt des |annote|-Feldes wird ausgegeben (nur im Literaturverzeichnis\,!). + Es besteht die Möglichkeit -- ähnlich wie bei \textsf{natbib}~-- das |annote|-Feld nicht zu + besetzen und \textsf{jurabib} stattdessen eine Datei benutzen zu lassen. Diese Datei wird + eingebunden, sofern sie den Namen des BibTeX-Datenbankeintrags besitzt und auf |.tex| endet. + Sollte das |annote|-Feld leer sein und keine annote-Datei existieren, + wird nichts ausgegeben. + \DescribeMacro{\bibAnnotePath} + Mit |\bibAnnotePath| läßt sich ein Pfad zu den Annote-Dateien angeben. + Die Syntax entspricht der von |\graphicspath|: |\bibAnnotePath{{annotes/}}| + verwendet die Annote-Dateien aus dem Verzeichnis |annotes| unterhalb + des aktuellen Verzeichnisses. +\item[super] Konvertiert alle\NEW{0.6} |\cite|-Befehle in |\footcite|'s, +\item[config=\meta{file}] Ermöglicht die\NEW{0.6} Nutzung von mehreren |.cfg| Dateien. Mit dieser Option laden Sie die gewünschte Datei. Bitte beachten Sie, daß es \emph{nicht} nötig ist, die Erweiterung |.cfg| anzugeben\,! +\item[dotafter=bibentry] setzt einen \NEW{0.6}Punkt am Ende der Einträge in der Bibliographie. +\item[dotafter=endnote] setzt einen \NEW{0.6} Punkt am Ende der Endnoten + (bei Verwendung von \textsf{endnotes.sty}). +\end{Options} + +\subsubsection{Weitere Möglichkeiten der Anpassung} + \DescribeMacro{\bibbtsep} + \DescribeMacro{\bibjtsep} +Da es durchaus unterschiedliche Ansichten dazu gibt, wie ein Zitat aus einem +Sammelwerk oder einer Zeitschrift im Literaturverzeichnis zu erscheinen hat, +gibt es die Befehle \cs{bibbtsep} und \cs{bibjtsep}. Sie stehen für +"`\textbf{b}ook\textbf{t}itle \textbf{sep}aration"' und +"`\textbf{j}ournal\textbf{t}itle \textbf{sep}aration"'. +\begin{bibexample} +\item \textbf{Brinkmann, Franz~Josef:} Der Zugang der Willenserklärungen, Münsterische +Beiträge zur Rechtswissenschaft, Bd.~3 Berlin, 1984 +\end{bibexample} +Möchte man beispielsweise, daß im Literaturverzeichnis ein "`in~"' vor den +Buch\-titeln und dem Titel von Zeitschriften erscheint, dann wären die +folgenden Umdefinitionen zu tätigen: +\begin{verbatim} + \renewcommand*{\bibbtsep}{in } + \renewcommand*{\bibjtsep}{in } +\end{verbatim} +Nach obiger Redefinition bietet sich uns folgendes Bild: +\begin{bibexample} +\item \textbf{Brinkmann, Franz~Josef:} Der Zugang der Willenserklärungen, in Münsterische +Beiträge zur Rechtswissenschaft, Bd.~3 Berlin, 1984 +\end{bibexample} + \DescribeMacro{\bibansep} + \DescribeMacro{\bibatsep} + \DescribeMacro{\bibbdsep} +Auch was die Zeichensetzung nach Autoren, Titeln und zwischen Verlagsort und +Monat\slash Jahr betrifft, gibt es verschiedene Auffassungen. Dieser Tatsache +wird durch die Befehle \cs{bibansep} (\textbf{a}fter \textbf{n}ame +\textbf{sep}aration), \cs{bibatsep} (\textbf{a}fter \textbf{t}itle +\textbf{sep}aration) und \cs{bibbdsep} (\textbf{b}efore \textbf{d}ate +\textbf{sep}aration) Rechnung getragen. Möchte man also beispielsweise nach dem +Autor keinen Doppelpunkt, nach dem Titel anstelle des Kommas einen Punkt und +kein Komma zwischen Ort und Jahr, dann kann man sein Ziel über folgende +Redefinitionen erreichen: +\begin{verbatim} + \renewcommand*{\bibansep}{} + \renewcommand*{\bibatsep}{.} + \renewcommand*{\bibbdsep}{} +\end{verbatim} +Das Ergebnis sieht nun so aus: +\begin{bibexample} +\item \textbf{Brinkmann, Franz~Josef} Der Zugang der Willenserklärungen. Münsterische +Beiträge zur Rechtswissenschaft, Bd.~3 Berlin 1984 +\end{bibexample} + +\subsubsection{Zitiert \dots} +\DescribeMacro{howcited=normal} \DescribeMacro{howcited=multiple} +\DescribeMacro{howcited=compare} \DescribeMacro{howcited=all} Die +\texttt{howcited}-Optionen plazieren (unter unterschiedlichen Bedingungen) +hinter \emph{ausgewählten} Einträgen im Literaturverzeichnis einen Kommentar, +der angibt, wie das Werk im Text zitiert wurde. Dabei wird dieser Kommentar +entsprechend dynamisch verändert, wie wir das schon vom Zitat selbst kennen, +d.\,h. die Angabe im Literaturverzeichnis entspricht immer genau der +\emph{zuletzt} im Text verwendeten Form. Bei Artikeln und Periodika wird per +Voreinstellung keine Angabe über die Art der Zitierung gemacht -- dies gilt für +alle \texttt{howcited}-Optionen (ausgenommen \texttt{howcited=all}) -- da dies +üblicherweise über die Angabe des Autorennamens und des Zeitschriftentitels +erfolgt und somit hinreichend eindeutig ist.\footnote{Vielen Dank an +\textsc{Christian Meyn} für diesen Hinweis.} Sollte es erforderlich sein, daß +der Vermerk auch bei Artikeln und Periodika erscheint, benutzen Sie folgendes: +\begin{verbatim} + \makeatletter + \jb@allow@howcited@art@periodtrue + \makeatother +\end{verbatim} +\begin{Options} +\item[howcited=normal]\DescribeMacro{howcited=normal} + Die Option \texttt{howcited=normal} setzt dann den Vermerk "`(zitiert: \meta{Autor})"', wenn in + der \texttt{.bib}-Datei das Feld \texttt{howcited} besetzt + wurde.\footnote{Mit dieser Option läßt sich der unter Umständen unerwünschte + Automatismus der nachfolgenden Option \texttt{howcited=compare} ausschalten und man behält bei + jedem einzelnen Werk die Kontrolle, ob dort ein Vermerk über die Art des Zitats + erscheinen soll oder nicht und wenn er erscheinen soll, wie er auszusehen hat.} + +Nun gibt es zwei Möglichkeiten, dieses Feld zu benutzen. Im Sinne eines +Schalters funktioniert der Wert \texttt{1} in diesem Feld. Er bewirkt, daß das +Originalzitat, so wie es im Text erscheint, auch nach dem Eintrag im +Literaturverzeichnis gesetzt wird. Ein Beispiel: +\begin{verbatim} + @BOOK{enne:nipp, + author = {Ludwig Enneccerus and Hans Carl Nipperdey}, + title = {Allgemeiner Teil des Bürgerlichen Rechts}, + year = 1960, + volume = {1}, + volumetitle = {zweiter Halbband}, + address = {Tübingen}, + edition = {15.}, + howcited = {1} + } +\end{verbatim} +Erzeugt folgendes (Benutzung von \cs{[foot]cite} vorausgesetzt): +\begin{bibexample} +\item \textbf{Enneccerus, Ludwig\slash Nipperdey, Hans~Carl:} + Allgemeiner Teil des Bürgerlichen Rechts. Bd.~1, zweiter Halbband, 15.~Auf"|lage, + Tübingen 1960 (zitiert: Eneccerus\slash Nipperdey) +\end{bibexample} + +Sollte jedoch Bedarf bestehen, diesen Vermerk vom Originalzitat abweichen zu +lassen, trägt man in dieses Feld einfach das ein, was anstelle des +Originalzitates erscheinen soll. Ein Beispiel: +\begin{verbatim} + @BOOK{enne:nipp, + author = {Ludwig Enneccerus and Hans Carl Nipperdey}, + title = {Allgemeiner Teil des Bürgerlichen Rechts}, + year = 1960, + volume = {1}, + volumetitle = {zweiter Halbband}, + address = {Tübingen}, + edition = {15.}, + howcited = {Enneccerus/Nipperdey, B"urgerliches Recht} + } +\end{verbatim} +Erzeugt: +\begin{bibexample} +\item \textbf{Enneccerus, Ludwig\slash Nipperdey, Hans~Carl:} + Allgemeiner Teil des Bürgerlichen Rechts. Bd.~1, zweiter Halbband, 15.~Auf"|lage, + Tübingen 1960 (zitiert: Enneccerus\slash Nipperdey, Bürgerliches Recht) +\end{bibexample} +Um ein einheitliches Layout auch bei der Veränderung von Optionen, die die +Schriftschnitte der Autoren betreffen, sicherzustellen, sind u.\,U. Fontbefehle +in das Feld einzufügen. + +\item[howcited=compare]\DescribeMacro{howcited=compare} +Diese Option plaziert den Zusatz "`(zitiert: \meta{Autor})"' dann, \emph{wenn +ein Eintrag im Feld \texttt{shorttitle} gemacht wurde}, und dieser vom Eintrag +im Feld \texttt{title} abweicht. Das Feld \texttt{howcited} in der +\texttt{.bib}-Datei wird nun ignoriert. Maßgeblich für die Plazierung des +Vermerks ist allein die Abweichung des Feldes \texttt{shorttitle} vom Feld +\texttt{title}! Das ist bei dem folgenden, mit \cs{[foot]citetitle} zitierten +Beispiel der Fall: +\begin{verbatim} + @BOOK{kkstrr, + author = {Kurt Kodal and Joachim Krämer}, + title = {Straßenrecht}, + shorttitle = {StrR}, + year = 1995, + address = {München}, + edition = {5.}, + pages = {30--34, \S~24} + } +\end{verbatim} +\begin{bibexample} +\item \textbf{Kodal, K.\slash Krämer, J.:} Straßenrecht, 5.~Auf"|lage München, 1995 +(zitiert: Kodal\slash Krämer, StrR) +\end{bibexample} + +\item[howcited=multiple]\DescribeMacro{howcited=multiple} + Diese Option plaziert den Zusatz "`(zitiert: \meta{Autor})"' nur dann, wenn + mehr als ein Werk des betreffenden Autors zitiert wurde. Dies gilt per + Voreinstellung jedoch nicht für Kommentare (bei diesen wird der Vermerk + immer gesetzt), was sich jedoch ändern läßt (\cs{jb@@mult@switch} ist gleich + \texttt{1}, wenn mehr als ein Werk eines Autors zitiert wurde): +\begin{verbatim} + \makeatletter + \renewcommand*{\jb@make@howcited@multiple}{% + \jb@suppress@dot@for@howcitedtrue + \ifthenelse{\equal{\jb@@mult@switch}{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} + Der \texttt{howcited}-Vermerk erscheint bei allen Einträgen. +\end{Options} + +Voreingestellt ist der Wortlaut "`(zitiert: \meta{Autor})"'. Eine Anpassung ist +möglich über die folgenden Befehle: +\begin{verbatim} + \newcommand*{\howcitedprefix}{-- als } + \newcommand*{\howcitedsuffix}{ zitiert.} +\end{verbatim} +Man beachte die Leerzeichen. Dies ergibt dann: +\begin{bibexample} +\item \textbf{Kodal, K.\slash Krämer, J.:} Straßenrecht, 5.~Auf"|lage München, 1995 + -- als Kodal\slash Krämer, StrR zitiert. +\end{bibexample} +Wenn das Werk nicht zitiert worden ist, aber in das Literaturverzeichnis +aufgenommen werden soll, kann man sich des Befehls \cs{nocite} bedienen: +\begin{verbatim} + \nocite{kkstrr} +\end{verbatim} +Oder, um \emph{alle} nicht-zitierten Werke ins Literaturverzeichnis +aufzunehmen: +\begin{verbatim} + \nocite{*} +\end{verbatim} +Dann erhält der Vermerk die aktuelle Bedeutung des Befehls \cs{bibnotcited}. +Standard ist die leere Definition dieses Befehls. Dies läßt sich jedoch einfach +anpassen: +\begin{verbatim} + \renewcommand*{\bibnotcited}{(nicht zitiert)} +\end{verbatim} +Erzeugt folgendes: +\begin{bibexample} +\item \textbf{Kodal, K.\slash Krämer, J.:} Straßenrecht, 5.~Auf"|lage München, 1995 + (nicht zitiert) +\end{bibexample} +Eine der \texttt{howcited}-Optionen muß dafür natürlich aktiviert sein. + +Mittlerweile sind alle sinnvollen Kombinationen von |howcited|-Optionen möglich. + +Noch ein Hinweis zur Benutzung der \texttt{howcited}-Optionen: Wenn Sie +bemerken sollten, daß nicht die zuletzt im Text verwendete Zitierform im +Literaturverzeichnis erscheint, löschen Sie bitte die \texttt{.aux}-Datei und +bearbeiten Ihr Dokument erneut mit \LaTeX. + +\subsubsection{Weitere Eintragsfelder und Eintragstypen} + + \DescribeMacro{url =} +Auch wenn es vielleicht in der Rechtswissenschaft noch nicht zur Üblichkeit +gehört, Quellen aus dem World Wide Web zu zitieren, habe ich neben den Feldern +\texttt{shortauthor} und \texttt{shorttitle} noch das Feld \texttt{url} +hinzugefügt. + + \DescribeMacro{urldate =} +Mit dem Feld \texttt{urldate} ist es möglich, das Datum des Zugriffs auf die Website anzugeben. Der vor dem +Datum des Zugriffs erscheinende Wortlaut ist voreingestellt auf "`Zugriff am "' +und läßt sich redefinieren über: +\begin{verbatim} + \AddTo\bibsgerman{\renewcommand*{\urldatecomment}{besucht am }} . +\end{verbatim} +Die Trennung zwischen URL und |\urldatecomment| ist konfigurierbar und durch das Makro |\bibbudcsep| repräsentiert. +Es ist in der Voreinstellung als "` -- "' definiert. + + \DescribeMacro{\biburlprefix} + \DescribeMacro{\biburlsuffix} +In Zusammenhang damit ergibt sich die Möglichkeit, die Ausgabe des +\texttt{url}-Feldes zu formatieren. Dies ist mit Hilfe des Befehls +\cs{biburlprefix} möglich, welcher vor den eigentlichen URL-Eintrag +beispielsweise "`URL:"' einfügt. Voreingestellt sind: + +\begin{verbatim} + \newcommand*{\biburlprefix}{\jblangle{}URL: } + \newcommand*{\biburlsuffix}{\jbrangle{}} +\end{verbatim} +Eine Umdefinition erfolgt analog zu den anderen Befehlen via \cs{renewcommand}. +Um ein Umbrechen des URL sowie die korrekte Ausgabe von Zeichen wie z.\,B. +\verb+~+ und \verb+_+ zu ermöglichen, lädt \textsf{jurabib} das +\textsf{url}-Paket. In Version 0.51 ist der Befehl \CH{0.51} |\biburlfont| +geändert worden, eine Formatierung des URL ist nun folgendermaßen möglich (nur +diese vier Werte sind möglich\,!): +\begin{verbatim} + \biburlfont{tt} % typewriter + \biburlfont{rm} % roman + \biburlfont{sf} % serifenlos + \biburlfont{same} % wie im Text +\end{verbatim} + + \DescribeMacro{@WWW} + Neuer Eintragstyp für URL. Zwingend ist nur \texttt{url}, optional sind \texttt{urldate}, +\texttt{author} und \texttt{title}. +\begin{verbatim} + @WWW{testurl, + author = {Jens Berger}, + title = {Home of jurabib}, + url = {http://www.jurabib.org}, + urldate = {06.12.2003} + } +\end{verbatim} +\begin{bibexample} +\item \textbf{Berger, Jens:} Home of jurabib, $\langle$URL: + |http://www.jurabib.org|$\rangle$~-- Zugriff am 06.12.2003 +\end{bibexample} + \DescribeMacro{@PERIODICAL} +Auf einen Hinweis von \textsc{Andreas Stefanski} hin habe ich für Periodika -- +die nach Band und nicht nach Jahreszahl zitiert werden -- einen neuen +Eintragstyp \texttt{@PERIODICAL} definiert, der die Anforderung erfüllt, die +Jahreszahl in eckigen Klammern zu setzen. Zudem ist die Angabe des Bandes +möglich: +\begin{verbatim} + @PERIODICAL{oellers, + author = {Bernd Oellers}, + title = {Doppelwirkung im Recht?}, + journal = {AcP}, + year = 1969, + volume = 169, + pages = {67ff} + } +\end{verbatim} +Dies erzeugt folgendes: +\begin{bibexample} +\item \textbf{Oellers, Bernd:} Doppelwirkung im Recht? AcP 169 [1969], S.\,67ff +\end{bibexample} + \DescribeMacro{\bibpldelim} + \DescribeMacro{\bibprdelim} +Über die Befehle \cs{bibpldelim} (\texttt{P}eriodical \texttt{L}eft +\texttt{DELIM}iter) und \cs{bibprdelim} (\texttt{P}eriodical \texttt{R}ight +\texttt{DELIM}iter) ist eine Änderung der Klammerung der Jahreszahl möglich: +\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} Desweiteren wurde durch die Definition des +Eintragstyps \texttt{@COMMENTED} eine Möglichkeit geschaffen, Kommentare auch +als solche zu verwalten. Im Zusammenhang mit der Option +\texttt{howcited=normal} erscheint dann auch für diesen Eintrag am Ende des +Eintrags (zitiert: \meta{Autor}\slash Bearbeiter) oder (zitiert: Bearbeiter in +\meta{Autor}). +\begin{bibexample} +\item \textbf{Münchener Kommentar:} Kommentar zum Bürgerlichen Gesetzbuch, Bd.~2, +\mbox{--~Schuldrecht~--} Allgemeiner Teil, 3.~Auf"|lage, München, 1994, +\S\kern-.8pt\S~241--432 (zitiert: MüKo\slash Bearbeiter) +\end{bibexample} +\DescribeMacro{updated =} Dieses neue Feld wird innerhalb des Typs |@COMMENTED| +ausgewertet, um den jeweils letzten Stand z.\,B. von Loseblattsammlungen anzugeben. +\begin{bibexample} +\item \textbf{Münchener Kommentar:} Kommentar zum Bürgerlichen Gesetzbuch, Bd.~2, +\mbox{--~Schuldrecht~--} Allgemeiner Teil, 3.~Auf"|lage, München, Stand: Mai~1994 +\end{bibexample} +|updated| überschreibt \emph{nicht} das |year|-Feld\,! Die Abtrennung vom |address|\slash|publisher|/|year|-Block +ist durch das |\updatesep|-Makro gegeben, welches per Voreinstellung als Komma ausgeführt ist. +Vor den im Feld |updated| angegebenen Daten erscheint via Voreinstellung "`Stand:"'. Dies ist +konfigurierbar über das Makro |\updatename|. +\begin{verbatim} + \AddTo\bibsgerman{% + \def\updatesep{.} + \def\updatename{Stand vom} + } +\end{verbatim} + +Wird dieser Eintragstyp nicht verwendet, obwohl es sich um einen Kommentar +handelt, erscheint (zitiert: \meta{Autor}), was nicht korrekt ist, weil das +tatsächliche Layout des Zitates anders aussieht. Wer allerdings die +\texttt{howcited}-Optionen nicht benutzt, für den ist es unerheblich, welchen +Eintragstyp er für die Eingabe von Kommentaren verwendet. + +\DescribeMacro{volumetitle =} Über das Feld \texttt{volumetitle} ist es +möglich, einen Bandtitel anzugeben, der dann hinter der Nummer des Bandes +erscheint. Dieses Feld steht für die Eintragstypen \texttt{@COMMENTED}, +\texttt{@BOOK}, \texttt{@INBOOK} und \texttt{@INCOLLECTION} zur Verfügung. + +\DescribeMacro{titleaddon =} Dieses Feld dient dazu, einen Kommentar, eine +Notiz, Angaben zum Übersetzer, Mitarbeitern etc. zu machen. Es wird unmittelbar +hinter dem Titel plaziert. +\begin{verbatim} + @COMMENTED{mueko, + [...] + title = {Kommentar zum Bürgerlichen Gesetzbuch}, + titleaddon = {Unter Mitarbeit von Hans Mustermann}, + [...] + } +\end{verbatim} +Erzeugt: +\begin{bibexample} +\item \textbf{Münchener Kommentar:} Kommentar zum Bürgerlichen Gesetzbuch, + Unter Mitarbeit von Hans Mustermann, Bd.~2, +\mbox{--~Schuldrecht~--} Allgemeiner Teil, 3.~Auf"|lage, München, 1994, +\S\kern-.8pt\S~241--432 +\end{bibexample} + +\DescribeMacro{booktitleaddon =} Hier gilt ähnliches wie für das +|titleaddon|-Feld, nur ist dieses Feld für Anmerkungen hinter dem Titel eines +Sammelwerkes vorgesehen. + +\DescribeMacro{editortype =} Sollte man einmal vor dem Problem stehen, daß man +(für einen einzelnen Eintrag in der Datenbank) nach dem Namen des Herausgebers +etwas anderes als "`(Hrsg.)"' einsetzen möchte, etwa "`(Begr.)"' oder +ähnliches, dann trägt man den gewünschten Ersetzungstext einfach in das Feld +|editortype| ein: +\begin{verbatim} + @COMMENTED{palandt, + editor = {Otto Palandt}, + editortype = {Begr.}, + title = {Bürgerliches Gesetzbuch mit Einführungsgesetz [...]}, + [...] + } +\end{verbatim} +\begin{bibexample} +\item \textbf{Palandt, Otto (Begr.):} Bürgerliches Gesetzbuch mit Einführungsgesetz [...], +59.~Auf"|lage, München, 2000 +\end{bibexample} + Dies funktioniert auch für den Eintragstyp |@INCOLLECTION|. +\par\medskip\par +\DescribeMacro{sortkey =} Es scheint des öfteren notwendig zu sein, ein Werk an +einer bestimmten Stelle im Literaturverzeichnis auftauchen zu lassen, die vom +normalen Sortieralgorithmus abweicht. Dieses Problem löst das neue Feld +|sortkey|, in das man einen Sortierschlüssel eintragen kann, der -- im +Gegensatz zum Standard-Feld |key| -- nicht erst bei Fehlen von |author| und +|editor| zum Sortieren benutzt wird, sondern mit höchster Priorität die +Sortierung bestimmt. Gerade deshalb sollte er sorgfältig eingesetzt werden. + +\DescribeMacro{annote =} Auch der Wunsch nach einer Möglichkeit, eine (unter +Umständen längere) Zusammenfassung nach dem Eintrag im Literaturverzeichnis +auszugeben, wurde mehrfach geäußert. Diesem Wunsch trage ich mit dem neuen +|annote|-Feld Rechnung. Das Erscheinen des Inhaltes dieses Feldes läßt sich +über die Option |annote=true| bzw. nur |annote| in der Präambel bzw. in der + |jurabib.cfg| an- und abschalten. +\begin{verbatim} + @COMMENTED{palandt, + editor = {Otto Palandt}, + title = {Bürgerliches Gesetzbuch mit Einführungsgesetz [...]}, + annote = {Auch der Wunsch nach einer ...}, + [...] + } +\end{verbatim} +\begin{bibexample} +\item \textbf{Palandt, Otto:} Bürgerliches Gesetzbuch mit Einführungsgesetz [...], +59.~Auf"|lage, München, 2000 \par {\small Auch der Wunsch nach einer +Möglichkeit, eine (unter Umständen längere) Zusammenfassung nach dem Eintrag im +Literaturverzeichnis auszugeben, wurde mehrfach geäußert. Diesem Wunsch trage +ich mit dem neuen |annote|-Feld Rechnung. Das Erscheinen des Inhaltes dieses +Feldes läßt sich über die Option |annote=true| bzw. nur |annote| in der +Präambel bzw. in der + |jurabib.cfg| an- und abschalten.} +\end{bibexample} +Per Voreinstellung wird dieses Feld in |\small| gesetzt. + Aber auch hier ist eine Anpassung an den eigenen Geschmack möglich: +\begin{verbatim} + \renewcommand{\jbannoteformat}[1]{{\footnotesize\begin{quote}#1\end{quote}}} +\end{verbatim} + +\begin{bibexample} +\item \textbf{Palandt, Otto:} Bürgerliches Gesetzbuch mit Einführungsgesetz [...], +59.~Auf"|lage, München, 2000 \par {\footnotesize\begin{quote} Auch der Wunsch +nach einer Möglichkeit, eine (unter Umständen längere) Zusammenfassung nach dem + Eintrag im Literaturverzeichnis auszugeben, wurde mehrfach geäußert. Diesem + Wunsch trage ich mit dem neuen |annote|-Feld Rechnung. Das Erscheinen des + Inhaltes dieses Feldes läßt sich über die Option |annote=true| bzw. nur + |annote| in der Präambel bzw. in der |jurabib.cfg| an- und abschalten. + \end{quote}}\end{bibexample} + +\subsubsection{Zitieren von juristischen Dissertationen und ähnlichen Werken} + +\DescribeMacro{dissyear =} Juristische Dissertationen können einmal als reine +Dissertation zitiert werden, andererseits besteht die Möglichkeit, daß eine +juristische Dissertation auch als Buch erschienen ist. Für den ersten Fall ist +vorrangig der Eintragstyp \texttt{@JURTHESIS} (oder \texttt{@PHDTHESIS} bzw. +\texttt{@MASTERSTHESIS}) zu verwenden.\footnote{Die beiden letzteren sind im +Falle von \texttt{jurabib.bst} absolut identisch.} Im zweiten Fall scheint es +sinnvoll, die auch als Buch erschienene Dissertation mittels \texttt{@BOOK} zu +erfassen. Es wurde nun ein neues Feld \texttt{dissyear} geschaffen, was +gewissermaßen den Schalter darstellt, um ein Buch auch als Dissertation oder +ein ähnliches Werk zu deklarieren. Desweiteren werden nun innerhalb von +\texttt{@BOOK} auch die Felder \texttt{school} und \texttt{type} ausgewertet, +jedoch nur, wenn \texttt{dissyear} angegeben wurde, sonst werden sowohl +\texttt{type} als auch \texttt{school} ignoriert. Ein Beispiel: +\begin{verbatim} + @BOOK{alexy, + author = {Alexy, Robert}, + title = {Theorie der Grundrechte}, + year = 1985, + address = {Baden-Baden}, + type = {Habil.}, + school = {Göttingen}, + dissyear = 1984 + } +\end{verbatim} +erzeugt folgendes: +\begin{bibexample} +\item \textbf{Alexy, Robert:} Theorie der Grundrechte, Baden-Baden 1985 (zugl. Habil. +Göttingen 1984) +\end{bibexample} + +Angenommen, diese Arbeit wäre nicht als Buch erschienen, wäre die folgende +Erfassung sinnvoll gewesen: +\begin{verbatim} + @JURTHESIS{alexy, + author = {Alexy, Robert}, + title = {Theorie der Grundrechte}, + year = 1984, + type = {Habil.}, + school = {Göttingen} + } +\end{verbatim} +und hätte folgendes erzeugt: +\begin{bibexample} + \item \textbf{Alexy, Robert:} Theorie der Grundrechte, Habil. Göttingen 1984 +\end{bibexample} +Die Voreinstellung bezüglich des Typs der Arbeit ist "`Jur. Diss."': +\begin{verbatim} + @PHDTHESIS{alexy, + author = {Alexy, Robert}, + title = {Theorie der Grundrechte}, + year = 1984, + school = {Göttingen} + } +\end{verbatim} +\begin{bibexample} +\item \textbf{Alexy, Robert:} Theorie der Grundrechte, Jur. Diss. Göttingen 1984 +\end{bibexample} + \DescribeMacro{\SSS} +Der Befehl \cs{SS} wird nicht mehr durch \textsf{jurabib} umdefiniert\,! +Der Befehl \cs{SSS} repräsentiert zwei Paragraphenzeichen mit verkürztem Zwischenraum. Man +vergleiche \cs{S}\cs{S}: \S\S\ und \cs{SSS}: \S\kern-.8pt\S + +\section{Diverses~\dots} +Hier nun in loser Folge einige Optionen und Befehle, die nach und nach in das +Paket eingeführt wurden. +\begin{Options} +\item[pages=format] Hiermit können Sie die mittels optionalem Argument und + \texttt{pages}-Feld angegebenen Seitenzahlen und Seitenzahlbereiche durch \textsf{jurabib} +formatieren lassen. Sie können also in der \texttt{.bib}-Datei \texttt{pages = \{22-34\}} +statt \texttt{pages = \{S.\textasciitilde22-34\}} schreiben und innerhalb des optionalen +Argumentes der \cs{cite}-Befehle z.B. |\cite[45]{}|. Möchten Sie einmal etwas anderes als +Seitenzahlen angeben oder möchten Sie nach einer Seitenzahl noch etwas Text im optionalen +Argument unterbringen, benutzen Sie bitte die Befehle \cs{nopage} bzw. \cs{pageadd} (siehe +Übersicht). \textsf{jurabib} fügt nun eigenständig "`S."' ein und -- falls Sie \textsf{babel} +verwenden -- benutzt es die jeweils eingestellte Hauptsprache. \textsf{jurabib} unterscheidet +dabei auch zwischen einzelnen Seiten und Seitenzahlbereichen, nur macht sich das im Deutschen +per Voreinstellung nicht bemerkbar, da beide verantwortlichen Makros mit `S.' definiert sind. +Wenn Sie das ändern möchten, z.B.: + + \begin{verbatim} + \AddTo\bibsgerman{% + \def\jbpagename{Seite}% + \def\jbpagesname{Seiten}% + } + \end{verbatim} + +Es existieren eigene Makros für die Seitenangaben in der Bibliographie. +Die Makronamen lauten |\bibpagename| und |\bibpagesname|. Ihre Definition entspricht per Voreinstellung +der von |\jbpage[s]name|. Das heißt, wenn Sie |\jbpage[s]name| umdefinieren, wird auch automatisch +|\bibpage[s]name| angepasst, es sei denn, Sie redefinieren |\bibpage[s]name| direkt. + +Hier eine Übersicht (zur Veranschaulichung der Unterscheidung zwischen +Seitenzahlen und Seitenzahlbereichen hier mit dem englischen Pendant für +"`S."'): +\begin{center} +{\small +\begin{tabular}{@{}ll@{}} +\hline\\[-2ex] +|\cite[45]{} |& \dots{}, p.~45\\ +|\cite[45--47]{} |& \dots{}, pp.~45--47\\ +|\cite[45, 47 and 49]{} |& \dots{}, pp.~45, 47 and 49\\ +|\cite[45f]{} |& \dots{}, pp.~45f.\\ +|\cite[45ff]{} |&\dots{}, pp.~45ff.\\ +|\cite[\nopage{I, III and IV}]{} |& \dots{}, I, III and IV\\ +|\cite[13,\pageadd{etwas Text}]{} |& \dots{}, p.~13, etwas Text\\ +| ^ Hier kein Leerzeichen!!!! |& \\ +\hline\\[-2ex] +\end{tabular}} +\end{center} + +\item[pages=test] Da per Voreinstellung Seitenzahlen, die mit dem Feld + \texttt{pages} in der \texttt{.bib}-Datei angegeben wurden, im + Zitat unterdrückt werden, kann man mit diesem Befehl erreichen, daß + überprüft wird, ob via \cs{cite}-Befehl eine Fundstelle angegeben + wurde -- wenn das nicht der Fall ist, wird die Seitenangabe aus + der \texttt{.bib}-Datei verwendet. +\item[pages=always] Hier werden die Seitenangaben aus der + \texttt{.bib}-Datei immer im Zitat ausgegeben. +\item[hypercite=false] Schaltet die automatische Konvertierung von Zitaten in Hyperlinks ab, sofern man das \textsf{hyperref}-Paket benutzt. +\end{Options} +% +\begin{description} +\item[\cs{jbedseplikecite}] Die Separation der Herausgeber im + Literaturverzeichnis entspricht der im Zitat. +\item[\cs{jbdisablecitationcrossref}] schaltet die Ausgabe von Querverweisen + innerhalb von Zitaten ab, aber nur solchen, die \emph{nicht} innerhalb einer + \texttt{@INCOLLECTION} gemacht wurden, also wo der Querverweis vielleicht + mehr die inhaltliche Verwandschaft zweier Werke kennzeichnen soll. +\item[\cs{formatpages}, \textit{ehemals} \cs{formatarticlepages}] Mit Hilfe dieses + Befehls können Sie die Ausgabe der Seitenzahlen bei Zitaten steuern. Er + ermöglicht die bei Juristen teilweise übliche Angabe von Startseiten eines in + der Datenbank angegebenen Seitenzahlbereiches. \textsf{jurabib} ist in der + Lage, diese Startseite aus dem angegebenen Seitenzahlbereich zu extrahieren. + Seit v0.51 kann dieser Befehl nun auf alle Publikationstypen angewendet werden. + Dazu kann man im zweiten Argument eine Liste derjenigen Publikationstypen + angeben, bei denen diese Startseite angegeben werden soll. + Dieser Befehl besitzt \textit{zwei\,!} optionale und drei obligatorische Argumente: + \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} + D.\,h. die Angabe |\formatpages[: ]{}{(}{)}| formatiert Ihr Zitat |\cite[48]|\marg{key} bei diesem Eintrag in der Datenbank +\begin{verbatim} + @ARTICLE/PERIODICAL{broxja, + author = {Hans Brox}, + title = {Die Anfechtung bei der Stellvertretung}, + journal = {JA}, + language = {german}, + year = 1980, + pages = {45--60}, + address = {München} + } +\end{verbatim} +folgendermaßen: +\par\medskip +\qquad Brox, JA 1980, 45: (48). +\par\medskip +Bitte beachten Sie, daß für eine Angabe einer Startseite ohne folgendes +Separationszeichen das optionale Argument mit einem Leerzeichen benutzen +müssen: |\formatpages[ ]{}}{(}{)}|\,! +\par\medskip +\qquad Brox, JA 1980, 45 (48). +\par\medskip +Wenn Sie nur die via |\cite| angegebenen Seiten formatieren wollen, können Sie +auf die Angabe der Startseite verzichten, indem Sie die optionalen (erstes und zweites) +Argumente weglassen: +\par\medskip +|\formatpages{}{[}{]}| +\par\medskip +\qquad Brox, JA 1980, [48]. +\par\medskip + +Sollten Sie |\formatpages| zusammen mit der Option |pages=format| verwenden, +ist es nun Voreinstellung, daß bei Angabe einer Seitenzahl im optionalen Argument diese +keine weitere Formatierung erhält. Ein Beispiel: Sie haben +|\formatpages[, ]{article}{}{}| in Ihrer Präambel und benutzen die Option |pages=format|, +dann wird mit unserem Beispiel nun folgendes erzeugt: + +\par\medskip +\qquad Brox, JA 1980 S.~45, 48. +\par\medskip + +Sollten Sie eine Formatierung der zweiten Seitenzahl wünschen, können Sie dies durch +Angabe von |\jbnoformatafterstartpagefalse| in der Präambel erreichen: + +\par\medskip +\qquad Brox, JA 1980 S.~45, S.~48. +\par\medskip + +\item[\cs{jbfirstcitepageranges}] Sollte bei einem Eintrag vom |@ARTICLE|- oder |@PERIODICAL|-Typ + mit Hilfe des |pages|-Feldes ein Seitenzahlbereich angegeben worden sein, wird dieser beim + Erstzitat (und bei expliziten Vollzitaten) ausgegeben. Dies funktioniert unabhängig von den |pages|-Optionen. + Wenn Sie eine konkrete Fundstelle über das optionale Argument des |\[foot]cite|-Befehls angegeben haben, + wird diese dem Seitenzahlbereich angefügt, getrennt durch das Wort "`hier:"': + +\par\medskip +\qquad [\dots], S.~45, hier: S.~48. +\par\medskip + +Eine Umdefinition dieses Wortes ist in gewohnter Weise möglich: + + \begin{verbatim} + \AddTo\bibsgerman{% + \def\herename{da:}% + } + \end{verbatim} + +\end{description} + +\section{Die Konfigurationsdatei \texttt{jurabib.cfg}} +Sei es, um immer wieder benötigte Umdefinitionen, die den Umfang der Präambel +zu sprengen drohen aus selbiger zu verbannen oder weil man zu faul ist, diese +immer wieder auf's neue in die Präambel des nächsten Dokumentes zu kopieren +oder aus reiner Ordnungsliebe -- wie auch immer, es bietet sich an, diese +häufig benutzten Redefinitionen in einer Datei abzulegen. Diese Datei muß +\texttt{jurabib.cfg} heißen und entweder im Arbeitsverzeichnis oder dort wo +\texttt{jurabib.sty} liegt, abgelegt werden. Ab Version 0.4p lassen sich nun +auch sämtliche Optionen via \cs{jurabibsetup} in der Konfigurationsdatei +ablegen: +\begin{verbatim} + \jurabibsetup{ + authorformat=smallcaps, + commabeforerest, + titleformat=colonsep, + bibformat=tabular + } +\end{verbatim} +\section{Optionen für Nicht-Juristen}\label{see:nichtjur} +Die nun folgenden Optionen sind nicht primär für juristische Hausarbeiten +gedacht, sondern decken Anforderungen ab, die u.\,U. von Historikern, +Germanisten, Pädagogen und vielleicht auch noch anderen benötigt werden. Sie +stellen das (vorläufige) Ergebnis von verschiedensten Anfragen an mich dar. Ich +hoffe, daß diese Optionen hilfreich sind. Verbesserungsvorschläge sind +willkommen. + +\begin{Options} + \item[ibidem=name] Hiermit werden ausführlichere Angaben beim Wiederholungszitat + gemacht als bei \texttt{ibidem/ibidem=strict}. Es wird der volle Name des + Autors ausgegeben (Es sei denn, die Option \texttt{authorformat=reducedifibidem} + ist aktiv, dann wird nur der Nachname ausgegeben). Diese Option ist für die + Verwendung mit der Option \texttt{citefull=first} konzipiert, deshalb erfolgt + auch automatisch die Aktivierung dieser Option. + + Sollte ein Autor mit mehreren Werken zitiert werden, kann es vorkommen, daß + \textsf{jurabib} automatisch auf die Option + |ibidem=name&title&auto| umschaltet, um die Eindeutigkeit der Zitate nicht zu + gefährden. Sie werden dann in der \texttt{.log}-Datei einen Hinweis dazu + finden. + +\item[\texttt{ibidem=name\&title}] Wie \texttt{ibidem=name}, nur wird hier auch noch der Titel + ausgegeben. Es wird ebenfalls die Option \texttt{citefull=first} aktiviert. +\end{Options} +Auch hierzu eine Übersicht: +\begin{center} +{\small +\begin{tabular}{@{}lr@{}p{4.55cm}r@{}p{4.55cm}@{}}\hline\\[-2ex] +{\footnotesize\cs{footcite}\texttt{..}} & & {\footnotesize\texttt{ibidem=name}} & &{\footnotesize|ibidem=name&title|}\\\hline \\[-2ex] +\texttt{..\mymarg{broxbgb}} & $^{1}$ &\textsc{Brox}, Hans: + \textit{Allgemeiner Teil des Bürgerlichen + Gesetzbuches.} 20.\,Auf"|lage, Köln, + Berlin, Bonn, München 1996. + & $^{1}$ &\textsc{Brox}, Hans: + \textit{Allgemeiner Teil des Bürgerlichen + Gesetzbuches.} 20.\,Auf"|lage, Köln, + Berlin, Bonn, München 1996. \\[.3ex] +\texttt{..\mymarg{broxbgb}} & $^{2}$ &\textsc{Brox}, Hans, a.\,a.\,O\kern-1.2pt. & $^{2}$&\textsc{Brox}, Hans: BGB AT, a.\,a.\,O\kern-1.2pt.\\[.3ex] +\texttt{..\mymarg{broxbgb}} & $^{3}$ &\textsc{Brox}, Hans, a.\,a.\,O\kern-1.2pt. & $^{3}$&\textsc{Brox}, Hans: BGB AT, a.\,a.\,O\kern-1.2pt.\\[.3ex] +\texttt{..\mymarg{oellers}} & $^{4}$ &\textsc{Oellers}, Bernd: + \textit{Doppelwirkung im Recht\,?} AcP 169 [1969]. + & $^{4}$ &\textsc{Oellers}, Bernd: + \textit{Doppelwirkung im Recht\,?} AcP 169 [1969]. \\[.5ex] +\texttt{..\mymarg{broxbgb}} & $^{5}$ &\textsc{Brox}, Hans, a.\,a.\,O\kern-1.2pt. & $^{5}$&\textsc{Brox}, Hans: BGB AT, a.\,a.\,O\kern-1.2pt.\\[.3ex] +\texttt{..\mymarg{broxbgb}} & $^{6}$ &\textsc{Brox}, Hans, a.\,a.\,O\kern-1.2pt. & $^{6}$&\textsc{Brox}, Hans: BGB AT, a.\,a.\,O\kern-1.2pt.\\[.8ex] +\multicolumn{5}{@{}c@{}}{\emph{Seitenumbruch}}\\[1.6ex] +\texttt{..\mymarg{broxbgb}} & $^{7}$ &\textsc{Brox}, Hans, a.\,a.\,O\kern-1.2pt. & $^{7}$&\textsc{Brox}, Hans: BGB AT, a.\,a.\,O\kern-1.2pt.\\[.3ex] +\texttt{..\mymarg{broxbgb}} & $^{8}$ &\textsc{Brox}, Hans, a.\,a.\,O\kern-1.2pt. & $^{8}$&\textsc{Brox}, Hans: BGB AT, a.\,a.\,O\kern-1.2pt.\\[.8ex] +\multicolumn{5}{@{}l@{}}{\emph{und jetzt mit \texttt{authorformat=citationreversed}:}}\\[.8ex] +\texttt{..\mymarg{broxbgb}} & $^{9}$ & Hans \textsc{Brox}, a.\,a.\,O\kern-1.2pt. & $^{9}$&Hans \textsc{Brox}: BGB AT, a.\,a.\,O\kern-1.2pt. \\[.8ex] +\multicolumn{5}{@{}l@{}}{\emph{oder mit \texttt{authorformat=reducedifibidem}:}}\\[.8ex] +\texttt{..\mymarg{broxbgb}} & $^{10}$ &\textsc{Brox}, a.\,a.\,O\kern-1.2pt. & $^{10}$&\textsc{Brox}: BGB AT, a.\,a.\,O\kern-1.2pt. \\[.3ex] +\hline +\end{tabular}} +\end{center} +\begin{Options} +\item[\texttt{ibidem=name\&title\&auto}] + Diese Option ist bei häufigen Wiederholungszitaten mehrerer Werke + eines Autors von Nutzen. Beim ersten Zitat eines Werks wird die volle + Information ausgegeben (Option |citefull=first| ist automatisch aktiviert). + Solange wiederholt aus demselben Werk des Autors zitiert wird, wird im + folgenden nur der Name des Autors verwendet (entsprechend der Option + |ibidem=name|). Wird das Werk in einer späteren Fußnote nochmals zitiert, + werden einmalig Name und Titel ausgegeben (entsprechend der Option + |ibidem=name&title|). Dadurch wird die Eindeutigkeit der Zitate gewährleistet, + auch wenn ein Autor mit mehreren Werken vertreten ist. Für unmittelbar + folgende Zitate aus dem gleichen Werk wird dann wieder nur der Name + des Autors angegeben. + + Bei Verwendung der Option |ibidem=name| prüft \textsf{jurabib}, ob durch das + Auftreten von Wiederholungszitaten verschiedener Werke eines Autors + Mehrdeutigkeiten entstehen und schaltet in diesem Fall automatisch + auf die Option |ibidem=name&title&auto| um. Ein entsprechender Hinweis + wird in der |.log|-Datei abgelegt. +\end{Options} +Dies läßt sich wohl am besten an einer Übersicht erklären: +\begin{center} +{\small +\begin{tabular}{@{}lr@{}p{9.5cm}@{}}\hline\\[-2ex] +{\footnotesize\cs{footcite}\texttt{..}} & & {\footnotesize|ibidem=name&title&auto|}\\\hline\\[-2ex] +\texttt{..\mymarg{broxbgb}} & $^{1}$&\textsc{Brox}: \textit{Allgemeiner Teil des Bürgerlichen Gesetzbuches.} 20.\,Auf"|lage, Köln, Berlin, Bonn, München 1996.\\[.3ex] +\texttt{..\mymarg{broxschr}} & $^{2}$&\textsc{Brox}: \textit{Besonderes Schuldrecht.} 20.\,Auf"|lage, München 1995.\\[.3ex] +\texttt{..\mymarg{broxbgb}} & $^{5}$&\textsc{Brox}, a.\,a.\,O\kern-1.2pt.\\[.8ex] +\multicolumn{3}{@{}l@{}}{\hfill\emph{jetzt Wechsel des Werkes\,!}}\\[.8ex] +\texttt{..\mymarg{broxschr}} & $^{6}$&\textsc{Brox}: SchR~BT, a.\,a.\,O\kern-1.2pt.\\[.8ex] +\texttt{..\mymarg{broxschr}} & $^{7}$&\textsc{Brox}, a.\,a.\,O\kern-1.2pt.\\[.8ex] +\multicolumn{3}{@{}l@{}}{\hfill\emph{und noch ein Wechsel des Werkes\,!}}\\[.8ex] +\texttt{..\mymarg{broxbgb}} & $^{8}$&\textsc{Brox}: BGB AT, a.\,a.\,O\kern-1.2pt.\\[.8ex] +\texttt{..\mymarg{broxbgb}} & $^{8}$&\textsc{Brox}, a.\,a.\,O\kern-1.2pt.\\[.8ex] +\hline +\end{tabular}} +\end{center} + +\bigskip + +\noindent Eine Änderung der Sequenz "`a.\,a.\,O."' ist über die Befehle +\cs{ibidemname} und \cs{ibidemmidname} möglich: + + \begin{verbatim} + \AddTo\bibsgerman{% + \renewcommand*{\ibidemname}{Ebd.} + \renewcommand*{\ibidemmidname}{ebd.} + } + \end{verbatim} + +\cs{ibidemname} wird bei den Optionen \texttt{ibidem=strict}, +\texttt{ibidem=strictdoublepage} und \texttt{ibidem=nostrict} verwendet und +erscheint am Anfang des -- letztlich unterdrückten -- Zitates (es könnte hier +also groß geschrieben werden). \cs{jibidemmidname} dagegen erscheint bei den +Optionen \texttt{ibidem=name} und \texttt{ibidem=name\&title} und könnte klein +geschrieben werden -- das ist letztlich jedoch Geschmackssache. + +Es ist nun möglich, zwischen zwei Situationen zu unterscheiden: dem +Folgezitat mit derselben Seitenzahl und dem Folgezitat mit einer anderen +Seitenzahl. Sollte also das unmittelbar folgende Zitat dieselbe Seitenangabe +enthalten wie das vorhergehende, wird intern das Makro |\samepageibidemname| +bzw. |\samepageibidemmidname| benutzt. Dessen Bedeutung ist per Voreinstellung +identisch mit der Definition von |\ibidemname| bzw. |\ibidemmidname|. Wenn +dagegen die Seitenzahlen im optionalen Argument abweichen sollten, werden die +Makros |\diffpageibidemname| bzw. |\diffpageibidemmidname| benutzt. Möchte man +also zum Beispiel, daß bei identischen Seitenzahlen "`Ebd."' erscheint, bei +verschiedenen dagegen "`a.a.O."', wäre folgendes zu tun: + \begin{verbatim} + \renewcommand*{\samepageibidemname}{Ebd.} + \end{verbatim} +Die folgende Übersicht mag das veranschaulichen: +\begin{center} +{\small +\begin{tabular}{@{}lcl@{}} +\hline\\[-2ex] +|\footcite[45]{broxbgb}| & $\longrightarrow$ &\textsuperscript{1}Brox, 45.\\ +|\footcite[45--47]{broxbgb}| & $\longrightarrow$ &\textsuperscript{2}A.a.O., 45--47.\\ +|\footcite[45--47]{broxbgb}| & $\longrightarrow$ &\textsuperscript{3}Ebd.\\ +|\footcite[45f]{broxbgb}| & $\longrightarrow$ &\textsuperscript{4}A.a.O., 45\,f.\\ +\hline\\[-2ex] +\end{tabular}} +\end{center} + +\begin{Options} + +\item[citefull=first] Mit Hilfe dieser Option ist es möglich, das erste Zitat eines Werkes +analog zum Eintrag im Literaturverzeichnis (Vollzitat) erscheinen zu lassen. +Für alle weiteren Zitate werden die angegeben bzw. generierten Kurzformen +verwendet. Eine erneute Verwendung des Vollzitats ist über die Befehle +\cs{fullcite} und \cs{footfullcite} möglich. Bearbeiter werden bei dieser Form +\emph{vor den Autor} gesetzt, getrennt durch ein "`in"'. Um ein einheitliches +Erscheinungsbild zu erreichen und den Leser nicht zu verwirren, schaltet diese +Option bezüglich Separation des Bearbeiters global -- d.\,h. für alle anderen +Zitate gültig -- automatisch auf die Option \texttt{annotatorfirstsep=in} um und +überschreibt so andere Optionen, die die Separation steuern, wie z.\,B. +\texttt{annotatorlastsep=divis} oder \texttt{annotatorfirstsep=comma}. Außerdem werden die +\texttt{howcited}-Optionen deaktiviert. + +\item[citefull=chapter] Schaltet automatisch auf \texttt{citefull=first} und + setzt es bei Beginn eines neuen Kapitels zurück. + +\item[citefull=section] Schaltet automatisch auf \texttt{citefull=first} und + setzt es bei Beginn eines neuen Abschnittes zurück. + +\item[citefull=all] Diese Option läßt alle Zitate als Vollzitat erscheinen. +Auch sie schaltet bezüglich Separation des Bearbeiters automatisch auf die +Option \texttt{annotatorfirstsep=in} um. Auch hier werden die Optionen +\texttt{howcited}-Optionen deaktiviert. Eine Kombination mit der Option +\texttt{ibidem} ist hingegen möglich. + +\item[see] Da man als Nicht-Jurist das zweite optionale Argument der \cs{cite*}-Befehle +nicht für die Angabe von Bearbeitern benötigt, lassen sich hiermit Sequenzen +wie etwa "`Vgl."' oder "`Siehe"' vor das Zitat setzen. Diese Option wirkt +global. + +\item[natoptargorder] Hiermit wird die Reihenfolge der optionalen Parameter + umgekehrt, z.\,B. um das Dokument kompatibel zu \texttt{natbib.sty} zu machen. + +\item[crossref=dynamic] Die anderen \texttt{crossref}-Optionen können mit dieser + Option kombiniert werden, um ein verschieden ausführliches Erscheinungsbild + der Querverweise zu erreichen, je nachdem, ob das Werk, in dem der Querverweis + vorkommt, das erste Mal oder ein weiteres Mal zitiert wird -- vergleichen Sie + die alleinige Anwendung von \texttt{crossref=dynamic} (zur Veranschaulichung + finden Sie die Querverweise jeweils in eckigen Klammern): +\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} +mit der Kombination von \texttt{crossref=dynamic} und \texttt{crossref=long}: +\begin{quote} +\small $^1$\,Lincoll, Daniel D.: Semigroups of Recurrences. In [Lipcoll, +David~J./Lawrie, + D.~H./Sameh, A.~H. (Hrsg.): + High Speed Computer and Algorithm Organization. + 3.~Auf\/lage, 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) Hiermit werden (im Literaturverzeichnis) die + Querverweise, die mit Hilfe des \texttt{crossref}-Feldes angegeben werden, mit Autor + (\texttt{shortauthor} hat Priorität vor \texttt{author}) und Titel (\texttt{shorttitle}, + wenn vorhanden, sonst Ersetzung mit \texttt{title}) angegeben. +\item[crossref=short] Hier wird auf die Angabe des Titels verzichtet, es sei denn, die + Eindeutigkeit des Zitates ist gefährdet, in diesem Fall wird \texttt{shorttitle} + durch \texttt{title} ersetzt. +\item[crossref=long] Mit dieser Option wird im Querverweis das Vollzitat ausgegeben. +\item[human] Allgemeine Option für die Geisteswissenschaften. Schaltet unter anderem + auf |authorformat=and|. +\item[oxford] Schaltet auf eine Formatierung der Zitate und des Literaturverzeichnisses + im Oxford-Stil um (nicht im wörtlichen Sinn!). +\item[chicago] Schaltet auf eine Formatierung der Zitate und des Literaturverzeichnisses + im chicago-Stil um (nicht im wörtlichen Sinn!). Sowohl die |oxford|- und + |chicago|-Option gehen auf Vorschläge von \textsc{Maarten Wisse} zurück. +\item[lookat] Hiermit werden -- \emph{ausschließlich bei Verwendung der + \cs{footcite}-Befehle bzw. in Fußnoten eingefaßten \cs{cite}-Befehlen in + Verbindung mit der Option \texttt{citefull=first}} -- Querverweise + auf die Fußnoten möglich, die das Vollzitat enthalten, z.\,B. wenn für + einen Artikel keine Bibliographie ausgegeben werden soll. Hierfür gibt + es den Befehl +\par\medskip +\qquad \cs{nobibliography}\marg{bibfile}\DescribeMacro{\nobibliography} +\par\medskip der die Ausgabe des Literaturverzeichnisses unterdrücken +kann.\footnote{Dieser Befehl ist zwar primär für die Verwendung mit der Option +\texttt{lookat} vorgesehen, er erfordert diese Option jedoch \emph{nicht}. Es +muß lediglich eine der \texttt{citefull}-Optionen aktiv sein. Dank an +\textsc{Stefan Ulrich}.} In einem späteren Zitat werden dann die Kurzformen +verwendet, verbunden mit einem Hinweis, in welcher Fußnote das Vollzitat zu + finden ist.\footnote{Beispiel: \textsc{Brox}: BGB AT (wie Anm. \meta{Nr.}), Rn.~168.} + +Beachten Sie bitte, daß zur korrekten Auflösung der Verweise, die +\texttt{lookat} produziert, (nach der Bearbeitung mit \BibTeX) \emph{drei} +\LaTeX-Läufe nötig sind\,! + +Sollten Sie das Paket \textsf{varioref} oder \textsf{fancyref} verwenden, so +wird intern statt \cs{ref} der Befehl \cs{vref} benutzt, was zu angepaßten +Verweisen führt, insbesondere, wenn das Folgezitat ein bis zwei Seiten entfernt +ist. Wollen Sie das Paket \textsf{varioref} oder \textsf{fancyref} in Ihrem +Dokument benutzen, ohne daß dies Auswirkungen auf +\DescribeMacro{\jbignorevarioref} Ihre Zitate hat, können Sie den Befehl +\cs{jbignorevarioref} in die Präambel Ihres Dokumentes setzen.\par Sie müssen +es zudem nicht bei der voreingestellten Form (wie Anm. \meta{Nr.}) belassen, +sondern können diese Ihren Vorstellungen entsprechend anpassen: +\begin{verbatim} + \renewcommand*{\lookatprefix}{\space(siehe Fußnote~} + \renewcommand*{\lookatsuffix}{)} +\end{verbatim} + +\DescribeMacro{\lookatfortype} Mit |\lookatfortype| können \NEW{0.6} Sie eine kommaseparierte Liste der Publikationstypen angeben, für welche die |lookat|-Option ausschließlich wirksam werden soll. Die |lookat|-Option muß natürlich aktiviert sein\,! +\begin{verbatim} + \lookatfortype{booklet} +\end{verbatim} +wendet die Option |lookat| nür auf Werke des Typs |@booklet| an. + +\texttt{lookat} \emph{kann} zusammen mit den \texttt{ibidem}-Optionen verwendet +werden, nur möchte ich das nicht empfehlen. + + Bei Verwendung von \cs{cite}-Befehlen im Fließtext (außerhalb einer + Fußnote\,!) \emph{und} \cs{footcite}-Befehlen \mymarginpar{\hfill\textsf{\large CAVE\,!}} + (oder \cs{cite}-Befehlen innerhalb einer Fußnote) + kann es zu Fehlermeldungen entweder von \textsf{alphanum} + oder -- sofern verwendet -- von \textsf{varioref} kommen. + \textsf{alphanum} beklagt sich dann möglicherweise: +\begin{verbatim} + ! Package alphanum Error: Self-reference detected!. + [...] + ? +\end{verbatim} +Dann haben Sie mit einem \cs{cite}-Befehl im Fließtext ein Werk zum ersten Mal +zitiert, worauf Sie noch innerhalb des aktuellen Abschnittes mit einem +\cs{footcite}-Befehl Bezug nehmen. Da sich das erste Zitat nicht in einer +Fußnote befindet, wird die aktuelle Abschnittsnumerierung als Referenz +verwendet. Da Sie sich nun mit der Option \texttt{lookat} im Folgezitat auf das +Erstzitat beziehen, wird als Referenz die Abschnittsnummer angegeben und da Sie +sich im selben Abschnitt befinden, beschwert sich \textsf{alphanum} in oben +gezeigter Form. \par Eine andere Fehlermeldung zum gleichen Problem könnte auch +so aussehen: +\begin{verbatim} + ! Extra }, or forgotten \endgroup. + \J@refP ...nta #1\,\J@INumberRoot {#1}{#2} + [...] + ? +\end{verbatim} +Zur Lösung empfiehlt es sich, zumindest das Erstzitat in eine Fußnote zu +verfrachten (ob \cs{footcite} oder \cs{cite} innerhalb von \cs{footnote} ist +dabei unerheblich). + +\emph{Die Option \texttt{lookat} kann nicht ohne weiteres innerhalb von +\texttt{book}- oder \texttt{report}-Klassen oder deren Abkömmlingen verwendet +werden.} Ebensowenig läßt sich die Option sinnvoll verwenden, wenn +\textsf{footnpag.sty} benutzt wird. + +Eine Benutzung von \texttt{lookat} innerhalb der \texttt{book}- oder +\texttt{report}-Klassen wird bei Verwendung des \textsf{remreset}-Paketes +möglich. Dies kann die Rücksetzung des Fußnotenzählers zu Beginn eines neuen +Kapitels rückgängig machen und so eindeutige Verweise ermöglichen. Fügen Sie +dazu (mindestens) folgendes in Ihre Präambel ein: +\begin{verbatim} + \usepackage{remreset} + \makeatletter + \@removefromreset{footnote}{chapter} + \makeatother +\end{verbatim} +Um eine gewisse Konsistenz zu errreichen, sollten Sie die Zähler der +Abbildungen und Tafeln nicht außer acht lassen: +\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}] + Diese neue Option ist der |ibidem|-Option sehr ähnlich, nur ersetzt sie nicht + das gesamte Zitat durch ein Kürzel, sondern nur den Namen des Autors/der + Autoren mit "`Idem"' bzw. "`idem"'. Sie ist mit der |ibidem|-Option + kombinierbar. Folgende Werte sind möglich: |idem| (gleichbedeutend mit + |idem=strict|), |idem=strictdoublepage| und |idem=nostrict|. Das jeweilige + Verhalten bei Seitenumbrüchen ist analog zu den |ibidem|-Optionen, weshalb ich + auf eine separate Übersicht verzichte. + + Umdefinitionen sind wie gehabt möglich über: + \begin{verbatim} + \AddTo\bibsgerman{% + \renewcommand*{\idemname}{Ders.} + \renewcommand*{\idemmidname}{ders.} + } + \end{verbatim} +\end{Options}% + +\DescribeMacro{\noidem} |\noidem| funktioniert analog zu |\noibidem| und setzt +den |idem|-Mechanismus für das folgende Zitat außer Kraft. + + \begin{Options} + \item[\texttt{opcit}] + Diese Option plaziert das Kürzel "`\textit{op.\,cit.}"' (opere citato: bereits zitiert) im Zitat. + Ein Beispiel:\\[1.5ex] + {\footnotesize\textsuperscript{1}\,Aamport, \textit{Gnats and Gnus} (1986), S.\,25.}\\ + {\footnotesize [\ldots]}\\ + {\footnotesize\textsuperscript{5}\,Aamport, \textit{op.\,cit.}, S.\,37.} + + Anpassungen sind möglich über: + + \begin{verbatim} + \renewcommand*{\opcit}{\textit{op.\,cit.}} + \end{verbatim} + + \DescribeMacro{opcit=chapter} + \DescribeMacro{opcit=section} + Die Option |opcit| kann mit Hilfe der Werte |chapter| bzw. |section| zu Beginn + eines neuen Kapitels bzw. Abschnittes zurückgesetzt werden, d.\,h. es + erscheint bei erneuter Zitierung eines Werkes nach Kapitelbeginn wieder die + Form, die durch alle anderen Optionen festgelegt wurde. Dies ist vollkommen + analog zu |citefull=chapter| bzw. |citefull=section|. +\end{Options} + +\section{Sprachanpassungen} + +Der zunehmenden Verbreitung von \textsf{jurabib} unter Nicht-Juristen +\texttt{;-)} Rechnung tragend, habe ich u.\,a. den \BibTeX-Stil erheblich +überarbeitet, so daß nun \LaTeX-seitig eine Umschaltung der sprachspezifischen +Ausdrücke erfolgen kann, etwa, wenn das gesamte Dokument in englischer Sprache +verfaßt werden soll. Dies betrifft vor allem Umschaltungen wie etwa von +"`a.\,a.\,O\kern-1.2pt."' auf "`Ibid."'. + +\DescribeMacro{language =} Ebenso ist es möglich, innerhalb der +\texttt{.bib}-Datei mit Hilfe des \texttt{language}-Feldes die für den +jeweiligen Eintrag zutreffende Sprache auszuwählen.\footnote{Dieses Feature hat +wesentlich vom \texttt{bibgerm}-Paket profitiert.} Zur Zeit sind Englisch, +Französisch, Holländisch, Spanisch, Italienisch und Deutsch implementiert: + +\begin{verbatim} + @INCOLLECTION{incollection-crossref, + author = {Daniel D. Lincoll}, + title = {Semigroups of Recurrences}, + pages = {179--183}, + language = {english} + } +\end{verbatim} + +Ab Version 0.5e erfolgt keine Modifizierung der \texttt{title}-Felder +bezüglich Groß- und Kleinschreibung mehr. + +Im Gegensatz zum \textsf{bibgerm}-Paket brauchen Sie für ein deutschsprachiges +Dokument nur bei den \emph{relevanten} Einträgen \texttt{language = +\marg{andere Sprache}} anzugeben. Dies gilt ebenso bei der Verwendung von +\textsf{babel}, \textsf{jurabib} wird automatisch die über die +\textsf{babel}-eigenen Mechanismen gewählte Hauptsprache als Voreinstellung +verwenden~-- sofern diese innerhalb von \textsf{jurabib} definiert ist. +Ein weiterer Unterschied zum \textsf{bibgerm}-Paket besteht darin, daß die +sprachspezifischen Einstellungen von der via \textsf{babel} angegebenen +Hauptsprache abhängen. Jedoch werden die \emph{Trennmuster} für jeden Eintrag +im Literaturverzeichnis und jedes Zitat individuell in Abhängigkeit von der +angebenen Sprache des Eintrages gewählt. + +Eine Anpassung der sprachspezifischen Ausdrücke an eigene Vorstellungen ist +möglich: +\begin{verbatim} + \AddTo\bibsgerman{\def\editorname{Herausgeber}} +\end{verbatim} +Für das Englische lautet das Makro \cs{bibsenglish}. + +Sollte ich bei der Einarbeitung der englischen Begriffe noch etwas übersehen +oder eine unglückliche Formulierung gewählt haben, bitte ich um Nachricht. +Ebenso, wenn andere Sprachen unterstützt werden sollen. + +\section{Über den Tellerrand} + +\subsection{\textsf{jura.cls}} + +Wie schon erwähnt, ist eine Benutzung mit \textsf{\mbox{jura.cls}} möglich. + +\subsection{\textsf{bibtopic.sty}} + +\textsf{jurabib.sty} ist bislang unter einer Bedingung kompatibel zu +\textsf{bibtopic.sty}: Es müssen alle Kurztitel angegeben werden, da es sonst +zu zweideutigen Zitaten kommen kann. Es ist derzeit nicht möglich, das Feature +des automatischen Setzens des Kurztitels zu verwenden, wenn geteilte +Literaturdatenbanken verwendet werden. Deshalb erfolgt eine Aktivierung der +Option \texttt{titleformat=all} automatisch, wenn \textsf{bibtopic.sty} geladen +ist. Anmerkung: Sie sollten mindestens Version \texttt{1.0j} benutzen. + +\subsection{\textsf{hyperref.sty}} + +Ab Version 0.4b ist \textsf{jurabib} kompatibel mit +\textsf{hyperref}.\footnote{Auch hier war erneut \textsc{Stefan Ulrich} +entscheidend beteiligt.} Es existiert jedoch (noch) eine Inkompatibilität mit +\textsf{alphanum}, die bewirkt, daß der \cs{ref}-Mechanismus von +\textsf{alphanum} nur eingeschränkt funktioniert. Das bedeutet im einzelnen, +daß der Befehl \cs{ref*} nur relative Verweise liefert. Wenn Sie +\textsf{alphanum} und \textsf{hyperref} ohne \textsf{jurabib} benutzen wollen, +sollten sie folgendes in Ihre Präambel schreiben: + \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} + +Seit Version 0.51 hat \textsf{jurabib} eine neue interne +URL-Schnittstelle. Mit dieser gibt es kein (bis jetzt bekanntes) Problem bei +der Verwendung mit \textsf{hyperref}. Es wird nun eine separate Datei +\meta{Dokument}|.url| generiert, welche die URL enthält. Bitte stellen sie +sicher, daß Sie keine so benannte Datei für andere Zwecke benutzen. Sollte +\textsf{jurabib} eine solche Datei vorfinden, die nicht von \textsf{jurabib} +selbst generiert wurde, erhalten Sie eine Fehlermeldung. Das Verdienst an der +Lösung dieses Problems hat einzig \textsc{Stefan Ulrich}. + +\subsection{\textsf{babel.sty}} + +\textsf{jurabib} ist nun ohne weitere Manipulation mit \textsf{babel} +kompatibel und detektiert selbständig + die Hauptsprache. Dabei ist es egal, wie Sie die Sprache(n) angegeben haben + -- ob als globale Option: +\begin{verbatim} + \documentclass[english,german]{article} + % ^^^^^^ die zuletzt angegebene Sprache + % ist die Hauptsprache !! + \usepackage{babel} +\end{verbatim} +oder als \textsf{babel}-Paketoption: +\begin{verbatim} + \usepackage[english,german]{babel} . +\end{verbatim} +{\Large Sie müssen \textsf{babel} vor \textsf{jurabib} laden\,!} + +\subsection{\textsf{chapterbib.sty}} +\textsf{jurabib} ist kompatibel zu \textsf{chapterbib}. Siehe dazu +Beispieldokument |jbtestcb.tex|. + +\subsection{\textsf{bibunits.sty}} +\textsf{jurabib} ist kompatibel zu \textsf{bibunits} (bitte +benutzen Sie mindestens Version |2.1n|). Siehe dazu Beispieldokument |jbtestbu.tex|. + +\subsection{\textsf{multibib.sty}} +\textsf{jurabib} ist kompatibel zu \textsf{multibib} (bitte +benutzen Sie Versionen $>$~|1.2|). Siehe dazu Beispieldokument |jbtestmb.tex|. + + +\subsection{\textsf{index.sty}} +Wenn Sie das \textsf{french}-, \textsf{pmfrench}- oder das +\textsf{frenchle}-Paket verwenden, können Sie dieses Feature momentan nicht +verwenden. + +Mit Hilfe der Option \texttt{authorformat=indexed} können Sie alle zitierten +Autoren in den Index aufnehmen. Möchten Sie einen separaten Autoren-Index +erstellen, können Sie das \textsf{index}-Paket von \textsc{David M. Jones} +verwenden, das Bestandteil des \textsf{camel}-Bündels ist. Um mit +\textsf{index.sty} einen zusätzlichen Index zu deklarieren, tun sie folgendes: +\begin{verbatim} + [...] + \usepackage[authorformat=indexed]{jurabib}% + [...] + \usepackage{index} + \newindex{default}{idx}{ind}{Index} % für den normalen Index + \newindex{aut}{adx}{and}{Autorenindex} % für den neuen Index + \renewcommand*{\jbindextype}{aut} % + [...] + \begin{document} + [...] + \printindex % für den normalen Index + \printindex[aut] % für den neuen Index + \end{document} +\end{verbatim} +Beachten Sie, daß \cs{jbindextype} dem Wert des ersten Argumentes von +\cs{newindex} entsprechen muß. + +Um den Index dann via MakeIndex zu generieren, rufen Sie für obiges Beispiel +\begin{verbatim} + makeindex -g -s german.ist -o datei.and datei.adx +\end{verbatim} +auf. Anschließend muß das Dokument noch einmal mit \LaTeX{} bearbeitet werden. +Alles weitere entnehmen Sie bitte der Dokumentation des \textsf{index}-Paketes. + +\subsection{\textsf{endnotes.sty}} +\textsf{jurabib} ist kompatibel mit \textsf{endnotes}. Durch einfaches Hinzufügen von |\usepackage{endnotes}| zur +Präambel Ihres Dokumentes werden Ihre |\foot[full]cite|-Zitate zu Endnoten +"`konvertiert"', die dort erscheinen, wo Sie den Befehl |\theendnotes| plaziert +haben. "`Normale"' Zitate oder solche, die in |\footnote|-Befehle gefaßt sind, +werden per Voreinstellung nicht konvertiert\,! Sollten Sie das wünschen, benutzen +Sie die Option `|citetoend=true|' oder ziehen Sie bitte die +\textsf{endnotes}-Dokumentation zu Rate. + +Endnoten besitzen per Voreinstellung keinen abschließenden Punkt. Sollten Sie +trotzdem einen Punkt benötigen, benutzen sie bitte die Option |dotafter=endnote|. + +\section{Mitstreiter} +Dieses Paket wäre ohne die tatkräftige Hilfe von \textsc{Stefan Ulrich}, +\textsc{Andreas Stefanski} und \textsc{Oren Patashnik} nie entstanden. +Besonders \textsc{Stefan Ulrich} ist es zu verdanken, daß dieses Paket in +dieser Form zustandekommen konnte und nicht schon in der Anfangsphase +steckenblieb. Ihm gilt mein besonderer Dank. \textsc{Heiko Oberdiek} lieferte +ebenso wertvolle Hinweise. \textsc{Andreas Stefanski} stand mir als +unermüdlicher Tester und Berater in Sachen juristischer Formalien zur Seite. +Nicht zu vergessen hat \textsc{Oren Patashnik} entscheidende Code-Teile des +\BibTeX-Stils geliefert, die ein dynamisches Setzen des juristischen Kurztitels +überhaupt erst ermöglicht haben. \textsc{Bernard Gaulle} hat viel für die +Kompatibilität mit den french Paketen getan und gab viele wertvolle Hinweise, +speziell zur Sprachunterstützung. Ich möchte \textsc{Maarten Wisse} für die +Übersetzung der Dokumentation danken, ebenso für seine Geduld und seine vielen +Hinweise während der Implementation der grundlegenden Optionen für die +Geisteswissenschaften. + \textsc{Peter Flynn} und \textsc{P\'{a}draig de~Br\'{u}n} haben ebenso neue + Optionen für Nicht-Juristen vorgeschlagen. Und dann sind da noch viele Leute, + die als Beta-Tester oder als fleißiger Bug-Reporter meinen Dank verdienen (die + Reihenfolge ist keine Wertung\,!): \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} + und \textsc{Tilman Finke}. + +\section[Rückkopplung erwünscht]{Rückkopplung erwünscht \dots} + +Fragen, Vorschläge, Kritik oder sonstige Anregungen können gerichtet werden an: +\texttt{jb jurabib org} + +\newpage + +\bibliographystyle{jurabib} +\end{document} diff --git a/macros/latex/contrib/jurabib/jurabib.dtx b/macros/latex/contrib/jurabib/jurabib.dtx new file mode 100644 index 0000000000..1996af79f4 --- /dev/null +++ b/macros/latex/contrib/jurabib/jurabib.dtx @@ -0,0 +1,14030 @@ +% \iffalse +% jurabib.dtx +% +% Docstrip archive, run jurabib.ins through LaTeX. +% +% Run jbgerdoc.tex through LaTeX for German documentation. +% +% Run jbendoc.tex through LaTeX for English documentation. +% +% Copyright (C) 1999-2004 Jens Berger +% This program is free software; you can redistribute it and/or +% modify it under the terms of the GNU General Public License +% as published by the Free Software Foundation; either version 2 +% of the License, or (at your option) any later version. +% +% This program is distributed in the hope that it will be useful, +% but WITHOUT ANY WARRANTY; without even the implied warranty of +% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +% GNU General Public License for more details. +% +% You should have received a copy of the GNU General Public License +% along with this program; if not, write to the Free Software +% Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. +% +%<*driver> +\documentclass{ltxdoc} +\begin{document}\DocInput{jurabib.dtx}\end{document} +% +% \fi +% \ClassError{jurabib}{The German jurabib documentation will no longer be\MessageBreak +% produced by LaTeX'ing the file jurabib.dtx!\MessageBreak +% Please use `latex jbgerdoc.tex' instead. You will\MessageBreak +% find this file on CTAN and on www.jurabib.org}% +% \endinput +%<*package> +\NeedsTeXFormat{LaTeX2e}[1995/12/01] +\ProvidesPackage{jurabib}[2004/01/25 v0.6 Extended citations] +\RequirePackage{ifthen} +\RequirePackage{calc} +\RequirePackage{keyval} +\RequirePackage{url} +\RequirePackage{array} +\newcommand*{\jb@pkg@name}{jurabib} +\newif\ifjb@abbrv +\newif\ifjbidemabbrvwithperiod +\newif\ifjb@all@titles +\newif\ifjb@all@full +\newif\ifjb@allow@adding@of@pagerange +\newif\ifjb@allow@adding@of@pagerange@for@first@cite +\newif\ifjb@allow@dot@for@lookat +\newif\ifjb@allow@lookat@for@fullcite +\newif\ifjb@allow@howcited@art@period +\newif\ifjb@allow@hyper@cite@nobib +\newif\ifjb@allow@hyper@cite +\newif\ifjb@allow@nobib +\newif\ifjb@alphanum +\newif\ifjb@always@pageranges +\newif\ifjbaltformat +\newif\ifjb@author@year +\newif\ifjb@babel +\newif\ifjb@backref +\newif\ifjb@before@title@separator +\newif\ifjb@bib@hang +\newif\ifjb@bibetal\jb@bibetaltrue +\newif\ifjb@biblikecite +\newif\ifjb@bibssed +\newif\ifjb@change@fonts@for@fullcite +\newif\ifjb@cite +\newif\ifjb@cite@title +\newif\ifjb@cite@no@title +\newif\ifjb@annotator@last +\newif\ifjb@compare@title@fields +\newif\ifjb@comma@before@rest +\newif\ifjb@compressed@bib +\newif\ifjb@citetoend +\newif\ifjbcross +\newif\ifjb@debug +\newif\ifjb@debug@br +\newif\ifjb@do@authors@index +\newif\ifjb@do@editors@index +\newif\ifjb@do@organizations@index +\newif\ifjb@dot +\newif\ifjb@dynamic@author@fonts +\newif\ifjb@dynamic@crossrefs +\newif\ifjb@edby +\newif\ifjb@endnotes +\newif\ifjbetal +\newif\ifjb@fn +\newif\ifjb@foot +\newif\ifjb@footnote@period +\newif\ifjb@footnote@period@ibidem +\newif\ifjb@first@cite +\newif\ifjb@firstcite@full +\newif\ifjb@first@author@reversed +\newif\ifjb@formatted@pages +\newif\ifjb@fullcite@again +\newif\ifjblookforgender +\newif\ifjb@howcited +\newif\ifjb@howcited@all +\newif\ifjb@howcited@normal +\newif\ifjb@howcited@compare +\newif\ifjb@howcited@multiple +\newif\ifjb@humanbst@loaded +\newif\ifjb@hyper +\newif\ifjb@ibidem +\newif\ifjb@ibidem@pagewise +\newif\ifjb@ibidem@double@pagewise +\newif\ifjb@ibidem@with@name +\newif\ifjb@ibidem@with@short@name +\newif\ifjb@ibidem@with@name@and@title +\newif\ifjb@ibidem@with@name@and@title@auto +\newif\ifjb@same@author@different@work +\newif\ifjb@idem +\newif\ifjb@idem@pagewise +\newif\ifjb@idem@double@pagewise +\newif\ifjb@ignore@varioref +\newif\ifjb@index +\newif\ifjb@index@bib +% NEW 0.6 +\newif\ifjb@index@only@first@authors +\newif\ifjb@index@only@first@editors +\newif\ifjb@index@only@first@organization +\newif\ifjb@jura +\newif\ifjb@jox +\newif\ifjb@jureco +\newif\ifjb@kv@recognized +\newif\ifjb@lookat +\newif\ifjb@no@bib\global\jb@no@bibfalse +\newif\ifjb@no@lookat@for@bib +\newif\ifjb@no@nested@crossrefs +\newif\ifjb@no@title@replace +\newif\ifjb@no@firstname +\newif\ifjb@numbered@bib +%\newif\ifjb@natbib@order +\newif\ifjb@old@order +% NEW 0.6 switch to enable \bibel{