# Day 1 - Getting to know IIIF and Mirador ### Section 1: Getting to know IIIF *For more information, see* [*http://iiif.io*](http://iiif.io/) #### What is IIIF? #### The APIs 1. Image API 2. Presentation API {% hint style="info" %} Interested in "motivations"? See more at {% endhint %} **Quick Exercise**: go to 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 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: {% hint style="info" %} A browser plug-in for finding IIIF manifests: (h/t to Niqui O'Neill) {% endhint %} #### **Quick Exercise:** open 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) More at #### **Quick Exercise**:open 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 2. Manifest: Quick Exercise: * Using the manifest above * Open the map in the Mirador demo: * Using the annotation tools in Mirador, begin to describe what you see ![](/files/-LjGuF7iHxZYUMGjEfeM) 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 {% hint style="info" %} *NB: these annotations will not persist once the browser session is closed - to be persistent, there needs to be a back-end for storage.* {% endhint %} ### Section 3: Getting Mirador set up for yourself #### Installing on your laptop 1. Go to 2. Download the .zip or .tar of the latest version (in this case, 2.7.0) 3. Unzip it (it will produce a folder called "build") 4. 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 4. 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`](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 ; 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: Example: becomes which can be used as a IIIF Image URL like: #### 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. Once uploaded, you will have an archive.org URL like: 4. From here you can find your manifest by using your item ID in the following pattern: 5. Likewise, you can get to your specific image following this pattern: 6. General pattern: #### Other Options * {% hint style="warning" %} Advanced Preview: Running an image server locally {% endhint %} 1. Install Docker 2. Use or another loris container 3. Follow the directions above to set up the docker-image locally 4. 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-docker`\ replacing 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: Using the Oxford Manifest Editor (different host): Using the Digirati Manifest Editor (version 3 API only): **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 1. Example: ## --- # 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/interoperability-and-medieval-manuscripts/day-1-getting-to-know-iiif-and-mirador.md?ask= ``` 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.