Skip to content

Commit

Permalink
start filling out day-two
Browse files Browse the repository at this point in the history
  • Loading branch information
dnoneill committed May 21, 2024
1 parent 645fde3 commit cffb7b6
Show file tree
Hide file tree
Showing 38 changed files with 352 additions and 11 deletions.
2 changes: 1 addition & 1 deletion dhsi/README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Introduction

Instructors:
* Niqui O'Neil
* Niqui O'Neill
* Jeffrey C. Witt

<!--
Expand Down
26 changes: 16 additions & 10 deletions dhsi/SUMMARY.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
## Monday, Session 1: 10:30am-12:00pm**

1. Introductions
1. [Introductions](day-one/introductions.md)
1. Week Overview (Jeff)
2. [What is IIIF (Niqui)](day-one/whatisiiif.md)
3. [Why use IIIF (Niqui)](day-one/whyiiif.md)
Expand All @@ -17,14 +17,17 @@

## Tuesday, Session 3: 9:00am-10:15am**

1. Reflection on using the IIIF Image API
2. IIIF Presentation API
1. [Overview]
2. [Exercise - Create a Manifest]
3. IIIF Viewers
1. [Reflection on using the IIIF Image API](day-two/reflections.md)
2. [IIIF Presentation API Overview](day-two/presentation-api.md)
3. [Exercise - Create a Manifest](day-two/manifest-exercise.md)
1. [Bodleian (V2)](day-two/bodleian-editor/README.md)
2. [Digirati (V3)](day-two/digirati-editor/README.md)
3. [Digirati A/V](day-two/digirati-editor/Add_video_manifest.md)
4. IIIF Viewers
1. [Overview]
1. [Finding IIIF Manifests and images](day-two/finding-manifest.md)
2. [Exercise]
4. Reflection
5. Reflection

## Tuesday, Session 4: 10:30am-12:00pm

Expand All @@ -37,10 +40,11 @@

## Tuesday, Session 5: 1:00pm-2:15pm

1. Auto generating Manifests
2. Publishing Manifests
1. [Auto generating Manifests](day-two/auto-generate-manifest.md)
2. [Publishing Manifests](day-two/publishing-manifests.md)
1. Overview
2. Exercise
2. Exercise - Workbench, manual, github


## Tuesday Session 6: 2:30pm-3:45pm

Expand All @@ -49,6 +53,8 @@
1. Mirador Configuration and Customization
2. Embedding Universal Viewer
2. Work Period




- [Overview](README.md)
Expand Down
6 changes: 6 additions & 0 deletions dhsi/day-one/introductions.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
- Name
- Institution
- Role
- Why you are in the class?
- IIIF experience?
- Something interesting about you.
33 changes: 33 additions & 0 deletions dhsi/day-two/auto-generate-manifest.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
# Autogenerating manifests

Do we think all of these institutions with manifests autogenerate them? No they are generated multiple different ways. Often they are tied the a metadata or DAMS system that retrieves the metadata and image info from the systems.

