Merge pull request #194 from IIIF/gri_getty

Adding v1 of the training

europeana/exhibit/getty.md

@@ -0,0 +1,68 @@
+# Create an Exhibit
+
+This is a practical way to demonstrate what you can do with Manifests. An example of a presentation pulling together multiple manifests is given below:
+
+<iframe src="https://exhibit.so/exhibits/vjxZwSD0sgKKzQhU4r7i?embedded=true" width="1024" height="768" allowfullscreen frameborder="0"></iframe>
+
+This tells the story of a ship called the Canganian and brings together IIIF resources from Newspapers to Manuscripts to make the presentation. 
+
+## Find manifests
+
+For this example we are going to use the manifests from the [12 Sunsets project](https://12sunsets.getty.edu/). 
+
+## Create an Exhibit
+
+Navigate to:
+
+[https://www.exhibit.so/](https://www.exhibit.so/)
+
+Scroll to the bottom until you see the 'Create an Exhibit' button. Click this and you will be taken to the following screen:
+
+![Create Exhibit screen](img/create.png)
+
+On this screen you can choose the following type of presentation:
+
+ * Kiosk - this will auto play the slides and is useful for a public display terminal
+ * Scroll - 'slides' will be presented in a single long web page and uses will scroll down to read the story
+ * Slides - the default and allows uses to press right or left to navigate the different parts of the story. 
+ * Quiz - Similar to the Slides option buy you can ask your viewers to answer a questions
+
+For this tutorial we will focus on the slides option. Fill in a Title, Author and Description for your exhibit and agree to the Terms and Conditions and tick the I am not a robot button. Then click "Create Exhibit". 
+
+You will then be presented with the following screen:
+
+![Exhibition start screen](img/start.png)
+
+The first thing to do is to add your Manifest. If you switch back to the workbench ([https://workbench.gdmrdigital.com/](https://workbench.gdmrdigital.com/index.xhtml)) in another browser tab. Navigate to your Manifest and right click the IIIF icon and select "Copy link":
+
+![Workbench copy manifest link](img/workbench.png)
+
+Now switch back to the Exhibit tool and click the Add Item button and it will show this dialog:
+
+![Add Manifest URL](img/add_item.png)
+
+Paste the Manifest URL into the text box and click import. You should see the manifest load in the background and the manifest title in the Items dialog:
+
+![List items dialog](img/list_items.png)
+
+Click the cross to close this dialog.
+
+Now we have the manifest loaded we want to create a 'slide'. Click the + on the left hand side of the screen underneath the Title and description:
+
+![add slide button](img/add_anno.png)
+
+Enter a description of what you would like to show and then zoom the right hand image into an area of the image you would like to highlight. 
+
+![add description and zoom](img/zoom.png)
+
+Once you are happy with the description and zoom click the tick symbol to save the annotation. 
+
+You can now add a number of different slides to tell your story. You can also add different Manifests using the Add Item button.
+
+Once you are happy click the Preview button which will show you what your presentation looks like:
+
+<iframe src="https://www.exhibit.so/exhibits/CJkH4G1vIncsNAtMKXYC?embedded=true" width="640" height="480" allowfullscreen allow="autoplay" frameborder="0"></iframe>
+
+You can find Manifests from various institutions by going to the IIIF Guides website:
+
+[https://guides.iiif.io/finding_resources/](https://guides.iiif.io/finding_resources/)

gri_getty/README.md

@@ -0,0 +1,10 @@
+# GRI Custom training
+
+This is a custom training built for the Getty GRI and was delivered on the 10th of November 2023. It is a 2 hour workshop with the following aims:
+
+1. Brief introduction to overall IIIF capabilities. A general overview of major IIIF functionality, and a wide range of example use cases from institutional uses around the world.
+2. IIIF Viewers. The general usage of IIIF viewers, such as Mirador 3 and Universal Viewer. Other viewers, perhaps with specialized interfaces, could be added if time allows.
+3. Finding IIIF Manifests in the RCV and using them in IIIF viewers.
+4. Cropping Tools. How to extract images from within Getty IIIF manifests, and using them in well-known IIIF cropping tools. 
+5. Comparison Tools. The usage of additional comparison functionality within Mirador, and how researchers and scholars use this IIIF functionality to further their work. 
+6. Time-allowing: The basics of Annotations and Guided Storytelling.

gri_getty/SUMMARY.md

@@ -0,0 +1,16 @@
+# Summary
+
+- [Overview](README.md)
+
+# Part 1
+- [IIIF Basics](https://training.iiif.io/iiif-online-workshop/day-one/whatisiiif.html)
+- [How users make use of IIIF](introduction.md)
+- [Finding IIIF manifests](day-one/getty-guides.md) 
+
+# Part 2
+
+- [Looking at other GRI collections](gri_collections.md)
+- [Cropping Tools](cropping_tools.md)
+- [Geolocating a Map](geo-locating-map.md)
+- [Exhibit building](exhibit/getty.md)
+- [Project demos and summary](demos.md)

gri_getty/book.json

@@ -0,0 +1,26 @@
+{
+  "title": "Getty GRI Workshop 10th November 2023",
+  "plugins": [
+    "include",
+    "theme-default",
+    "toggle-chapters",
+    "git-author",
+    "-highlight",
+    "toggle-chapters"
+  ],
+  "gitbook": "3.2.3",
+  "styles": {
+        "website": "styles/website.css"
+  },
+  "pluginsConfig": {
+    "theme-default": {
+        "showLevel": true
+    },
+    "git-author": {
+      "position": "bottom",
+      "modifyTpl": "Last modified by {user} {timeStamp}",
+      "createTpl": "Created by {user} {timeStamp}",
+      "timeStampFormat": "YYYY-MM-DD HH:mm:ss"
+    }
+  }
+}

gri_getty/cropping_tools.md

@@ -0,0 +1,11 @@
+# Cropping tools
+
+For this part of the workshop we will be diving into the details of the Image API. This is a specification which allows zooming into high quality images but can also be used with certain tools to create cropped images. We are going to use the following tool:
+
+https://iiifimage.link
+
+You can follow along with your own image from the previous step but you can also use the following examples:
+
+ * Rossetta image: https://rosettaapp.getty.edu/iiif/2/FL9931118.jpg/info.json
+ * 12 sunsets image: https://media.getty.edu/iiif/image/14bd1507-c4b0-48d4-b489-411c4d672105/info.json
+ * Digital Florentine Codex: https://media.getty.edu/iiif/image/d5472c67-e070-4022-afb0-3e2c7b97d16a

gri_getty/day-one

@@ -0,0 +1 @@
+../iiif-online-workshop/day-one

gri_getty/demos.md

@@ -0,0 +1,39 @@
+# Project demos
+
+We've now completed the course and would be interested in seeing the demos you've been working on. 
+
+## Slack channels
+
+Join the [IIIF slack](http://bit.ly/iiif-slack):
+
+ * general - general discussion and announcements
+ * beginner - beginner questions lots of people to help
+ * iiif-in-the-classroom - ideas for IIIF in the classroom
+ * curators_of_awesome - become a curator of awesome by helping to curate: https://github.com/IIIF/awesome-iiif
+ * mirador - ask questions and see the latest developments with Mirador
+ * technical - ask difficult technical questions :-)
+
+## Zoom calls
+Community Calls https://iiif.io/community/call/
+
+## Community groups
+See all IIIF calls on the IIIF Calendar: https://iiif.io/community/
+
+Community groups:
+ * [3D](https://iiif.io/community/groups/3d)
+ * [A/V](https://iiif.io/community/groups/av)
+ * [Design](https://iiif.io/community/groups/D4H)
+ * [Maps](https://iiif.io/community/groups/maps)
+ * [Museums](https://iiif.io/community/groups/museums)
+ * [Outreach](https://iiif.io/community/groups/outreach)
+
+Technical Groups
+ * [3D](https://iiif.io/community/groups/3d/tsg/)
+ * [Authentication](https://iiif.io/community/groups/auth-tsg)
+ * [Content Search](https://iiif.io/community/groups/content-search-tsg)
+
+
+## Stay informed
+
+ * Join the [monthly newsletter](https://iiif.io/newsletter/)
+ * Join the IIIF Discuss [email list](https://groups.google.com/forum/#!forum/iiif-discuss)

gri_getty/exhibit

@@ -0,0 +1 @@
+../europeana/exhibit

gri_getty/geo-locating-map.md

@@ -0,0 +1,13 @@
+# Geo-locating a map
+
+While looking through the GRI collection I noticed a number of Maps which is a good excuse to demonstrate one of the new tools available for IIIF maps.  For this example I am going to use this map of Paris:
+
+https://rosettaapp.getty.edu/delivery/DeliveryManagerServlet?dps_pid=IE2799092&dps_file=FL2799094&md_pane=hide
+
+![Paris map](imgs/paris_map.png)
+
+Using the detektIIIF tool discussed previously we can use this map in the following Geo-referencing tool:
+
+https://editor.allmaps.org/
+
+![All maps import](imgs/all_maps_import.png)

gri_getty/gri_collections.md

@@ -0,0 +1,32 @@
+# Looking at other GRI collections
+
+We will now have a look at the collections that are available from Rosseta and can be accessed from the following URL:
+
+ * [Getty Search Gateway](https://search.getty.edu/gateway/search?q=maps&cat=source&sources=%22GRI%20Digital%20Collections%22&highlights=%22Open%20Content%20Images%22&rows=50&srt=&dir=s&dsp=0&img=0&pg=1)
+
+When you get to an item page you can View the IIIF image in on of the basic IIIF viewers called [Openseadragon](https://openseadragon.github.io/). For example:
+
+![Screenshot of rossetta](imgs/rossetta.png)
+
+https://rosettaapp.getty.edu/delivery/DeliveryManagerServlet?dps_pid=IE9931113
+
+Although this is a photo album with many pages it doesn't seem to have an associated manifest. It maybe possible to enable this and there are some instructions [here](https://knowledge.exlibrisgroup.com/Rosetta/Training/What%27s_New_Videos/Rosetta_5-3/IIIF_Image_Viewing).
+
+Without access to the IIIF manifest it makes it very difficult for end users to re-use this content. One solution is to use a community developed tool called [DetektIIIF](https://seige.digital/en/detektiiif/). This was developed by a IIIF community member; Leander Seige to make it easier to find manifests. It can be installed in either Firefox or chrome. If you install the plugin then refresh the page you should be able to access it in the extensions part of the browser:
+
+![detektIIIF](imgs/detekt_item.png)
+
+In this example it shows a red 1 to show that it has found an IIIF item. If you then navigate to a different image and select the detekt extension again and click to open the extension you will now see:
+
+![detektIIIF image](imgs/detekt_image.png)
+
+You will notice that no Manifests were found but it has found some IIIF images. If you click the Copy URL button you should be ready for the next stage of cropping the image. The URL will look something like:
+
+https://rosettaapp.getty.edu/iiif/2/FL9931118.jpg/info.json
+
+
+For Manifests like [The Florentine Codex](https://dfc-django-backend.getty.digirati.io/iiif/iiif/manifest/f75b53f9-7295-41f3-9299-6bbe04685c8b/) or the 12 Sunset photographs you can use the following tool to get the Image ID:
+
+https://glenrobson.github.io/CanvasFinder/
+
+

gri_getty/introduction.md

@@ -0,0 +1,74 @@
+# Introductions
+
+## Getty involvement with IIIF
+IIIF is a set of standards that provide access to high quality images and audio-visual content in a method that allows users to choose different viewers and tools to interact with cultural heritage content. It has been widely adopted by world leading organisations including the J. Paul Getty Trust. It provides a basis for users to gather digital content and enables research by comparing and annotating content. The IIIF standards are developed by an international open community and are supported by a consortium of institutions including the Getty. 
+
+The Getty has been involved with the development of IIIF since the very beginning and was instrumental in the addition of audio-visual support to IIIF. It was also one of the early members of the [IIIF Consortium](https://iiif.io/community/consortium/). Members of staff at the Getty have been active participants in the community providing advice on implementation and also funding tools that benefit both the Getty and the wider IIIF community. A highlight of some of IIIF related work the Getty has presented on are below:
+
+ * [2016 Edward Ruscha photographs of Los Angeles streets](https://12sunsets.getty.edu)
+ * [2017 press release for 30,000 artworks](https://www.getty.edu/news/30000-getty-museum-images-published-iiif/)
+ * [Quire](https://quire.getty.edu/) - a widely used publication system
+ * [Animal Crossing Art Generator](https://experiments.getty.edu/ac-art-generator) 
+ * [iiif-for-dolls](https://iiif-for-dolls.davidnewbury.com/) - a thought provoking app on relating physical size to digital images. 
+ * [Digital Florentine Codex](https://florentinecodex.getty.edu/) - mentioned at the 2019 DHSI training
+
+# How users make use of IIIF 
+
+One of the IIIF Community groups has done some research on how people use IIIF items and created the following groups of users: 
+
+![D4H Personas Diagram](imgs/IIIF-D4H-UX-Research-Findings.jpg)
+
+From the [D4H Community Group Research Findings presentation](https://docs.google.com/presentation/d/1JhhjJdGIAZjYm0j9iNig7-YT2LJqFgVgThsoS59jAV0/edit#slide=id.gdbd80f572f_0_95)
+
+The groups are defined as:
+
+### Gatherers
+ * **EXPERTISE IN IIIF:** Does not use IIIF. May be aware or unaware that it exists.
+ * **MOTIVATION:** The materials relevant to their research; technology agnostic.
+ * **TOOLBOX:** Use tools like Zotero, Google Drive, Dropbox and MS Office to manage digital items.
+ * **PEERS:** Involved in their own research communities.
+
+Use cases include:
+ * Making use of your [catalogue](https://search.getty.edu/gateway/landing) to find digital stuff
+ * Browsing a project website like:
+  * [Digital Florentine Codex](https://florentinecodex.getty.edu/)   
+  * [Edward Ruscha photographs of Los Angeles streets](https://www.getty.edu/research/collections/collection/100071)
+ * Storing references in Zotero or Spreadsheets
+ * Downloading images
+
+### Adopters
+ * **EXPERTISE IN IIIF:** Utilize IIIF-compliant materials for research projects.
+ * **MOTIVATION:** Available technology and materials relevant to their research.
+ * **TOOLBOX:** Use tools like [FromThePage](https://fromthepage.com/), [Wordpress](https://www.vam.ac.uk/blog/digital/iiif-wordpress-and-shakespeare-too), [Omeka](https://omeka.org/s/), and other out-of-the-box solutions for research projects.
+ * **PEERS:** Involved in their own research communities more than IIIF community.
+
+Use cases include:
+ * Looking for IIIF material. 
+ * Using multiple collections with tools like [Mirador](https://projectmirador.org/)
+ * Will use tools like [Exhibit](https://exhibit.so/) to put together exhibitions/presentations. 
+ * This is where this course will target.
+
+### Educators
+ * **EXPERTISE IN IIIF:** Understand how to use IIIF tools for viewing, annotation, and transcription.
+ * **MOTIVATION:** Teach people about the possibilities of IIIF.
+ * **TOOLBOX:** Use tools like viewers in teaching.
+ * **PEERS:** May be involved with IIIF community.
+
+Use cases include:
+ * Similar tools to above
+ * Will use annotation tools we will cover on Thursday
+ * Will use tools like [Recogito](https://recogito.pelagios.org/) which is a hosted annotation tool for teaching
+ * Use AV tools like [Timeliner](https://cultural-heritage.digirati.com/our-work/timeliner/) or the [Europeana Media Player](https://video-editor.eu/).
+ * Can setup crowdsourcing projects
+ * We held a community call on Teaching and Learning with IIIF. Notes [here](https://docs.google.com/document/d/1viF1tgssZSTTiMTPy1sY3iTxgAKfByt1eM9MrCQEfF4/edit) and video [here](https://www.youtube.com/watch?v=ILrmRxPcK-o).
+
+### Builders
+ * **EXPERTISE IN IIIF:** Possess a deep, technical knowledge.
+ * **MOTIVATION:** Make digital content from their institution available.
+ * **TOOLBOX:** Use tools like Github, code editors, open source tools.
+ * **PEERS:** Members of the IIIF community.
+
+Use cases:
+ * Create Manifests and IIIF Images either programmatically or through tools like Manifest Editors
+ * They know about the IIIF tools available and where to look for them ([awesome-iiif](https://github.com/IIIF/awesome-iiif))
+

gri_getty/styles

@@ -0,0 +1 @@
+../iiif-online-workshop/styles