Module Documentation: eml-literature
Back to EML Contents
The eml-literature module - Citation specific information

The eml-literature module contains information that describes literature resources. It is intended to provide overview information about the literature citation, including title, abstract, keywords, and contacts. Citation types follow the conventions laid out by EndNote, and there is an attempt to represent a compatible subset of the EndNote citation types. These citation types include: article, book, chapter, edited book, manuscript, report, thesis, conference proceedings, personal communication, map, generic, audio visual, and presentation. The "generic" citation type would be used when one of the other types will not work.

The eml-literature module, like other modules, may be "referenced" via the <references> tag. This allows a citation to be described once, and then used as a reference in other locations within the EML document via its ID.

Module details
Recommended Usage: All datasets with literary citations
Stand-alone: yes
Imports: eml-documentation, eml-resource, eml-coverage, eml-party, eml-access, eml-project
Imported By:
View an image of the schema: eml-literature image

Element Definitions:

citation  This element has no default value.
Content of this field: Description of this field:
Type: CitationType
The citation element contains general information about a literature resource that is being documented, or a piece of literature that is being cited in support of a given resource, such as a dataset. It contains sub-elements that are specific to a literature resource such as a book, a journal article, a thesis, etc. It extends the generic resource elements with literature specific fields.
contact  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The contact field contains information about an alternate person to be contacted about this citation. Usually, the first author serves as the contact for a citation resource, e.g., a reprint request. In some cases, an alternate individual(s) may serve that function, and can be indicated here. Since contact is of the type rp:ResponsibleParty, a reference may be used.
article  This element has no default value.
Content of this field: Description of this field:
Type: Article
The article field provides sub-fields for a full citation of an article in a journal or other periodical.
book  This element has no default value.
Content of this field: Description of this field:
Type: Book
The book field provides sub-fields for a full citation of a book.
chapter  This element has no default value.
Content of this field: Description of this field:
Type: Chapter
The book chapter allows citation of a single chapter or section of a book. The "creator" for a book chapter are the chapter's authors, while the "editor" is the book editors. Likewise, "title" is the chapter title, while "bookTitle" is the title of the whole book.
editedBook  This element has no default value.
Content of this field: Description of this field:
Type: Book
The edited book represents a book which was edited by one or more editors, but whose chapters were possibly authored by others. The editors of an edited book should be listed in the "creator" field.
manuscript  This element has no default value.
Content of this field: Description of this field:
Type: Manuscript
The manuscript field provides sub-fields for a full citation of an unpublished manuscript.
report  This element has no default value.
Content of this field: Description of this field:
Type: Report
The report may be self published by the institution or through a publisher. They usually are available by request to the institution or can be purchased from the publisher.
thesis  This element has no default value.
Content of this field: Description of this field:
Type: Thesis
Information about a thesis that has been written as part of a degree requirement and is frequently published in small numbers by the degree awarding institution.
conferenceProceedings  This element has no default value.
Content of this field: Description of this field:
Type: ConferenceProceedings
The published notes, papers, presentations, etc..., of a conference.
personalCommunication  This element has no default value.
Content of this field: Description of this field:
Type: PersonalCommunication
This could be a widely distributed memo, an e-mail, a transcript from a conversation or interview, etc...
map  This element has no default value.
Content of this field: Description of this field:
Type: Map
This element describes the map that is being cited or cataloged, including its geographic coverage and scale.
generic  This element has no default value.
Content of this field: Description of this field:
Type: Generic
This reference type was created for references that do not fit in to the other existing reference types.
audioVisual  This element has no default value.
Content of this field: Description of this field:
Type: AudioVisual
This reference type is meant to cover all forms of audio and visual media, including film, video, broadcast, other electronic media.
presentation  This element has no default value.
Content of this field: Description of this field:
Type: Presentation
An unpublished presentation from a conference, workshop, workgroup, symposium, etc. It will be provided upon request in either in paper and/or electronic form. If the presentation was actually published in a proceedings, use the conferenceProceedings type instead.
journal  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The name of the journal, magazine, newspaper, zine, etc... in which the article was published.
Example(s):
"Ecology"
"New York Times"
"Harper's"
volume  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The volume field is used to describe the volume of the journal in which the article appears.
Example(s):
"Volume I"
issue  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The issue field is used to describe the issue of the journal in which the article appears.
Example(s):
November 2001
pageRange  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The page range field is used for the beginning and ending pages of the journal article that is being documented.
Example(s):
115-122
publisher  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The organization that physically puts together the article and publishes it.
Example(s):
Harper Collins
University Of California Press
publicationPlace  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The location at which the work was published. This is usually the name of the city in which the publishing house produced the work.
Example(s):
New York
London
ISSN  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The ISSN, or International Standard Serial Number that has been assigned to this literature resource.
Example(s):
ISSN 1234-5679
publisher  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The organization that physically puts together the book and publishes it.
Example(s):
Harper Collins
University Of California Press
publicationPlace  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The location at which the work was published. This is usually the name of the city in which the publishing house produced the work.
Example(s):
New York
London
edition  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The edition field is to document the edition of the book that is being described.
Example(s):
Second Edition
volume  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The volume field is used to describe the volume number of a book that is part of a multi-volume series of books.
Example(s):
Volume 2
numberOfVolumes  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
Number of volumes in a collection
Example(s):
12
totalPages  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The total pages field is used to describe the total number of pages in the book that is being described.
Example(s):
628
totalFigures  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
the total figures field is used to describe the total number of figures, diagrams, and plates in the book that is being documented.
Example(s):
45
totalTables  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The total tables field is used to describe the total number of tables that are present in the book that is being documented.
Example(s):
10
ISBN  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The ISBN, or International Standard Book Number that has been assigned to this literature resource.
Example(s):
ISBN 1-861003-11-0
chapterNumber  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The chapter number of the chapter of a book that is being described.
Example(s):
7
editor  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The book editor field is used to document the name of the editor of the book that is being described. The editor may be a person, organization, or a role within an organization.
Example(s):
Tom Christiansen
Institute of Marine Science
Publication Manager
bookTitle  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The book title field is used to document the title of the book that is being described.
Example(s):
War and Peace
pageRange  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The page range field is used to document the beginning and ending pages of a chapter in a book.
Example(s):
25-122
conferenceName  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The name of the conference whose proceedings have been published.
Example(s):
North American Science Symposium
conferenceDate  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The date the conference was held.
Example(s):
November 1-6, 1998
conferenceLocation  This element has no default value.
Content of this field: Description of this field:
Type: rp:Address
The location where the conference was held.
institution  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The institution information field is used to provide contact and address information that would be needed to request an unpublished manuscript
Example(s):
Please see the individual sub-fields for specific examples.
totalPages  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The total pages field is used to describe the total number of pages in the manuscript that is being described.
Example(s):
628
reportNumber  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The report number field is used to describe the unique identification number that has been issued by the report institution for the report being described.
Example(s):
22
publisher  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The organization that physically put together the report and publishes it.
Example(s):
Harper Collins
University Of California Press
publicationPlace  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The location at which the work was published. This is usually the name of the city in which the publishing house produced the work.
Example(s):
New York
London
totalPages  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The total pages field is used to describe the total number of pages in the report that is being described.
Example(s):
628
publisher  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The organization that physically puts together the communication and publishes it.
Example(s):
Harper Collins
University Of California Press
publicationPlace  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The location at which the work was published. This is usually the name of the city in which the publishing house produced the work.
Example(s):
New York
London
communicationType  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The type of personal communication. Could be an email, letter, memo, transcript of conversation either hardcopy or online.
Example(s):
memo
letter
email
recipient  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The person, place or thing the personal communication was sent to.
Example(s):
Schmedley, Joe
jschmedley@lternet.edu
publisher  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The organization that physically puts together the map and publishes it.
Example(s):
Harper Collins
edition  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The edition field is to document the edition of the map that is being described.
Example(s):
Second Edition
geographicCoverage  This element has no default value.
Content of this field: Description of this field:
Type: cov:GeographicCoverage
This element describes the geographic area which the map covers. Could be descriptive text or Cartesian coordinates of the area.
scale  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The Map's scale
Example(s):
1:25,000
publisher  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
Organization which actually distributes the video, film, the broadcaster etc...
Example(s):
LTER Network Office
Public Broadcasting
Pacifica Radio
publicationPlace  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The location at which the work was published. This is usually the name of the city in which the publishing house produced the work.
Example(s):
New York
London
performer  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The performers involved in acting, narrating, or shown in the audio visual production.
Example(s):
Jim Nabors
Sir Lawrence Olivier
ISBN  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The ISBN, or International Standard Book Number that has been assigned to this literature resource.
Example(s):
ISBN 1-861003-11-0
publisher  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The organization which physically puts together the reference and publishes it.
Example(s):
Harper Collins
University Of California Press
publicationPlace  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The location at which the work was published. This is usually the name of the city in which the publishing house produced the work.
Example(s):
New York
London
referenceType  This element has no default value.
Content of this field: Description of this field:
The reference type describes the type of reference this generic type is being used to represent.
Example(s):
zine
film
radio program
volume  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The volume field is used to describe the volume number of a reference that is part of a multi-volume series of references.
Example(s):
Volume 2
numberOfVolumes  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
Number of volumes in a collection
Example(s):
"12"
totalPages  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The total pages field is used to describe the total number of pages in the references that is being described.
Example(s):
628
totalFigures  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The total figures field is used to describe the total number of figures, diagrams, and plates in the reference that is being documented.
Example(s):
45
totalTables  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The total tables field is used to describe the total number of tables that are present in the reference that is being documented.
Example(s):
10
edition  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The edition field is to document the edition of the generic reference type that is being described.
Example(s):
Second Edition
originalPublication  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
Supplemental information about the original publication of the current reference.
Example(s):
Date
Publisher
reprintEdition  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
Reference for current edition that was originally published under a different title.
Example(s):
Stream Research in the LTER Network, 1993
reviewedItem  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
Use for articles, chapters, audio visual, etc. that are critical review of books, cinema, art, or other works.
Example(s):
Structure and Function of an Alpine Ecosystem Niwot Ridge, Colorado Edited by WILLIAM D. BOWMAN and TIMOTHY R. SEASTEDT, University of Colorado, Boulder
ISBN  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The ISBN, or International Standard Book Number that has been assigned to this literature resource.
Example(s):
ISBN 1-861003-11-0
ISSN  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The ISSN, or International Standard Serial Number that has been assigned to this literature resource.
Example(s):
ISSN 1234-5679
degree  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The degree field is used to describe the name or degree level for which the thesis was completed.
Example(s):
Ph.D.
M.S.
Master of Science
institution  This element has no default value.
Content of this field: Description of this field:
Type: rp:ResponsibleParty
The degree institution field is used to name the institution from which the degree was awarded for the thesis being described.
Example(s):
Western Washington University
totalPages  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The total pages field is used to document the number of pages that are present in the thesis that is being described.
Example(s):
356
conferenceName  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The name of the conference at which this presentation was given.
Example(s):
North American Science Symposium
conferenceDate  This element has no default value.
Content of this field: Description of this field:
Type: res:NonEmptyStringType
The date the conference was held.
Example(s):
November 1-6, 1998
conferenceLocation  This element has no default value.
Content of this field: Description of this field:
Type: rp:Address
The location where the conference was held.

