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
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
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
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.
18. 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." .
}
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)
23. Open Source
• Annotation server
– lorestore
• https://github.com/uq-eresearch/lorestore
• Annotation clients
– lore
• https://github.com/uq-eresearch/lore
– AustESE Annotator Plugins
• https://github.com/uq-eresearch/annotator
– Drupalplugin
• https://github.com/uq-eresearch/austese_annotations
See http://uq-eresearch.github.io/AustESE/
Contact: Anna Gerber <a.gerber@uq.edu.au>
Editor's Notes
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