Tutorial 1: IIIF, Mirador, and Book History Content

Participants will come away with a better understanding of what IIIF content is, and how to maximize the research value of digitized collections with commonly used tools.

Section 1: What is IIIF?

For more information, see http://iiif.io

For John Unsworth's discussion of scholarly primitives, see http://people.virginia.edu/~jmu2m//Kings.5-00/primitives.html

Two APIs

• Image API

• Presentation API

Image API

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 these workshops.

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.

Presentation API

"Manifest" - this is the bundle of information that IIIF relies on to enable sharing of books and manuscripts across viewers and institutions. Often represented by the icon, or by a URL.

To learn more, read an overview at https://www.learniiif.org/presentation-api/ or the full specification at https://iiif.io/api/presentation/2.1/

Example 1: Comparing copies of Sidereus nuncius from different repositories

Note: I'll demonstrate this live, and then we'll practice together in Section 2 below.

Step 1: Find desired content at multiple repository websites (some example below)

• Stanford Libraries (Venice): https://searchworks.stanford.edu/view/1204402

• Boston Public Library (Frankfurt): https://archive.org/details/sidereusnunciusm00gali_0/page/n4/mode/2up

• Smithsonian (Venice): https://archive.org/details/sidereusnunciusm00gali/page/n6/mode/2up

• Smithsonian (Venice): https://archive.org/details/Sidereusnuncius00Gali/page/1/mode/2up

• Linda Hall Library: http://lhldigital.lindahall.org/cdm/compoundobject/collection/astro_early/id/68/rec/14

• Linda Hall Library: http://lhldigital.lindahall.org/cdm/compoundobject/collection/astro_early/id/141/rec/2

• BNF: https://gallica.bnf.fr/ark:/12148/bpt6k9907264.r=sidereus?rk=21459;2

• BSB (Frankfurt): https://app.digitale-sammlungen.de/bookshelf/bsb10859768

• BSB (Frankfurt): https://app.digitale-sammlungen.de/bookshelf/bsb10859768

• Cambridge University Library (Venice): https://cudl.lib.cam.ac.uk/view/PR-ADAMS-00005-00061-00001/1

Step 2: Find IIIF icon for desired content (or manifest URL)

• Some repositories will have the IIIF icon where you can either drag and drop the object into Mirador or copy the URL for the manifest. Others are a bit more difficult...

• Tips & Tricks:

  • For materials at the Internet Archive, the IIIF manifest is constructed by:

    • finding the item ID

    • inserting it in the following URL structure: https://iiif.archivelab.org/iiif/{item ID}/manifest.json

    • for example:

      • https://archive.org/details/Sidereusnuncius00Gali/page/1/mode/2up becomes

      • https://iiif.archivelab.org/iiif/Sidereusnuncius00Gali/manifest.json

  • IIIF access for materials in CONTENTdm can be found at https://researchworks.oclc.org/iiif-explorer/

  • Material in Gallica, from the Bibliothèque national de France, is available via IIIF as well. To construct a manifest for these, use the following pattern:

    • https://gallica.bnf.fr/iiif/ark:/12148/{ARK_Name}/manifest.json

      • so https://gallica.bnf.fr/ark:/12148/bpt6k9907264.r=sidereus?rk=21459;2 becomes

      • https://gallica.bnf.fr/iiif/ark:/12148/bpt6k9907264/manifest.json

Step 3: Bring together items for comparison in Mirador

• I'll demonstrate this here, and we'll practice together in Section 2 below

Section 2: Finding Content

Finding interoperable material around the world

1. OCLC IIIF Explorer (experimental): https://researchworks.oclc.org/iiif-explorer/

2. Bayerische StaatsBibliothek: https://app.digitale-sammlungen.de/bookshelf/

3. Stanford Special Collections: https://bit.ly/stanford_iiif

4. Biblissima (aggregates many European libraries): https://iiif.biblissima.fr/collections/

5. The Vatican: https://digi.vatlib.it/

6. Harvard: https://library.harvard.edu/digital-collections

7. Many, many more: https://bit.ly/iiif_collections

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/

1. Find a book or manuscript that interests you from 1-7 above

2. Find the IIIF badge, and drag it into Mirador, or the IIIF manifest URL and add it to the Mirador workspace

Section 3: The Basics of Mirador

More at http://projectmirador.org/

We'll do a brief tour together, and then explore on our own.

Quick Exercise:open http://projectmirador.org/demo/

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

Conclusion

IIIF is a community, with practitioners and experts worldwide, and aims to be very inclusive. Having difficulty getting started, looking for a little help with a specific task, or wanting to dive in much deeper? Please reach out:

• IIIF Resources list: https://docs.google.com/document/d/1RYHEj1siVuTo355eIoj1aXoiFBztB_rKQYbAGP53qOc/edit?usp=sharing

• Discussion List: https://groups.google.com/forum/#!forum/iiif-discuss

• Slack: http://bit.ly/iiif-slack

• Join the community calls: https://iiif.io/community/call

• Awesome-IIIF: https://github.com/IIIF/awesome-iiif

• YouTube: https://www.youtube.com/channel/UClcQIkLdYra7ZnOmMJnC5OA

• Twitter:

  • IIIF admin team: @iiif_io

  • Hashtag: #IIIF

  • or reach out to me directly @bla222