0.10.0 - Added support for <podcast:transcript> and a simple transcript generator tool

[vnali]

Since 0.10.0, the Studio plugin added support for podcast:transcript.

You can have <podcast:transcript> tags on your podcast RSS in different ways:

1- Transcript files are ready:
Create a custom field with the default handle episodeTranscript (or you can specify this handle on the config/studio.php file on your project).

• It can be an asset field for representing some transcript items.
  • <podcast:transcript> URL attributes are the URL of uploaded assets and type attributes are the mime type of those assets
• It can be a matrix/supertable field (For matrix, block type handle can be transcript or it can be specified via config/studio.php file).
  • Inside this block type or super table you can have an asset field with a transcript handle
    • <podcast:transcript> URL attributes are the URL of uploaded assets and type attributes are the mime type of those assets.
  • Inside this block type or super table you can have an URL field with a transcript handle and a radio/dropdown with the handle of mimeType.
    • mimeType field values should be text/plain/text/vtt/application/json/application/x-subrip
    • <podcast:transcript> URL attributes are the URL of the transcript field and the type attribute is the value of the mimeType field

podcast-transcript1.mp4

2- Writing transcript as plain text without a time code:

• you should have a custom text area field with the default handle transcriptText (or you can specify this handle on the config/studio.php file on your project).
• write the transcript inside the text area.
• you can download the text version from the transcript sidebar and follow Transcript files are ready to upload the transcript file, or:
• you can create a dropdown field with episodeTranscript handle, one option can be text. if the user edit the episode and select this option, the plugin creates <podcast:transcript> tag and its url is pointed to content of transcriptText field.

podcast-transcript2.mp4

3- Generating time-coded transcript files/Using time-coded transcripts:

• You should have a custom text area field with the default handle transcriptText (or you can specify this handle on the config/studio.php file on your project).
• On the episode edit page, Click on the asset field to preview the asset
• Use the start caption/stop caption button to specify the start time and stop time of the caption
• You can select/add a speaker (suggested speakers are from podcast:person tag) and type caption text. by saving this form, the plugin adds the vtt format to the text area field.
• Finally
  • you can download subtitle files in different formats and upload them to the transcript field (follow Transcript files are ready) or
  • Create a radio/checkbox/dropdown/multi select field with the default handle episodeTranscript. supported values are text, html, json, srt, vtt. now the user can edit an episode and select some formats. when the studio plugin creates RSS, it creates <podcast:transcript> tags for selected formats. in this case url attribute of <podcast:transcript> is something like http://siteurl/episodes/transcript?episodeId=x&site=y&type=srt and if the content of transcriptText is in valid vtt format, it returns the transcript in passed type format

podcast-transcript3.mp4

Getting transcript in the text field via GraphQL:
When fetching a transcript in the transcriptText field via GraphQL, you can use @transcript directive to get it in a different format
for example

{
  episodes{
     title,
    ... on podcastformatName_Episode{
      transcript_format1:transcriptText@transcript(format:"json"),
      transcript_format2:transcriptText@transcript(format:"srt")
    }
  }
}