Attribute Definitions:

id

Type: res:IDType

Use: optional

system

Type: res:SystemType

Use: optional

scope

Type: res:ScopeType

Use: optional

Default value: document

Complex Type Definitions:

CitationType 
Content of this field: Description of this field:
Elements: Use: How many:
A choice of (
A sequence of (
res:ResourceGroup  
contactoptionalunbounded
A choice of (
articlerequired
OR
bookrequired
OR
chapterrequired
OR
editedBookrequired
OR
manuscriptrequired
OR
reportrequired
OR
thesisrequired
OR
conferenceProceedingsrequired
OR
personalCommunicationrequired
OR
maprequired
OR
genericrequired
OR
audioVisualrequired
OR
presentationrequired
)
)
OR
res:ReferencesGroup  
)
Attributes: Use: Default Value:
idoptional
systemoptional
scopeoptionaldocument
Article 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
journalrequired
volumeoptional
issueoptional
pageRangeoptional
publisheroptional
publicationPlaceoptional
ISSNoptional
)
The article field provides sub-fields for a full citation of an article in a journal or other periodical.
Book 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
publisherrequired
publicationPlaceoptional
editionoptional
volumeoptional
numberOfVolumesoptional
totalPagesoptional
totalFiguresoptional
totalTablesoptional
ISBNoptional
)
The book field provides sub-fields for a full citation of a book.
Chapter 
Content of this field: Description of this field:

Derived from: Book (by xs:extension)

Derived from: Book (by xs:extension)

Elements: Use: How many:
A sequence of (
chapterNumberoptional
editorrequiredunbounded
bookTitlerequired
pageRangeoptional
)
The book chapter allows citation of a single chapter or section of a book. The "creator" for a book chapter are the chapter's authors, while the "editor" is the book editors. Likewise, "title" is the chapter title, while "bookTitle" is the title of the whole book.
ConferenceProceedings 
Content of this field: Description of this field:

Derived from: Chapter (by xs:extension)

Derived from: Chapter (by xs:extension)

Elements: Use: How many:
A sequence of (
conferenceNameoptional
conferenceDateoptional
conferenceLocationoptional
)
The published notes, papers, presentations, etc..., of a conference.
Manuscript 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
institutionrequiredunbounded
totalPagesoptional
)
The manuscript field provides sub-fields for a full citation of an unpublished manuscript.
Report 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
reportNumberoptional
publisheroptional
publicationPlaceoptional
totalPagesoptional
)
The report may be self published by the institution or through a publisher. They usually are available by request to the institution or can be purchased from the publisher.
PersonalCommunication 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
publisheroptional
publicationPlaceoptional
communicationTypeoptional
recipientoptionalunbounded
)
This could be a widely distributed memo, an e-mail, a transcript from a conversation or interview, etc...
Map 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
publisheroptional
editionoptional
geographicCoverageoptionalunbounded
scaleoptional
)
This element describes the map that is being cited or cataloged, including its geographic coverage and scale.
AudioVisual 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
publisherrequired
publicationPlaceoptionalunbounded
performeroptionalunbounded
ISBNoptional
)
This reference type is meant to cover all forms of audio and visual media, including film, video, broadcast, other electronic media.
Generic 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
publisherrequired
publicationPlaceoptional
referenceTypeoptional
volumeoptional
numberOfVolumesoptional
totalPagesoptional
totalFiguresoptional
totalTablesoptional
editionoptional
originalPublicationoptional
reprintEditionoptional
reviewedItemoptional
A choice of (
ISBNrequired
OR
ISSNrequired
)
)
Thesis 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
degreerequired
institutionrequired
totalPagesoptional
)
Information about a thesis that has been written as part of a degree requirement and is frequently published in small numbers by the degree awarding institution.
Presentation 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
conferenceNameoptional
conferenceDateoptional
conferenceLocationoptional
)
An unpublished presentation from a conference, workshop, workgroup, symposium, etc. It will be provided upon request in either in paper and/or electronic form by contacting the authors. If the presentation was actually published in a proceedings, use the conferenceProceedings type instead.

Group Definitions:

Web Contact: jones@nceas.ucsb.edu