PubMan Func Spec Bibtex Mapping

BibTeX

Standard entry types

article

An article from a journal or magazine.
Required fields: author, title, journal, year
Optional fields: volume, number, pages, month, note, key

book

A book with an explicit publisher.
Required fields: author/editor, title, publisher, year
Optional fields: volume, series, address, edition, month, note, key, pages

booklet

A work that is printed and bound, but without a named publisher or sponsoring institution.
Required fields: title
Optional fields: author, howpublished, address, month, year, note, key

conference

The same as inproceedings, included for Scribe (markup language) compatibility.
Required fields: author, title, booktitle, year
Optional fields: editor, pages, organization, publisher, address, month, note, key

inbook

A part of a book, usually untitled. May be a chapter (or section or whatever) and/or a range of pages.
Required fields: author/editor, title, chapter/pages, publisher, year
Optional fields: volume, series, address, edition, month, note, key

incollection

A part of a book having its own title.
Required fields: author, title, booktitle, year
Optional fields: editor, pages, organization, publisher, address, month, note, key

inproceedings

An article in a conference proceedings.
Required fields: author, title, booktitle, year
Optional fields: editor, pages, organization, publisher, address, month, note, key

manual

Technical documentation.
Required fields: title
Optional fields: author, organization, address, edition, month, year, note, key

mastersthesis

A Master's thesis.
Required fields: author, title, school, year
Optional fields: address, month, note, key

misc

For use when nothing else fits.
Required fields: none
Optional fields: author, title, howpublished, month, year, note, key

phdthesis

A Ph.D. thesis.
Required fields: author, title, school, year
Optional fields: address, month, note, key

proceedings

The proceedings of a conference.
Required fields: title, year
Optional fields: editor, publisher, organization, address, month, note, key

techreport

A report published by a school or other institution, usually numbered within a series.
Required fields: author, title, institution, year
Optional fields: type, number, address, month, note, key

unpublished

A document having an author and title, but not formally published.
Required fields: author, title, note
Optional fields: month, year, key

Other entry types

Using these entry types is not recommended, but they might occur in some bibliographies.

collection

A collection of works. The same as proceedings

patent

A patent.

BibTeX standard data entries

• address: Usually the address of the publisher or other type of institution. For major publishing houses, van Leunen recommends omitting the information entirely. For small publishers, on the other hand, you can help the reader by giving the complete address.
• annote: An annotation. It is not used by the standard bibliography styles, but may be used by others that produce an annotated bibliography.
• author: The name(s) of the author(s) (in the case of more than one author, separated by and)
• booktitle: Title of a book, part of which is being cited.
• chapter: A chapter (or section or whatever) number.
• crossref: The database key of the entry being cross referenced. Any fields that are missing from the current record are inherited from the field being cross referenced.
• edition: The edition of a book---for example, "Second". This should be an ordinal, and should have the first letter capitalized, as shown here; the standard styles convert to lower case when necessary.
• editor: The name(s) of the editor(s). If there is also an author field, then the editor field gives the editor of the book or collection in which the reference appears.
• howpublished: How it was published, if the publishing method is nonstandard
• institution: The institution that was involved in the publishing, but not necessarily the publisher. (The sponsoring institution of a technical report).
• journal: The journal or magazine the work was published in
• key: A hidden field used for specifying or overriding the alphabetical order of entries (when the "author" and "editor" fields are missing). Note that this is very different from the key (mentioned just after this list) that is used to cite or cross-reference the entry.
• month: The month of publication (or, if unpublished, the month of creation)
• note: Miscellaneous extra information
• number: The "number" of a journal, magazine, or tech-report, if applicable. (Most publications have a "volume", but no "number" field.)
• organization: The conference sponsor
• pages: Page numbers, separated either by commas or double-hyphens. For books, the total number of pages.
• publisher: The publisher's name
• school: The school where the thesis was written
• series: The series of books the book was published in "Lecture Notes in Physics".When citing an entire book, the title field gives its title and an optional series field gives the name of a series or multi-volume set in which the book is published.
• title: The title of the work
• type: The type of tech-report, for example, "Research Note"
• volume: The volume of a journal or multi-volume book
• year: The year of publication (or, if unpublished, the year of creation)

