From e0c6872cf40896c7be36b11dcc744620f10adf1d Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Mon, 2 Sep 2019 13:46:59 +0900 Subject: Initial commit --- info/biblatex-cheatsheet/biblatex-cheatsheet.tex | 606 +++++++++++++++++++++++ 1 file changed, 606 insertions(+) create mode 100644 info/biblatex-cheatsheet/biblatex-cheatsheet.tex (limited to 'info/biblatex-cheatsheet/biblatex-cheatsheet.tex') 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[]{} +... +\usepackage[utf8]{inputenc} +\usepackage{babel,csquotes,xpatch}% recommended +\usepackage[backend=biber,]{biblatex} +\addbibresource[]{} +\addbibresource[]{} +... +\begin{document} + ... + \printbibliography[] + ... + \printbibliography[] + ... +\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} + @{, + = , + = , + = , + ...} +\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} + [,...]% 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 + \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 .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} -- cgit v1.2.3