Wikipedia:Manual of Style/Text formatting: Difference between revisions
→How not to apply emphasis: add shortcut |
→Emphasis: Add note about accessibility. |
||
| Line 66: | Line 66: | ||
=== Emphasis === |
=== Emphasis === |
||
The use of italics for emphasis on Wikipedia should follow good English print style. Italics may be used to draw attention to an important word or phrase within a sentence when the point or thrust of the sentence may otherwise not be apparent to readers, or to stress a contrast: |
The use of italics for emphasis on Wikipedia should follow good English print style. The most [[WP:ACCESS|accessible]] way to indicate emphasis is with [[HTML]] <code><nowiki><em></nowiki></code> tags or by enclosing the emphasized text within an {{tl|em}} template. |
||
Italics may be used to draw attention to an important word or phrase within a sentence when the point or thrust of the sentence may otherwise not be apparent to readers, or to stress a contrast: |
|||
:Gellner accepts that knowledge must be knowledge |
:Gellner accepts that knowledge must be knowledge {{em|of}} something; and that {{em|some}} philosophical theories {{em|may}} arise from linguistic confusion. |
||
It may be preferable to avoid the need for italics by rewriting a sentence more explicitly. |
It may be preferable to avoid the need for italics by rewriting a sentence more explicitly. |
||
| Line 74: | Line 75: | ||
Italics may also be used where, in the course of using a term in an article, that term is being defined, introduced or distinguished in meaning. For instance, in the [[consciousness]] article: |
Italics may also be used where, in the course of using a term in an article, that term is being defined, introduced or distinguished in meaning. For instance, in the [[consciousness]] article: |
||
:''Access consciousness'' is the phenomenon whereby information in our minds is accessible for verbal report and reasoning. |
:''<dfn>Access consciousness</dfn>'' is the phenomenon whereby information in our minds is accessible for verbal report and reasoning. |
||
If, however, a term is strictly synonymous with the subject of the article, then [[#Boldface|bold face]] should be used in place of italics. The first occurrence of a technical term may be both linked and italicised if the term also has its own article (or section) corresponding exactly to the meaning when used in the present article. A term being introduced is often [[#Words as words|mentioned as a word (see below)]] rather than playing its normal grammatical role; if so, it should be italicised or quoted, but not both. |
If, however, a term is strictly synonymous with the subject of the article, then [[#Boldface|bold face]] should be used in place of italics. The first occurrence of a technical term may be both linked and italicised if the term also has its own article (or section) corresponding exactly to the meaning when used in the present article. A term being introduced is often [[#Words as words|mentioned as a word (see below)]] rather than playing its normal grammatical role; if so, it should be italicised or quoted, but not both. |
||
Revision as of 10:03, 20 May 2011
 | This guideline is a part of the English Wikipedia's Manual of Style. It is a generally accepted standard that editors should attempt to follow, though occasional exceptions may apply. Any substantive edit to this page should reflect consensus. When in doubt, discuss first on the talk page. |
 | This page in a nutshell: This page provides guidance on when to format text in articles. For instructions on how to do that, see Help:Wiki markup#Format. |
| Manual of Style (MoS) |
|---|
Boldface
Boldface (text like this) is common in Wikipedia articles, but only for certain usages.
Article title terms
The most common use of boldface is to highlight the article title, and often synonyms, in the lead section (first paragraph). This is done for the majority of articles, but there are exceptions. See Lead section – Format of the first sentence for in-depth coverage.
Other uses
Use boldface in the remainder of the article only in a few special cases:
- Table headers and captions
- Definition lists (example: Glossary of trucking industry terms in the United States)
- Volume numbers of journal articles, in some bibliographic formats
In the first two cases, the appropriate markup automatically adds the boldface formatting; do not use the explicit triple-apostrophe markup. Similarly, in the third case, the formatting should generally be added implicitly by use of a template, such as {{citation}}.
Contraindications
Use italics, not boldface, for emphasis in article text.
It is technically possible to bold Greek and Cyrillic alphabets, but this should be avoided.
Wikipedia automatically puts headings (section titles) in boldface. Bolded headings, though technically possible, will appear especially bold, and are not appropriate.
Italic face
Italic type (text like this) has several uses on Wikipedia.
- Certain scientific names
- Court cases
- Named vehicles
- Trains and locomotives
- Ships
- Ship classes
- Works of art and artifice
- Art exhibitions
- Books
- Cantatas and motets
- Comic strips and webcomics
- Computer and video games (but not other software)
- Films (including short films) and documentaries
- Long or epic poems
- Musical albums
- Musicals
- Operas, operettas, oratorios
- Orchestral works, but only 'true titles' (e.g. Symphonie fantastique), not generic titles (e.g. Piano Concerto No. 5).
- Paintings, sculptures and other works of visual art
- Periodicals (newspapers, journals, and magazines)
- Plays
- Television shows, series and serials (individual episodes should appear in quotes)
Abbreviations of the above should also be italicized.
Website titles may or may not be italicized depending on the type of site and what kind of content it features. Online magazines, newspapers, and news sites with original content should generally be italicized (such as Salon.com or The Huffington Post). Online encyclopedias and dictionaries (like Wikipedia or Urban Dictionary) should also be italicized. Other types of websites should be decided on a case-by-case basis. (This is under discussion- see the talk page.)
Emphasis
The use of italics for emphasis on Wikipedia should follow good English print style. The most accessible way to indicate emphasis is with HTML <em> tags or by enclosing the emphasized text within an {{em}} template.
Italics may be used to draw attention to an important word or phrase within a sentence when the point or thrust of the sentence may otherwise not be apparent to readers, or to stress a contrast:
- Gellner accepts that knowledge must be knowledge of something; and that some philosophical theories may arise from linguistic confusion.
It may be preferable to avoid the need for italics by rewriting a sentence more explicitly.
Italics may also be used where, in the course of using a term in an article, that term is being defined, introduced or distinguished in meaning. For instance, in the consciousness article:
- Access consciousness is the phenomenon whereby information in our minds is accessible for verbal report and reasoning.
If, however, a term is strictly synonymous with the subject of the article, then bold face should be used in place of italics. The first occurrence of a technical term may be both linked and italicised if the term also has its own article (or section) corresponding exactly to the meaning when used in the present article. A term being introduced is often mentioned as a word (see below) rather than playing its normal grammatical role; if so, it should be italicised or quoted, but not both.
Words as words
Use italics when writing about words as words, or letters as letters (to indicate the use–mention distinction). When italics would cause confusion, quotation marks may be used to distinguish words as words. For example:
- Deuce means "two".
- The term panning is derived from panorama, which was coined in 1787.
- The most common letter in English is e.
Foreign terms
Wikipedia prefers italics for phrases in other languages and for isolated foreign words that do not yet have everyday use in non-specialised English. Use the native spellings if they use the Latin alphabet (with or without diacritics)—otherwise Anglicise their spelling. For example: "Gustav I of Sweden liked to breakfast on crisp bread (knäckebröd) open sandwiches with toppings such as messmör (butter made from goat's milk), ham (skinka), vegetables (grönsaker) like tomatoes (tomat) or cucumber (gurka)." In accordance with the guide to writing better Wikipedia articles, use foreign words sparingly.
Loanwords or phrases that have common use in English, however—praetor, Gestapo, samurai, esprit de corps, e.g., i.e.—do not require italicization. Likewise musical movement titles, tempo markings, or terms like minuet and trio, are in roman type. If looking for a good rule of thumb, do not italicize words that appear in Merriam-Webster Online.
If there is a reason to include native spelling in a non-Latin script, it can be placed in parentheses. Text in non-Latin scripts (such as Greek or Cyrillic) should not be italicized at all—even where this is technically feasible; the difference of script suffices to distinguish it on the page.
A proper name is usually not italicized when it is used, but it may be italicized when the name itself is being referred to (see Words as words).
Scientific names of organisms are formatted according to normal nomenclature, with genus and species (and subgenus and subspecies if applicable) in italics (see the main section). For example: "The largest carnivore in family Tyrannosauridae was T. rex itself" but "Unicorn was an album by the band T. Rex".
For better accessibility, Latin quotations should never be set in all caps or small caps, even when such use might seem anachronistic.
- See also Template:Lang/doc for marking passages in a foreign language with
{{lang|xx}}and{{lang-xx}}.
Quotations
It is normally incorrect to put quotations in italics. They should only be used if the material would otherwise call for italics, such as for emphasis or to indicate use of non-English words. Indicate whether italics were used in the original text or whether they were added later. For example:
- Now cracks a noble heart. Good night sweet prince: And flights of angels sing thee to thy rest!
- (emphasis added)
Variables
Program variables
Variables in computer programs and symbols for program variables within plain-English prose and in computer source code presented as textual content can be marked up with the <var> element, or its wikimarkup equivalent, the {{var}} template:
...where <var>x</var> is incremented on each pass... ⇒ ...where x is incremented on each pass...|id={{var|ISBN or other identifier}} ⇒ |id=ISBN or other identifier
This provides richer semantic markup over simple italicization (or no formatting at all), that can aid in searching, accessibility, and disambiguation between variables and literal values.
Mathematics variables
Symbols for mathematics variables, either used within mathematical formulas or used in isolation, are simply italicized:
The value of ''y'' when ''x'' = 3 ⇒ The value of y when x = 3''E'' = ''m''c<sup>2</sup> ⇒ E = mc2
Some things remain in upright form regardless of the surrounding text
- Bold-face variables (such as vectors), and structures (such as Q, the rational numbers)
- Letters with an arrow on top for vectors
- Symbols for chemical elements and compounds such as HCl
- Symbols for units of measure such as kg, ft/s
- Symbols for mathematical operators such as sin and ln
- sin x, ln (p/p0)
The template {{varserif}} is available to distinguish between I (upper-case i) and l (lower-case L) as variables, which look almost identical in most sans-serif fonts, including the default typefaces of many browsers.
Uses of italics that are specific to Wikipedia
One-line notes that are placed at the top of articles or sections to assist disambiguation are hatnotes. One-line notes may also be placed at the top of sections to cross-reference or point to additional information that is not directly linked in the text. Both of these are in italics and indented, in order to distinguish them from the text of the article proper. Using the correct Disambiguation and redirection templates or Wikipedia page-section templates automatically provides the required italic formatting.
Special section headings for appendices such as ==See also== are not in italics.
A further type of cross-reference may occur within a paragraph of text, usually in parentheses. For example:
- At this time France possessed the largest population in Europe (see Demographics of France).
Unlike many traditional reference works, the convention on Wikipedia that has evolved is that "see" or "see also" are not in italics. Nor are the article titles put in quotation marks.
When not to use italics
Italics are generally used only for titles of longer works. Titles of shorter works should be enclosed in double quotation marks ("text like this"). This particularly applies to works that exist as a smaller part of a larger work. Examples of titles which are quoted:
- Articles, essays or papers
- Chapters of a longer work
- Entries in a longer work (dictionary, encyclopedia, etc.)
- Single episodes of a television series
- Short poems
- Short stories
- Arias, musical numbers, songs and 'singles'
How not to apply emphasis
Avoid various kinds of overemphasis, which distracts from the writing:
- Exclamation points (!) should usually only be used in direct quotes.
- Bold type is reserved for certain uses (see boldface, above).
- Quotation marks for emphasis of a single word or phrase, or scare quotes, are discouraged. Quotation marks are to show that you are using the correct word as quoted from the original source. For example: His tombstone was inscribed with the name "Aaron" instead of the spelling he used during his life.
- ALL CAPS and small caps formatting should be changed to title case, in which each significant word is capitalized. "WAR BEGINS TODAY" should be reduced to "War Begins Today". This has become the standard for The New York Times in its transcription project. The same rule applies to book and magazine titles pursuant to Wikipedia:Manual of Style (capital letters)#All caps.
- Double emphasis, such as "italics in quotation marks" or italics and an exclamation point!, is unnecessary.
- Underlining is used in typewriting and handwriting to represent italic type. Generally, do not underline text or it may be confused with links on a web page.
Other text formatting concerns
Font size
Editors should avoid manually inserting large and small fonts into prose. Increased and decreased font size should primarily be produced through automated facilities such as headings or through carefully designed templates. Additionally, large tables may require a decreased font size in order to fit on screen.
When it is necessary to specify an increased or decreased font size, the specification should be done as a percentage of the original font size and not as an absolute size. This improves accessibility for visually impaired users who use a large default font size.
Color
Prose text should never be manually colored. Further information can be found at Wikipedia:Accessibility#Color.
Font family
Font families should not be explicitly defined in the CSS of an article. On one hand, this interferes with Wikipedia's flexibility. On the other hand, it is impossible to foresee what fonts will be installed on a user's computer.
Articles used to explicitly define font families for special characters, because older browsers could not automatically select an appropriate font. This is no longer dealt with by using explicit font definitions in the articles. Instead, the font definitions have been moved to MediaWiki:Common.css/WinFixes.css. These definitions are invoked by using special templates, see Help:Special characters, {{unicode}} or {{IPA}}.
See also