Annotations as Linked Data with Fedora4 and Triannon
5 likes1,760 views
The document discusses the implementation of Stanford University Libraries' annotation system as linked data using Fedora4 and Triannon, emphasizing the use of RDF for managing annotations. It outlines requirements for creating, managing, and displaying annotations along with technical specifications such as JSON-LD formats and the integration with Solr for search capabilities. The project aims for modularity, maintainability, and ease of use for developers in an LDP environment.
![Client App: Search and Display
Triannon SolrClient App
http://triannon-solr/by_target?url=purl.stanford.edu/bd136jk4522
'response'=>{'numFound'=>3,'start'=>0,'maxScore'=>1.0,'docs'=>[
{
'id'=>'98206ec8-4def-44b8-b190-648d8224ce1c’,
'anno_jsonld'=>'{"@context":"http://www.w3.org/ns/oa.jsonld","@graph":
[{"@id":"_:g70038924372700","@type":["dctypes:Text","cnt:ContentAsText"], "format":"text/plain”,
"chars":"Portland is somewhere here. Also Dragons”},{"@id":"https://
triannon-dev.stanford.edu/annotations/98206ec8-4def-44b8-
b190-648d8224ce1c","@type":"oa:Annotation","hasBody":"_:g70038924372700","hasTarget":"http://
purl.stanford.edu/bd136jk4522","motivatedBy":"oa:commenting"}]}',
...},
{
'id'=>'f691b921-6f54-415b-9dfb-0d017f0d8ada',
...](https://image.slidesharecdn.com/code4lib-triannon-final-150211120341-conversion-gate01/85/Annotations-as-Linked-Data-with-Fedora4-and-Triannon-28-320.jpg)
Annotations as Linked Data with Fedora4 and Triannon
- 1. STANFORD UNIVERSITY LIBRARIES Annotations as Linked Data with Fedora4 and Triannon (A Real Use Case for RDF!) C O D E 4 L I B 2015 PO R T L A N D , OR FE B R U A R Y 11 Rob Sanderson / [email protected] / @azaroth42 Naomi Dushay / [email protected]
- 2. STANFORD UNIVERSITY LIBRARIES Annotations as Linked Data with Fedora4 and Triannon (A Real Use Case for RDF!) C O D E 4 L I B 2015 PO R T L A N D , OR FE B R U A R Y 11 Rob Sanderson / [email protected] / @azaroth42 Naomi Dushay / [email protected]
- 11. Where are the Dragons? :(
- 12. Triannon: Putting the Dragons Back in Portland since sometime last week Requirements: • Create and manage tags/annotations in any client or environment • Retrieve tags/annotations to display in any client • With the identifiers of Works, not of catalog views Need: • A model for annotations • A format to serialize them into • A protocol to transfer the serializations between systems • Implementations!
- 13. JSON Annotation Format {! "@context": "http://www.w3.org/ns/oa-context-20130208.json",! "@id": "http://www.example.org/annotations/1",! "@type": "oa:Annotation”,! "motivatedBy":"oa:commenting",! "hasBody": {! "@type": "cnt:ContentAsText",! "chars": "Portland is somewhere here. Also Dragons",! "format": "text/plain"! },! "hasTarget": "http://purl.stanford.edu/bd136jk4522#xywh=..."! } !
- 14. JSON-LD Annotation Format {! "@context": "http://www.w3.org/ns/oa-context-20130208.json",! "@id": "http://www.example.org/annotations/1",! "@type": "oa:Annotation”,! "motivatedBy":"oa:commenting",! "hasBody": {! "@type": "cnt:ContentAsText",! "chars": "Portland is somewhere here. Also Dragons",! "format": "text/plain"! },! "hasTarget": "http://purl.stanford.edu/bd136jk4522#xywh=..."! } !
- 15. JSON-LD Annotation Format {! "@context": "http://www.w3.org/ns/oa-context-20130208.json",! "@id": "http://www.example.org/annotations/1",! "@type": "oa:Annotation”,! "motivatedBy":"oa:commenting",! "hasBody": {! "@type": "cnt:ContentAsText",! "chars": "Portland is somewhere here. Also Dragons",! "format": "text/plain"! },! "hasTarget": "http://purl.stanford.edu/bd136jk4522#xywh=..."! } ! Dirty not-so-secret time...
- 16. RDF Annotation Format {! "@context": "http://www.w3.org/ns/oa-context-20130208.json",! "@id": "http://www.example.org/annotations/1",! "@type": "oa:Annotation”,! "motivatedBy":"oa:commenting",! "hasBody": {! "@type": "cnt:ContentAsText",! "chars": "Portland is somewhere here. Also Dragons",! "format": "text/plain"! },! "hasTarget": "http://purl.stanford.edu/bd136jk4522#xywh=..."! } ! It's actually RDF, following the Open Annotation model
- 19. Reality is More Complex
- 20. In Reality ... • Multiple resources to manage, each requires a POST • Binary or external resources with descriptions tricky • Multiple JSON-LD contexts complex (IIIF, OA, ...) Want: • Ease of use/implementation for annotation client • Ability to swap back-end to other LDP system • Integration with Rails environment • Search with Solr (easy) not SPARQL (less easy)
- 21. Triannon
- 23. Triannon: Implementation Goals • Rapid Development • Modular • Re-Usable • Deployable • Maintainable
- 24. Triannon: Rails Engine Gem REST over HTTP Create POST jsonld, turtle, rdfxml Read GET " Update PUT/PATCH " Delete DELETE (id) Model ActiveRecord ActiveModel LDP View (for apps and developers) jsonld, turtle, rdfxml Controller http://github.com/sul-dlss/triannon
- 26. It’s the Graph, Baby!
- 27. Rails App (SearchWorks) ActiveTriples ld4l-open_annotation_rdf triple store (in memory) RDF SearchWorks: Create, Update, Delete Triannon id html form jsonld from RDF::Graph
- 28. Client App: Search and Display Triannon SolrClient App http://triannon-solr/by_target?url=purl.stanford.edu/bd136jk4522 'response'=>{'numFound'=>3,'start'=>0,'maxScore'=>1.0,'docs'=>[ { 'id'=>'98206ec8-4def-44b8-b190-648d8224ce1c’, 'anno_jsonld'=>'{"@context":"http://www.w3.org/ns/oa.jsonld","@graph": [{"@id":"_:g70038924372700","@type":["dctypes:Text","cnt:ContentAsText"], "format":"text/plain”, "chars":"Portland is somewhere here. Also Dragons”},{"@id":"https:// triannon-dev.stanford.edu/annotations/98206ec8-4def-44b8- b190-648d8224ce1c","@type":"oa:Annotation","hasBody":"_:g70038924372700","hasTarget":"http:// purl.stanford.edu/bd136jk4522","motivatedBy":"oa:commenting"}]}', ...}, { 'id'=>'f691b921-6f54-415b-9dfb-0d017f0d8ada', ...
- 29. Rails App (SearchWorks) ActiveTriples ld4l-open_annotation_rdf triple store (in memory) RDF SearchWorks: Read and Display • Easy Access to Relevant Info from jsonld • Rapid Development • Modular • Maintainable Triannon Solr jsonld as RDF::Graph Search for annos
- 30. LDP API Fedora 4Solr CRUD Search / Read CRUDCUD Client Application Client Application Client Application Triannon
- 31. STANFORD UNIVERSITY LIBRARIES Thank You! February 11th, 2015 [email protected] [email protected]