Help:Links: Difference between revisions
translation tweaks |
Marked this version for translation |
||
Line 386: | Line 386: | ||
Interlanguage links behave similarly to interwiki links (or [[Categorylinks|category links]]), except that they appear as a list in the sidebar and not within the content of the page (or below it in the categories bar). To create an interlanguage link to the corresponding page in another language, type <code><nowiki>[[</nowiki>''language prefix'':pagename]]</code> anywhere in the page (preferably at the bottom, like category links); 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]]).</translate> |
Interlanguage links behave similarly to interwiki links (or [[Categorylinks|category links]]), except that they appear as a list in the sidebar and not within the content of the page (or below it in the categories bar). To create an interlanguage link to the corresponding page in another language, type <code><nowiki>[[</nowiki>''language prefix'':pagename]]</code> anywhere in the page (preferably at the bottom, like category links); 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]]).</translate> |
||
<translate> |
<translate> |
||
<!--T:83--> |
|||
The interlanguage link is unilateral, it does not point back from that page in the other language.</translate> |
The interlanguage link is unilateral, it does not point back from that page in the other language.</translate> |
||
<translate> |
<translate> |
||
<!--T:84--> |
|||
For that purpose, an equivalent back-link needs to be placed there as well.</translate> |
For that purpose, an equivalent back-link needs to be placed there as well.</translate> |
||
<translate> |
<translate> |
||
<!--T:85--> |
|||
It does not work like the "Edit links" in the languages section of Wikipedia-language versions.</translate> |
It does not work like the "Edit links" in the languages section of Wikipedia-language versions.</translate> |
||
<translate> |
<translate> |
||
<!--T:86--> |
|||
But it can be used across all name spaces, including 'User:' to point to ones other profiles in other languages. |
But it can be used across all name spaces, including 'User:' to point to ones other profiles in other languages. |
||
Revision as of 23:52, 11 February 2017
Note: When you edit this page, you agree to release your contribution under the CC0. See Public Domain Help Pages for more info. |
There are five types of links in MediaWiki:
- Internal links to other pages in the wiki
- External links to other websites
- External links to internal pages in the wiki
- Interwiki links to other websites registered to the wiki in advance
- Interlanguage links to other websites registered as other language versions of the wiki
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 the link is displayed in blue; if it does not exist it appears red (unless the color scheme of the wiki has been changed from the default). Links to the current page title ("selflinks") do not result in live links but are displayed in bold. (If you really want to link to the current page, you probably want to link to a specific section or to an anchor; see examples below.)
The first letter of the target page is usually case-insensitive, unless configured otherwise by wiki admins, meaning links can be capitalized or not. The case of every subsequent letter must match exactly. Spaces in the page title may be represented as underscores (i.e., typing an underscore in a link will have the same effect as typing a space), but using underscores in links is not recommended since they will be visible in the page text (this can be prevented by using a pipe; again, examples are shown below).
Description | You type | You get |
---|---|---|
Internal link | [[Main Page]] [[Help:Contents]] [[Extension:DynamicPageList (Wikimedia)]] |
Main Page |
Piped link | [[Help:Editing pages|editing help]] [[Help:Editing pages#Preview|previewing]] See also meta:Help:Piped link |
editing help |
Pipe trick | [[Manual:Extensions|]] [[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. |
Extensions |
Word-ending links | [[Help]]s [[Help]]ing [[Help]]ers [[Help]]almostanylettersyoulikehere Follows so called "linktrail rules" localised per each language. |
|
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 Help:Redirects |
→ Main Page |
Internal link to an anchor | [[#See also]] 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="Unique anchor name 1">optional text</div> <span id="Unique anchor name 2">optional text</span> Rendered block-level and inline, respectively. Omit the "optional text" for an invisible anchor. |
optional text
optional text |
Setting an anchor in a section heading |
==<span id="Alternate Section Title"></span>Section heading== Note the placement; this must be a "span" tag. (Used to avoid breaking incoming links when a section is retitled.) |
|
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 Help:Magic words#Page names |
Discussion |
Internal link to a subpage | [[/example]] Shortcut for |
/example |
Internal link to a subpage without the leading slash | [[/example/]] Shortcut for |
example |
Internal link to a category page | [[:Category:Help]] See also Help:Categories |
Category:Help |
Internal link to an image or media file without displaying the file contents | [[:File:example.jpg]] [[:File:example.jpg|this example]] [[media:example.jpg]] See also Help:Images. Note that using the "media:" prefix links directly to the uploaded file. |
|
Internal link to the reader's own user page | [[Special:MyPage]] |
Special:MyPage |
Internal link to the reader's own talk page | [[Special:MyTalk]] |
Special:MyTalk |
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 | https://mediawiki.org URLs beginning with "http://" and "https://" are automatically linked. To prevent this, see How to avoid auto-links below. |
https://mediawiki.org |
External link with different label | [https://mediawiki.org MediaWiki] |
MediaWiki |
Numbered external link | [https://mediawiki.org] |
[1] |
External links with file icons | [https://en.wikipedia.org/wiki/.avi video] [https://en.wikipedia.org/wiki/.ogg sound] [https://en.wikipedia.org/wiki/.pdf document] See #External link icons for currently supported icons and extensions. |
|
Protocol-relative external link | [//en.wikipedia.org Wikipedia] [//en.wikipedia.org //en.wikipedia.org] The link will be HTTP or HTTPS depending on the protocol of the current page. This is only supported inside square brackets [ ]. Note that //en.wikipedia.org by itself does not make a link. |
|
External link to the same host | https://{{SERVERNAME}}/pagename |
https://www.mediawiki.org/pagename |
External link to other host passing the pagename | https://google.com/search?q={{PAGENAMEE}} See also: URL encoded page names, PAGENAMEE encoding |
https://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 |
Custom URI | [skype:echo123 call me] Any URI you wish to add needs to be first declared through $wgUrlProtocols . |
[skype:echo123 call me]
(Disabled on mediawiki.org) |
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 | [https://www.mediawiki.org/w/index.php?title=Help:Links&action=edit Edit this page] [{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page] See also Help:Magic_words#URL_data and External links above. |
Edit this page |
External link to the current page's edit page, and styled to look like an internal link | <span class="plainlinks">[https://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 |
External link icons
Some MediaWiki installations are set up to use special icons to denote external links to specific file types or using specific protocols. None of these special icons are enabled here on MediaWiki.org, but we present them here for the sake of completeness.
Test link | Icon | Trigger |
---|---|---|
[2] | http:// , gopher:// , [//]
| |
[3] | https://
| |
[4] | mailto:
| |
[5] | news://
| |
[6] | ftp://
| |
[7] | irc://
| |
[8] | .ogg , .mid , .midi , .mp3 , .wav , .wma
| |
[9] | .ogm , .avi , .mpeg , .mpg
| |
[10] | .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:
To avoid that effect, put the URL between <nowiki>
tags, like this:
<nowiki>https://mediawiki.org</nowiki>
To get this:
https://mediawiki.org
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 works because by default MediaWiki configures wikipedia:
as an "interwiki prefix" that turns into http://en.wikipedia.org/wiki/ when used inside [[ ]]. (It may not work 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 Manual:Interwiki and m:Help:Interwiki linking. Your wiki may have a Special:Interwiki page listing the interwiki prefixes it supports; here is the default interwiki list. You can edit the Manual:Interwiki table on your site.
Interlanguage links
If your wiki has other language versions, you may find “interlanguage links” in the sidebar, just below toolbox in a section titled “in other languages.”
Interlanguage links behave similarly to interwiki links (or category links), except that they appear as a list in the sidebar and not within the content of the page (or below it in the categories bar). To create an interlanguage link to the corresponding page in another language, type [[language prefix:pagename]]
anywhere in the page (preferably at the bottom, like category links); the language prefix is the prefix specified at your wiki for the other language version (typically the ISO 639-1 language code).
The interlanguage link is unilateral, it does not point back from that page in the other language.
For that purpose, an equivalent back-link needs to be placed there as well.
It does not work like the "Edit links" in the languages section of Wikipedia-language versions.
But it can be used across all name spaces, including 'User:' to point to ones other profiles in other languages.
If you want to make the interlanguage link appear at a specific place in the content of the page rather than in the sidebar, 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.
For more information, see m:Help:Interlanguage link.
See also
[[Category:HelpTemplate:Translation|Links]] [[Category:LinkTemplate:Translation|Links]]