In addition, each entry contains a key that is used to cite or cross-reference the entry. This key is the first item in a BibTeX entry, and is not part of any field.

Other (non standard) fields

• affiliation: The authors affiliation.
• abstract: An abstract of the work.
• contents: A Table of Contents
• copyright: Copyright information.
• date: Usually the date of publication. This replaces BibTEX's year and month fields. Its value should be written in ISO 8601 format, e.g., 1967-02-24.
• eprint: A specification of an electronic publication, often a preprint or a technical report.
• ISBN: The International Standard Book Number.
• ISSN: The International Standard Serial Number. Used to identify a journal.
• keywords: Key words used for searching or possibly for annotation.
• language: The language the document is in.
• location: A location associated with the entry, such as the city in which a conference took place.
• LCCN: The Library of Congress Call Number.
• mrnumber: The Mathematical Reviews number.
• price: The price of the document.
• size: The physical dimensions of a work.
• URL: The WWW Universal Resource Locator that points to the item being referenced. This often is used for technical reports to point to the ftp site where the postscript source of the report is located.

Mapping BibTeX to eSciDoc Metadata Set for Publications (for BibTeX import)

• Overall rule: if a source.title is given, please always set source.genre to "journal"

Mapping of Genres

BibTeX	eSciDoc	Comment/Condition(s)
article	Article	-
book	book	-
booklet	Other	-
conference	Proceedings Paper	the same as inproceedings
inbook	Book Item	-
incollection	Book Item	-
inproceedings	Conference Paper	-
manual	manual	-
mastersthesis	Thesis with degree type "master"	-
misc	Other	-
phdthesis	Thesis with degree type "phd"	-
phdthesis/masterthesis with tag "dissertation"	Thesis with degree type "?"	-
phdthesis/masterthesis with tag "habilitation"	Thesis with degree type "habilitation"	-
proceedings	Proceedings	-
techreport	Report	-
unpublished	Other	-
talk	talk	To be created by MPS
poster	poster	To be created by MPS

Mapping of BibTeX Standard Entries

BibTeX	eSciDoc	Comment/Condition(s)
Cite Key	Identifier(type = BibTexCiteKey)	-
address	PublishingInfo.Place	If there's no additional value in "publisher" or "school" (for theses and techreport): set "any publisher" in publishinginfo.publisher. If there's a source, map to Source.Publishinginfo.Place for article, inbook, inproceedings, conference and incollection
annote	not mapped	-
author	Creator.CreatorType=Author.Person.FamilyName.GivenName	it also might be, that it is in the order GivenName.FamilyName. Organizations in creator role can be recognized by the beginning "the". May also be marked with "{}".
booktitle	source.title	if genre is @conference, @inbook, @incollection, @inproceedings
chapter	title	e.g. "IV - The Effect of Solar..."
crossref	not mapped	-
edition	PublishingInfo.Edition	-
editor	Creator.CreatorType=Editor.Person.FamilyName.GivenName	it also might be, that it is in the order GivenName.FamilyName. Organizations: See "author".
howpublished	not mapped	-
institution	PublishingInfo.Publisher	if Publisher is not set
journal	Source.Title	for @article, @misc or @unpublished; if fjournal is given, please map journal to source.AlternativeTitle
key	not mapped	-
month	date.type = published in print, date.date	goes after the year with a "-" e.g. 2007-month; before that the month has to be transfered into numbers, e.g. jan to 01, feb to 02; not sure if that is sufficient or if the month field should rather not be mapped
month	date.type = created, date.date	for @unpublished; goes after the year with a "-" e.g. 2007-month
note	not mapped	-
number	Source.Issue	For all genres other than @techreport. If genre is @techreport, map to Indetifier.ID (type "Report-Nr." = new ID type)
organization	not mapped	-
pages	Source.Startpage and Source.Endpage	For all genres other than @book or @proceedings
pages	TotalNumberOfPages	if genre is @book or @proceedings
publisher	PublishingInfo.Publisher	If there's a source, map to Source.Publishinginfo.Publisher for article, inbook, inproceedings, conference and incollection
school	PublishingInfo.Publisher	For all thesis (Master & PhD) related genres, if publisher isn't set directly
series	Source.Title	for @book, @misc and @techreport
series	Source.Title	Title of 2nd source for @inbook, @incollection, and @inproceedings
title	Title	-
type	Degree	"Habilitation", "Dissertation", "Master", "Magister", "Diploma", "Bachelor" in connection with PhD Tesis or Master Thesis
volume	Source.Volume	for @article, @book and @proceedings
volume	Source.Source.Volume	for @inbook, @inproceedings, @incollection and @conference
year	date.type = published in print, date.date	goes before the month if given
year	date.type = created, date.date	for @unpublished; goes before the month if given

