-
Notifications
You must be signed in to change notification settings - Fork 16
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
38 changed files
with
352 additions
and
11 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 | ||
|
||
<!-- | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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? |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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`. |
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.
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.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
Oops, something went wrong.
Oops, something went wrong.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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) |
Oops, something went wrong.