Difference between revisions of "Links"

From AccountIT
Jump to: navigation, search
(Created page with "There are five types of links in MediaWiki: [[<tvar|internal>#Internal links</>|Internal links]] to other pages in the wiki <tvar|external>#External links</>|External link...")
 
Line 1: Line 1:
There are five types of links in MediaWiki: [[<tvar|internal>#Internal links</>|Internal links]] to other pages in the wiki
+
<!--T:1-->
[[<tvar|external>#External links</>|External links]] to other websites
+
There are five types of links in MediaWiki:  
[[<tvar|external2>#External links to internal pages</>|External links to internal pages]] in the wiki
+
[[<tvar|interwiki>#Interwiki links</>|Interwiki links]] to other websites registered to the wiki in advance
+
[[<tvar|interlang>#Interlanguage links</>|Interlanguage links]] to other websites registered as other language versions of the wiki
+
  
 +
<!--T:2-->
 +
# '''[[<tvar|internal>#Internal links</>|Internal links]]''' to other pages in the wiki
 +
# '''[[<tvar|external>#External links</>|External links]]''' to other websites
 +
# '''[[<tvar|external2>#External links to internal pages</>|External links to internal pages]]''' in the wiki
 +
# '''[[<tvar|interwiki>#Interwiki links</>|Interwiki links]]''' to other websites registered to the wiki in advance
 +
# '''[[<tvar|interlang>#Interlanguage links</>|Interlanguage links]]''' to other websites registered as other language versions of the wiki
  
 +
{{Anchor|Internal|Internal links}}
  
Internal links To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already it is displayed in blue, if it does not, in red.
+
== Internal links == <!--T:3-->
 +
 
 +
<!--T:4-->
 +
To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already it is displayed in blue, if it does not, in red.
 
Selflinks to the current page are not transformed in URLs but displayed in bold.
 
Selflinks to the current page are not transformed in URLs but displayed in bold.
(If you really want to link to the current page, use an anchor (see below), or [[#top|current page]] which always links to the top.)The first letter of the target page is automatically capitalized, unless otherwise set by the admins, and spaces are represented as underscores (typing an underscore in the link will have a similar effect as typing a space, but is not recommended, since the underscore will also be shown in the text).
+
(If you really want to link to the current page, use an anchor (see below), or <nowiki>[[#top|current page]]</nowiki> which always links to the top.)
  
 +
<!--T:5-->
 +
The first letter of the target page is automatically capitalized, unless otherwise set by the admins, and spaces are represented as underscores (typing an underscore in the link will have a similar effect as typing a space, but is not recommended, since the underscore will also be shown in the text).
  
  
 +
 +
{| border="1" class="wikitable"
 +
!<!--T:6-->
 
Description
 
Description
 +
!<!--T:7-->
 
You type
 
You type
 +
!<!--T:8-->
 
You get
 
You get
 
+
|-
<translate>Internal link</translate>
+
|<!--T:9-->
 +
Internal link
 +
|<pre>
 
[[Main Page]]
 
[[Main Page]]
  
Line 23: Line 39:
  
 
[[Extension:DynamicPageList (Wikimedia)]]
 
[[Extension:DynamicPageList (Wikimedia)]]
 +
</pre>
 +
|[[Main Page]]
  
Main Page
+
[[Help:Contents]]
  
Help:Contents
+
[[Extension:DynamicPageList (Wikimedia)]]
 +
|-
 +
|<!--T:10-->
 +
Piped link
 +
|<pre>[[Main Page|different text]]</pre>
 +
<!--T:11-->
 +
See also [[<tvar|meta>meta:Special:MyLanguage/Help:Piped link</>|meta:Help:Piped link]]
 +
|[[Main Page|different text]]
 +
|-
 +
|[[w:Help:Pipe_trick|Pipe trick]]
 +
|<pre>
 +
[[Help:Contents|]]
  
Extension:DynamicPageList (Wikimedia)
+
[[User:John Doe|]]
  
<translate>Piped link</translate>
+
[[Extension:DynamicPageList (Wikimedia)|]]
[[Main Page|different text]]
+
<translate>
+
See also [[<tvar|meta>meta:Special:MyLanguage/Help:Piped link</>|meta:Help:Piped link]]</translate>
+
different text
+
  
Pipe trick
+
[[Extension:DynamicPageList (third-party)|]]
[[Help:Contents|Contents]]
+
</pre>
 +
<!--T:12-->
 +
The pipe trick quickly makes shorter link text, but could be confusing in circumstances like the DynamicPageList link examples.
 +
|[[Help:Contents|Contents]]
  
 
[[User:John Doe|John Doe]]
 
[[User:John Doe|John Doe]]
Line 44: Line 72:
  
 
[[Extension:DynamicPageList (third-party)|DynamicPageList]]
 
[[Extension:DynamicPageList (third-party)|DynamicPageList]]
 +
|-
 +
|<span id="linktrail"></span><!--T:13-->
 +
Word-ending links, following so called "linktrail rules" [[Localisation|localised]] per [[MessagesXx.php|each language]]
 +
|<pre>
 +
[[Help]]s
  
<translate>
+
[[Help]]ing
The pipe trick quickly makes shorter link text, but could be confusing in circumstances like the DynamicPageList link examples.</translate>
+
Contents
+
  
John Doe
+
[[Help]]ers
  
DynamicPageList
+
[[Help]]almostanylettersyoulikehere
 
+
</pre>
DynamicPageList
+
|
 
+
<translate>Word-ending links, following so called "linktrail rules" localised per each language</translate>
+
 
[[Help]]s
 
[[Help]]s
  
Line 63: Line 92:
  
 
[[Help]]almostanylettersyoulikehere
 
[[Help]]almostanylettersyoulikehere
 +
|-
 +
|<!--T:14-->
 +
Avoiding word-ending links
 +
|<pre>
 +
[[Help]]<nowiki />ful advice
  
 +
[[wikipedia:GNU General Public License|GPL]]<nowiki />v3
 +
</pre>
 +
|
 +
[[Help]]<nowiki />ful advice
  
Helps
+
[[wikipedia:GNU General Public License|GPL]]<nowiki />v3
 
+
|-
Helping
+
|<!--T:15-->
 
+
Redirect
Helpers
+
|<pre>#REDIRECT [[Main Page]]</pre>
 
+
<!--T:16-->
Helpalmostanylettersyoulikehere
+
See also [[<tvar|redirects>Special:MyLanguage/Help:Redirects</>|Help:Redirects]]
 
+
| &rarr; [[Main Page]]
<translate>Avoiding word-ending links</translate>
+
|-
[[Help]]ful advice
+
|<!--T:17-->
 
+
Internal link to an anchor
[[wikipedia:GNU General Public License|GPL]]v3
+
|<pre>[[#See also]]</pre>
 
+
[[<tvar|formatting>Special:MyLanguage/Help:Formatting</>|Section headings]] and the [[#top|top]] of the page are automatically anchored.
 
+
|[[#See also]]
Helpful advice
+
|-
 
+
|<!--T:18-->
GPLv3
+
Internal link to an anchor from different text
 
+
|<pre>[[#See also|different text]]</pre>
<translate>Redirect</translate>
+
|[[#See also|different text]]
#REDIRECT [[Main Page]]
+
|-
<translate>
+
|<!--T:19-->
See also [[<tvar|redirects>Special:MyLanguage/Help:Redirects</>|Help:Redirects]]</translate>
+
Setting an internal link anchor
Main Page
+
|<pre><div id="NameOfAnchorHere">optional text</div></pre>
 
+
<translate>Internal link to an anchor</translate>
+
[[#See also]]
+
<translate>[[<tvar|formatting>Special:MyLanguage/Help:Formatting</>|Section headings]] and the top of the page are automatically anchored.</translate>
+
#See also
+
 
+
<translate>Internal link to an anchor from different text</translate>
+
[[#See also|different text]]
+
different text
+
 
+
<translate>Setting an internal link anchor</translate>
+
<div id="NameOfAnchorHere">optional text</div>
+
 
Omit the "optional text" for invisible anchor.
 
Omit the "optional text" for invisible anchor.
optional text
+
|<div id="NameOfAnchorHere">optional text</div>
 
+
|-
<translate>Internal link to an anchor at another page</translate>
+
|<!--T:20-->
[[Help:Images#Supported media types for images]]
+
Internal link to an anchor at another page
Help:Images#Supported media types for images
+
|<pre>[[Help:Images#Supported media types for images]]</pre>
 
+
|[[Help:Images#Supported media types for images]]
<translate>Internal link to the current page's talk page</translate>
+
|-
[[{{TALKPAGENAME}}|Discussion]]
+
|<!--T:21-->
<translate>
+
Internal link to the current page's talk page
See also [[<tvar|page-names>Special:MyLanguage/Help:Magic_words#Page_names</>|Help:Magic_words#Page_names]]</translate>
+
|<pre>[[{{TALKPAGENAME}}|Discussion]]</pre>
Discussion
+
<!--T:22-->
 
+
See also [[<tvar|page-names>Special:MyLanguage/Help:Magic_words#Page_names</>|Help:Magic_words#Page_names]]
<translate>Internal link to a subpage</translate>
+
|[[{{TALKPAGENAME}}|Discussion]]
[[/example]]
+
|-
<translate>Shortcut for [[Help:Links/example|/example]]. See also [[<tvar|subpages>Special:MyLanguage/Help:Subpages</>|Help:Subpages]].</translate>
+
|<!--T:23-->
/example
+
Internal link to a subpage
 
+
|<pre>[[/example]]</pre>
<translate>Internal link to a subpage without the leading slash</translate>
+
Shortcut for <code><nowiki>[[Help:Links/example|/example]]</nowiki></code>. See also [[<tvar|subpages>Special:MyLanguage/Help:Subpages</>|Help:Subpages]].
[[/example/]]
+
|[[Help:Links/example|/example]]
Shortcut for [[Help:Links/example|example]].
+
|-
example
+
|<!--T:24-->
 
+
Internal link to a subpage without the leading slash
<translate>Internal link to a category page</translate>
+
|<pre>[[/example/]]</pre>
[[:Category:Help]]
+
Shortcut for <code><nowiki>[[Help:Links/example|example]]</nowiki></code>.
<translate>
+
|[[Help:Links/example|example]]
See also [[<tvar|cat>Special:MyLanguage/Help:Categories</>|Help:Categories]]</translate>
+
|-
Category:Help
+
|<!--T:25-->
 +
Internal link to a category page
 +
|<pre>[[:Category:Help]]</pre>
 +
<!--T:26-->
 +
See also [[<tvar|cat>Special:MyLanguage/Help:Categories</>|Help:Categories]]
 +
|[[:Category:Help]]
 +
|-
 +
|<!--T:27-->
 +
Internal link to an image or a file of other types
 +
|<pre>[[media:example.jpg]]
  
<translate>Internal link to an image or a file of other types</translate>
+
[[media:example.pdf]]</pre>
[[media:example.jpg]]
+
<!--T:28-->
 +
See also [[<tvar|images>Special:MyLanguage/Help:Images</>|Help:Images]]
 +
|[[media:example.jpg]]
  
 
[[media:example.pdf]]
 
[[media:example.pdf]]
<translate>
+
|-
See also [[<tvar|images>Special:MyLanguage/Help:Images</>|Help:Images]]</translate>
+
|<!--T:29-->
media:example.jpg
+
Internal link to the user's user page
 +
|<pre>[[Special:MyPage]]</pre>
 +
|[[Special:MyPage]]
 +
|-
 +
|<!--T:30-->
 +
Internal link to the user's talk page
 +
|<pre>[[Special:MyTalk]]</pre>
 +
|[[Special:MyTalk]]
 +
|}
  
media:example.pdf
+
{{Anchor|External|External links}}
  
<translate>Internal link to the user's user page</translate>
 
[[Special:MyPage]]
 
Special:MyPage
 
  
<translate>Internal link to the user's talk page</translate>
+
== External links == <!--T:31-->
[[Special:MyTalk]]
+
Special:MyTalk
+
  
 +
<!--T:32-->
 +
To add an external link, enclose the URL followed by space and the name of the page you want to link to in single square brackets. When you save the page, you'll see the new link pointing to your page, with an arrow icon after it to show that it was coded with single bracket external link syntax, and thus may lead to another site.
  
 
+
{| class="wikitable"
<translate>
+
!style="width:15%"|<!--T:33-->
 
+
Description
External links To add an external link, enclose the URL followed by space and the name of the page you want to link to in single square brackets. When you save the page, you'll see the new link pointing to your page, with an arrow icon after it to show that it was coded with single bracket external link syntax, and thus may lead to another site.
+
!style="width:45%"|<!--T:34-->
</translate>
+
You type
 
+
!style="width:40%"|<!--T:35-->
<translate>Description</translate>
+
You get
<translate>You type</translate>
+
|-
<translate>You get</translate>
+
|<!--T:36-->
 
+
External link
<translate>External link</translate>
+
|<tt><nowiki>http://mediawiki.org</nowiki></tt>
http://mediawiki.org
+
|http://mediawiki.org
http://mediawiki.org
+
|-
 
+
|<!--T:37-->
<translate>External link with different label</translate>
+
External link with different label
[http://mediawiki.org MediaWiki]
+
|<tt><nowiki>[http://mediawiki.org MediaWiki]</nowiki></tt>
MediaWiki
+
|[http://mediawiki.org MediaWiki]
 
+
|-
<translate>Numbered external link</translate>
+
|<!--T:38-->
[http://mediawiki.org]
+
Numbered external link
 
+
|<tt><nowiki>[http://mediawiki.org]</nowiki></tt>
 
+
|[http://mediawiki.org]
<translate>External links with file icons</translate>
+
|-
 
+
|<!--T:39-->
 +
External links with file icons
 +
|<tt><nowiki>
 
[http://en.wikipedia.org/wiki/.avi video]
 
[http://en.wikipedia.org/wiki/.avi video]
 
[http://en.wikipedia.org/wiki/.ogg sound]
 
[http://en.wikipedia.org/wiki/.ogg sound]
 
[http://en.wikipedia.org/wiki/.pdf document]
 
[http://en.wikipedia.org/wiki/.pdf document]
 
+
</nowiki></tt>
<translate>
+
<small><!--T:40-->
See [[<tvar|external3>#External link icons</>]] for currently supported icons and extensions.</translate>
+
See [[<tvar|external3>#External link icons</>]] for currently supported icons and extensions.</small>
 
+
|
video
+
[http://en.wikipedia.org/wiki/.avi video]<br/>
sound
+
[http://en.wikipedia.org/wiki/.ogg sound]<br/>
document
+
[http://en.wikipedia.org/wiki/.pdf document]<br/>
 
+
|-
<translate>
+
|
Protocol relative external link (Will be http if the current site is http, https if the current site is https)</translate>
+
<!--T:75-->
 
+
Protocol relative external link (Will be http if the current site is http, https if the current site is https)
[//en.wikipedia.org wikipedia]
+
|<tt><nowiki>
 +
[//en.wikipedia.org wikipedia]</nowiki><br/><nowiki>
 +
[//en.wikipedia.org //en.wikipedia.org]
 +
</nowiki></tt>
 +
<small><!--T:76-->
 +
This is only supported inside <tt><nowiki>[ ]</nowiki></tt>. //en.wikipedia.org by itself does not make a link.</small>
 +
|
 +
[//en.wikipedia.org wikipedia]<br/>
 
[//en.wikipedia.org //en.wikipedia.org]
 
[//en.wikipedia.org //en.wikipedia.org]
 +
|-
 +
|<!--T:41-->
 +
External link to the same host
 +
|<tt><nowiki>http://{{SERVERNAME}}/pagename</nowiki></tt>
 +
|http://{{SERVERNAME}}/pagename
 +
|-
 +
|<!--T:42-->
 +
External link to other host passing the pagename
 +
|<tt><nowiki>http://google.com/search?q={{PAGENAMEE}}</nowiki></tt><br />
 +
See also: [[<tvar|encoded>Special:MyLanguage/Help:Magic_words#URL_encoded_page_names</>|URL encoded page names]], [[<tvar|PAGENAMEE>Special:MyLanguage/Manual:PAGENAMEE encoding</>|PAGENAMEE encoding]]
 +
|http://google.com/search?q={{PAGENAMEE}}
 +
|-
 +
|<!--T:43-->
 +
Mailto link
 +
|<tt><nowiki>[mailto:info@example.org email me]</nowiki></tt>
 +
|[mailto:info@example.org email me]
 +
|-
 +
|<!--T:44-->
 +
Mailto named with subject line and body
 +
|<tt><nowiki>[mailto:info@example.org?Subject=URL%20Encoded%20Subject&amp;body=Body%20Text info]</nowiki></tt>
 +
|[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
 +
|}
  
<translate>
+
{{Anchor|External-to-internal|External links to internal pages}}
This is only supported inside [ ]. //en.wikipedia.org by itself does not make a link.</translate>
+
  
wikipedia
+
=== External links to internal pages === <!--T:45-->
//en.wikipedia.org
+
  
<translate>External link to the same host</translate>
+
<!--T:46-->
http://{{SERVERNAME}}/pagename
+
To add a link to a page on the same wiki using [[w:URI scheme | URL query parameters]], you may need to use external link syntax.  
http://www.mediawiki.org/pagename
+
  
<translate>External link to other host passing the pagename</translate>
 
http://google.com/search?q={{PAGENAMEE}}
 
<translate>See also: [[<tvar|encoded>Special:MyLanguage/Help:Magic_words#URL_encoded_page_names</>|URL encoded page names]], [[<tvar|PAGENAMEE>Special:MyLanguage/Manual:PAGENAMEE encoding</>|PAGENAMEE encoding]]</translate>
 
http://google.com/search?q=Links
 
  
<translate>Mailto link</translate>
+
{| border="1" class="wikitable"
[mailto:info@example.org email me]
+
!<!--T:47-->
email me
+
Description
 +
!<!--T:48-->
 +
You type
 +
!<!--T:49-->
 +
You get
 +
|-
 +
|<!--T:50-->
 +
External link to the current page's edit page
 +
|<pre>[http://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page]</pre>
 +
|[http://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page]
 +
|-
 +
|<!--T:51-->
 +
External link to the current page's edit page using the [[<tvar|url-data>Special:MyLanguage/Help:Magic_words#URL_data</>|fullurl parser function]]
 +
|<pre>[{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page]</pre>
 +
<!--T:52-->
 +
See also [[<tvar|url-data>Special:MyLanguage/Help:Magic_words#URL_data</>|Help:Magic_words#URL_data]] and [[<tvar|external>#External links</>|#External links]]
 +
|[{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page]
 +
|-
 +
|<!--T:53-->
 +
External link to the current page's edit page, and styled to look like an internal link
 +
|<pre><span class="plainlinks">[http://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page]</span></pre>
 +
<!--T:54-->
 +
The [[Plainlinks | plainlinks class]] can be used in cases where you want an external link to look like an internal one, by suppressing the icon that normally appears after it.
 +
|<span class="plainlinks">[http://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page]</span>
 +
|}
  
<translate>Mailto named with subject line and body</translate>
+
{{anchor|External link icons}}
[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
+
info
+
  
 +
=== External link icons === <!--T:55-->
  
  
<translate>
+
{| class="wikitable"
External links to internal pages To add a link to a page on the same wiki using  URL query parameters, you may need to use external link syntax.  
+
! <!--T:56-->
</translate>
+
Test link !! <!--T:57-->
 +
Icon !! <!--T:58-->
 +
Trigger
 +
|-
 +
| [http://.] || [http://bits.wikimedia.org/skins-1.17/vector/images/external-link-ltr-icon.png external-link-ltr-icon.png] || <code>http://</code>, <code>gopher://</code>, <code>[//]</code>
 +
|-
 +
| [https://.] || [http://bits.wikimedia.org/skins-1.17/vector/images/lock-icon.png lock-icon.png] || <code>https://</code>
 +
|-
 +
| [mailto:.] || [http://bits.wikimedia.org/skins-1.17/vector/images/mail-icon.png mail-icon.png] || <code>mailto:</code>
 +
|-
 +
| [news://.] || [http://bits.wikimedia.org/skins-1.17/vector/images/news-icon.png news-icon.png] || <code>news<nowiki/>://</code>
 +
|-
 +
| [ftp://.] || [http://bits.wikimedia.org/skins-1.17/vector/images/file-icon.png file-icon.png] || <code>ftp://</code>
 +
|-
 +
| [irc://.] || [http://bits.wikimedia.org/skins-1.17/vector/images/talk-icon.png talk-icon.png] || <code>irc://</code>
 +
|-
 +
| [http://.ogg] || [http://bits.wikimedia.org/skins-1.17/vector/images/audio-icon.png audio-icon.png] || <code>.ogg</code>, <code>.mid</code>, <code>.midi</code>, <code>.mp3</code>, <code>.wav</code>, <code>.wma</code>
 +
|-
 +
| [http://.ogm] || [http://bits.wikimedia.org/skins-1.17/vector/images/video-icon.png video-icon.png] || <code>.ogm</code>, <code>.avi</code>, <code>.mpeg</code>, <code>.mpg</code>
 +
|-
 +
| [http://.pdf] || [http://bits.wikimedia.org/skins-1.17/vector/images/document-icon.png document-icon.png] || <code>.pdf</code>, <code>.pdf#</code>, <code>.pdf?</code>
 +
|}
  
  
<translate>Description</translate>
+
=== How to avoid auto-links === <!--T:59-->
<translate>You type</translate>
+
<translate>You get</translate>
+
  
<translate>External link to the current page's edit page</translate>
+
<!--T:60-->
[http://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page]
+
When you put a URL on a wiki page it will be automatically converted into an external link, like this:
Edit this page
+
  
<translate>External link to the current page's edit page using the [[<tvar|url-data>Special:MyLanguage/Help:Magic_words#URL_data</>|fullurl parser function]]</translate>
 
[{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page]
 
<translate>
 
See also [[<tvar|url-data>Special:MyLanguage/Help:Magic_words#URL_data</>|Help:Magic_words#URL_data]] and [[<tvar|external>#External links</>|#External links]]</translate>
 
Edit this page
 
  
<translate>External link to the current page's edit page, and styled to look like an internal link</translate>
+
http://mediawiki.org
<span class="plainlinks">[http://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page]</span>
+
<translate>
+
The  plainlinks class can be used in cases where you want an external link to look like an internal one, by suppressing the icon that normally appears after it.</translate>
+
Edit this page
+
  
  
 +
<!--T:61-->
 +
To avoid that effect, put the URL between <tvar|1><code>&lt;nowiki&gt;</code></> tags, like this:
  
<translate>
 
External link icons </translate>
 
  
 +
<pre>&lt;nowiki&gt;http://mediawiki.org&lt;/nowiki&gt;</pre>
  
<translate>
+
<!--T:62-->
Test link</translate>  <translate>
+
To get this:
Icon</translate>  <translate>Trigger</translate>
+
  
  external-link-ltr-icon.png  http://, gopher://, [//]
+
<nowiki>http://mediawiki.org</nowiki>
  
  lock-icon.png  https://
+
{{Anchor|Interwiki|Interwiki links}}
  
  mail-icon.png  mailto:
 
  
  news-icon.png  news://
+
== Interwiki links == <!--T:63-->
  
  file-icon.png  ftp://
+
<!--T:64-->
 +
Interwiki links are links with the internal link markup to a website registered in advance. For example, you can link to the article http://en.wikipedia.org/wiki/Sunflower by typing <code><nowiki>[[wikipedia:Sunflower]]</nowiki></code>, which will result in a link [[wikipedia:Sunflower]]. This is because <code><nowiki>http://en.wikipedia.org/wiki/</nowiki></code> is registered to your wiki by default with the prefix of <code>wikipedia</code>. (''This link may not work properly if the admin of your wiki has changed the setting.'') Unlike internal links, interwiki links do not use page existence detection, so an interwiki link will appear blue even if the page does not exist on the remote wiki.
  
  talk-icon.png  irc://
+
<!--T:65-->
 +
Similar to internal page links, you can create piped links, with alternate link label, e.g. <code><nowiki>[[wikipedia:Sunflower|big yellow flower]]</nowiki></code> is the link [[wikipedia:Sunflower|big yellow flower]] and <code><nowiki>[[wikipedia:Sunflower|]]</nowiki></code> is the link [[wikipedia:Sunflower|Sunflower]].
  
  audio-icon.png .ogg, .mid, .midi, .mp3, .wav, .wma
+
<!--T:66-->
 +
Basically, interwiki links are abbreviations for commonly used longer external links. A very similar link could be created as <code><nowiki>[http://en.wikipedia.org/wiki/Sunflower big yellow flower]</nowiki></code>.
  
  video-icon.png  .ogm, .avi, .mpeg, .mpg
+
<!--T:67-->
 +
More details are at [[<tvar|interwiki>Special:MyLanguage/Manual:Interwiki</>|Manual:Interwiki]] and [[m:Help:Interwiki linking]]. See the [https://git.wikimedia.org/blob/mediawiki%2Fcore//maintenance%2Finterwiki.list default interwiki prefixes]. To edit the [[<tvar|interwiki-table>Special:MyLanguage/Manual:Interwiki table</>|Manual:Interwiki table]] on your site, see the [[<tvar|ext-interwiki>Special:MyLanguage/Extension:Interwiki</>|Interwiki extension]].
  
  document-icon.png  .pdf, .pdf#, .pdf?
 
  
 +
{{anchor|Interlanguage links}}
  
<translate>
+
=== Interlanguage links === <!--T:68-->
How to avoid auto-links When you put a URL on a wiki page it will be automatically converted into an external link, like this:
+
</translate>
+
  
http://mediawiki.org
+
<!--T:69-->
 +
If your wiki has other language versions, you may find “interlanguage links” in the [[<tvar|sidebar>Special:MyLanguage/Help:Navigation#Sidebar</>|sidebar]], just below [[<tvar|toolbox>Special:MyLanguage/Help:Navigation#Toolbox</>|toolbox]] in the box named “{{lcfirst:{{int:otherlanguages}}}}.
  
<translate>
+
<!--T:70-->
 +
Interlanguage links behave similarly to interwiki links, except that they are listed in the sidebar. To create an interlanguage link from a page, just type <code><nowiki>[[</nowiki>''language prefix'':pagename]]</code> wherever you like in the page; the language prefix is the prefix specified at your wiki for the other language version (typically the [[wikipedia:List of ISO 639-1 codes|ISO 639-1 language code]]).
  
To avoid that effect, put the URL between <tvar|1><nowiki></> tags, like this:
+
<!--T:71-->
</translate>
+
If you want to make the interlanguage link appear in the content of the page rather than in the sidebar, you can add a colon before the language prefix:
 
+
:<code><nowiki>[[:en:Sunflower]]</nowiki></code> &rarr; '''[[:en:Sunflower]]'''
<nowiki>http://mediawiki.org</nowiki>
+
 
+
<translate>
+
To get this:</translate>
+
 
+
http://mediawiki.org
+
  
 +
<!--T:72-->
 +
When a link is both interwiki and interlanguage, the order is '''[[wikipedia:en:Sunflower]]'''.
  
<translate>
 
  
Interwiki links Interwiki links are links with the internal link markup to a website registered in advance. For example, you can link to the article http://en.wikipedia.org/wiki/Sunflower by typing [[wikipedia:Sunflower]], which will result in a link wikipedia:Sunflower. This is because http://en.wikipedia.org/wiki/ is registered to your wiki by default with the prefix of wikipedia. (This link may not work properly if the admin of your wiki has changed the setting.) Unlike internal links, interwiki links do not use page existence detection, so an interwiki link will appear blue even if the page does not exist on the remote wiki. Similar to internal page links, you can create piped links, with alternate link label, e.g. [[wikipedia:Sunflower|big yellow flower]] is the link big yellow flower and [[wikipedia:Sunflower|Sunflower]] is the link Sunflower.Basically, interwiki links are abbreviations for commonly used longer external links. A very similar link could be created as  [http://en.wikipedia.org/wiki/Sunflower big yellow flower].More details are at [[<tvar|interwiki>Special:MyLanguage/Manual:Interwiki</>|Manual:Interwiki]] and m:Help:Interwiki linking. See the default interwiki prefixes. To edit the [[<tvar|interwiki-table>Special:MyLanguage/Manual:Interwiki table</>|Manual:Interwiki table]] on your site, see the [[<tvar|ext-interwiki>Special:MyLanguage/Extension:Interwiki</>|Interwiki extension]].
+
{{anchor|See also}}
</translate>
+
  
 +
== See also == <!--T:73-->
  
<translate>
+
<!--T:74-->
Interlanguage links If your wiki has other language versions, you may find “interlanguage links” in the [[<tvar|sidebar>Special:MyLanguage/Help:Navigation#Sidebar</>|sidebar]], just below [[<tvar|toolbox>Special:MyLanguage/Help:Navigation#Toolbox</>|toolbox]] in the box named “.”Interlanguage links behave similarly to interwiki links, except that they are listed in the sidebar. To create an interlanguage link from a page, just type [[language prefix:pagename]] wherever you like in the page; the language prefix is the prefix specified at your wiki for the other language version (typically the ISO 639-1 language code).If you want to make the interlanguage link appear in the content of the page rather than in the sidebar, you can add a colon before the language prefix:
+
* [[<tvar|linked-images>Special:MyLanguage/Help:Linked images</>|Linked images]]
[[:en:Sunflower]] → en:SunflowerWhen a link is both interwiki and interlanguage, the order is wikipedia:en:Sunflower.
+
</translate>
+
  
  
<translate>
+
[[Category:Help{{langcat|Links}}|Links]]
See also  [[<tvar|linked-images>Special:MyLanguage/Help:Linked images</>|Linked images]]
+
[[Category:Link{{langcat|Links}}|Links]]
</translate>
+

Revision as of 22:52, 19 May 2014

There are five types of links in MediaWiki:

  1. [[<tvar|internal>#Internal links</>|Internal links]] to other pages in the wiki
  2. [[<tvar|external>#External links</>|External links]] to other websites
  3. [[<tvar|external2>#External links to internal pages</>|External links to internal pages]] in the wiki
  4. [[<tvar|interwiki>#Interwiki links</>|Interwiki links]] to other websites registered to the wiki in advance
  5. [[<tvar|interlang>#Interlanguage links</>|Interlanguage links]] to other websites registered as other language versions of the wiki

Template:Anchor

Internal links

To add an internal link, enclose the name of the page you want to link to in double square brackets. When you save the page, you'll see the new link pointing to your page. If the page exists already it is displayed in blue, if it does not, in red. Selflinks to the current page are not transformed in URLs but displayed in bold. (If you really want to link to the current page, use an anchor (see below), or [[#top|current page]] which always links to the top.)

The first letter of the target page is automatically capitalized, unless otherwise set by the admins, and spaces are represented as underscores (typing an underscore in the link will have a similar effect as typing a space, but is not recommended, since the underscore will also be shown in the text).


Description

You type

You get

Internal link

[[Main Page]]

[[Help:Contents]]

[[Extension:DynamicPageList (Wikimedia)]]
Main Page

Help:Contents

Extension:DynamicPageList (Wikimedia)

Piped link

[[Main Page|different text]]

See also [[<tvar|meta>meta:Special:MyLanguage/Help:Piped link</>|meta:Help:Piped link]]

different text
Pipe trick
[[Help:Contents|]]

[[User:John Doe|]]

[[Extension:DynamicPageList (Wikimedia)|]]

[[Extension:DynamicPageList (third-party)|]]

The pipe trick quickly makes shorter link text, but could be confusing in circumstances like the DynamicPageList link examples.

Contents

John Doe

DynamicPageList

DynamicPageList

Word-ending links, following so called "linktrail rules" localised per each language

[[Help]]s

[[Help]]ing

[[Help]]ers

[[Help]]almostanylettersyoulikehere

Helps

Helping

Helpers

Helpalmostanylettersyoulikehere

Avoiding word-ending links

[[Help]]<nowiki />ful advice

[[wikipedia:GNU General Public License|GPL]]<nowiki />v3

Helpful advice

GPLv3

Redirect

#REDIRECT [[Main Page]]

See also [[<tvar|redirects>Special:MyLanguage/Help:Redirects</>|Help:Redirects]]

Main Page

Internal link to an anchor

[[#See also]]

[[<tvar|formatting>Special:MyLanguage/Help:Formatting</>|Section headings]] and the top of the page are automatically anchored.

#See also

Internal link to an anchor from different text

[[#See also|different text]]
different text

Setting an internal link anchor

<div id="NameOfAnchorHere">optional text</div>

Omit the "optional text" for invisible anchor.

optional text

Internal link to an anchor at another page

[[Help:Images#Supported media types for images]]
Help:Images#Supported media types for images

Internal link to the current page's talk page

[[{{TALKPAGENAME}}|Discussion]]

See also [[<tvar|page-names>Special:MyLanguage/Help:Magic_words#Page_names</>|Help:Magic_words#Page_names]]

Discussion

Internal link to a subpage

[[/example]]

Shortcut for [[Help:Links/example|/example]]. See also [[<tvar|subpages>Special:MyLanguage/Help:Subpages</>|Help:Subpages]].

/example

Internal link to a subpage without the leading slash

[[/example/]]

Shortcut for [[Help:Links/example|example]].

example

Internal link to a category page

[[:Category:Help]]

See also [[<tvar|cat>Special:MyLanguage/Help:Categories</>|Help:Categories]]

Category:Help

Internal link to an image or a file of other types

[[media:example.jpg]]

[[media:example.pdf]]

See also [[<tvar|images>Special:MyLanguage/Help:Images</>|Help:Images]]

media:example.jpg

media:example.pdf

Internal link to the user's user page

[[Special:MyPage]]
Special:MyPage

Internal link to the user's talk page

[[Special:MyTalk]]
Special:MyTalk

Template:Anchor


External links

To add an external link, enclose the URL followed by space and the name of the page you want to link to in single square brackets. When you save the page, you'll see the new link pointing to your page, with an arrow icon after it to show that it was coded with single bracket external link syntax, and thus may lead to another site.

Description

You type

You get

External link

http://mediawiki.org http://mediawiki.org

External link with different label

[http://mediawiki.org MediaWiki] MediaWiki

Numbered external link

[http://mediawiki.org] [1]

External links with file icons

[http://en.wikipedia.org/wiki/.avi video] [http://en.wikipedia.org/wiki/.ogg sound] [http://en.wikipedia.org/wiki/.pdf document]

See [[<tvar|external3>#External link icons</>]] for currently supported icons and extensions.

video
sound
document

Protocol relative external link (Will be http if the current site is http, https if the current site is https)

[//en.wikipedia.org wikipedia]
[//en.wikipedia.org //en.wikipedia.org]

This is only supported inside [ ]. //en.wikipedia.org by itself does not make a link.

wikipedia
//en.wikipedia.org

External link to the same host

http://{{SERVERNAME}}/pagename http://imiss.dk/pagename

External link to other host passing the pagename

http://google.com/search?q={{PAGENAMEE}}

See also: [[<tvar|encoded>Special:MyLanguage/Help:Magic_words#URL_encoded_page_names</>|URL encoded page names]], [[<tvar|PAGENAMEE>Special:MyLanguage/Manual:PAGENAMEE encoding</>|PAGENAMEE encoding]]

http://google.com/search?q=Links

Mailto link

[mailto:info@example.org email me] email me

Mailto named with subject line and body

[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info] info

Template:Anchor

External links to internal pages

To add a link to a page on the same wiki using URL query parameters, you may need to use external link syntax.


Description

You type

You get

External link to the current page's edit page

[http://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page]
Edit this page

External link to the current page's edit page using the [[<tvar|url-data>Special:MyLanguage/Help:Magic_words#URL_data</>|fullurl parser function]]

[{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page]

See also [[<tvar|url-data>Special:MyLanguage/Help:Magic_words#URL_data</>|Help:Magic_words#URL_data]] and [[<tvar|external>#External links</>|#External links]]

Edit this page

External link to the current page's edit page, and styled to look like an internal link

<span class="plainlinks">[http://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page]</span>

The plainlinks class can be used in cases where you want an external link to look like an internal one, by suppressing the icon that normally appears after it.

Edit this page

Template:Anchor

External link icons

Test link !! Icon !! Trigger

[2] external-link-ltr-icon.png http://, gopher://, [//]
[3] lock-icon.png https://
[4] mail-icon.png mailto:
[5] news-icon.png news://
[6] file-icon.png ftp://
[7] talk-icon.png irc://
[8] audio-icon.png .ogg, .mid, .midi, .mp3, .wav, .wma
[9] video-icon.png .ogm, .avi, .mpeg, .mpg
[10] document-icon.png .pdf, .pdf#, .pdf?


How to avoid auto-links

When you put a URL on a wiki page it will be automatically converted into an external link, like this:


http://mediawiki.org


To avoid that effect, put the URL between <tvar|1><nowiki></> tags, like this:


<nowiki>http://mediawiki.org</nowiki>

To get this:

http://mediawiki.org

Template:Anchor


Interwiki links

Interwiki links are links with the internal link markup to a website registered in advance. For example, you can link to the article http://en.wikipedia.org/wiki/Sunflower by typing [[wikipedia:Sunflower]], which will result in a link wikipedia:Sunflower. This is because http://en.wikipedia.org/wiki/ is registered to your wiki by default with the prefix of wikipedia. (This link may not work properly if the admin of your wiki has changed the setting.) Unlike internal links, interwiki links do not use page existence detection, so an interwiki link will appear blue even if the page does not exist on the remote wiki.

Similar to internal page links, you can create piped links, with alternate link label, e.g. [[wikipedia:Sunflower|big yellow flower]] is the link big yellow flower and [[wikipedia:Sunflower|]] is the link Sunflower.

Basically, interwiki links are abbreviations for commonly used longer external links. A very similar link could be created as [http://en.wikipedia.org/wiki/Sunflower big yellow flower].

More details are at [[<tvar|interwiki>Special:MyLanguage/Manual:Interwiki</>|Manual:Interwiki]] and m:Help:Interwiki linking. See the default interwiki prefixes. To edit the [[<tvar|interwiki-table>Special:MyLanguage/Manual:Interwiki table</>|Manual:Interwiki table]] on your site, see the [[<tvar|ext-interwiki>Special:MyLanguage/Extension:Interwiki</>|Interwiki extension]].


Template:Anchor

Interlanguage links

If your wiki has other language versions, you may find “interlanguage links” in the [[<tvar|sidebar>Special:MyLanguage/Help:Navigation#Sidebar</>|sidebar]], just below [[<tvar|toolbox>Special:MyLanguage/Help:Navigation#Toolbox</>|toolbox]] in the box named “in other languages.”

Interlanguage links behave similarly to interwiki links, except that they are listed in the sidebar. To create an interlanguage link from a page, just type [[language prefix:pagename]] wherever you like in the page; the language prefix is the prefix specified at your wiki for the other language version (typically the ISO 639-1 language code).

If you want to make the interlanguage link appear in the content of the page rather than in the sidebar, you can add a colon before the language prefix:

[[:en:Sunflower]]en:Sunflower

When a link is both interwiki and interlanguage, the order is wikipedia:en:Sunflower.


Template:Anchor

See also

  • [[<tvar|linked-images>Special:MyLanguage/Help:Linked images</>|Linked images]]


[[Category:HelpTemplate:Langcat|Links]] [[Category:LinkTemplate:Langcat|Links]]