Transcript Workflow: Difference between revisions

From The Portal Wiki
No edit summary
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This is where we coordinate to get transcripts of every episode completed. If you want to help, join '''[https://discord.gg/BDmJVp8 The Portal Transcripts Discord]'''. This is part of the '''[[Transcript Completion Project]]'''.
This is where we coordinate to get transcripts of every episode completed. If you want to help, check out the following links:
 
* '''[https://discord.gg/BDmJVp8 The Portal Transcripts Discord]'''
To see our progress, check out '''[https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit#gid=0 The Portal Media Progress]'''.
* [https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit#gid=0 The Portal Media Progress]
 
* [[Transcript Completion Project]]


== Getting Started ==
== Getting Started ==
Line 10: Line 10:
* 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.
* 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.)
* 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/dJNjH4SP6vw/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.
* 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.
* Buttons: next, prev, mp3, art19, etc.
* Make sure to include the buttons: next, prev, mp3, art19, etc.


=== Join the Transcripts Discord ===
=== Join the Transcripts Discord ===
Line 17: Line 17:


=== Pick an Episode that You'd Like to Work On ===
=== Pick an Episode that You'd Like to Work On ===
* Tell us which episode you'd like to do some work on.
* Go to the #general channel and tell us which episode you'd like to do some work on. We'll point you in the right direction.


=== See What Status It's In ===
=== See What Status It's In ===
Line 32: Line 32:
* 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 Parsing Program ===
=== Run Through Alex's VTT Conversion Program ===
 
Find the [https://github.com/Buhlean/The-Portal-Scripts VTT Parsing Program] on Github
 
* Either ping Alex (Buhlean#2694) and wait
 
Or


* Download [http://Python.org/downloads Python] 3.x, download the Conversion Script (discord) and follow the instructions in the file
Find the [https://github.com/Buhlean/The-Portal-Scripts VTT Conversion Program] on Github.
Then either:
* 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
* open the output '_wiki.txt' file
* Paste into Wiki
* Paste into Wiki


=== Make Human-Made Version ===
=== 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 questions.
* 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]]. (New user accounts are temporarily locked due to vandalism. <span class="highlight">Contact [[User:BeefSandwich27|Brandon]] and he'll unlock things to let you create an account.</span>)
** If you want your name to be listed in the History, then you'll need to [[Special:CreateAccount|create an account]].
* Once you feel like you're done, change the Transcript Status to "Human-Made" in [https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit#gid=0 The Portal Media Progress].
* Once you feel like you're done, change the Transcript Status to "Human-edited" in [https://docs.google.com/spreadsheets/d/1lFYnK-Z_eDAp_6D7SAZvCrcw3LxoLdBcEHzzVs9oztI/edit#gid=0 The Portal Media Progress].


=== Update VTT file with Human-Made Version ===
=== 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 231: Line 230:
=== Other Media ===
=== Other Media ===
Create a table here for other media the community finds relevant or useful.
Create a table here for other media the community finds relevant or useful.
[[Category:Projects]]
[[category:guides]]

Revision as of 19:49, 30 July 2020

This is where we coordinate to get transcripts of every episode completed. If you want to help, check out the following links:

Getting Started

Add Podcast Episode Information to Wiki

  • Find new episodes of 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 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.
  • Make sure to include the buttons: next, prev, mp3, art19, etc.

Join the Transcripts Discord

Pick an Episode that You'd Like to Work On

  • Go to the #general channel and tell us which episode you'd like to do some work on. We'll point you in the right direction.

See What Status It's In

Working on a Transcript

Make a Machine Readable Version

  • Get the MP3 (from the episode wiki page)
  • Import the MP3 into Descript
  • Export a VTT file from Descript
    • Check the "Remove ums/uhs Checkbox"
  • Upload VTT file to wiki
  • Link VTT file in The Portal Media Progress

Run Through Alex's VTT Conversion Program

Find the VTT Conversion Program on Github. Then either:

  • Download Python 3.x, download the Conversion Script (.pyw) and run it.

or:

  • Download the .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-Edited Version

  • Add your name to the "Responsibility" column in 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.
    • If you want your name to be listed in the History, then you'll need to create an account.
  • Once you feel like you're done, change the Transcript Status to "Human-edited" in The Portal Media Progress.

Update VTT file with Human-edited Version

Run Through VTT Parser to Make Wiki-Friendly Text

  • Paste new version to wiki.
  • Update "Transcript Notes".


Annotating a Transcript


Other Media

Create a table here for other media the community finds relevant or useful.