biblatex-claves (11sep16)

git-svn-id: svn://tug.org/texlive/trunk@42066 c570f23f-e606-0410-a88d-b1316a301751

8 files changed, 257 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/biblatex-claves/README b/Master/texmf-dist/doc/latex/biblatex-claves/README
new file mode 100644
index 00000000000..08f79fea743
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-claves/README
@@ -0,0 +1,4 @@
+biblatex-claves
+==================
+
+Manage claves with biblatex (like Bibliotheca Hagiographica Graeca, Clavis Patrum Latinorum)
diff --git a/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves-ref.bib b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves-ref.bib
new file mode 100644
index 00000000000..533e0ab9876
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves-ref.bib
@@ -0,0 +1,33 @@
+@book{CANT,
+	Address = {Turnhout},
+	Author = {Maurice Geerard},
+	Date = {1992},
+	Publisher = {Brepols},
+	Series = {Corpus Christianorum},
+	Title = {Clavis Apocryphorum Novi Testamenti}}
+@mvbook{BHG_3,
+	Address = {Bruxelles},
+	Author = {François Halkin},
+	Date = {1957},
+	Edition = {3},
+	Number = {81},
+	Publisher = {{Société des Bollandistes}},
+	Series = {Subsidia Hagiographica},
+	Title = {Bibliotheca hagiographica graeca},
+	Volumes = {3}}
+@book{BHG_auctarium,
+	Address = {Bruxelles},
+	Author = {François Halkin},
+	Date = {1969},
+	Number = {47},
+	Publisher = {{Société des Bollandistes}},
+	Series = {Subsidia Hagiographica},
+	Title = {Auctarium bibliothecae hagiographicae graecae}}
+@book{BHG_novum_auctarium,
+	Address = {Bruxelles},
+	Author = {François Halkin},
+	Date = {1984},
+	Number = {65},
+	Publisher = {{Société des Bollandistes}},
+	Series = {Subsidia Hagiographica},
+	Title = {Novum auctarium bibliothecae hagiographicae graecae}}
diff --git a/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.bib b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.bib
new file mode 100644
index 00000000000..4cee43a9bed
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.bib
@@ -0,0 +1,16 @@
+@bookinbook{BHG225,
+	Bhg = {225},
+	Cant = {285},
+	Crossref = {AAA2.2},
+	Editor = {Maximilien Bonnet},
+	Pages = {292-302},
+	Title = {Acta Barnabae}
+}
+@book{AAA2.2,
+	Address = {Darmstadt},
+	Date = {1903},
+	Editor = {Maximilien Bonnet},
+	Location = {Leipzig},
+	Publisher = {Hermann Mendelssohn},
+	Title = {Acta Apostolorum Apocrypha},
+	Volume = {2.2}}
diff --git a/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.pdf b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.pdf
new file mode 100644
index 00000000000..84a4ff48ef0
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.pdf
diff --git a/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.tex b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.tex
new file mode 100644
index 00000000000..e886c27f6a8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/biblatex-claves.tex
@@ -0,0 +1,184 @@
+\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}
+\hypersetup{citecolor=black}
+% Usefull commands
+\newcommand{\biblatex}{\emph{biblatex}\xspace}
+\newcommand{\claves}{\emph{claves}\xspace}
+\newcommand{\clavis}{\emph{clavis}\xspace}
+\pretocmd{\bibfield}{\sloppy}{}{}
+\pretocmd{\bibtype}{\sloppy}{}{}
+\newcommand{\namebibstyle}[1]{\texttt{#1}}
+% Meta-datas
+\titlepage{%
+  title={Manage \claves with \biblatex},
+  subtitle={New fields},
+  email={maieul <at> maieul <dot> net},
+  author={Maïeul Rouquette},
+  revision={1.0.0},
+  date={2016/09/11},
+  url={https://git.framasoft.org/maieul/biblatex-claves}}
+
+\usepackage[citestyle=verbose,bibstyle=claves]{biblatex}
+\bibliography{biblatex-claves.bib}
+\bibliography{biblatex-claves-ref.bib}
+\AddBiblatexClavis{BHG}
+\AddBiblatexClavis{CANT}
+\begin{document}
+
+\printtitlepage
+\tableofcontents
+
+
+\section{Aim of the package}
+
+When studying antic and medieval literature, we may find many different texts published with the same title, or, in contrary, the same text published with different titles.
+To avoid confusion, scholars have published \claves, which are books listing ancient texts, identifying them by an identifier --- a number or a string of text.
+For example, for early Christianity, we have the \citetitle{BHG_3},\footcites{BHG_3}{BHG_auctarium}{BHG_novum_auctarium}, the \citetitle{CANT},\footcite{CANT} and other \claves.
+ 
+It could be useful to print the identifier of a texts in one specific \clavis, or in many \claves.
+
+This package allows us to create new field for different \claves, and to present all these fields in a consistent way.
+ 
+Considering this example:
+\inputminted{tex}{biblatex-claves.bib}
+
+It will be typeset as:
+\begin{quotation}
+\cite{BHG225}
+\end{quotation}
+
+Here, we can see the \enquote{BHG} and \enquote{CANT} identifiers.
+ 
+\section{Use}
+
+\subsection{Requirement}
+
+The package requires \biblatex~3.5 or later.
+
+\subsection{Loading the package}
+
+As the package defines new fields, it must be loaded as a bibliography style:
+\begin{minted}{latex}
+\usepackage[bibstyle=claves,citestyle=<your-citestyle>]{biblatex}
+\end{minted}
+The \emph{verbose} bibliography style is automatically loaded.
+
+If you must load an other bibliography style, or if you need to load package which requires to be loaded as bibliography style, like \emph{biblatex-bookinother}, you must use the \emph{biblatex-multiple-dm} package.
+ For example:
+\begin{minted}{latex}
+\usepackage[tools={claves,bookinther},bibstyle=verbose]{biblatex-multiple-dm}
+\usepackage[bibstyle=multiple-dm,citestyle=<your-citestyle>]{biblatex}
+\end{minted}
+
+Read the \emph{biblatex-multiple-dm} handbook for more details.
+
+\subsection{Defining the \claves}
+
+You must define which \claves\  you want to use, using \cs{AddBiblatexClavis} \textbf{in your preamble}. 
+This command takes on argument, which is the abbreviated form of the concerned \clavis.
+ For example, in this handbook, the preamble contains:
+\begin{minted}{latex}
+\AddBiblatexClavis{BHG}
+\AddBiblatexClavis{CANT}
+\end{minted}
+Note the following points:
+\begin{itemize}
+  \item The order of \cs{AddBiblatexClavis} determines in which order will be typeset the \claves\ in bibliographic entries.
+ \item The case of the argument will be used for typesetting the \claves in bibliographic entries.
+\end{itemize}
+ 
+After that, you just have to add the fields in the concerned entry of the \verb+.bib+ file.
+Notes that if you don't call the concerned \cs{AddBiblatexClavis}, the \clavis\  won't be typeset.
+ That allows you to decide, in the last time of your work, which \claves you will use.
+
+ \subsection{Customizing style}
+You can  redefine:
+\begin{itemize}
+  \item The \cs{multiclavesseparator} macro, which defines which character will be typeset between the different \claves\ identifiers. By default, a semicolon.
+  \item The \cs{clavisseparator} macro, which defines which character will be typeset between the \clavis abbreviated form and the \clavis identifier. By default, just a space.
+  \item The \verb+claves+ fieldformat, which define the way all the \claves and identifier will be typeset.
+ By default, between parenthesis.
+\end{itemize}
+Note that you must use the \biblatex\ punctuation macro.
+Here, the default definition:
+\begin{minted}{latex}
+\newcommand{\multiclavesseparator}{\addsemicolon\ifpunct{\addspace}{}}
+\newcommand{\clavisseparator}{\addspace}
+\DeclareFieldFormat{claves}{\mkbibparens{#1}}
+\end{minted}
+\subsection{Printing the list of \claves}
+
+You could want to print the list of the \claves used, with the bibliographic reference.
+ To do, you must define some entries in your \verb+.bib+ file corresponding to the \claves:
+\inputminted{tex}{biblatex-claves-ref.bib}
+
+As you can see, the \citetitle{BHG_3} claves is in reality composed by one book in three volumes and two supplements (\enquote{auctarium}).
+ We could define a \bibtype{set} entry directly in the \verb+.bib+ file.
+ However, it could happen that you need to cite each entry individually, and a global \bibtype{set} entry does not allow it.\footnote{Cf. \url{https://github. com/plk/biblatex/issues/470}.}
+
+ That's why the best way is to define locally entry set in a \verb+refsection+ environment.\footnote{Read the \biblatex\ handbook about this environment, which allow you to have a local bibliography.} Consequently, we provide a \cs{citeallclaves} macro, which automatically add a \cs{nocite} for all the \claves\ defined by the \cs{AddBiblatexClavis} macros in your preamble.
+
+ We also provide a \verb+claves+ sorting scheme, and a \verb+claves+ bibliographic environment. So to print the concerning \claves, while defining local \bibtype{set} entry, you must do something like this:
+\begin{minted}{latex}
+\begin{refsection}
+  \begin{refcontext}[sorting=claves]
+    \setlength{\shorthandwidth}{3em}
+    \defbibentryset{BHG}{BHG_3,BHG_auctarium,BHG_novum_auctarium}
+    \citeallclaves% Be careful on the order
+    \printbibliography[env=claves,title=List of \emph{claves}]
+  \end{refcontext}
+\end{refsection}
+\end{minted}
+
+That produces the following output:
+\begin{quotation}
+\begin{refsection}
+  \begin{refcontext}[sorting=claves]
+    \setlength{\shorthandwidth}{3em}
+    \defbibentryset{BHG}{BHG_3,BHG_auctarium,BHG_novum_auctarium}
+    \citeallclaves
+    \printbibliography[env=claves,title=List of \emph{claves}]
+  \end{refcontext}
+\end{refsection}
+\end{quotation}
+
+Note the following points:
+\begin{itemize}
+  \item The bibliographic keys are used as label. Consequently, be careful with case, as \emph{biber} is sensitive to it.
+  \item Many time, \claves have a shorter former too long for the default label size defined by \biblatex.
+    That why, in our example, we have redefined the \cs{shorthandwidth} length.
+  \item Contrary to the default style, all the entry of a \bibtype{set} are in there own paragraph, and we use dashes when citing many times the same author. If you want to define your own bibliographic environment devoted to the \claves, you can use the following lines insides:
+    \begin{minted}{latex}
+\renewcommand{\entrysetpunct}{\endgraf}
+\clavesadddashinset
+    \end{minted}
+\end{itemize}
+\section{Credits}
+
+This package was created for Maïeul Rouquette's phd dissertation\footnote{\url{http://apocryphes.hypothese.org}.} in 2016. 
+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-claves/issues}.}
+
+
+\section{Change history}
+
+\begin{changelog}
+
+\begin{release}{1.0.0}{2016-09-1}
+\item First public release.
+\end{release}
+
+\end{changelog}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/biblatex-claves/documentation/latexmkrc b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/latexmkrc
new file mode 100644
index 00000000000..d6cfc714fa5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/latexmkrc
@@ -0,0 +1,2 @@
+$pdflatex = "xelatex --shell-escape %S";
+$pdf_mode = "1";
diff --git a/Master/texmf-dist/doc/latex/biblatex-claves/documentation/makefile b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/makefile
new file mode 100644
index 00000000000..7846df29ac7
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-claves/documentation/makefile
@@ -0,0 +1,2 @@
+all:
+	latexmk *tex
diff --git a/Master/texmf-dist/doc/latex/biblatex-claves/makefile b/Master/texmf-dist/doc/latex/biblatex-claves/makefile
new file mode 100644
index 00000000000..090d25ae3c8
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-claves/makefile
@@ -0,0 +1,16 @@
+dist: all
+	rm -rf biblatex-claves
+	mkdir biblatex-claves
+	ln README *bbx *dbx *makefile biblatex-claves
+	mkdir biblatex-claves/documentation
+	ln documentation/*tex documentation/*bib documentation/*pdf documentation/makefile documentation/latexmkrc biblatex-claves/documentation
+	$(RM) ../biblatex-claves.zip
+	zip -r ../biblatex-claves.zip biblatex-claves
+
+
+clean:
+	$(MAKE) -C documentation clean
+	@$(RM) *.pdf *.toc *.aux *.out *.fdb_latexmk *.log *.bbl *.bcf *.blg *run.xml *.synctex.gz*
+
+all: documentation/biblatex-claves.tex
+	$(MAKE) -C documentation all