Bib info: Difference between revisions

From OLPC
Jump to navigation Jump to search
No edit summary
(updatews)
Line 1: Line 1:
This is an ongoing discussion of bibliographic information to recommend every bundle to include for itself and its subelements.

==Elements==
==Elements==


=== Collection information ===
⚫
# TITLE Plain text title of the resource
''for a single collection.''
⚫
# CREATOR Person(s) who created this work. Should change with every revision.*
# SUBJECT This is the same as Category, Should be one of top-level Categories from the [[Sample_library.info_file| Sample Library Info file]]
⚫
# DESCRIPTION Plain text description of the item. May include an abstract, table of contents, etc.
⚫
# PUBLISHER Organization that put this item together, i.e. University of Bombay, OXFAM, Doctors without Borders
⚫
# CONTRIBUTOR Person who contributed this item, should change every time a new individual revises the item
⚫
# DATE YYYY-MM-DD, YYYY-MM, or YYYY
⚫
# TYPE [http://www.iana.org/assignments/media-types/ Basically a MIME Type]
⚫
# FORMAT Format information specific to the type, such as 400 X 500 pixels
# IDENTIFIER ID from external data provider, like a Course ID
⚫
# SOURCE URL to source document
⚫
# LANGUAGE [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1 codes]
⚫
# RELATION Plain text description of how this item may relate to a collection of similar items in the library
⚫
# COVERAGE Period of time, geospatial dimensions, intended age group, etc.
⚫
# RIGHTS URL to license [http://creativecommons.org/licenses/by/3.0/ http://creativecommons.org/licenses/by/3.0/] -- Default


⚫
PUBLISHER Organization that put this item together, i.e. University of Bombay, OXFAM, Doctors without Borders
⚫
Notes:<br />
⚫
COLLECTION-SOURCE URL to source collection
<nowiki>* </nowiki> If you translate, revise, or modify someone else's work, you should change the Creator's title to your own name. Here is a real world scenario why this is important. If I search for "The Black Cat" by Edgar Allan Poe, I want to get back the original work by Edgar Allan Poe that all my friends have read. I should not read to the end of "The Black Cat" to find there is a new ending added by SJ Klein. However, my desire to read Edgar Allan Poe's original work, should not constrict SJ's, or anyone else's, freedom to create a new version. When SJ changes "The Black Cat" he should also change the CREATOR field and make sure the [[Bundle_metadata#acknowledgments_-_required|acknowledgements]] file references Edgar's original work. We could not find a more elegant way to do this without making the format of bib_info much more complex. ---[[User:Berrybw|Bryan Berry]]
DESCRIPTION Plain text description of the item. May include a manifest, history, &c.
RELATION Plain text description of how this item may relate to other collections
RIGHTS Description of license[s] applicable to the collection.
Partly redundant with, but more detailed than, the Acknowledgements file for each bundle/collection.



<nowiki>*</nowiki> The COPYRIGHT_TYPE is designated by a URL to the appropriate license <br />
=== Resource information ===
''for a single work of code, writing, music, design, &c''

RESOURCE-ID An ID unique to this resource; combined with version ID for a unique identifier for this resource-version.
VERSION Version ID
VERSION-HISTORY Sequence of Version IDs

⚫
CREATOR Person(s) who created this work.
⚫
CREATION-DATE YYYY-MM-DD, YYYY-MM, or YYYY
⚫
LAST-MODIFIER Person who contributed this version should change every time a new individual revises the item
LAST-MODIFIED-DATE YYYY-MM-DD, YYYY-MM, or YYYY
REPOSITORY-URL Optional URL to an original or mirror
REPOSITORY-ID Optional repository ID, with a description (such as a Course ID; often redundant with part of repository-url)
SOURCES* Other resources from which this resource is significantly derived. Should include full resource IDs where posible.
REFERENCES A bibliography of references and sources for quotes, notes, and information.
⚫
RELATION Plain text description of how this item may relate to other resources or collections

