# 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="/files/-M3K-z88GG_VINCFvNYc" 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

![](/files/-M3K612qcgAxkD5qZqO_)

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://benjamin-albritton.gitbook.io/bsa-iiif-tutorials/tutorial-1-iiif-mirador-and-book-history-content.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.