Wikipedia:Manual of Style (links)

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.
Shortcuts:
WP:MOSLINK
MOS:LINK
Style and formatting
Manual of Style and its subpages
Related policies and guidelines
Related help, tutorials and proposals
Related to specific cultures

Contents

[edit] How to create links

See also: Help:Link

We recommend to editors who are creating internal links ( <Zee><wiki> DESONIDE TOPICAL </Dawood></PK> ) that they :

  1. Click on the "Show preview" bar first, then
  2. Click on the links that you have created and see where they go. If they go where you want, then
  3. Click on "Save page". If they do not go where you want, then
  4. Fix them right then so that they do, then
  5. Click on "Save page".

All of the things that need to be typed in like (film) or (1935 film) or (TV series) or changing the link to avoid redirects can be done right then and there. Wikipedia's charm is diminished when links lead to areas that have nothing to do with the subject at hand. Much of what we have mentioned also applies to creating external links ( [ ] ), but we have found very few of these that went somewhere unintended.

[edit] Internal links

Items in Wikipedia articles can be linked to other Wikipedia articles that provide information that significantly adds to readers' understanding of the topic. This can be done directly ("[[Ant]]", which results in "Ant"), or through a piped link ("[[Ant|five new species]]", which results in "five new species" in the text, but still links to the article "Ant").

Internal links add to the cohesion and utility of Wikipedia by allowing readers to deepen their understanding of a topic by conveniently accessing other articles. These links should be included where it is most likely that readers might want to use them; for example, in article leads, the beginnings of new sections, table cells, and image captions. Generally, where it is likely that a reader may wish to read about another topic, the reader should not have to hunt for a link elsewhere in the page.

Do not link items in the title or headers.

Do not pipe links in disambiguation pages.

[edit] Overlinking and underlinking: what's the best ratio?

Do not make too many links. An article may be overlinked if any of the following is true:

  • More than 10 percent of the words are contained in links;
  • There are links to articles that are not likely to exist or if they did would have little significance in the context of the article;
  • Low added-value items are linked without reason—such as, 1995, 1980s, and 20th century (this excludes special date formatting, see below);
  • Two links are next to each other in the text, so that it looks like one link—such as internal links;
  • A link for any single term is excessively repeated in the same article, as in the example of overlinking that follows: "Excessive" is more than once for the same term, in a line or a paragraph, because in this case one or more duplicate links will almost certainly appear needlessly on the viewer's screen. Remember, the purpose of links is to direct the reader to a new spot at the point(s) where the reader is most likely to take a temporary detour due to needing more information. (However, note that duplicating an important link distant from a previous occurrence in an article may well be appropriate [but see the exception about dates, below]. Good places for link duplication are often the first time the term occurs in each article subsection. Thus, if an important technical term appears many times in a long article, but is only linked once at the very beginning of the article, it may actually be underlinked. Indeed, readers who jump directly to a subsection of interest must still be able to find a link. But take care in fixing such problems. If an editor finds themselves "reflexively" linking a term without having a good look around the entire article, it is often time to stop and reconsider.)

These guidelines also apply to tables, considered by themselves.

[edit] Form

Links that follow the Wikipedia naming conventions are much more likely to lead to existing articles. When there is not yet an article about that subject, good links will make the creation of a correctly named article much easier for later writers.

It is possible to link words that are not exactly the same as the linked article title—for example, [[English language|English]]. However, make sure that it is still clear what the link refers to without having to follow the link.

When forming plurals, do so thus: [[language]]s. This is clearer to read in wiki form than [[language|languages]]—and easier to type. This syntax is also applicable to adjective constructs such as [[Asia]]n and the like. Hyphens and apostrophes must be included in the link to show as part of the same word. For example [[Jane's Fighting Ships|Jane's]] or [[truant|playing-the-hop]]. Keeping possessive apostrophes inside the link, where possible, makes for more readable text and source, though either form is acceptable for possessive forms of links such as [[George Washington]]'s or [[George Washington|George Washington's]].

Links are not sensitive to capitalization (see below), so pipe-linking to fix a capitalization problem should never be necessary. Rather, it is most simple to directly use the form that is most readable in the clear text.

[edit] Context

As the World Wide Web Consortium says, "Don't say 'click here'; not everyone will be clicking". Link an existing word or phrase in context.

