https://wiki.collex.org/api.php?action=feedcontributions&user=Mandellc&feedformat=atomARC Wiki - User contributions [en]2024-03-29T14:38:26ZUser contributionsMediaWiki 1.32.3https://wiki.collex.org/index.php?title=Submitting_RDF&diff=438Submitting RDF2017-08-18T18:40:22Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- circa 1450 to 1700, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List (available at <[http://www.loc.gov/standards/iso639-2/php/code_list.php http://www.loc.gov/standards/iso639-2/php/code_list.php]>). The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; the other federations do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=437Submitting RDF2017-07-12T18:29:59Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- circa 1450 to 1700, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List (available at <[http://www.loc.gov/standards/iso639-2/php/code_list.php http://www.loc.gov/standards/iso639-2/php/code_list.php]>). The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; the other federations do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=436Submitting RDF2017-07-04T16:40:47Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- circa 1485 to 1700, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List (available at <[http://www.loc.gov/standards/iso639-2/php/code_list.php http://www.loc.gov/standards/iso639-2/php/code_list.php]>). The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; the other federations do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=435Submitting RDF2017-06-29T00:57:41Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List (available at <[http://www.loc.gov/standards/iso639-2/php/code_list.php http://www.loc.gov/standards/iso639-2/php/code_list.php]>). The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; the other federations do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=434Submitting RDF2017-06-29T00:57:01Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List (available at [http://www.loc.gov/standards/iso639-2/php/code_list.php <http://www.loc.gov/standards/iso639-2/php/code_list.php>]). The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; the other federations do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=433Submitting RDF2017-06-29T00:53:42Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List (available at [http://www.loc.gov/standards/iso639-2/php/code_list.php <http://www.loc.gov/standards/iso639-2/php/code_list.php>]). The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=432Submitting RDF2017-06-29T00:53:09Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List (available at [http://www.loc.gov/standards/iso639-2/php/code_list.php | http://www.loc.gov/standards/iso639-2/php/code_list.php]). The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=431Submitting RDF2017-06-29T00:52:23Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List (available at [[http://www.loc.gov/standards/iso639-2/php/code_list.php | http://www.loc.gov/standards/iso639-2/php/code_list.php]]. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=430Submitting RDF2017-06-15T04:58:59Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
== Element Definitions ==<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=429Submitting RDF2017-06-15T04:57:56Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=428Submitting RDF2017-06-15T04:57:07Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<dc:type>|<dc:type>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|-<br />
| <b>Elements Still Usable but Not Recommended</b><br />
|-<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-}<br />
<br />
<br />
<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=427Submitting RDF2017-06-15T04:54:02Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=426Submitting RDF2017-06-15T04:53:04Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<dc:type>|<dc:type>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|-<br />
| <b>Elements Still Usable but Not Recommended</b><br />
|-<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-}<br />
<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=425Submitting RDF2017-06-15T04:51:43Z<p>Mandellc: /* RDF Specification */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<dc:type>|<dc:type>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|-<br />
| <b>Elements Still Usable but Not Recommended</b><br />
|-<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=424Submitting RDF2017-06-07T18:08:58Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA ([http://www.mesa-medieval.org])<br />
*REKN ([http://www.rekn.org])<br />
*NEAR (forthcoming)<br />
*18thConnect ([http://www.18thconnect.org])<br />
*NINES ([http://www.nines.org])<br />
*ModNets ([http://www.modnets.org])<br />
*SiRO ([http://www.studiesinradicalism.org])<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=423Submitting RDF2017-06-07T18:05:41Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the legal values of this are <br />
*MESA<br />
*REKN<br />
*NEAR<br />
*18thConnect<br />
*NINES<br />
*ModNets<br />
*SiRO<br />
*estc<br />
*GLA<br />
The federation to which the object belongs is the scholarly community that peer-reviewed your resource. Notice that an object can belong to more than one federation if accepted into one federation. Add federations to the original one based upon dates and the requirements of that scholarly community:<br />
*MESA -- medieval era; must be peer-reviewed by MESA<br />
*REKN -- 1485 to 1660, inclusive; accepts all scholarly community's peer review decisions;<br />
*NEAR -- American Literature, all dates; must be peer-reviewed by NEAR<br />
*18thConnect -- 1660-1830, inclusive; accepts all scholarly community's peer review decisions;<br />
*NINES -- 1785-1920, inclusive; accepts all scholarly community's peer review decisions;<br />
*ModNets -- 1900 on, inclusive; accepts all scholarly community's peer review decisions;<br />
*SiRO -- Studies in Radicalism; must be peer-reviewed by SiRO<br />
*estc -- English Short Title Catalog; closed<br />
*GLA -- Great Lakes Project; closed<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=422Submitting RDF2017-05-23T15:37:10Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2017''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Main_Page&diff=421Main Page2017-05-15T15:16:22Z<p>Mandellc: /* Metadata specifications */</p>
<hr />
<div>== ARC ==<br />
* [[MESA]]<br />
* [[REKn]]<br />
* [[18thConnect]]<br />
* [[NINES]]<br />
* [[ModNets]]<br />
* [[CWRC]]<br />
* [[Great Lakes]]<br />
* [[MuSO]]<br />
* [[NEAR]]<br />
* [[SiRO]]<br />
<br />
== Metadata_specifications ==<br />
* [[Principles for Metadata Reform]]<br />
* [[Submitting RDF]]<br />
* [[RDF samples]]<br />
* [[RDF XSLT|XSLT samples]]<br />
<br />
==MESA==<br />
* [[MESA Metadata Information]]<br />
<br />
== NINES ==<br />
* [[Preliminary Technical Checklist]]<br />
* [[General Content Sources]]<br />
* [[Steering Committee Responsibilities]]<br />
* [[Draft of FAQ for NINES Submissions]]<br />
* [[Grants in Progress]]<br />
* [[Adminstrative]]<br />
* [[Peer Review and Outreach]]<br />
* [[NINES Fellows]]<br />
<br />
== Collex ==<br />
* [[Collex]]: basic description and design <br />
* [[Collex Deployment]]: An explanation for how nines.org and staging.nines.org are deployed<br />
* [[Collex Getting Started | Getting started with Collex]]: A quick-start guide for new installations<br />
* [[GeneralizingCollex | Generalizing Collex]]: How to skin Collex for your installation<br />
* [[Indexing Tools]]: Tools and instructions for indexing documents so that they show up in Search<br />
<br />
== Juxta ==<br />
<br />
[[Juxta Process Workflow]]<br />
<br />
[[Juxta Source Overview]]<br />
<br />
== Rossetti Archive ==<br />
[[Archive basics]]<br />
=== Editorial and Imaging ===<br />
Image Production Record Database [http://www.iath.virginia.edu/jjm2f-bin/imagedata.cgi (IPROD)]<br><br />
[[Imaging Procedures]]<br><br />
[[Tagging Resources]]<br><br />
[[House Style]]<br><br />
[[Tags Defined]]: the big list<br><br />
[[Unicode Entity References]]: special characters<br><br />
[[Proofing Checklists]] for RADs, RAPs, and RAWs<br />
<br />
=== Technical ===<br />
[[Unix commands]]: navigate, search, check/change permissions<br><br />
[[hardware|In-house Hardware]]: Algernon, The Yellow Machine, Alexa<br><br />
[[scripts|Documentation for scripts]]: how to produce the archive<br><br />
[[RDF Production]]</div>Mandellchttps://wiki.collex.org/index.php?title=Main_Page&diff=420Main Page2017-05-15T15:14:39Z<p>Mandellc: /* ARC */</p>
<hr />
<div>== ARC ==<br />
* [[MESA]]<br />
* [[REKn]]<br />
* [[18thConnect]]<br />
* [[NINES]]<br />
* [[ModNets]]<br />
* [[CWRC]]<br />
* [[Great Lakes]]<br />
* [[MuSO]]<br />
* [[NEAR]]<br />
* [[SiRO]]<br />
<br />
== Metadata specifications ==<br />
* [[Principles for Metadata Reform]]<br />
* [[Submitting RDF]]<br />
* [[RDF samples]]<br />
* [[RDF XSLT|XSLT samples]]<br />
<br />
==MESA==<br />
* [[MESA Metadata Information]]<br />
<br />
== NINES ==<br />
* [[Preliminary Technical Checklist]]<br />
* [[General Content Sources]]<br />
* [[Steering Committee Responsibilities]]<br />
* [[Draft of FAQ for NINES Submissions]]<br />
* [[Grants in Progress]]<br />
* [[Adminstrative]]<br />
* [[Peer Review and Outreach]]<br />
* [[NINES Fellows]]<br />
<br />
== Collex ==<br />
* [[Collex]]: basic description and design <br />
* [[Collex Deployment]]: An explanation for how nines.org and staging.nines.org are deployed<br />
* [[Collex Getting Started | Getting started with Collex]]: A quick-start guide for new installations<br />
* [[GeneralizingCollex | Generalizing Collex]]: How to skin Collex for your installation<br />
* [[Indexing Tools]]: Tools and instructions for indexing documents so that they show up in Search<br />
<br />
== Juxta ==<br />
<br />
[[Juxta Process Workflow]]<br />
<br />
[[Juxta Source Overview]]<br />
<br />
== Rossetti Archive ==<br />
[[Archive basics]]<br />
=== Editorial and Imaging ===<br />
Image Production Record Database [http://www.iath.virginia.edu/jjm2f-bin/imagedata.cgi (IPROD)]<br><br />
[[Imaging Procedures]]<br><br />
[[Tagging Resources]]<br><br />
[[House Style]]<br><br />
[[Tags Defined]]: the big list<br><br />
[[Unicode Entity References]]: special characters<br><br />
[[Proofing Checklists]] for RADs, RAPs, and RAWs<br />
<br />
=== Technical ===<br />
[[Unix commands]]: navigate, search, check/change permissions<br><br />
[[hardware|In-house Hardware]]: Algernon, The Yellow Machine, Alexa<br><br />
[[scripts|Documentation for scripts]]: how to produce the archive<br><br />
[[RDF Production]]</div>Mandellchttps://wiki.collex.org/index.php?title=Main_Page&diff=419Main Page2017-05-15T15:14:11Z<p>Mandellc: /* Metadata specifications */</p>
<hr />
<div>== ARC ==<br />
* [[MESA]]<br />
* [[REKn]]<br />
* [[18thConnect]]<br />
* [[NINES]]<br />
* [[ModNets]]<br />
* [[CWRC]]<br />
* [[Great Lakes]]<br />
* [[MuSO]]<br />
* [[NEAR]]<br />
* [[SiRO]]<br />
<br />
{{metadata}}<br />
{{metadata}}<br />
== Metadata specifications ==<br />
* [[Principles for Metadata Reform]]<br />
* [[Submitting RDF]]<br />
* [[RDF samples]]<br />
* [[RDF XSLT|XSLT samples]]<br />
<br />
==MESA==<br />
* [[MESA Metadata Information]]<br />
<br />
== NINES ==<br />
* [[Preliminary Technical Checklist]]<br />
* [[General Content Sources]]<br />
* [[Steering Committee Responsibilities]]<br />
* [[Draft of FAQ for NINES Submissions]]<br />
* [[Grants in Progress]]<br />
* [[Adminstrative]]<br />
* [[Peer Review and Outreach]]<br />
* [[NINES Fellows]]<br />
<br />
== Collex ==<br />
* [[Collex]]: basic description and design <br />
* [[Collex Deployment]]: An explanation for how nines.org and staging.nines.org are deployed<br />
* [[Collex Getting Started | Getting started with Collex]]: A quick-start guide for new installations<br />
* [[GeneralizingCollex | Generalizing Collex]]: How to skin Collex for your installation<br />
* [[Indexing Tools]]: Tools and instructions for indexing documents so that they show up in Search<br />
<br />
== Juxta ==<br />
<br />
[[Juxta Process Workflow]]<br />
<br />
[[Juxta Source Overview]]<br />
<br />
== Rossetti Archive ==<br />
[[Archive basics]]<br />
=== Editorial and Imaging ===<br />
Image Production Record Database [http://www.iath.virginia.edu/jjm2f-bin/imagedata.cgi (IPROD)]<br><br />
[[Imaging Procedures]]<br><br />
[[Tagging Resources]]<br><br />
[[House Style]]<br><br />
[[Tags Defined]]: the big list<br><br />
[[Unicode Entity References]]: special characters<br><br />
[[Proofing Checklists]] for RADs, RAPs, and RAWs<br />
<br />
=== Technical ===<br />
[[Unix commands]]: navigate, search, check/change permissions<br><br />
[[hardware|In-house Hardware]]: Algernon, The Yellow Machine, Alexa<br><br />
[[scripts|Documentation for scripts]]: how to produce the archive<br><br />
[[RDF Production]]</div>Mandellchttps://wiki.collex.org/index.php?title=Main_Page&diff=418Main Page2017-05-15T15:13:27Z<p>Mandellc: /* Metadata specifications */</p>
<hr />
<div>== ARC ==<br />
* [[MESA]]<br />
* [[REKn]]<br />
* [[18thConnect]]<br />
* [[NINES]]<br />
* [[ModNets]]<br />
* [[CWRC]]<br />
* [[Great Lakes]]<br />
* [[MuSO]]<br />
* [[NEAR]]<br />
* [[SiRO]]<br />
<br />
{{metadata}}<br />
== Metadata specifications ==<br />
* [[Principles for Metadata Reform]]<br />
* [[Submitting RDF]]<br />
* [[RDF samples]]<br />
* [[RDF XSLT|XSLT samples]]<br />
<br />
==MESA==<br />
* [[MESA Metadata Information]]<br />
<br />
== NINES ==<br />
* [[Preliminary Technical Checklist]]<br />
* [[General Content Sources]]<br />
* [[Steering Committee Responsibilities]]<br />
* [[Draft of FAQ for NINES Submissions]]<br />
* [[Grants in Progress]]<br />
* [[Adminstrative]]<br />
* [[Peer Review and Outreach]]<br />
* [[NINES Fellows]]<br />
<br />
== Collex ==<br />
* [[Collex]]: basic description and design <br />
* [[Collex Deployment]]: An explanation for how nines.org and staging.nines.org are deployed<br />
* [[Collex Getting Started | Getting started with Collex]]: A quick-start guide for new installations<br />
* [[GeneralizingCollex | Generalizing Collex]]: How to skin Collex for your installation<br />
* [[Indexing Tools]]: Tools and instructions for indexing documents so that they show up in Search<br />
<br />
== Juxta ==<br />
<br />
[[Juxta Process Workflow]]<br />
<br />
[[Juxta Source Overview]]<br />
<br />
== Rossetti Archive ==<br />
[[Archive basics]]<br />
=== Editorial and Imaging ===<br />
Image Production Record Database [http://www.iath.virginia.edu/jjm2f-bin/imagedata.cgi (IPROD)]<br><br />
[[Imaging Procedures]]<br><br />
[[Tagging Resources]]<br><br />
[[House Style]]<br><br />
[[Tags Defined]]: the big list<br><br />
[[Unicode Entity References]]: special characters<br><br />
[[Proofing Checklists]] for RADs, RAPs, and RAWs<br />
<br />
=== Technical ===<br />
[[Unix commands]]: navigate, search, check/change permissions<br><br />
[[hardware|In-house Hardware]]: Algernon, The Yellow Machine, Alexa<br><br />
[[scripts|Documentation for scripts]]: how to produce the archive<br><br />
[[RDF Production]]</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=417Submitting RDF2017-05-01T16:50:15Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2016''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source and provenance, the latter information appearing in the description.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:dateofedition>====<br />
:The element allows you to record the date that the digital surrogate was created if your project records such dates.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=416Submitting RDF2017-05-01T16:44:41Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2016''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use '''ANY''' -- new rule as of April 2017 -- of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=415Submitting RDF2017-05-01T16:43:47Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2016''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also ][#<collex:dateofedition>|<collex:dateofedition>][ and [[#<collex:reviewdate>|<collex:reviewdate>]] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=414Submitting RDF2017-05-01T16:43:05Z<p>Mandellc: /* RDF Specification */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2016''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<dc:coverage>|<dc:coverage>]]<br />
|[[#<collex:dateofedition>|<collex:dateofedition>]]<br />
|-<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|[[#<dc:description>|<dc:description>]]<br />
|-<br />
|[[#<role:***>|<i>roles list expanded</i>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also [#<collex:dateofedition>|<collex:dateofedition>] and [#<collex:reviewdate>|<collex:reviewdate>] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=413Submitting RDF2017-05-01T16:40:06Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2016''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
:''See also [#<collex:dateofedition>|<collex:dateofedition>] and [#<collex:reviewdate>|<collex:reviewdate>] below.''<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=412Submitting RDF2017-04-27T16:44:16Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
''This Metadata Scheme was revised 27 April 2016''.<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=411Submitting RDF2017-04-27T16:41:59Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 27 April 2016. ==<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Advertisement<br />
| Animation<br />
| Bibliography<br />
| Catalog<br />
|-<br />
| Chronology<br />
| Citation<br />
| Collection<br />
| Correspondence<br />
|-<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
| Essay<br />
|-<br />
| Fiction<br />
| Film, Documentary<br />
| Film, Experimental<br />
| Film, Narrative<br />
|-<br />
| Film, Other<br />
| Historiography<br />
| Interview<br />
| Life Writing<br />
|-<br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Work<br />
|-<br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Performance<br />
|-<br />
| Philosophy<br />
| Photograph<br />
| Political Statement<br />
| Poetry<br />
|-<br />
| Religion<br />
| Reference Works<br />
| Review<br />
| Scripture<br />
|-<br />
| Sermon<br />
| Speech<br />
| Translation<br />
| Travel Writing<br />
|-<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=410Submitting RDF2017-04-27T16:32:56Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 27 April 2016. ==<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <br />
| <b>Available</b><br/><b>Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics, Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=409Submitting RDF2017-04-27T16:25:57Z<p>Mandellc: /* */</p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 27 April 2016. ==<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
| Art Studies<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Dance Studies<br />
| Economics<br />
| Education<br />
|- <br />
| Ethnic Studies<br />
| Film Studies<br />
| Gender Studies<br />
| Geography<br />
| History<br />
|- <br />
| Labor Studies<br />
| Law<br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
|- <br />
| Music Studies<br />
| Philosophy<br />
| Political Science<br />
| Religious Studies<br />
| Science<br />
|-<br />
| Sociology<br />
| Sound Studies<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=408Submitting RDF2017-04-27T15:30:54Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 27 April 2016. ==<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Dataset<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
| Notated Music<br />
|- <br />
| Page Proofs<br />
| Pamphlet<br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
|- <br />
| Sheet<br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=407Submitting RDF2017-04-26T19:28:37Z<p>Mandellc: /* <dc:description */</p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 24 April 2016. ==<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description>====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=406Submitting RDF2017-04-26T19:28:09Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 24 April 2016. ==<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:description====<br />
:This element is designed for adding descriptive information about the resource or the metadata record (e.g., provenance, manuscript details, metadata uncertainties, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:coverage>====<br />
:This element allows you to declare geographical locations. The vocabulary for these locations should be derived from the Getty Thesaurus of Geographical Names Online < http://www.getty.edu/research/tools/vocabulary/tgn/index.html>. The only place information in the metadata record should be related to the source.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:reviewdate>====<br />
:This element marks the date of peer review (really, the date of ingestion into the ARC Catalog, which marks the end of the peer review process). If a project re-submits rdf, the project should be reviewed again by the node, and a new peer-review (ingestion) date added. The point of this element is to let people know how recently this object in our catalog has been updated by peer-reviewing and ingesting digital scholarship.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=405Submitting RDF2017-04-25T17:50:55Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 24 April 2016. ==<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|-<br />
| <b>Elements Added April 2017</b><br />
|-<br />
|width=250|[[#<role:***>|<i>roles list expanded</i>]]<br />
|[[#<dc:coverage>|<dc:coverage>]]<br />
|-<br />
|[[#<dc:description>|<dc:description>]]<br />
|[[#<collex:reviewdate>|<collex:reviewdate>]]<br />
|-<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. You may use any of the roles contained in the list of the LOC MARC relator codes ([http://www.loc.gov/marc/relators/relaterm.html]). <br />
<br />
: possible element names include <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=404Submitting RDF2017-04-24T18:59:58Z<p>Mandellc: /* This Metadata Scheme was revised 24 April 2016. */</p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 24 April 2016. ==<br />
<br />
<br />
== Description of ARC RDF ==<br />
<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. Though this list is drawn from the LOC relator codes<br />
([http://www.loc.gov/marc/relators/relaterm.html]), it is hard-coded into the Collex indexing software; if ARC nodes want to use<br />
additional relator codes such as RCD (Recordist) or DRT (Director), the ARC Steering Committee would need to add them to the set of terms allowed in Collex.<br />
<br />
: possible element names include <code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=403Submitting RDF2017-04-24T18:58:55Z<p>Mandellc: </p>
<hr />
<div><br />
<br />
== This Metadata Scheme was revised 24 April 2016. ==<br />
<br />
RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissions l this page] at NINES.<br />
<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"/><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"/><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object. This id should be meaningful to the home project. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis". This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "podunk_up_journal1"). You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title or name of the object. The distinction between titles and alternative titles is application-specific. In Collex search results, the alternative title displays below the<br />
main title, in plain (non-hyperlinked) text.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed in some nodes, but is displayed in the results for others. It may be applied to tags and for future mining of data from ARC Partners sites. MESA also adds a requirement that the term come from a recognized or approved-by-MESA authority list. See the MESA metadata standards for more info:<br />
[http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:subject.3E] .<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individuals or organizations involved in the creation of the object. Though this list is drawn from the LOC relator codes<br />
([http://www.loc.gov/marc/relators/relaterm.html]), it is hard-coded into the Collex indexing software; if ARC nodes want to use<br />
additional relator codes such as RCD (Recordist) or DRT (Director), the ARC Steering Committee would need to add them to the set of terms allowed in Collex.<br />
<br />
: possible element names include <code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/] authorities list. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object. This optional element is used to specify the full-sized image that may appear in a pop-up box when a user clicks on the object thumbnail in a list of search results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object being described. If this tag<br />
is not present, the display will default to the archive or node thumbnail. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "true" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content. In some cases, mostly for resources like victbib, this full text was NOT the full text of the object in question, rather it was project-specific text (like an annotated bibliography). In other cases it could be the full text of a poem, for example, for which there is no online plain text to harvest. If you intend to provide a link to full text on the web for indexing, a "true" value is required. The value is not case-sensitive.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource using the language codes from the ISO 639-2 Language Code List. The content of dc:language may be either from the first column (ISO 639-2 Code), the third column (English name of Language), or the fourth column (French name of Language). Please note that currently only the MESA search interface allows the user to limit a search by language; NINES and 18thConnect do not have this capability. An example appears at [http://wiki.collex.org/index.php/MESA_Metadata_Information#.3Cdc:language.3E].<br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=369Submitting RDF2013-08-22T09:22:32Z<p>Mandellc: /* */</p>
<hr />
<div>RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissionsl this page] at NINES.<br />
<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis." This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "PodunkUP_journal1.") You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title of the object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed, but may be applied to tags and for future mining of data from ARC Partners sites.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individual involved in the creation of the object<br />
: possible element names include <code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/ authorities list]. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the archive's logo. In the absence of that thumbnail, we use as a default node logos. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "false" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource. Please note whether the language is '''English''', '''French''', '''German''', or '''Italian'''. <br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=368Submitting RDF2013-08-22T09:19:29Z<p>Mandellc: /* */</p>
<hr />
<div>RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissionsl this page] at NINES.<br />
<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis." This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "PodunkUP_journal1.") You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title of the object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed, but may be applied to tags and for future mining of data from ARC Partners sites.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individual involved in the creation of the object<br />
: possible element names include <code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/ authorities list]. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>), or may contain a <code><nowiki><collex:date></nowiki></code> element inside, its usage described in this entry and the next one.<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "false" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource. Please note whether the language is '''English''', '''French''', '''German''', or '''Italian'''. <br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=367Submitting RDF2013-08-22T09:17:44Z<p>Mandellc: /* */</p>
<hr />
<div>RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissionsl this page] at NINES.<br />
<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis." This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "PodunkUP_journal1.") You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title of the object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed, but may be applied to tags and for future mining of data from ARC Partners sites.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individual involved in the creation of the object<br />
: possible element names include <code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/ authorities list]. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year AND NOTHING ELSE (<code><nowiki><dc:date>1959</dc:date></nowiki></code>, or may contain a <code><nowiki><collex:date></nowiki></code> element<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "false" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource. Please note whether the language is '''English''', '''French''', '''German''', or '''Italian'''. <br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellchttps://wiki.collex.org/index.php?title=Submitting_RDF&diff=366Submitting RDF2013-08-22T09:16:30Z<p>Mandellc: /* */</p>
<hr />
<div>RDF is the metadata format that contributors use to make their resources available for use within NINES, 18thConnect and MESA. With RDF, contributors describe each of their resources in general terms that allow those resources to be categorized and searched through COLLEX.<br />
<br />
For more basic information about RDF and the principles of generating it for your project, see [http://www.nines.org/about/scholarship/submissionsl this page] at NINES.<br />
<br />
<br />
== Samples ==<br />
<br />
Below is a generic, mock RDF file. We have also made several [[RDF samples|RDF samples]] available, along with samples of [[RDF XSLT|XSLT]] for transforming XML source files into RDF metadata.<br />
<br />
=== RDF Mock-up===<br />
<pre><?xml version="1.0" encoding="utf-8"?><br />
<rdf:RDF<br />
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"<br />
xmlns:dc="http://purl.org/dc/elements/1.1/"<br />
xmlns:dcterms="http://purl.org/dc/terms/"<br />
xmlns:collex="http://www.collex.org/schema#"<br />
xmlns:ra="http://www.rossettiarchive.org/schema#"<br />
xmlns:rdfs="http://www.w3.org/2000/01/rdf-schema#"<br />
xmlns:role="http://www.loc.gov/loc.terms/relators/"><br />
<br />
<YOUR:NAMESPACE rdf:about="UNIQUE_OBJECT_ID"><br />
<br />
<!-- choose your federation: multiples are also allowed. --><br />
<br />
<collex:federation>NINES</collex:federation><br />
<collex:federation>18thConnect</collex:federation><br />
<collex:federation>MESA</collex:federation><br />
<br />
<collex:archive>CONTRIBUTING PROJECT</collex:archive><br />
<br />
<dc:title>OBJECT TITLE</dc:title><br />
<dcterms:alternative>ALTERNATE TITLE</dcterms:alternative><br />
<dc:source>TITLE OF JOURNAL/ANTHOLOGY/LARGER WORK</dc:source><br />
<br />
<role:ART>VISUAL ARTIST</role:ART><br />
<role:AUT>AUTHOR</role:AUT><br />
<role:EDT>EDITOR</role:EDT><br />
<role:PBL>PUBLISHER</role:PBL><br />
<role:TRL>TRANSLATOR</role:TRL><br />
<role:CRE>CREATOR</role:CRE><br />
<role:ETR>ETCHER</role:ETR><br />
<role:EGR>ENGRAVER</role:EGR><br />
<br />
<dc:type>TYPE</dc:type><br />
<br />
<collex:discipline>DISCIPLINE</collex:discipline><br />
<br />
<collex:genre>GENRE</collex:genre><br />
<collex:genre>ANOTHER GENRE</collex:genre><br />
<br />
<collex:freeculture>TRUE OR FALSE</collex:freeculture><br />
<collex:ocr>TRUE OR FALSE</collex:ocr><br />
<collex:fulltext>TRUE OR FALSE</collex:fulltext><br />
<br />
<dc:language>LANGUAGE OF RESOURCE</dc:language><br />
<br />
<dc:date>4-DIGIT-DATE</dc:date><br />
<br />
<collex:thumbnail rdf:resource="http://YOUR_PUBLICATION.ORG/THUMBNAIL.JPG"/><br />
<collex:image rdf:resource="http://YOUR_PUBLICATION.ORG/FULL_SIZE_IMAGE.JPG"/><br />
<br />
<collex:source_xml rdf:resource="http://YOUR_ENCODED_RESOURCE.XML"/><br />
<collex:text rdf:resource="http://PLAIN_TEXT_OBJECT_TRANSCRIPTION.TXT"/><br />
<rdfs:seeAlso rdf:resource="http://YOUR_PUBLICATION.ORG/YOUR_OBJECT.HTML"/><br />
<br />
<dcterms:hasPart rdf:resource="ANOTHER_OBJECT_CONTAINED_BY_THIS_OBJECT"/><br />
<dcterms:isPartOf rdf:resource="AN_OBJECT_THAT_CONTAINS_THIS_OBJECT"><br />
<dc:relation rdf:resource="AN_ASSOCIATED_OBJECT"><br />
<br />
</YOUR:NAMESPACE><br />
<br />
</rdf:RDF></pre><br />
<br />
== RDF Specification ==<br />
{|<br />
| <b>Available Elements</b><br />
|-<br />
|width="250"|[[#<custom_namespace rdf:about="value">|<<i>custom_namespace</i> rdf:about="">]]<br />
|[[#<collex:source_xml rdf:resource="">|<collex:source_xml>]]<br />
|-<br />
|[[#<collex:source_html rdf:resource="">|<collex:source_html>]]<br />
|[[#<collex:source_sgml rdf:resource="">|<collex:source_sgml>]]<br />
|-<br />
|[[#<dc:date>|<dc:date>]]<br />
|[[#<collex:thumbnail rdf:resource="">|<collex:thumbnail>]]<br />
|-<br />
|[[#<dc:relation rdf:resource="">|<dc:relation>]]<br />
|[[#<collex:text rdf:resource="">|<collex:text>]]<br />
|-<br />
|[[#<dc:source>|<dc:source>]]<br />
|[[#<rdf:RDF>|<rdf:RDF>]]<br />
|-<br />
|[[#<dc:title>|<dc:title>]]<br />
|[[#<rdf:value>|<rdf:value>]]<br />
|-<br />
|[[#<dcterms:alternative>|<dcterms:alternative>]]<br />
|[[#<rdfs:label>|<rdfs:label>]]<br />
|-<br />
|[[#<dcterms:hasPart rdf:resource="">|<dcterms:hasPart>]]<br />
|[[#<rdfs:seeAlso rdf:resource="">|<rdfs:seeAlso>]]<br />
|-<br />
|[[#<dcterms:isPartOf rdf:resource="">|<dcterms:isPartOf>]]<br />
|[[#<role:***>|<role:ART>]]<br />
|-<br />
|[[#<collex:archive>|<collex:archive>]]<br />
|[[#<role:***>|<role:AUT>]]<br />
|-<br />
|[[#<collex:date>|<collex:date>]]<br />
|[[#<role:***>|<role:EDT>]]<br />
|-<br />
|[[#<collex:genre>|<collex:genre>]]<br />
|[[#<role:***>|<role:PBL>]]<br />
|-<br />
|[[#<collex:image rdf:resource="">|<collex:image>]]<br />
|[[#<role:***>|<role:TRL>]]<br />
|-<br />
|[[#<role:***>|<role:ETR>]]<br />
|[[#<role:***>|<role:CRE>]]<br />
|-<br />
|[[#<collex:federation>|<collex:federation>]]<br />
|[[#<role:***>|<role:EGR>]]<br />
|-<br />
|[[#<collex:ocr>|<collex:ocr>]]<br />
|[[#<collex:fulltext>|<collex:fulltext>]]<br />
|-<br />
|[[#<dc:language>|<dc:language>]]<br />
|[[#<collex:freeculture>|<collex:freeculture>]]<br />
|}<br />
=== Element Definitions ===<br />
<br />
'''All element values should not include leading or trailing whitespace.''' In other words, <code><dc:date>1875</dc:date></code> is correct while <code><dc:date> 1875 </dc:date></code> is incorrect.<br />
<br />
====<rdf:RDF>====<br />
: the root element of the RDF file, listing namespace declarations with multiple "<code>xmlns:___</code>" attributes<br />
: it isn't necessary to reference an actual XSD schema to validate the RDF--use the "xmlns" value only to establish a unique namespace<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<<i>custom_namespace</i> rdf:about="<i>value</i>">====<br />
: denotes the object<br />
: a child element of <code><nowiki><rdf:RDF></nowiki></code> with a project defined namespace<br />
: <code><nowiki>"rdf:about"</nowiki></code> attribute records the unique id for the object <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:archive>====<br />
: a shorthand reference to the contributing project or journal, one word such as "rossetti" or "rc_praxis." This word should be unique to this particular set of content. You shouldn't, therefore, choose a reference like "PodunkUP" if Podunk University Press intends to contribute a different set of content in future. (Instead, choose "PodunkUP_journal1.") You may use a wide variety of characters to form this name, but it is recommended that you use only lower case letters, numbers, and the underscore.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:title>====<br />
: the title of the object<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:alternative>====<br />
: an alternative title of the object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:source>====<br />
: title of the larger work, resource, or collection of which the present object takes part<br />
: can be used for the title of a journal, anthology, book, online collection, etc.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:subject>====<br />
: a single keyword which is not currently displayed, but may be applied to tags and for future mining of data from ARC Partners sites.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:type>====<br />
: adapted from the DCMI list of types, this term should describe the medium, or format of the object.<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Type Values</b><br />
|- <br />
| Codex<br />
| Collection<br />
| Drawing<br />
| Illustration<br />
|- <br />
| Interactive Resource<br />
| Manuscript<br />
| Map<br />
| Moving Image<br />
|- <br />
| Periodical<br />
| Physical Object<br />
| Roll<br />
| Sheet<br />
|- <br />
| Sound<br />
| Still Image<br />
| Typescript<br />
|<br />
|}<br />
<br />
<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<role:***>====<br />
: individual involved in the creation of the object<br />
: possible element names include <code><nowiki><role:ART></nowiki></code> for Visual Artist<br />
::::::::<code><nowiki><role:AUT></nowiki></code> for Author<br />
::::::::<code><nowiki><role:EDT></nowiki></code> for Editor<br />
::::::::<code><nowiki><role:PBL></nowiki></code> for Publisher<br />
::::::::<code><nowiki><role:TRL></nowiki></code> for Translator<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:ETR></nowiki></code> for Etcher<br />
::::::::<code><nowiki><role:EGR></nowiki></code> for Engraver<br />
::::::::<code><nowiki><role:OWN></nowiki></code> for Owner <br />
::::::::<code><nowiki><role:ART></nowiki></code> for Artist <br />
::::::::<code><nowiki><role:ARC></nowiki></code> for Architect <br />
::::::::<code><nowiki><role:BND></nowiki></code> for Binder <br />
::::::::<code><nowiki><role:BKD></nowiki></code> for Book designer <br />
::::::::<code><nowiki><role:BKP></nowiki></code> for Book producer<br />
::::::::<code><nowiki><role:CLL></nowiki></code> for Calligrapher <br />
::::::::<code><nowiki><role:CTG></nowiki></code> for Cartographer<br />
::::::::<code><nowiki><role:COL></nowiki></code> for Collector<br />
::::::::<code><nowiki><role:CLR></nowiki></code> for Colorist <br />
::::::::<code><nowiki><role:CWT></nowiki></code> for Commentator for written text<br />
::::::::<code><nowiki><role:COM></nowiki></code> for Compiler<br />
::::::::<code><nowiki><role:CMT></nowiki></code> for Compositor<br />
::::::::<code><nowiki><role:CRE></nowiki></code> for Creator<br />
::::::::<code><nowiki><role:DUB></nowiki></code> for Dubious author<br />
::::::::<code><nowiki><role:FAC></nowiki></code> for Facsimilist<br />
::::::::<code><nowiki><role:ILU></nowiki></code> for Illuminator<br />
::::::::<code><nowiki><role:ILL></nowiki></code> for Illustrator<br />
::::::::<code><nowiki><role:LTG></nowiki></code> for Lithographer<br />
::::::::<code><nowiki><role:PRT></nowiki></code> for Printer<br />
::::::::<code><nowiki><role:POP></nowiki></code> for Printer of plates<br />
::::::::<code><nowiki><role:PRM></nowiki></code> for Printmaker<br />
::::::::<code><nowiki><role:RPS></nowiki></code> for Repository<br />
::::::::<code><nowiki><role:RBR></nowiki></code> for Rubricator<br />
::::::::<code><nowiki><role:SCR></nowiki></code> for Scribe) <br />
::::::::<code><nowiki><role:SCL></nowiki></code> for Sculptor) <br />
::::::::<code><nowiki><role:TYD></nowiki></code> for Type designer) <br />
::::::::<code><nowiki><role:TYG></nowiki></code> for Typographer) <br />
::::::::<code><nowiki><role:WDE></nowiki></code> for Wood engraver) <br />
::::::::<code><nowiki><role:WDC></nowiki></code> for Wood cutter)<br />
: ARC Partner sites recommend the submission of names in the format of "Last, First." Contributors are also encouraged to consult the Library of Congress [http://authorities.loc.gov/ authorities list]. Please be internally consistent and keep good records of any names you use.<br />
: <b>Please note: each element's content values pertain only to the object at hand, not to the object's content or subject matter; when you list a particular name as "author," this should be ''the author of'' the object, not ''an author described in'' the object's text.</b><br />
: ARC strongly encourages using <code><nowiki><role:ART></nowiki></code> or <code><nowiki><role:AUT></nowiki></code>, even when the agent is unknown or anonymous. In such cases, use the standard values "Unknown" or "Anonymous." For example, <code><nowiki><role:AUT>Unknown</role:AUT></nowiki></code>. Variants of those values ("Unk." or "Anon.") will degrade the usability of the faceted browser.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:discipline>====<br />
: information about the disciplines that may be interested in the object<br />
: Each object is required to have at least one valid discipline from the list below.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Discipline Values</b><br />
|- <br />
| Anthropology<br />
| Archaeology<br />
| Architecture<br />
| Art History<br />
|- <br />
| Book History<br />
| Classics and Ancient History<br />
| Ethnic Studies<br />
| Film Studies<br />
|- <br />
| Gender Studies<br />
| Geography<br />
| History<br />
| Law<br />
|- <br />
| Literature<br />
| Manuscript Studies<br />
| Math<br />
| Musicology<br />
|- <br />
| Philosophy<br />
| Religious Studies<br />
| Science<br />
| Theater Studies <br />
|}<br />
<br />
====<collex:genre>====<br />
: basic descriptive genres for Collex materials<br />
: Each object is required to have at least one valid genre from the list below. <br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
:{| border="1" cellpadding="5"<br />
| <b>Available Genre Values</b><br />
|- <br />
| Bibliography<br />
| Catalog<br />
| Citation<br />
| Collection<br />
|- <br />
| Correspondence<br />
| Criticism<br />
| Drama<br />
| Ephemera<br />
|- <br />
| Fiction<br />
| Historiography<br />
| Law<br />
| Life Writing<br />
|- <br />
| Liturgy<br />
| Musical Analysis<br />
| Music, Other<br />
| Musical Recording<br />
|- <br />
| Musical Score<br />
| Nonfiction<br />
| Paratext<br />
| Philosophy<br />
|- <br />
| Photograph<br />
| Poetry<br />
| Religion<br />
| Religion, Other<br />
|- <br />
| Reference Works<br />
| Review<br />
| Scripture<br />
| Sermon<br />
|- <br />
| Translation<br />
| Travel Writing<br />
| Unspecified<br />
| Visual Art<br />
|}<br />
: Please note the difference between 'Bibliography' (that is, a collection of bibliographical citations) and 'Citation' (referring to one citation, possibly within a larger list).<br />
<br />
====<dc:date>====<br />
: date of the object<br />
: may contain either a four digit year inside the <code><nowiki><dc:date></nowiki></code> tags or a <code><nowiki><collex:date></nowiki></code> element<br />
: '''Please note: contributors should, when at all possible, attempt to include a date ''even'' when a date value is unknown or uncertain'''<br />
::Unknown or uncertain dates can, in most cases, be narrowed to a possible date range, be it a decade or a century; contributors should use the <code><nowiki><nines:date></nowiki></code> formula to record a human-readable value (<code><rdfs:label></code>) and a computational value (<code><rdf:value></code>). <br />
:::To narrow a range to a decade, replace the last year digit with "u." E.g. 1860's are written as "186u" in <code><rdf:value></code>.<br />
:::To narrow a range to a century, replace the last two year digits with "u." E.g. 1800's are written as "18uu" in <code><rdf:value></code>.<br />
:::The value of <code><rdfs:label></code> can be anything one would like: "1860's", "1800's", "Likely the 1860's", "1860 through 1869", etc.<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1890-99 (circa)</rdfs:label><br />
<rdf:value>189u</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects which were produced over a number of years can receive a date range. Again, use the <code><collex:date></code> scheme. The <code><rdfs:label></code> takes any human-readable formulation, e.g. "1861 through 1862". <code><rdf:value></code> would encode the start-date and end-date in the range in a comma-separated format, e.g. "1861,1862".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>1891-93</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date></pre><br />
<br />
::Objects that are uncertainly dated but still known to be composed within a specific date range should receive a hybrid formulation, involving two <code><dc:date></code> elements. One <code><dc:date></code> records the date range; the second <code><dc:date></code> marks the object's date as "Uncertain".<br />
<pre><br />
<dc:date><br />
<collex:date><br />
<rdfs:label>Sometime between 1891 and 1893</rdfs:label><br />
<rdf:value>1891,1893</rdf:value><br />
</collex:date><br />
</dc:date><br />
<dc:date>Uncertain</dc:date></pre><br />
<br />
:: Objects worked on in nonconsecutive years should receive distinct <code><dc:date></code> elements for each year. So, for an object begun in 1890, put on hiatus in 1891, then concluded in 1892, the encoding would be ...<br />
<pre><br />
<dc:date>1890</dc:date><br />
<dc:date>1892</dc:date></pre><br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:date>====<br />
: element used when contributor wants to preserve more human readable date information while also including a formal date value<br />
: has two child elements, <code><nowiki><rdfs:label></nowiki></code> and <code><nowiki><rdf:value></nowiki></code><br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:label>====<br />
: preserves a human readable date value, e.g. "1806 (circa)"<br />
: will appear as the "Date" value in COLLEX query results<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdf:value>====<br />
: formal, four-digit date value of the <code><nowiki><rdfs:label></nowiki></code> contents<br />
: used for computational sorting and querying<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:freeculture>====<br />
: if present, a "true" value denotes that the content is free and available for use by all people in all places, whereas as a "false" value denotes that the content is restricted in some way to subscribers.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_xml>====<br />
: pointer to the web-accessible source code for the data in XML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_html>====<br />
: pointer to the web-accessible source code for the data in HTML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:source_sgml>====<br />
: pointer to the web-accessible source code for the data in SGML format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<rdfs:seeAlso rdf:resource="">====<br />
: pointer to the web-accessible object as it is rendered in your own interface. distinct urls displaying the same content should each get an rdfs:seeAlso entry.<br />
: usually an html page. During indexing, the NINES server issues a HEAD request to the specified URL (not a GET) and follows redirects. <br />
: <b>Required?</b> YES <br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:text>====<br />
: contains either:<br />
: 1) URL to a web-accessible, plain text transcription of the object, like the following:<br />
<br />
: <pre><collex:text rdf:resource="http://www.rossettiarchive.org/docs/1-1835.raw.txt"/></pre><br />
<br />
: 2) plain text of the transcript within the nines:text element, such as:<br />
<br />
: <pre><collex:text>full text goes here</collex:text></pre><br />
<br />
: indexed by the COLLEX search engine and used for full-text queries. This should be a "pure" transcript of the text content of the object, without extraneous text from navigation elements, copyright statements, etc. Encode plain text in UTF-8 format.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:image rdf:resource="">====<br />
: pointer to the web-accessible, full-size digital image of the object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:thumbnail rdf:resource="">====<br />
: pointer to the web-accessible, thumbnail-sized digital image of the object. We suggest that you make your thumbnails no larger than 100 pixels in either height or width.<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dcterms:hasPart rdf:resource="">====<br />
: pointer to divisions of the present object which have their own RDF objects<br />
: expresses a hierarchical relationship<br />
: e.g. a book object could points to its subordinate chapter objects<br />
: not currently exploited by COLLEX, but useful in the future for describing a graph of objects<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dcterms:isPartOf rdf:resource="">====<br />
: pointer to the RDF object of which the present object is a division<br />
: expresses a hierarchical relationship<br />
: e.g. a chapter object points to a book object<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<dc:relation rdf:resource="">====<br />
: pointer to an associated resource<br />
: provide a means to express relationships among resources that have formal relationships to others, but exist as discrete resources themselves<br />
: e.g. images in a document, other volumes in a series or items in a collection<br />
: <b>Required?</b> NO<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:federation>====<br />
: The federation that this object belongs to. Currently, the two legal values of this are "NINES" and "18thConnect". Notice that an object can belong to more than one federation.<br />
: <b>Required?</b> YES<br />
: <b>Can appear?</b> MULTIPLE<br />
<br />
====<collex:ocr>====<br />
: if present, a "true" value denotes that the content is was obtained by OCR, so there may be mistakes.<br />
: <b>Required?</b> NO (defaults to "false" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<collex:fulltext>====<br />
: if present, a "false" value denotes that the text element points to the full text of the object, and not a summary, or other abbreviated content.<br />
: <b>Required?</b> NO (defaults to "true" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
====<dc:language>====<br />
: This element identifies the language of the resource. Please note whether the language is '''English''', '''French''', '''German''', or '''Italian'''. <br />
: <b>Required?</b> NO (defaults to "English" if not present)<br />
: <b>Can appear?</b> ONCE<br />
<br />
== Testing, Troubleshooting, and Submitting RDF ==<br />
<br />
The W3C makes available a great [http://www.w3.org/RDF/Validator/ RDF Validator]. Use this service to ensure your RDF parses correctly and to gain a deeper understanding of the graph nature of RDF (by enabling the graph display option). <br />
<br />
NINES has developed a mechanism for contributors to upload their own RDF submissions, parse them against our schema, and test and tinker with them in a sandbox Collex interface. Once you've prepared a set of RDF you'd like to test, you can gain access to this staging area by submitting your materials to the [http://inbox.nines.org/ NINES Inbox]. From that page you can contact the Project Manager to set up your account and start the indexing process.<br />
<br />
== The Importance of Being Stable ==<br />
<br />
We recommend linking to your RDF in the meta tags of your HTML as follows:<br />
<br />
<pre><br />
<link rel="meta" type="application/rdf xml" href="myobject.rdf"/><br />
</pre><br />
<br />
These links are a semantic web "best practice." That said, Collex does not currently pick up changes to your HTML-linked RDF in any automated way. Instead, when you have revised RDF, you should upload it through the data administration system as a fresh batch. Please note that your fresh upload will '''completely replace''' all the RDF records NINES currently holds for your project. This means that the unique object id's expressed in each ''rdf:about'' field should '''remain stable.'''<br />
<br />
These id's are the most brittle aspect of the NINES system. If you change an id, all the user-created content built on top of your object will be lost or ruined. This includes tags and annotations as well as NINES exhibits, such as course syllabi or critical essays.<br />
<br />
The requirement that you keep stable NINES id's should not impact your ability to alter identifiers ''within your own archive'' at will.<br />
<br />
== Special Considerations for Dynamic Content ==<br />
<br />
The Collex software matches a site's public URL to the one given in the rdfs:seeAlso link in order to make objects collectible from the bookmarklet. Web resources generated from a database or XSLT at run time present additional challenges, as parameters may be re-ordered or absent. Rather than listing every URL permutation as an rdfs:seeAlso entry, one should explicitly reference the RDF from the meta tag in the HTML (see note above). The Collex system then matches the rdf:about unique identifier for objects defined in your RDF and objects loaded in Collex.<br />
<br />
The preferable solution for dynamic driven sites is to use URIs which hide the underlying technology, which is certain to change. See the following article for a technical explanation for future proofing your URIs:<br />
<br />
http://www.wrox.com/WileyCDA/Section/id-301495.html</div>Mandellc