Editing Transcript Workflow
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
{{#lst:The Portal Transcripts|transcript-infobox}} <!-- Includes the Transcripts project infobox --> | {{#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 | 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 == | == 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/ | 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/blog blog]. | ||
=== Make accounts === | === Make accounts === | ||
Line 16: | Line 16: | ||
== Basic Editing Rules == | == Basic Editing Rules == | ||
[[File:ParagraphsExampleImage.png|thumb|right|A labelled example | [[File:ParagraphsExampleImage.png|thumb|right|A labelled example that shows paragraph formatting.]] | ||
We have developed a | We have developed a style guide to keep our transcripts consistent. Here are the basics: | ||
* We use American English. | * We use American English. | ||
* We use a clean verbatim style. This means filler words (um, uh, etc.) | * We use a clean verbatim style. This means filler words (um, uh, etc.) and repeated words or phrases, when they do not add meaning or nuance, are removed. | ||
* Paragraphs are not indented. | * Paragraphs are not indented. | ||
* | * Leave an empty paragraph 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. | * 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). | * Speaker tags are bold, punctuated with a colon, and use the speaker's full name (first + last). | ||
Line 38: | Line 38: | ||
# Edit in Google Docs again, fine tuning grammar and punctuation. | # Edit in Google Docs again, fine tuning grammar and punctuation. | ||
Leave comments where you're uncertain on what is being said. Search online for terms or phrases that you don't know, Google can usually find most of them. Search for song lyrics or exact quotes in order to mirror how they were originally written. | |||
For guidance on typesetting mathematics, see our | For guidance on typesetting mathematics, see our style guide. | ||
=== Tips for Otter === | === Tips for Otter === | ||
[[File:OtterExportOptions.png|thumb|right|Options to use when exporting from 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. | * 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/360047731754-Edit-a-conversation Otter's Editing Guide] | ||
* [https://help.otter.ai/hc/en-us/articles/360047733634-Export-conversations Otter's Export Guide] | * [https://help.otter.ai/hc/en-us/articles/360047733634-Export-conversations Otter's Export Guide] | ||
Line 54: | Line 52: | ||
[[File:GDocsSmartQuotes.png|thumb|right|The smart quotes option in Preferences.]] | [[File:GDocsSmartQuotes.png|thumb|right|The smart quotes option in Preferences.]] | ||
[[File:GDocsSubstitutions.png|thumb|right|The automatic substitution option in Preferences.]] | [[File:GDocsSubstitutions.png|thumb|right|The automatic substitution option in Preferences.]] | ||
* Disable smart quotes in Preferences | * Disable smart quotes in Preferences | ||
* Disable substitutions in Preferences | * Disable substitutions in Preferences | ||
* Use heading level 3 as your highest heading level. | * Use heading level 3 as your highest heading level. | ||
Line 65: | Line 63: | ||
Copy/Paste it from Google Docs onto the wiki. Note that: | 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. | * Timestamps must be followed by a <code><nowiki><br></nowiki></code> tag to insert the linebreak. | ||
* | * 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 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. | ||
Line 88: | Line 86: | ||
|} | |} | ||
== If I want to stop part-way | == If I want to stop part-way == | ||
Tell us! | Tell us! | ||
<!-- | <!-- | ||
Line 209: | Line 207: | ||
[[Category:Projects]] | [[Category:Projects]] | ||
[[Category:Guides]] | [[Category:Guides]] | ||