diff --git a/_includes/links.md b/_includes/links.md index 122bf65e5..176e64518 100644 --- a/_includes/links.md +++ b/_includes/links.md @@ -37,8 +37,8 @@ [0065]: {{ site.cookbook_url | absolute_url }}/recipe/0065-opera-multiple-canvases/ "Table of Contents for Multiple A/V Files on Multiple Canvases" [0068]: {{ site.cookbook_url | absolute_url }}/recipe/0068-newspaper/ "Basic Newspaper" [0074]: {{ site.cookbook_url | absolute_url}}/recipe/0074-multiple-language-captions/ "Using Caption and Subtitle Files in Multiple Languages with Video Content" -[0074-4]: {{ site.cookbook_url | absolute_url}}/recipe/0074-multiple-language-captions/#version-4 "Using Caption and Subtitle Files in Multiple Languages with Video Content" -[0079-4]: {{ site.cookbook_url | absolute_url }}/recipe/0079-annotations-for-captions/#version-4 "Using Annotations for Timed Text" +# [0074-4]: {{ site.cookbook_url | absolute_url}}/recipe/0074-multiple-language-captions/#version-4 "Using Caption and Subtitle Files in Multiple Languages with Video Content" +# [0079-4]: {{ site.cookbook_url | absolute_url }}/recipe/0079-annotations-for-captions/#version-4 "Using Annotations for Timed Text" [0117]: {{ site.cookbook_url | absolute_url }}/recipe/0117-add-image-thumbnail/ "Image Thumbnail for Manifest" [0118]: {{ site.cookbook_url | absolute_url }}/recipe/0118-multivalue/ "Displaying Multiple Values with Language Maps" [0135]: {{ site.cookbook_url | absolute_url }}/recipe/0135-annotating-point-in-canvas/ "Annotating a specific point of an image" @@ -46,15 +46,16 @@ [0154]: {{ site.cookbook_url | absolute_url }}/recipe/0154-geo-extension/ "Locate a Manifest on a Web Map" [0202]: {{ site.cookbook_url | absolute_url }}/recipe/0202-start-canvas/ "Load Manifest Beginning with a Specific Canvas" [0219]: {{ site.cookbook_url | absolute_url }}/recipe/0219-using-caption-file/ "Using Caption and Subtitle Files with Video Content" -[0219-4]: {{ site.cookbook_url | absolute_url }}/recipe/0219-using-caption-file/#version-4 "Using Caption and Subtitle Files with Video Content" +# [0219-4]: {{ site.cookbook_url | absolute_url }}/recipe/0219-using-caption-file/#version-4 "Using Caption Files with Video Content" [0229]: {{ site.cookbook_url | absolute_url }}/recipe/0229-behavior-ranges/ "Adding Thumbnail Navigation and `no-nav` to a Video Resource" [0230]: {{ site.cookbook_url | absolute_url }}/recipe/0230-navdate/ "Navigation by Chronology" [0231]: {{ site.cookbook_url | absolute_url }}/recipe/0231-transcript-meta-recipe/ "Transcripts, Captions, and Subtitles - General Considerations" -[0231-4]: {{ site.cookbook_url | absolute_url }}/recipe/0231-transcript-meta-recipe/#version-4 "Transcripts, Captions, and Subtitles - General Considerations" +# [0231-4]: {{ site.cookbook_url | absolute_url }}/recipe/0231-transcript-meta-recipe/#version-4 "Transcripts, Captions, and Subtitles - General Considerations" [0232]: {{ site.cookbook_url | absolute_url }}/recipe/0232-image-thumbnail-canvas/ "Implementation discussion: Thumbnails on Canvases" [0234]: {{ site.cookbook_url | absolute_url }}/recipe/0234-provider/ "Acknowledge Content Contributors" [0240]: {{ site.cookbook_url | absolute_url }}/recipe/0240-navPlace-on-canvases/ "Locate Multiple Canvases on a Web Map" -[253-4]: {{ site.cookbook_url | absolute_url }}/recipe/0253-using-transcript-file/ "Using Transcript Files with Audio or Video Content" + +[0253-4]: {{ site.cookbook_url | absolute_url }}/recipe/0253-using-transcript-file/ "Using Transcript Files with Audio or Video Content" [0258]: {{ site.cookbook_url | absolute_url }}/recipe/0258-tagging-external-resource/ "Tagging with an External Resource" [0261]: {{ site.cookbook_url | absolute_url }}/recipe/0261-non-rectangular-commenting/ "Annotation with a Non-Rectangular Polygon" [0266]: {{ site.cookbook_url | absolute_url }}/recipe/0266-full-canvas-annotation/ "Simplest Annotation" diff --git a/index.md b/index.md index aadf15b3c..d3ca36b99 100644 --- a/index.md +++ b/index.md @@ -73,7 +73,7 @@ _The corresponding 2.1 test fixture(s) is given like this, where appropriate: .. * [Providing Access to Transcript Files of A/V Content][0017] * [Using Annotations for Timed Text][0079] * [Using Caption and Subtitle Files with Video Content][0219] - * [A Side-by-side Transcript of a Video Recording][0253] + * [A Side-by-side Transcript of a Video Recording][0253-4] * Transcription of content into XML, with XPaths to select a segment ## Other kinds of annotations diff --git a/recipe/0253-using-transcript-file/index.md b/recipe/0253-using-transcript-file/index.md new file mode 100644 index 000000000..660c248b0 --- /dev/null +++ b/recipe/0253-using-transcript-file/index.md @@ -0,0 +1,28 @@ +--- +title: Using Transcript Files with Audio or Video Content +id: 253 +layout: recipe +tags: [video, audio, transcript, presentation] +summary: "Providing a transcript file to to be rendered alongside an audio or video resource." +v4-viewers: + +topic: AV +top_tabs: + - label: Version 4 + content: "{% capture my_include %}{%- include_relative v4/recipe.md version='4' -%}{% endcapture %}{{ my_include | markdownify }}" +--- + +{{ theme.block-center-start }} + +{% include blocks/tabs.html tabs=page.top_tabs %} + +{{ theme.block-end }} + + + + diff --git a/recipe/0253-using-transcript-file/v4/manifest.json b/recipe/0253-using-transcript-file/v4/manifest.json new file mode 100644 index 000000000..9d78fd330 --- /dev/null +++ b/recipe/0253-using-transcript-file/v4/manifest.json @@ -0,0 +1,67 @@ +{ + "@context": "http://iiif.io/api/presentation/3/context.json", + "id": "{{ id.url }}", + "type": "Manifest", + "label": { + "en": [ + "Lunchroom Manners" + ] + }, + "items": [ + { + "id": "{{ id.path }}/canvas", + "type": "Canvas", + "height": 360, + "width": 480, + "duration": 572.034, + "items": [ + { + "id": "{{ id.path }}/canvas/page", + "type": "AnnotationPage", + "items": [ + { + "id": "{{ id.path }}/canvas/page/annotation1", + "type": "Annotation", + "motivation": "painting", + "body": { + "id": "https://fixtures.iiif.io/video/indiana/lunchroom_manners/high/lunchroom_manners_1024kb.mp4", + "type": "Video", + "height": 360, + "width": 480, + "duration": 572.034, + "format": "video/mp4" + }, + "target": "{{ id.path }}/canvas" + } + ] + } + ], + "annotations": [ + { + "id": "{{ id.path }}/canvas/page2", + "type": "AnnotationPage", + "items": [ + { + "id": "{{ id.path }}/canvas/page2/a1", + "type": "Annotation", + "motivation": "supplementing", + "provides": ["transcript"], + "body": { + "id": "https://fixtures.iiif.io/video/indiana/lunchroom_manners/lunchroom_manners.docx", + "type": "Text", + "format": "text/vtt", + "label": { + "en": [ + "Transcript in WebVTT format" + ] + }, + "language": "en" + }, + "target": "{{ id.path }}/canvas" + } + ] + } + ] + } + ] +} diff --git a/recipe/0253-using-transcript-file/v4/recipe.md b/recipe/0253-using-transcript-file/v4/recipe.md new file mode 100644 index 000000000..0fc65b950 --- /dev/null +++ b/recipe/0253-using-transcript-file/v4/recipe.md @@ -0,0 +1,34 @@ +## Use Case + +Transcripts may be available for your audio and/or video content and should be enabled for side-by-side display alongside your IIIF media resources. + +## Implementation notes + +External transcript files may exist in a wide variety of formats, including .vtt, .srt, .docx, .txt, and .pdf. To improve accessibility, it is ideal for a IIIF media viewer to display as many potential formats as possible. +Some markup file formats use time tags that allow for time alignment of the audio or video content with the transcript, primarily [WebVTT](http://en.wikipedia.org/wiki/WebVTT) or [SRT](https://en.wikipedia.org/wiki/SubRip) (SubRip Text). + +Offering the transcript file(s) as an Annotation on the Canvas that contains the media file itself enables us to express the relationship between the two. The `provides` property of the Annotation can be used by the client to identify transcript files that should be rendered side-by-side or adjacent to the media item itself. +The `format` property of the Annotation can be used to determine if the transcript file format can be rendered directly to the user by the media viewer. + +In addition to this implementation, one could also offer transcripts as a series of timed textual annotations, making the text available in multiple ways. See [Using Annotations for Timed Text][0079-4]. + +While captions, subtitles, and transcripts each present some text interpretation of the A/V content, the ways in which they are consumed by users differ. For a more detailed discussion about these differences see [Transcripts, Captions, and Subtitles - General Considerations][0231-4]. + +## Example + +In this example we demonstrate a transcript file in the docx format, but other formats are possible (see above). + +{% include manifest_links.html viewers="" manifest="v4/manifest.json" version="4"%} + +{% include jsonviewer.html src="v4/manifest.json" config='data-line="43-61"'%} + +# Related recipes + +- [Using Caption Files with Video Content][0219-4] +- [Using Caption and Subtitle Files in Multiple Languages with Video Content][0074-4] +- [Using Annotations for Timed Text][0079-4] +- [Providing Access to Transcripts of A/V Content][0017] +- [Annotating a Poetry Reading][0103] + +{% include acronyms.md %} +{% include links.md %} \ No newline at end of file