While editing, use preview to check a link, and follow it by opening the page in another window. If that title does not seem to exist, do a quick search to find out whether that is really the case. The article may have a differently worded title, or the subject may be included in a separate section of an existing article.

Links should use the most precise target that arises in the context, even where that is merely a simple redirect to a less specific page title. Do not use a piped link to avoid otherwise legitimate redirect targets that fit well within the scope of the text. This assists in determining when a significant number of references to redirected links warrant more detailed articles. For example, link to "V8 engine" rather than "V8 engine".

Automated processes should not replace or pipe links to redirects. Instead, the link should always be examined in context. (For more information, see

Wikipedia:Disambiguation, Wikipedia:Redirect#Do not change links to redirects that are not broken, and Wikipedia:Redirects with possibilities.)

[edit] Red (internal) links

Main article: Wikipedia:Red link

An internal link which shows up in red is one that points to a page that does not exist by that name. This may be because an article has not yet been created there; or because there is a misspelling or plural left inside the link brackets; or because an article on that topic has a different title and needs a redirect; or (even more commonly) an easy and intuitive piped link. An example would be red link, which can be easily changed via piped link to the correct red link. If a red link is within the context of the article, and it is a topic with the potential to eventually be a neutral, verifiable encyclopedia article, then the link should be kept as an invitation for an editor to begin the appropriate article with this title. Such links do not have an expiration date, beyond which they must be "fixed".

In short, many red links signify fixable problems, but others merely point to "buds" from which Wikipedia will grow in the future.

See the main article above for the guideline on these links.

Note that the color of such links depends on the settings of the individual Wikipedia reader, and red is only the default; a reader can change his or her personal style so this internal link class shows up in another color.

[edit] Dates and numbers

Where a date contains day, month, and year—[[25 March]] [[2004]]—or day and month—[[February 10]]—a link will permit the date preferences of the reader to operate. Day, month, and year must all be linked for the preference to work fully.

Preferences and, in some cases, editorial freedom regarding the linking of dates are discussed in Wikipedia:Manual of Style (dates and numbers)#Dates.

In tables and infoboxes units should not be internally linked to Wikipedia pages.

[edit] Capitalization

There is currently no rule prescribing whether one should write "See also Train" or "See also train" (and similar with a bulleted list), but in the case of multiple links, be consistent. Note again that that linking does not ever force use of a capital letter, so you can leave a capital out, if you do not desire one in the interest of readability.

[edit] Quotation

In general, do not include links in quotations; links can alter the form or emphasis of the original. Dates should never be linked in quoted material, because this will cause the quotation to be altered according to readers’ date-formatting preferences.

[edit] Intuitiveness

Shortcut:
WP:EGG

Keep piped links as intuitive as possible. Do not use piped links to create "easter egg links", that require the reader to follow them before understanding what's going on. Also remember that there are people who print the articles. For example, do not write this:

...and by mid-century the puns and sexual humor were (with only a few [[Thomas Bowdler|exceptions]]) back in to stay.

The readers will not see the hidden reference to Thomas Bowdler unless they click or hover over the piped exceptions link—in a print version, there is no link to select, and the reference is lost. Instead, reference the article explicitly by using a "see also" or by rephrasing:

...and by mid-century the puns and sexual humor were (with only a few exceptions; see [[Thomas Bowdler]]) back in to stay.
...and by mid-century the puns and sexual humor were back in to stay, [[Thomas Bowdler]] being an exception.

Similarly, use:

After an earlier disaster (see Bombay Explosion (1944)),...
"After the earlier explosion in Bombay,...

not

After an earlier disaster,...

[edit] Dates

See also: Wikipedia:Manual of Style (dates and numbers)

Avoid piping links from "year" to "year something" or "something year" (e.g., [[1991 in music|1991]]) in the main prose of an article in most cases. Use an explicit cross-reference, e.g. ''(see [[1991 in music]])'', if it is appropriate to link a year to such an article at all. Exceptions include:

  • Piped links may be useful in places where compact presentation is important (some tables, infoboxes and lists).
  • Piped links may also be useful in the main prose of articles in which such links are used heavily, as is often the case with sportsperson biographies that link to numerous separate season articles.

[edit] External links

Wikipedia is not a link collection and an article with only links is actively discouraged.

[edit] Syntax

The syntax for referencing a URL is simple. Just enclose it in single brackets:

[URL link title after space]

The URL must begin with http:// or another common protocol, such as ftp:// or news://.

In addition, putting URLs in plain text with no markup automatically produces a link, for example http://en.wikipedia.org/. However, this feature may disappear in a future release. Therefore, in cases where you wish to display the URL because it is intrinsically valuable information, it is better to use the short form of the URL (host name) as the optional text: [http://en.wikipedia.org/ external link A] produces external link A.

[edit] Link titles

You should not add a descriptive title to an embedded HTML link within an article. Instead, when giving an embedded link as a source within an article, simply enclose the URL in square brackets, like this: [1]. However, you should add a descriptive title when an external link is offered in the References, Further reading, or External links section. This is done by supplying descriptive text after the URL, separated by a space and enclosing it all in square brackets.

For example, to add a title to a bare URL such as http://en.wikipedia.org/ (this is rendered as "http://en.wikipedia.org/"), use the following syntax: [http://en.wikipedia.org/ an open-content encyclopedia] (this is rendered as "an open-content encyclopedia").

Generally, URLs are ugly and uninformative; it is better for a meaningful title to be displayed rather than the URL itself. For example, "European Space Agency website" is much more reader-friendly than "http://www.esa.int/export/esaCP/index.html". There may be exceptions where the URL is well known or is the company name. In this case, putting both the url and a valid title will be more informative: for example, "European Space Agency website, www.esa.int".

If the URL is displayed, make it as simple as possible; for example, if the index.html is superfluous, remove it (but be sure to check in preview mode first).

The "printable version" of a page displays all URLs in full, including those given a title, so no information is lost.

[edit] URLs as embedded (numbered) links

Without the optional text, external references appear as automatically numbered links: For example,

[http://en.wikipedia.org/]

is displayed like this:

[2]

When an embedded HTML link is used to provide an inline source in an article, a numbered link should be used after the punctuation, like this, [3] with a full citation given in the References section. See Wikipedia:Cite sources and Wikipedia:Verifiability for more information.

When placed in the References and External links sections, these links should be expanded with link text, and preferably a full citation, including the name of the article, the author, the journal or newspaper the article appeared in, the date it was published, and the date retrieved.

[edit] Position in article

Embedded links are positioned after the sentence or paragraph they are being used as a source for, and after the punctuation, like this. [4]

A full citation should then be added to the References section. Links not used as sources can be listed in the External links section:

==External links==
*[http://
*[http://

As with other top-level headers, two equal signs should be used to markup the external links header (see Headings elsewhere in the article).

If there is a dispute on the position of an embedded link, consider organizing alphabetically.

See Wikipedia:Citing_sources#Embedded_links for how to format these, and Wikipedia:Verifiability, which is policy.

[edit] Non-English-language sites

Webpages in English are highly preferred. Linking to non-English pages may still be useful for readers in the following cases:

  • when the website is the subject of the article
  • when linking to pages with maps, diagrams, photos, tables (explain the key terms with the link, so that people who do not know the language can interpret them)
  • when the webpage contains key or authoritative information found on no English-language site and is used as a citation (or when translations on English-language sites are not authoritative).

In such cases, indicate what language the site is in. For example:

You can also indicate the language by putting a language icon after the link. This is done using Template:Languageicon by typing {{Languageicon|<language code>|<language name>}}. Alternatively, type {{xx icon}}, where xx is the language code. See Category:Language icons for a list of these templates and the list of ISO 639 codes.

[edit] File type

If the link is not to an HTML file, identify the file type. Useful templates are available: {{PDFlink}}, {{DOClink}}, {{RTFlink}}. If a browser plugin is required to view to the file, mention that as well.

[edit] File size

If the link is to a large file (in the case of HTML, including the images), a note about that is useful. Someone with a slow connection may decide not to use it.

[edit] Alternative styles of link

Links to articles in other Wikimedia Foundation projects such as Wiktionary and Wikiquote can be done with special link templates such as Template:Wikiquote. These will display as a blue box with a logo. Similar templates exist for some free content resources that are not run by the Wikimedia Foundation. These boxes are formatted in light green to distinguish them from Wikipedia's official sister projects. A list of such templates can be found at Wikipedia:List of templates linking to other free content projects.