From 59f1e064f55604e495d588e870b63a3d5c603830 Mon Sep 17 00:00:00 2001 From: Dawn Childress Date: Tue, 28 Oct 2025 11:17:21 -0700 Subject: [PATCH 1/4] updates to periodical use case --- source/presentation/4.0/index.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/source/presentation/4.0/index.md b/source/presentation/4.0/index.md index 65bd92298..f03989b97 100644 --- a/source/presentation/4.0/index.md +++ b/source/presentation/4.0/index.md @@ -1351,6 +1351,8 @@ When a Scene is nested into another Scene, the `backgroundColor` of the Scene to ## Use Case : Multi-spectral Images with Comments +This example is a Manifest with a single Canvas containing a Choice of multi-spectral images. + ## Embedded Content @@ -1420,9 +1422,9 @@ IIIF Ranges are used to represent structure _WITHIN_ a Manifest beyond the defau ## Use Case : Periodical -This example demonstrates the use of IIIF Collections to group Manifests into a hierarchy. In this case, there is a Collection for a publishing run of the _The Tombstone Epitaph_ from 1880 to 1920. This contains 41 child Collections each representing a year's worth of issues. The parent Collection and each of its child Collections use the `behavior` "multi-part" to signal that the Collections and their Manifests are part of a logical whole or contiguous set. Each of the year Collections has one Manifest for each issue of the newspaper. +This example demonstrates the use of IIIF Collections to group Manifests into a hierarchy. In this case, there is a Collection for a run of the _The Tombstone Epitaph_, published from 1880 to 1920. This contains 41 child Collections each representing a year's worth of issues. The parent Collection and each of its child Collections use the `behavior` "multi-part" to signal that the Collections and their Manifests are part of a logical set. Each of the year Collections has one Manifest for each issue of the newspaper. -The top level Collection has a `navPlace` property that could be used on a "Newspapers of America" map to allow users to view newspapers by location. Each Manifest has a `navDate` property that could be used to plot the issues on a calendar-style user interface. Within each Manifest, the `structures` property provides Ranges which are used to identify individual sections of the Newspaper, and individual stories within the sections, which may be spread across multiple columns and pages. Each story's Range includes the `supplementary` property to link to an Annotation Collection that provides the text of the story. +The top-level Collection has a `navPlace` property that could be used on a "Newspapers of America" map to allow users to view newspapers by location. Each Manifest has a `navDate` property that could be used to plot the issues on a timeline or calendar-style user interface. Within each Manifest, the `structures` property provides Ranges which are used to identify individual sections of the Newspaper, and individual stories within those sections, which may be spread across multiple columns and pages. Each story's Range includes the `supplementary` property to link to an Annotation Collection that provides the text of the story. IIIF Collection with `behavior` "multi-part" that contains the individual "multi-part" Collections for each year/volume: @@ -1465,7 +1467,7 @@ IIIF Collection with `behavior` "multi-part" that contains the individual "multi ] } ``` -IIIF Collection with `behavior` "multi-part" for the second volume (1881), with individual Manifests for each issue. +IIIF Collection with `behavior` "multi-part" for the second volume (1881), with individual Manifests for each issue: ```json { @@ -1486,7 +1488,7 @@ IIIF Collection with `behavior` "multi-part" for the second volume (1881), with } ``` -Manifest for the October 27, 1881 issue, with Ranges for table of contents. +Manifest for the October 27, 1881 issue, with Ranges for table of contents: ```json { From f1fe3b2f4c9e2d285455e90a4e9da66d618a2b75 Mon Sep 17 00:00:00 2001 From: Dawn Childress Date: Tue, 28 Oct 2025 12:24:21 -0700 Subject: [PATCH 2/4] Revert "updates to periodical use case" This reverts commit 59f1e064f55604e495d588e870b63a3d5c603830. --- source/presentation/4.0/index.md | 10 ++++------ 1 file changed, 4 insertions(+), 6 deletions(-) diff --git a/source/presentation/4.0/index.md b/source/presentation/4.0/index.md index f03989b97..65bd92298 100644 --- a/source/presentation/4.0/index.md +++ b/source/presentation/4.0/index.md @@ -1351,8 +1351,6 @@ When a Scene is nested into another Scene, the `backgroundColor` of the Scene to ## Use Case : Multi-spectral Images with Comments -This example is a Manifest with a single Canvas containing a Choice of multi-spectral images. - ## Embedded Content @@ -1422,9 +1420,9 @@ IIIF Ranges are used to represent structure _WITHIN_ a Manifest beyond the defau ## Use Case : Periodical -This example demonstrates the use of IIIF Collections to group Manifests into a hierarchy. In this case, there is a Collection for a run of the _The Tombstone Epitaph_, published from 1880 to 1920. This contains 41 child Collections each representing a year's worth of issues. The parent Collection and each of its child Collections use the `behavior` "multi-part" to signal that the Collections and their Manifests are part of a logical set. Each of the year Collections has one Manifest for each issue of the newspaper. +This example demonstrates the use of IIIF Collections to group Manifests into a hierarchy. In this case, there is a Collection for a publishing run of the _The Tombstone Epitaph_ from 1880 to 1920. This contains 41 child Collections each representing a year's worth of issues. The parent Collection and each of its child Collections use the `behavior` "multi-part" to signal that the Collections and their Manifests are part of a logical whole or contiguous set. Each of the year Collections has one Manifest for each issue of the newspaper. -The top-level Collection has a `navPlace` property that could be used on a "Newspapers of America" map to allow users to view newspapers by location. Each Manifest has a `navDate` property that could be used to plot the issues on a timeline or calendar-style user interface. Within each Manifest, the `structures` property provides Ranges which are used to identify individual sections of the Newspaper, and individual stories within those sections, which may be spread across multiple columns and pages. Each story's Range includes the `supplementary` property to link to an Annotation Collection that provides the text of the story. +The top level Collection has a `navPlace` property that could be used on a "Newspapers of America" map to allow users to view newspapers by location. Each Manifest has a `navDate` property that could be used to plot the issues on a calendar-style user interface. Within each Manifest, the `structures` property provides Ranges which are used to identify individual sections of the Newspaper, and individual stories within the sections, which may be spread across multiple columns and pages. Each story's Range includes the `supplementary` property to link to an Annotation Collection that provides the text of the story. IIIF Collection with `behavior` "multi-part" that contains the individual "multi-part" Collections for each year/volume: @@ -1467,7 +1465,7 @@ IIIF Collection with `behavior` "multi-part" that contains the individual "multi ] } ``` -IIIF Collection with `behavior` "multi-part" for the second volume (1881), with individual Manifests for each issue: +IIIF Collection with `behavior` "multi-part" for the second volume (1881), with individual Manifests for each issue. ```json { @@ -1488,7 +1486,7 @@ IIIF Collection with `behavior` "multi-part" for the second volume (1881), with } ``` -Manifest for the October 27, 1881 issue, with Ranges for table of contents: +Manifest for the October 27, 1881 issue, with Ranges for table of contents. ```json { From b6ab24bb191ba1f64b2b4e0bf2e71c092180f363 Mon Sep 17 00:00:00 2001 From: Dawn Childress Date: Tue, 28 Oct 2025 12:31:23 -0700 Subject: [PATCH 3/4] update periodical use case --- source/presentation/4.0/index.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/source/presentation/4.0/index.md b/source/presentation/4.0/index.md index 634925340..4051e38d2 100644 --- a/source/presentation/4.0/index.md +++ b/source/presentation/4.0/index.md @@ -626,9 +626,9 @@ Properties: [behavior](#model/behavior), [viewingDirection](#model/viewingDirect ## Use Case 3: Periodical -This example demonstrates the use of IIIF Collections to group Manifests into a hierarchy. In this case, there is a Collection for a publishing run of the _The Tombstone Epitaph_ from 1880 to 1920. This contains 41 child Collections each representing a year's worth of issues. The parent Collection and each of its child Collections use the `behavior` "multi-part" to signal that the Collections and their Manifests are part of a logical whole or contiguous set. Each of the year Collections has one Manifest for each issue of the newspaper. +This example demonstrates the use of IIIF Collections to group Manifests into a hierarchy. In this case, there is a Collection for a run of the _The Tombstone Epitaph_, published from 1880 to 1920. This contains 41 child Collections each representing a year's worth of issues. The parent Collection and each of its child Collections use the `behavior` "multi-part" to signal that the Collections and their Manifests are part of a logical set. Each of the year Collections has one Manifest for each issue of the newspaper. -The top level Collection has a `navPlace` property that could be used on a "Newspapers of America" map to allow users to view newspapers by location. Each Manifest has a `navDate` property that could be used to plot the issues on a calendar-style user interface. Within each Manifest, the `structures` property provides Ranges which are used to identify individual sections of the Newspaper, and individual stories within the sections, which may be spread across multiple columns and pages. Each story's Range includes the `supplementary` property to link to an Annotation Collection that provides the text of the story. +The top-level Collection has a `navPlace` property that could be used on a "Newspapers of America" map to allow users to view newspapers by location. Each Manifest has a `navDate` property that could be used to plot the issues on a timeline or calendar-style user interface. Within each Manifest, the `structures` property provides Ranges which are used to identify individual sections of the Newspaper, and individual stories within those sections, which may be spread across multiple columns and pages. Each story's Range includes the `supplementary` property to link to an Annotation Collection that provides the text of the story. IIIF Collection with `behavior` "multi-part" that contains the individual "multi-part" Collections for each year/volume: @@ -671,7 +671,7 @@ IIIF Collection with `behavior` "multi-part" that contains the individual "multi ] } ``` -IIIF Collection with `behavior` "multi-part" for the second volume (1881), with individual Manifests for each issue. +IIIF Collection with `behavior` "multi-part" for the second volume (1881), with individual Manifests for each issue: ```json { @@ -692,7 +692,7 @@ IIIF Collection with `behavior` "multi-part" for the second volume (1881), with } ``` -Manifest for the October 27, 1881 issue, with Ranges for table of contents. +Manifest for the October 27, 1881 issue, with Ranges for table of contents: ```json { From 4b019b66b2b4782cc4dfd0b540ce8aa8d30ac42a Mon Sep 17 00:00:00 2001 From: Dawn Childress Date: Tue, 28 Oct 2025 12:46:52 -0700 Subject: [PATCH 4/4] update intro and use case list --- source/presentation/4.0/index.md | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/source/presentation/4.0/index.md b/source/presentation/4.0/index.md index 4051e38d2..3bafeb84f 100644 --- a/source/presentation/4.0/index.md +++ b/source/presentation/4.0/index.md @@ -74,25 +74,24 @@ __Previous Version:__ [3.0][prezi30] The purpose of the IIIF Presentation API specification is to provide a [model](model) and JSON serialization format of that model. -It provides a document format - the IIIF Manifest - for cultural heritage organizations (and anyone else) to present objects in a standardized, interoperable fashion. This allows compatible software such as viewers and annotation tools to load and present complex digital objects on the web from thousands of different providers. +It provides a document format---the IIIF Manifest---for cultural heritage organizations (and anyone else) to present objects in a standardized, interoperable way. This allows compatible software such as viewers and annotation tools to load and present complex digital objects on the web from thousands of different providers. **If you have existing images, audio, video and models on the web, you can easily provide IIIF Manifests for them by publishing the appropriate JSON documents.** -The IIIF Presentation API is concerned with enabling user experiences - providing enough information to present objects in compatible software, and leaving the meaning of the objects to external descriptive metadata standards. +The IIIF Presentation API is concerned with enabling user experiences---providing enough information to present objects in compatible software, and leaving the meaning of the objects to external descriptive metadata standards. -This document acts as an introduction to the specification through a set of typical (but non-exhaustive) use cases. The model [model](model) document provides the formal specification of the terms used in this introduction. +This document acts as an introduction to the specification through a set of typical (but non-exhaustive) use cases. The [Presentation API 4.0 Properties](model) document provides the formal specification of the model and terms used in this introduction. ## IIIF Use cases 1. **Artwork** - a Manifest that represents a painting, comprising a single image and accompanying display information. 2. **Book** - a Manifest that represents a digitized bound volume made up many separate images in order. The IIIF model provides structural elements to indicate the chapters. The text of the book is made available in machine-readable form as Web Annotations. -3. **45 Single** - a Manifest that represents the digitized audio from the two sides of a vinyl 7 inch record. -4. **Movie** - a Manifest that represents the digitized video of a film. A transcript of the audio is provided as Web Annotations, and additional machine-readable files provide subtitles and captions. -5. **Simple 3D Model** - a Manifest that publishes a single 3D model. -6. **Complex Scene** - a Manifest that publishes a complex 3D scene comprising multiple models, lights and cameras. -7. **Periodical** - a IIIF Collection that provides multiple child Collections and Manifests, representing the publication run of a newspaper over many years. The IIIF model provides structural elements to indicate individual articles and other elements. +3. **Periodical** - a IIIF Collection that provides multiple child Collections and Manifests, representing the publication run of a newspaper over many years. The IIIF model provides structural elements to indicate individual articles and other elements. +4. **45 Single** - a Manifest that represents the digitized audio from the two sides of a vinyl 7 inch record. +5. **Movie** - a Manifest that represents the digitized video of a film. A transcript of the audio is provided as Web Annotations, and additional machine-readable files provide subtitles and captions. +6. **Simple 3D Model** - a Manifest that publishes a single 3D model. +7. **Complex Scene** - a Manifest that publishes a complex 3D scene comprising multiple models, lights and cameras. 8. **Storytelling in 3D** - a Manifest that defines a sequence of states in a complex scene for the purposes of guiding a user through a particular experience. -9. **Manuscript** - (integration) These use case were chosen as a broad sample to introduce IIIF concepts. Many more use cases are provided as recipes in the [IIIF Cookbook](link).