Mapping of "common" (maybe relevant), non standard BibTeX Entries

BibTeX	eSciDoc	Comment/Condition(s)
affiliation	Creator.Organization	Won't occur for MPS
abstract	Abstract	-
contents	TableOfContents	-
date	Date.Date	date.type = published in print - Won't occur for MPS
eprint	not mapped	-
fjournal	source.title	if fjournal exists, please map "journal" to source.AlternativeTitle
ISBN	Identifier.ID	and set Identifier.IdType to "ISBN"
ISBN	Source.Identifier.ID	for @inproceeding, @inbook, @incollection, @conference and Identifier.IdType set to "ISBN"
ISSN	Identifier.ID	and set Identifier.IdType to "ISSN"
ISSN	Source.Identifier.ID	for @article and Identifier.IdType set to "ISSN"
ISSN	Source.Source.Identifier.ID	for @inproceeding, @inbook, @incollection, @conference and Identifier.IdType set to "ISSN"
keywords	Subject	-
language	Language	language of publication is meant. To be clarified
location	not mapped	because we can't have a place of event without a tile of event
subtitle	AlternativeTitle	Type "Subtitle" (to be implemented in PubMan).
URL	file locator	first write URL into the locator field. User will then have the possibility in the edit mask to download the file and create a full text.
DOI	Identifier.ID	Type: "DOI"
eid	sequence number
rev	Review Type	= "Peer"
MPG-Affil	Affiliation	= "MPG" Affiliation for the concerning Authors ? To be clarified. Could also be "{}" for the concerning authors.

Mapping eSciDoc Metadata Set for Publications to BibTeX (for BibTeX Export)

The mapping and implementation of the BibTeX Export will be divided into two steps. 1st Step is the mapping of the standard fields (see below). In a 2nd step PubMan specific fields will be mapped.

Mapping of Genres

Original PubMan genres will be included as
% pubman genre = XXX
in front of each record

eSciDoc	BibTeX	Comment/Condition(s)
Article	@article	-
book	@book	-
Book Item	@incollection	-
Proceedings	@proceedings	-
Proceedings Paper	@inproceedings	-
Talk at Event	@inproceedings	-
Conference Report	@misc	-
Poster	@inproceedings	-
Courseware/Lecture	@misc	-
Thesis	@mastersthesis if degree=master/diploma/magister/staatsexamen/bachelor, @phdthesis if degree=phd/habilitation	'type' ist set to '$degree'
Paper	@misc	-
Report	@techreport	-
Journal	@misc	-
Issue	@misc	-
Series	@misc	-
Manuscript	@misc	-
Meeting Abstract	@inproceedings	-
Other	@misc	-

Mapping of Entries