⚫
TITLE Plain text title of the resource
SUBJECT Similar to the Category of a [[sample library.info file|bundle info file]].
⚫
DESCRIPTION Plain text description of the item. May include an abstract, table of contents, etc.
⚫
COVERAGE Period of time, geospatial dimensions, intended age group, etc.

⚫
TYPE [http://www.iana.org/assignments/media-types/ ... basically a MIME Type]
⚫
FORMAT Format information specific to the type, such as 400 X 500 pixels
⚫
LANGUAGE [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO 639-1 codes]
⚫
RIGHTS URL to license [http://creativecommons.org/licenses/by/3.0/ http://creativecommons.org/licenses/by/3.0/] -- Default
NB: this is partly redundant with, but more granular than, the Acknowledgements file for each bundle/collection.

⚫
'''Notes''':<br />
* If you translate, revise, or modify someone else's work, you should always update the version, version-history, and last-modifier fields. If the change is dramatic enough, you may want to change the Creator and Creation date, and add the original to the list of Sources.
* COPYRIGHT_TYPE can be designated by a URL to the appropriate license; but should also link to a local description of the license where possible (and especially where required).
* http://creativecommons.org/licenses/by/3.0/ -- Default
* http://creativecommons.org/licenses/by/3.0/ -- Default
Line 27: Line 51:
* http://creativecommons.org/licenses/by-sa/3.0/
* http://creativecommons.org/licenses/by-sa/3.0/



==bib_info File Format==
== bib_info File Format ==


<blockquote>
<blockquote>
Line 52: Line 77:
</blockquote>
</blockquote>


=== XML format implementation ===
Here is a sample [http://ds.lahai.com/ole/bib_info.xml bib_info.xml file]
Here is a sample [http://ds.lahai.com/ole/bib_info.xml bib_info.xml file]


Why use XML? The point of bib_info.xml is to make it easy for large-scale repositories like [http://www.dspace.org DSpace], [http://www.fedora-commons.org Fedora Repository Server], [http://globe.edna.edu.au GLOBE], and [http://www.ariadne-eu.org/ ARIADNE] to serve up .xo bundles. For this reason we chose a simple standard -- Dublin Core encoded in XML -- that plays well with others rather than create our own.
Why use XML? The point of bib_info.xml is to make it easy for large-scale repositories like [http://www.dspace.org DSpace], [http://www.fedora-commons.org Fedora Repository Server], [http://globe.edna.edu.au GLOBE], and [http://www.ariadne-eu.org/ ARIADNE] to serve up .xo bundles. For this reason we chose a simple standard -- Dublin Core encoded in XML -- that plays well with others rather than create our own.


=== External links ===
Here are some good links on Metadata and Controlled Vocabularies
Here are some good links on Metadata and Controlled Vocabularies
* Wikipedia [http://en.wikipedia.org/wiki/Controlled_vocabulary Controlled Vocabularies]
* Wikipedia [http://en.wikipedia.org/wiki/Controlled_vocabulary Controlled Vocabularies]
Line 61: Line 88:
* Cory Doctorow's [http://www.well.com/~doctorow/metacrap.htm MetaCrap]
* Cory Doctorow's [http://www.well.com/~doctorow/metacrap.htm MetaCrap]


Basically, a Controlled Vocabulary is a set of standard values This is pretty important for the Copyright Type, language, and country. Less so for the other elements.
Basically, a Controlled Vocabulary is a set of standard values. This can be useful for the Copyright Type, language, and country; less so for the other elements.




Revision as of 18:20, 31 January 2008

This is an ongoing discussion of bibliographic information to recommend every bundle to include for itself and its subelements.

Elements

Collection information

for a single collection. 

PUBLISHER      Organization that put this item together, i.e. University of Bombay, OXFAM, Doctors without Borders 
COLLECTION-SOURCE   URL to source collection
DESCRIPTION    Plain text description of the item. May include a manifest, history, &c. 
RELATION       Plain text description of how this item may relate to other collections
RIGHTS         Description of license[s] applicable to the collection.
               Partly redundant with, but more detailed than, the Acknowledgements file for each bundle/collection.


Resource information

for a single work of code, writing, music, design, &c 

RESOURCE-ID     An ID unique to this resource; combined with version ID for a unique identifier for this resource-version.
VERSION         Version ID
VERSION-HISTORY Sequence of Version IDs

CREATOR         Person(s) who created this work. 
CREATION-DATE   YYYY-MM-DD, YYYY-MM, or YYYY   
LAST-MODIFIER   Person who contributed this version should change every time a new individual revises the item         
LAST-MODIFIED-DATE  YYYY-MM-DD, YYYY-MM, or YYYY 
REPOSITORY-URL  Optional URL to an original or mirror  
REPOSITORY-ID   Optional repository ID, with a description (such as a Course ID; often redundant with part of repository-url)
SOURCES*        Other resources from which this resource is significantly derived.  Should include full resource IDs where posible.
REFERENCES      A bibliography of references and sources for quotes, notes, and information.
RELATION        Plain text description of how this item may relate to other resources or collections  

TITLE           Plain text title of the resource
SUBJECT         Similar to the Category of a bundle info file. 
DESCRIPTION     Plain text description of the item. May include an abstract, table of contents, etc.   
COVERAGE        Period of time, geospatial dimensions, intended age group, etc.  

TYPE            ... basically a MIME Type 
FORMAT          Format information specific to the type, such as 400 X 500 pixels
LANGUAGE        ISO 639-1 codes
RIGHTS          URL to license http://creativecommons.org/licenses/by/3.0/ -- Default 
                NB: this is partly redundant with, but more granular than, the Acknowledgements file for each bundle/collection.

Notes:

  • If you translate, revise, or modify someone else's work, you should always update the version, version-history, and last-modifier fields. If the change is dramatic enough, you may want to change the Creator and Creation date, and add the original to the list of Sources.
  • COPYRIGHT_TYPE can be designated by a URL to the appropriate license; but should also link to a local description of the license where possible (and especially where required).


bib_info File Format

<?xml version="1.0"?>
<dc xmlns:dc="http://dublincore.org/schemas/xmls/simpledc20021212.xsd">
<dc:title>Coliseum in Rome</dc:title>
<dc:creator>Thornton Staples</dc:creator>
<dc:subject>images</dc:subject>
<dc:description>Image of Coliseum in Rome</dc:description>
<dc:publisher>University of Virginia Library</dc:publisher>
<dc:contributor>Bryan Berry</dc:contributor>
<dc:date>2008-01-30</dc:date>
<dc:type>image</dc:type>
<dc:format>image/jpeg</dc:format>
<dc:identifier>ISBN:0385424728</dc:identifier>
<dc:source>http://www.virginia.edu/pictures/</dc:source>
<dc:language>en</dc:language>
<dc:relation>University of Virginia Antiquities Collection</dc:relation>
<dc:coverage>50-100 AD</dc:coverage>
<dc:rights>http://creativecommons.org/licenses/by/3.0/</dc:rights>
</dc>

XML format implementation

Here is a sample bib_info.xml file

Why use XML? The point of bib_info.xml is to make it easy for large-scale repositories like DSpace, Fedora Repository Server, GLOBE, and ARIADNE to serve up .xo bundles. For this reason we chose a simple standard -- Dublin Core encoded in XML -- that plays well with others rather than create our own.

External links

Here are some good links on Metadata and Controlled Vocabularies

Basically, a Controlled Vocabulary is a set of standard values. This can be useful for the Copyright Type, language, and country; less so for the other elements.

Retrieved from "http://wiki.laptop.org/mediawiki/index.php?title=Bib_info&oldid=104132"