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:
or the older format you migh have seen, which is supported but considered depracated:
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
These fields are simply copied to the output by BBT, so if you have
you will end up with
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
and not
BBT will apply case-protection rules for non-raw fields by including capitals in the prefix, eg
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