User:Aardvark/TranscriptWorkflow: Difference between revisions

no edit summary
No edit summary
No edit summary
 
(33 intermediate revisions by the same user not shown)
Line 4: Line 4:


== Before you start ==
== Before you start ==
There are a couple things you should know before starting. Also check that there isn't already a transcript for what you would like to contribute to, using our sheet, the wiki categories, or the blog.
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 ==
We have developed a style guide to keep our transcripts consistent. Here are the basics.
[[File:ParagraphsExampleImage.png|thumb|right|A labelled example that shows paragraph formatting.]]
We have developed a style guide to keep our transcripts consistent. Here are the basics:


* We use a clean verbatim style. This means filler words (ums/uhs) and repeated words when they do not add extra meaning (and, and , and ...) are removed.
* We use American English.
* 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.
* 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.
* 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 notes in brackets for things that happen in video but don't translate to audio.
* No indent on paragraphs
* Add headings to identify the discussion topic.
* In your text editor, leave an empty paragraph between existing ones
* Timestamp on top, italicized, shift+enter for line break (not paragraph break from regular enter)
* For speaker tags: full speaker name (first + last), bolded with a colon.
* For multiple paragraphs by the same speaker, only the first should have a speaker tag
* Add section headings


Be sure to review our style guide for everything in detail with examples.
Be sure to review our style guide for everything in detail with examples.


== Editing Process ==
== Editing Process ==
Some people prefer doing the majority of their editing in Otter, while others prefer Google Docs. Both are necessary, but you are free to use them as best suits your preferences.
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
# Edit in Otter, focusing on matching text to the correct speaker and correcting obvious errors as convenient.
# Edit in GDocs while listening
# Export to Google Docs when finished.
# Edit in GDocs again
# 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.


=== Using Otter ===
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.
* https://help.otter.ai/hc/en-us/articles/360047731754-Edit-a-conversation
* https://help.otter.ai/hc/en-us/articles/360047733634-Export-conversations


=== Using Google Docs ===
For guidance on typesetting mathematics, see our 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
* Disable substitutions in Preferences
* Use heading level 3 as your highest heading level.


== When finished ==
== When finished ==
Tell us! We'll look it over and put it on the blog.
Tell Aardvark or Brooke. We'll look it over and post it on the blog.


Paste it onto the wiki. Note that
=== 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.
* 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>.
* 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 heading levels may differ between the Google doc and the wiki, all that needs to be preserved is.
* 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.


Also add the transcript blurb template.
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]].
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]].


== If I don't want to continue working on a transcript ==
== 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 ==
Tell us!
Tell us!


<!--
<!--
== Getting Started ==
=== Add Podcast Episode Information to Wiki ===
* Find new episodes of [https://art19.com/shows/the-portal The Portal Podcast].
* Create a page for the podcast episode. Here's the list of [[All Episodes]]. Edit the page and add the newest episode there. Let logic lead you down the path.
* Put the description paragraph at the top of the document. (You may be tempted to put a heading above the intro paragraph called "Description". Resist this temptation. If you put that heading, the Table of Contents will be put at the very top of the document. This will make the "next" and "previous" navigation hard to find.)
* Add the thumbnail using the format of [https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg this URL]. All you have to do is change the YouTube ID in the URL to get the large thumbnail for any video. Look at how the other pages do this and copy that to the new page.
== Working on a Transcript ==
== Working on a Transcript ==


Line 180: Line 205:
|}
|}
-->
-->
[[Category:Projects]]
[[category:guides]]