Digital Manuscripts Toolkit

The journey so far...

Monica Messaggi Kaya

@monicams

About me

Javascript / Front-end developer

Bodleian Libraries
University of Oxford

What is DMT?

Easy to use toolkit

focus on the study and presentation of medieval manuscripts, working with digital materials in innovative and exciting ways

Project blog at http://dmt.bodleian.ox.ac.uk

Why?

Content is available through a great many different viewers, websites, and approaches.

Varied levels of quality, functionality and ease of access, and to lots of duplicated effort

AIMS

Use, develop, and repurpose digital manuscripts

and other cultural heritage materials

International Image Interoperability Framework

Two Linked Data-based APIs - an Image API and a Presentation API - to allow reuse of content, creating a global network whereby institutions can share materials and allow innovative development.

Deploy an image server that supports the IIIF Image API

Steps to work with IIIF

Publish metadata about your image-based objects that complies to IIIF Presentation API

Deploy and integrate software that allows you to discover and display IIIF-compliant image resources

The IIIF Image API URI for requesting an image must conform to the following URI Template:

{scheme}://{server}{/prefix}/{identifier}/{region}/{size}/{rotation}/{quality}.{format}

IIIF Image API

For example:

http://www.example.org/image-service/abcd1234/full/full/0/default.jpg

Demo: http://iiif.io/#try-it

Digital images are a container for much of the information content in the Web-based delivery of “stuff” *.

IIIF Presentation API

* museum objects, books, newspapers, letters, manuscripts, maps, scrolls, single sheet collections, and digital surrogates of textiles, realia and ephemera.

Each manifest must, and is very likely to, have one sequence, but may have more than one.

Primary Resources

Each sequence must have at least one canvas and is likely to have more than one.

Each canvas should have one or more content resources associated with it.

Zero is possible but unlikely; it represents the case where the page exists (or existed) but has not been digitized.

Descriptive Properties

label
A human readable label, name or title for the resource.
metadata
A list of short descriptive entries, given as pairs of human readable label and value to be displayed to the user.

thumbnail
A small image that depicts or pictorially represents the resource that the property is attached to.

Presentation Resource Properties

Rights and Licensing Properties

attribution
A human readable label that must be displayed when the resource it is associated with is displayed or used.

logo
A small image that represents an individual or organization associated with the resource it is attached to.

license
A link to an external resource that describes the license or rights statement under which the resource is being used.

Presentation Resource Properties

Technical Properties

@id - @type - Height - viewingDirection – viewingHint

Linking Properties

Related – service – seeAlso – within – startCanvas

Presentation Resource Properties

Using JSON for linking data (JSON-LD) to organise and connect

Json - ease of developement
Linked data - play nice with others

How?

http://iiif.io/api/presentation/2.0/#primary-resource-types-1

{
  // Metadata about this manifest file
  "@context":"http://iiif.io/api/presentation/2/context.json",
  "@id":"http://www.example.org/iiif/book1/manifest",
  "@type":"sc:Manifest",

  // Descriptive metadata about the object/work
  "label": "Book 1",
  "metadata": [
    {"label":"Author", "value":"Anne Author"},
    {"label":"Published", "value": [
        {"@value": "Paris, circa 1400", "@language":"en"},
        {"@value": "Paris, environ 1400", "@language":"fr"}
      ]
    },
    {"label":"Source", 
     "value": "<span>From: <a href=\"http://example.org/db/1.html\">Some Collection</a></span>"}
  ],
  "description":"A longer description of this example book. It should give some real information.",
  "thumbnail": {
    "@id": "http://www.example.org/images/book1-page1/full/80,100/0/default.jpg",
    "service": {
      "@context":"http://iiif.io/api/image/2/context.json",
      "@id":"http://www.example.org/images/book1-page1",
      "profile":"http://iiif.io/api/image/2/level1.json"
    }
  },

  // Presentation Information
  "viewingDirection": "right-to-left",
  "viewingHint": "paged",

  // Rights Information
  "license":"http://www.example.org/license.html",
  "attribution":"Provided by Example Organization",
  "logo": "http://www.example.org/logos/institution1.jpg",

  // Links
  "related":{
    "@id": "http://www.example.org/videos/video-book1.mpg",
    "format": "video/mpeg"
  },
  "service": {
    "@context": "http://example.org/ns/jsonld/context.json",
    "@id": "http://example.org/service/example",
    "profile": "http://example.org/docs/example-service.html"
  },
  "seeAlso":"http://www.example.org/library/catalog/book1.xml",
  "within":"http://www.example.org/collections/books/",

  // List of sequences
  "sequences" : [
      {
        "@id":"http://www.example.org/iiif/book1/sequence/normal",
        "@type":"sc:Sequence",
        "label":"Current Page Order"
        // sequence's page order should be included here, see below...
      }
      // Any additional sequences can be referenced here...
  ]
}

Image server - deliver easily installable versions of IIP and Loris

(probably via Docker images)

DMT progress

Metadata IIIF compliance

via Manifest Factory (python)

DMT progress

Discovery: Digital Mushaf project

This reunites an early Qur’anic manuscript which had been split and dispersed and is now held by four institutions: Bodleian (UK), Wolfenbuttel (Germany), Chester Beatty Library (Dublin), and the BnF (Paris)

DMT progress

Display IIIF-compliant image resources

Using Mirador on the Mushaf pilot project

Another example: UniversalViewer - demo Arch. G b.6

DMT progress

Research of existing tools and libraries

To name a few: Grunt, Node.js, jQuery, Karma, underscore.js, pubsub.js, handlebars.js, URI.js, mousetrap.js, ZeroClipboard.js, d3.js, state-machine.js, tinymce.js, qTip2, sinon.js, Jasmine, Istanbul, Travis and more.