Format Considerations

We probably want to stop using Mozilla's RDF support for writing RDF/XML, or at least try to clean it up a little. In order to make our RDF as interoperable as possible, we probably want to write it in an XML-based format that's relatively easy for other implementations to read. We might also want to consider Turtle, a simple, human-readable subset of N3. Simplified RDF/XML would be easier to parse using standard XML parsing libraries; Turtle would be more compact and easier to read. In either case, a number of libraries exist for parsing RDF/XML in various languages.

note from bruce: this looks good, but some of the net-related stuff (IM, Blog, forum post, etc.) could be better covered using ​SIOC. Possibly relevant types for Zotero include:

• sioct:AnnotationSet
• sioct:BookmarkFolder
• sioct:ReadingList
• sioct:BlogPost
• sioct:BoardPost
• sioct:Comment
• sioct:InstantMessage
• sioct:MailMessage
• sioct:MicroblogPost
• sioct:WikiArticle
• sioct:Category
• sioct:Tag

SIOC also has some interesting types relating to commentary.

Keep in mind too that a resource may have more than one type. Also per conversation on the forums with Dan S., I think it might be valuable to talk about how to model a library, and contents.

Item Type Mappings

Zotero Type	RDF Item Type	RDF Subcontainer Type	RDF Container Type
artwork	bibo:Image?
attachment	not in bibo, but probably fine to use something from Zotero namespace
audioRecording	bibo:AudioDocument
bill	bibo:Bill	bibo:Code
blogPost	bibo:Article dc:type sioct:BlogPost	dc:isPartOf bibo:Website dc:type sioct:Weblog
book	bibo:Book/bibo:EditedBook
bookSection	bibo:BookSection	dc:isPartOf bibo:Book
case	bibo:LegalDecision	dc:isPartOf bibo:CourtReporter
computerProgram	?
conferencePaper	bibo:Article	bibo:presentedAt bibo:Conference
dictionaryEntry	bibo:Article	dc:isPartOf bibo:ReferenceSource (Bruce commented in June 2008 that this had been accidentally deleted) dc:type z:Dictionary? ...but we would probably be better off with a bibo:Dictionary subclass of bibo:ReferenceSource
document	bibo:Document
email	bibo:Email
encyclopediaArticle	See dictionaryEntry above
film	bibo:Film
forumPost	bibo:Article(?) dc:type sioct:BoardPost	sioct:MessageBoard
hearing	bibo:Hearing
instantMessage	bibo:PersonalCommunication dc:type sioct:InstantMessage
interview	bibo:Interview
journalArticle	bibo:AcademicArticle	dc:isPartOf bibo:Issue	dc:isPartOf bibo:Journal
letter	bibo:Letter
magazineArticle	bibo:Article	dc:isPartOf bibo:Issue	dc:isPartOf bibo:Magazine
manuscript	bibo:Manuscript
map	bibo:Map
newspaperArticle	bibo:Article	dc:isPartOf bibo:Issue	dc:isPartOf bibo:Newspaper
note	bibo:Note
patent	bibo:Patent
podcast	bibo:AudioDocument dc:type z:Podcast
presentation	bibo:Slideshow?
radioBroadcast	po:Broadcast dcterms:medium po:Radio?
report	bibo:Report
statute	bibo:Statute
thesis	bibo:Thesis
tvBroadcast	po:Broadcast dcterms:medium po:TV?
videoRecording	bibo:AudioVisualDocument
webpage	bibo:Webpage	dc:isPartOf biblio:Website

Field Mappings

The list of base field mappings was generated by the SQLite query

SELECT GROUP_CONCAT(f1.fieldName, '[[BR]]') FROM fields AS f1
LEFT JOIN baseFieldMappings AS b ON (b.fieldID = f1.fieldID)
LEFT JOIN fields AS f2 ON (f2.fieldID = b.baseFieldID)
GROUP BY IFNULL(b.baseFieldID, f1.fieldID)
ORDER BY IFNULL(b.baseFieldID, f1.fieldID);

Properties on the container below are applied to the item itself if no container exists. Properties on the subcontainer below are applied to the container if no subcontainer exists, or the item itself if no subcontainer or container exists.

Zotero Field	RDF Property
url	dcterms:URI
rights	dc:rights
series	dc:title on Series
volume	bibo:volume on Subcontainer
codeVolume	bibo:volume on Container
reporterVolume	bibo:volume on Container
issue	bibo:issue on Subcontainer
edition	bibo:edition
place	address:localityName on dc:publisher foaf:Organization
country	address:countryName on dc:publisher foaf:Organization
publisher institution label studio network company university	foaf:name on dc:publisher foaf:Organization
pages codePages	bibo:pages
firstPage	bibo:pageStart
ISBN	bibo:isbn10/bibo:isbn13
publicationTitle encyclopediaTitle dictionaryTitle websiteTitle forumTitle blogTitle proceedingsTitle bookTitle	dc:title on Container
ISSN	bibo:issn on bibo:Journal
date issueDate dateDecided dateEnacted	dc:date on Subcontainer
section	bibo:section
callNumber	bibo:lccn on Container
archiveLocation	dc:source
distributor	bibo:distributor
extra	z:extra
journalAbbreviation	bibo:shortTitle on Container
DOI	bibo:doi
accessDate	z:accessDate (should be in bibo?)
seriesTitle	dc:title on Series (doesn't seem to be used on any item types concurrently with the series field)
seriesText	dc:description on Series
seriesNumber	bibo:number on Series
code	dc:title on Container
session	?
legislativeBody	?
history	?
reporter	dc:title on Container
court	bibo:court
numberOfVolumes	should be added to bibo
committee	?
assignee	?
priorityNumbers	?
references	dc:references
legalStatus	?
codeNumber	dc:number on Container
patentNumber reportNumber billNumber documentNumber publicLawNumber episodeNumber docketNumber applicationNumber	bibo:number
artworkSize	dc:format?
repository	z:repository
scale	?
meetingName	?
runningTime	po:duration
version	bibo:edition
system	?
conferenceName	dc:title on Container
language	dc:language
programmingLanguage	dc:language (doesn't seem to be used on any item types concurrently with the language field)
abstractNote	dc:description
type reportType videoRecordingType letterType manuscriptType mapType thesisType websiteType audioRecordingType presentationType postType audioFileType
medium artworkMedium interviewMedium	dcterms:medium
title caseName nameOfAct subject	dc:title
shortTitle	bibo:shortTitle
numPages	?