# 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 |  |
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)
Elements: | Use: | How many:

Derived from: Book (by xs:extension)

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)
Elements: | Use: | How many:

Derived from: Chapter (by xs:extension)

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 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 (
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