User:Aardvark/TranscriptStyle: Difference between revisions

From The Portal Wiki
(Created page with "Style guide for The Portal Transcripts.")
 
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
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].
 
== Word Processor Configuration ==
* Disable smart quotes
* Disable Substitutions
 
== Spelling Help ==
Search for unknown terms or names, or search for some of the words in their context to find their proper spelling.
 
== Headings ==
Generally, our transcripts will be posted on pages under a level 2 heading, so any subheadings in the transcript should begin at a level 3 heading.
 
== Paragraphs ==
Paragraphs should contain a whole idea.
 
=== Paragraph Breaks ===
Paragraph breaks don't always have to be for total change of topic. The next subtopic in a line of thought can be broken into its own paragraph to help readability. More paragraphs also = more timestamps.
 
=== Timestamp ===
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 (shift+enter) 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 ===
The speaker tag is bold, punctuated by a colon, and in-line with the paragraph.
 
== Punctuation ==
Our punctuation rules.
 
=== Commas ===
Use the Oxford comma.
 
Comma before single and double quotes that begin a new clause.
 
=== Hyphenation ===
Hyphenate certain words.
 
=== Dashes ===
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 in certain
 
=== Ellipses ===
Ellipses can be used in some places instead of dashes, if a speaker is trailing off for instance. Put a space after ellipses. They can be treated as periods or commas for the capitalization of the next word.
 
=== Quotations ===
Comma before single and double quotes that begin a new clause.
 
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.
 
Single quotes for thoughts. If it the sentence ends inside a single quote, end punctuation is placed inside the quote.
 
==== Indirect Quotations ====
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.
 
== Capitalization ==
Capitalize essay titles.
 
Capitalize book titles.
 
=== Acronyms ===
Acronyms are capitalized and unpunctuated: PhD, UK, USA, DISC, etc.
 
Slogans that reduce to acronyms are capitalized, i.e. "Make America Think Harder (MATH)".
 
Name acronyms are capitalized and punctuated: M.C. Escher.
 
=== Portal Terms ===
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
 
 
== Italicization ==
Italicize book titles.
 
Italicize foreign language phrases/terms i.e. sine qua non, unless they're in quotes that aren't dialogue quotes.
 
== Numbers ==
Numbers greater than ten should be written out as numerals. Numbers less than ten can also be written as numerals so long as it's internally consistent within a transcript.
 
Year references like "seventies" and "eighties" should be rendered as '70s, '80s.
 
== Mathematics ==
Math grammar rules here.
 
=== Typesetting ===
LaTeX compatible with MathJax.
 
== Editor's Notes ==
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 [are], 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 [sic] ..."]
 
If something is inaudible or unintelligible, write [inaudible] or [unintelligible] where it occurs.
 
== Miscellaneous ==
For words that end in "m" extended with -my, add the ending to the existing word, don't conjugate it. "Spectrum" + "-my" = "Spectrummy"

Latest revision as of 18:43, 26 April 2021

Style guide for The Portal Transcripts. Link.

Word Processor Configuration[edit]

  • Disable smart quotes
  • Disable Substitutions

Spelling Help[edit]

Search for unknown terms or names, or search for some of the words in their context to find their proper spelling.

Headings[edit]

Generally, our transcripts will be posted on pages under a level 2 heading, so any subheadings in the transcript should begin at a level 3 heading.

Paragraphs[edit]

Paragraphs should contain a whole idea.

Paragraph Breaks[edit]

Paragraph breaks don't always have to be for total change of topic. The next subtopic in a line of thought can be broken into its own paragraph to help readability. More paragraphs also = more timestamps.

Timestamp[edit]

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 (shift+enter) 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[edit]

The speaker tag is bold, punctuated by a colon, and in-line with the paragraph.

Punctuation[edit]

Our punctuation rules.

Commas[edit]

Use the Oxford comma.

Comma before single and double quotes that begin a new clause.

Hyphenation[edit]

Hyphenate certain words.

Dashes[edit]

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 in certain

Ellipses[edit]

Ellipses can be used in some places instead of dashes, if a speaker is trailing off for instance. Put a space after ellipses. They can be treated as periods or commas for the capitalization of the next word.

Quotations[edit]

Comma before single and double quotes that begin a new clause.

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.

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

Indirect Quotations[edit]

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.

Capitalization[edit]

Capitalize essay titles.

Capitalize book titles.

Acronyms[edit]

Acronyms are capitalized and unpunctuated: PhD, UK, USA, DISC, etc.

Slogans that reduce to acronyms are capitalized, i.e. "Make America Think Harder (MATH)".

Name acronyms are capitalized and punctuated: M.C. Escher.

Portal Terms[edit]

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


Italicization[edit]

Italicize book titles.

Italicize foreign language phrases/terms i.e. sine qua non, unless they're in quotes that aren't dialogue quotes.

Numbers[edit]

Numbers greater than ten should be written out as numerals. Numbers less than ten can also be written as numerals so long as it's internally consistent within a transcript.

Year references like "seventies" and "eighties" should be rendered as '70s, '80s.

Mathematics[edit]

Math grammar rules here.

Typesetting[edit]

LaTeX compatible with MathJax.

Editor's Notes[edit]

When necessary, add a missing, unspoken word to clarify the meaning of a sentence, i.e. [if], [the], etc. "... I have seen no printed discussion of where the supposed trading records of this person [are, who seemed to amass a fortune."]

If there is an obvious flaw in grammar of something spoken, add [sic] after the mistake, i.e. "I didn’t felt [sic ..."]

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

Miscellaneous[edit]

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