summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/biblatex-bookinother/documentation/biblatex-bookinother.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-bookinother/documentation/biblatex-bookinother.tex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-bookinother/documentation/biblatex-bookinother.tex252
1 files changed, 252 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-bookinother/documentation/biblatex-bookinother.tex b/Master/texmf-dist/doc/latex/biblatex-bookinother/documentation/biblatex-bookinother.tex
new file mode 100644
index 00000000000..a53352d0c5f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-bookinother/documentation/biblatex-bookinother.tex
@@ -0,0 +1,252 @@
+\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}
+\usepackage{graphics}
+% Usefull commands
+\newcommand{\reff}[1]{\ref{#1} p.~\pageref{#1}}
+\newcommand{\pkg}[1]{\emph{#1}}
+\newcommand{\biblatex}{\emph{biblatex}\xspace}
+\newcommand{\meta}[1]{\texttt{<#1>}}
+\pretocmd{\bibfield}{\sloppy}{}{}
+\pretocmd{\bibtype}{\sloppy}{}{}
+\newcommand{\namebibstyle}[1]{\texttt{#1}}
+% Meta-datas
+\titlepage{%
+ title={Book edited in other other type with biblatex},
+ subtitle={New data types},
+ email={maieul <at> maieul <dot> net},
+ author={Maïeul Rouquette},
+ revision={2.0.0},
+ date={06/04/2016},
+ url={https://github.com/maieul/biblatex-bookinarticle}}
+
+% biblatex
+\usepackage[tools={bookinother,morenames},bibstyle=verbose]{biblatex-multiple-dm}
+\usepackage[citestyle=verbose,bibstyle=multiple-dm]{biblatex}
+\addbibresource{example-bookinarticle.bib}
+\addbibresource{example-bookincollection.bib}
+\addbibresource{example-bookinincollection.bib}
+\addbibresource{example-bookininproceedings.bib}
+\addbibresource{example-bookinjournal.bib}
+\addbibresource{example-bookinproceedings.bib}
+\addbibresource{example-bookinthesis.bib}
+\begin{document}
+
+\printtitlepage
+\tableofcontents
+
+\section{Introduction}
+
+\subsection{Aim}
+The default \biblatex's styles provide an entry type called \bibtype{bookinbook}.
+However, it can happen, especially in classical philology, that a book is edited in other entry type.
+For example a book can be edited in article, in proceedings, in a thesis etc.
+This package provides new bibliographic entry types.
+
+\subsection{History}
+
+Originally, the package was called \pkg{biblatex-bookinarticle}, because it provided only a new \bibtype{bookinarticle} entry type.
+However, many new types were added.
+Changing the name was required, and when the loading's way has changed, a good occasion happened.
+\subsection{Credits}
+
+This package was created for Maïeul Rouquette's phd dissertation\footnote{\url{http://apocryphes.hypothese.org}.} in 2014. 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 GitHub issues page\footnote{\url{https://github.com/maieul/biblatex-bookinarticle/issues}.}.
+
+
+\section{What does the package provide?}
+
+The package provides:
+\begin{itemize}
+ \item New entry types.
+ \item Inheritance's mechanism for these entry types.
+ \item Integration of the entry types following the standard bibliography's styles of biblatex.
+ \item Integration of the new fields of the \pkg{biblatex-morenames} package.
+\end{itemize}
+
+
+\section{Loading package}
+As the package defines new fields, you must load it as a \verb+bibstyle+ option of \biblatex package.
+
+\begin{minted}{latex}
+ \usepackage[citestyle=yourcitationstyle,bibstyle=bookinother]{biblatex}
+\end{minted}
+
+Notes that the \bibstyle{bookinother} bibliography's style automatically loads \bibstyle{verbose} bibliography's style, which means it is compatible with all the \emph{verbose-xxx} and \bibstyle{authortitle-xxx} bibliography's styles of \biblatex, because all of them are identical to the \bibstyle{verbose} \textbf{bibliography style}.
+
+Hoewever, if you want to use an other bibliography's style, you can use the \pkg{biblatex-multiple-dm} package, but the uniformity can't be assured.
+
+In any case, you can choose your own \textbf{citation style}.
+
+\label{morenames}If you need to use this package with package which also requires loading \emph{via} the \verb+bibstyle+ option, as for example \pkg{biblatex-morenames}, just use the \pkg{biblatex-multiple-dm} package, in the following way:
+
+\begin{minted}{latex}
+ \usepackage[tools={bookinother,morenames},bibstyle=verbose]{biblatex-multiple-dm}
+ \usepackage[citestyle=verbose,bibstyle=multiple-dm]{biblatex}
+\end{minted}
+
+If you want to use this package with \bibstyle{alphabetic-xxx} or \bibstyle{numeric-xx} bibliography style, also use the \pkg{biblatex-multiple-dm} package, changing the \verb+bibstyle+ option.
+
+\begin{minted}{latex}
+ \usepackage[tools={bookinother},bibstyle=numeric]{biblatex-multiple-dm}
+ \usepackage[citestyle=numeric,bibstyle=multiple-dm]{biblatex}
+\end{minted}
+
+\section{The new entry types}
+
+\subsection{Using crossref mechanisme}
+
+
+The package provides new entry types in the form of \bibtype{bookin\meta{othertype}}.
+ The best way to manage these entry types is to use the crossref mechanism of biber.
+ So the \bibfield{crossref} field of a \bibtype{bookin\meta{othertype}} entry should refers to the main \bibtype{\meta{othertype}} entry.
+
+ The package also provides new \bibtype{in\meta{othertype}} entry types.
+ The only differences with the \bibtype{bookin\meta{othertype}} entry types is that the \bibfield{title} is, with standard styles, printed in roman font and wrapped in quotation marks.
+
+\subsection{Fields}
+
+In the following parts of this handbook, we will describe, for each entry type, the fields inheritance mechanism.
+
+Here is a list of fields which are NOT inherited :
+\begin{itemize}
+ \item \bibfield{author} means the author of the edited (ancient) book.
+ \item \bibfield{bookineditor} means the editor of the edited (ancient) book.
+ \item \bibfield{title} means the title of the edited (ancient) book.
+ \item \bibfield{subtitle} means the subtitle of the edited (ancient) book.
+
+\end{itemize}
+
+If you use the \bibfield{ineditor} field of the \pkg{biblatex-morenames} package, it will be inherited as \bibfield{bookeditor} field.
+
+Notes that the package take account of the \bibfield{maineditor} field of the \pkg{biblatex-morenames} package, if loaded.
+
+% Here, a loop on the entry type, to automatically generate the handbook
+
+\def\firstofthree#1#2#3{#1}
+\def\secondofthree#1#2#3{#2}
+\def\thirdofthree#1#2#3{#3}
+\renewcommand{\do}[1]{%
+ \edef\entrytype{\firstofthree#1}%
+ \edef\entrykey{\secondofthree#1}%
+ \edef\entrymore{\thirdofthree#1}%
+ \subsection{\bibtype{bookin\entrytype}}
+ \subsubsection{Meaning}
+ For book edited in a \bibtype{\entrytype} entry.
+ \subsubsection{.bib example}
+
+ \inputminted[breaklines]{latex}{example-bookin\entrytype.bib}
+
+ \subsubsection{Fields inheritance}
+ The graph~\ref{example-bookin\entrytype} shows the fields inheritance.
+ \begin{figure}
+ \centering
+ \includegraphics[height=0.9\textheight]{example-bookin\entrytype.pdf}
+ \label{example-bookin\entrytype}
+ \caption{Inheritance related to the \bibtype{bookin\entrytype} entry type}
+ \end{figure}
+ \subsubsection{Output example}
+ \begin{quotation}
+ \cite{\entrykey}
+ \end{quotation}
+ \entrymore
+}
+
+% For each entry of the csvlist:
+% 1) The main type
+% 2) The name of the entry for demonstration
+% 3) More texts to add…
+\docsvlist{%
+ {{article}{BHG226e}{}},%
+ {{collection}{Aristotle2016}{%
+ \unexpanded{\subsubsection{About \bibtype{bookinreference}}
+ The package also provides a \bibtype{bookinreference} entry type for book edited in a \bibtype{reference}.
+ This is a more specific variant of \bibtype{bookincollection}.
+ The standard styles will treat this entry type as an alias for \bibtype{bookincollection}.
+ }}},%
+ {{incollection}{AcTiteLatin}{%
+ \unexpanded{\subsubsection{About \bibtype{bookininreference}}
+ The package also provides a \bibtype{bookininreference} entry type for book edited in a \bibtype{inreference}.
+ This is a more specific variant of \bibtype{bookinincollection}.
+ The standard styles will treat this entry type as an alias for \bibtype{bookinincollection}.
+ }}},%
+ {{inproceedings}{Aristotle2012}{}},%
+ {{journal}{Alexander_Aphrodisias}{}},%
+ {{proceedings}{Aristotle2015}{}},%
+ {{thesis}{GuilielmusdeBoldensele}{%
+ \unexpanded{\subsubsection{About the type of thesis}
+ As for the standard \bibtype{thesis} entry type, a \bibtype{bookinthesis} can contain a \bibfield{type} field containing one the following key:
+ \begin{description}
+ \item[mathesis] For a master's thesis.
+ \item[phdthesis] For a phd's thesis.
+ \item[candthesis] For a candidate's thesis.
+ \end{description}
+ The value of this field is automatically inherited from the main entry.
+ The package also provides two entry types:
+ \begin{itemize}
+ \item \bibtype{bookinmathesis} for book edited in a \bibtype{mathesis};
+ \item \bibtype{bookinphdthesis} for book edited in a \bibtype{phdthesis}.
+ \end{itemize}
+ }}}%
+}
+\section{Customization}
+
+The ways new entry types are printed are derived from the \verb+standard.bbx+ bibliography's style. You can customize it by overriding bibliographic macros or bibliographic drivers. Look at the \verb+bookinother.bbx+file.
+
+\section{Change history}
+
+
+\begin{changelog}
+
+\begin{release}{2.0.0}{2016-04-06}
+\item Change name to \pkg{biblatex-bookinother}.
+\item Loading as a \biblatex bibliographic style and not more as a \LaTeX\ package.
+\item Add \bibtype{bookincollection}, \bibtype{bookininproceedings}, \bibtype{bookininreference}, \bibtype{bookinproceedings}, \bibtype{bookinreference} and related.
+\item Prevent inheritance of \bibfield{shorttitle}, \bibfield{sorttitle}, \bibfield{indextitle}, \bibfield{indexsorttitle} fields.
+\item Add field \bibfield{bookeditor} and \bibfield{bookineditor}.
+\item Compatibility with the \pkg{biblatex-morenames} package.
+\end{release}
+
+\begin{release}{1.3.1}{2016-02-24}
+\item Fix bug added in v.1.3.0 which made some fields disappeared, even in for standard types.
+\end{release}
+
+\begin{release}{1.3.0}{2016-02-11}
+\item Add \bibtype{bookinthesis} and \bibtype{inthesis} and related.
+\end{release}
+
+\begin{release}{1.2.0a}{2016-02-07}
+\item Fix handbook.
+\end{release}
+
+\begin{release}{1.2.0}{2016-02-05}
+\item Formate \bibfield{series}, \bibfield{volume} and \bibfield{number} fields of \bibtype{inarticle} and \bibtype{bookinarticle} entries as \bibfield{series}, \bibfield{volume} and \bibfield{number} fields of \bibtype{article} entries.
+\end{release}
+
+\begin{release}{1.1.2}{2015-02-05}
+\item Use the \bibfield{shortauthor} field to define the \bibfield{labelname} field (useful for some citation style, like authortitle).
+\end{release}
+
+\begin{release}{1.1.1}{2014-11-03}
+\item Delete a false and not need test in the driver.
+\item Compatibility with biblatex-dw family's styles.
+\end{release}
+\begin{release}{1.1.0}{2014-10-09}
+\item Add \bibtype{bookinincollection} and \bibtype{inincollection}.
+\end{release}
+
+\begin{release}{1.0.0}{2014-07-02}
+\item First public release.
+\end{release}
+\end{changelog}
+\end{document}