## Minimal computing ways to autogenerate manifests
1. [wax](https://github.com/minicomp/wax) - a minimal computing project for producing digital exhibitions focused on longevity, low costs, and flexibility. Provides a way to create manifests via csv.
2. [biiif](https://github.com/IIIF-Commons/biiif) - Organise your files according to a simple naming convention to generate IIIF v3 manifests.
3. [biiif-cli](https://github.com/IIIF-Commons/biiif-cli) - biiif terminal tool
3. [iiif-producer](https://github.com/ubleipzig/iiif-producer) - A CLI tool that generates IIIF Presentation 2.1 Manifests from METS/MODS (produced by Kitodo).
4. [Leiden's Islandora IIIF Manifest Generator](https://github.com/LeidenUniversityLibrary/islandora_iiif_manifests) - A module to generate IIIF Manifest for Islandora.
5. [Presentation API libraries](https://github.com/IIIF/awesome-iiif?tab=readme-ov-file#presentation-api-libraries) - Libraries that will help create manifests in a script.

## biiif-cli
1. Go to your dhsi-iiif-2024 folder.
2. In the images folder create an `info.yml` file.
3. Fill out some metadata to match the format below.
![Screenshot of https://github.com/IIIF-Commons/biiif?tab=readme-ov-file#metadata](img/biiif-manifest.png).
4. Upload to your dhsi-iiif-2024 fork
5. `git add images/info.yml`
6. `git commit -m "create info.yml file"`
7. `git push origin main`
8. Look in the images folder. What do you see?

You can create move complex forms with this tool.
![Screenshot of https://github.com/IIIF-Commons/biiif?tab=readme-ov-file#examples](img/biiif-filestructure.png).




## Reflections
1. Based on what we know what if anything is wrong with this method?
2. Is there anything we can do to fix it?
3. What method (does not need to include something on this page) would you want for generating manifests?
71 changes: 71 additions & 0 deletions dhsi/day-two/bodleian-editor/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
# Create a IIIF Manifest using the Bodleian Manifest Editor

## Gather images
First, assemble a list of IIIF `info.json` URLs for your content.
* Here is a sample image at [Klokan](http://free.iiifhosting.com/iiif/f9a02a80bf76333f50ffcf0f0c17aa58f9ebf6a1510c9801bde50f565ac0a936/info.json)
* 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)

## Use the Bodleian Manifest Editor to create a manifest

Navigate to the editor. If *any* of your `info.json` URLs begin with HTTP, use the HTTP version. See the [Note on Mixed Content](#note-on-mixed-content) section below for more information.

- HTTP version at [text and bytes](http://iiif-manifest-editor.textandbytes.com/)
- HTTPS version at [the Bodleian](https://digital.bodleian.ox.ac.uk/manifest-editor/)

### Note on Mixed Content
The links above to Universal Viewer use the HTTP version of the site to avoid Mixed Content errors. Likewise, you will need to use version of the Bodleian Manifest Editor served over HTTP if any of your IIIF images are served via HTTP. See this article on [Mixed Content](https://developers.google.com/web/fundamentals/security/prevent-mixed-content/what-is-mixed-content) for an explanation of the issue.

## Steps to create your Manifest

### Step 1
Click on the create New Manifest button.

![New manifest option](imgs/bod_new_manifest.png)

### Step 2

Click the Add Canvas button

![Add Canvas button](imgs/bod_add_canvas.png)

Select the Canvas Metadata on the right hand side of the screen.

***Note***: the Empty canvas thumbnail on the left will keep on spinning until you add an image. If you use a level 0 image this thumbnail will keep on spinning as Manifest editors does not support level 0 images as thumbnails. The main image should work OK for a level 0 image.

![Select canvas metadata](imgs/bod_select_canvas_metadata.png)

Now click the Add Image to Canvas button.

***Note:*** again the thumbnail will still be spinning and there is also another spinning circle above the button which will disappear when an image is selected. The main image also says it can't load `/img/empty-canvas-large.png` but ignore this too as it will disappear when an image has been loaded.

![Add image to canvas](imgs/bod_add_image_to_canvas.png)

In the following dialog select the 'From info.json URI' option and enter your info.json into the text box. Then click Submit URI.

![Enter info.json](imgs/bod_add_info_json.png)

Once the image is loaded you should see something similar to the screenshot below. Note it may take a few minutes for the image to load if you are using the Internet Archive. You should see the thumbnail at the bottom and above the Add Image to canvas button.

Now edit the Canvas label by clicking into the highlighted box.

![Image added](imgs/bod_added_image.png)

Now repeat these steps to add a second canvas to your manifest.

### Step 3

We are now going to edit the Manifest metadata to change the label. First click the Manifest Metadata panel to reveal the fields you can edit in the Manifest and then click the highlighted Label box to add a label.

![Edit label](imgs/bod_edit_label.png)

### Step 4

Now we are going to save and download the Manifest for the next stage. Click the Save Manifest button at the top right of the screen and then click the download button.

***Note:*** it is best to keep the Manifest Editor open as although the Manifest Editor allows you to import a Manifest for editing it is not very successful at doing this and often it will refuse to load a manifest so it is safer to keep the tab open until you are sure that you have finished with it.

![Download manifest](imgs/bod_download_manifest.png)

### 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`.
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.
51 changes: 51 additions & 0 deletions dhsi/day-two/digirati-editor/Add_video_manifest.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
# Create a Video Manifest

One of the extra features of the Digirati Manifest Editor is the support of Audio or Video resources. This guide will take you through adding a Video from the Internet Archive. For IIIF videos need to be accessible as a URL to the file and the Internet Archive provides the option to download Videos and this is the link we can use.

## Find a video to embed in your Manifest

Navigate to the Internet Archive and find a video from the Movie section:

https://archive.org/details/movies

If you stick to vidoes which are listed as MPEG4 these are more likely to be supported in the current IIIF viewers. I am going to use the following example:

https://archive.org/details/twitter-1407319283122671621

and to get the link to the video I am going to right click on the MPEG4 download option and select copy link:

![Copy Video URL](imgs/ia_video.png)

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.

## Creating a Video Manifest

If you navigate to the Digirati Manifest Editor:

https://manifest-editor.digirati.services/

and either select new Manifest or if you are already editing a manifest select **File** -> **New** -> **Blank Manifest**:

![new manifest](imgs/new-manifest.png)

Now select add canvas and then the Video Annotation.

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

Paste in the link to your video and scroll to the bottom of the right 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:

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

Once you click the preview button you should see the following in the Univesral 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.
73 changes: 73 additions & 0 deletions dhsi/day-two/digirati-editor/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
# Create a IIIF Manifest using the Digirati Manifest Editor

The Digirati Manifest editor provides more functionality than the [Bodleian Manifest Editor](../bodleian-editor/README.md) that we used in the previous task. Specifically it supports version 3 of the IIIF specifications which allows you to add Video or Audio items to a canvas.

## Gather images

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'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:

![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**

### Step 2

Click the Add canvas link in the left hand menu

![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.

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

Paste the URL of the info.json into the text box and click **Create**.

![Paste the Image Service URL](imgs/paste-image-service-url.png)

Once the image is loaded you should see something similar to the screenshot below. Note it may take a few minutes for the image to load if you are using the Internet Archive.

![Newly created canvas](imgs/newly-created-canvas.png)

Now edit the Canvas label, replacing the words "Untitled canvas" in the Label field in the right-hand panel:

![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)

### Step 3

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)

Now edit the Manifest label:

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

### Step 4

Now we are going to save and download the Manifest for the next stage.

In the menu, click **File** -> **Export**.

The Manifest Editor gives you the option of IIIF Presentation 3 or 2. Click the **Download** button for Presentation 3:

![Export a manifest](imgs/export.png)

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`.
Binary file added dhsi/day-two/digirati-editor/imgs/add-canvas.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 added dhsi/day-two/digirati-editor/imgs/add-video.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.
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 added dhsi/day-two/digirati-editor/imgs/export.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added dhsi/day-two/digirati-editor/imgs/ia_video.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.
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 added dhsi/day-two/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 added dhsi/day-two/digirati-editor/imgs/splash.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added dhsi/day-two/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.
67 changes: 67 additions & 0 deletions dhsi/day-two/digirati-editor/standalone.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
# Create a IIIF Manifest using the Digirati Manifest Editor

The Digirati Manifest editor provides more functionality than the Bodleian Manifest Editor that we used in the previous versions of the training. Specifically it supports version 3 of the IIIF specifications which allows you to add Video or Audio items to a canvas.

## Gather images

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'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)

You can also use the following canvas finder which will take a Manifest and show you the IIIF Image Ids you need for the manifest editor:

[https://glenrobson.github.io/CanvasFinder/](https://glenrobson.github.io/CanvasFinder/)

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

![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**

### Step 2

Click the Add canvas link in the left hand menu

![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.

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

Paste the URL of the info.json into the text box and click **Create**.

![Paste the Image Service URL](imgs/paste-image-service-url.png)

Once the image is loaded you should see something similar to the screenshot below. Note it may take a few minutes for the image to load if you are using the Internet Archive.

![Newly created canvas](imgs/newly-created-canvas.png)

Now edit the Canvas label, replacing the words "Untitled canvas" in the Label field in the right-hand panel:

![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)

### Step 3

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)

Now edit the Manifest label:

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

### Step 4

Now we are going to view the manifest and try it out in some viewers. If you click the down arrow beside the red Preview button at the top right. You should see a list of options including Mirador and the Universal Viewer. There is also the option to view the Raw Manifest which you can copy and paste and use in other tools.

![Preview manifest](imgs/preview.png)
Binary file added dhsi/day-two/imgs/biiif-filestructure.png
Binary file added dhsi/day-two/imgs/biiif-manifest.png
8 changes: 8 additions & 0 deletions dhsi/day-two/manifest-exercise.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# Manifest exercise

Create a manifest using either the Bodleian editor (V2) or Digirati editor. You will need to find some Image API links. They don't have to all be from the same Institution/URL.


1. [Bodleian (V2)](day-two/bodleian-editor/README.md)
2. [Digirati (V3)](day-two/digirati-editor/README.md)
3. [Digirati A/V](day-two/digirati-editor/Add_video_manifest.md)
Loading

0 comments on commit cffb7b6

Please sign in to comment.