AustESE annotation tools and services. Presented at OA Roll Out meeting, Manchester June 2013.

1. Annota&on
tools
and
services
Anna
Gerber
ITEE
eResearch
Group
The
University
of
Queensland
AustESEAustralian Electronic Scholarly Editing

2. Tools:
lorestore
lorestore
Annota&on
Repository
Search,
query,
display,
validate
&
subscribe
to
annotaAons
&
resource
maps
Web
UI
to
administer
content
and
users
OpAonally
manage
user
accounts
and
permissions
or
hook
into
exisAng
accounts
system
e.g.
drupal

3. AnnotaAon
ValidaAon
• ValidaAon
service
to
check
constraints
from
the
core
spec
• ValidaAon
rules
implemented
as
SPARQL
1.1
queries

4. ValidaAon
Rules
{
"ref":
"2.1.0.
(5)
Body
and
Target
Resources",
"url":
"hUp://www.openannotaAon.org/spec/core/core.html#BodyTarget",
"descripAon":
"There
MUST
be
1
or
more
oa:hasTarget
relaAonships
associated
with
an
AnnotaAon.",
"severity":
"error",
"precondiAonMessage":
"No
AnnotaAons
idenAfied",
"precondiAon":
"PREFIX
oa:
<hUp://www.w3.org/ns/oa#>
ASK
WHERE
{
{
?annotaAon
oa:hasTarget
?t
}
UNION
{
?annotaAon
a
oa:AnnotaAon
}
}",
"query":
"PREFIX
oa:
<hUp://www.w3.org/ns/oa#>
SELECT
?annotaAon
WHERE
{
?annotaAon
a
oa:AnnotaAon
.
FILTER(NOT
EXISTS
{
?annotaAon
oa:hasTarget
?t
})
}"
},

5. AnnotaAon
views:
textual

6. AnnotaAon
views:
graphical
eResearch
Australasia
2012

7. SPARQL
endpoint

8. REST
API
• REST
API
for
creaAng,
retrieving,
updaAng,
deleAng
and
querying
annotaAons
&
resource
maps
• Documented
in
developer
docs
built
into
lorestore
web
UI
• Atom
feeds
for
query
results
eResearch
Australasia
2012

9. lorestore
implementaAon
• Implemented
as
a
Java
web
applicaAon
• Available
as
a
prebuilt
war
file
or
as
source
(build
using
Apache
Maven)
• Configured
via
properAes
files
• Can
be
customized
using
war
overlays

10. Tools:
lore
eResearch
Australasia
2012
lore
Annota&on
Client
• Firefox
add-­‐on
&
open
social
gadget
• create,
edit,
search,
browse
annotaAons
and
resource
maps

11. Tools:
Annotator
AustESE
Annotator
• JavaScript
AnnotaAon
client
• Extends
OKFN
Annoator
• Create,
edit
&
display
basic
annotaAons

12. AustESE
Annotator
Plugins
LoreStore
Maps
the
internal
JSON
data
structure
used
to
represent
annotaAons
in
the
Annotator
system
to
an
equivalent
OA
JSON-­‐LD
serializaAon.
Also
implements
a
protocol
for
communicaAng
with
our
OA-­‐compliant
annotaAon
repository.
Image
Enables
the
selecAon
and
annotaAon
of
rectangular
regions
of
images
CharacterRange
Calculates
character
offsets
and
text
selecAons
used
to
idenAfy
the
part
of
the
(text-­‐based)
resource
being
annotated
across
representaAons.
Mo&va&on
Allows
users
to
aUach
custom
MoAvaAons
(e.g.
ExplanatoryNote,
TextualNote,
Glossary)
to
annotaAons.
Reply
Enables
discussion
between
editors,
scholars
and
readers.
Prov
Records
and
displays
provenance
(creator,
creaAon
Ame)
for
an
AnnotaAon.

13. Drupal
Plugin
• Drupal
7
plugin
to
integrate
AustESE
annotator
plugins
with
the
AustESE
Workbench
– Loads
and
configures
Annotator
and
plugins
for
all
transcripAons
and
content
images
– Provides
search
UI
– Adds
HTML5
data
aUributes
to
idenAfy
transcripAons
and
images
(independently
of
format
or
page
URI)

14. Open
Source
• AnnotaAon
server
– lorestore
• hUps://github.com/uq-­‐eresearch/lorestore
• AnnotaAon
clients
– lore
• hUps://github.com/uq-­‐eresearch/lore
– AustESE
Annotator
Plugins
• hUps://github.com/uq-­‐eresearch/annotator
– Drupal
plugin
• hUps://github.com/uq-­‐eresearch/austese_annotaAons
See
hUp://uq-­‐eresearch.github.io/AustESE/
for
more
detail

15. Contact
Anna
Gerber
a.gerber@uq.edu.au
ITEE
eResearch
Group
The
University
of
Queensland