User:Aardvark/TranscriptStyle: Difference between revisions

From The Portal Wiki
No edit summary
No edit summary
Line 6: Line 6:


== Headings ==
== 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 ==
Line 20: Line 21:


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


=== Commas ===
=== Commas ===

Revision as of 18:30, 26 April 2021

Style guide for The Portal Transcripts. Link.

Word Processor Configuration

  • Disable smart quotes
  • Disable Substitutions

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.

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

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.

Indirect Quotations

No capitalization and no preceding comma.

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.

Hyphenation

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.

Editor's Notes

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 ..."]

Miscellaneous

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