zooniverse / iiif-annotations

A proof-of-concept, annotating a IIIF manifest with Zooniverse classification data.
https://zooniverse.github.io/iiif-annotations/README/
Apache License 2.0
4 stars 1 forks source link

Documentation: how to add media to Zooniverse projects via IIIF manifests #16

Open mialondon opened 2 years ago

mialondon commented 2 years ago

Drafting documentation to share at the IIIF conference....

  1. Get the manifest link

I copied the manifest address I wanted, in this case from: ‘A collection of playbills from Lyceum Theatre 1809-1821.

A note for using British Library manifest links: The 'IIIF' logo on the 'share' dialogue has the manifest link.

Copying that manifest link gives you a long version e.g. https://api.bl.uk/metadata/iiif/ark:/81055/vdc_100022589296.0x000002/manifest.json?manifest=https://api.bl.uk/metadata/iiif/ark:/81055/vdc_100022589296.0x000002/manifest.json

But I only need the second half of the URL so I chopped off the part up to the ‘=’ sign to get:

https://api.bl.uk/metadata/iiif/ark:/81055/vdc_100022589296.0x000002/manifest.json

  1. Log into Zooniverse (this assumes you have appropriate permissions on the project)

  2. Go to the special link to import IIIF manifests as Zooniverse subject sets: https://www.zooniverse.org/lab/xxx/subject-sets/iiif - your project will have a unique number that you will need to copy into the 'xxx' part of this link.

  3. Paste my IIIF manifest link into the box

IIIF manifest import 2022-05-17 at 16-25-41 Zooniverse project 16535

  1. Hit ‘Fetch manifest’.

It grabs the data from the manifest.

I can review the fields and choose to hide some so they’re not available to the public during tasks. (See screenshot below). Hiding fields during tasks but making them available afterwards can be used to e.g. prevent bias in how people work with items from e.g. wildlife camera traps or scientific instruments.

  1. Go!

The page then says it’s uploading,

  1. Go to the new subject set when uploading is complete

When the number of items it’s uploading matches the number to be uploaded e.g. 648 of 648 items, I can click the link that appears to go to the subject set - this link will be specific to your project and subject sets.

IIIF manifest import 2022-05-17 at 16-27-50 Zooniverse project 16535 annotated

I can look over the subject set then go into my Workflow and add it there. I can view individual items, rename the set, and delete them individually if necessary.

  1. Add the new subject set to Zooniverse workflows

Go to the workflow page in the Lab and scroll down to tick or untick subject sets to include. You can do this while a workflow is active.

  1. Tell people that new volumes are available! Via Twitter, newsletters, forum posts, etc