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