PubMan Func Spec Bibtex Mapping
Revision as of 12:56, 11 April 2011 by Martin (talk | contribs) (→Mapping of "common" (maybe relevant), non standard BibTeX Entries)
BibTeX[edit]
Standard entry types[edit]
- 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[edit]
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[edit]
- 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 [1] [2][edit]
- 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.
eSciDoc Metadata Set for Publication[edit]
see: CoLab page on PubMan Metadata Sets
Mapping BibTeX to eSciDoc Metadata Set for Publications (for BibTeX import)[edit]
- Overall rule: if a source.title is given, please always set source.genre to "journal"
Mapping of Genres[edit]
| 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 | - |
| poster | poster | - |
Mapping of BibTeX Standard Entries[edit]
| BibTeX | eSciDoc | Comment/Condition(s) |
|---|---|---|
| address | PublishingInfo.Place | - |
| 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 | publisher | - |
| 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 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 | |
| school | publisher | For all thesis related genres |
| series | Source.Title | for @book, @misc and @techreport |
| series | Source.Title | Title of 2nd source for @inbook and @incollection |
| title | Title | - |
| type | Degree | "Habilitation" or "Dissertation" in connection with PhD Tesis or Master Thesis |
| volume | Source.Volume | for @article, @book and @proceedings |
| volume | Source.Source.Volume | for @inbook, @inproceedings and @incollection |
| 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[edit]
| 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' 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" | |
| ISSN | Identifier.ID | and set Identifier.IdType 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 |
Mapping eSciDoc Metadata Set for Publications to BibTeX (for BibTeX Export)[edit]
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[edit]
| eSciDoc | BibTeX | Comment/Condition(s) |
|---|---|---|
| Article | @article | - |
| book | @book | - |
| Book Item | @incollection | - |
| Proceedings | @proceedings | - |
| Proceedings Paper | @inproceedings | - |
| Talk at Event | @misc | - |
| Conference Report | @misc | - |
| Poster | @misc | - |
| Courseware/Lecture | @misc | - |
| Thesis | @mastersthesis if degree=master is given, @phdthesis if degree=phd is given | if none of the previously named conditions are fullfilled, then map to @misc |
| Paper | @misc | - |
| Report | @techreport | - |
| Journal | @misc | - |
| Issue | @misc | - |
| Series | @misc | - |
| Manuscript | @misc | - |
| Other | @misc | - |
Mapping of Entries[edit]
| eSciDoc | BibTeX | Comment/Condition(s) |
|---|---|---|
| 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 |
| Title | title | - |
| Language | language | - |
| 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 |
| PublishingInfo.Publisher | publisher | if no publisher is given at source |
| PublishingInfo.Place | address | if no publisher is given at source |
| PublishingInfo.Edition | edition | if no edition is given at source |
| 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 |
| Abstract | abstract | - |
| Subject | keywords | - |
| TableOfContents | contents | - |
| 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 or Proceedings |
| Source.Title | journal | write source.title to journal, if source.genre is journal |
| 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 | note | if Source.Creator.CreatorRole.Editor 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.Editor exists, then write <Source.Creator.Creator role>":" value of Source.Creator.Organization.Name to note |
| Source.Volume | volume | - |
| Source.Issue | issue | - |
| Source.StartPage + Source.EndPage | pages | write <Source.StartPage> "-" <Source.EndPage> in pages |
| Source.PublishingInfo.Publisher | publisher | - |
| Source.PublishingInfo.Place | address | - |
| Source.PublishingInfo.Edition | edition | - |
| 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 |
Links, further reading[edit]
- 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
References[edit]
- ↑ http://www.fb10.uni-bremen.de/anglistik/langpro/bibliographies/jacobsen-bibtex.html - page on BibTeX
- ↑ http://www.ams.org/tex/amsrefs.html - extension package for LaTeX/BibTeX by the American Mathematical Society