# Tutorial 1: IIIF, Mirador, and Book History Content

## Section 1: What is IIIF?

*For more information, see* [*http://iiif.io*](http://iiif.io/)

*For John Unsworth's discussion of scholarly primitives, see* [*http://people.virginia.edu/\~jmu2m//Kings.5-00/primitives.html*](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](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

{% hint style="info" %}
"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 <img src="https://488458291-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M3ItgXA-qsZj3YA2XqP%2F-M3Jz8BK_rKfBIjLlMiQ%2F-M3K-z88GG_VINCFvNYc%2FScreenshot%202020-03-25%2021.04.53.png?alt=media&#x26;token=572e7ff0-af0c-4813-a349-451d06ce3d1b" alt="" data-size="original"> icon, or by a URL.
{% endhint %}

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:&#x20;
      * <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

![](https://488458291-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-M3ItgXA-qsZj3YA2XqP%2F-M3K0zMgbgTlRVo9897V%2F-M3K612qcgAxkD5qZqO_%2FScreenshot%202020-03-25%2021.31.01.png?alt=media\&token=ae001e59-36b4-4110-bc3a-0f124fbe3c55)

## 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>

{% hint style="info" %}
A browser plug-in for finding IIIF manifests: <https://github.com/2SC1815J/open-in-iiif-viewer> (h/t to Niqui O'Neill)
{% endhint %}

#### **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