Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

UniWiki:Manual of Style/Linking: Difference between revisions

From EVE University Wiki
Djavin novienta (talk | contribs)
Fix link.
 
(22 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{hatnote|For technical information about link formatting, see [[Wikipedia:Help:Link].}}
{{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]].}}
{{hatnote|For information on adding external links to articles, see [[Wikipedia:Wikipedia:External links|Wikipedia:External links]].}}
{{UMoS guideline}}
{{UMoS guideline}}
Line 5: Line 5:
'''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]].
'''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.
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 [[#Overlinking and underlinking|underlinking]] and [[#Overlinking and underlinking|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]].
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]].
Line 17: Line 17:
===General points on linking style===
===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).
*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.
*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>
*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>
Line 58: Line 58:
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.
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 {{em|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.
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.
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.
Line 115: Line 115:
*Consider [[Wikipedia:Wikipedia:Starting an article|creating the article]] yourself.
*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 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 [[redlink|red link]], but first read {{section link||Red links}} below.
*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]]}}
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]]}}
Line 164: Line 164:
*'''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]].
*'''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]].


===={{anchor|Linking to sections of articles}}Piped links and redirects to sections of articles====
====Piped links and redirects to sections of articles====
{{shortcut|MOS:LINK2SECT}}
{{see also|UniWiki:Manual of Style/Linking#Section links}}
{{see|Wikipedia:Manual of Style/Linking#Section links|Help:Link#Section linking (anchors)}}


Linking to particular [[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|[[Oman]]}}, type {{xt|<code><nowiki>[[Oman#Culture|culture of Oman]]</nowiki></code>}}; this displays as {{xt|[[Oman#Culture|culture of Oman]]}} (note that the section name is case-sensitive). When doing this, add a [[MOS:COMMENT|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 (alternatively, use {{tlx|Anchor}} in cases where a section has a large number of incoming 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"
{| align=right style="margin-left:24px; margin-bottom:20px"
Line 177: Line 176:
  |}
  |}


Many topics useful for linking may currently appear only as sections of other Wikipedia 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 [[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; [[WP:NOTBROKEN|it costs little]] and makes improvements easier.
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 Wikipedia's categories===
===Links to the UniWiki's categories===
{{See also|Wikipedia:Colon trick}}
{{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.
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 [[:Category:Phrases]], and piping can be used: [[:Category:Phrases|Phrases]].
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]].
 
{{xt|<code><nowiki>{{see also cat|Phrases}}</nowiki></code>}} creates: {{see also cat|Phrases}}


===Red links===
===Red links===
{{Main article|Wikipedia:Red link}}
{{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.
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 group="nb">Academic research has suggested that red links may be a driving force in Wikipedia growth; see {{cite journal
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.
|last1=Spinellis |first1=D.
(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.
|author1-link=Diomidis Spinellis
|last2=Louridas |first2=P.
|author2-link=Panagiotis Louridas
|year=2008
|title=The collaborative organization of knowledge
|journal=[[Communications of the ACM]]
|volume=51 |issue=8 |pages=68–73
|doi=10.1145/1378704.1378720
|quote=Most new articles are created shortly after a corresponding reference to them is entered into the system
}} See also ''[[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 that do not violate ''[[Wikipedia:What Wikipedia is not|What Wikipedia is not]]''.) 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 [[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''. Valid [[Wikipedia:Requested_articles|requests]] for the future creation of each title in a list, or in prose, may also be a risky investment when the number of red links could be perceived by ''other'' editors as overlinking, and then removed before the investment was fruitful. The removal of massive numbers of red links from an overlinked list is best handled by an editor skilled in the automation of [[text processing]].
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 policy or the [[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:Stub|stub]], a [[WP:redirect|redirect]], or a [[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:Naming conventions|naming]] and [[Wikipedia:AT|titling]].
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===
===Checking links as they are created===
{{shortcut|WP:TESTLINK}}


One of the most common errors in linking occurs when editors do not check to see whether a [[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.
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.
# Carefully key in the link.
# Click on "Show preview".
# Click on "Show preview".
# In the display-mode, click on the links (or open them in a new browser [[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.
# 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).
# 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".
# Click on "Save page".


By following [[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.
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==
==Specific cases==


===<span id="Chronological items"></span><span id="Year linking"></span><span id="Month-and-day linking"></span>Linking month-and-day or year===
===Units of measurement that are not obscure===
{{shortcut|WP:DATELINK|WP:YEARLINK}}
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.
 
Month-and-day articles (e.g. [[February 24|February&nbsp;24]] and [[July 10|10&nbsp;July]]) and year articles (e.g. [[1795]], [[1955]], [[2007]]) should not be linked unless the linked date or year has a significant connection to the subject of the linking article, beyond that of the date itself, so that the linking enhances the reader's understanding of the subject.
For example:
*The date (or year) should not be linked in a sentence such as (from [[Sydney Opera House]]): "{{xt|The Sydney Opera House was made a UNESCO World Heritage Site on 28 June 2007}}", because little if any content of either [[June 28|June&nbsp;28]] or [[2007]] is germane to either UNESCO, World Heritage Sites, or the Sydney Opera House.
*The years of birth and death of architect [[Philip Johnson]] should not be linked, because little if any content of [[1906]] or [[2005]] enhance the reader's understanding of Johnson or his work.
*[[Timeline of World War II (1942)]] might be linked to from another article about WWII
*[[1787 in science]] might be linked from a passage discussing a particular development in the metric system which occurred in that year.
However, in intrinsically chronological articles ([[1789]], [[January]], and [[1940s]]), links to specific month-and-day, month-and year, or year articles are not discouraged.
 
Commemorative days ([[Saint Patrick's Day]]) are not considered month-and-day items for the purposes of the above.
 
==={{anchor|Units}} 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 [[use–mention distinction]]). So, for example, the [[troy ounce]] or [[bushel]], the [[candela]], [[mho]], or [[millibarn]] might be considered obscure. Units that are relatively common generally don't need to be linked. Other units may be obscure in some countries, but well known in others (such as metric system units, which are not well known in the United States) and so linking them may be useful, unless a [[MOS:CONVERSIONS|conversion]] is present, as in {{xt|{{convert|20|C|F}}}} or {{xt|{{convert|68|F|C}}}}—practically all readers will understand at least one of the measures.
<!--
The following table shows some (but not all) units considered to be not-obscure.
{| class="wikitable"
! Quantity !! Not obscure in US !! Not obscure in UK !! Not obscure in rest of world
|-
| Length, area, volume || || Metre/meter || Metre/meter
|-
| Length, area, volume || Inch, foot, yard, mile || Inch, foot, yard, mile ||
|-
| Area || Acre || Acre, hectare || Hectare
|-
| Volume || Litre/liter || Litre/liter || Litre/liter
|-
| Volume || US fluid ounce, pint, quart, gallon || imperial fluid ounce, pint, quart, gallon ||
|-
| Mass || || Gram || Gram
|-
| Mass || Ounce, pound, short ton || Ounce, pound, stone, tonne || tonne
|-
| Time || Second, minute, hour, day, week, month, year, decade, century, millennium || second, minute, hour, day, week, fortnight, month, year, decade, century, millennium || second, minute, hour, day, week, month, year, decade, century, millennium
|-
| Speed || Mile per hour || <not-obscure unit of length> divided by time || <not-obscure unit of length> divided by time
|-
| Temperature || °F || °C || °C
|-
| Power || Watt, kilowatt || Watt, kilowatt || Watt
|-
| Power || Horsepower || Horsepower ||
|-
| Energy || Kilowatt hour || <not-obscure unit of power> multiplied by time || <not-obscure unit of power> multiplied by time
|-
| Energy || Calorie || Calorie || Calorie
|-
| Voltage || Volt || Volt || Volt
|-
| Frequency || Hertz || Hertz || Hertz
|-
| Information || Bit, byte || Bit, byte || Bit, byte
|-
| Other || || Prefixes milli, centi, kilo, mega, giga applied to <not obscure SI units> || Prefixes milli, centi, kilo, mega, giga applied to <not obscure SI units>
|-
| Other || || Squares and cubes of <not obscure units> || Squares and cubes of <not obscure units>
|}
-->


==External links section==
==External links section==
{{Main article|Wikipedia:External links}}
Wikipedia is not a link collection, and an article comprising only links is contrary to what the [[WP:NOT#LINKS|"what Wikipedia is not" policy]] dictates.


===Syntax===
===Syntax===
The syntax for referencing a [[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:
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>
:<code><nowiki>[http://www.example.org Text to display]</nowiki></code>
The text will display as:
The text will display as:
Line 300: Line 225:


===Link titles===
===Link titles===
{{Main article|Wikipedia:Embedded citations}}


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.
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.
Line 317: Line 241:
is displayed like this:
is displayed like this:
:[http://en.wikipedia.org/]
:[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 [[WP:LR|link rot]]. See [[Wikipedia:Cite sources]] and [[Wikipedia:Verifiability]] for more information.
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.
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===
===Position in article===
{{Main article|MOS:ORDER}}
{{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:Citing sources#Embedded links|citation formatting]] and [[WP:REFPUNC|placement in relation to punctuation]].
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:
Links that are '''not''' used as sources can be listed in the External links section, like this:
Line 331: Line 255:
: <code><nowiki>*[http:// </nowiki></code>
: <code><nowiki>*[http:// </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 [[Wikipedia:Manual_of_Style/Layout#Headings|Headings]]). ''External links'' should always be the last section in an article. It precedes categories and some kinds of [[WP:NAVBOX|navigation templates]].
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.
If there is a dispute on the position of an embedded link, consider organizing alphabetically.
===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 information found on no English-language site of comparable quality, and is used as a citation (or when translations on English-language sites are not authoritative).
If the language is one that most readers could not be expected to recognize, or is for some other reason unclear from the name of the publication or the book/article/page title, consider indicating what language the site is in.
*Example: {{xt|[http://www.kohajone.com/ ''Koha Jonë''], an Albanian-language newspaper from [[Tirana]]}}
*Example: {{Xt|[http://www.elpais.es/ ''El País''], a Spanish-language newspaper from [[Madrid]]}}
You can also indicate the language by putting a language icon after the link. This is done using [[Template:link language]] by typing <code><nowiki>{{link language|<language code>}}</nowiki></code>. For example, <code><nowiki>{{link language|es}}</nowiki></code> displays as: {{xt|{{link language|es}}}}. Alternatively, type <code><nowiki>{{</nowiki><var>xx</var> icon<nowiki>}}</nowiki></code>, where <code><var>xx</var></code> is the language code. For example, <code><nowiki>{{pl icon}}</nowiki></code> gives: {{xt|{{pl icon}}}}. See [[:Category:Language icon templates]] for a list of these templates and the [[list of ISO 639 codes]].
When using one of the {{cs1}} or {{cs2}} templates, instead of the {{tld|xx icon}} or {{tld|link language}} templates, use the {{para|language}} parameter. This parameter accepts language names or [[list of ISO 639-1 codes|ISO 639-1]] language codes.


===File type and size===
===File type and size===
If the link is not to an [[HTML]] or [[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. Useful templates are available: {{tl|DOClink}}, {{tl|RTFlink}}. If a [[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 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.
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==
==Interwiki links==
{{Main article|Help:Interlanguage links|Help:Interwikimedia links}}
{{hatnote|See also: [[Wikipedia:Help:Interwikimedia links]]}}


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


The pipe symbol suppresses the prefix:
The pipe symbol suppresses the prefix:
Line 365: Line 275:


Adding text after the pipe allows different text:
Adding text after the pipe allows different text:
:<code><nowiki>[[wiktionary:article|Any text]]</nowiki></code> → [[wiktionary:article|Any text]]
:<code><nowiki>[[Wikipedia:article|Any text]]</nowiki></code> → [[Wikipedia:article|Any text]]
 
To avoid reader confusion, inline interlanguage, or interwiki, linking within an article's body text is generally discouraged. Exceptions: [[Wiktionary]] and [[Wikisource]] entries may be linked inline (e.g. to an unusual word or the text of a document being discussed), and {{tl|ill}}, {{tl|ill2}}, or {{tl|ill-WD}} templates may be helpful in some cases to show both a [[WP:RED|red link]] and an interlanguage link.{{explain}}


===Floating boxes===
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).
{{wikiquote|Jimmy Wales}}Floating boxes for links to articles in other Wikimedia Foundation projects such as Wiktionary and Wikiquote can be done with special link templates such as <code><nowiki>{{Wikiquote|Jimmy Wales}}</nowiki></code>. These will display as a 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]].


==Link maintenance==
==Link maintenance==
Linking and continual change are both central features of Wikipedia. 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).
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.
*''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 blue any existing red links to its title (proper redlinks 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 redlinks, if any, and that they are appropriate.
*''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.
<!--==Transclusion in talk pages via linking==
[[WP:Transclusion|Transclusion]] means the inclusion of the content of one document in another document by reference, such as by linking. It is best to use transclusion linking rather than copying entire sections, such as in talk page discussions, so as to avoid [[Wikipedia:Article_creep#Talk_page_creep|article creep]].-->


==See also==
==See also==
{{Columns-list|colwidth=30em|
*[[Wikipedia:Wikipedia:Linking dos and don'ts|Wikipedia:Wikipedia:Linking dos and don'ts]] (information page summarizing the key points of this guideline)
*[[Wikipedia:Linking dos and don'ts]] (information page summarizing the key points of this guideline)
*[[Wikipedia:Help:Interwikimedia links]]
*[[Help:Interwikimedia links]]
*[[Wikipedia:Help:Link color]]
*[[Help:Link color]]
*[[Wikipedia:Wikipedia:Dead-end pages|Wikipedia:Dead-end pages]], pages without internal links
*[[Help:Menu/Links]]
*[[Wikipedia:Wikipedia:Integrate|Wikipedia:Integrate]]
*[[Template:Dead end]]
*[[Wikipedia:Wikipedia:Links to (disambiguation) pages|Wikipedia:Links to (disambiguation) pages]]
*[[Template:Dead link]]
*[[Wikipedia:Wikipedia:Orphan|Wikipedia:Orphan]], pages without incoming links
*[[Template:Underlinked]]
*[[Wikipedia:Wikipedia:Red link|Wikipedia:Red link]] (example [[red link]])
*[[Wikipedia:Dead-end pages]], pages without internal links
*[[Wikipedia:Wikipedia:Walled garden|Wikipedia:Walled garden]]
*[[Wikipedia:Integrate]]
*[[Wikipedia:Links to (disambiguation) pages]]
*[[Wikipedia:Links to disambiguating pages]]
*[[Wikipedia:Linky tutorial]]
*[[Wikipedia:Orphan]], pages without incoming links
*[[Wikipedia:Red link]] ([[example red link]])
*[[Wikipedia:Walled garden]]
*{{Section link|Wikipedia:What Wikipedia is not|Wikipedia is not an indiscriminate collection of information}}
*[[Wikipedia:Wikipedia doesn't use Allwiki]], the idea that every single word should be a link
*[[Wikipedia:WikiProject Orphanage]], editors dedicated to clearing up the immense backlog of orphaned articles
*<s>[[Template:Wikify]]</s> (deprecated)
}}
 
==Notes==
<references group="nb"/>


==References==
==References==
{{Reflist}}
{{Reflist}}
==External links==
*{{cite journal
|last1=Silvers |first1=V. L.
|last2=Kreiner |first2=D. S.
|date=1997
|title=The Effects of Pre-existing Inappropriate Highlighting on Reading Comprehension
|journal=Reading Research and Instruction
|volume=36
|issue=3
|pages=217–223
|doi=10.1080/19388079709558240
|id={{MASID|3889799}}
}}
*[http://www.seoreviewtools.com/internal-link-analyzer/ Internal link analyzer] for automatic detection of [[#Overlinking|redundant links]] in Wikipedia