Transcript Style Guide: Difference between revisions
→Quotations
(→Commas) |
|||
| (18 intermediate revisions by 2 users not shown) | |||
| 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]]. | |||
<!-- | |||
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 == | == General Guidelines == | ||
Our transcripts are in American English. | Our transcripts are in American English. | ||
| Line 13: | Line 18: | ||
[[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. | Disable smart quotes in Preferences (see image on right). | ||
Disable automatic substitutions. | 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. | 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. | ||
== Headings == | == Headings == | ||
| Line 24: | Line 29: | ||
== Paragraphs == | == Paragraphs == | ||
Paragraphs should contain a whole idea. | [[File:ParagraphsExampleImage.png|thumb|right|A labelled example of paragraph formatting.]] | ||
Paragraphs should in general contain a whole idea. | |||
Paragraphs are not indented. | Paragraphs are not indented. | ||
| Line 49: | Line 55: | ||
Place a comma before single and double quotes that begin a new clause. | Place a 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 64: | Line 72: | ||
Place a comma before single and double quotes that begin a new clause. | Place a comma before single and double quotes that begin a new clause. | ||
Use double quotes for dialogue or speech, terms or phrases, and scare quotes. For dialogue and speech, end-punctuation is placed inside the quote. Otherwise it is outside or unpunctuated. | 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. | ||
Use single quotes for thoughts. If | Use single quotes for thoughts. If the sentence ends inside of 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) 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. | ||
==== 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 75: | Line 86: | ||
Capitalize book titles. | Capitalize book titles. | ||
Capitalize song titles. | |||
=== Acronyms === | === Acronyms === | ||
| Line 86: | Line 99: | ||
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, Wokistan, Magastan | However, Portal terms that are explicitly proper nouns are capitalized: The Portal Podcast, Wokistan, Magastan | ||
== Italicization == | == Italicization == | ||
| Line 99: | Line 112: | ||
== Mathematics == | == Mathematics == | ||
Our glossary for mathematics and physics is in progress. Ask for general guidance in our Discord server. | |||
=== Typesetting === | === Typesetting === | ||
LaTeX compatible with MathJax. | Typesetting should be done in LaTeX compatible with MathJax. | ||
=== Diagrams === | === Diagrams === | ||
| Line 110: | Line 123: | ||
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>[sic]</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>[</nowiki>''sic''<nowiki>]</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. | ||