Wikipedia:Manual of Style/Text formatting

From Wikipedia, the free encyclopedia
< Wikipedia:Manual of Style  (Redirected from MOS:Ety)
Jump to: navigation, search

Boldface[edit]

Shortcuts:

Boldface (text like this) is common in Wikipedia articles, but only for certain usages. It is usually created by surrounding the text to be boldfaced with triple apostrophes: '''...''', but can also be done with the <b>...</b> HTML element.

Article title terms[edit]

The most common use of boldface is to highlight the title word/phrase of the article, and often synonyms, in the lead section. This is done for the majority of articles, but there are exceptions.

Automatically applied cases[edit]

  • The article (or other page) title heading as it appears at the top of the page
  • Titles of sub- and sub-sub-headings (==Sub-heading== and ===Sub-sub-heading=== markup)
  • Table headings and captions (not image captions, for which boldface is not used)
  • Entries in description (a.k.a. definition or association) lists (example: Glossary of the American trucking industry)

Manually added boldface markup in such cases would be redundant and is to be avoided.

Other uses[edit]

Use boldface in the remainder of the article only in a few special cases:

  • To identify terms in the first couple of paragraphs of an article, or at the beginning of a section of an article, which are the targets of redirects to the article or section (e.g. sub-topics of the article's topic, rather than the synonyms as already boldfaced per the above). (See Wikipedia:Redirect § What needs to be done on pages that are targets of redirects? for examples and further details.)
  • Mathematical objects traditionally written in boldface such as vectors and the rational number symbols Q and Z.
  • Volume numbers of journal articles, in some bibliographic formats (particularly when "Volume" or "Vol." are omitted).

Similarly, in the last case, the formatting should generally be added implicitly by use of a template, such as {{citation}}.

Contraindications[edit]

Do not use boldface for emphasis in article text; instead use template {{em}}, or the underlying <em>...</em> HTML markup, which render as italics in most browsers.

It is technically possible to put non-Latin alphabets such as Greek or Cyrillic in boldface, but this should be avoided.

HTML's <strong>...</strong> emphasis, (which usually renders as boldface) is generally not appropriate in article text, though it is common in projectpages, template documentation, talk page discussions, and other non-article contexts, and can also be rendered with the {{strong}} template.

Italic type[edit]

Shortcuts:

Names and titles[edit]

For complete guidance on the handling of titles of works, see (until the material is better consolidated):

Italic type (text like this) should be used for the following types of names and titles, or abbreviations thereof:

  • Major works of art and artifice, such as albums, books, video games, films, musical, operas, symphonies, paintings, sculptures, newspapers, journals, magazines, epic poems, plays, television programs, radio shows. Medium of publication or presentation is not a factor; a video feature only released on video tape, disc or the Internet is considered a "film" for these purposes, and so on. (See WP:Manual of Style/Titles § Italics for details.)

Minor works (and any specifically-titled subdivisions of italicized major works) are given in quotation marks. (See § When not to use italics, below, for details.)

These cases are well-established conventions recognized in most style guides. Do not apply italics to other categories or instances because you feel they are creative or artful (e.g. game or sport moves, logical arguments, "artisanal" products, schools of practice or thought, etc.).

  • Named, specific vessels
    • Ships, with ship prefixes, classification symbols, pennant numbers, and types in normal font: USS Baltimore (CA-68). However, italicize ship names when they appear in the names of classes of ships (the Baltimore-class cruisers). (See Wikipedia:Naming conventions (ships) for more detail on ship and ship class titles.)
    • Spacecraft (often fictional): the Space Shuttle Challenger, USS Enterprise NC-1701, Constitution-class starships
    • Trains and locomotives

The vessels convention does not apply to smaller conveyances such as cars, trucks, and buses.

Use piped linking to properly italicize in wikilinks: "USS Baltimore (CA-68), the lead ship of the Baltimore-class cruisers", is produced by [[USS Baltimore (CA-68)|USS ''Baltimore'' (CA-68)]], the lead ship of the [[Baltimore-class cruiser|''Baltimore''-class cruiser]]s

Emphasis[edit]

Shortcut:

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 emphasis by rewriting a sentence more explicitly. Use of emphasis more than once in a sentence is rarely helpful to readers, unless the emphasized terms are being directly compared.

Words as words[edit]

Shortcuts:

Use italics when writing about words as words, or letters as letters (to indicate the use–mention distinction). Examples:

  • Deuce means "two".
  • The term panning is derived from panorama, which was coined in 1787.
  • The most common letter in English is e.

When italics could cause confusion, quotation marks instead may be used to distinguish words as words. Use one style or the other in a given context; do not apply both styles at once to the same terms, or switch back and forth between the styles in the same material.

A technical term being introduced is often being mentioned as a word rather than (or in addition to) playing its normal grammatical role; if so, it should be italicized or quoted. The first occurrence of a technical term may be both italicized (or quoted) and linked if the term also has its own article (or section) corresponding exactly to the meaning when used in the present article.

Italics may also be used where <dfn> tags or {{dfn}} templates mark a term's first use, definition, introduction, or distinguished meaning on the page. Note that <dfn> tags and {{dfn}} templates do not apply text formatting, so the italicization (or quoting) must be added if intended. 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...

If, however, a term is strictly synonymous with the subject of the article (i.e. the likely target of a redirect), then boldface should be used in place of italics or quotation marks at such a first occurrence.

'''<dfn>text</dfn>'''text

Foreign terms[edit]

See also: MOS:FOREIGN

Wikipedia prefers italics for phrases in other languages and for isolated foreign words that do not yet have everyday use in non-specialized 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), and 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 normal upright font. 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 a term in a non-Latin script, it can be placed in parentheses. Text in non-Latin scripts (such as Greek, Cyrillic or Chinese) 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 quotations should not be set in all caps or small caps. When reproduced for their content, inscriptions that were originally all caps should be transcribed according to standard rules of English capitalization. Please note, however, that simply undoing caps may result in incorrect orthography; for example, capital V may represent either the consonant v or the vowel u. Editors should be cautious about making their own interpretations when transcribing epigraphic and numismatic sources. Particularly on coins, a character that appears to be a letter may instead be a Roman numeral, a denomination, or a symbol. For articles that reproduce examples of epigraphy or coin legends, editors should consult the orthography of expert secondary sources (see also diplomatic transcription).

