Skip to content

Commit

Permalink
Adding v1 of the training
Browse files Browse the repository at this point in the history
  • Loading branch information
glenrobson committed Nov 10, 2023
1 parent 4c3b989 commit f344d89
Show file tree
Hide file tree
Showing 12 changed files with 278 additions and 1 deletion.
68 changes: 68 additions & 0 deletions europeana/exhibit/getty.md
Original file line number Diff line number Diff line change
@@ -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/)
15 changes: 15 additions & 0 deletions gri_getty/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# 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 in the GRI collection](day-one/getty-guides.md)

# Part 2

- [Looking at other GRI collections](gri_collections.md)
- [Cropping Tools](cropping_tools.md)
- [Exhibit building](exhibit/exhibit.md)
- [Project demos and summary](demos.md)
26 changes: 26 additions & 0 deletions gri_getty/book.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,26 @@
{
"title": "IIIF VRA Workshop - October 16th to 17th 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"
}
}
}
1 change: 1 addition & 0 deletions gri_getty/cropping_tools.md
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
# Cropping tools
1 change: 1 addition & 0 deletions gri_getty/day-one
1 change: 1 addition & 0 deletions gri_getty/exhibit
7 changes: 7 additions & 0 deletions gri_getty/gri_collections.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Looking at other GRI collections

We will have a look at the Digital Florentine Codex in the next section but for this part of the workshop I would like to focus on 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)


74 changes: 74 additions & 0 deletions gri_getty/introduction.md
Original file line number Diff line number Diff line change
@@ -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](img/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))

81 changes: 81 additions & 0 deletions iiif-online-workshop/day-one/getty-guides.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
# Finding IIIF manifests in the GRI collection

For the purposes of this workshop we are going to look at a GRI item in a number of different viewers to show one of the popular use cases. This can be either from the view point of a researcher choosing a particular viewer with the tools they need to do their research or from an institution creating a custom view on their collection.

We are going to start with the Edward Ruscha photographs of Los Angeles streets which can be found on the website below and we are going to try and find something called a IIIF Manifest. A Manifest is something defined by the IIIF standards and is a document which points to all of the images and metadata about an object. We are going to copy a link to this manifest and open it in a number of different IIIF viewers.

* [https://12sunsets.getty.edu](https://12sunsets.getty.edu)

Once you have selected an image you will need to navigate to the record at Getty Research Institute:

![Screen shot of the view in GRI](img/getty_view_gri.png)

Once you have clicked on the GRI link you can scroll to the bottom of the page and look for the View IIIF manifest link. If you right click and either Copy link (Firefox) or Copy Link Address (Chrome). You now have a link to the manifest you can use in the viewers mentioned below.

![Screenshot of the view manifest link](img/view_manifest.png)

You could also use the [Digital Florentine Codex](https://florentinecodex.getty.edu/). Unfortunately it isn't possible to access the Manifests through the site as the site does not have a IIIF button. So the manifest for the site is shown below:

* [The Florentine Codex](https://dfc-django-backend.getty.digirati.io/iiif/iiif/manifest/f75b53f9-7295-41f3-9299-6bbe04685c8b/)

# Finding IIIF manifests from other institutions

This is also an issues for the IIIF Community is how to find IIIF resources. One method that the community is using to solve this problem is to create a list of guides showing how to access IIIF manifest for various institutions.

![Screenshot of the Guides Website](img/guides.png)

This is available on the IIIF website at the following location:

[https://iiif.io/guides/finding_resources/](https://iiif.io/guides/finding_resources/)

This is a community effort and if your institution isn't listed then please feel free to add it to the [Github Repository](https://github.com/IIIF/guides) or fill in the following [Google form](https://forms.gle/S6LLjBy2o4iEBR8C9).

If you look through the different collections listed you will notice there are many ways to get the link to a Manifest and this is also something the community is looking to standardise.

# Task: Find a Manifest

Using the guides site above find a Manifest you would like to view in one of the major IIIF viewers, either Mirador or the Universal Viewer (UV). Opening Manifests in the UV and Mirador is something that we will do a lot of during the course.

## Opening up a Manifest in Mirador 3

Navigate to [https://projectmirador.org/](https://projectmirador.org/) and click the __Try a Live Demo__ button. Once Mirador opens close the two demo objects by clicking the two crosses highlighted in the screen shot below:

![Mirador close window screenshot](img/mirador_close.png)

Then click the Start here button on the top left.

![Mirador start screenshot](img/mirador-start.png)

Then click the add resource button at the bottom right:

![Mirador add Manifest button](img/mirador-add-resource.png)

Finally you can paste your URL to your manifest and click Add and Mirador should open your Manifest.

![Mirador add Manifest](img/mirador-add-manifest.png)

## Opening up a Manifest in the Universal Viewer

Navigate to [http://universalviewer.io/](http://universalviewer.io/). Scroll down to where you see the __View a IIIF Manifest__ heading and enter in your Manifest URL and click View.

![UV enter manifest screenshot](img/uv_manifest.png)

If you need to switch to a new manifest then scroll to the bottom of the UV page and enter it in the __Set IIIF Manifest Id__ box and click the button next to it.

## Other viewers

Clover:
* [https://samvera-labs.github.io/clover-iiif/docs/viewer/demo](https://samvera-labs.github.io/clover-iiif/docs/viewer/demo)
* Paste the Manifest URL just below the docs button.

IIIF Curation Viewer
* [http://codh.rois.ac.jp/software/iiif-curation-viewer/demo/](http://codh.rois.ac.jp/software/iiif-curation-viewer/demo/)
* Right click in the middle and click paste

Tify
* [https://tify.rocks/](https://tify.rocks/)
* Scroll to the bottom and enter the manifest URL into the box and hit return.

Annona
* [https://ncsu-libraries.github.io/annona/tools/#/display?url=https://media.getty.edu/iiif/manifest/4fc71f54-cd9e-4d68-bb33-3866e5deb530&viewtype=iiif-storyboard&manifesturl=&settings={"fullpage"%3Atrue}](https://ncsu-libraries.github.io/annona/tools/#/display?url=https://media.getty.edu/iiif/manifest/4fc71f54-cd9e-4d68-bb33-3866e5deb530&viewtype=iiif-storyboard&manifesturl=&settings={"fullpage"%3Atrue})
* You will have to edit the URL to get your own Manifest in here.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
5 changes: 4 additions & 1 deletion index.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,10 @@ Documentation and workshop materials for IIIF training

## Bespoke Training

* [British Library online Training](iiif-bl-workshop/index.html) - a bespoke 5 day workshop written for the British Library and delivered in 2021/22. If this is of interest to your institution please contact staff (at) iiif.io.
* [Getty Research Institute](gri_getty/index.html) - a bespoke 2 hour workshop written for the Getty GRI and delivered in 2023.
* [British Library online Training](iiif-bl-workshop/index.html) - a bespoke 5 day workshop written for the British Library and delivered in 2021/22.

If bespoke training is of interest to your institution please contact staff (at) iiif.io.

## Older training

Expand Down

0 comments on commit f344d89

Please sign in to comment.