annotations supporting scholarly editing

Annotations Supporting Scholarly Editing

Anna Gerber

ITEE eResearch Group

The University of Queensland

Scholarly Editions

• Provide accurate reading texts of works of literary, historical, theological or philosophical significance

• They contain:

– historical and textual essays,

– explanatory notes,

– appendixes e.g. glossary

– a scholarly apparatus that provides access to alternative readings in other versions of the work

From:

Boldrewood, Rolf, &Eggert, Paul, & Webby, Elizabeth. & Australian Academy of the Humanities. 2006, Robbery under arms / Rolf Boldrewood ; edited by Paul Eggert and Elizabeth Webby, University of Queensland Press, St. Lucia, Qld.

Critical Apparatus

Apparatus

Critical Edition with apparatus as footnotes

AustESE

eResearchTools to Support the Collaborative Authoring and Management of Electronic Scholarly Editions

http://itee.uq.edu.au/~eresearch/projects/austese/

Funded by

Annotation Use Cases

• Facilitate collaborative discussion of texts, sources and facsimiles

– Comments

– Questions

– Replies

• Describe textual variation for apparatus

• Record notes

– Textual notes (about production of text)

– Explanatory notes (meaning, historical context etc)

– Link texts with facsimiles, reference secondary sources

Extending OA Motivation

Annotating Transcriptions & Images

Explanatory Note

Explanatory Note RDF

@prefix oa: <http://www.w3.org/ns/oa#> .@prefix cnt: <http://www.w3.org/2011/content#> .@prefix austese: <http://austese.net/ns/oa/>.@prefix dcterms: <http://purl.org/dc/terms/>.@prefix foaf: <http://xmlns.com/foaf/0.1/>.@prefix dc: <http://purl.org/dc/elements/1.1/>.<http://austese.net/lorestore/oa/29FAC2C4D02CAC8F> {<http://austese.net/lorestore/oa/29FAC2C4D02CAC8F> a oa:Annotation ;oa:annotatedAt "2013-03-22T06:16:25+00:00"^^<http://purl.org/dc/terms/W3CDTF> ;dcterms:modified "2013-03-22T06:16:25+00:00"^^<http://purl.org/dc/terms/W3CDTF> ;oa:annotatedBy<http://austese.net/lorestore/users/tdolin> ;oa:motivatedByaustese:ExplanatoryNote ;oa:hasBody<urn:uuid:68b949ea-4621-4353-bc46-2d4c37264de2> ;oa:hasTarget<urn:uuid:91030c8e-78cd-4292-8d5c-c402f04cbfaf> .

<urn:uuid:68b949ea-4621-4353-bc46-2d4c37264de2> a cnt:ContentAsText ;dc:format "text/plain" ;cnt:characterEncoding "UTF-8" ;cnt:chars "In 1 Kings 18 the prophet Elijah (called \"Elijah the Tishbite\") challenges the followers of Baal

to dress a sacrificial bullock and pray to their god to ignite the fire beneath it. When their prayers are not answered, Elijah mocks them." .

Explanatory Note RDF (continued)

<urn:uuid:91030c8e-78cd-4292-8d5c-c402f04cbfaf> a <http://www.w3.org/ns/oa#SpecificResource> ;oa:hasSelector<urn:uuid:cadfc91a-a137-45c0-a687-f626126d84ff> ;oa:hasSource<http://austese.net/repository/resources/fe4e44f4af604eebb934f981fade527d/content> .

<urn:uuid:cadfc91a-a137-45c0-a687-f626126d84ff> a oa:Choice ;oa:item<urn:uuid:35a22500-92b9-11e2-9e96-0800200c9a66> ;oa:default<urn:uuid:35a22500-92b9-11e2-9e96-0800200c9a66> ;oa:item<urn:uuid:43d4c9c0-92b9-11e2-9e96-0800200c9a66> .

<http://austese.net/lorestore/users/tdolin> a foaf:Person ;foaf:name "Tim Dolin" .