Scientific names[edit]

Scientific names of organisms are formatted according to normal taxonomic nomenclature.

  • Do not italicize (but do capitalize) taxa higher than genus.
  • Italicize all lower ranks (taxa): genus (capitalized), subgenus (capitalized), species, subspecies.
    • Names of genera are always italicized (and capitalized), even when not paired with a species name: Allosaurus, Falco, Anas.
    • The entire binomial or trinomial scientific name is italicized, whether given in full or abbreviated: (Liriodendron tulipifera, N. v. piaropicola).
  • Interpolations such as "cf." or "×" are not italicized: Ninox cf. novaeseelandiae, the chaussie is a hybrid cat (Felis catus × F. chaus).
  • Parenthetic expressions should not be italicized unless part of the scientific name, as in the case of a subgenus, which is always italicized, though the parentheses (round brackets) are not: Potentilla (Sibbaldiopsis) tridentata.
  • Do not italicize author names juxtaposed with scientific names: Subgenus Potentilla Syme and subgenus Hypargyrium (Fourr.) Juz. have been combined under subgenus Potentilla Syme.

Derived uses in non-biological contexts are not italicized: The largest carnivore in family Tyrannosauridae was T. rex itself, but Unicorn was an album by the band T. Rex.

Although derived from Latin (and often Ancient Greek), scientific names are never marked up with {{lang}} or related templates.

Quotations[edit]

Further information: WP:MOSQUOTE
Shortcut:

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[edit]

