https://wiki.digitalclassicist.org/api.php?action=feedcontributions&user=AdamChandler&feedformat=atomThe Digital Classicist Wiki - User contributions [en-gb]2024-03-29T05:01:16ZUser contributionsMediaWiki 1.41.0https://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3817Classical Works Knowledge Base2012-06-05T15:13:27Z<p>AdamChandler: /* Matrix defining the KEV format to represent a canonical citation */</p>
<hr />
<div>==Available==<br />
<br />
* http://cwkb.org/<br />
<br />
==Description==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
==Matrix defining the KEV format to represent a canonical citation==<br />
<br />
Requests to the CWKB are made using an OpenURL metadata format. The metadata format is in draft form. It has been submitted to the OpenURL Registry for public review. [Online] Available: http://cwkb.org/matrix/<br />
<br />
==References==<br />
* Aloi, Daniel. "Got Ovid? Classical knowledge base will assist in citing ancient Greek and Latin texts." Chronicle Online, June 2, 1010. [Online] Available: http://www.news.cornell.edu/stories/June10/ClassicsBase.html<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: http://cwkb.org/<br />
<br />
* Rebillard, E. and Ruddy, D., "Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt<br />
<br />
[[category:citation_in_digital_scholarship]]<br />
[[category:projects]]</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3324Classical Works Knowledge Base2010-10-11T16:31:03Z<p>AdamChandler: /* Matrix defining the KEV Format to represent a canonical citation */</p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
==Matrix defining the KEV format to represent a canonical citation==<br />
<br />
Requests to the CWKB are made using an OpenURL metadata format. The metadata format is in draft form. It has been submitted to the OpenURL Registry for public review. [Online] Available: http://cwkb.org/docs/matrix/<br />
<br />
==References==<br />
* Aloi, Daniel. "Got Ovid? Classical knowledge base will assist in citing ancient Greek and Latin texts." Chronicle Online, June 2, 1010. [Online] Available: http://www.news.cornell.edu/stories/June10/ClassicsBase.html<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: http://cwkb.org/<br />
<br />
* Rebillard, E. and Ruddy, D., "Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3323Classical Works Knowledge Base2010-10-11T16:30:40Z<p>AdamChandler: /* Matrix defining the KEV Format to represent a canonical citation */</p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
==Matrix defining the KEV Format to represent a canonical citation==<br />
<br />
Requests to the CWKB are made using an OpenURL metadata format. The metadata format is in draft form. It has been submitted to the OpenURL Registry for public review. [Online] Available: http://cwkb.org/docs/matrix/<br />
<br />
==References==<br />
* Aloi, Daniel. "Got Ovid? Classical knowledge base will assist in citing ancient Greek and Latin texts." Chronicle Online, June 2, 1010. [Online] Available: http://www.news.cornell.edu/stories/June10/ClassicsBase.html<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: http://cwkb.org/<br />
<br />
* Rebillard, E. and Ruddy, D., "Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3322Classical Works Knowledge Base2010-10-11T16:30:21Z<p>AdamChandler: /* Matrix defining the KEV Format to represent a canonical citation */</p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
==Matrix defining the KEV Format to represent a canonical citation==<br />
<br />
Requests to the CWKB are made using an OpenURL metadata format. * The metadata format is in draft form. It has been submitted to the OpenURL Registry for public review. [Online] Available: http://cwkb.org/docs/matrix/<br />
<br />
==References==<br />
* Aloi, Daniel. "Got Ovid? Classical knowledge base will assist in citing ancient Greek and Latin texts." Chronicle Online, June 2, 1010. [Online] Available: http://www.news.cornell.edu/stories/June10/ClassicsBase.html<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: http://cwkb.org/<br />
<br />
* Rebillard, E. and Ruddy, D., "Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3321Classical Works Knowledge Base2010-10-11T16:30:02Z<p>AdamChandler: /* Matrix defining the KEV Format to represent a canonical citation */</p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
==Matrix defining the KEV Format to represent a canonical citation==<br />
<br />
Requests to the CWKB are made using an OpenURL metadata format.<br />
<br />
* The metadata format is in draft form. It has been submitted to the OpenURL Registry for public review. [Online] Available: http://cwkb.org/docs/matrix/<br />
<br />
==References==<br />
* Aloi, Daniel. "Got Ovid? Classical knowledge base will assist in citing ancient Greek and Latin texts." Chronicle Online, June 2, 1010. [Online] Available: http://www.news.cornell.edu/stories/June10/ClassicsBase.html<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: http://cwkb.org/<br />
<br />
* Rebillard, E. and Ruddy, D., "Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3320Classical Works Knowledge Base2010-10-11T16:26:57Z<p>AdamChandler: </p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
==Matrix defining the KEV Format to represent a canonical citation==<br />
<br />
Requests to the CWKB are made using an OpenURL metadata format.<br />
<br />
<br />
<br />
==References==<br />
* Aloi, Daniel. "Got Ovid? Classical knowledge base will assist in citing ancient Greek and Latin texts." Chronicle Online, June 2, 1010. [Online] Available: http://www.news.cornell.edu/stories/June10/ClassicsBase.html<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: http://cwkb.org/<br />
<br />
* Rebillard, E. and Ruddy, D., "Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Citation_in_digital_scholarship&diff=3319Citation in digital scholarship2010-10-11T16:22:28Z<p>AdamChandler: </p>
<hr />
<div>[[category:citation_in_digital_scholarship]]<br />
This page suggests best practices for making citations in digital scholarship and documents a set of conventions that are intended to promote greater interoperability. It will also point to tools for identifying, processing, and presenting citations in server and client-side environments. Additionally, it highlights resources that are creating stable URLs relevant to digital scholarship, with a focus on humanities disciplines.<br />
<br />
The phrase 'Citation in Digital Scholarship' is meant very generally as the encoding of reference to an external entity in support of, as illustration of, or otherwise in relationship to a work of digitally available scholarship. Scholars cite resources ranging from primary texts, contemporary scholarship, museum objects, people, places, and a wide range of other entities and categories of information. A set of robust and straightforward conventions that allow for local extension will enable increased recognition of the growing number of links between scholarly works.<br />
<br />
In its most simple form, the convention adopted here is to wrap a citation in an element that has an attribute with value 'citation'. A title attribute, or equivalent, can be used to indicate a plain-text non-abbreviated form of a citation. In html that can mean:<br />
<br />
* <a class="citation" href="http://www.jstor.org/stable/148266" title="Alcock, Susan. 1991. 'Urban Survey and the Polis of Phlius', Hesperia 60.4, pp. 421-463.">Alcock (1991)</a><br />
* Further example: <a class="citation" title="Herodotus, Histories, 1.78" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a><br />
* Example with added RDFa: <a class="citation" typeof="dc:Location" rel="skos:definition" href="http://pleiades.stoa.org/places/599612">Ephesus</a><br />
<br />
<br />
<br />
==Requirements==<br />
This effort takes as its starting point that the conventions described should:<br />
<br />
# Be automatically parsable. Automatic agents should be able to recognize that a citation is being made, and to identify what is being cited.<br />
# Encourage reuse of existing naming schemes. A consistently applied convention should allow distinct and independent citation to the same entity to be recognized by third parties. For all the examples below, but particularly for sites creating stable id's (e.g. Pleiades), a concern is for a generic, interoperable, author-friendly convention to refer to those resources in ways that the sites themselves will recognize. "If you make a reference to Pleiades, how does Pleiades know that you've done so?"<br />
# Support user interaction. Client-side operations, such as "show me a map of all geographic entities in a document" can be facilitated by a robust citation convention.<br />
# Recognize that various standards already exist and not take unnecessary steps to interfere with the deployment of those standards.<br />
<br />
The above list is based up on previous scholarship in the field of digital citation (<ref>Romanello 2008</ref>, <ref>Smith 2009</ref>).<br />
<br />
==Recommended Convention (@*="citation" paired with URI)==<br />
For xml-based documents, the following conventions are recommended:<br />
* Citations should be human readable.<br />
* Citations must be indicated by a containing element that has an attribute whose value is 'citation'. In (x)html that attribute is the 'class' global attribute. The only role of this attribute is to identify a span of text that is amenable to automatic processing to identify, describe or make actionable to a user the cited resource.<br />
* Citations should be qualified by an attribute giving an unabbreviated plain text version of the citation. This is unnecessary when the citation itself is not abbreviated.<br />
* The language of the citation should be indicated if it is distinct from the language of the host document.<br />
* Citations should link to stable online resources that make available, are surrogates for, or otherwise define the cited entity.<br />
* Citations may use an existing standard, such as microdata, microformats, or RDFa, to indicate the nature of the entity being cited and to describe the relationship of the online resource being linked to the underlying concept that online resource describes. The specific patterns suggested for each of these standards is the topic of ongoing community discussion.<br />
<br />
==Examples==<br />
===Simple Examples===<br />
* <a class="citation" title="Herodotus, Histories, 1.78" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a><br />
* &lt;span class="citation">Briant, P., Boucharlat, R., & Réseau international d'études et de recherches achéménides. (2005). L'archéologie de l'empire achéménide. Paris: de Boccard. (<a href="http://www.worldcat.org/title/archeologie-de-lempire-achemenide/oclc/496793701">Worldcat recrod</a>)</span><br />
* <a class="citation" href="http://pleiades.stoa.org/places/599612">Ephesus</a><br />
<br />
===Other examples with more markup===<br />
<br />
Given the following mapping between prefixes and URL:<br />
* 'dc' = 'http://purl.org/dc/terms/'<br />
* 'skos' = 'http://www.w3.org/2004/02/skos/core#'<br />
<br />
the following examples add RDF to conformant citations:<br />
<br />
*<a class="citation" title="Herodotus, Histories, 1.78" rel="dc:references" typeof="dc:Text" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a><br />
:The @typeof will produce an RDFa triple indicating the resource at the URI is a Dublin Core Text.<br />
<br />
* <a class="citation" typeof="dc:Location" rel="dc:references skos:definition" href="http://pleiades.stoa.org/places/599612">Ephesus</a>'<br />
:Here the citation is to a 'http://purl.org/dc/terms/Location' that is defined at the URL 'http://pleiades.stoa.org/places/599612' .<br />
<br />
Addition of RDF to conformant citations is discussed in more detail on the page [[Citations with added RDFa]].<br />
<br />
==Use Cases==<br />
The '@*="citation"' pattern can be used in the following circumstances.<br />
<br />
* To distinguish those links which contribute to the intellectual argument of a document from those that implement a user-interface or indicate the immediate publishing environment of a document. For example, a link to the homepage of a website hosting a document should not be marked with 'citation'.<br />
<br />
* By authors of (x)html documents that are the archival version of digital scholarship.<br />
<br />
* As a presentation target for documents that are stored in a non-html format but presented as such on the web.<br />
<br />
==The Process of Digital Citation in Prose Works==<br />
<br />
====Preliminary Notes====<br />
* An xml environment, with examples implemented in (x)html and tei, is assumed.<br />
* While this page does assert categories, those are also up for discussion. What is the theoretical and practical difference between a "primary source" and "secondary scholarship"? It is reasonable to cite the 9th century scholar [http://en.wikipedia.org/wiki/Photius Photius] as both.<br />
<br />
===1. Plain-text citations===<br />
<br />
Sample text: ''Herodotus (1.78) describes Babylon as the strongest and most famous city in Assyria. It is likely that this city was subsequently the mint from which Alexander issued a series of coins depicting eastern warriors on the obverse and an elephant on the reverse (e.g. ANS 1995.51.68). See discussion by Martin Price (1991).''<br />
<br />
Is it possible to establish a robust convention that allows unambiguous machine-recognizable linking to the cited text, to Alexander, to Babylon, to a description of the the coin in the collection of the American Numismatic Society and to the article "Circulation at Babylon in 323 B.C."?<br />
<br />
===2. Indicating the Presence of a Citation (@*="citation")===<br />
HTML: &lt;span class="citation">Herodotus (1.78)&lt;/span><br />
<br />
TEI: <ref type="citation">Herodotus (1.78)</ref><br />
<br />
In both these usages, an xpath selector "//*[@*='citation']" will create a set of all the citations in a text. That is robust.<br />
<br />
===3. Normalizing the plain text citation===<br />
HTML: &lt;span class="citation" lang="en" title="Herodotus Histories 1.78">Herodotus (1.78)&lt;/span><br />
<br />
TEI: <ref type="citation" n="Hdt. 1.78">Herodotus (1.78)</ref><br />
<br />
Normalization will assist tools that can automatically recognize plain text citations.<br />
<br />
If the value of the 'title' attribute would be identical to the text representation of the element it is attached to, it can be left out.<br />
<br />
Note: in the HTML5 spec, elements without @title inherit the value from any ancestor that has @title. That should not happen in the case of a citation.<br />
<br />
===4. Be explicit about language===<br />
Both "Herodotus Histories 1.78" and "Hdt. 1.78" can be considered English representations of the citation of that text. The German equivalent of the first is "Herodot Historien 1.78", the Latin - still with Arabic numerals - is "Herodotus Historiae 1.78". If the language of the citation is the same as its prose context, it is not necessary to further markup the citation. It is common practice in some disciplines to cite the title of a work in its original language or in a widely accepted academic language, such as Latin titles for Greek works in Classics.<br />
<br />
HTML: Herodotus (<a class="citation" title="Herodotus Historiae 1.78" lang="la">Historiae 1.78</a>) describes...<br />
<br />
The 'lang' attribute specifices the language of the element to which it is attached. It does not directly specify the language of the 'title' attribute. Therefore, they must be the same.<br />
<br />
===5. Choosing a URL===<br />
Ideally, citations in digital scholarship are paired with a link to an online resource available at a persistent URI that that has clear semantics. Such URIs do not always exist, which is one reason to put a plain-text reference in the 'title' attribute.<br />
<br />
HTML: <a class="citation" title="Hdt. 1.78" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a><br />
<br />
TEI: <ref type="citation" n="Hdt. .78" target="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78" >Herodotus (1.78)</ref><br />
<br />
HTML: <a class="citation" href="http://atlantides.org/batlas/babylon-91-f5">Babylon</a><br />
<br />
<br />
<br />
==Adding other markup schemes to conformant citations==<br />
The 'class="citation" title="<normalized plain text citation>"' html pattern is designed so that it can be easily used with other markup schemes. The global 'class' attribute in html is a space separated list so that other, unrelated values can be present without interfering with the identification of an element as a citation. The global 'title' attribute is directly suitable for the role envisioned here so shouldn't clash with other conforming uses.<br />
<br />
Content-creators may choose to add in additional markup. Links to guidelines for doing so are list here.<br />
===OpenURL/Coins/Zotero===<br />
* [[Citations with COINS]]<br />
<br />
===CTS + Microformats===<br />
* [[Citations with CTS and Microformats]]<br />
<br />
===RDFa===<br />
* [[Citations with added RDFa]]<br />
<br />
===Canonical Workds Knowledge Base (CWKB)===<br />
* [[CWKB]]<br />
<br />
==Categories of resources that can be cited==<br />
Note: the page [[Current practice in citation]] has been started.<br />
=== Ancient Mediterranean Primary Texts ===<br />
"Classics" has well established abbreviations. Neither complete, nor unambiguous, but well established.<br />
* Plain text: "Hom. Il. 2.345", "Homer, Iliad 2.345"<br />
<br />
The following examples illustrate that the same text can appear in different places.<br />
* HTML: <a class="citation" title="Homer Iliad 2.345" href="http://perseus.uchicago.edu/perseus-cgi/citequery3.pl?query=Hom.+Il.+2.345&dbname=GreekTexts">Hom. Il. 2.345</a><br />
<br />
This example does not address the presence and/or capabilities of the [[Canonical Text Services]] (CTS) protocol and URN scheme under development at the Center for Hellenic Studies.<br />
<br />
===Geographic Entities===<br />
Within the Ancient Mediterranean, the Pleiades Project is establishing short URL as identifiers for geographic entities (but see their own discussion for details). Geonames.org is a worldwide list of identifiers.<br />
*HTML: <a class="citation" href="http://pleiades.stoa.org/places/599612">Ephesus</a><br />
*HTML: <a class="citation" href="http://www.geonames.org/1346463/samarqand-shahri.html">Samarkand</a><br />
<br />
===Bibliographic Data===<br />
Worldcat. But there may be licensing issues.<br />
*HTML: <a class="citation" href="http://www.worldcat.org/title/golden-age-of-chinese-archaeology-celebrated-discoveries-from-the-peoples-republic-of-china/oclc/41606205&referer=brief_results">Yang, X., National Gallery of Art (U.S.), Museum of Fine Arts, Houston., & Asian Art Museum of San Francisco. (1999). <i>The golden age of Chinese archaeology: Celebrated discoveries from the People's Republic of China</i>. Washington: National Gallery of Art</a><br />
<br />
What is the relationship between citing a work and citing its bibliographic record? Is that a necessary distinction?<br />
<br />
===Museum Objects===<br />
<br />
Or any cataloged object with stable id?<br />
<br />
HTML: <a class="citation" href="http://numismatics.org/collection/1968.34.40">ANS 1968.34.40</a>. <br />
<br />
===Egyptian Papyri===<br />
The sites http://papyri.info and http://trismegistos.org (e.g. http://www.trismegistos.org/tm/detail.php?tm=23 ) are islands of stability here.<br />
<br />
HTML: <a class="citation" title="Trismegistos Number 23" href="http://www.trismegistos.org/tm/detail.php?tm=23">TM23</a><br />
<br />
==Tools==<br />
* citations.js is an early-stage javascript library that parses 'class="citation"' markup. http://github.com/sfsheath/citations-js<br />
* http://github.com/mromanello/CTS_dev/ hosts code related to the Canonical Text Services protocol.<br />
* http://github.com/mromanello/CRefEx is a "A Canonical Refences Extractor written in python".<br />
<br />
==Notes==<br />
{{reflist}}<br />
<br />
==References and Further Reading ==<br />
<br />
* Heath 2010: Sebastian Heath, 'Diversity and Reuse of Digital Resources for Ancient Mediterranean Material Culture.' In G. Bodard and S. Mahony, eds., Digital Research in the Study of Classical Antiquity. (2010), pp. 35-52. Farnham, UK: Ashgate. http://hdl.handle.net/2451/29797 <br />
<br />
* Isaksen 2009. Leif Isaksen ‘Pandora’s Box: The Future of Cultural Heritage on the World Wide Web’ http://leifuss.files.wordpress.com/2009/04/pandorasboxrev1.pdf .<br />
<br />
* Romanello 2007. Matteo Romanello, "A semantic linking system for canonical references to electronic corpora," in International Conference on Electronic Corpora of Ancient Languages : proceedings of the international conference, Prague, November 16-17, 2007, P. Zemanek, Ed., Prague, 2007, pp. 107-120. [Online]. Available: http://eprints.rclis.org/16239/1/Romanello2008.pdf<br />
<br />
* Romanello 2008. Matteo Romanello. "A Semantic Linking Framework to Provide Critical Value-Added Services for E-Journals on Classics." ELPUB 2008: Open Scholarship: Authority, Community, and Sustainability in the Age of Web 2.0 - Proceedings of the 12th International Conference on Electronic Publishing: http://elpub.scix.net/data/works/att/401_elpub2008.content.pdf.<br />
<br />
* Smith 2009. Neel Smith. “Citation in Classical Studies”, ''Digital Humanities Quarterly'' Winter 2009 Volume 3 Number 1. http://digitalhumanities.org/dhq/vol/3/1/000028/000028.html</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Citation_in_digital_scholarship&diff=3318Citation in digital scholarship2010-10-11T16:21:23Z<p>AdamChandler: </p>
<hr />
<div>[[category:citation_in_digital_scholarship]]<br />
This page suggests best practices for making citations in digital scholarship and documents a set of conventions that are intended to promote greater interoperability. It will also point to tools for identifying, processing, and presenting citations in server and client-side environments. Additionally, it highlights resources that are creating stable URLs relevant to digital scholarship, with a focus on humanities disciplines.<br />
<br />
The phrase 'Citation in Digital Scholarship' is meant very generally as the encoding of reference to an external entity in support of, as illustration of, or otherwise in relationship to a work of digitally available scholarship. Scholars cite resources ranging from primary texts, contemporary scholarship, museum objects, people, places, and a wide range of other entities and categories of information. A set of robust and straightforward conventions that allow for local extension will enable increased recognition of the growing number of links between scholarly works.<br />
<br />
In its most simple form, the convention adopted here is to wrap a citation in an element that has an attribute with value 'citation'. A title attribute, or equivalent, can be used to indicate a plain-text non-abbreviated form of a citation. In html that can mean:<br />
<br />
* <a class="citation" href="http://www.jstor.org/stable/148266" title="Alcock, Susan. 1991. 'Urban Survey and the Polis of Phlius', Hesperia 60.4, pp. 421-463.">Alcock (1991)</a><br />
* Further example: <a class="citation" title="Herodotus, Histories, 1.78" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a><br />
* Example with added RDFa: <a class="citation" typeof="dc:Location" rel="skos:definition" href="http://pleiades.stoa.org/places/599612">Ephesus</a><br />
<br />
<br />
<br />
==Requirements==<br />
This effort takes as its starting point that the conventions described should:<br />
<br />
# Be automatically parsable. Automatic agents should be able to recognize that a citation is being made, and to identify what is being cited.<br />
# Encourage reuse of existing naming schemes. A consistently applied convention should allow distinct and independent citation to the same entity to be recognized by third parties. For all the examples below, but particularly for sites creating stable id's (e.g. Pleiades), a concern is for a generic, interoperable, author-friendly convention to refer to those resources in ways that the sites themselves will recognize. "If you make a reference to Pleiades, how does Pleiades know that you've done so?"<br />
# Support user interaction. Client-side operations, such as "show me a map of all geographic entities in a document" can be facilitated by a robust citation convention.<br />
# Recognize that various standards already exist and not take unnecessary steps to interfere with the deployment of those standards.<br />
<br />
The above list is based up on previous scholarship in the field of digital citation (<ref>Romanello 2008</ref>, <ref>Smith 2009</ref>).<br />
<br />
==Recommended Convention (@*="citation" paired with URI)==<br />
For xml-based documents, the following conventions are recommended:<br />
* Citations should be human readable.<br />
* Citations must be indicated by a containing element that has an attribute whose value is 'citation'. In (x)html that attribute is the 'class' global attribute. The only role of this attribute is to identify a span of text that is amenable to automatic processing to identify, describe or make actionable to a user the cited resource.<br />
* Citations should be qualified by an attribute giving an unabbreviated plain text version of the citation. This is unnecessary when the citation itself is not abbreviated.<br />
* The language of the citation should be indicated if it is distinct from the language of the host document.<br />
* Citations should link to stable online resources that make available, are surrogates for, or otherwise define the cited entity.<br />
* Citations may use an existing standard, such as microdata, microformats, or RDFa, to indicate the nature of the entity being cited and to describe the relationship of the online resource being linked to the underlying concept that online resource describes. The specific patterns suggested for each of these standards is the topic of ongoing community discussion.<br />
<br />
==Examples==<br />
===Simple Examples===<br />
* <a class="citation" title="Herodotus, Histories, 1.78" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a><br />
* &lt;span class="citation">Briant, P., Boucharlat, R., & Réseau international d'études et de recherches achéménides. (2005). L'archéologie de l'empire achéménide. Paris: de Boccard. (<a href="http://www.worldcat.org/title/archeologie-de-lempire-achemenide/oclc/496793701">Worldcat recrod</a>)</span><br />
* <a class="citation" href="http://pleiades.stoa.org/places/599612">Ephesus</a><br />
<br />
===Other examples with more markup===<br />
<br />
Given the following mapping between prefixes and URL:<br />
* 'dc' = 'http://purl.org/dc/terms/'<br />
* 'skos' = 'http://www.w3.org/2004/02/skos/core#'<br />
<br />
the following examples add RDF to conformant citations:<br />
<br />
*<a class="citation" title="Herodotus, Histories, 1.78" rel="dc:references" typeof="dc:Text" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a><br />
:The @typeof will produce an RDFa triple indicating the resource at the URI is a Dublin Core Text.<br />
<br />
* <a class="citation" typeof="dc:Location" rel="dc:references skos:definition" href="http://pleiades.stoa.org/places/599612">Ephesus</a>'<br />
:Here the citation is to a 'http://purl.org/dc/terms/Location' that is defined at the URL 'http://pleiades.stoa.org/places/599612' .<br />
<br />
Addition of RDF to conformant citations is discussed in more detail on the page [[Citations with added RDFa]].<br />
<br />
==Use Cases==<br />
The '@*="citation"' pattern can be used in the following circumstances.<br />
<br />
* To distinguish those links which contribute to the intellectual argument of a document from those that implement a user-interface or indicate the immediate publishing environment of a document. For example, a link to the homepage of a website hosting a document should not be marked with 'citation'.<br />
<br />
* By authors of (x)html documents that are the archival version of digital scholarship.<br />
<br />
* As a presentation target for documents that are stored in a non-html format but presented as such on the web.<br />
<br />
==The Process of Digital Citation in Prose Works==<br />
<br />
====Preliminary Notes====<br />
* An xml environment, with examples implemented in (x)html and tei, is assumed.<br />
* While this page does assert categories, those are also up for discussion. What is the theoretical and practical difference between a "primary source" and "secondary scholarship"? It is reasonable to cite the 9th century scholar [http://en.wikipedia.org/wiki/Photius Photius] as both.<br />
<br />
===1. Plain-text citations===<br />
<br />
Sample text: ''Herodotus (1.78) describes Babylon as the strongest and most famous city in Assyria. It is likely that this city was subsequently the mint from which Alexander issued a series of coins depicting eastern warriors on the obverse and an elephant on the reverse (e.g. ANS 1995.51.68). See discussion by Martin Price (1991).''<br />
<br />
Is it possible to establish a robust convention that allows unambiguous machine-recognizable linking to the cited text, to Alexander, to Babylon, to a description of the the coin in the collection of the American Numismatic Society and to the article "Circulation at Babylon in 323 B.C."?<br />
<br />
===2. Indicating the Presence of a Citation (@*="citation")===<br />
HTML: &lt;span class="citation">Herodotus (1.78)&lt;/span><br />
<br />
TEI: <ref type="citation">Herodotus (1.78)</ref><br />
<br />
In both these usages, an xpath selector "//*[@*='citation']" will create a set of all the citations in a text. That is robust.<br />
<br />
===3. Normalizing the plain text citation===<br />
HTML: &lt;span class="citation" lang="en" title="Herodotus Histories 1.78">Herodotus (1.78)&lt;/span><br />
<br />
TEI: <ref type="citation" n="Hdt. 1.78">Herodotus (1.78)</ref><br />
<br />
Normalization will assist tools that can automatically recognize plain text citations.<br />
<br />
If the value of the 'title' attribute would be identical to the text representation of the element it is attached to, it can be left out.<br />
<br />
Note: in the HTML5 spec, elements without @title inherit the value from any ancestor that has @title. That should not happen in the case of a citation.<br />
<br />
===4. Be explicit about language===<br />
Both "Herodotus Histories 1.78" and "Hdt. 1.78" can be considered English representations of the citation of that text. The German equivalent of the first is "Herodot Historien 1.78", the Latin - still with Arabic numerals - is "Herodotus Historiae 1.78". If the language of the citation is the same as its prose context, it is not necessary to further markup the citation. It is common practice in some disciplines to cite the title of a work in its original language or in a widely accepted academic language, such as Latin titles for Greek works in Classics.<br />
<br />
HTML: Herodotus (<a class="citation" title="Herodotus Historiae 1.78" lang="la">Historiae 1.78</a>) describes...<br />
<br />
The 'lang' attribute specifices the language of the element to which it is attached. It does not directly specify the language of the 'title' attribute. Therefore, they must be the same.<br />
<br />
===5. Choosing a URL===<br />
Ideally, citations in digital scholarship are paired with a link to an online resource available at a persistent URI that that has clear semantics. Such URIs do not always exist, which is one reason to put a plain-text reference in the 'title' attribute.<br />
<br />
HTML: <a class="citation" title="Hdt. 1.78" href="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78">Herodotus (1.78)</a><br />
<br />
TEI: <ref type="citation" n="Hdt. .78" target="http://www.perseus.tufts.edu/hopper/text?doc=Perseus:text:1999.01.0125:book%3D1:chapter%3D78" >Herodotus (1.78)</ref><br />
<br />
HTML: <a class="citation" href="http://atlantides.org/batlas/babylon-91-f5">Babylon</a><br />
<br />
<br />
<br />
==Adding other markup schemes to conformant citations==<br />
The 'class="citation" title="<normalized plain text citation>"' html pattern is designed so that it can be easily used with other markup schemes. The global 'class' attribute in html is a space separated list so that other, unrelated values can be present without interfering with the identification of an element as a citation. The global 'title' attribute is directly suitable for the role envisioned here so shouldn't clash with other conforming uses.<br />
<br />
Content-creators may choose to add in additional markup. Links to guidelines for doing so are list here.<br />
===OpenURL/Coins/Zotero===<br />
* [[Citations with COINS]]<br />
<br />
===CTS + Microformats===<br />
* [[Citations with CTS and Microformats]]<br />
<br />
===RDFa===<br />
* [[Citations with added RDFa]]<br />
<br />
===CWKB===<br />
* [[Classical Works Knowledge Base (CWKB)]]<br />
<br />
==Categories of resources that can be cited==<br />
Note: the page [[Current practice in citation]] has been started.<br />
=== Ancient Mediterranean Primary Texts ===<br />
"Classics" has well established abbreviations. Neither complete, nor unambiguous, but well established.<br />
* Plain text: "Hom. Il. 2.345", "Homer, Iliad 2.345"<br />
<br />
The following examples illustrate that the same text can appear in different places.<br />
* HTML: <a class="citation" title="Homer Iliad 2.345" href="http://perseus.uchicago.edu/perseus-cgi/citequery3.pl?query=Hom.+Il.+2.345&dbname=GreekTexts">Hom. Il. 2.345</a><br />
<br />
This example does not address the presence and/or capabilities of the [[Canonical Text Services]] (CTS) protocol and URN scheme under development at the Center for Hellenic Studies.<br />
<br />
===Geographic Entities===<br />
Within the Ancient Mediterranean, the Pleiades Project is establishing short URL as identifiers for geographic entities (but see their own discussion for details). Geonames.org is a worldwide list of identifiers.<br />
*HTML: <a class="citation" href="http://pleiades.stoa.org/places/599612">Ephesus</a><br />
*HTML: <a class="citation" href="http://www.geonames.org/1346463/samarqand-shahri.html">Samarkand</a><br />
<br />
===Bibliographic Data===<br />
Worldcat. But there may be licensing issues.<br />
*HTML: <a class="citation" href="http://www.worldcat.org/title/golden-age-of-chinese-archaeology-celebrated-discoveries-from-the-peoples-republic-of-china/oclc/41606205&referer=brief_results">Yang, X., National Gallery of Art (U.S.), Museum of Fine Arts, Houston., & Asian Art Museum of San Francisco. (1999). <i>The golden age of Chinese archaeology: Celebrated discoveries from the People's Republic of China</i>. Washington: National Gallery of Art</a><br />
<br />
What is the relationship between citing a work and citing its bibliographic record? Is that a necessary distinction?<br />
<br />
===Museum Objects===<br />
<br />
Or any cataloged object with stable id?<br />
<br />
HTML: <a class="citation" href="http://numismatics.org/collection/1968.34.40">ANS 1968.34.40</a>. <br />
<br />
===Egyptian Papyri===<br />
The sites http://papyri.info and http://trismegistos.org (e.g. http://www.trismegistos.org/tm/detail.php?tm=23 ) are islands of stability here.<br />
<br />
HTML: <a class="citation" title="Trismegistos Number 23" href="http://www.trismegistos.org/tm/detail.php?tm=23">TM23</a><br />
<br />
==Tools==<br />
* citations.js is an early-stage javascript library that parses 'class="citation"' markup. http://github.com/sfsheath/citations-js<br />
* http://github.com/mromanello/CTS_dev/ hosts code related to the Canonical Text Services protocol.<br />
* http://github.com/mromanello/CRefEx is a "A Canonical Refences Extractor written in python".<br />
<br />
==Notes==<br />
{{reflist}}<br />
<br />
==References and Further Reading ==<br />
<br />
* Heath 2010: Sebastian Heath, 'Diversity and Reuse of Digital Resources for Ancient Mediterranean Material Culture.' In G. Bodard and S. Mahony, eds., Digital Research in the Study of Classical Antiquity. (2010), pp. 35-52. Farnham, UK: Ashgate. http://hdl.handle.net/2451/29797 <br />
<br />
* Isaksen 2009. Leif Isaksen ‘Pandora’s Box: The Future of Cultural Heritage on the World Wide Web’ http://leifuss.files.wordpress.com/2009/04/pandorasboxrev1.pdf .<br />
<br />
* Romanello 2007. Matteo Romanello, "A semantic linking system for canonical references to electronic corpora," in International Conference on Electronic Corpora of Ancient Languages : proceedings of the international conference, Prague, November 16-17, 2007, P. Zemanek, Ed., Prague, 2007, pp. 107-120. [Online]. Available: http://eprints.rclis.org/16239/1/Romanello2008.pdf<br />
<br />
* Romanello 2008. Matteo Romanello. "A Semantic Linking Framework to Provide Critical Value-Added Services for E-Journals on Classics." ELPUB 2008: Open Scholarship: Authority, Community, and Sustainability in the Age of Web 2.0 - Proceedings of the 12th International Conference on Electronic Publishing: http://elpub.scix.net/data/works/att/401_elpub2008.content.pdf.<br />
<br />
* Smith 2009. Neel Smith. “Citation in Classical Studies”, ''Digital Humanities Quarterly'' Winter 2009 Volume 3 Number 1. http://digitalhumanities.org/dhq/vol/3/1/000028/000028.html</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3317Classical Works Knowledge Base2010-10-11T16:17:26Z<p>AdamChandler: /* References */</p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
<br />
==References==<br />
* Aloi, Daniel. "Got Ovid? Classical knowledge base will assist in citing ancient Greek and Latin texts." Chronicle Online, June 2, 1010. [Online] Available: http://www.news.cornell.edu/stories/June10/ClassicsBase.html<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: http://cwkb.org/<br />
<br />
* Rebillard, E. and Ruddy, D., "Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3316Classical Works Knowledge Base2010-10-11T16:15:14Z<p>AdamChandler: /* References */</p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
<br />
==References==<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: http://cwkb.org/<br />
<br />
* Rebillard, E. and Ruddy, D.,"Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3315Classical Works Knowledge Base2010-10-11T16:14:37Z<p>AdamChandler: /* References */</p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
<br />
==References==<br />
<br />
* Canonical Citation Linking and OpenURL. [Online] Available: Canonical Citation Linking and OpenURL<br />
<br />
* Rebillard, E. and Ruddy, D.,"Text linking in the humanities: citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandlerhttps://wiki.digitalclassicist.org/index.php?title=Classical_Works_Knowledge_Base&diff=3314Classical Works Knowledge Base2010-10-11T16:11:45Z<p>AdamChandler: </p>
<hr />
<div>==Classical Works Knowledge Base (CWKB)==<br />
<br />
This service allows for the assembly and maintenance of specialized knowledge about works within its domain and about online resources that can provide services related to those works. It understands the linking heuristics used by online text resources within its domain and is able to create for any given canonical citation one or many URLs that can take users to specific texts within these resources, and ideally to specific passages. Although our example, and the focus of our study, concerns Classical literature, such domain specific knowledge bases would operate in the same way for other disciplines.<br />
<br />
<br />
==References==<br />
<br />
* Rebillard, E. and Ruddy, D.,"Text linking in the humanities:�citing canonical works using OpenURL." CNI Spring 2009 Task Force Meeting, Minneapolis, MN, April 7 2009. [Online]. Available: http://cwkb.org/pubs/200904-CNI-OpenURL.ppt</div>AdamChandler