summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-opcit-booktitle/documentation/biblatex-opcit-booktitle.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-opcit-booktitle/documentation/biblatex-opcit-booktitle.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-opcit-booktitle/documentation/biblatex-opcit-booktitle.tex190
1 files changed, 190 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-opcit-booktitle/documentation/biblatex-opcit-booktitle.tex b/Master/texmf-dist/doc/latex/biblatex-opcit-booktitle/documentation/biblatex-opcit-booktitle.tex
new file mode 100644
index 00000000000..16b24823565
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-opcit-booktitle/documentation/biblatex-opcit-booktitle.tex
@@ -0,0 +1,190 @@
+\documentclass{ltxdockit}[2011/03/25]
+\usepackage{btxdockit}
+\usepackage{fontspec}
+\usepackage[mono=false]{libertine}
+\usepackage{microtype}
+\usepackage[american]{babel}
+\usepackage[strict]{csquotes}
+\setmonofont[Scale=MatchLowercase]{DejaVu Sans Mono}
+\usepackage{shortvrb}
+\usepackage{pifont}
+\usepackage{minted}
+\setminted{breaklines}
+
+% Usefull commands
+\newcommand{\biblatex}{biblatex\xspace}
+\pretocmd{\bibfield}{\sloppy}{}{}
+\pretocmd{\bibtype}{\sloppy}{}{}
+\newcommand{\namebibstyle}[1]{\texttt{#1}}
+% Meta-datas
+\titlepage{%
+ title={\emph{Op. cit.} for booktitle field},
+ subtitle={Abbreviated references},
+ email={maieul <at> maieul <dot> net},
+ author={Maïeul Rouquette},
+ revision={1.0.2},
+ date={2015/06/05},
+ url={https://git.framasoft.org/maieul/biblatex-opcit-booktitle}}
+
+% biblatex
+\usepackage[citestyle=verbose-trad2]{biblatex}
+\addbibresource{biblatex-opcit-booktitle-example.bib}
+\usepackage{biblatex-opcit-booktitle}
+
+\begin{document}
+
+\printtitlepage
+\tableofcontents
+
+
+\section{Aim of the package}
+
+The default citation styles \verb+verbose-trad1+;\verb+verbose-trad2+;\verb+verbose-trad3+ use the \emph{op. cit.} form in order to have shorter reference when a title have been already cited.
+
+However, when you cite two entries which share the same \bibfield{booktitle} but not the same \bibfield{title}, the \emph{op. cit.} mechanism does not work.
+
+For example we obtain the following example:
+
+\begin{quotation}
+\makeatletter
+\cite{Pleiade_Barnabe}
+
+\csundef{blx@bsee@\the\c@refsection}
+
+\cite{Pseudo-Hippolyte}
+
+\csundef{blx@bsee@\the\c@refsection}
+
+\cite{Pleiade_Tite}
+
+\csundef{blx@bsee@\the\c@refsection}
+
+\cite{Pseudo-Epiphane}
+\makeatother
+\end{quotation}
+
+While we would like to obtain:
+
+\citereset
+
+
+\begin{quotation}
+
+\cite{Pleiade_Barnabe}
+
+\cite{Pseudo-Hippolyte}
+
+\cite{Pleiade_Tite}
+
+\cite{Pseudo-Epiphane}
+\end{quotation}
+
+The aim of this package is to enable such abbreviation.
+
+\section{Use}
+
+The \verb+biblatex-opcit-booktitle+ package must be loaded after the \verb+biblatex+ package. You must use a \verb+verbose-trad+ citation style. For example:
+
+\begin{minted}{latex}
+\usepackage[bibstyle=verbose,citestyle=verbose-trad1,citepages=omit]{biblatex}
+\usepackage{biblatex-opcit-booktitle}
+\end{minted}
+
+In order to know when two entry share the same \bibfield{booktitle}, you must use the crossref mechanism of \biblatex. In the case of the previous example, we used:
+\begin{minted}{latex}
+@book{Pleiade2,
+ Address = {Paris},
+ Number = {516},
+ Publisher = {Gallimard},
+ Series = {Bibliothèque de la Pléiade},
+ Title = {Écrits apocryphes chrétiens},
+ Volume = {2},
+ Year = {2005}}
+
+@bookinbook{Pleiade_Barnabe,
+ Annotator = {Enrico Norelli},
+ Crossref = {Pleiade2},
+ Pages = {627-642},
+ Title = {Actes de Barnabé},
+ Translator = {Enrico Norelli}}
+
+@bookinbook{Pleiade_Tite,
+ Annotator = {Willy Rordorf},
+ Bhg = {1850z},
+ Crossref = {Pleiade2},
+ Pages = {609-615},
+ Title = {Actes de Tite},
+ Translator = {Willy Rordorf}}
+
+@book{Schermann1907,
+ Address = {Leipzig},
+ Editor = {Theodor Schermann},
+ Publisher = {Teubner},
+ Title = {Prophetarum vitae fabulosae indices apostolorum discipulorumque Domini Dorotheo · Epiphanio · Hippolyto aliisque vindicata},
+ Year = {1907}
+}
+
+@bookinbook{Pseudo-Hippolyte,
+ Author = {{Pseudo-Hippolyte}},
+ Crossref = {Schermann1907},
+ Pages = {163-170},
+ Title = {Index apostolorum discipulorumque Domini}}
+
+@bookinbook{Pseudo-Epiphane,
+ Author = {{Pseudo-Épiphane}},
+ Crossref = {Schermann1907},
+ Pages = {107-126},
+ Title = {Index apostolorum discipulorumque Domini}}
+\end{minted}
+
+There is not other thing to do!
+
+The feature works with these entrytypes: \bibtype{inbook}, \bibtype{incollection}, \bibtype{inproceedings}, \bibtype{bookinbook}.
+
+\subsection{Limits}
+
+We have not implemented options to use abbreviation like \verb+ibid+, because we want to have not ambiguous abbreviated forms.
+
+If you have redefined the \verb+cite+ bibliographic macro, you must changes:
+\begin{minted}{latex}
+\usebibmacro{cite:full}%
+ \usebibmacro{cite:save}
+\end{minted}
+
+by:
+
+\begin{minted}{latex}
+\usebibmacro{cite:test:ifrelated}
+\end{minted}
+
+\subsection{Customization}
+
+You can change the \verb+inbook:rel+ bibliographic driver to customize the way the main title is printed.
+
+\section{Credits}
+
+This package was created for Maïeul Rouquette's phd dissertation\footnote{\url{http://apocryphes.hypothese.org}.} in 2015. It is freely inspired by Paul Stanley code.\footnote{\url{http://tex.stackexchange.com/a/172777/7712}.} It is licensed on the \emph{\LaTeX\ Project Public License}.\footnote{\url{http://latex-project.org/lppl/lppl-1-3c.html}.}.
+
+
+All issues can be submitted, in French or English, in the Framasoft issues page\footnote{\url{https://git.framasoft.org/maieul/biblatex-opcit-booktitle/issues}.}.
+
+
+\section{Change history}
+
+
+\begin{changelog}
+
+\begin{release}{1.0.2}{2015-06-05}
+\item Wrap \enquote{op. cit} in \cmd{mkibid}.
+\end{release}
+
+\begin{release}{1.0.1}{2015-06-03}
+\item Correct order of name's part (first name / last name).
+\end{release}
+
+\begin{release}{1.0.0}{2015-05-31}
+\item First public release.
+\end{release}
+
+\end{changelog}
+\end{document}