Program variables[edit]

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[edit]

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'' = ''mc''<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 {{mvar}} 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[edit]

Shortcuts:

One-line notes that are placed at the top of articles or sections (most often to assist disambiguation or provide cross-references) 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 to distinguish them from the text of the article proper. The Disambiguation and redirection templates and Wikipedia page-section templates automatically provide 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 (round brackets). For example:

At this time France possessed the largest population in Europe (see Demographics of France).

Here, the cross-referenced article does not topically make a good target for a running-text link from the phrase "largest population in Europe", or any other text in the sentence, but has been deemed relevant enough to mention in passing without relegating it to the "See also" section at the bottom of the article. In any case where a such a link in running text would be proper, it is preferred over a parenthetical, explicit cross-reference.

Like hatnotes, these parenthetical cross-references are italicized in their entirety, as Wikipedia self-references and not part of the article content proper. Unlike some traditional reference works, the convention that has evolved on Wikipedia is not to individually italicize "see" or "see also". Wikipedia's own article titles are not put in quotation marks in such cross-references.

In the rare case of a cross-namespace links or some other form of Wikipedia self-reference that would normally be avoided, wrap the cross-reference in the {{selfref}} template (which auto-italicizes); it will prevent that text from appearing in printed versions and on other sites that re-use Wikipedia content.

When not to use italics[edit]

Shortcut:

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. These include but are not limited to: Articles, essays, papers, chapters, reference work entries, newspaper and magazine sections or departments, episodes of audio-visual series, segments or skits in longer programs, short poems, short stories, story lines and plot arcs; songs, album tracks and other short musical works; leaflets and circulars. (See WP:Manual of Style/Titles § Quotation marks for details.)

Other cases

How not to apply emphasis[edit]

Shortcuts:

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.
  • Avoid using ALL CAPS and small caps for emphasis; see WP:Manual of Style/Capital letters §thinsp;All caps. Italics are usually more appropriate.
  • 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[edit]

Font size[edit]

Shortcuts:

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.

The use of reduced font sizes should be used sparingly. Avoid using smaller font sizes in elements that already use a smaller font size, such as infoboxes, navboxes and reference sections. In no case should the resulting font size drop below 85% of the page fontsize (or 11px).

Color[edit]

In prose[edit]

Prose text should never be manually colored. Links should clearly be identifiable as a link to our readers. Further information can be found at Wikipedia:Accessibility#Color.

In navboxes[edit]

Shortcuts:
  1. Keeping in line with Wikipedia:Manual of Style/Accessibility#Color, colors used in navboxes should not make navigating difficult for colorblind or visually impaired readers.
  2. Colors that are useful for identification and are appropriate, representative, and accessible may be used with discretion and common sense. In general, text color should not be anything other than black or white (excluding the standard colors of hyperlinks), and background colors should contrast the text color enough to make the template easily readable.
  3. An "appropriate, representative" color, when intended to identify with an organization's logo or branding, should use the most prominent accessible color in the logo. For example, Template:Pink Panther should be using a background of F6D4E6 (the color of the body in File:Pink Panther.png) rather than E466A9 (the color of the background in that image). A representative color may also be the one present in an article's infobox (if included). For example the navbox associated with National Register of Historic Places and other related categorizations should conform to Wikipedia's NRHP colors legend.
  4. In the case that no properly identifying, accessible color exists; or the subject of the navbox should not be identified with a particular color (e.g. an average biography), the default navbox color should be used.
  5. If an article includes several navboxes whose colors conflict with each other, discretion should be used to minimize the disruption by using the default colors for navboxes.

Font family[edit]

Shortcuts:

Font families should not be explicitly defined in an article, with the exception of PUA characters (next section). 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. Certain definitions can be invoked by using special templates, see Help:Special characters, {{Unicode}} or {{IPA}}.

Private Use Area and invisible formatting characters[edit]

