Interoperability and Medieval Manuscripts
  • Overview
  • Day 1 - Getting to know IIIF and Mirador
  • Day 2 - Applying IIIF, Thinking About The Real Thing
  • Day 3 - Sharing with IIIF
  • Tips and Tricks
  • Additional Reading
Powered by GitBook
On this page
  • Section 1: Getting to know IIIF
  • Basics of the Mirador viewer (a quick tour of features)
  • Section 2: Creating annotations and transcriptions using Mirador
  • Section 3: Getting Mirador set up for yourself
  • Section 4: Using Your Own Images
  • Section 5: Creating Manifests

Was this helpful?

Day 1 - Getting to know IIIF and Mirador

A gentle introduction to the International Image Interoperability Framework and an interactive viewer that allows for comparison and annotation.

PreviousOverviewNextDay 2 - Applying IIIF, Thinking About The Real Thing

Last updated 5 years ago

Was this helpful?

Section 1: Getting to know IIIF

For more information, see

What is IIIF?

The APIs

  1. Image API

  2. Presentation API

Interested in "motivations"? See more at

Quick Exercise: go to and manipulate the test image

For later: - developed by Jack Reed - is a wonderful tutorial that you can use for reference throughout this workshop.

Fun with cropping

From this tool, , try cropping specific images.

Finding interoperable material around the world

  1. OCLC IIIF Explorer (experimental):

  2. Bayerische StaatsBibliothek:

  3. Stanford: ,

  4. Biblissima (aggregates many European libraries):

  5. The Vatican:

  1. Find a manuscript that interests you from 1-5 above

  2. Find the IIIF badge, and drag it into Mirador

Basics of the Mirador viewer (a quick tour of features)

  1. Build a workspace view that compares two or more manuscripts

  2. If you want, take a screenshot or picture of your comparison and share on Twitter: #IIIF

Section 2: Creating annotations and transcriptions using Mirador

Overview of Annotation Tools (structuring data, actual tools for bounding boxes and coloration, tags, annotation bodies, etc.)

Creating annotations in Mirador

  1. Annotating medieval maps: The Gough Map

Quick Exercise:

  • Using the manifest above

  • Using the annotation tools in Mirador, begin to describe what you see

Examples:

Find London. Draw a shape around it and annotate it as such.

Find the Isle of Orkney on the Gough map. Draw a shape around it and annotate it as such.

Create a route from London to another city on the map (virtual pilgrimage?)

Find other features of interest on either map and annotate them.

If you want, take a screenshot or picture of your annotations and share on Twitter using our hashtag #MirMed2019

NB: these annotations will not persist once the browser session is closed - to be persistent, there needs to be a back-end for storage.

Section 3: Getting Mirador set up for yourself

Installing on your laptop

  1. Download the .zip or .tar of the latest version (in this case, 2.7.0)

  2. Unzip it (it will produce a folder called "build")

  3. From your browser, open the example.html file in that folder

Changing the list of manuscripts in your instance

  1. Find where you downloaded Mirador

  2. In a text editor, open the example.html file

  3. Find a manifest you want to add

Section 4: Using Your Own Images

On the web

Start by creating an account at https://archive.org

Example:

becomes

Loading your images into Internet Archive

  1. Uploading your images to the Internet Archive:

    1. Go to archive.org and use the upload tool

    2. NB: You will need to create an Internet Archive account

    3. General pattern: http://iiif.archivelab.org/iiif/:item_id

Other Options

Advanced Preview: Running an image server locally

  1. Install Docker

  2. Follow the directions above to set up the docker-image locally

  3. When you start the container use a command likedocker run -d -v /Users/blalbrit/Desktop/July2019/July52019:/usr/local/share/images -p 5004:5004 bdlss/loris-grok-docker replacing the path to your local image folder and the docker-image if necessary

Section 5: Creating Manifests

Quick refresher - Presentation API

Quick Exercise

  1. Using the Oxford Manifest Editor, create and download a 2-image manifest of your own.

    1. Find default.jpg URL

    2. Except with Parker, replace / with %252F to mirror service @id

  2. Save to GitHub Gist

  3. Display using Mirador

A browser plug-in for finding IIIF manifests: (h/t to Niqui O'Neill)

Quick Exercise: open

More at

Quick Exercise:open

Manifest:

Open the map in the Mirador demo:

Go to

Add your manifest to the top of the list in the following format (replacing the URL for the manifest, and the location, as appropriate. An example: { "manifestUri": "https:///iiif/manifest", "location": "Stanford University, Burke Collection"},

We'll be using the Internet Archive IIIF service. If you have a non-IIIF image that is already online, you can put the URL to the image at the end of this URL:

which can be used as a IIIF Image URL like:

Once uploaded, you will have an archive.org URL like:

From here you can find your manifest by using your item ID in the following pattern:

Likewise, you can get to your specific image following this pattern:

Use or another loris container

Using the Oxford Manifest Editor:

Using the Oxford Manifest Editor (different host):

Using the Digirati Manifest Editor (version 3 API only):

Example:

http://iiif.io
http://www.openannotation.org/spec/core/core.html#Motivations
https://www.learniiif.org/image-api/playground
https://www.learniiif.org
https://jbhoward-dublin.github.io/IIIF-imageManipulation/index.html?imageID=https://iiif.ucd.ie/loris/ivrla:10408
https://researchworks.oclc.org/iiif-explorer/search?q=medieval%20manuscripts
https://app.digitale-sammlungen.de/bookshelf/
https://exhibits.stanford.edu/mss
https://exhibits.stanford.edu/burke_mss
https://iiif.biblissima.fr/collections/
https://digi.vatlib.it/mss/
https://github.com/2SC1815J/open-in-iiif-viewer
http://projectmirador.org/demo/
http://projectmirador.org/
http://projectmirador.org/demo/
https://iiif.bodleian.ox.ac.uk/iiif/manifest/e4dc07a6-3ec8-414a-aa92-2e9815f93276.json
https://projectmirador.org/demo/
https://github.com/ProjectMirador/mirador/releases
purl.stanford.edu/ty289vb4415
http://iiif.archivelab.org/iiif/url2iiif?url=
http://iiif.archivelab.org/iiif/url2iiif?url=https://ia802808.us.archive.org/12/items/IMG0196_201807/IMG_0196.JPG
http://iiif.archivelab.org/iiif/url2iiif$e7b2a50a7e865e59840b360be60959ef779ce08218d1b2748c0fd130aa2f3319
http://iiif.archivelab.org/iiif/url2iiif$e7b2a50a7e865e59840b360be60959ef779ce08218d1b2748c0fd130aa2f3319/full/full/0/default.jpg
https://archive.org/details/IMG0196_201807
http://iiif.archivelab.org/iiif/IMG0196_201807/manifest.json
http://iiif.archivelab.org/iiif/IMG0196_201807/full/full/270/default.jpg
http://www.iiifhosting.com/
https://hub.docker.com/r/bdlss/loris-grok-docker
http://iiif.bodleian.ox.ac.uk/manifest-editor
https://iiif-manifest-editor.textandbytes.com
https://iiif-manifest-editor-live-demo.netlify.com/
https://gist.githubusercontent.com/blalbrit/729f8f8736c7750d0a0aa08ddca8fc1d/raw/088e12ffc0073c932b01323504e68cafb99935e6/manifest.json