Transcript Workflow: Difference between revisions
Β |
|||
(59 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
{{#lst:The Portal Transcripts|transcript-infobox}} <!-- Includes the Transcripts project infobox --> | |||
This is the workflow for generating and editing transcripts for [[The Portal Podcast]] and other [[Content by Eric Weinstein]]. It introduces the tools we use, our [[Transcript Style Guide|style guide]], and our process. | |||
== | == Before you start == | ||
There are a few things you should have ready before starting. Also check that there isn't already a completed transcript for what you would like to contribute to, using our [https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit?usp=sharing spreadsheet], the [[:Category:Transcript|transcript wiki category]], or the [https://theportal.group/tag/transcript/ blog]. | |||
=== | === Make accounts === | ||
In order to give you access to our transcripts, you'll need accounts with the services we use. | |||
* Have a [https://discord.com/ Discord] account. Discord is an online chat service where we coordinate our work. | |||
* Have an [https://otter.ai/ Otter.ai] account. We generate our transcripts in Otter, where they can be edited to match speakers to text. | |||
* Have a [https://google.com/ Google] account. We use Google Drive and Google Docs to store and coordinate our work. | |||
=== | === Contact us on Discord === | ||
Contact Aardvark or Brooke on our transcript-focused [https://discord.gg/wu957e7 Discord server] or our main [https://discord.gg/VxEuDZD2PC Discord server]. Say what you'd like to work on and we'll give you access to our Drive folder and the AI-generated transcript in Otter. | |||
== Basic Editing Rules == | |||
[[File:ParagraphsExampleImage.png|thumb|right|A labelled example of paragraph formatting.]] | |||
We have developed a [[Transcript Style Guide|style guide]] to keep our transcripts consistent. Here are the basics: | |||
* We use American English. | |||
* We use a clean verbatim style. This means filler words (um, uh, etc.), false starts, and repeated words or phrases, when they do not add meaning or nuance, are removed. | |||
* Paragraphs are not indented. | |||
* An empty paragraph is left between paragraphs. | |||
* Timestamps (preferably taken from the content's YouTube version) are at the start of a paragraph, italicized, of the form ''HH:MM:SS'', and separated by a line break (<code>Shift + Enter</code>) from the rest of the paragraph. | |||
* Speaker tags are bold, punctuated with a colon, and use the speaker's full name (first + last). | |||
* Only the first of consecutive paragraphs by a speaker should have a speaker tag. | |||
* Add notes in brackets for things that happen in video but don't translate to audio. | |||
* Add headings to identify the discussion topic. | |||
Be sure to review our style guide for everything in detail with examples. | |||
== Editing Process == | |||
Some people prefer doing the majority of their editing and corrections in Otter, while others prefer Google Docs. Both are necessary, but you are free to use them as best suits your preferences. The general process follows these steps: | |||
# Edit in Otter, focusing on matching text to the correct speaker and correcting obvious errors as convenient. | |||
# Export to Google Docs when finished. | |||
# Edit in Google Docs while listening to the source material, correcting major errors and adding paragraph breaks and new timestamps where necessary. | |||
# Edit in Google Docs again, fine tuning grammar and punctuation. | |||
=== Editing Tips === | |||
* Leave comments where you're uncertain on what is being said. | |||
* Search online for terms or phrases that you don't know. [https://www.google.com/ Google], [https://en.wikipedia.org/wiki/Main_Page Wikipedia], and [https://arxiv.org/ arXiv] should cover almost all cases. | |||
* Search for song lyrics or exact quotes in order to mirror how they were originally written. | |||
For guidance on typesetting mathematics, see our [[Transcript Style Guide|style guide]]. | |||
=== Tips for Otter === | |||
[[File:OtterExportOptions.png|thumb|right|Options to use when exporting from Otter.]] | |||
* Export as text to your clipboard, and paste it into a new Google Doc. '''Wait to make sure that Otter has finished "matching speakers" before exporting.''' | |||
* [https://help.otter.ai/hc/en-us/articles/360047731754-Edit-a-conversation Otter's Editing Guide] | |||
* [https://help.otter.ai/hc/en-us/articles/360047733634-Export-conversations Otter's Export Guide] | |||
=== Tips for Google Docs === | |||
[[File:GDocsSmartQuotes.png|thumb|right|The smart quotes option in Preferences.]] | |||
[[File:GDocsSubstitutions.png|thumb|right|The automatic substitution option in Preferences.]] | |||
* Disable smart quotes in Preferences (see image on right). | |||
* Disable substitutions in Preferences (see image on right). | |||
* Use heading level 3 as your highest heading level. | |||
== When finished == | |||
Tell Aardvark or Brooke. We'll look it over and post it on the blog. | |||
=== Putting it on the wiki === | |||
[[File:WikiTimestampLineBreakExample.png|thumb|right|Example of using <br> tags to insert linebreaks after timestamps.]] | |||
Copy/Paste it from Google Docs onto the wiki. Note that: | |||
* Timestamps must be followed by a <code><nowiki><br></nowiki></code> tag to insert the linebreak. | |||
* Speaker names will need to be bolded. Perform a find/replace operation with each speaker name, replacing the speaker name with the name surrounded by three tick marks. So <code>Eric Weinstein:</code> is replaced <code><nowiki>'''Eric Weinstein:'''</nowiki></code>. | |||
* Add the necessary markup around section headings. Keep in mind that heading levels may differ between the Google Doc and the wiki, all that needs to be preserved is the relative ordering. | |||
Add the [[:Template:Transcript blurb|transcript blurb template]] and credit yourself. | |||
For more help on using the wiki, see [https://en.wikipedia.org/wiki/Help:Wikitext Wikipedia's guide on Wiki markup] and our [[Wiki Usage FAQ]]. | |||
== Example Transcripts == | |||
Here are some completed transcripts to refer to as examples. | |||
{| class="wikitable" | |||
|- | |||
! Transcript !! Google Doc !! Wiki Page !! Blog Post | |||
|- | |||
| The Portal Podcast Episode 2 || [https://docs.google.com/document/d/1BEXCxpOkKKK7lYWRYlnf2p9QTD2VWz-GYUDY_OP8zLw/edit?usp=sharing Link] || [[Ep2|Link]] || [https://theportal.group/the-portal-episode-002-what-is-the-portal/ Link] | |||
|- | |||
| The Portal Podcast Episode 8 || [https://docs.google.com/document/d/1xoYpcimh0SflNpzshWSbUVbzw2gk21195p-RvSRZK9o/edit?usp=sharing Link] || [[Ep8|Link]] || [https://theportal.group/8-andrew-yang-the-different-candidate-the-media-wants-you-to-ignore/ Link] | |||
|- | |||
| Eric on the Glenn Beck Podcast || [https://docs.google.com/document/d/1mY1xPog-jW12uwtepsuAZ0Wz95Q5a-hMzHumZwH50wY/edit?usp=sharing Link] || [[Why Eric Weinstein Is Finally Talking to Glenn Beck (YouTube Content)|Link]] || [https://theportal.group/eric-on-the-glenn-beck-podcast/ Link] | |||
|- | |||
| Geometric Unity on Into the Impossible || [https://docs.google.com/document/d/1g-FYv6Wi0zQLhPlaRRcaix2aySKkyGNivWX70UOkI-Q/edit?usp=sharing Link] || [[Eric Weinstein: A Conversation (YouTube Content)|Link]] || [https://theportal.group/into-the-impossible-eric-weinstein-geometric-unity-revealed/ Link] | |||
|} | |||
== If I want to stop part-way through == | |||
Tell us! This is a volunteer project, so we have no expectations or requirements for completion. | |||
<!-- | |||
== Working on a Transcript == | == Working on a Transcript == | ||
=== Make a Machine Readable Version === | === Make a Machine Readable Version === | ||
* Get the MP3 Β | * Get the MP3 (from the episode wiki page) | ||
* Import the MP3 into Descript | * Import the MP3 into Descript | ||
* Export a VTT file from Descript | * Export a VTT file from Descript | ||
Line 19: | Line 102: | ||
* Link VTT file in [https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit#gid=0 The Portal Media Progress] | * Link VTT file in [https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit#gid=0 The Portal Media Progress] | ||
=== Run Through Alex's VTT | === Run Through Alex's VTT Conversion Program === | ||
* | Find the [https://github.com/Buhlean/The-Portal-Scripts VTT Conversion Program] on Github. | ||
* | Then either: | ||
* Paste into Wiki | * Download [http://Python.org/downloads Python] 3.x, download the Conversion Script ([https://github.com/Buhlean/The-Portal-Scripts/blob/master/Transcript_Converter.pyw .pyw]) and run it. | ||
or: | |||
* Download the [https://github.com/Buhlean/The-Portal-Scripts/blob/master/Transcript_Converter.zip .zip] with the Windows executable inside from GitHub and run it. | |||
Regardless of which one you choose, you can then: | |||
* open the output '_wiki.txt' file | |||
* Paste into Wiki | |||
=== Make Human- | === Make Human-Edited Version === | ||
* Add your name to the "Responsibility" column in [https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit#gid=0 The Portal Media Progress], so people know who to contact with | * Add your name to the "Responsibility" column in [https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit#gid=0 The Portal Media Progress], so people know who to contact with questions. | ||
* Make edits to the wiki. All progress will be tracked in the "View History" tab. | * Make edits to the wiki. All progress will be tracked in the "View History" tab. | ||
* | ** If you want your name to be listed in the History, then you'll need to [[Special:CreateAccount|create an account]]. | ||
=== Update VTT file with Human- | === Update VTT file with Human-edited Version === | ||
* Upload the MP3 file to Descript | * Upload the MP3 file to Descript | ||
* Make sure file is in right format to be imported into Descript. | * Make sure file is in right format to be imported into Descript. | ||
Line 36: | Line 123: | ||
** https://help.descript.com/en/articles/3337674-transcribing-an-audio-video-file | ** https://help.descript.com/en/articles/3337674-transcribing-an-audio-video-file | ||
** Import the transcript into Descript | ** Import the transcript into Descript | ||
* Export VTT file | |||
* Upload back to wiki. Make sure you use the same filename, so that a new version of the file is created. | |||
== | === Run Through VTT Parser to Make Wiki-Friendly Text === | ||
* Paste new version to wiki. | |||
Β | * Update "Transcript Notes". | ||
* | --> | ||
Β | |||
Β | |||
* | |||
Β | |||
Β | |||
<!-- | |||
=== The Portal Podcast .vtt Files === | === The Portal Podcast .vtt Files === | ||
{| class="wikitable sortable" Β | {| class="wikitable sortable" Β | ||
Line 197: | Line 206: | ||
| 0 ||[[0: Welcome to The Portal]] || [[:File:0_welcome.vtt|Episode 0 VTT File]] || Finished | | 0 ||[[0: Welcome to The Portal]] || [[:File:0_welcome.vtt|Episode 0 VTT File]] || Finished | ||
|} | |} | ||
--> | |||
[[Category:Projects]] | |||
[[Category:The Portal Transcripts]] | |||
[[Category:Guides]] | |||
[[Category:Commented content]] |
Latest revision as of 15:05, 18 August 2022
The Portal Transcripts (Transcript Completion Project) | |
Information | |
---|---|
Topic | The Portal Podcast |
Leader | pyrope#5830 BeefSandwich27#0143 Aardvark#5610 |
Start Date | 31 January 2020 |
Methodology | Transcript Workflow |
Style Guide | Wiki Page |
Portal Media Spreadsheet | Sheet |
Google Drive | Drive |
Links | |
Website | The Portal Blog |
Discord | Link |
The Portal Group Discord | Link |
All Projects |
This is the workflow for generating and editing transcripts for The Portal Podcast and other Content by Eric Weinstein. It introduces the tools we use, our style guide, and our process.
Before you start[edit]
There are a few things you should have ready before starting. Also check that there isn't already a completed transcript for what you would like to contribute to, using our spreadsheet, the transcript wiki category, or the blog.
Make accounts[edit]
In order to give you access to our transcripts, you'll need accounts with the services we use.
- Have a Discord account. Discord is an online chat service where we coordinate our work.
- Have an Otter.ai account. We generate our transcripts in Otter, where they can be edited to match speakers to text.
- Have a Google account. We use Google Drive and Google Docs to store and coordinate our work.
Contact us on Discord[edit]
Contact Aardvark or Brooke on our transcript-focused Discord server or our main Discord server. Say what you'd like to work on and we'll give you access to our Drive folder and the AI-generated transcript in Otter.
Basic Editing Rules[edit]
We have developed a style guide to keep our transcripts consistent. Here are the basics:
- We use American English.
- We use a clean verbatim style. This means filler words (um, uh, etc.), false starts, and repeated words or phrases, when they do not add meaning or nuance, are removed.
- Paragraphs are not indented.
- An empty paragraph is left between paragraphs.
- Timestamps (preferably taken from the content's YouTube version) are at the start of a paragraph, italicized, of the form HH:MM:SS, and separated by a line break (
Shift + Enter
) from the rest of the paragraph. - Speaker tags are bold, punctuated with a colon, and use the speaker's full name (first + last).
- Only the first of consecutive paragraphs by a speaker should have a speaker tag.
- Add notes in brackets for things that happen in video but don't translate to audio.
- Add headings to identify the discussion topic.
Be sure to review our style guide for everything in detail with examples.
Editing Process[edit]
Some people prefer doing the majority of their editing and corrections in Otter, while others prefer Google Docs. Both are necessary, but you are free to use them as best suits your preferences. The general process follows these steps:
- Edit in Otter, focusing on matching text to the correct speaker and correcting obvious errors as convenient.
- Export to Google Docs when finished.
- Edit in Google Docs while listening to the source material, correcting major errors and adding paragraph breaks and new timestamps where necessary.
- Edit in Google Docs again, fine tuning grammar and punctuation.
Editing Tips[edit]
- Leave comments where you're uncertain on what is being said.
- Search online for terms or phrases that you don't know. Google, Wikipedia, and arXiv should cover almost all cases.
- Search for song lyrics or exact quotes in order to mirror how they were originally written.
For guidance on typesetting mathematics, see our style guide.
Tips for Otter[edit]
- Export as text to your clipboard, and paste it into a new Google Doc. Wait to make sure that Otter has finished "matching speakers" before exporting.
- Otter's Editing Guide
- Otter's Export Guide
Tips for Google Docs[edit]
- Disable smart quotes in Preferences (see image on right).
- Disable substitutions in Preferences (see image on right).
- Use heading level 3 as your highest heading level.
When finished[edit]
Tell Aardvark or Brooke. We'll look it over and post it on the blog.
Putting it on the wiki[edit]
Copy/Paste it from Google Docs onto the wiki. Note that:
- Timestamps must be followed by a
<br>
tag to insert the linebreak. - Speaker names will need to be bolded. Perform a find/replace operation with each speaker name, replacing the speaker name with the name surrounded by three tick marks. So
Eric Weinstein:
is replaced'''Eric Weinstein:'''
. - Add the necessary markup around section headings. Keep in mind that heading levels may differ between the Google Doc and the wiki, all that needs to be preserved is the relative ordering.
Add the transcript blurb template and credit yourself.
For more help on using the wiki, see Wikipedia's guide on Wiki markup and our Wiki Usage FAQ.
Example Transcripts[edit]
Here are some completed transcripts to refer to as examples.
Transcript | Google Doc | Wiki Page | Blog Post |
---|---|---|---|
The Portal Podcast Episode 2 | Link | Link | Link |
The Portal Podcast Episode 8 | Link | Link | Link |
Eric on the Glenn Beck Podcast | Link | Link | Link |
Geometric Unity on Into the Impossible | Link | Link | Link |
If I want to stop part-way through[edit]
Tell us! This is a volunteer project, so we have no expectations or requirements for completion.