summaryrefslogtreecommitdiff
path: root/info/biblatex-cheatsheet
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /info/biblatex-cheatsheet
Initial commit
Diffstat (limited to 'info/biblatex-cheatsheet')
-rw-r--r--info/biblatex-cheatsheet/README7
-rw-r--r--info/biblatex-cheatsheet/biblatex-cheatsheet.pdfbin0 -> 313925 bytes
-rw-r--r--info/biblatex-cheatsheet/biblatex-cheatsheet.tex606
3 files changed, 613 insertions, 0 deletions
diff --git a/info/biblatex-cheatsheet/README b/info/biblatex-cheatsheet/README
new file mode 100644
index 0000000000..5b7e5bc30b
--- /dev/null
+++ b/info/biblatex-cheatsheet/README
@@ -0,0 +1,7 @@
+A 'cheat sheet' for Biblatex/Biber.
+
+Clea F. Rees
+ReesC21 <at> cardiff <dot> ac <dot> uk
+2017/06/24
+
+vim: set nospell:
diff --git a/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf b/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf
new file mode 100644
index 0000000000..e0c10d943c
--- /dev/null
+++ b/info/biblatex-cheatsheet/biblatex-cheatsheet.pdf
Binary files differ
diff --git a/info/biblatex-cheatsheet/biblatex-cheatsheet.tex b/info/biblatex-cheatsheet/biblatex-cheatsheet.tex
new file mode 100644
index 0000000000..3f8257d48c
--- /dev/null
+++ b/info/biblatex-cheatsheet/biblatex-cheatsheet.tex
@@ -0,0 +1,606 @@
+% !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}