Annota&on  tools  and  services  

Anna  Gerber  

ITEE  eResearch  Group  The  University  of  Queensland    

AustESEAustralian Electronic Scholarly Editing

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  

AnnotaAon  ValidaAon  

•  ValidaAon  service  to  check  constraints  from  the  core  spec  

•  ValidaAon  rules  implemented  as  SPARQL  1.1  queries  

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

AnnotaAon  views:  textual  

AnnotaAon  views:  graphical  

eResearch  Australasia  2012  

SPARQL  endpoint  

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  

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  

Tools:  lore  

eResearch  Australasia  2012  

lore  Annota&on  Client  •  Firefox  add-­‐on  &  open  social  gadget  •  create,  edit,  search,  browse  annotaAons  

and  resource  maps  

Tools:  Annotator  

AustESE  Annotator  •  JavaScript  AnnotaAon  client  •  Extends  OKFN  Annoator  •  Create,  edit  &  display  basic  

annotaAons  

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.

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)  

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  

Contact  

Anna  Gerber  

a.gerber@uq.edu.au  

ITEE  eResearch  Group  

The  University  of  Queensland