diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-fiwi/biblatex-fiwi.tex')
| -rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-fiwi/biblatex-fiwi.tex | 157 |
1 files changed, 138 insertions, 19 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-fiwi/biblatex-fiwi.tex b/Master/texmf-dist/doc/latex/biblatex-fiwi/biblatex-fiwi.tex index 87a6a591ac5..b761adf5e6e 100644 --- a/Master/texmf-dist/doc/latex/biblatex-fiwi/biblatex-fiwi.tex +++ b/Master/texmf-dist/doc/latex/biblatex-fiwi/biblatex-fiwi.tex @@ -1,7 +1,7 @@ %!TEX encoding = UTF-8 Unicode %!TEX TS-program = lualatex % !BIB TS-program = biber -% biblatex-fiwi,v 1.6 2016/09/09 +% biblatex-fiwi,v 1.6b 2017/01/27 \documentclass{ltxdockit} \usepackage{luatex85} @@ -82,7 +82,7 @@ BoldItalicFont = *-BoldItalic, url={http://www.ctan.org/pkg/biblatex-fiwi}, author={Simon Spiegel}, email={simon@simifilm.ch}, - revision={1.6a}, + revision={1.6b}, date={\rcstoday}} \hypersetup{% @@ -164,7 +164,7 @@ BoldItalicFont = *-BoldItalic, \hyphenation{% } - +\let\emph\textit \begin{document} \printtitlepage @@ -247,16 +247,37 @@ Mit dieser Option wird beim Zitieren von Filmen mit \cmd{filmcite} der Titel der \item[true] Im Normalfall wird, falls vorhanden, \bibfield{indextitle} indexiert, andernfalls \bibfield{title}; werden zwei Filme mit identischem Titel indexiert, wird zur Unterscheidung zusätzlich das Jahr in Klammern ausgegeben. \item[complete] Ist \opt{filmindex} auf \opt{complete} gesetzt, werden die komplette filmographische Angaben ausgegeben, wie sie mit \cmd{printbibliography} erscheinen würden. Damit kann auf eine eigenständige Filmographie verzichtet werden. \end{valuelist} +Siehe zum Indexieren von Filmen auch \secref{{sub:indexfield}}. + +\boolitem[false]{splitfilmindex} +Mit Paketen wie \sty{imakeidx}\fnurl{http://ctan.org/pkg/imakeidx} resp. \sty{splitidx} (ist Teil von \sty{koma-script}\fnurl{http://ctan.org/pkg/koma-script}) ist es möglich, mehrere Indizes in einem Dokument zu setzen, z.\,B. einen für Literatur und einen für Filme. \sty{biblatex-fiwi} bietet die Möglichkeit, Filmtitel automatisch in ein separates Index-File zu schreiben, so dass am Ende ein eigener Filmindex erzeugt werden. Ist diese Option aktiviert, werden Filmtitel mit dem Befehl \cmd{index[film]} zitiert und in ein entsprechendes .idx-File geschrieben. Um diese Funktion zu nutzen, muss \opt{filmindex} aktiviert und eines der genannten Pakete geladen werden; zudem müssen die passenden Indizes mit \cmd{makeindex} erzeugt werden. Der entsprechende Code sieht so aus: + +\begin{lstlisting}[style=latex]{} +… +\ExecuteBibliographyOptions{filmindex=true} +\ExecuteBibliographyOptions{splitfilmindex=true} +… +\usepackage{imakeidx} +\makeindex[...] +\makeindex[name=film, ...] +... +\begin{document} +... +\printindex +\printindex[film] +\end{document} +\end{lstlisting} +Siehe zum Indexieren von Filmen auch \secref{sub:indexfield}. \boolitem[true]{citeprefix} Das korrekte Schreiben und Sortieren von Nachnamen mit Zusätzen wie <von> oder <van> ist eine Wissenschaft für sich. Im Deutschen gilt grundsätzlich folgende Regel: Ein Name wie »Ursula von Keitz« muss in der Bibliographie als »Keitz, Ursula von« erscheinen. Dies gilt aber nicht für Namen in anderen Sprachen; im Prinzip müssen hier jeweils die Regeln der Sprache des Herkunftslandes befolgt werden. Und streng genommen gibt es auch einen Unterschied zwischen der Deutschen »Ursula von Keitz« und dem Schweizer »Peter von Matt«. Im ersten Fall handelt es sich ursprünglich um einen Adelstitel, im zweiten Fall um einen Flurnamen, der eigentlich als »von Matt, Peter« in der Bibliographie stehen müsste. -Steht unter \bibfield{name} einfach \opt{von Keitz, Ursula}, dann erfolgt die Ausgabe auch als »von Keitz, Ursula« und wird unter »von« einsortiert. Möchte man diese Ausgabe aber eine Einsortierung unter »Keitz«, dann müsste ein entsprechender Eintrag in das \bibfield{sortkey}"=Feld. +\sty{biblatex-fiwi} aktiviert setzt die \sty{biblatex}-Option standardmäßig auf \opt{true}. Steht unter \bibfield{name} einfach \opt{von Keitz, Ursula}, dann erfolgt die Ausgabe somit als »von Keitz, Ursula« und wird unter »von« einsortiert. Möchte man diese Ausgabe aber eine Einsortierung unter »Keitz«, dann müsste ein entsprechender Eintrag in das \bibfield{sortkey}"=Feld. Setzt man dagegen in das Feld \bibfield{options} den Eintrag \bibfield{useprefix=false}, dann lautet die Ausgabe »Keitz, Ursula von« und wird unter »Keitz« einsortiert. -Unabhängig von diesem Feld lautet die Ausgabe im Text in jedem Fall standardmäßig »von Keitz« resp. »von Matt«. Für Zitate im Text wird \option{useprefix=false} also normalerweise ignoriert. Mit der Option \opt{nociteprefix} kann dies geändert werden, dann steht auch beim Zitat im Text nur noch »Matt« bzw. »Keitz«. Die Kurzform \opt{citeprefix} entspricht \kvopt{citeprefix}{true}. +Unabhängig von diesem Feld lautet die Ausgabe im Text in jedem Fall standardmäßig »von Keitz« resp. »von Matt«. Für Zitate im Text wird \option{useprefix=false} also normalerweise ignoriert. Mit der Option \opt{citeprefix} kann dies geändert werden, dann steht auch beim Zitat im Text nur noch »Matt« bzw. »Keitz«. Die Kurzform \opt{citeprefix} entspricht \kvopt{citeprefix}{true}. \boolitem[false]{dashed} @@ -342,7 +363,7 @@ Kombination der vorhergehenden Befehle, der bestimmt, ob der Inhalt von \bibfiel Aktiviert die Ausgabe der Felder \bibfield{isbn/issn/isrn/isan}. \boolitem[false]{compactcite} -Wenn mit einem \cmd{cite}-Befehl zwei Werke des gleichen Autors zitiert werden, so geschieht das normalerweise in Form von »Autor Jahr, Autor Jahr«. Ist diese Option aktiviert, werden die beiden Verweise als »Autor Jahr und Jahr« zusammengezogen, z.\,B. »Müller 1997 und 1998«. Die Funktion hat allerdings einen Haken: Standardmäßig ist <und> als Verbindung zwischen den beiden Jahreszahlen definiert. Da \sty{biblatex} nicht unterscheiden kann, ob mehr als zwei Quellen des gleichen Autors zitiert werden, würde ein Beispiel mit drei Quellen des gleichen Autors so aussehen: »Müller 1997 und 1998 und 1999«. Das verbindende Partikel, normalerweise <und>, wird in \cmd{compcitedelim} definiert. +Wenn mit einem \cmd{cite}- resp. \cmd{parencite}-Befehl zwei Werke des gleichen Autors zitiert werden, so geschieht das normalerweise in Form von »Autor Jahr, Autor Jahr«. Ist diese Option aktiviert, werden die beiden Verweise als »Autor Jahr und Jahr« zusammengezogen, z.\,B. »Müller 1997 und 1998«. Die Funktion hat allerdings einen Haken: Standardmäßig ist <und> als Verbindung zwischen den beiden Jahreszahlen definiert. Da \sty{biblatex} nicht unterscheiden kann, ob mehr als zwei Quellen des gleichen Autors zitiert werden, würde ein Beispiel mit drei Quellen des gleichen Autors so aussehen: »Müller 1997 und 1998 und 1999«. Das verbindende Partikel, normalerweise <und>, wird in \cmd{compcitedelim} definiert. \optitem[true]{mergedate}{\opt{maximum}, \opt{compact}, \opt{basic}, \opt{minimum}, \opt{true (=basic)}, \opt{false}} @@ -463,7 +484,7 @@ Standardmäßig aktiviert \sty{biblatex-fiwi} die Option \opt{indexing=cite}, da \indexentry{Index-Eintrag@Index-Eintrag}{Seitenzahl}. \end{ltxcode} % -Der zweite Teil des Eintrags nach dem @-Zeichen zeigt dem Programm \sty{makeindex} an, wie der Eintrag sortiert werden muss und kann bei Bedarf über das Feld \bibfield{indextitle} definiert werden (ist \bibfield{indextitle} nicht definiert, wird \bibfield{title} verwendet). Das weitaus mächtigere Index"=Programm \bin{xindy}\fnurl{http://xindy.sourceforge.net/} ermöglicht viel komplexere Sortiervorgänge und benötigt den zweiten Teil des Index"=Eintrags nicht -- im Gegenteil: Dieser macht die Verarbeitung mit \bin{xindy} viel aufwendiger. Die Option \opt{xindy} unterbindet deshalb, dass der zweite Teil ausgegeben wird; der Eintrag in die \sty{.idx}"=Datei sieht dann folgendermaßen aus: +Der zweite Teil des Eintrags nach dem @-Zeichen zeigt dem Programm \sty{makeindex} an, wie der Eintrag sortiert werden muss und kann bei Bedarf über das Feld \bibfield{indextitle} definiert werden (ist \bibfield{indextitle} nicht definiert, wird \bibfield{title} verwendet). Das weitaus mächtigere Index"=Programm \bin{xindy}\fnurl{http://xindy.sourceforge.net/} ermöglicht viel komplexere Sortiervorgänge und benötigt den zweiten Teil des Index"=Eintrags nicht -- im Gegenteil: Der so genannte Actual-Operator @ macht die Verarbeitung mit \bin{xindy} viel aufwendiger. Die Option \opt{xindy} unterbindet deshalb, dass der zweite Teil ausgegeben wird; der Eintrag in die \sty{.idx}"=Datei sieht dann folgendermaßen aus: \begin{ltxcode} \indexentry{Index-Eintrag}{Seitenzahl}. @@ -471,7 +492,7 @@ Der zweite Teil des Eintrags nach dem @-Zeichen zeigt dem Programm \sty{makeinde % In diesem Fall hat das Feld \bibfield{indexsorttitle} auch keinen Einfluss auf den Index"=Eintrag. Die Kurzform \opt{xindy} entspricht \kvopt{xindy}{true}. -Beim Zitieren eines Films mittels \cmd{citefilm} wird der Titel des Films und nicht der Regie indexiert. Wie beim \cmd{citefilm}-Befehl überprüft \sty{biblatex-fiwi} dabei, ob innerhalb des Dokuments mehrere Filme mit gleichen Titels zitiert werden. Ist dies der Fall, wird zur Unterscheidung automatisch das Jahr im Index angegeben. +Beim Zitieren eines Films mittels \cmd{citefilm} wird der Titel des Films und nicht der Name des Regisseurs indexiert. Wie beim \cmd{citefilm}-Befehl überprüft \sty{biblatex-fiwi} dabei, ob innerhalb des Dokuments mehrere Filme mit gleichen Titels zitiert werden. Ist dies der Fall, wird zur Unterscheidung automatisch das Jahr im Index angegeben (siehe zum Indexieren von Filmen \secref{sub:indexfield}). In jedem Fall muss die Index"=Erzeugung mittels eines Paket wie \sty{makedidx} oder \sty{imakedidx} sowie dem Befehl \cmd{makeindex} aktiviert werden. \end{optionlist} @@ -829,26 +850,116 @@ Filme werden normalerweise in einer gesonderten Filmographie aufgeführt. Da \st \addbibresource{...} \begin{document} ... -\printbibheading -<<\defbibfilter{film}{% - ( type=misc or type=movie or type=video)}>> -\printbibliography[<<nottype=movie,nottype=video,nottype=misc>>, - heading=subbibliography, title={Literatur}] -\printbibliography[<<filter=film>>,heading=subbibliography, - title={Filmographie}] +\printbibliography[<<nottype=movie,nottype=video,nottype=misc>>,heading=subbibliography, title={Literatur}] +\printbibliography[<<type=movie,type=video,type=misc>>,heading=subbibliography,title={Filmographie}] \end{document} \end{ltxexample} % Normalerweise werden Filmographien nicht nach dem Namen des Regisseurs, sondern nach dem Titel des Films geordnet. Seit Version 2.0 bietet \sty{biblatex} die Möglichkeit, das Sortier"=Schema nicht nur global, sondern gesondert für jede Bibliographie zu setzen. \sty{biblatex-fiwi} bietet zusätzlich zu den Standard"=Schemata noch das Sortierschema \opt{title}, das ausschliesslich nach Titeln ordnet: \begin{ltxexample} -\printbibliography[type=movie,video,<<sorting=title>>] +<<\newrefcontext[sorting=title]>> +\printbibliography[ype=movie,type=video,type=misc,heading=subbibliography,title={Filmographie}] \end{ltxexample} % Bei einzelnen Folgen von Fernsehserien wird zuerst nach \bibfield{maintitle} und anschließend nach \bibfield{title} sortiert.\footnote{In früheren Versionen wurde mittels \cmd{DeclareSortExclusion} das Sortieren nach Autoren, Herausgebern etc. für \bibtype{misc,movie} und \bibtype{video} generell deaktiviert. Dies ist nun nicht mehr der Fall. Das kann zur Folge haben, dass bestehende Dokumente angepasst werden müssen.} Zudem bietet \bin{biber} die Möglichkeit, beim Sortieren von Filmtiteln die Artikel zu ignorieren, so dass beispielsweise \textsc{The Godfather} unter <G> eingeordnet wird. Standardmäßig werden bei \sty{biblatex-fiwi} so die gängigen Artikel in den Feldern \bibfield{title} und \bibfield{maintitle} ignoriert. Mit der Option \opt{ignorearticle=false} kann diese Funktion deaktiviert werden. Wenn alle Stricke reißen, kann man am Ende immer noch auf die Felder \bibfield{sorttitle} respektive \bibfield{sortkey} ausweichen. +\subsection{Indexieren von Filmen}\label{sub:indexfield} + +\sty{biblatex-fiwi} bietet mit \opt{filmindex} und \opt{splitfilmindex} zwei Optionen zum Indexieren von Filmen (\secref{opt}). Ist \opt{filmindex} aktiviert, führt \cmd{citefilm} zu folgendem Eintrag in das .idx-File: + +\begin{lstlisting}[style=bibtex]{} +@movie{Kubrick.S:1968, + Location = {GB and USA}, + Director = {Kubrick, Stanley}, + Subtitle = {2001: Odyssee im Weltraum}, + Title = {2001: A Space Odyssey}, + Year = {1968}} +\end{lstlisting} +\begin{lstlisting}[style=latex]{} +\indexentry{2001: A Space Odyssey@\textsc {2001: A Space Odyssey}}{1} +\end{lstlisting} +% +Ist \opt{filmindex} auf \opt{complete} gesetzt, erzeugt \sty{biblatex-fiwi} folgenden Eintrag: + +\begin{lstlisting}[style=bibtex]{} +\indexentry{2001: A Space Odyssey @ \fullcite {Kubrick.S:1968}}{1} +\end{lstlisting} +\sty{biblatex-fiwi} schreibt also einfach einen \cmd{fullcite}-Befehl in den Index, entsprechend sieht das Ergebnis aus. +% +Falls nun zwei Filme mit gleichem Titel indexiert werden, wird automaitsch das Jahr in das .idx-File geschrieben: + +\begin{lstlisting}[style=bibtex]{} +@movie{Siegel.D:1956, + Location = {USA}, + Director = {Siegel, Don}, + Subtitle = {Die Dämonischen}, + Title = {Invasion of the Body Snatchers}, + Year = {1956}} +@movie{Kaufman.P:1978, + Location = {USA}, + Director = {Kaufman, Philip}, + Subtitle = {Die Körperfresser kommen}, + Title = {Invasion of the Body Snatchers}, + Year = {1978}} +\end{lstlisting} + +\begin{lstlisting}[style=bibtex]{} +\indexentry{Invasion of the Body Snatchers (1978)@\textsc {Invasion of the Body Snatchers} (1978)}{1} +\indexentry{Invasion of the Body Snatchers (1956)@\textsc {Invasion of the Body Snatchers} (1956)}{1} +\end{lstlisting} +% +Ist \opt{filmindex=complete} gesetzt, sieht der Eintrag etwas anders aus: +\begin{lstlisting}[style=latex]{} +\indexentry{Invasion of the Body Snatchers1978 @ \fullcite {Kaufman.P:1978}}{1} +\indexentry{Invasion of the Body Snatchers1956 @ \fullcite {Siegel.D:1956}}{1} +\end{lstlisting} +% +In beiden Fällen ist also sicher gestellt, dass \bin{makeindex} die Einträge unterscheiden kann. + +Die Option \opt{xindy} sorgt dafür, dass der Actual-Operator @ und der zweite Teil des Eintrags nicht ausgegeben wird. In diesem Fall sieht ein Eintrag folgendermaßen aus: + +\begin{lstlisting}[style=latex]{} +\indexentry{\textsc {2001: A Space Odyssey}}{1} +\end{lstlisting} +% +Ein Eintrag dieser Form führt bei der Kombination von \opt{filmindex=complete} und \opt{xindy} zu falschen Sortierungen; denn in diesem Fall würde nur ein \cmd{fullcite}-Befehl im .idx-File stehen und \bin{xindy} hätte keine Möglichkeit, den Filmtitel zu ermitteln. Deshalb ist hier ein bisschen Gebastel nötig. Bei \opt{filmindex=complete} wird zusätzlich der Filmtitel (resp. \bibfield{indextitle}) in das .idx-File geschrieben. + +\begin{lstlisting}[style=latex]{} +\indexentry{\sortentry {2001: A Space Odyssey} \fullcite {Kubrick.S:1968}}{1} +\end{lstlisting} + +Der Befehl \cmd{sortentry} ist so definiert, dass sein Inhalt nicht ausgegeben wird. Dieser Teil des Index-Eintrags erscheint also nicht im Index, sondern dient dazu, \bin{xindy} anzuzeigenden, welcher Teil des Eintrags zum Sortieren gedacht ist. Mit einer Merge-Rule dieser Form kann man dann dafür sorgen, dass der Eintrag richtig sortiert wird: +\begin{lstlisting}[style=latex]{} +(merge-rule "\\sortentry \{(.*)\}\\fullcite(.*)" "\1" :eregexp :again) +\end{lstlisting} +% +Zur Erklärung: Diese Regel sortiert den Eintrag unter dem Inhalt von \cmd{sortentry}. Da \cmd{sortentry} nichts anzeigt, erscheint nur der zweite Teil, also das Ergebnis von \cmd{fullcite}, im Index. + +Und hier schließlich noch ein Beispiel für einen Index-Eintrag eines Films, bei dem \bibfield{alternatetitlescript} (\secref{alternatetitle}) definiert ist: +\begin{lstlisting}[style=bibtex]{} +@movie{Protazanov.Y:1924, + Location = {SU}, + Alternatetitle = Аэлита, + Alternatetitlescript = {cyrillic}, + Director = {Protazanov, Yakov}, + Year = {1924}} +\end{lstlisting} +% +Ist \opt{filmindex=complete} gesetzt, sieht der Eintrag etwas anders aus (in der Variante mit \opt{filmindex=complete} und \opt{xindy}): +\begin{lstlisting}[style=latex]{} +\indexentry{\sortentry {Aelita} \fullcite {Protazanov.Y:1924}}{1} +\indexentry{\usebibmacro *{altscript:cyrillic-font}{{Аэлита}}\rmfamily |see{\textsc {Aelita}}}{1} +\end{lstlisting} +% +Hier werden zwei Einträge erzeugt. Zum einen Eintrag mit dem vollen Titel, der unter <Aelita> sortiert werden kann, sowie ein zweiter Eintrag mit dem kyrillischen Titel, der auf den lateinischen verweist. Damit dieser korrekt sortiert wird, ist wieder eine Merge-Rule nötig. +\begin{lstlisting}[style=latex]{} +(merge-rule "altscript\:(.*)-font(.*)" "\2" :eregexp :again) +\end{lstlisting} +Unschlüssig bin ich hinsichtlich der Frage, wie Einträge in nicht-lateinischem Alphabet sortiert werden müssen. Sinnvolle Ideen sind erwünscht. + \section{Verbundene Einträge}\label{sub:verbund} Seit Version 2.0 bietet \sty{biblatex} die Möglichkeit, zwei Einträge miteinander zu verknüpfen. Dabei wird im Feld \bibfield{related} der Citekey des verknüpften Eintrags und im Feld \bibfield{relatedtype} die Art der Verbindung angegeben. Mit \sty{biblatex-fiwi} sind verschiedene Varianten von Verknüpfungen möglich. @@ -1180,7 +1291,7 @@ Für die Beispiele wurden folgende Optionen zusätzlich zu den Standardeinstell \end{ltxexample} \fullcite{Kuhn.T:1976}. -\newpage\begin{ltxexample} +\begin{ltxexample} @incollection{Kepler.J:1993, Author = {Kepler, Johannes}, Bookauthor = {Kepler, Johannes}, @@ -1232,7 +1343,7 @@ Für die Beispiele wurden folgende Optionen zusätzlich zu den Standardeinstell \end{ltxexample} \fullcite{Kubrick.S:1968}. -\begin{ltxexample} +\newpage\begin{ltxexample} @movie{Lidelof.D:2004a, Author = {Lidelof, Damon and Cuse, Carlton and Abrams, J. J.}, Date = {2004/2010}, @@ -1295,7 +1406,15 @@ Für die Beispiele wurden folgende Optionen zusätzlich zu den Standardeinstell \begin{changelog} -\begin{release}{1.6a}{2017-01-29} +\begin{release}{1.6b}{2017-01-27} +\item Bugfixes für die Option \opt{filmindex} \see{opt} +\item Neue Option \opt{splitfilmindex} zum getrennten Indexieren von Filmtiteln \see{opt} +\item Bessere Implementierung der Option \opt{xindy} \see{opt} +\item Neues Unterkapitel zur Indexierung von Filmen \see{sub:indexfield}. +\end{release} + + +\begin{release}{1.6a}{2017-01-20} \item Die Option \opt{citefilm} kennt nun die Variante \opt{country}, bei der Produktionsland und -jahr ausgegeben werden \see{opt} \item Ist kein Regisseur definiert, wird nun die Produktionsfirma angegeben oder »[K.\,A.]« ausgegeben \see{sub:filme} \item Neue Option \opt{compactcite} zur kompakten Ausgabe von mehreren Zitaten des gleichen Autors \see{opt} |