Editing Transcript Style Guide

Warning: You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

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 style guide for [[The Portal Transcripts]].
Style guide for [[The Portal Transcripts]]. [https://docs.google.com/document/d/1m_nCPXVSFfTw7asW7oMUoINwVoHxKz78Wqeiss_DrM0/edit?usp=sharing Link].
<!--
Also see our [[Transcript Workflow|transcript workflow]].
-->
<!--
An early version is available at this [https://docs.google.com/document/d/1m_nCPXVSFfTw7asW7oMUoINwVoHxKz78Wqeiss_DrM0/edit?usp=sharing link].
-->
== General Guidelines ==
Our transcripts are in 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.
 
Headings are added to identify the discussion topic.


== Word Processor Configuration ==
== Word Processor Configuration ==
[[File:GDocsSmartQuotes.png|thumb|right|The smart quotes option in Preferences.]]
* Disable smart quotes
[[File:GDocsSubstitutions.png|thumb|right|The automatic substitution option in Preferences.]]
* Disable Substitutions
Disable smart quotes in Preferences (see image on right).
 
Disable automatic substitutions in Preferences (see image on right).


== Spelling Help ==
== Spelling Help ==
Search for unknown terms or names, or search for the words in their context to find their proper spelling. [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 unknown terms or names, or search for some of the words in their context to find their proper spelling.


== Headings ==
== Headings ==
Line 29: Line 14:


== Paragraphs ==
== Paragraphs ==
[[File:ParagraphsExampleImage.png|thumb|right|A labelled example of paragraph formatting.]]
Paragraphs should contain a whole idea.
Paragraphs should in general contain a whole idea.
 
Paragraphs are not indented.
 
An empty paragraph is left between paragraphs.


=== Paragraph Breaks ===
=== Paragraph Breaks ===
Line 40: Line 20:


=== Timestamp ===
=== Timestamp ===
The timestamp is italicized, always of the form ''HH:MM:SS'' (hours:minutes:seconds). It marks the beginning of a paragraph. It is separated by a line break (<code>Shift + Enter</code>) instead of a paragraph break from the paragraph proper. This can be checked by triple-clicking a paragraph to select it and seeing whether the timestamp is also highlighted as part of the selection.
The timestamp is italicized, always of the form 00:00:00 (hours:minutes:seconds). It marks the beginning of a paragraph. It is separated by a line break (<code>shift+enter</code>) instead of a paragraph break. This can be checked by triple-clicking a paragraph to select it, and seeing whether the timestamp is also highlighted as part of the selection.


=== Speaker Tag ===
=== Speaker Tag ===
The speaker tag is bold, punctuated by a colon, and in-line with the paragraph.
The speaker tag is bold, punctuated by a colon, and in-line with the paragraph.
Only the first of consecutive paragraphs by a speaker should have a speaker tag.
Paragraphs immediately following a heading should have a speaker tag.


== Punctuation ==
== Punctuation ==
Our punctuation rules.


=== Commas ===
=== Commas ===
Use the Oxford comma.  
Use the Oxford comma.  


Place a comma before single and double quotes that begin a new clause.
Comma before single and double quotes that begin a new clause.
 
Certain repeated words should have commas in between them: "No, no, ..." and, "No, no, no, no, ..." for instance.


=== Hyphenation ===
=== Hyphenation ===
Line 62: Line 37:


=== Dashes ===
=== Dashes ===
Em-dash or long dash (—) for interruptions (mid-word or mid-sentence) or abrupt change in a sentence's topic. There is no space after the dash with the exception of starting a new sentence.
Em-dash or long dash (—) for interruptions (mid-word or mid-sentence) or abrupt change in a sentence's topic. No space after the dash.


En-dash (–) multiple names used as an adjective, such as in Teller–Ulam design or Yang–Mills theory.
En-dash multiple names used as an adjective, such as in Teller–Ulam design or Yang–Mills theory.


=== Ellipses ===
=== Ellipses ===
Line 70: Line 45:


=== Quotations ===
=== Quotations ===
Place a comma before single and double quotes that begin a new clause.
Comma before single and double quotes that begin a new clause.


Use double quotes for dialogue or speech, terms or phrases, song titles, and scare quotes. For dialogue and speech, end-punctuation is placed inside the quote. Otherwise it is placed outside or the quote is left unpunctuated.
Double quotes for dialogue or speech, terms or phrases, and scare quotes. For dialogue and speech, end-punctuation is inside the quote. Otherwise it is outside, or there is no punctuation.


Use single quotes for thoughts. If the sentence ends inside of a single quote, end punctuation is placed inside the quote.
Single quotes for thoughts. If it the sentence ends inside a single quote, end punctuation is placed inside the quote.


==== Indirect Quotations ====
==== Indirect Quotations ====
Indirect quotes (no quote marks) are used for hypothetical speech or heavy paraphrasing. Use your own judgment. Place no comma before indirect quotes. Do not capitalize the first word of indirect quotes.
Indirect quotes (no quote marks) when it's hypothetical speech or . Use your own judgment. No comma before indirect quotes. Don't capitalize first word of indirect quotes.
 
==== Spelling and Formatting Inside Quotations ====
If a speaker is directly reading or reciting a written work, it should be spelled and formatted exactly as it was originally written.


== Capitalization ==
== Capitalization ==
Line 86: Line 58:


Capitalize book titles.
Capitalize book titles.
Capitalize song titles.


=== Acronyms ===
=== Acronyms ===
Line 99: Line 69:
Portal terms aren't capitalized: embedded growth obligation, gated institutional narrative, etc.
Portal terms aren't capitalized: embedded growth obligation, gated institutional narrative, etc.


However, Portal terms that are explicitly proper nouns are capitalized: The Portal Podcast, Wokistan, Magastan
However, Portal terms that are explicitly proper nouns are capitalized: The Portal, Wokistan, Magastan


== Italicization ==
== Italicization ==
Line 112: Line 82:


== Mathematics ==
== Mathematics ==
Our glossary for mathematics and physics is in progress. Ask for general guidance in our Discord server.
Math grammar rules here.


=== Typesetting ===
=== Typesetting ===
Typesetting should be done in LaTeX compatible with MathJax.
LaTeX compatible with MathJax.


=== Diagrams ===
=== Diagrams ===
Line 123: Line 93:
When necessary, add a missing, unspoken word to clarify the meaning of a sentence, i.e. [if], [the], etc. [https://theportal.group/18-eric-weinstein-solo-slipping-the-disc-state-of-the-portal-chapter-2020/ "... I have seen no printed discussion of where the supposed trading records of this person <nowiki>[are]</nowiki>, who seemed to amass a fortune."]
When necessary, add a missing, unspoken word to clarify the meaning of a sentence, i.e. [if], [the], etc. [https://theportal.group/18-eric-weinstein-solo-slipping-the-disc-state-of-the-portal-chapter-2020/ "... I have seen no printed discussion of where the supposed trading records of this person <nowiki>[are]</nowiki>, who seemed to amass a fortune."]


If there is an obvious flaw in grammar of something spoken, add [''sic''] after the mistake, i.e. [https://theportal.group/8-andrew-yang-the-different-candidate-the-media-wants-you-to-ignore/ "I didn’t felt <nowiki>[</nowiki>''sic''<nowiki>]</nowiki> ..."]
If there is an obvious flaw in grammar of something spoken, add [''sic''] after the mistake, i.e. [https://theportal.group/8-andrew-yang-the-different-candidate-the-media-wants-you-to-ignore/ "I didn’t felt <nowiki>[sic]<nowiki> ..."]


If something is inaudible or unintelligible, write [Inaudible] or [Unintelligible] where it occurs.
If something is inaudible or unintelligible, write [Inaudible] or [Unintelligible] where it occurs.


== Miscellaneous ==
== Miscellaneous ==
For words that end in "m" extended with -my, add the ending to the existing word without conjugating it. "Spectrum" + "-my" = "Spectrummy"
For words that end in "m" extended with -my, add the ending to the existing word, don't conjugate it. "Spectrum" + "-my" = "Spectrummy"


[[Category:The Portal Transcripts]]
[[Category:The Portal Transcripts]]
[[Category:Guides]]
[[Category:Guides]]
Please note that all contributions to The Portal Wiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see The Portal:Copyrights for details). Do not submit copyrighted work without permission!
Cancel Editing help (opens in new window)

Templates used on this page: