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 subelements 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. Ususally, the first author serves as the contact for a citation resource, e.g., a reprint request. In some cases, an altnernate 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 desribes 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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
The edition field is to document the edition of the mapthat 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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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: xs:string
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    
contact optional unbounded
A choice of (
article required
OR
book required
OR
chapter required
OR
editedBook required
OR
manuscript required
OR
report required
OR
thesis required
OR
conferenceProceedings required
OR
personalCommunication required
OR
map required
OR
generic required
OR
audioVisual required
OR
presentation required
)
)
OR
res:ReferencesGroup    
)
Attributes: Use: Default Value:
id optional
system optional
scope optional document
Article 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
journal required
volume optional
issue optional
pageRange optional
publisher optional
publicationPlace optional
ISSN optional
)
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 (
publisher required
publicationPlace optional
edition optional
volume optional
numberOfVolumes optional
totalPages optional
totalFigures optional
totalTables optional
ISBN optional
)
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 (
chapterNumber optional
editor required unbounded
bookTitle required
pageRange optional
)
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 (
conferenceName optional
conferenceDate optional
conferenceLocation optional
)
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 (
institution required unbounded
totalPages optional
)
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 (
reportNumber optional
publisher optional
publicationPlace optional
totalPages optional
)
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 (
publisher optional
publicationPlace optional
communicationType optional
recipient optional unbounded
)
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 (
publisher optional
edition optional
geographicCoverage optional unbounded
scale optional
)
This element desribes 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 (
publisher required
publicationPlace optional unbounded
performer optional unbounded
ISBN optional
)
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 (
publisher required
publicationPlace optional
referenceType optional
volume optional
numberOfVolumes optional
totalPages optional
totalFigures optional
totalTables optional
edition optional
originalPublication optional
reprintEdition optional
reviewedItem optional
A choice of (
ISBN required
OR
ISSN required
)
)
Thesis 
Content of this field: Description of this field:
Elements: Use: How many:
A sequence of (
degree required
institution required
totalPages optional
)
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 (
conferenceName optional
conferenceDate optional
conferenceLocation optional
)
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