path: root/info/biblatex-cheatsheet/biblatex-cheatsheet.tex

% !TEX TS-program = pdflatex
% !TEX encoding = UTF-8 Unicode
% arara: pdflatex: { synctex: true }
%% biblatex-cheatsheet.tex
%% Copyright 2017 Clea F. Rees
%
% This work may be distributed and/or modified under the
% conditions of the LaTeX Project Public License, either version 1.3
% of this license or (at your option) any later version.
% The latest version of this license is in
%   http://www.latex-project.org/lppl.txt
% and version 1.3 or later is part of all distributions of LaTeX
% version 2005/12/01 or later.
%
% This work has the LPPL maintenance status `maintained'.
%
% The Current Maintainer of this work is Clea F. Rees.
%
% This work consists of the file biblatex-cheatsheet.tex.
%%
\pdfminorversion=7
\documentclass[a4paper,welsh,british,landscape]{article}
\usepackage{svn-multi}
\svnid{$Id: biblatex-cheatsheet.tex 6644 2017-06-24 01:14:08Z cfrees $}
\svnRegisterAuthor{cfrees}{Clea F. Rees}
\usepackage{babel}
\usepackage[utf8]{inputenc}
\usepackage[tt=lining]{cfr-lm}
\newlength\normalparindent
\setlength\normalparindent{\parindent}
\usepackage{enumitem,geometry,url,texnames,multicol,parskip,titling,,xcolor,array,ragged2e,tabularx,verbatim}
\usepackage[flushleft]{threeparttablex}
\usepackage{csquotes}
\usepackage{microtype}
\geometry{hmargin=10mm,vmargin=10mm}
\setlength{\columnseprule}{0pt}
\setlength\parskip{.75ex plus .5ex minus .25ex}
\definecolor{blueberry}{rgb}{0.000,0.000,1.000}
\usepackage{tikz}
\usetikzlibrary{tikzmark,decorations.pathreplacing}
\hyphenation{bib-la-tex}
\usepackage[%
  pdftex,
  colorlinks=true,
  extension=pdf,
  pdfpagelabels=true,
  bookmarks=true,
  bookmarksopen=false,
  bookmarksnumbered=true,
  pdfusetitle=true,
  pdfcreator={TeX},
  pdfproducer={pdfeTeX},
  urlcolor={blueberry}]{hyperref}
\usepackage{hypdestopt}


\newcommand*{\cls}[1]{\textsf{#1}}
\newcommand*{\pkg}[1]{\textsf{#1}}
\newcommand*{\cs}[1]{\texttt{\textbackslash#1}}
\newcommand*{\env}[1]{\texttt{#1}}
\newcommand*{\marg}[1]{\texttt{\{#1\}}}
\newcommand*{\oarg}[1]{\texttt{[#1]}}
\newcommand*{\parg}[1]{\texttt{(#1)}}
\newcommand*{\meta}[1]{\ensuremath{\langle}{\normalfont\emph{#1}}\ensuremath{\rangle}}
\newcommand*{\filename}[1]{\texttt{#1}}
\newcommand*{\narg}[1][1]{\texttt{\##1}}
\newcommand*\entry[1]{\texttt{@#1}}
\newcommand*\bkey[1]{\texttt{#1}}
\let\bkeyfamily\ttfamily

\renewcommand*{\url}[1]{\href{http://#1}{\texttt{#1}}}
\newcommand*{\email}[1]{\href{mailto:#1}{\texttt{#1}}}

\setcounter{secnumdepth}{0}
\makeatletter
\setlength\droptitle{-45\p@}
\pretitle{\begingroup\centering\Large\bfseries}
\posttitle{\par\endgroup}
\predate{\relax}
\postdate{\relax}
\preauthor{\@gobble}
\postauthor{}

\def\section{\@startsection{section}{1}%
  \z@{1.5\baselineskip\@plus\fill\pagebreak[3]}{\baselineskip \nopagebreak}%
  {\normalfont\large\bfseries}}%
\def\subsection{\@startsection{subsection}{2}%
  \z@{1\baselineskip\@plus\fill\pagebreak[3]}{\baselineskip \nopagebreak}%
  {\normalfont\bfseries}}

\newcommand\mverbatim@font{% modified from verbatim.sty
  \normalfont\tmstyle\hyphenchar\font\m@ne\@noligs}

\newenvironment{mverbatim}% modified from verbatim manual, t. 2
{\verbatim\mverbatim@font}%
{\endverbatim}

\makeatother

\newcolumntype{e}[2]{@{\hskip .25em#1=\hskip .25em}>{#2}l}
\newcolumntype{T}{e{\ttfamily}{\ttfamily}}
\newcolumntype{M}{e{\ttfamily}{}}
\newcolumntype{h}{@{}>{\itshape}l@{}}

\tikzset{
  marginal/.style={midway, rotate=90, inner ysep=5pt, font=\scshape\scriptsize, align=center},
  left marginal/.style={left, anchor=south, marginal},
  right marginal/.style={right, anchor=north, marginal},
}
\newcommand*\cysylltiad[3][]{%
  \draw [decoration={brace}, decorate] ([xshift=-.25em, yshift=-.1\baselineskip]#2) -- ([xshift=-.25em, yshift=.6\baselineskip]#3) node [left marginal] {#1}}

\title{Biblatex Cheat Sheet}
\author{Clea F. Rees}
\date{}
\pagestyle{empty}

\begin{document}
\pdfinfo{%
  /Author	(Clea F. Rees)
  /Title	(Biblatex Cheat Sheet)
  /Subject	(LaTeX)
  /Keywords	(Biblatex, Biber)}%
\footnotesize
\begin{multicols}{3}%
\maketitle\thispagestyle{empty}
For further details, explanations, hints, caveats, examples and alternatives to the \bkey{backend} Biber, see \href{http://mirrors.ctan.org/macros/latex/contrib/biblatex/doc/biblatex.pdf}{the Biblatex manual}.
For a list of \emph{contributed} styles and extensions, see \url{ctan.org/topic/biblatex}.

\section{Basic Setup}\label{sec:basic}
Compilation sequence: \verb|pdflatex| $\rightarrow$ \verb|biber| $\rightarrow$ \verb|pdflatex| ($\times 2$).
\tikzmark{doc0}

\hskip.75\normalparindent\tikzmark{doc1}\hskip.25\normalparindent%
\begin{minipage}[b]{.75\linewidth}%
\begin{verbatim}
\documentclass[<language option>]{<class>}
...
\usepackage[utf8]{inputenc}
\usepackage{babel,csquotes,xpatch}% recommended
\usepackage[backend=biber,<options>]{biblatex}
\addbibresource[<options>]{<first resource>}
\addbibresource[<options>]{<second resource>}
...
\begin{document}
  ...
  \printbibliography[<options>]
  ...
  \printbibliography[<options>]
  ...
\end{document}
\end{verbatim}
\end{minipage}\hfill\mbox{}
\begin{tikzpicture}[remember picture, overlay]
  \draw ({pic cs:doc1} |- {pic cs:doc0}) +(0,-\parskip) -- ({pic cs:doc1});
\end{tikzpicture}

\section{Common Package Options}\label{sec:options}

\begin{tabular}{@{}>{\bkeyfamily}lMl@{}}
  \tikzmark{s1opt}style	&	\meta{style} & style of bibliography and citations\\
  bibstyle	&	\meta{style} & bibliography style\\
  \tikzmark{s2opt}citestyle	&	\meta{style} & citation style\\
  \tikzmark{r1opt}refsection	&	\meta{division} & new \texttt{refsection} at document \texttt{division}\\
  \tikzmark{r2opt}refsegment	&	\meta{division} & new \texttt{refsegment} at document \texttt{division}\\
  \tikzmark{c1opt}autocite	&	\meta{style} & behaviour of \cs{autocite} etc.\\
  sortcites	&	\meta{boolean}	&	whether to sort multiple citations\\
  maxnames	&	\meta{integer}	&	truncate longer name lists\\
  \tikzmark{c2opt}minnames	&	\meta{integer}	&	no.\ of names in truncated name lists\\
  \tikzmark{b1opt}backref	&	\meta{boolean}	&	whether to print ‘back references’\\
  mincrossrefs	&	\meta{integer}	&	minimum number of cross references\\
  \tikzmark{b2opt}sorting	&	\meta{sort order}	&	bibliography sort order\\
  indexing	&	\meta{boolean}	&	whether to enable indexing support\\
\end{tabular}
\begin{tikzpicture}[overlay, remember picture]
  \foreach \i in {b,c,r,s}
  \cysylltiad{{pic cs:\i2opt}}{{pic cs:\i1opt}};
\end{tikzpicture}

\section{Sources of Bibliographical Data}\label{sec:sources}

\begin{tabular}{@{}ll@{}}
	\cs{addbibresource}\oarg{\meta{options}}\marg{\meta{resource}}	&	add to default resource list\\
	\cs{addglobalbib}\oarg{\meta{options}}\marg{\meta{resource}}	&	add to global resource list\\
\end{tabular}

\begin{tabular}{>{\bkeyfamily}lTll@{}}
  \multicolumn{4}{h}{Options:}\\[.5ex]
  location	&	local & local file & (default)\\
			&	remote	& HTTP/FTP	\\
  datatype	&	bibtex & \BibTeX{}  & (default)\\
			&	ris & RIS \\
			&	zoterordfxml & Zotero RDF/XML \\
			&	endnotexml & EndNote XML \\
\end{tabular}

\begin{tabular}{ll@{}}
  \multicolumn{2}{h}{\meta{resource} must be one of:}\\[.5ex]
  \filename{\meta{filename}.bib}	&	local database\\
  \texttt{http://.../}\meta{filename}\texttt{.bib}	&	remote\\
  \texttt{ftp://.../}\meta{filename}\texttt{.bib}	&	remote\\
\end{tabular}

\cs{bibliography}\marg{\meta{filename},\meta{filename},...} adds 1+ local \BibTeX{} files.

\section{Citations}\label{sec:cite}

\begin{threeparttable}
  \begin{tabular}{@{}*{3}{l}@{}}
	\multicolumn{3}{h}{Standard commands:}\\[.5ex]
	\tikzmark{sc1}\tnote{c,m}	&	\cs{cite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	bare\\
	\tnote{c,m}	&	\cs{parencite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	parenthetical\\
	\tnote{m}	&	\cs{footcite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	footnote (\cs{footnote})\\
	\tikzmark{sc2}\tnote{m}	&	\cs{footcitetext}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	& footnote (\cs{footnotetext})\\[.5ex]
	\multicolumn{3}{h}{Common commands:}\\[.5ex]
	\tikzmark{cc1}\tnote{c,m}	&	\cs{textcite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	textual\\
	\tnote{c,m}	&	\cs{smartcite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	context-dependent\\
	\tnote{a}	&	\cs{cite*}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	year/title only\\
	\tnote{a}	&	\cs{parencite*}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	year/title only\\
	\tikzmark{cc2}\tnote{m,n}	&	\cs{supercite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	superscript\\[.5ex]
	\multicolumn{3}{h}{Style-independent commands:}\\[.5ex]
	\tikzmark{sic1}\tnote{c,m}	&	\cs{autocite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	style-dependent\\
	\tikzmark{sic2}\tnote{c,m}	&	\cs{autocite*}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	style-dependent\\[.5ex]
	\multicolumn{3}{h}{Text commands:}\\[.5ex]
	\tikzmark{tc1}\tnote{c}	&	\cs{citeauthor}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	author list\\
	\tnote{c}	&	\cs{citeauthor*}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	& compressed author list\\
	&	\cs{citetitle}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	(short) title\\
	&	\cs{citetitle*}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	(full) title\\
	\tnote{s}&	\cs{citeyear}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	year\\
	\tnote{s}&	\cs{citedate}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	date\\
	\tikzmark{tc2}&	\cs{citeurl}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	URL\\[.5ex]
	\multicolumn{3}{h}{Multi-volume commands:}\\[.5ex]
	\tikzmark{mv1}\tnote{c,m}&	\cs{volcite}\oarg{\meta{pre}}\marg{\meta{vol}}\oarg{\meta{page}}\marg{\meta{key}}	& cite by volume + page\\
	\tnote{c,m}&	\cs{pvolcite}\oarg{\meta{pre}}\marg{\meta{vol}}\oarg{\meta{page}}\marg{\meta{key}}	& parenthetical\\
	\tnote{c,m}&	\cs{fvolcite}\oarg{\meta{pre}}\marg{\meta{vol}}\oarg{\meta{page}}\marg{\meta{key}}	& footnote (\cs{footnote})\\
	&	\cs{ftvolcite}\oarg{\meta{pre}}\marg{\meta{vol}}\oarg{\meta{page}}\marg{\meta{key}}	& footnote (\cs{footnotetext})\\
	\tnote{c,m}&	\cs{svolcite}\oarg{\meta{pre}}\marg{\meta{vol}}\oarg{\meta{page}}\marg{\meta{key}}	& context-dependent\\
	\tnote{c,m}&	\cs{tvolcite}\oarg{\meta{pre}}\marg{\meta{vol}}\oarg{\meta{page}}\marg{\meta{key}}	& textual\\
	\tikzmark{mv2}\tnote{c,m}&	\cs{avolcite}\oarg{\meta{pre}}\marg{\meta{vol}}\oarg{\meta{page}}\marg{\meta{key}}	&  style-dependent\\[.5ex]
	\multicolumn{3}{h}{Standalone citation commands:}\\[.5ex]
	\tikzmark{spc1}&	\cs{fullcite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	full reference\\
	\tikzmark{spc2}&	\cs{footfullcite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	full reference in footnote\\[.5ex]
	\multicolumn{3}{h}{Inclusion in bibliography without citation:}\\[.5ex]
	\tikzmark{inc1}&	\cs{nocite}\marg{\meta{key}}\hfill\cs{nocite}\marg{*}\hfill\mbox{}	&	inclusion only \\
	\tnote{c}	&	\cs{notecite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	& with notes \\
	\tnote{c}	&	\cs{pnotecite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	with parenthetical notes \\
	\tikzmark{inc2}  &	\cs{fnotecite}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}	&	with footnote notes \\[.5ex]
  \end{tabular}
  \begin{tablenotes}
    \item[a] Author-year and author-title styles only.
    \item[c] Capitalised command(s) also provided.
	e.g.~\cs{Textcite}, \cs{Autocites}.
	\item[m] ‘Multicite’ command(s) available.\\	e.g.~\cs{cites}\parg{\meta{multipre}}\parg{\meta{multipost}}\oarg{\meta{pre}}\oarg{\meta{post}}\marg{\meta{key}}\oarg{\meta{pre}}\\\oarg{\meta{post}}\marg{\meta{key}}\dots.
    \item[n] Numerical styles only.
	\item[s] Starred version available to include extra year information.
  \end{tablenotes}
\end{threeparttable}
\begin{tikzpicture}[overlay, remember picture]
  \foreach \i in {sc,sic,spc,tc,cc,mv,inc}
  \cysylltiad{{pic cs:\i2}}{{pic cs:\i1}};
\end{tikzpicture}

\section{\BibTeX{} Databases}\label{sec:bib}

A \BibTeX{} database file is a plain text file with extension \textt{.bib}.
It consists of entries of the following form:\tikzmark{doc7}

\hskip .5\normalparindent\tikzmark{doc5}\hskip .25\normalparindent%
\begin{minipage}[t]{.325\linewidth}

\begin{verbatim}
	@<entrytype>{<key>,
	    <field> = <value>,
	    <field> = <value>,
	    <field> = <value>,
	    ...}
\end{verbatim}
\end{minipage}%
\hfill
\begin{minipage}[t]{.05\linewidth}
  e.g.
\end{minipage}%
\hskip .5\normalparindent\tikzmark{doc8}\hskip .25\normalparindent%
\begin{minipage}[t]{.525\linewidth}
\begin{mverbatim}
	@book{tolkien-hobbit,
	  author = {Tolkien, J. R. R.},
	  title  = {The Hobbit},
	  date   = {YYYY-MM-DD},
	  ...}
\end{mverbatim}
\end{minipage}
\begin{tikzpicture}[overlay, remember picture]
  \draw
	({pic cs:doc6}) ++(0,\baselineskip) coordinate (doc6)
	({pic cs:doc7}) ++(0,\parskip-\baselineskip) coordinate (doc7)
	({pic cs:doc5} |- doc7) -- ({pic cs:doc5} |- doc6)
	({pic cs:doc8} |- doc7) -- ({pic cs:doc8} |- doc6)
	;
\end{tikzpicture}

\tikzmark{doc6}\meta{entrytype} partially determines which fields are required and which optional.
\meta{key} is a unique identifier used in citation commands to reference the entry.
\meta{field} is the name of a database field and determines the expected format of \meta{value}.
\meta{value} is the value of the relevant \meta{field} for the entry.

\subsection{\BibTeX{} Database Entry Types}\label{subsec:entries}

\begin{tabular}{@{}ll@{}}
  \multicolumn{2}{h}{Material from journals, magazines \& newspapers:}\\[.5ex]
  \tikzmark{1j}\entry{article}	&	journal, magazine or newspaper article\\
  \entry{periodical}	&	whole issue of a periodical\\
  \tikzmark{2j}\entry{suppperiodical}	&	supplemental material in periodical\\[.5ex]
  \multicolumn{2}{h}{Material from single-authored or co-authored books:}\\[.5ex]
  \tikzmark{1b}\entry{inbook}	&	book part with own title\\
  \entry{suppbook}	&	supplemental material in book\\
  \entry{bookinbook}	&  originally published as standalone book\\
  \entry{book}	&	single-volume book by author(s) of whole\\
  \tikzmark{2b}\entry{mvbook}	&	multi-volume book\\[.5ex]
  \multicolumn{2}{h}{Material from edited anthologies:}\\[.5ex]
  \tikzmark{1c}\entry{incollection}	&	contribution to anthology\\
  \entry{suppcollection}	&	supplemental material in anthology\\
  \entry{collection}	&	single-volume edited anthology\\
  \tikzmark{2c}\entry{mvcollection}	&	multi-volume collection\\[.5ex]
  \multicolumn{2}{h}{Material from conference proceedings:}\\[.5ex]
  \tikzmark{1p}\entry{inproceedings}	&	article in conference proceedings\\
  \entry{proceedings}	&	single-volume conference proceedings\\
  \tikzmark{2p}\entry{mvproceedings}	&	multi-volume conference proceedings\\[.5ex]
  \multicolumn{2}{h}{Material from works of reference:}\\[.5ex]
  \tikzmark{1r}\entry{inreference}	&	article in a reference work\\
  \entry{reference}	&	single-volume work of reference\\
  \tikzmark{2r}\entry{mvreference}	&	multi-volume reference work\\[.5ex]
  \multicolumn{2}{h}{Material from technical \& institutional publications:}\\[.5ex]
  \tikzmark{1i}\entry{manual}	&	technical or other documentation\\
  \entry{report}	&	institutional report or white paper\\
  \entry{patent}	&	patent or patent request\\
  \tikzmark{2i}\entry{thesis}	&	work completed to fulfil degree requirement\\[.5ex]
  \multicolumn{2}{h}{Material from online, informal \& other sources:}\\[.5ex]
  \tikzmark{1o}\entry{online}	&	\emph{inherently} online source\\
  \entry{booklet}	&	informally published book\\
  \entry{unpublished}	&	work not formally published\\
  \tikzmark{2o}\entry{misc}	&	 last resort (check manual first!)\\[.5ex]
  \multicolumn{2}{h}{Special entries for database management:}\\[.5ex]
  \tikzmark{1x}\entry{set}	&	(static) entry ‘set’\\
  \tikzmark{2x}\entry{xdata}	&	data-container (cannot be cited)\\
\end{tabular}
\begin{tikzpicture}[overlay, remember picture]
  \foreach \i in {j,b,c,p,r,o,x,i}
  \cysylltiad{{pic cs:2\i}}{{pic cs:1\i}};
\end{tikzpicture}

\subsection{\BibTeX{} Database Fields}\label{subsec:fields}

\begin{threeparttable}
  \begin{tabular}{@{}>{\bkeyfamily}ll@{}}
	\tikzmark{a1}author\tnote{s} &	author(s) of \bkey{title}, \bkey{authortype} specifies kind\\
	bookauthor	&	author(s) of \bkey{booktitle}\\
	editor\tnote{s}		& editor(s), \bkey{editortype} specifies role	\\
	editora/b/c	 &	secondary editor(s), \bkey{editora/b/ctype} for roles\\
	afterword		&	author(s) of afterword\\
	annotator	&	author(s) of annotations\\
	commentator	&	author(s) of commentary\\
	forward	&	author(s) of forward\\
	introduction	&	author(s) of introduction\\
	translator	&	translator(s) of \bkey{(book)title}\\
	\tikzmark{a2}holder	&	of patent\\
	\tikzmark{o1}institution	&	university or similar\\
	organization	&	manual/website publisher or event sponsor\\
	\tikzmark{o2}publisher\tnote{o}	& publisher(s)	\\
	\tikzmark{t1}title\tnote{a,o,s,u}	&	title\\
	indextitle	&	if different from \bkey{title}\\
	booktitle\tnote{a,u}	&	title of book\\
	maintitle\tnote{a,u}	&	title of multi-volume book\\
	journaltitle\tnote{u}	&	or \bkey{journal\tnote{s}}\\
	issuetitle\tnote{u}	&	title of journal special issue\\
	eventtitle\tnote{a}	&	title of conference or event\\
	reprinttitle	&	title of a reprint of the work\\
	\tikzmark{t2}series\tnote{s}	&	publication series\\
	\tikzmark{v1}volume	&	volume of journal or multi-volume book\\
	number	&	numbered issue of journal or book in series\\
	part	&	number of physical part of logical volume\\
	issue	&	non-number issue of journal\\
	volumes	&	number of volumes for multi-volume work\\
	edition	&	as \meta{integer} rather than ordinal\\
	version	&	revision number for software or manual\\
	\tikzmark{v2}pubstate	&	publication state\\
	\tikzmark{p1}pages	&	page list or range\\
	pagetotal	&	total number of pages\\
	\tikzmark{p2}(book)pagination	&	pagination format of \bkey{(book)title}\\
	\tikzmark{d1}date\tnote{o}		&	publication date as \meta{\textsc{yyyy-mm-dd}}\\
	eventdate	&	conference or event date as \meta{\textsc{yyyy-mm-dd}}\\
	\tikzmark{d2}urldate	&	access date for \bkey{url} as \meta{\textsc{yyyy-mm-dd}}\\
	\tikzmark{l1}location\tnote{o}	&	or \bkey{address}, where published\\
	\tikzmark{l2}venue	&	of event\\
	\tikzmark{e1}url		& URL\\
	doi		&	Digital Object Identifier\\
	eid		&	electronic identifier of \entry{article}\\
	eprint	&	archive-specific electronic identifier\\
	\tikzmark{e2}eprinttype	&	type of identifier, \bkey{eprintclass} for further details\\
	\tikzmark{y1}type	&	of \entry{manual}, \entry{patent}, \entry{report} or \entry{thesis}\\
	\tikzmark{y2}entrysubtype	&	for finer-grained specification of type\\
	\tikzmark{n1}addendum	&	miscellaneous data printed at end of entry\\
	note	&	miscellaneous data printed within entry\\
	\tikzmark{n2}howpublished	&	non-standard publication details\\
	language\tnote{o}	&	language of work\\
  \end{tabular}
  \begin{tablenotes}
	\item[a] An \bkey{--addon} field is available
	e.g.~\bkey{nameaddon}, \bkey{eventtitleaddon}.
	\item[o] An \bkey{orig--} field is available
	e.g.~\bkey{origdate}, \bkey{origlanguage}.
	\item[s] A \bkey{short--} field is available
	e.g.~\bkey{shortauthor}, \bkey{shortitle}.
	\item[u] A \bkey{--subtitle} field is available
	e.g.~\bkey{subtitle}, \bkey{mainsubtitle}.
  \end{tablenotes}
\end{threeparttable}

\begin{tabular}{@{}>{\bkeyfamily}ll@{}}
	\tikzmark{i1}isan	&	International Standard Audiovisual Number\\
	isbn	&	International Standard Book Number\\
	ismn	&	International Standard Music Number\\
	isrn	&	International Standard Technical Report Number\\
	issn	&	International Standard Serial Number\\
	\tikzmark{i2}iswc	&	International Standard Work Code\\
	abstract	&	record of work's abstract\\
	annotation	&	for annotated bibliographies\\
	file	&	local link\\
	library	&	library name, call number or similar\\
	\tikzmark{h1}label	&	fall-back label\\
	shorthand	&	special designator, overrides label in citations\\
	\tikzmark{h2}shorthandintro	&	override default introduction of \bkey{shorthand}\\[.5ex]
	\multicolumn{2}{h}{Special fields for non-printable data:}\\[.5ex]
	\tikzmark{s1}execute	&	arbitrary \TeX{} code\\
	keywords	&	separated list of keywords\\
	options	&	per-entry options\\
	ids	&	citation key aliases\\
	\tikzmark{r1}related	&	another entry key, \bkey{relatedoptions} for options\\
	relatedtype & relationship identifier for \bkey{related}\\
	\tikzmark{r2}relatedstring	&	override value of \bkey{relatedtype}\\
	\tikzmark{x1}entryset	&	list of entry keys in \entry{set}\\
	crossref	&	another entry key\\
	xref		&	another entry key\\
	\tikzmark{x2}xdata	&	entry key for \entry{xdata} container\\
	\tikzmark{b1}langid	&	\pkg{babel}/\pkg{polyglossia} language identifier\\
	langidopts	&	\pkg{polyglossia} options for \bkey{langid}\\
	\tikzmark{b2}gender	&	gender of \bkey{author} or \bkey{editor}\\
	\tikzmark{srt1}presort	&	modify sorting\\
	sortkey	&	sort key, overrides everything except \bkey{presort}\tikzmark{de}\\
	sortname	&	replaces \bkey{author} or \bkey{editor} when sorting\\
	sortshorthand	&	\bkey{sortkey} if entry has \bkey{shorthand}\\
	sorttitle	&	replaces \bkey{title} when sorting\\
	indexsorttitle	&	replaces \bkey{title} when sorting index\\
	\tikzmark{s2}\tikzmark{srt2}sortyear	&	replaces \bkey{year} (from \bkey{date}) when sorting\\
\end{tabular}
\begin{tikzpicture}[overlay, remember picture]
  \foreach \i/\j in {a/individuals,t/titles,x/inherit\\data,y/types,e/digital,n/misc.,o/orgs,d/dates,l/places,p/pages,v/volumes \& versions,r/related,h/labels,i/international\\standards,b/lang.,srt/sorting}
  \cysylltiad[\j]{{pic cs:\i2}}{{pic cs:\i1}};
  \draw [decoration={brace}, decorate] ([xshift=-2.5em, yshift=-.1\baselineskip]{pic cs:s2}) -- ([xshift=-2.5em, yshift=.6\baselineskip]{pic cs:s1});
\end{tikzpicture}

\section{Built-In Styles}\label{sec:styles}

\begin{threeparttable}
  \begin{tabularx}{\linewidth}{@{}>{\bkeyfamily}l>{\bkeyfamily}l>{\RaggedRight\arraybackslash}X@{}}
	\normalfont\bkeyfamily\bfseries citestyle	&	\normalfont\bkeyfamily\bfseries bibstyle & \\[.5ex]
	numeric\tnote{c,v}	& numeric	& numeric	\\
	alphabetic\tnote{v}	& alphabetic	&	alphabetic \\
	authoryear\tnote{c,ib,ic}	& authoryear	& author-year\\
	authortitle\tnote{c,ib,ic,t,tc,tic}	& authortitle	&	\\
	verbose\tnote{ib,in,n}	&	verbose	&	full reference on first citation\\
	verbose-trad1/2/3\tnote{tr}	&	&	‘traditional’ footnote citations\\
	reading\tnote{1}	&	reading	&	reading list\\
	draft	&	draft	&	show entry keys\\
	debug	&	debug	&	for debugging\\
  \end{tabularx}
  \begin{tablenotes}[para]
	\item[c] \bkey{-comp} option (compact).
	\item[ib] \bkey{-ibid} option (use \emph{ibidem}).
	\item[ic] \bkey{-icomp} option (compact \& \emph{ibidem}).
	\item[in] \bkey{-inote} option (notes \& \emph{ibidem}).
	\item[n] \bkey{-note} option (full citations as footnotes).
	\item[t] \bkey{-terse} option (omit title if unique).
	\item[tc] \bkey{-tcomp} option (compact \& terse).
	\item[tic] \bkey{-ticomp} option (compact, terse \& \emph{ibidem}).
	\item[tr] The three use different scholarly abbreviations in different ways.
	\item[v] \bkey{-verb} option (verbose).
	\item[1] Equivalent to \verb|citestyle=authortitle|.
  \end{tablenotes}
\end{threeparttable}

\section{Multiple, Divided \& Filtered Bibliographies}\label{sec:multi}

\begin{description}
  \item[Bibliography section] Document part with its own bibliography.
  \item[Bibliography segment] Document part corresponding to a sub-division of a global bibliography.
\end{description}

See package options \bkey{refsection} and \bkey{refsegment} for automated creation according to document division.
Finer-grained control is also possible:\tikzmark{doc2}

\hskip .75\normalparindent\tikzmark{doc4}\hskip .25\normalparindent
\begin{minipage}[b]{.55\linewidth}
  \begin{verbatim}
	\begin{refsection}
	    [<resource>,...]% replace default list
	    ...
	\end{refsection}
  \end{verbatim}
\end{minipage}%
\hskip .75\normalparindent\tikzmark{doc3}\hskip .25\normalparindent
\begin{minipage}[b]{.3\linewidth}
  \begin{verbatim}
	\begin{refsegment}
		...
	\end{refsegment}

  \end{verbatim}
\end{minipage}\hfill\mbox{}%
\begin{tikzpicture}[remember picture, overlay]
  \draw
	({pic cs:doc4}) ++(0,\baselineskip) coordinate (doc4)
	({pic cs:doc3}) ++(0,2\baselineskip) coordinate (doc3)
	(doc4 |- {pic cs:doc2}) +(0,-\parskip) -- (doc4)
	(doc3 |- {pic cs:doc2}) +(0,-\parskip) -- (doc3)
	;
\end{tikzpicture}


\begin{description}
  \item[Bibliography category] Topic or source type corresponding to a sub-division of a global bibliography.
\end{description}

\begin{tabular}{@{}ll@{}}
  \cs{DeclareBibliographyCategory}\marg{\meta{category}}	&	new category\\
  \cs{addtocategory}\marg{\meta{category}}\marg{\meta{key}}	&	add entry to category\\
\end{tabular}

\section{Printing Bibliographies}\label{sec:print}

\begin{tabularx}{\linewidth}{@{}l>{\RaggedRight\arraybackslash}X@{}}
  \cs{printbibliography}\oarg{\meta{options}}	&	typeset the bibliography\\
  \cs{printbiblist}\oarg{\meta{options}}\marg{\meta{name}}	&	typeset bibliography list \meta{name}\newline e.g.~\bkey{shorthand}\\
\end{tabularx}

\begin{threeparttable}
  \begin{tabularx}{\linewidth}{>{\bkeyfamily}lM>{\RaggedRight\arraybackslash}X@{}}
	\multicolumn{3}{h}{Options:}\\[.5ex]
	env	&	\meta{name}	& 	e.g.~\bkey{bibliography}\\
	heading	&	\meta{heading}	&	e.g.~\bkey{subbibliography}, \bkey{(sub)bibintoc}\\
	title		&	\meta{text}	&	\\
	prenote	&	\meta{name}\tikzmark{pn1}	&	define start/end notes with\\
	postnote	&	\meta{name}\tikzmark{pn2}	&	\cs{defbibnote}\marg{\meta{name}}\marg{\meta{text}}\\
	section	&	\meta{integer}	&	for \env{refsection} \meta{integer}\\
	segment	&	\meta{integer}	& 	for \env{refsegment} \meta{integer}\\
	category\tnote{n}	&	\meta{category}	&	only entries in \meta{category}\\
	keyword\tnote{n}	&	\meta{keyword}	&	only entries with \bkey{keyword} \meta{keyword}\\
	type\tnote{n}		&	\meta{entrytype}	&	only entries of type \meta{entrytype}\\
  \end{tabularx}
  \begin{tablenotes}
	\item[n] A negated filter is available as \bkey{not--}
	e.g.~\bkey{notcategory}\texttt{=}\meta{category}.
  \end{tablenotes}
\end{threeparttable}

\begin{tabular}{@{}>{\bkeyfamily}ll@{}}
  \cs{bibbysection}\oarg{\meta{options}}	&	all \bkey{refsection} bibliographies\\
  \cs{bibbysegment}\oarg{\meta{options}}	&	all \bkey{refsegment} bibliographies\\
  \cs{bibbycategory}\oarg{\meta{options}}	&	bibliographies for all categories\\
\end{tabular}

\begin{tikzpicture}[remember picture, overlay]
  \foreach \i in {1,2} \coordinate (pn\i) at ({pic cs:pn\i});
  \draw [decoration={brace}, decorate] ([xshift=2em, yshift=.6\baselineskip]pn1) -- ([xshift=2em, yshift=-.1\baselineskip]pn2);
\end{tikzpicture}

\section{Biber}\label{sec:biber}

\begin{minipage}{.5\linewidth}
  \begin{verbatim}
	biber [options] file[.bcf]
  \end{verbatim}
\end{minipage}%
\begin{minipage}{.5\linewidth}
  \begin{verbatim}
  	biber [options] --tool <datasource>
  \end{verbatim}
\end{minipage}

By default, Biber reads a \filename{.bcf} and produces a \filename{.bbl} which \LaTeX{} needs to produce a document's citations and bibliography.
But Biber also has a powerful ‘tool’ mode.
The manual explains the details but \verb|biber --help| is a more comprehensible starting point.

To produce a document-specific \filename{.bib}:
\begin{verbatim}
	biber --output_format=bibtex --output_resolve <filename>.bcf
\end{verbatim}
\mbox{}\smallskip

\hrule
\smallskip

{\scriptsize Copyright \copyright \svnyear{} \svnFullAuthor{\svnauthor} \email{ReesC21@cardiff.ac.uk} Rev.~\svnrev{} \svnyear--\svnmonth--\svnday{}\par}
\end{multicols}

\end{document}