Open Annotation Roll Out meeting

1. Annotations Supporting Scholarly Editing
Anna Gerber
ITEE eResearch Group
The University of Queensland

2. 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

3. Critical Apparatus
Critical Edition with apparatus as footnotes
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.
Apparatus

4. AustESE
eResearchTools to Support the Collaborative Authoring and Management of Electronic
Scholarly Editions
http://itee.uq.edu.au/~eresearch/projects/austese/
Funded by

5. 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

6. Extending OA Motivation

7. Annotating Transcriptions & Images

8. Explanatory Note

9. 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." .

10. 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> .
}

11. Replies

12. 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." .
}

13. Textual Variation

14. Annotating Textual Variation

15. Variation Metadata

16. Annotation Validation
• Validation
service to
check
constraints
from the core
spec
• Validation rules
implemented
as SPARQL 1.1
queries

17. 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 })
}"
},

18. Tools: lorestore
lorestore Annotation Repository
– Search, query, display &validate
annotations & resource maps
– REST API for
creating, retrieving, updating and
deleting annotations

19. Tools: lore
lore Annotation Client
• Firefox add-on
• create, edit, search, browse annotations
and resource maps
eResearch Australasia 2012

20. Tools: AustESE Annotator
AustESE Annotator
• Extends OKFN Annoator
• Create, edit & display basic annotations

21. 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

22. Contact
http://itee.uq.edu.au/~eresearch/projects/austese/
Anna Gerber
a.gerber@uq.edu.au
ITEE eResearch Group
The University of Queensland

23. Acknowledgement
The University of Queensland is proud to be in partnership with the
National eResearch Collaboration Tools and Resources (NeCTAR) project
to create a unique opportunity to develop eResearch Tools that support
the Collaborative Authoring and Management of Electronic Scholarly
Editions. This project will benefit the Australian research community by
providing an online research and publishing platform that contributes to
the preservation and understanding of literary, classical, theological and
philosophical texts that have shaped our cultural heritage.