1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
|
\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.1},
date={2017/11/19},
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.1}{2017-11-19}
\item Compatibility with \biblatex~3.8.
\end{release}
\begin{release}{1.0.0}{2017-04-02}
\item First public release.
\end{release}
\end{changelog}
\end{document}
|