Your SlideShare is downloading. ×
Supporting Open Scholarly Annotation
Upcoming SlideShare
Loading in...5

Thanks for flagging this SlideShare!

Oops! An error has occurred.

Saving this for later? Get the SlideShare app to save on your phone or tablet. Read anywhere, anytime – even offline.
Text the download link to your phone
Standard text messaging rates apply

Supporting Open Scholarly Annotation


Published on

Presented at I Annotate 3 April 2014

Presented at I Annotate 3 April 2014

Published in: Technology

1 Like
  • Be the first to comment

No Downloads
Total Views
On Slideshare
From Embeds
Number of Embeds
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

No notes for slide
  • In this edition, variations between the versions were split into apparatus appearing at the foot of the page and an appendix listing editor’s emendationsSince the mid-1990s, scholarly editors have experimented with Web-based electronic editions, producing exemplary models such as The William Blake Archive, The Rossetti Archive, The Mark Twain Project, Nietzsche Source, Electronic Kierkegaard and the Samuel Beckett Digital Manuscript project. But, despite such advances, these previous efforts provide one-off handcrafted solutions that address project-specific issues but don’t facilitate re-use or interoperability of digital tools and data
  • The AustESE Workbench adopts a component-based architecture to integrate several scholarly editing tools. This means that resources such as transcriptions and images of versions of literary works are displayed via a variety of views within the Workbench. The presentation of these resources (e.g., rendering them from a TEI/XML document) may be different for each view. For example, for the collation tools, markup is displayed to indicate textual variation between selected versions (additions, deletions, transposition). Most annotations within an electronic edition refer to parts of resources such as individual words or paragraphs. To support annotation across the different versions, tools and views encapsulated within the Workbench, we need to be able to capture, describe and display annotation selections consistently across all representations of a resource (including across different formats e.g. HTML or PDF).
  • Also supporting multiple instances per pageFuzzy matching
  • Example of custom annotation subclassThis also shows our use of multiple selectors to support the fuzzy matching
  • Our definition of annotations: Annotations are additional information attached to a digital resource or part of a resource that do not modify the original content of the resource
  • We still use our Firefox plugin lore for annotations with multiple targets – need to look to Annotator 2.0 for options for alternative UI that is not tied to a single DOM
  • Transcript

    • 1. Supporting Open Scholarly Annotation Anna Gerber ITEE eResearch Group The University of Queensland
    • 2. Image: Robbery under arms / Rolf Boldrewood ; edited by P.Eggert and E. Webby, University of Queensland Press, St. Lucia, Qld, 2006 Scholarly Editions Apparatus • 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. Scholarly Editing Annotation Use Cases • Facilitate collaborative discussion of texts, sources and facsimiles – Comments – Questions – Replies • Describe textual variation for apparatus – annotations linking multiple versions • Align parts of transcriptions and facsimile images • Record notes – Textual notes (about production of text) – Explanatory notes (meaning, historical context etc) – Link texts with facsimiles, reference secondary sources
    • 4. Tools: lorestore lorestore Annotation Repository Search, query, display, validate & subscribe to annotations & resource maps Supports public and private annotations Web UI to administer content and users Optionally manage user accounts and permissions or hook into existing accounts system e.g. drupal
    • 5. Annotation Validation • Validation service to check constraints from the core spec • Validation rules implemented as SPARQL 1.1 queries
    • 6. SPARQL endpoint
    • 7. REST API • REST API for creating, retrieving, updating, deleting and querying annotations & resource maps • Supports multiple serialisations e.g. RDF/XML, JSON-LD • Documented in developer docs built into lorestore web UI • Atom feeds for query results eResearch Australasia 2012
    • 8. Annotation views
    • 9. AustESE Workbench eResearch Australasia 2013 • Transcriptions rendered to HTML from TEI/XML or plain text: • View Resource page • Reading View •Rendered from MVD: • Compare View • Table Apparatus • Export to PDF • Export to Word • Etc. •Images at different zoom levels
    • 10. Challenges • Support the various types of annotation required by scholarly editors • Annotate regions of text or images regardless of rendered view – E.g. HTML rendered directly from TEI vs as rendered via collation tool, Images viewed directly vs images displayed through lightbox tool • Allow annotation while transcriptions are still being edited/corrected • Query and display annotations of text selections, textual variation across versions – When large sections text might have been transposed • Restrict Annotation to certain parts of site
    • 11. Tools: Annotator AustESE Annotator • JavaScript Annotation client • Extends OKFN Annotator • Create, edit & display basic annotations
    • 12. AustESE Annotator Plugins LoreStore Maps the internal JSON data structure used to represent annotations in the Annotator system to an equivalent OA JSON-LD serialization. Also implements a protocol for communicating with our OA-compliant annotation repository. Image Enables the selection and annotation of rectangular regions of images CharacterRange Calculates character offsets and text selections used to identify the part of the (text-based) resource being annotated across representations. Motivation Allows users to attach custom Motivations (e.g. ExplanatoryNote, TextualNote, Glossary) to annotations. Reply Enables discussion between editors, scholars and readers. Prov Records and displays provenance (creator, creation time) for an Annotation.
    • 13. Extending OA Motivation
    • 14. Motivations Annotator Plugin
    • 15. Explanatory Note Model
    • 16. Reply Annotator Plugin eResearch Australasia 2012
    • 17. Model for Replies
    • 18. Reply RDF <> { <> 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<> . <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." . }
    • 19. Image Annotator Plugin
    • 20. Using the Plugins jQuery(el).annotator({'bindToDocument': true}) .annotator('addPlugin', 'Image') .annotator('addPlugin', 'Prov') .annotator('addPlugin', 'CharRangeSelection') .annotator('addPlugin', 'LoreStore') .annotator('addPlugin', 'Reply') .annotator('addPlugin', 'Motivations', { "showField": false, // will display via provplugin instead "motivations": [ { value: "oa:Commenting", label: "Comment"}, { value: "oa:Questioning", label: "Question" }, { value: "austese:TextualNote", label: "Textual Note" }, … eResearch Australasia 2012
    • 21. DrupalPlugin • Drupal 7 plugin to integrate AustESE annotator plugins with the AustESE Workbench – Loads and configures Annotator and plugins for all transcriptions and content images – Provides search UI – Adds HTML5 data attributes to identify transcriptions and images (independently of format or page URI)
    • 22. Tools: lore eResearch Australasia 2012 lore Annotation Client • Firefox add-on • create, edit, search, browse annotations and resource maps
    • 23. Open Source • Annotation server – lorestore • • Annotation clients – lore • – AustESE Annotator Plugins • – Drupalplugin • See Contact: Anna Gerber <>