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.
Section 1: Getting to know IIIF
For more information, see http://iiif.io
What is IIIF?
The APIs
Image API
Presentation API
Interested in "motivations"? See more at http://www.openannotation.org/spec/core/core.html#Motivations
Quick Exercise: go to https://www.learniiif.org/image-api/playground and manipulate the test image
For later: https://www.learniiif.org - developed by Jack Reed - is a wonderful tutorial that you can use for reference throughout this workshop.
Fun with cropping
From this tool, https://jbhoward-dublin.github.io/IIIF-imageManipulation/index.html?imageID=https://iiif.ucd.ie/loris/ivrla:10408, try cropping specific images.
Finding interoperable material around the world
OCLC IIIF Explorer (experimental): https://researchworks.oclc.org/iiif-explorer/search?q=medieval%20manuscripts
Bayerische StaatsBibliothek: https://app.digitale-sammlungen.de/bookshelf/
Biblissima (aggregates many European libraries): https://iiif.biblissima.fr/collections/
The Vatican: https://digi.vatlib.it/mss/
A browser plug-in for finding IIIF manifests: https://github.com/2SC1815J/open-in-iiif-viewer (h/t to Niqui O'Neill)
Quick Exercise: open http://projectmirador.org/demo/
Find a manuscript that interests you from 1-5 above
Find the IIIF badge, and drag it into Mirador
Basics of the Mirador viewer (a quick tour of features)
More at http://projectmirador.org/
Quick Exercise:open http://projectmirador.org/demo/
Build a workspace view that compares two or more manuscripts
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
Annotating medieval maps: The Gough Map
Quick Exercise:
Using the manifest above
Open the map in the Mirador demo: https://projectmirador.org/demo/
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
Download the .zip or .tar of the latest version (in this case, 2.7.0)
Unzip it (it will produce a folder called "build")
From your browser, open the example.html file in that folder
Changing the list of manuscripts in your instance
Find where you downloaded Mirador
In a text editor, open the example.html file
Find a manifest you want to add
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://purl.stanford.edu/ty289vb4415/iiif/manifest", "location": "Stanford University, Burke Collection"},
Section 4: Using Your Own Images
On the web
Start by creating an account at https://archive.org
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: http://iiif.archivelab.org/iiif/url2iiif?url=
Example:
becomes
which can be used as a IIIF Image URL like: http://iiif.archivelab.org/iiif/url2iiif$e7b2a50a7e865e59840b360be60959ef779ce08218d1b2748c0fd130aa2f3319/full/full/0/default.jpg
Loading your images into Internet Archive
Uploading your images to the Internet Archive:
Go to archive.org and use the upload tool
NB: You will need to create an Internet Archive account
Once uploaded, you will have an archive.org URL like: https://archive.org/details/IMG0196_201807
From here you can find your manifest by using your item ID in the following pattern: http://iiif.archivelab.org/iiif/IMG0196_201807/manifest.json
Likewise, you can get to your specific image following this pattern: http://iiif.archivelab.org/iiif/IMG0196_201807/full/full/270/default.jpg
General pattern: http://iiif.archivelab.org/iiif/:item_id
Other Options
Advanced Preview: Running an image server locally
Install Docker
Use https://hub.docker.com/r/bdlss/loris-grok-docker or another loris container
Follow the directions above to set up the docker-image locally
When you start the container use a command like
docker run -d -v /Users/blalbrit/Desktop/July2019/July52019:/usr/local/share/images -p 5004:5004 bdlss/loris-grok-dockerreplacing the path to your local image folder and the docker-image if necessary
Section 5: Creating Manifests
Quick refresher - Presentation API
Using the Oxford Manifest Editor: http://iiif.bodleian.ox.ac.uk/manifest-editor
Using the Oxford Manifest Editor (different host): https://iiif-manifest-editor.textandbytes.com
Using the Digirati Manifest Editor (version 3 API only): https://iiif-manifest-editor-live-demo.netlify.com/
Quick Exercise
Using the Oxford Manifest Editor, create and download a 2-image manifest of your own.
Find default.jpg URL
Except with Parker, replace / with %252F to mirror service @id
Save to GitHub Gist
Last updated
