diff --git a/transcripts/transcripts.md b/transcripts/transcripts.md index 41d415e..9ed9ad2 100644 --- a/transcripts/transcripts.md +++ b/transcripts/transcripts.md @@ -6,97 +6,78 @@ Some transcript implementations are done in-browser. [CORS headers](https://deve are required to make these files available from other websites. [A CORS tester is available here](https://cors-test.codehappy.dev/), to ensure that transcripts are available within browser-based players. -The examples given below are just for convenience. In production you should ensure you are conforming to the actual -spec for each format as defined in it's own documentation. +* **Want to support only one format?** WebVTT is used by Apple Podcasts for ingest, and also natively supported by web browsers. Because the WebVTT format is the most flexible, it's an ideal choice if you can only support one format. -

+The examples given below are just for convenience. In production you should ensure you are conforming to the actual spec for each format as defined in its own documentation. +## WebVTT -## HTML +The [Web Video Text Tracks Format (WebVTT)](https://www.w3.org/TR/webvtt1/) is designed for use in HTML on the web. You can use the [ element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/track) in your own web-based players to make closed-captions appear on a web-page. -The HTML transcript format provides a solution when a transcript is available but no or limited timecode data is available. HTML transcript files are considered low-fidelity and are -designed to serve as an accessibility aid and provide searchable episode content. The HTML format used for podcast transcripts should adhere to the following specifications. +A VTT file contains medium-fidelity timestamps. It differs from the SRT format (below) because you can optionally add speaker names, including them in a voice span tag `` at the beginning of each caption when they change, as in the snippet below. Apple Podcasts supports these speaker names, and will ingest them into its transcript tool. -#### HTML tags used: -- ``: Name of the speaker (if available) -- `