Extra fields

In some cases the Zotero fields do not offer a place to enter the data you need to get your exported entries just right. For this Zotero has a so-called “cheater syntax” which allows you to add extra “fields” as separate lines in the extra field all items in Zotero have. These fields are supported by the citation processor inside Zotero, and BBT understands them too, and adds one “cheater syntax of its own.

You can add such fields by adding each on their own line in the following format:

Label: value

or the older format you migh have seen, which is supported but considered depracated:

{:csl-variable: value}

The full list of labels and the Zotero/CSL variables they translate to can be found in the table at the end.

These extra-fields are available to postscripts as extra.kv.<variable-name>. Which variable it is depends (sorry):

  • when you export to CSL, it is attempted to map it to the corrsponding CSL fields; if none are available, it is available under their zotero name
  • when you export to Better BibTeX/Better BibLaTeX, it is attempted to map it to the corresponding zotero fields; if none are available, it is available under their csl variable name

There’s three type of fields:

  • text
  • date
  • name

Text is just that. For dates, BBT will do its darndest to parse the crazy dates so many people seem intent in using but if you want consistent results, stick to YYYY-MM-DD. For names, use either just text (equivalent to a single-part name in Zotero), or <family name> || <given name>.

BBT-specific

There is also a BBT-specific extra-field format that looks like

tex.field: value

These fields are simply copied to the output by BBT, so if you have

tex.bestfield: philosophy

you will end up with

  bestfield = {philosophy}

in the written bib(la)tex.

You can make BBT export the field only for bibtex or biblatex by changing the prefix to bibtex. (so bibtex.bestfield:) or biblatex. respectively. Finally, you can use = instead of : as a delimiter, and that will indicate to BBT that what follows the = is “raw LaTeX”; BBT will not do any escaping and just copy it out unchanged. This means, for example, that you would probably want

tex.corp: Black & Decker
tex.formula= $\sum\limits_{i=1}^{n} -p(m_{i})\log_{2}(p(m_{i}))$

and not

tex.corp= Black & Decker
tex.formula: $\sum\limits_{i=1}^{n} -p(m_{i})\log_{2}(p(m_{i}))$

BBT will apply case-protection rules for non-raw fields by including capitals in the prefix, eg

TeX.corp: Black & Decker

It is important to note that these BBT-specific fields are not recognized by any other exporter. They might end up in notes for some other exporters; there’s nothing I can do about that.

Label/variable list

note: I list the Zotero fields here, not the bibtex fields. The Zotero fields are translated to bibtex fields but that translation is pretty complicated and I don’t have a simple description of it at this time.