<urn:uuid:35a22500-92b9-11e2-9e96-0800200c9a66> a <http://www.w3.org/ns/oa#TextQuoteSelector> ;oa:prefix "f whom the ironical " ;oa:suffix " spoke, he was talki" ;oa:exact "Tishbite" .

<urn:uuid:43d4c9c0-92b9-11e2-9e96-0800200c9a66> a austese:RangeSelector ;austese:endElement "/div[1]/div[1]/p[23]" ;austese:endOffset "420"^^<http://www.w3.org/2001/XMLSchema#integer> ;austese:startElement "/div[1]/div[1]/p[23]" ;austese:startOffset "412"^^<http://www.w3.org/2001/XMLSchema#integer> .}

Replies

Reply RDF

<http://austese.net/lorestore/oa/5E080F7E12D492FA> {<http://austese.net/lorestore/oa/5E080F7E12D492FA> a oa:Annotation ;dc:language "en" ;dc:title "Re: Amen" ;oa:motivatedByoa:replying ;oa:annotatedAt "2012-03-26T16:34:47.673+10:00"^^dcterms:W3CDTF ;oa:hasBody<urn:uuid:E20D57674C0B45769D6B20C72560E418> ;oa:hasTarget<http://austese.net/lorestore/oa/2DA0F9596B3BA7B6> .

<urn:uuid:E20D57674C0B45769D6B20C72560E418> a cnt:ContentAsText ;cnt:characterEncoding "UTF-8" ;cnt:chars "While not deemed suitable for The BulnBuln and the Brolga, this passage is significant to the argument of Such is Life (1898). Furphy is much more concerned with exploring the 'fiction of facts' and the 'facts of fiction' in the typescript version. Returned to their previous context, the unrevised sections of the BulnBuln and the Brolga perform a different function in a significantly different narrative." .

}

Textual Variation

Annotating Textual Variation

Variation Metadata

Annotation Validation

• Validation service to check constraints from the core spec

• Validation rules implemented as SPARQL 1.1 queries

Validation Rules

{"ref": "2.1.0. (5) Body and Target Resources","url": "http://www.openannotation.org/spec/core/core.html#BodyTarget","description": "There MUST be 1 or more oa:hasTarget relationships associated

with an Annotation.","severity": "error","preconditionMessage": "No Annotations identified","precondition": "PREFIX oa: <http://www.w3.org/ns/oa#>ASK WHERE {

{ ?annotation oa:hasTarget ?t }UNION { ?annotation a oa:Annotation }

}","query": "PREFIX oa: <http://www.w3.org/ns/oa#>SELECT ?annotation WHERE {

?annotation a oa:Annotation . FILTER(NOT EXISTS { ?annotation oa:hasTarget ?t })

}"},

Tools: lorestore

lorestore Annotation Repository

– Search, query, display &validate annotations & resource maps

– REST API for creating, retrieving, updating and deleting annotations

Tools: lore

eResearch Australasia 2012

lore Annotation Client• Firefox add-on• create, edit, search, browse annotations

and resource maps

Tools: AustESE Annotator

AustESE Annotator• Extends OKFN Annoator• Create, edit & display basic annotations

Open Source

• Annotation server

– lorestore

• https://github.com/uq-eresearch/lorestore

• Annotation clients

– lore

• https://github.com/uq-eresearch/lore

– AustESE Annotator

• https://github.com/uq-eresearch/annotator

Contact

Anna Gerber

a.gerber@uq.edu.au

ITEE eResearch Group

The University of Queensland

http://itee.uq.edu.au/~eresearch/projects/austese/

Acknowledgement

The University of Queensland is proud to be in partnership with theNational eResearch Collaboration Tools and Resources (NeCTAR) projectto create a unique opportunity to develop eResearch Tools that supportthe Collaborative Authoring and Management of Electronic ScholarlyEditions. This project will benefit the Australian research community byproviding an online research and publishing platform that contributes tothe preservation and understanding of literary, classical, theological andphilosophical texts that have shaped our cultural heritage.