summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-04-10 21:55:58 +0000
committerKarl Berry <karl@freefriends.org>2017-04-10 21:55:58 +0000
commit3813f353852891036ded396c3d78a8803c0b9385 (patch)
treeaeb29d9ed3fd5456da0ba60d8a55d45ccca0a1a4 /Master/texmf-dist/doc/latex
parentc8cd8edf4451d006d810c0a699f9c6f746d06b66 (diff)
biblatex-shortfields (10apr17)
git-svn-id: svn://tug.org/texlive/trunk@43738 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex')
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/README7
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields-example.pdfbin0 -> 27690 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields-example.tex18
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.bib111
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.pdfbin0 -> 51606 bytes
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.tex111
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/latexmkrc2
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/makefile5
-rw-r--r--Master/texmf-dist/doc/latex/biblatex-shortfields/makefile17
9 files changed, 271 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/README b/Master/texmf-dist/doc/latex/biblatex-shortfields/README
new file mode 100644
index 00000000000..65ac0a7efc2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/README
@@ -0,0 +1,7 @@
+biblatex-shortfields
+==================
+
+Use short version of fields (series, journal) when defined.
+
+Print a list of the short versions of the fields, mixing multiple fields type.
+For example, a liste mixing short version of series field and short version of journal field.
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields-example.pdf b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields-example.pdf
new file mode 100644
index 00000000000..63bafa98623
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields-example.tex b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields-example.tex
new file mode 100644
index 00000000000..bf1b65bb99f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields-example.tex
@@ -0,0 +1,18 @@
+\documentclass{article}
+\usepackage{libertineotf}
+\usepackage{polyglossia}
+\usepackage{csquotes}
+\setmainlanguage{french}
+
+\usepackage[citestyle=verbose,bibstyle=claves]{biblatex}
+\AddBiblatexClavis{BHG}
+\AddBiblatexClavis{CPG}
+\usepackage{biblatex-shortfields}
+\addbibresource{biblatex-shortfields.bib}
+\begin{document}
+\nocite{*}
+\printbibshortfields
+\printbibliography
+
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.bib b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.bib
new file mode 100644
index 00000000000..800fe3c1a59
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.bib
@@ -0,0 +1,111 @@
+@article{Delehaye1907,
+ Author = {Hippolyte Delehaye},
+ Date = {1907},
+ Journaltitle = {Analecta Bollandiana},
+ Number = {26},
+ Shorttitle = {AB},
+ Pages = {161-301},
+ Title = {Saints de Chypre}
+}
+
+@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}}
+@set{BHG,
+ entryset={BHG_3,BHG_auctarium,BHG_novum_auctarium}
+}
+@mvbook{CPG,
+ Address = {Turnhout},
+ Author = {Maurice Geerard},
+ Date = {1974/2003},
+ Publisher = {Brepols},
+ Series = {Corpus Christianorum Series Graeca},
+ Shortseries = {CCSG},
+ Title = {Clavis Patrum Graecorum},
+ Volumes = {5}}
+@book{BHG410,
+ Author = {{Alexandre de Chypre}},
+ Bhg = {410},
+ Cpg = {7398},
+ Number = {87.3},
+ Pages = {4015-4076},
+ Pagination = {column},
+ Series = {Patrologia Graeca},
+ Shortseries = {PG},
+ Title = {De venerandae ac vivificae crucis inventione}}
+@book{CCSG16,
+ Editor = {Edmond Voordeckers and Franz Tinnefeld},
+ Number = {16},
+ Series = {Corpus Christianorum Series Graeca},
+ Shortseries = {CCSG},
+ Title = {Iohannis Cantacuzeni Refutationes duae Prochori Cydonii et Disputatio cum Paulo patriarcha latino epistulis septem tradita}
+}
+@mvbook{Malamut1988,
+ Address = {Paris},
+ Author = {Élisabeth Malamut},
+ Date = {1988},
+ Number = {8},
+ Publisher = {Publications de la Sorbonne},
+ Series = {Byzantina Sorbonensia},
+ Subtitle = {\textsc{viii}-\textsc{xii}\textsuperscript{e} siècles},
+ Title = {Les îles de l'Empire byzantin},
+ Volumes = {2}
+}
+@book{CCSA4,
+ Editor = {Louis Leloir},
+ Number = {4},
+ Series = {Corpus Christianorum Series Apocryphorum},
+ Shortseries = {CCSA},
+ Subtitle = {Traduction de l'édition arménienne de Venise},
+ Title = {Écrits apocryphes sur les apôtres},
+ Volume = {2}}
+@book{CCSG26,
+ Editor = {Van Deun, Peter and Jacques Noret},
+ Number = {26},
+ Series = {Corpus Christianorum Series Graeca},
+ Shortseries = {CCSG},
+ Title = {Hagiographica Cypria}}
+@article{VanDeun1990,
+ Author = {Van Deun, Peter},
+ Date = {1990},
+ Journaltitle = {Analecta Bollandiana},
+ Number = {108},
+ Pages = {323-335},
+ Shortjournal = {AB},
+ Subtitle = {Édition et traduction},
+ Title = {Un mémoire anonyme sur saint Barnabé (BHG 226e)}}
+@article{James1905,
+ Author = {Montague Rhodes James},
+ Date = {1905},
+ Journaltitle = {The Journal of Theological Studies},
+ Number = {24},
+ Pages = {549-556},
+ Shortjournal = {JThS},
+ Title = {The Acts of Titus and the Acts of Paul},
+ Volume = {6}
+}
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.pdf b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.pdf
new file mode 100644
index 00000000000..7b3e74a5375
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.tex b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.tex
new file mode 100644
index 00000000000..e28866fef36
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/biblatex-shortfields.tex
@@ -0,0 +1,111 @@
+\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{csquotes}
+
+\setminted{breaklines}
+\hypersetup{citecolor=black}
+% Usefull commands
+\newcommand{\biblatex}{biblatex\xspace}
+\pretocmd{\bibfield}{\sloppy}{}{}
+\pretocmd{\bibtype}{\sloppy}{}{}
+\newcommand{\namebibstyle}[1]{\texttt{#1}}
+% Meta-datas
+\titlepage{%
+ title={Biblatex-shortfields},
+ subtitle={Using short version of fields},
+ email={maieul <at> maieul <dot> net},
+ author={Maïeul Rouquette},
+ revision={1.0.0},
+ date={2017/04/09},
+ url={https://git.framasoft.org/maieul/biblatex-shortfields}}
+
+% biblatex
+
+
+\begin{document}
+
+\printtitlepage
+\tableofcontents
+
+
+\section{Aim of the package}
+
+The \biblatex\ package provide \bibfield{shortseries} and \bibfield{shortjournal} field, but default styles didn't use them.
+
+It also provides a mechanism to print the equivalence between short forms of fields and long fields (\cs{printbiblist}), but this mechanism does not allow to mix between different type of short fields, for example, between short forms of journal title and short forms of series title.\footnote{Cf.~\url{https://github.com/plk/biblatex/issues/317}.}
+
+This package provides solution to these two problems:
+\begin{itemize}
+ \item If a \bibfield{shortjournal} field is defined, it prints it instead of the \cs{journal} field.
+ \item If a \bibfield{shortseries} field is defined, it prints it instead of the \cs{series} field.
+ \item It provides a \cs{printbibshortfields} command to print a list of the sort forms of the fields.
+ \item This list also includes the \emph{claves} defined with the \emph{biblatex-claves} package \textbf{v.~1.2 or later}.
+\end{itemize}
+
+\section{Use}
+
+You must load the package after the \biblatex\ package.
+\begin{minted}{latex}
+\usepackage[…]{biblatex}
+\usepackage{biblatex-shortfields}
+\end{minted}
+
+You just need to put \cs{printbibshortfields} when you need to print the shortlist. The command take an optional argument, which could contain options in the optional argument of \cs{printbibliography}, except \opt{check} and \cs{env} options.
+
+For example, to change the title of this list, use:
+
+\begin{minted}{latex}
+\printbibshortfields[title=List of shorthands]
+\end{minted}
+
+The equivalence between short and long form of field are determined by the entries.
+For example, if you want to tell that \enquote{Corpus Christianorum Series Apocryphorum} is abbreviated \enquote{CCSA}, your entries in this series must contains the following fields:
+\begin{minted}{latex}
+@entrytype{key,
+ Fields …,
+ Series = {Corpus Christianorum Series Apocryphorum},
+ Shortseries = {CCSA}
+}
+\end{minted}
+
+The only exception is for \emph{claves}, which abbreviations are determined by the mechanism used in the \emph{biblatex-claves} package.
+
+
+See the \href{./example-biblatex-shortfields.tex}{example file}.
+
+\section{Customization}
+
+You can change the width devoted to the abbreviations by redefining the \cs{shortfieldswidth} length, using \cs{setlength}. Default value is 4~em.
+
+For more customization, contact us. If your need is generic, we will add it in the package.
+
+\section{Credits}
+
+
+
+This package was created for Maïeul Rouquette's for Hélène Wiener's needs.\footnote{\url{http://geekographie.maieul.net/144\#forum1736}.} The original idea of the code is explained in Maïeul Rouquette's website.\footnote{\url{http://geekographie.maieul.net/99}.}
+
+
+All issues can be submitted, in French or English, in the Framasoft's issues page\footnote{\url{https://git.framasoft.org/maieul/biblatex-shortfields/issues}.}.
+
+
+\section{Change history}
+
+
+\begin{changelog}
+
+\begin{release}{1.0.0}{2017-04-02}
+ \item First public release.
+\end{release}
+
+\end{changelog}
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/latexmkrc b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/latexmkrc
new file mode 100644
index 00000000000..d6cfc714fa5
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/latexmkrc
@@ -0,0 +1,2 @@
+$pdflatex = "xelatex --shell-escape %S";
+$pdf_mode = "1";
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/makefile b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/makefile
new file mode 100644
index 00000000000..831057ac163
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/documentation/makefile
@@ -0,0 +1,5 @@
+all: *tex *bib
+ latexmk biblatex-shortfields.tex
+ latexmk biblatex-shortfields-example.tex
+
+
diff --git a/Master/texmf-dist/doc/latex/biblatex-shortfields/makefile b/Master/texmf-dist/doc/latex/biblatex-shortfields/makefile
new file mode 100644
index 00000000000..465cdd1a994
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/biblatex-shortfields/makefile
@@ -0,0 +1,17 @@
+dist: all
+ rm -rf biblatex-shortfields
+ mkdir biblatex-shortfields
+ ln README.md biblatex-shortfields/README
+ ln makefile *sty biblatex-shortfields
+ mkdir biblatex-shortfields/documentation
+ ln documentation/*tex documentation/*bib documentation/*pdf documentation/latexmkrc documentation/makefile biblatex-shortfields/documentation
+ $(RM) ../biblatex-shortfields.zip
+ zip -r ../biblatex-shortfields.zip biblatex-shortfields
+
+
+clean:
+ $(MAKE) -C documentation clean
+ @$(RM) *.pdf *.toc *.aux *.out *.fdb_latexmk *.log *.bbl *.bcf *.blg *run.xml *.synctex.gz*
+
+all: documentation/biblatex-shortfields-example.tex documentation/biblatex-shortfields.tex documentation/biblatex-shortfields.bib documentation/latexmkrc
+ $(MAKE) -C documentation all