eSciDoc	BibTeX	Comment/Condition(s)
Abstract	abstract	-
Creator.CreatorType.Person	author	if Creator.CreatorRole.Author exists, then write value of Creator.Person.Family.Name, Creator.Person.GivenName to author
Creator.CreatorType.Organization	author	if Creator.CreatorRole.Author exists, then write value of Creator. Organization.Name to author
Creator.CreatorType.Person	editor	Creator.CreatorRole.Editor exists, then write value of Creator.Person.Family.Name, Creator.Person.GivenName to editor
Creator.CreatorType.Organization	editor	if Creator.CreatorRole.Editor exists, then write value of Creator. Organization.Name to author
Date.Date	year	format YYYY, always export only one date; priority is: first Date.DateType = Published in Print, Date.DateType = Published Online, Date.DateType = accepted Date.DateType = submitted, Date.DateType = modified, Date.DateType = created
Date.Date	date	if DateType is published in print, then map Date.Date to year and date
Event.Place	adress
Identifier.Id	howpublished	if Identifier.IdType.URI or if Identifier.IdType.URN, then write <Identifier.IDType>":" <IdentifierId> to howpublished
Identifier.ID	ISSN	if Identifier.IdType.ISSN
Identifier.ID	ISBN	if Identifier.IdType.ISBN
Identifier.ID	URL	if Identifier.IdType.URI or Identifier.IdType.URN
Identifier.ID	DOI	if Identifier.IdType.DOI
Identifier.ID	number	if Identifier.IdType.Report-Nr
Identifier.ID	note	if Identifier.IdType.patentnumber (Value: "Patent numer XXX")
Language	language	-
PublishingInfo.Publisher	publisher	if no publisher is given at source
PublishingInfo.Publisher	school	for all types of thesis
PublishingInfo.Place	address	if no publisher is given at source and no event place is given
PublishingInfo.Edition	edition	if no edition is given at source
PublishingInfo.TotalNumberOfPages	pages	if publication genre is book, proceeding or issue
Subject	keywords	-
Source.Title	series	write source.title to series, if source.genre is series,
Source.Title	booktitle	write source.title to booktitle, if source.genre is Book, Proceedings, handbook, collected edition, festschrift,
Source.Title	journal	write source.title to journal, if source.genre is journal, issue, newspaper
Source.Creator.CreatorType.Person	note	if Source.Creator.CreatorRole.Author exists, then write <Source.Creator.Creator role>":" value of Source.Creator.Person.Family.Name, Source.Creator.Person.GivenName to note
Source.Creator.CreatorType.Organization	note	if Source.Creator.CreatorRole.Author exists, then write <Source.Creator.Creator role>":" value of Source.Creator.Organization.Name to note
Source.Creator.CreatorType.Person	editor	if Source.Creator.CreatorRole.Editor exists, then write <Source.Creator.Creator role>":" value of Source.Creator.Person.Family.Name, Source.Creator.Person.GivenName to editor
Source.Creator.CreatorType.Organization	editor	if Source.Creator.CreatorRole.Editor exists, then write <Source.Creator.Creator role>":" value of Source.Creator.Organization.Name to editor
Source.Volume	volume	-
Source.Issue	issue	-
Source.StartPage + Source.EndPage	pages	write <Source.StartPage> "--" <Source.EndPage> in pages
Source.PublishingInfo.Publisher	publisher	-
Source.PublishingInfo.Publisher	institution	if Genre is Report
Source.PublishingInfo.Place	address	if no event place is given
Source.PublishingInfo.Edition	edition	-
Source.PublishingInfo.Edition	number	if Genre is Report an no Identifier.ID with type Report-Nr. exists
Source.Identifier.Id	howpublished	if Source.Identifier.IdType.URI or if Source.Identifier.IdType.URN, then write <Source.Identifier.IDType>":" <Source.IdentifierId> to howpublished
Source.Identifier.ID	ISSN	if Source.Identifier.IdType.ISSN
Source.Identifier.ID	ISBN	if Source.Identifier.IdType.ISBN
Source.Sequence Number	eid
TableOfContents	contents	-
Title	title	-

Links, further reading

• Michael Wiedmann: References for TeX and Friends: http://www.miwie.org/tex-refs/html/index.html
• Oren Patashnik: BibTexing - http://www.eeng.dcu.ie/local-docs/btxdocs/btxdoc/btxdoc/btxdoc.html
• Wikipedia article on BibTeX: http://en.wikipedia.org/wiki/BibTeX
• Documentation of the BibTeX fields etc. used at the MPI für Sonnensystemforschung. And Link to the database that holds these entries.
• amsrefs package (extension package for LaTeX/BibTeX by the American Mathematical Society) http://www.ams.org/tex/amsrefs.html

Reference Management Software for Lists of References

International Organization for Standardization

International Standard Book Number

International Standard Serial Number

Uniform Resource Locator

Enhanced Scientific Documentation

Max Planck Society

Identifier

philosophiae doctor

Publication Management

Digital Object Identifier

Max-Planck-Gesellschaft

Uniform Resource Identifier

Uniform Resource Name

Max-Planck-Institut

Lamport TeX