label type zotero csl
access date text accessDate accessed
accessed date accessDate accessed
annote text annote
application number text applicationNumber call-number
archive text archive archive
archive collection text archive_collection
archive id text archiveID / number
archive location text archiveLocation archive_location
archive place text archive-place
artist name artist
artwork medium text artworkMedium / medium
artwork size text artworkSize dimensions
assignee text assignee
attorney agent name attorneyAgent
audio file type text audioFileType / medium
audio recording format text audioRecordingFormat / medium
author name author / creator author
authority text authority authority
available date date available-date
bill number text billNumber / number
blog title text blogTitle / publicationTitle
book author name bookAuthor container-author
book title text bookTitle / publicationTitle
call number text applicationNumber / callNumber call-number
cartographer name cartographer
case name text caseName / title
cast member name castMember performer
categories text categories
chair name chair chair
chapter number text session chapter-number
citation key text citationKey citation-key
citation label text citation-label
citation number text citation-number
code text code container-title
code number text codeNumber volume
code pages text codePages / pages
code volume text codeVolume / volume
collection editor name seriesEditor collection-editor
collection number text seriesNumber collection-number
collection title text series / seriesTitle collection-title
commenter name commenter
committee text committee section
company text company / publisher
compiler name compiler
composer name composer composer
conference name text conferenceName event-title
container author name bookAuthor container-author
container title text code / publicationTitle / reporter container-title
container title short text container-title-short
contributor name contributor contributor
cosponsor name cosponsor
counsel name counsel
country text country
court text authority / court
creator name creator author
curator name curator
custom custom
date date date issued
date decided date date / dateDecided
date enacted date date / dateEnacted
dictionary title text dictionaryTitle / publicationTitle
dimensions text artworkSize / runningTime dimensions
director name director director
distributor text distributor / publisher
division text division
docket number text docketNumber / number
document number text documentNumber / number
doi text DOI DOI
edition text edition edition
editor name editor editor
editorial director name editorial-director
encyclopedia title text encyclopediaTitle / publicationTitle
episode number text episodeNumber / number
event text event
event date date event-date
event place text eventPlace event-place
event title text conferenceName / meetingName event-title
executive producer name executiveProducer executive-producer
filing date date filingDate submitted
first page text firstPage / pages
first reference note number text first-reference-note-number
format text format / medium
forum title text forumTitle / publicationTitle
genre text genre / programmingLanguage / type genre
guest name guest guest
history text history references
host name host / podcaster host
id text id
identifier text identifier / number
illustrator name illustrator
institution text institution / publisher
interviewee name interviewee
interviewer name interviewer interviewer
interview medium text interviewMedium / medium
inventor name inventor
isbn text ISBN ISBN
issn text ISSN ISSN
issue text issue / priorityNumbers issue
issued date date issued
issue date date date / issueDate
issuing authority text authority / issuingAuthority
journal abbreviation text journalAbbreviation journalAbbreviation
jurisdiction text jurisdiction
keyword text keyword
label text label / publisher
language text language language
legal status text legalStatus / status
legislative body text authority / legislativeBody
letter type text letterType / type
library catalog text libraryCatalog source
license text rights license
locator text locator
manuscript type text manuscriptType / type
map type text mapType / type
medium text medium / system medium
meeting name text meetingName event-title
name of act text nameOfAct / title
narrator name narrator narrator
network text network / publisher
number text number number
number of pages text numPages number-of-pages
number of volumes text numberOfVolumes number-of-volumes
num pages text numPages number-of-pages
organization text authority / organization
organizer name organizer organizer
original author name originalCreator original-author
original creator name originalCreator original-author
original date date originalDate original-date
original place text originalPlace original-publisher-place
original publisher text originalPublisher original-publisher
original publisher place text originalPlace original-publisher-place
original title text original-title
page text pages page
page first text page-first
pages text pages page
part text part
part number text partNumber part-number
part title text partTitle part-title
patent number text number / patentNumber
performer name castMember / performer performer
place text place publisher-place
pmcid text PMCID PMCID
pmid text PMID PMID
podcaster name podcaster host
post type text postType / type
presentation type text presentationType / type
presenter name presenter
printing text printing
priority date text originalDate / priorityDate
priority numbers text priorityNumbers issue
proceedings title text proceedingsTitle / publicationTitle
producer name producer producer
programmer name programmer
programming language text programmingLanguage genre
program title text programTitle / publicationTitle
publication title text publicationTitle container-title
public law number text number / publicLawNumber
publisher text publisher publisher
publisher place text place publisher-place
recipient name recipient recipient
references text history / references references
reporter text reporter container-title
reporter volume text reporterVolume / volume
report number text number / reportNumber
report type text reportType / type
repository text publisher / repository
repository location text place / repositoryLocation
reviewed author name reviewedAuthor reviewed-author
reviewed genre text reviewed-genre
reviewed title text reviewed-title
rights text rights license
running time text runningTime dimensions
scale text scale scale
scriptwriter name scriptwriter script-writer
script writer name scriptwriter script-writer
section text committee / section section
series text series collection-title
series creator name seriesCreator series-creator
series editor name seriesEditor collection-editor
series number text seriesNumber collection-number
series text text seriesText
series title text seriesTitle collection-title
session text session chapter-number
session title text publicationTitle / sessionTitle
short title text shortTitle shortTitle / title-short
source text libraryCatalog source
sponsor name sponsor
status text status status
studio text publisher / studio
subject text subject / title
submitted date filingDate submitted
supplement text supplement
system text system medium
thesis type text thesisType / type
title text title title
title short text shortTitle title-short
translator name translator translator
type text type genre / type
university text publisher / university
url text url URL
version text versionNumber version
version number text versionNumber version
video recording format text medium / videoRecordingFormat
volume text codeNumber / volume volume
volume title text volume-title
volume title short text volume-title-short
website title text publicationTitle / websiteTitle
website type text type / websiteType
words by name wordsBy
year suffix text year-suffix

¹ only supported in Juris-M