Skip to content

Commit

Permalink
Merge pull request #211 from IIIF/austrlia
Browse files Browse the repository at this point in the history
Adding Australia workshop
  • Loading branch information
glenrobson authored Oct 15, 2024
2 parents b8566a6 + e86757e commit 4469fb3
Show file tree
Hide file tree
Showing 31 changed files with 201 additions and 45 deletions.
33 changes: 33 additions & 0 deletions australia/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# VRA IIIF Training

This training is part of the [IIIF events](https://iiif.io/event/2024/canberra/) around Fantastic Futures conference in Australia.

## About the workshop
Access to image-based resources is fundamental to research, scholarship and the transmission of cultural knowledge. Digital images are a container for much of the information content in the Web-based delivery of images, books, newspapers, manuscripts, maps, scrolls, single sheet collections, and archival materials. Yet much of the Internet's image-based resources are locked up in silos, with access restricted to bespoke, locally built applications. A large community of the world's leading research libraries and image repositories have embarked on an effort to collaboratively produce an interoperable technology and community framework for image delivery.

This workshop will introduce the basics of the International Image Interoperability Framework (IIIF) starting with demonstrating the use cases it supports; including side by side comparison, annotations and layering of images. It will then go on to look into the Image API and provide a method for participants to upload their own images to the Internet Archive so they can access the IIIF Image support the IA provides.

The second part of the workshop will focus on linking multiple IIIF images together with metadata to provide a IIIF Presentation API manifest and look at the different tools that are available to work with these manifests. Participants will create their own manifests and look to create an exhibit showing off their work.

## Speaker Bio:
Glen Robson works as the IIIF Technical Coordinator and runs a monthly 5 day online training course along with designing custom training for different institutions on IIIF and AV and reusing IIIF resources in various research systems like Omeka, Zooniverse and other annotation systems. Glen has been involved in the IIIF community since 2014 and previously worked at the National Library of Wales and worked on their IIIF implementation to support various crowdsourcing, maps and Newspaper projects.

## Plan:

### Part 1:
9:00am - 11:00am
* Introductions and intro to IIIF - 30 mins
* Introduce exercise on taking a manifest from an institution and opening it in a viewer
* Exercise time - 10mins
* Looking at the image API - 1 hour
* Introduce exercise on uploading image to the internet archive and leave as home work - 10mins

### Part 2:
11:00am - 12:00pm
* Presentation API - 30mins
* Introduce exercise on using the Manifest Editor
* Exercise time - 15 mins
* Extras - 10mins
* Things to do with Manifests
* Create an Exhibit
* Project demos and summary - 5 mins
30 changes: 30 additions & 0 deletions australia/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,30 @@
# Summary

- [Overview](README.md)
- [What is IIIF](day-one/whatisiiif.md)
- [Exercise](day-one/guides.md)

## Image API
- [Image API](day-two/image-api.md)
- [Identifier](day-two/image-api/identifier.md)
- [Region](day-two/image-api/region.md)
- [Size](day-two/image-api/size.md)
- [Rotation](day-two/image-api/rotation.md)
- [Quality](day-two/image-api/quality.md)
- [Format](day-two/image-api/format.md)
- [File formats](day-two/fileformats.md)
- [Uses](day-two/uses.md)
- [Getting started](day-two/image-servers/README.md)
- [Hosted - Internet Archive](day-two/image-servers/iiif-hosting-ia.md)
- [Static Images - Workbench](day-two/image-servers/level0-workbench.md)
- [Cantaloupe (Advanced)](day-two/image-servers/setting-up-cantaloupe.md)
- [Scaling IIIF Images](day-two/scaling.md)

## Presentation API
- [Presentation API](day-three/prezi-intro.md)
- [How do people create Manifests?](day-three/prezi-how.md)
- [Create a Manifest](day-three/digirati-editor/standalone.md)
- [Create a AV Manifest](day-three/digirati-editor/Add_video_manifest.md)
- [Things to do with Manifests](manifests.md)
- [Create an Exhibit](exhibit/exhibit.md)
- [Project demos and summary](demos.md)
1 change: 1 addition & 0 deletions australia/annotation-use-cases
26 changes: 26 additions & 0 deletions australia/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 australia/day-four
1 change: 1 addition & 0 deletions australia/day-one
1 change: 1 addition & 0 deletions australia/day-three
1 change: 1 addition & 0 deletions australia/day-two
44 changes: 44 additions & 0 deletions australia/demos.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,44 @@
# Project demos

We've now completed the course and would be interested in seeing the demos you've been working on.

Examples from the first workshop can be found at:

https://docs.google.com/document/d/1W6sBXJEt3Ou2zIPRQxgDQtJtaHZ7qYvCYtixTcSO1Ro/edit?usp=sharing


## 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)
1 change: 1 addition & 0 deletions australia/exhibit
8 changes: 8 additions & 0 deletions australia/manifests.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Things to do with Manifests

Once you have a IIIF manifest hosted publicly on the web you are ready to use most IIIF tools. The following pages provide a few highlights and there are also extras in the following online training:

* [Exhibiting content with Omeka-s](https://training.iiif.io/advanced_iiif/modules/omeka/)
* [Crowdsourcing with Zooniverse](https://training.iiif.io/advanced_iiif/modules/zooniverse/)
* [Georeferencing with allmaps](https://allmaps.org/)
* [See more tools on awesome-iiif](https://github.com/IIIF/awesome-iiif)
1 change: 1 addition & 0 deletions australia/styles
1 change: 0 additions & 1 deletion iiif-online-workshop/day-one/whatisiiif.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,6 @@ First because IIIF provides a standard way of exposing images and metadata it is

* [Manuscript in NLW using the UniversalViewer](http://hdl.handle.net/10107/4574752)
* [Same Manuscript in Mirador 3](https://projectmirador.org/embed/?iiif-content=https://damsssl.llgc.org.uk/iiif/2.0/4574752/manifest.json)
* [Tify](https://demo.tify.rocks/demo.html?manifest=https://damsssl.llgc.org.uk/iiif/2.0/4574752/manifest.json)
* [IIIF Curation Viewer](http://codh.rois.ac.jp/software/iiif-curation-viewer/demo/?manifest=https://damsssl.llgc.org.uk/iiif/2.0/4574752/manifest.json)
* [Annona](https://ncsu-libraries.github.io/annona/tools/#/display?url=https://damsssl.llgc.org.uk/iiif/2.0/4574752/manifest.json&viewtype=iiif-storyboard&settings=%7B%22fullpage%22%3Atrue%7D)
* [Clover](https://samvera-labs.github.io/clover-iiif/docs/viewer/demo?iiif-content=https://damsssl.llgc.org.uk/iiif/2.0/4574752/manifest.json)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -20,32 +20,34 @@ For this item I get the following URL:

https://archive.org/download/twitter-1407319283122671621/1407319283122671621.mp4

Now we will create the Manifest for this video.
or use this image from the IIIF fixtures:

## Creating a Video Manifest
https://fixtures.iiif.io/video/indiana/parliamentary/high/parliamentary-procedure-in-action.mp4

If you navigate to the Digirati Manifest Editor:
Other videos are available on the [iiif-fixtures](https://fixtures.iiif.io) site.

https://manifest-editor.digirati.services/
Now we will create the Manifest for this video.

## Creating a Video Manifest

and either select new Manifest or if you are already editing a manifest select **File** -> **New** -> **Blank Manifest**:
Navigate to the editor at https://manifest-editor.digirati.services/ and click on the Create new Manifest option at the top of the page:

![new manifest](imgs/new-manifest.png)
![Manifest Editor Splash Screen](imgs/CreateEmptyManifest.png)

Now select add canvas and then the Video Annotation.
Now select "Start adding content" then the Video Annotation.

![Add video annotation](imgs/add-video-canvas.png)
![Add video annotation](imgs/video-service-option.png)

Paste in the link to your video and scroll to the bottom of the right panel and click Add Video.
Paste in the link to your video and scroll to the bottom of the panel and click Add Video.

![Add video](imgs/add-video.png)

Now we can view the Manifest in the Universal Viewer by clicking the Preview button:
Now we can view the Manifest in the Universal Viewer by clicking the Preview button. If you select the down triangle next to the Preview button you can choose a viewer like the Universal Viewer:

![Preview](imgs/preview-video.png)

Once you click the preview button you should see the following in the Univesral Viewer:
Once you click the preview button you should see the following in the Universal Viewer:

![Video in UV](imgs/uv.png)

***Note***: this video didn't work for me in Mirador due to the file format not being supported.
***Note***: the Internet Archive video doesn't work in Mirador due to the file format not being supported.
36 changes: 19 additions & 17 deletions iiif-online-workshop/day-three/digirati-editor/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,27 +6,33 @@ The Digirati Manifest editor provides more functionality than the [Bodleian Mani

First, assemble a list of IIIF `info.json` URLs for your content. They should all be on HTTPS URLs (not unsecure HTTP).

* Here is a sample image at the [Yale Center for British Art](https://images.collections.yale.edu/iiif/2/ycba:9e08d901-a26b-4acb-a768-28f90a062adf/info.json)
* Here is a sample image at the [Yale Center for British Art](https://images.collections.yale.edu/iiif/2/ycba:209a98f4-dce8-4948-bade-79a9ab6eb848/info.json)
* Here's another sample image at [Wellcome](https://iiif.wellcomecollection.org/image/V0037482/info.json)
* Here are some [book pages from Wellcome](https://digirati-co-uk.github.io/me-testing/03-image-services.html)

## Steps to create your Manifest

### Step 1

Navigate to the editor at https://manifest-editor.digirati.services/ and click on the Create Empty Manifest option at the bottom of the page:
Navigate to the editor at https://manifest-editor.digirati.services/ and click on the Create new Manifest option at the top of the page:

![Manifest Editor Splash Screen](imgs/splash.png)

If you have previously been editing a Manifest in the editor, it will resume from where you left off. You can start a fresh Manifest from the File menu: **File** -> **New** -> **Blank Manifest**
![Manifest Editor Splash Screen](imgs/CreateEmptyManifest.png)

### Step 2

Click the Add canvas link in the left hand menu
We are now going to edit the Manifest metadata to change the label. When you first open the manifest you have access to the Manifest metadata. To change the label of the manifest look to the right hand panel where it says **Blank Manifest**

![Edit manifest](imgs/edit_manifest.png)

Now edit the Manifest label. Changes are saved automatically. By clicking the tabs above the label i.e. Descriptive, Metadata, Technical and Linking you can add other descriptions and metadata to your manifest.

### Step 3

Now we are going to add some content to your manifest. To add a canvas click the "start adding content button":

![Add Canvas](imgs/add-canvas.png)

The Manifest Editor has a number of helpers for quickly creating Canvases from different sources. In this case, we're using IIIF Image Services. Select the **Image Service** option from the panel on the right.
The Manifest Editor has a number of helpers for quickly creating Canvases from different sources. In this case, we're using IIIF Image Services. Select the **IIIF Image** option from the panel.

![Create a Canvas from an Image Service](imgs/image-service-option.png)

Expand All @@ -42,19 +48,15 @@ Now edit the Canvas label, replacing the words "Untitled canvas" in the Label fi

![Editing the label](imgs/edit-label.png)

Now repeat these steps to add a second canvas to your manifest by clicking the higlighted Add Canvas link on the left hand side. Once you've added a second canvas this will be listed on the left hand side:

![A second canvas](imgs/second-canvas.png)
Now we are going to add a second canvas. To do this click on the Canvases panel on the left hand side:

### Step 3
![Select canvas panel](imgs/select-canvas-panel.png)

We are now going to edit the Manifest metadata to change the label. First click the **Edit manifest** link at the top of the left panel. This changes the subject of the right panel. The right panel always edits whatever is selected in the left hand or center panels.

![Edit manifest](imgs/edit_manifest.png)
This will show you all of the canvases you have with your manifests. To add a second canvas click the add canvas button highlighted in this image.

Now edit the Manifest label:
![Add second canvas](imgs/add-second-canvas.png)

![Edit the manifest label](imgs/edit-manifest-label.png)
Then repeat the steps for adding a IIIF image and its info.json.

### Step 4

Expand All @@ -70,4 +72,4 @@ This will save to your default downloads location.

### Step 5

You should now create a directory to store all of the manifests and other things we create during the course. We suggest you call it `iiif-workshop` and you move the downloaded Manifest to this directory and call it `manifest.json`.
You should now create a directory to store all of the manifests and other things we create during the course. We suggest you call it `iiif-workshop` and you move the downloaded Manifest to this directory and call it `manifest.json`.
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.
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.
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.
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.
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.
Binary file modified iiif-online-workshop/day-three/digirati-editor/imgs/preview.png
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.
Binary file modified iiif-online-workshop/day-three/digirati-editor/imgs/uv.png
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.
33 changes: 18 additions & 15 deletions iiif-online-workshop/day-three/digirati-editor/standalone.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ The Digirati Manifest editor provides more functionality than the Bodleian Manif

First, assemble a list of IIIF `info.json` URLs for your content. They should all be on HTTPS URLs (not unsecure HTTP).

* Here is a sample image at the [Yale Center for British Art](https://images.collections.yale.edu/iiif/2/ycba:9e08d901-a26b-4acb-a768-28f90a062adf/info.json)
* Here is a sample image at the [Yale Center for British Art](https://images.collections.yale.edu/iiif/2/ycba:209a98f4-dce8-4948-bade-79a9ab6eb848/info.json)
* Here's another sample image at [Wellcome](https://iiif.wellcomecollection.org/image/V0037482/info.json)
* Here are some [book pages from Wellcome](https://digirati-co-uk.github.io/me-testing/03-image-services.html)

Expand All @@ -18,19 +18,26 @@ You can also use the following canvas finder which will take a Manifest and show

### Step 1

Navigate to the editor at https://manifest-editor.digirati.services/ and click on the Create Empty Manifest option at the bottom of the page:
Navigate to the editor at https://manifest-editor.digirati.services/ and click on the Create new Manifest option at the top of the page:

![Manifest Editor Splash Screen](imgs/splash.png)
![Manifest Editor Splash Screen](imgs/CreateEmptyManifest.png)

If you have previously been editing a Manifest in the editor, it will resume from where you left off. You can start a fresh Manifest from the File menu: **File** -> **New** -> **Blank Manifest**

### Step 2

Click the Add canvas link in the left hand menu
We are now going to edit the Manifest metadata to change the label. When you first open the manifest you have access to the Manifest metadata. To change the label of the manifest look to the right hand panel where it says **Blank Manifest**

![Edit manifest](imgs/edit_manifest.png)

Now edit the Manifest label. Changes are saved automatically. By clicking the tabs above the label i.e. Descriptive, Metadata, Technical and Linking you can add other descriptions and metadata to your manifest.

### Step 3

Now we are going to add some content to your manifest. To add a canvas click the "start adding content button":

![Add Canvas](imgs/add-canvas.png)

The Manifest Editor has a number of helpers for quickly creating Canvases from different sources. In this case, we're using IIIF Image Services. Select the **Image Service** option from the panel on the right.
The Manifest Editor has a number of helpers for quickly creating Canvases from different sources. In this case, we're using IIIF Image Services. Select the **IIIF Image** option from the panel.

![Create a Canvas from an Image Service](imgs/image-service-option.png)

Expand All @@ -46,19 +53,15 @@ Now edit the Canvas label, replacing the words "Untitled canvas" in the Label fi

![Editing the label](imgs/edit-label.png)

Now repeat these steps to add a second canvas to your manifest by clicking the higlighted Add Canvas link on the left hand side. Once you've added a second canvas this will be listed on the left hand side:

![A second canvas](imgs/second-canvas.png)
Now we are going to add a second canvas. To do this click on the Canvases panel on the left hand side:

### Step 3
![Select canvas panel](imgs/select-canvas-panel.png)

We are now going to edit the Manifest metadata to change the label. First click the **Edit manifest** link at the top of the left panel. This changes the subject of the right panel. The right panel always edits whatever is selected in the left hand or center panels.

![Edit manifest](imgs/edit_manifest.png)
This will show you all of the canvases you have with your manifests. To add a second canvas click the add canvas button highlighted in this image.

Now edit the Manifest label:
![Add second canvas](imgs/add-second-canvas.png)

![Edit the manifest label](imgs/edit-manifest-label.png)
Then repeat the steps for adding a IIIF image and its info.json.

### Step 4

Expand Down
2 changes: 2 additions & 0 deletions index.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,8 @@ Documentation and workshop materials for IIIF training

* [Making use of IIIF](advanced_iiif/index.html) - a 3 hour hands on session run on the 21st of June 2022 for Yale University. Covers how to make use of IIIF resources with tools like Omeka, FromThePage, Zooniverse and working with an annotation store.

* [3 hour hands on Introduction to IIIF](australia/index.html) - delivered in Australia October 2024.

* [European Aggregators Training](europeana/index.html) - a 3 hour session run on the 23rd of May 2022, covering a basic introduction to the image and presentation API and looking at how to share date with Europeana.

* [Annotating Cultural Heritage via IIIF](annotations/index.html) - a 1.5 hour session run on the 9th of November 2021 looking at various use cases related to annotations.
Expand Down

0 comments on commit 4469fb3

Please sign in to comment.