Wikipedia:Manual of Style (disambiguation pages)
From Wikipedia, the free encyclopedia
 |
This guideline is a part of the English Wikipedia's Manual of Style. Editors should follow it, except where common sense and the occasional exception will improve an article. Before editing this page, please make sure that your revision reflects consensus. |
Disambiguation pages ("dab pages") are, like redirects, non-article pages in the article namespace. Disambiguation pages are solely intended to allow users to choose among several Wikipedia articles, usually when a user searches for an ambiguous term.
This style guideline is intended to make this process more efficient by giving disambiguation pages a consistent look and avoiding distracting information, such as extraneous links (internal or external). It applies to pages containing only disambiguation content, whether or not the page title contains the word "(disambiguation)". This guide does not apply to articles which are about a primary topic, even if they contain a "see also" notice or the like.
| Style and formatting |
|---|
| Manual of Style and its subpages |
|
Abbreviations |
| Related policies and guidelines |
| Other advice, including essays and proposals |
| Related to specific cultures |
|
Arabic-related articles |
| Disambiguation |
|---|
| Guideline Style guide WikiProject CJKV taskforce Suggestions Template Category |
Contents |
[edit] Page naming conventions
- Covered at Wikipedia:Disambiguation.
[edit] Linking to Wiktionary
Rather than including a dictionary definition of a word, create a cross-link to our sister project, Wiktionary. To do this, use one of the Wiktionary link templates on the first line. The multiple-option templates are useful if you want to link to dictionary entries with alternate capitalizations (star, Star, and STAR, for example).
- {{Wiktionarypar}} - {{wiktionarypar|WORD}}
- {{Wiktionarypar}} - {{wiktionarypar|WORD|WORD2|...|WORD5}} (up to five optional parameters)
- {{Wiktionary}} - {{wiktionary|WORD|optional display name}}
- Without parameters, {{wiktionary}} defaults to using the current page's name. Important: Check the link when using this method, as Wiktionary uses proper capitalization for its entries, unlike Wikipedia's uppercased first letter or page name.
Note: Wiktionary is case-sensitive on the first letter. For more information on linking see Wikipedia:Sister projects#Wiktionary.
[edit] Linking to a primary topic
When a page has "(disambiguation)" in the title, users are unlikely to stumble on it by accident. They will arrive there by clicking on a link from the primary topic article, by searching, or by directly typing its URL.
The link on the main article should be similar to:
- For other uses, see School (disambiguation).
The {{otheruses}} template series can be used.
Since it is unlikely that this well-known meaning is what they are looking for if they've visited the disambiguation page, it should not be mixed in with the other links. It is recommended to place the link back to the primary topic at the top, like this:
-
A school is an institution for learning.
School may also refer to:
- School (discipline), a group of people with common characteristics in what they do, e.g. a school of painting, or a school of thought
- "School" (song), by the grunge music group Nirvana
- School (band), a band from Konami's Pop'n Music series
- A swarm of fish
[edit] Introductory line
Like a standard article, the title of the page should be in bold (not italic). It should begin a sentence fragment ending with a colon, introducing a bulleted list:
-
Interval may refer to:
John Smith is the name of:
ABC may stand for:
It is not necessary to repeat all variations of capitalization, punctuation or spelling: "AU may refer to" is preferable to "AU, au, Au or A-U may refer to"; and "Saiyuki may refer to" is preferable to "Saiyuki, Saiyūki, Saiyûki, or Saiyuuki may refer to".
[edit] Individual entries
Keep in mind that the primary purpose of the disambiguation page is to help people find the information they want quickly and easily. These pages are not for exploration, but only to help the user navigate to a specific article.
- Preface each entry with a bullet (an asterisk in wiki markup). Only entries that link, not leading lines, should have bullet points.
- Each bulleted entry should, in almost every case, have exactly one navigable (blue) link. To avoid confusing the reader, do not wikilink any other words in the line. For example:
- "Dark Star" (song), a song by the Grateful Dead
- not: "Dark Star" (song), a song by the psychedelic rock band The Grateful Dead
- Including no links at all makes the entry useless for further navigation. (See "red links" below for cases where no article yet exists.) Never link days or dates.
- The link should be the first word or phrase in each entry. For example:
- Neapolitan chord, in music theory, a major chord built on the lowered second scale degree
- not: In music theory, a Neapolitan chord is a major chord built on the lowered second scale degree
- but: see Red links and URL anchor notation below when the entry's subject does not have an article of its own.
- Start with a capital letter unless the target article is marked with {{lowercase}}.
- The link should not be emphasized with bolding or italics, although titles (such as for books and movies) may need to be italicized, in conformance with Wikipedia:Manual of Style (titles). If the article's title contains both a title and a clarifier, use a piped link to quote or italicize only the title (see below).
- Entries should nearly always be sentence fragments. Even when the entry forms a complete sentence, do not include commas or periods at the end of the line.
- The description associated with a link should be kept to a minimum, just sufficient to allow the reader to find the correct link.
- Never include external links, either as entries or in descriptions. Disambiguation pages disambiguate Wikipedia articles, not the World-Wide Web. To note URLs that might be helpful in the future, include them as <!-- comments --> or on a talk page.
- Entries should not be pipe linked — refer to the article name in full. See below for several exceptions to this rule.
Example:
-
Interval may refer to: - Interval (mathematics), a certain subset of an ordered set
- Interval (music), the relationship between two notes
[edit] Examples of individual entries that should not be created
On a page called Title, do not create entries merely because Title is part of the name (see Wikipedia:Disambiguation#Lists).
Common examples:
- Title County
- Title City
- Title Hospital
- Title University
These may require their own disambiguation pages. For example, Jefferson County (disambiguation) should list the counties in all the states, but Jefferson (disambiguation) ideally would not. Instead, it should link to the Jefferson County disambiguation page.
The above does not apply if the subject is commonly referred to simply by Title. E.g., Oxford (disambiguation) should link Oxford University and Catalina might include Santa Catalina Island, California. If there is disagreement about whether this exception applies, it is often best to assume that it does.
You may want to create entries on the same page for:
- TITLE and Title
- Title town and Title township
- An example is "Willow Valley", which lists a town of that name as well as "Willow Valley Township" in another state.
[edit] Given names or surnames
- See also: Wikipedia:WikiProject Anthroponymy
- Title Smith
- Title Lee
- John Title
- Jane Title
Persons who happen to have the same surname or given name should not be mixed in with the other links unless they are very frequently referred to simply by the single name (e.g., Elvis, Shakespeare). For short lists of such persons, new sections of Persons with the surname Title and Persons with the given name Title can be added below the main disambiguation list. For longer lists, create a new Title (name), Title (surname) and/or Title (given name) page.
Pages only listing persons with certain given names or surnames who are not widely known by these parts of their name otherwise are not disambiguation pages, and this Manual of Style does not apply. In such cases, do not use {{disambig}} or {{hndis}}, but {{given name}} or {{surname}} instead.
[edit] Misspellings
Common misspellings should only be listed if there is a genuine risk of confusion or misspelling. These cross-links should be placed in a separate section entitled "Common misspellings" or "See also". For example, in a page called Kington (disambiguation), a link to Kingston (disambiguation) would appropriately be included in the See also section.
[edit] Piping
Piping means concealing the actual title of a linked article by replacing it with other text, typically to suppress parenthetical expressions.
Do not pipe the name of the links to the articles being listed. For example, in the entry for Moment (physics), the word "physics" should be visible to the reader. In many cases, what would be hidden by a pipe is exactly what the user would need to be able to find the intended article.
Exceptions:
- Use piping if you are linking to an anchor point on the target page.
- Use piping if the article title differs from what it should be due to technical limitations per {{Wrongtitle}}; for instance The Singles 81>85 or Softimage|XSI.
- Use piping to add italics or quotation marks to part of an article name; for instance Harvey (film), USS Adder (SS-3), "School" (song), Saturnalia (dinosaur), "Hush" (Buffy episode), Neo (The Matrix).
If a word in the description is linked (an unusual occurrence), you may use piping in that link.
Example:
-
Rock or rocks may refer to: - Rock, the name of [[Mega Man (character)|Mega Man]] in the Japanese versions of the games
This guidance to avoid piping means that a link to a redirect term will sometimes be preferred to a direct link, if the redirect term contains the disambiguation title and the redirect target does not. For example, in Delta (disambiguation), a link to the redirect term Delta Quadrant would be preferred over its target, Galactic quadrant.
[edit] Specific entry types
[edit] Foreign languages
For foreign-language terms, be sure an article exists or could be written for the word or phrase in question. Usually this means that the term has been at least partially adopted into English or is used by specialists.
-
Tambo may refer to: - Tambo (weapon), a very short staff used in martial arts
Avoid adding lines for words or phrases that are simply spelled the same as an English term. For example:
- not: Tambo, a Japanese word (田んぼ) for rice paddy
[edit] People
For people, include their birth and death years (when known), and only enough descriptive information that the reader can distinguish between different people with the same name. Keep in mind the conventions for birth and death dates, see Wikipedia:Manual of Style (dates and numbers)#Dates of birth and death. Do not include a, an or the before the description of the person's occupation or role.
-
John Smith is the name of: - John Smith (filmmaker) (born 1952), London-based avant-garde filmmaker
- John Smith (mathematician) (18th century), mathematician at the University of Oxford, 1766–1797
- John Smith (Ohio Senator) (1735–1824)
[edit] Places
For places, it may only be necessary to write the name of the article.
-
Jacksonville may refer to:
It might be appropriate to add the country after the link. Leave the country unlinked.
-
Kimberley is the name of: - Kimberley, Nottinghamshire, England
- Kimberley, British Columbia, Canada
[edit] Red links
A link to a non-existent article (a "red link") should only be included on a disambiguation page when another article also includes that red link. There is no need to brainstorm all occurrences of the page title and create red links to articles that are unlikely ever to be written, or likely to be removed as insufficiently notable topics.
If the only thing that uses the red link is the disambiguation page, unlink the "entry word" but still keep a blue link in the description. Use "Show preview" to see the entry with the red link, click through it, and use "What links here" to see if any other articles use the red link. See Help:What links here for more information.
Red links should not be the only link in a given entry; link also to an existing article, so that a reader (as opposed to a contributing editor) will have somewhere to navigate to for additional information. A (contrived) example:
-
Flibbygibby may refer to:
In this example, the architectural motif is judged to be appropriate for a future article, but the noodle is not.
[edit] Synonyms
If the link is to a synonym, simply use it as it is named:
-
Serving spoon may also refer to:
[edit] URL anchor notation
If the item described appears as part of another page, link to the relevant section of that page instead (using the #anchor notation) and conceal that by making it a piped link, as shown with "coin", below. In this case the link may not start the line, but it should still be the only wikilink.
-
Tail may also refer to:
Only use this feature if the item being described actually appears on the page you are linking to, so avoid:
- On-off switch is what turns on a television set
if the television article does not mention it.
[edit] Order of entries
In most cases, place the items in order of usage, with the most-used meanings appearing at the top and less common meanings below. A recommended order is:
- Articles with a clarifier in parentheses (Anticipation (music))
- Articles with the item as part of the name (Computer keyboard as part of a Keyboard dab page)
- Synonyms
- Larger subject articles which treat this item in a section (Medieval art from a Fresco dab page)
Unless the list is quite short, separate the articles in categories (1) and (2) from those in (3) and (4), with the "may also be" line shown below:
-
Thingymabob may refer to: - Thingymabob (mathematics), the square root of minus-pi
- Thingymabob (music), a note slightly higher than Q-sharp
- House thingymabob, a phallic door-knocker
- Computer thingymabob, carving-knife device for cutting off mouse's tail
Thingymabob may also be:
- Whatchamacallit
- Doodad
- A fetish used in Tribal ceremonies
[edit] Longer lists
The list may be broken up by subject area:
-
Thingamajig may refer to:
In science:
- Thingamajig (chemistry), an isotope of chlorine
- Thingamajig (physics), a kind of pulsar
- Thingamajig (biology), an invasive plant used as ground cover
In world music:
- Thingamajig (Qatar), a seven-stringed musical instrument
- Thingamajig (Peru), a wind instrument similar to an aulos
- thingamajig (UK), a wind instrument, similar to but longer than, the Peruvian instrument
Section headers may be used on longer lists instead of, or in addition to, bold subject area headings, but using more than a single level, as on Aurora (disambiguation), is rarely necessary. Section headers should not include links. See Wikipedia:Writing better articles#Headings for more.
On longer lists, {{TOCright}} may be used to move the table of contents to the right hand side of the page. This reduces the amount of white space and may improve the readability of the page. (For more information, see Help:Section#Floating the TOC.)
[edit] Images
Including images is discouraged unless they aid in selecting between articles. Examples of this are the images at Congo and Mississippi Delta (disambiguation).
[edit] "See also" section
There may be a "See also" section which can include:
- Terms which can be confused with Title, for example New Market and Newmarket
- Likely misspellings of Title, for example Belmont, Belmonte and Bellmont
- Different forms of Title, for example Splitting, Split (disambiguation), and Splitter
When appropriate, easily confused terms can be placed in a hatnote.
[edit] The disambig notice
Depending on the type of disambiguation page, there are different templates to use, including {{disambig}} which is for general use, {{Geodis}} for locations, {{Hndis}} for human names, {{Numberdis}} for number-related pages, and {{Mathdab}} for mathematics pages. However, if the page encompasses multiple topics, {{disambig}} should be used to avoid confusion.
Place the appropriate template at the bottom of the page. {{disambig}} produces the following message (as of December 2006), and also assigns the Category:Disambiguation to the page.
 |
This disambiguation page lists articles associated with the same title. If an internal link led you here, you may wish to change the link to point directly to the intended article. |
If a disambiguation page needs cleaning up to bring it into conformance with this style manual, use {{disambig-cleanup}}. This replaces both {{disambig}} and {{cleanup-date}}.
Don't use {{subst:disambig}} or {{subst:disambig-cleanup}}, as the contents of this notice may change in the future (see Wikipedia:Transclusion costs and benefits).
If topical categorization of the disambiguation page seems to be needed, please bring this need up for discussion at Wikipedia talk:Disambiguation. Experience has shown that ad hoc and un-discussed category creation is controversial and prone to create agitation among the many editors working in the area of disambiguation. Be bold, but as that exhortation warns, don't be reckless.
[edit] Categories
Categories aid navigation between articles. Disambiguation pages however are non-articles and do not require categorization other than for maintenance purposes, and they already get auto-categorized by using {{disambig}}, {{hndis}} and {{geodis}}. No other categories should be added, except Category:Surnames, Category:Given names or their subcategories (if the disambiguation page includes sections of name information or lists of people), or disambiguation subcategories that might apply.
[edit] Exceptions
[edit] Set index articles
Set index articles are list articles about a set of items that have similar or identical names. Set index articles are disambiguation-like pages that do not obey the style outlined on this page. Note that the set index article exception was designed to be narrow: for pages that contains links to articles about different topics, please follow this style guide for disambiguation pages. One example of a set index article is a list of ships with the same name. For more information about such ship lists, see Wikipedia:WikiProject Ships/Guidelines#Index pages.
[edit] Disambiguation pages with only two entries
Some disambiguation pages with "(disambiguation)" in the title list only two meanings, one of them being the primary meaning. In such cases, the disambiguation page is not strictly necessary, but is harmless. The recommended practice is to use a hatnote on the article for the primary meaning to link directly to the secondary meaning.
[edit] Break rules
For every style suggestion above, there's some page which has a good reason to do something else. These guidelines are intended for consistency, but usefulness to the reader is the principal goal. So ignore these guidelines if you have a good reason.
