View source for UniWiki:Manual of Style/Linking

{{hatnote|For technical information about link formatting, see [[Wikipedia:Help:Link]].}}
{{hatnote|For information on adding external links to articles, see [[Wikipedia:Wikipedia:External links|Wikipedia:External links]].}}
{{UMoS guideline}}

'''Linking''' through [[Wikipedia:Hyperlink|hyperlinks]] is an important feature of the UniWiki (and MediaWiki software in general. Internal links bind the project together into an interconnected whole. [[Wikipedia:Interwiki links|Interwiki links]] bind the UniWiki to other useful resources such as [[Wikipedia:Wikipedia|Wikipedia]], [[Wikipedia:Wiktionary|Wiktionary]], and external links bind the UniWiki to the [[Wikipedia:World Wide Web|World Wide Web]].

Appropriate links provide instant pathways to locations within and outside the project that are likely to increase readers' understanding of the topic at hand. Whenever writing or editing an article, it is important to consider not only what to put in the article, but what links to include to help the reader find related information, as well as which other pages should carry links ''to'' the article. Care should be taken to avoid both [[#Underlinking|underlinking]] and [[#Overlinking|overlinking]], as described below.

This page provides guidelines as to when links should and should not be used, and how to format links. Detailed information about the syntax used to create links can be found at [[Wikipedia:Help:Link]]. The rules on linking applicable to [[Wikipedia:WP:Disambiguation|disambiguation]] pages are set out in the [[UniWiki:Manual of Style/Disambiguation pages|disambiguation style guide]].

==Principles==

MediaWiki software, and thus by extention, the UniWiki itself, is based on [[Wikipedia:Hypertext|hypertext]], and aims to enable readers to access relevant information on other pages easily. The page from which the hyperlink is activated is called the ''anchor''; the page the link points to is called the ''target''.

In adding or removing links, consider an article's place in the [[Wikipedia:tree structure|knowledge tree]]. Internal links can add to the cohesion and utility of the UniWiki, allowing readers to deepen their understanding of a topic by conveniently accessing other articles. Ask yourself, "How likely is it that the reader will also want to read that other article?" Consider including links where readers might want to use them; for example, in article [[UniWiki:Manual of Style/Lead section|leads]], at the openings of new sections, in the cells of [[UniWiki:Manual of Style/Tables|tables]], and in [[UniWiki:Manual of Style/Captions|image captions]]. But note [[#What generally should not be linked|below]] that as a rule of thumb editors should only link the term's first occurrence in the text of the article.

===General points on linking style===

*As explained in more detail at [[Wikipedia:Help:Link|Wikipedia:Wikilinks]], linking can be "direct" (<code><nowiki>[[Exploration]]</nowiki></code>, which results in {{xt|[[Exploration]]}}), or "piped" (<code><nowiki>[[Exploration|exploring]]</nowiki></code>, which results in {{xt|[[Exploration|exploring]]}} in the text, but still links to the article "[[Exploration]]" (though [[Wikipedia:Help:Pipe trick|Pipe trick]] is an easier way to create this particular link).
*Section headings should not themselves contain links; instead, a {{tl|main}} or {{tl|see also}} template should be placed immediately after the heading.
*Links should not be placed in the [[UniWiki:Manual of Style/Lead section#Format of the first sentence|boldface reiteration of the title]] in the opening sentence of a lead.<ref>Many, but not all, articles repeat the article title in bold face in the first line of the article. Linking the article to itself produces '''boldface text'''; this practice is discouraged as page moves will result in a useless circular link through a redirect. Linking ''part'' of the bolded text is also discouraged because it changes the visual effect of bolding; some readers will miss the visual cue which is the purpose of using bold face in the first place.</ref>
*Items within quotations should not generally be linked; instead, consider placing the relevant links in the surrounding text or in the "See also" section of the article.
*When possible, avoid placing links next to each other so that they look like a single link, as in <code><nowiki>[[Ireland|Irish]]&nbsp;[[Chess]]&nbsp;[[Championship]]</nowiki></code> ([[Wikipedia:Ireland|Irish]]&nbsp;[[Wikipedia:Chess|Chess]]&nbsp;[[Wikipedia:Championship|Championship]]). Consider rephrasing the sentence, omitting one of the links, or using a more specific single link (e.g. to [[Wikipedia:Irish Chess Championship|Irish Chess Championship]] using <code><nowiki>[[Irish Chess Championship]]</nowiki></code>) instead.
*Articles on technical subjects might demand a higher density of links than general-interest articles, because they are likely to contain more technical terms that general dictionaries are unlikely to explain in context.
*Beware of linking to an article without first confirming that it is helpful in context; the fact that its title matches the concept you wish to link to, does not guarantee that it deals with the desired topic at all. For example, a physicist speaking of [[Wikipedia:Barn (unit)|barns]] is highly unlikely to wish to link to [[Wikipedia:Barn|Barn]] instead of [[Wikipedia:Barn (unit)|Barn (unit)]], and any reader needing to click on such a link almost certainly will struggle to make sense of what the system offers.
*Do not create links to user, essay, or draft pages in articles, except in articles about the UniWiki itself ''(see [[UniWiki:Manual of Style/Self-references to avoid|Self-references to avoid]])''.
*Do not unnecessarily make a reader chase links: if a highly technical term can be simply explained with very few words, do so.
*Do use a link wherever appropriate, but as far as possible do not force a reader to use that link to understand the sentence.
*The text needs to make sense to readers who cannot follow links. Users may print articles or read offline, and UniWiki content may be encountered in republished form, often without links.
*Refrain from implementing colored links that may impede user ability to distinguish links from regular text, or color links for purely aesthetic reasons.

===Overlinking and underlinking===

====What generally should be linked====

An article is said to be ''underlinked'' if words are not linked that are needed to aid understanding of the article. In general, links should be created to:
* Relevant connections to the subject of another article that will help readers understand the article more fully (see the example below). This can include people, events, and topics that already have an article or that clearly deserve one, so long as the link is relevant to the article in question.
* Articles with relevant information, for example: "{{xt|see [[Wikipedia:Fourier series|Fourier series]] for relevant background}}"
* Articles explaining words of technical terms, jargon or slang expressions/phrases—but you could also provide a concise definition instead of or in addition to a link..

Do not be afraid to create links to potential articles that do not yet exist ''(see {{section link||Red links}} below)''.

If you feel that a link does not belong in the body of an article, consider moving it to a [[UniWiki:Manual of Style/Layout#See also section|"See also" section]].

====What generally should not be linked====

An ''overlinked'' article contains an excessive number of links, making it difficult to identify links likely to aid the reader's understanding significantly.

A good question to ask yourself is whether reading the article you're about to link to would help someone understand the article you are linking from. Unless a term is particularly relevant to the context in the article, the following are not usually linked:
* Everyday words understood by most readers in context
* The names of ''major'' geographic features, locations (e.g. United States, London, New York City, France, Berlin...), languages, nationalities (e.g. English, British, American, French, German...) and religions (e.g. Christianity, Islam, Hinduism, Buddhism...)
* Common occupations
* [[#Units of measurement that are not obscure|Common units of measurement]], e.g. units relating to currency, time, temperature, length, area, or volume.
*Dates ''(see {{section link||Chronological items}} below)''

Do not link to pages that [[Wikipedia:Wikipedia:Redirect|redirect]] back to the page the link is on.

The function of links is to clarify, not emphasize; do not create links in order to draw attention to certain words or ideas, or as a mark of respect.

Generally, a link should appear only ''once'' in an article, but if helpful for readers, a link may be repeated in [[UniWiki:Manual of Style/Infoboxes|infoboxes]], tables, image captions, [[Wikipedia:Help:Footnotes|footnotes]], [[Wikipedia:Wikipedia:Hatnote|hatnotes]], and at the first occurrence after the lead.

Duplicate linking in lists is permissible if it significantly aids the reader. This is most often the case when the list is presenting information that could just as aptly be formatted in a table, and is expected to be parsed for particular bits of data, not read from top to bottom. If the list is normal article prose that happens to be formatted as a list, treat it as normal article prose.

====Lead section====

Too many links can make the lead hard to read. In technical articles that use uncommon terms, a higher-than-usual link density in the [[UniWiki:Manual of Style/Lead section|lead section]] may be necessary. In such cases, try to provide an informal explanation in the lead, avoiding using too many technical terms until later in the article—see [[Wikipedia:Wikipedia:Make technical articles understandable|Wikipedia:Make technical articles understandable]].

====An example article====

For example, in the article on [[Wikipedia:Supply and demand|supply and demand]]:
*Almost certainly link "[[Wikipedia:Microeconomics|microeconomics]]" and "[[Wikipedia:General equilibrium theory|general equilibrium theory]]", as these are technical terms that many readers are unlikely to understand at first sight.
*Consider linking "[[Wikipedia:Price|price]]" and "[[Wikipedia:good (economics)|goods]]" only if these common words have technical dimensions that are specifically relevant to the topic.
*Do not link to the "United States", because that is an article on a very broad topic with no direct connection to supply and demand.
*Definitely do not link "wheat", because it is a common term with no particular relationship to the article on supply and demand, beyond its arbitrary use as an example of traded goods in that article.
*Make sure that the links are directed to the correct articles: in this example, you should link [[Wikipedia:Good (economics)|good (economics)]], not [[Wikipedia:Good|good]], which is a disambiguation page. Many common dictionary words are ambiguous terms in Wikipedia and linking to them is often unhelpful to readers; "Good" is a surname and the name of albums, companies, etc., and the article title [[Wikipedia:Good|good]] is used to index those.

===Link clarity===

The article linked to should correspond to the term showing as the link as closely as possible given the context: for example, {{xt|When Mozart wrote [[Wikipedia:Requiem (Mozart)|his Requiem]]}} rather than {{!xt|When Mozart wrote his [[Wikipedia:Requiem (Mozart)|Requiem]]}}, or {{Xt|Previn conducted [[Wikipedia:Requiem (Mozart)|Mozart's Requiem]]}} rather than {{!xt|Previn conducted Mozart's [[Wikipedia:Requiem (Mozart)|Requiem]]}}&nbsp;– this makes it clear the link is to the article on Mozart's Requiem in particular, rather than that on requiems in general. The link target and the link label do not have to correspond to each other, but the link must be as intuitive as possible. Thus, one may have a link "{{xt|[[Wikipedia:Danube|second-longest European river]]}}" with the target article [[Wikipedia:Danube|Danube]]. For further detail, refer to the section {{section link||Piped links}}.

===Link specificity===

Always link to the article on the most specific topic appropriate to the context from which you link: it will generally contain more focused information, as well as links to more general topics.

{| class="wikitable"
! What you type
! How it appears
! Specificity
|-
| <code><nowiki>[[Icelandic orthography]]</nowiki></code> || [[Wikipedia:Icelandic orthography|Icelandic orthography]]
| Specific
|-
| <code><nowiki>[[Icelandic language|Icelandic]]</nowiki> orthography</code> || [[Wikipedia:Icelandic language|Icelandic]] orthography
| Related, but less specific
|-
| <code>Icelandic <nowiki>[[orthography]]</nowiki></code> || Icelandic [[Wikipedia:Orthography|orthography]]
| Unspecific
|-
| <code>the <nowiki>[[flag of Tokelau]]</nowiki></code>|| the [[Wikipedia:flag of Tokelau|flag of Tokelau]]
| Specific
|-
| <code><nowiki>the [[flag]] of [[Tokelau]]</nowiki></code> || the [[Wikipedia:Flag|flag]] of [[Wikipedia:Tokelau|Tokelau]]
| Unspecific
|-
| <code><nowiki>[[Requiem (Mozart)|Requiem]]</nowiki></code>|| [[Wikipedia:Requiem (Mozart)|Requiem]]
| Specific
|-
| <code><nowiki>[[Requiem]]</nowiki></code>|| [[Wikipedia:Requiem|Requiem]]
| Unspecific
|}

In each case the specific link is preferred.

If there is no article about the most specific topic, do one of the following things:
*Consider [[Wikipedia:Wikipedia:Starting an article|creating the article]] yourself.
*If an article on the specific topic does not yet exist, create a redirect page to the article about a more general topic, as described in section {{section link||Redirects}}. For example, if no article yet exists on the song "Sad Statue" from the album ''Mezmerize'', create a new article called [[Wikipedia:Sad Status|Sad Statue]] that is a redirect to the article ''[[Wikipedia:Mezmerize (album)|Mezmerize]]''.
*If there is no article on a more general topic either, then create a [[red link|red link]], but first read {{section link||Red links}} below.

When neither a redirect nor a red link appear appropriate, consider linking to a more general article instead. For example, instead of {{xt|[[Wikipedia:Baroque hairstyles|Baroque hairstyles]]}}, write {{xt|[[Wikipedia:Baroque|Baroque]] hairstyles}}, {{xt|Baroque [[Wikipedia:Hairstyle|hairstyles]]}}, {{xt|Baroque hairstyles}}, or {{xt|[[Wikipedia:Hairstyle|hairstyles]] of the [[Wikipedia:Baroque|Baroque]]}}
(but not {{xt|[[Baroque]] [[hairstyle]]s}} as [[#Sea of blue|two adjacent links]]), depending on the context.

====Section links====

If an existing article has a section specifically about the topic, you can redirect or link directly to it, by following the article name with a number sign (<code>#</code>) and the name of the section. For example, [[Wikipedia:Underpromotion|Underpromotion]] is a redirect to [[Wikipedia:Promotion (chess)|Underpromotion}}, and in the article [[Wikipedia:Quark|Quark]], the link [[Wikipedia:Gluon#Eight gluon colors|eight gluon types]] (typed as <code><nowiki>[[Gluon#Eight gluon colors|eight gluon types]]</nowiki></code>) links to a specific section in the article Gluon.

To link to a section within the same article, e.g. in the lead of [[Wikipedia:Promotion (chess)|Promotion (chess)]], write: <code><nowiki>[[#Promotion to rook or bishop|§ promotion to a rook or bishop]]</nowiki></code>. You can also use the {{tl|section link}} template for this purpose.

====Broken section links====
A problem can arise if the title of the section is changed for any reason, since this will break any incoming section links (if this occurs, incoming links will default to the top of the linked article).

To prevent this breakage, add a hidden comment to the target section such as <code><nowiki><!-- "Quark" links here --></nowiki></code> so that someone changing the title of that section can fix the incoming links.
The hidden message (<code><nowiki><!-- "Article" links here --></nowiki></code>) must be added to the target section with a break between the header and the hidden message:<br/>
<code><nowiki>==Target section==</nowiki></code><br/>
<code><nowiki><!-- "Article" links here --></nowiki></code>

If there is no break:
<br/><code><nowiki>==Target section==<!-- "Article" links here --></nowiki></code><br/>
problems arise; for example, the target section title is not added to the edit summary when the section edit button is clicked, and the article does not return to that section after editing.

==Techniques==

===Redirects===
{{hatnote|See also: [[Wikipedia:Wikipedia:Redirect|Wikipedia:Redirect]]}}

Let's assume for example you needed to link "poodle", and there was no article for poodles yet. You might want to create a redirect from "poodle" to "dog" as follows: Write the link in the text as if the "poodle" article existed: <code><nowiki>She owned a [[poodle]]</nowiki></code>. When you save or preview this, you will see: {{xt|She owned a [[Wikipedia:WP:Red link example|poodle]]}}. Click on the red link to create the redirect page, and enter the code <code><nowiki>#REDIRECT</nowiki></code> followed by a space and a standard wikilink to the target article name (in our case, {{xt|Dog}}). The result should be: <code><nowiki>#REDIRECT [[Dog]]</nowiki></code>.

The advantage of redirects over [[#Piped links|piped links]] is that they allow us to determine which pages link to the given topic using [[Special:WhatLinksHere]], which in turn allows us to:
*Create a new article when a significant number of links to that topic exist (see [[Wikipedia:WP:Don't fix links to redirects that are not broken|Wikipedia:Don't fix links to redirects that are not broken]])
*Maintain links (e.g. by filtering incoming links and identifying related articles)

(There is currently no way to apply Whatlinkshere directly to article sections.)

===Piped links===
{{hatnote|See also: [[Wikipedia:Wikipedia:Piped link|Wikipedia:Piped link]]}}

You may want a link to display text other than the title of the article being linked to (the "target"). This can be done with the use of the pipe character ('''|'''). For example, {{xt|<code><nowiki>[[Henry II of England|Henry II]]</nowiki></code>}} displays as {{xt|[[Wikipedia:Henry II of England|Henry II]]}}. However, make sure that it is still clear what the link is about without having to follow the link. Think about what the reader may believe the text refers to. For example, when seeing the link {{xt|<code><nowiki>[[Archery at the 2008 Summer Olympics|Archery]]</nowiki></code>}}, which displays as {{xt|[[Wikipedia:Archery at the 2008 Summer Olympics|Archery]]}}, the reader will probably expect this link to go to a general article on [[Wikipedia:Archery|Archery]], rather than {{xt|[[Wikipedia:Archery at the 2008 Summer Olympics|Archery at the 2008 Summer Olympics]]}} specifically. An exception to this is when it is clear from the context that a link refers to a specific article; for instance, in {{xt|[[Wikipedia:Template:2008 Summer Olympics calendar]]}} all links go to articles about these particular games.

*'''Plurals and other derived names.''' Plurals can be formed by appending an ''&#8209;s'' after the closing brackets; for instance, {{xt|<code><nowiki>[[apple]]s</nowiki></code>}} displays as {{xt|[[Wikipedia:Apple|apple]]s}}. This is both easier to type and clearer to read in the source text than the alternative {{xt|<code><nowiki>[[apple|apples]]</nowiki></code>}}. This works not just for ''&#8209;s'', but for any words that consist of a linked term and a [[Wikipedia:Suffix|suffix]], for example ''&#8209;ing'', ''&#8209;ed'', or ''&#8209;est''. However, such suffixes cannot begin with a [[Wikipedia:Hyphen|hyphen]] (-), an [[Wikipedia:Apostrophe|apostrophe]] ('), or a [[Wikipedia:Capital letter|capital letter]] (see [[Wikipedia:Help:Link]] for more details).
*'''Case sensitivity.''' Links are not sensitive to initial capitalization, so there is no need to use the pipe character where the case of the initial letter is the only difference between the link text and the target page (Wikipedia article titles almost always begin with a capital, whereas the linked words in context often do not). However, links are case-sensitive for all characters after the initial one.

*'''Intuitiveness.''' Keep piped links as intuitive as possible. Per the [[Wikipedia:Wikipedia:Principle of least astonishment|principle of least astonishment]], make sure that the reader knows what to expect when clicking on a link. You should plan your page structure and links so that everything appears reasonable and makes sense. If a link takes readers to somewhere other than where they thought it would, it should at least take them somewhere that makes sense. For example, do not write: <blockquote>{{!xt|Richard Feynman was also known for work in <code><nowiki>[[Parton (particle physics)|particle physics]]</nowiki></code>.}}</blockquote> Here readers would see the link displayed as {{xt|[[Wikipedia:Parton (particle physics)|particle physics]]}}, not the hidden reference to the page {{xt|[[Wikipedia:Parton (particle physics)|Parton (particle physics)]]}}, unless they clicked on the link or hovered their [[Wikipedia:Mouse cursor|mouse cursor]] over it. If a physical copy of the article were printed, the reference to the parton model would be lost. Such links are sometimes called "[[Wikipedia:Easter egg (media)|Easter egg]]" or "submarine" links. Instead, refer to the separate article with an explicit ''see also X'', or by rephrasing the sentence, as in: <blockquote>{{xt|Richard Feynman was also known for work in <code><nowiki>[[particle physics]]</nowiki></code>, especially the <code><nowiki>[[Parton (particle physics)|parton]]</nowiki></code> model.}}</blockquote>
** Do not place a link to a name within another name. For example, use {{xt|[[Wikipedia:Columbus Avenue|Columbus Avenue]]}}, not {{xt|[[Wikipedia:Christopher Columbus|Columbus]] Avenue}}; {{xt|[[Wikipedia:Feynman diagram|Feynman diagram]]}}, not {{xt|[[Wikipedia:Richard Feynman|Feynman]] diagram}}. This applies regardless of whether linking to the full name creates a [[Wikipedia:WP:REDLINK|red link]]; for example, even if there is no article titled {{xt|[[Wikipedia:Lafayette Avenue (Brooklyn)|Lafayette Avenue (Brooklyn)]]}}, do not use {{xt|[[Wikipedia:Gilbert du Motier, Marquis de Lafayette|Lafayette]] Avenue}}.

*'''Piping and redirects.''' As per {{section link||Link specificity}} above, do not use a piped link where it is possible to use a redirected term that fits well within the scope of the text. For example, let's assume that the page {{xt|[[Wikipedia:Papageno|Papageno]]}} is a redirect to the article about Mozart's opera ''[[Wikipedia:The Magic Flute|The Magic Flute]]''. While editing some other article, you might want to link the term {{xt|Papageno}}; here, you might be tempted to avoid the redirect by using a pipe within the link, as in {{!xt|<code><nowiki>[[Wikipedia:The Magic Flute|Papageno]]</nowiki></code>}}. Instead, write simply {{xt|<code><nowiki>[[Papageno]]</nowiki></code>}} and let the system handle the rest. This has two advantages: first, if an article is written later about the more specific subject (in this case, "Papageno"), fewer links will need to be changed to accommodate the new article; second, it indicates that the article is [[Wikipedia:WP:Most wanted articles|wanted]].

====Piped links and redirects to sections of articles====
{{see also|UniWiki:Manual of Style/Linking#Section links}}

Linking to particular [[Wikipedia:Wikipedia:Section|sections]] of articles can be useful, inasmuch as it can take the reader immediately to the information that is most focused on the original topic. Use of a piped link here avoids the unsightly ''Article name#Section name'' in the display text (alternative methods are to use a [[#Redirects|redirect]] or {{Tl|Section link}}). The format for a link to a page section is {{xt|<code><nowiki>[[Article#Section|name of link]]</nowiki></code>}}. For example, to link to the "Culture" subsection of the article {{xt|[[Wikipedia:Oman|Oman]]}}, type {{xt|<code><nowiki>[[Oman#Culture|culture of Oman]]</nowiki></code>}}; this displays as {{xt|[[Wikipedia:Oman#Culture|culture of Oman]]}} (note that the section name is case-sensitive). When doing this, add a [[UniWiki:Manual of Style#Invisible comments|hidden comment]] to the target section such as <code><nowiki><!-- the article ''X'' links here --></nowiki></code> so that if another user edits the title of that section, they can fix the incoming links.

{| align=right style="margin-left:24px; margin-bottom:20px"
 |History&nbsp;of&nbsp;''Topic'': {{xt|<tt>#REDIRECT&#91;[''Topic''#History]]</tt>}}<br>
{{xt|&#91;[history of ''Topic'']]}}
 |-
 |{{!xt|&#91;[''Topic''#History&#124;history of ''Topic'']]}}
 |}

Many topics useful for linking may currently appear only as sections of other UniWiki articles, but are potentially notable enough to become articles on their own. For example, the article {{xt|Eastern Anyshire}} might have a small "History" section, but this does not prevent the article {{xt|History of Eastern Anyshire}} being written eventually. Usually, a [[Wikipedia:WP:redirect|redirect]] page from such a sub-topic to a general topic will exist already; if not, they can be created when the occasion arises. It is bad practice to create links in article text using the format <code><nowiki>[[Article#Section]]</nowiki></code>; navigation then becomes difficult if the section is expanded into a new article. Instead, link using a redirect to the main topic; [[Wikipedia:WP:NOTBROKEN|it costs little]] and makes improvements easier.

===Links to the UniWiki's categories===
{{hatnote|See also: [[Wikipedia:Wikipedia:Colon trick|Wikipedia:Colon trick]]}}
Wikipedia has categories of articles like {{xt|<code><nowiki>[[Category:Phrases]]</nowiki></code>}}; adding this to an article puts it into that category. You can link to a category by putting a colon in front.

For example {{xt|<code><nowiki>[[:Category:Phrases]]</nowiki></code>}} links to [[Wikipedia:Category:Phrases|Category:Phrases]], and piping can be used: [[Wikipedia:Category:Phrases|Phrases]].

===Red links===
{{hatnote|See also: [[Wikipedia:Wikipedia:Red link|Wikipedia:Red link]]}}

Overlinking in general is a style issue partly because of the undesirable effect upon readability. But if too many ''blue'' links is distracting (reducing the chance the article will be read), then a ''red'' link is even more so. The ''unassuming'' coloration of the text (probably black) is the most productive.

In prose, if it seems that the level of red linking is overlinking, remember that red links have been found to be a driving force that encourage contributions<ref>Academic research has suggested that red links may be a driving force in wiki growth; See also ''[[Wikipedia:Wikipedia:Inflationary hypothesis of Wikipedia growth|Wikipedia:Inflationary hypothesis of Wikipedia growth]]''.</ref>, and then use that fact to balance the perceived stylistic issues of "overlinking" the red links.
(Legitimate red links are titles to unfulfilled coverage of topics. Given a certain number of red links needed, if marking ''all'' of them could be overlinking, then just ''how many'' should be marked could be a style issue, and just ''which ones'' are priority is a helpful contribution.

In [[Wikipedia:WP:lists|lists]], overlinking red links can occur when every item on a list is a red link. If the list is uniform, where each item is obviously qualified for an article, a ''single'' red link (or blue link) could indicate that. If the list is not uniform, the research effort to mark all possible red links is a risky investment: while red means "approved" status, "black" remains ambiguous, even though it meant "disapproved" ''after research''. The removal of massive numbers of red links from an overlinked list is best handled by an editor skilled in the automation of [[Wikipedia:Text processing|text processing]].

Red links can also be removed if they violate the [[Wikipedia:WP:red links|guideline for red links]], but otherwise red links do not have an expiration date. If you remain convinced there is overlinking of red links, consider turning some of them blue. The methods to do so are by creating a simple [[Wikipedia:Wikipedia:Stub|stub]], a [[Wikipedia:WP:redirect|redirect]], or a [[Wikipedia:WP:disambiguation|disambiguation]] page. All of these require the certainty that the red link was legitimate in the first place, such as the conventions on [[Wikipedia:Wikipedia:Naming conventions|naming]] and [[Wikipedia:Wikipedia:AT|titling]].

===Checking links as they are created===

One of the most common errors in linking occurs when editors do not check to see whether a [[Wikipedia:Help:Link|link they have created]] goes to the intended location. This is especially true when a mistake is not obvious to the reader or to other editors. The text of links needs to be exact, and many Wikipedia destinations have a number of similar titles. To avoid such problems, which can be irritating for readers, the following procedure is recommended, especially for editors who are new to creating links.
# Carefully key in the link.
# Click on "Show preview".
# In the display-mode, click on the links (or open them in a new browser [[Wikipedia:tab (GUI)|tab]]) to check they go where you intend; if they do not, fix them. If a destination page does not appear to exist, do a quick search to determine whether the article has a differently worded title or the subject is treated in a section of another article. Adjust the link accordingly or leave it as a red link.
# Return to the "Show preview" page using your browser's return button (or close the browser tab showing the linked article).
# Click on "Save page".

By following [[Wikipedia:Wikipedia:Naming conventions|naming conventions]], an internal link will be much more likely to lead to an existing article. When there is not yet an article about the subject, a good link will make the creation of a correctly named article much easier for subsequent writers.

==Specific cases==

===Units of measurement that are not obscure===
Units should generally only be linked to if they are likely to be obscure to readers of the article, or if they are being discussed (see [[Wikipedia:Use-mention distinction|use–mention distinction]]). So, for example, the [[Wikipedia:Troy ounce|troy ounce]] or [[Wikipedia:Bushel|bushel]], the [[Wikipedia:Candela|candela]], [[Wikipedia:Mho|mho]], or [[Wikipedia:Millibarn|millibarn]] might be considered obscure. Units that are relatively common generally don't need to be linked.

==External links section==

===Syntax===
The syntax for referencing a [[Wikipedia:URL|URL]] is simple. Just enclose it in single brackets with a space between the URL and the text that will be displayed when the page is previewed or saved:
:<code><nowiki>[http://www.example.org Text to display]</nowiki></code>
The text will display as:
:[http://www.example.org Text to display]

The URL must begin with <code><nowiki>http://</nowiki></code> or another common protocol, such as <code><nowiki>ftp://</nowiki></code> or <code><nowiki>news://</nowiki></code>. If no protocol is used, the square brackets will display normally&nbsp;– [like this]&nbsp;– and can be used in the standard way.

In addition, putting URLs in plain text with no markup automatically produces a link, for example <code><nowiki>http://www.example.org/</nowiki></code> → {{xt|http://www.example.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 (domain name) as the optional text: <code><nowiki> [http://www.example.org/ example.org]</nowiki></code> produces {{xt|[http://www.example.org/ example.org]}}.

===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: <code><nowiki>[http://www.guardian.co.uk/usa/story/0,12271,1650417,00.html]</nowiki></code> → {{xt|[http://www.guardian.co.uk/usa/story/0,12271,1650417,00.html]}}. 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 <code><nowiki>http://en.wikipedia.org/</nowiki></code> (this is rendered as {{xt|http://en.wikipedia.org/}}), use the following syntax: <code><nowiki>[http://en.wikipedia.org/ an open-content encyclopedia]</nowiki></code> (this is rendered as "{{xt|[http://en.wikipedia.org/ 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, {{xt|[http://www.esa.int/export/esaCP/index.html European Space Agency website]}} is much more reader-friendly than {{xt|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, {{xt|[http://www.esa.int/export/esaCP/index.html European Space Agency website, www.esa.int]}}.

If the URL ''is'' displayed, make it as simple as possible; for example, if the <code>index.html</code> 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.

===URLs as embedded (numbered) links===
Without the optional text, external references appear as automatically numbered links: For example,
:<code><nowiki>[http://en.wikipedia.org/]</nowiki></code>
is displayed like this:
:[http://en.wikipedia.org/]
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, [http://en.wikipedia.org/wiki/WP:CITE] with a full citation given in the References section. This style of referencing is not recommended, because such links are susceptible to [[Wikipedia:WP:LR|link rot]].

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.

===Position in article===
{{Main|UniWiki:Manual of Style/Layout#Order of article elements}}

Embedded links that support information in an article are positioned in the same manner as any other reference in the article, following the usual standards about [[Wikipedia:Wikipedia:Citing sources#Embedded links|citation formatting]] and [[UniWiki:Manual of Style#Punctuation and footnotes|placement in relation to punctuation]].

Links that are '''not''' used as sources can be listed in the External links section, like this:

: <code><nowiki>==External links==</nowiki></code>
: <code><nowiki>*[http:// </nowiki></code>
: <code><nowiki>*[http:// </nowiki></code>
As with other top-level headings, two equal signs should be used to mark up the external links heading (see [[UniWiki:Manual of Style/Layout#Headings|Headings]]). ''External links'' should always be the last section in an article. It precedes categories and some kinds of [[Wikipedia:WP:NAVBOX|navigation templates]].

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

===File type and size===
If the link is not to an [[Wikipedia:HTML|HTML]] or [[Wikipedia:PDF|PDF]] file (the latter is identified automatically by the software with an icon like this: {{xt|[http://www.example.com/test.pdf]}}), identify the file type. If a [[Wikipedia:Browser plugin|browser plugin]] is required to view the file, mention that as well. If a link is to a PDF file but doesn't end with <code>.pdf</code>, you can put a <code>#.pdf</code> at the end to flag it as a PDF.

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

==Interwiki links==
{{hatnote|See also: [[Wikipedia:Help:Interwikimedia links]]}}

===Linking===
Interwiki links can take the form of:
:<code><nowiki>[[Wikipedia:article]]</nowiki></code> which appears as: [[Wikipedia:article]]

The pipe symbol suppresses the prefix:
:<code><nowiki>[[wiktionary:article|]]</nowiki></code> → [[wiktionary:article|article]]

Adding text after the pipe allows different text:
:<code><nowiki>[[Wikipedia:article|Any text]]</nowiki></code> → [[Wikipedia:article|Any text]]

To avoid reader confusion, inline interwiki linking within an article's body text is generally discouraged. Exceptions: [[Wikipedia:Wiktionary|Wiktionary]] and [[Wikipedia:Wikipedia|Wikipedia]] entries may be linked inline (e.g. to an unusual word or the text of a document being discussed).

==Link maintenance==
Linking and continual change are both central features of the UniWiki. However, continual change makes linking vulnerable to acquired technical faults, and to the later provision of different information from that which was originally intended. This is true of both "outgoing" links (''from'' an article) and "incoming" links (''to'' an article).
*''Outgoing links:'' These should be checked from time to time for unintended changes that are undesirable. If the opportunity arises to improve their formatting, appropriateness, and focus, this should be done.
*''Incoming links:'' Creating an article will turn orange any existing red links to its title (proper red links are created only in the hope that an article will eventually be written). Therefore, when creating an article, it is wise to check "What links here" to identify such red links, if any, and that they are appropriate.

==See also==
*[[Wikipedia:Wikipedia:Linking dos and don'ts|Wikipedia:Wikipedia:Linking dos and don'ts]] (information page summarizing the key points of this guideline)
*[[Wikipedia:Help:Interwikimedia links]]
*[[Wikipedia:Help:Link color]]
*[[Wikipedia:Wikipedia:Dead-end pages|Wikipedia:Dead-end pages]], pages without internal links
*[[Wikipedia:Wikipedia:Integrate|Wikipedia:Integrate]]
*[[Wikipedia:Wikipedia:Links to (disambiguation) pages|Wikipedia:Links to (disambiguation) pages]]
*[[Wikipedia:Wikipedia:Orphan|Wikipedia:Orphan]], pages without incoming links
*[[Wikipedia:Wikipedia:Red link|Wikipedia:Red link]] (example [[red link]])
*[[Wikipedia:Wikipedia:Walled garden|Wikipedia:Walled garden]]

==References==
{{Reflist}}