The only invisible characters in the editable text should be spaces and tabs. However, other invisible characters are often inserted inadvertently by pasting from a word processor. These can cause confusion with editors and handling problems with editing software. Any necessary invisible or Private Use Area (PUA) characters should be substituted with their (hexa)decimal code values (that is, as &#...;) so that they can be edited properly. A template, {{PUA}}, is used to mark PUA characters; it has no effect on the text, but places the article in a tracking category. See the next sections for examples.

Mixed right-to-left text[edit]

Shortcuts:

When right-to-left text is embedded in certain left-to-right contexts, such as when tagged with a reference, it may require control characters to display properly. The marker to return to left-to-right text should be encoded as &lrm; or supplied through the template {{Rtl-lang}}.

Compare the display of unformatted Urdu

خ ?<ref>(note)</ref>:   خ ?[1]

with formatted

خ&lrm; ?<ref>(note)</ref>:   خ‎ ?[1] or {{Rtl-lang|ur|خ}} ?<ref>(note)</ref>:   خ‎ ?[1]

and unformatted

(خ)<ref>(note)</ref>:   (خ)[1]

with formatted

(خ)&lrm;<ref>(note)</ref>:   (خ)‎[1] or {{Rtl-lang|ur|(خ)}}<ref>(note)</ref>:   (خ)[1].

If there is intervening LTR text, as in خ abc[1], a control character is not required. Spacing and most punctuation, however, are not defined as either LTR or RTL, so the direction of the text needs to be reset manually.

PUA characters[edit]

Shortcut:

Private Use Area (PUA) characters are in three ranges of code points (U+E000U+F8FF in the BMP, and in planes 15 and 16). PUA characters should normally be avoided, but they are sometimes used when they are found in common fonts, especially when the character itself is the topic of discussion.

Where PUA characters cannot be replaced with non-PUA Unicode characters, they should be converted to their (hexa)decimal code values (that is, &#...; or &#x...;). However, whenever a PUA character has a Unicode equivalent, it should instead be replaced with that equivalent (Unicodified). The Unicode may be obvious when text is copied and pasted from a document that uses the PUA for bullets or similar characters in Latin text, but similar things happen with punctuation and emoticons in documents using Japanese and other scripts, so an editor familiar with those scripts may be needed. In Chinese documents it's not uncommon for the PUA to be used for characters that now have full Unicode support, due to poorer support for Chinese characters when those fonts were designed. Such PUA characters, which are sometimes found on Wikipedia in references and footnotes, should not be substituted with their (hexa)decimal values, as that will lock in the illegible character. If you're moderately familiar with the script, an internet search of the surrounding text will often locate a fully Unicode version of the text which can be used to correct the Wikipedia article.

Because browsers do not know which fonts to use for PUA characters, it is necessary for Wikipedia to specify them. {{Unicode}} or {{IPA}} formatting is sufficient in some cases. Otherwise the fonts should be specified through html markup, as in the example below. Note that if a font is not specified, or if none of the fonts are installed, readers will only see a numbered box in place of the PUA character.

Tagging a (hexa)decimal code with the template {{PUA}} will enable future editors to review the page, and to Unicodify the character if it is included in future expansions of Unicode. This happened, for example, at strident vowel, where a non-Unicode symbol for the sound was used in the literature and added to the PUA of SIL's IPA fonts. Unicode didn't support it until several years after the Wikipedia article was written, and once the fonts were updated to support it, the PUA character in the article was replaced with its new Unicode value.

For example,

SIL added these letters at U+F267 and U+F268: <span style="font-family:Gentium Plus, Charis SIL, Doulos SIL, serif">{{PUA|&#xf267;}}, {{PUA|&#xf268;}}</span>.

which renders as:

SIL added these letters at U+F267 and U+F268: , .

See Category:Articles with wanted PUA characters and especially Tengwar#Unicode for examples of PUA characters which cannot easily be replaced.

See also[edit]

References[edit]

  1. ^ a b c d e f g (note)