Wikipedia:Manual of Style (text formatting)
From Wikipedia, the free encyclopedia
 |
This guideline is a part of the English Wikipedia's Manual of Style. Use common sense in applying it; it will have occasional exceptions. Please ensure that any edits to this page reflect consensus. |
This is Wikipedia's style manual for text formatting. Use it for guidance on when to apply various formatting techniques, such as bold, italics and underlining. For instructions on how to do that, please see Wikipedia:How to edit a page#Character formatting.
Contents |
[edit] Boldface
Boldface (text like this) is used to separate the article name from ordinary text. It is typically used in the first paragraph of an article, used with proper names and common terms for the article topic, including any synonyms and acronyms. Do this only for the first occurrence of the term.
If the article topic does not have a commonly accepted name, but is merely descriptive (e.g., history of the United States), the title does not need to appear in the first sentence, and is not bolded if it does.
Wikipedia automatically puts headings (section titles) in boldface. Bolded headings, though possible, will appear especially bold, and are not appropriate.
Use italics, not boldface, for emphasis in article text. Use boldface in the remainder of the article only for a few special uses:
- Table headers
- Definition lists (example: Proof)
- Volume numbers of journal articles, in some bibliographic formats
It is technically possible to bold Greek and Cyrillic alphabets, but this should be avoided.
[edit] Italic face
Italic type (text like this) has several uses on Wikipedia.
[edit] Titles
Italics are generally used for proper titles of longer works (books, films, etc.). See Wikipedia:Manual of Style (titles) for specific usage guidelines.
[edit] Words as words
Use italics when writing about words as words, or letters as letters (to indicate the use–mention distinction). This category may also use quotation marks 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.
[edit] 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)." Per the guide to writing better Wikipedia articles, use foreign words sparingly.
Loan words or phrases that have common use in English, however—praetor, Gestapo, samurai, esprit de corps—do not require italicization. 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).
For better accessibility, Latin language quotations should never be set in all-capitals or small capitals, 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}}.
[edit] 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)
[edit] Variables
 |
It has been suggested that this page or section be merged into Manual of Style (dates and numbers) . (Discuss) |
[edit] 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.
[edit] 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.
[edit] When not to use emphasis
The following are proposed guidelines regarding the use of various style devices to show emphasis:
- Italics are used for emphasis, but sparingly.
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 as per 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.
