Banri: /* Internal links */

2021-01-14T11:22:55Z

Internal links

← Older revision		Revision as of 11:22, 14 January 2021
Line 336:		Line 336:

	Any URI you wish to add needs to be first declared through [[mw:Manual:$wgUrlProtocols\|$wgUrlProtocols]] by a sysadmin.		Any URI you wish to add needs to be first declared through [[mw:Manual:$wgUrlProtocols\|$wgUrlProtocols]] by a sysadmin.
	(This example is not enabled on ~~RuneScape.~~wiki)		(This example is not enabled on GeminiStation wiki)
	\|[skype:echo123 call me]		\|[skype:echo123 call me]
	\|}		\|}
Line 350:		Line 350:
	\|External link to the current page's edit page		\|External link to the current page's edit page
	\|<pre>		\|<pre>
	[https://~~runescape~~.~~wiki~~/index.php?title=Help:Links&action=edit Edit this page]		[https://wiki.geministation.com/index.php?title=Help:Links&action=edit Edit this page]

	[{{fullurl:{{FULLPAGENAME}}\|action=edit}} Edit this page]		[{{fullurl:{{FULLPAGENAME}}\|action=edit}} Edit this page]
Line 357:		Line 357:
	See also [[Help:Magic_words#URL_data\|Help:Magic_words#URL_data]] and [[#External links\|External links]] above.		See also [[Help:Magic_words#URL_data\|Help:Magic_words#URL_data]] and [[#External links\|External links]] above.
	\|		\|
	[https://~~runescape~~.~~wiki~~/index.php?title=Help:Links&action=edit Edit this page]		[https://wiki.geministation.com/index.php?title=Help:Links&action=edit Edit this page]

	[{{fullurl:{{FULLPAGENAME}}\|action=edit}} Edit this page]		[{{fullurl:{{FULLPAGENAME}}\|action=edit}} Edit this page]
Line 363:		Line 363:
	\|-		\|-
	\|External link to the current page's edit page, and styled to look like an internal link		\|External link to the current page's edit page, and styled to look like an internal link
	\|<pre><span class="plainlinks">[https://~~runescape~~.~~wiki~~/index.php?title=Help:Links&action=edit Edit this page]</span></pre>		\|<pre><span class="plainlinks">[https://wiki.geministation.com/index.php?title=Help:Links&action=edit Edit this page]</span></pre>

	The [[mw: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.		The [[mw: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">[https://~~runescape~~.~~wiki~~/index.php?title=Help:Links&action=edit Edit this page]</span>		\|<span class="plainlinks">[https://wiki.geministation.com/index.php?title=Help:Links&action=edit Edit this page]</span>
	\|}		\|}

Banri: Created page with "{{Construction}} There are five types of hypertext links in MediaWiki: # '''Internal links''' to other pages in the same wiki (commonly called "wikilink..."

2021-01-14T08:15:21Z

Created page with "{{Construction}} There are five types of hypertext links in MediaWiki: # '''Internal links''' to other pages in the same wiki (commonly called "wikilink..."

New page

{{Construction}}

There are five types of hypertext links in MediaWiki:

# '''[[#Internal links|Internal links]]''' to other pages in the same wiki (commonly called "wikilinks")
# '''[[#External links|External links]]''' to pages at other websites
# '''[[#External links to internal pages|External links to internal pages]]''' in the same wiki
# '''[[#Interwiki links|Interwiki links]]''' to other websites using special prefixes registered in advance

Please note that this list does not include [[Help:Categories|category links]] and [[Help:Images|file links]], which are used to place pages into categories and display images or other media files, respectively.
__TOC__

==Internal links==
To [[Help:Editing|create]] a so-called internal link to a page on the same wiki (a "wikilink"), use double square brackets wiki markup, <code><nowiki>[[like this]]</nowiki></code>. When you preview or save your changes, you will see a link that can be followed to the target page. If the page exists the link is displayed in blue (like the word "create" in the first sentence of this paragraph); if the page does not exist, the link appears red (so the <code><nowiki>[[like this]]</nowiki></code> link is actually rendered [[like this]]). Note that the colors could be different if the color scheme of the wiki has been changed from the default. Following such a "redlink" to a missing page (whether or not it is actually red) will usually enable the user to create the page.

To markup any arbitrary string of text (not necessarily a page title) as a link, use a "vertical bar" or "pipe" character, like this: <code><nowiki>[[Help:Categories|category links]]</nowiki></code> results in the link [[Help:Categories|category links]].

The first letter of the link target is usually not case-sensitive (unless the wiki is configured otherwise), meaning links can be capitalized or not (so [[Eris Ice]] and [[eris ice]] are equivalent). However, the case of every ''subsequent'' letter must match the target page exactly (so [[Eris Ice]] and [[Eris Ice]] are ''not'' equivalent). Spaces in the page title may be represented as underscores (so [[Eris Ice]] and [[Eris_Ice]] are again equivalent), but using underscores in links will make them visible in the page text (but this can be prevented by using a "pipe").

If the page title you are linking to is that of the page you are editing, the result is not a hyperlink at all but simply bold text (for example, on this page the markup <code><nowiki>[[</nowiki>{{FULLPAGENAME}}]]</code> gives the result [[{{FULLPAGENAME}}]]). If you're trying to create a wikilink to the current page, you probably want to link to a specific ''section'' or to an ''anchor'' within the page; see the examples below.

MediaWiki uses the [[mw:Manual:Pagelinks table|pagelinks database table]] to keep track of internal wikilinks.

{| border="1" class="wikitable"
!Name/Description
!Syntax
!Result
|-
|Internal link
|<pre>
[[Main Page]]

[[Help:Contents]]

[[GSWiki:About]]
</pre>
|
[[Main Page]]

[[Help:Contents]]

[[GSWiki:About]]
|-
|Piped link
|
<pre>[[Help:Editing|editing help]]</pre>

Links to a section/anchor within the target page.
<pre>[[Help:Editing#Advanced_guides|advanced guides]]</pre>

Piped link to an anchor on the same page
<pre>[[#See also|different text]]</pre>

See also [[wikipedia:Help:Pipe trick|Help:Piped link]].
|

[[Help:Editing|editing help]]

[[Help:Editing#Advanced_guides|advanced guides]]

[[#See also|different text]]

|-
|[[wikipedia:Help:Pipe trick|Pipe trick]]
|<pre>
[[Manual:Extensions|]]

[[User:John Doe|]]

[[Extension:DynamicPageList (Wikimedia)|]]

[[Extension:DynamicPageList (third-party)|]]
</pre>
The pipe trick involves less typing for editors, but is potentially confusing to readers.
|
[[Help:Editing|Editing]]

[[User:Banri|Banri]]

|-
|<span id="linktrail"></span>Word-ending links
|<pre>
[[Help]]s

[[Help]]ing

[[Help]]ers

[[Help]]almostanylettersyoulikehere

[[Help]]BUTnotalways
</pre>
Follows so-called "linktrail rules" [[mw:Localisation|localised]] per [[mw:Manual:MediaWiki_architecture#Localizing_messages|each language]].
|
[[Help]]s

[[Help]]ing

[[Help]]ers

[[Help]]almostanylettersyoulikehere

[[Help]]BUTnotalways

|-
|Avoiding word-ending links
|<pre>
[[Help]]<nowiki />full advice

[[wikipedia:GNU General Public License|GPL]]<nowiki />v3
</pre>
|
[[Help]]<nowiki />ful advice

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

|-
|Link to an anchor on the same page
|<pre>[[#See also]]</pre>
Anchors are provided automatically on [[Help:Formatting|section headings]] and to the [[#top|top]] of the page.
|[[#See also]]

|-
|Setting an anchor for incoming links
|<pre>
<div id="Unique anchor name 1">optional text</div>

<span id="Unique anchor name 2">optional text</span>
</pre>

Rendered [[wikipedia:HTML element#Document body elements|block-level and inline]], respectively.
Doing this would allow for <code><nowiki>[[#Unique anchor name 1]]</nowiki></code> on the same page or <code><nowiki>[[</nowiki>{{FULLPAGENAME}}#Unique anchor name 1]]</code> on a different page.
Omit the "optional text" for an invisible anchor.

Setting an anchor in a section heading
<pre>==<span id="Alternate Section Title"></span>Section heading==</pre>
Note the placement.
This must be a "span" tag, not a "div".
(Such anchors allow sections to be retitled without breaking incoming links.)

|
<div id="Unique anchor name 1">optional text</div>

<span id="Unique anchor name 2">optional text</span>

<div style="color: #000000; background: none; overflow: hidden; page-break-after: avoid; font-size: 1.5em; font-family: Georgia,Times,serif; margin-top: 1em; margin-bottom: 0.25em; line-height: 1.3; padding: 0; border-bottom: 1px solid #AAAAAA;"><span id="Alternate Section Title"></span>Section heading</div>

|-
|Link to an anchor at another page
|<pre>[[Help:Editing#Community]]</pre>
|[[Help:Editing#Community]]
|-
|Link to the current page's talk page
|<pre>[[{{TALKPAGENAME}}|Discussion]]</pre>
See also [[Help:Magic_words#Page_names|Help:Magic words#Page names]]
|[[{{TALKPAGENAME}}|Discussion]]
|-
|{{anchor|Subpage_feature}} Link to a subpage
|<pre>[[/example]]</pre>
Shortcut for <code><nowiki>[[Help:Links/example|/example]]</nowiki></code>. See also [[Help:Subpages]].
|[[/example|/example]]
|-
|Link to a subpage without the leading slash
|<pre>[[/example/]]</pre>
Shortcut for <code><nowiki>[[Help:Links/example|example]]</nowiki></code>.
|[[/example/]]
|-
|Link to a subpage of parent page for current page. Can only be used on subpages.
|<pre>[[../example2]]</pre>
Shortcut for <code><nowiki>[[Help:Links/example2|example2]]</nowiki></code> if you post the link on <code><nowiki>[[Help:Links/example|example]]</nowiki></code> page.
|[[Help:Links/example2|example2]]
|-
|Visible link to a category page
|<pre>[[:Category:Help]]</pre>
Without the leading colon the link would not be visible and the page would instead be placed into the category; this is a very common mistake.
See also [[Help:Categories|Help:Categories]].
|[[:Category:Help]]
|-
|Visible link to an image or media file
|id="file-links"|<pre>
[[:File:Weird gloop.png]]

[[:File:Weird gloop.png|this example]]

[[Media:Weird gloop.png]]
</pre>

Without the leading colon on the "File:" examples, the images would actually be displayed.
See also [[Help:Images]].

The <code>Media:</code> prefix is used to link directly to the uploaded file, rather than the file-information page.
|
[[:File:Earth Icon.png]]

[[:File:Earth Icon.png|this example]]

[[Media:Earth Icon.png]]

|-
|Link to a page specific to each reader (user page, etc.)
|<pre>
[[Special:MyPage]]

[[Special:MyTalk]]

[[Special:Preferences]]
</pre>
|
[[Special:MyPage]]

[[Special:MyTalk]]

[[Special:Preferences]]

|-
|Internal link to a specific revision
|<pre>[[Special:PermanentLink/34458114]]</pre>
Revision numbers can be found in each page's [[Help:History|edit history]].
(It is very common to see links to specific revisions implemented as external links because it's easy to cut-and-paste an entire URL to form an external link.)
|[[Special:PermanentLink/34458114]]
|-
|Internal link to a "diff"
|<pre>
[[Special:Diff/34458114]]

[[Special:Diff/7178134/34458114]]
</pre>
The default (in the first example above) is to show the changes from the previous revision.
See also the comments in the previous item.
|
[[Special:Diff/34458114]]

[[Special:Diff/7178134/34458114]]
|-
|Redirect
|<pre>#REDIRECT [[Main Page]]</pre>
Should be the first ''and only'' line on the page.
See [[Help:Redirects|Help:Redirects]].
| [[File:Redirect arrow without text (cropped).svg]] [[Main Page]]

|}

==External links==
To [[Help:Editing|create]] an external link, usually to a page at a different website, enclose the URL followed by space and the link text in single square brackets (see examples below). When you save or preview the page, you will see a link rendered slightly differently than an internal wikilink. It may be a different color and/or be followed by an arrow icon to show that it may lead to another site.

{| class="wikitable"
!style="width:15%"|Description
!style="width:45%"|You type
!style="width:40%"|You get
|-
|External link with specified link text
| <pre>[https://mediawiki.org MediaWiki]</pre>
| [https://mediawiki.org MediaWiki]
|-
| Numbered external link
| <pre>[https://mediawiki.org]</pre>
This is what happens if you omit the link text.
Multiple links of this type on the same page are numbered sequentially.
|[https://mediawiki.org]
|-
|Bare external link
|<pre>https://mediawiki.org</pre>
URLs beginning with "<code>http://</code>" and "<code>https://</code>" are automatically linked, even when no brackets are used.
|https://mediawiki.org
|-
|<span id="How to avoid auto-links">Avoiding auto-linked URLs</span>
|<pre><nowiki>https://mediawiki.org</nowiki></pre>
|<nowiki>https://mediawiki.org</nowiki>
|-
|
[[wikipedia:Protocol-relative URL|Protocol-relative]] external link
|<pre>
[//en.wikipedia.org Wikipedia]

[//en.wikipedia.org //en.wikipedia.org]
</pre>
The link will be HTTP or HTTPS depending on the protocol of the page currently being viewed (which could be different for different users).
This is only supported inside of square brackets <code><nowiki>[ ]</nowiki></code>.
Using "<code>//en.wikipedia.org</code>" by itself ''does not'' result in a link.
|
[//en.wikipedia.org Wikipedia]

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

|-
|External link to the current server
|<pre>https://{{SERVERNAME}}/pagename</pre>
|https://{{SERVERNAME}}/pagename

|-
|External link to other host passing the pagename
|<pre>https://google.com/search?q={{PAGENAMEE}}</pre>
See also: [[Help:Magic_words#URL_encoded_page_names|URL encoded page names]], [[mw:Manual:PAGENAMEE_encoding|PAGENAMEE encoding]]
|https://google.com/search?q=Links

|-
|Mailto link
|<pre>[mailto:info@example.org email me]</pre>
|[mailto:info@example.org email me]

|-
|Mailto named with subject line and body
|<pre>[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</pre>
|[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]

|-
|Custom UR
|<pre>[skype:echo123 call me]</pre>

Any URI you wish to add needs to be first declared through [[mw:Manual:$wgUrlProtocols|$wgUrlProtocols]] by a sysadmin.
(This example is not enabled on RuneScape.wiki)
|[skype:echo123 call me]
|}

=== External links to internal pages ===
To add a link to a page on the same wiki using [[wikipedia:URI scheme|URL query parameters]], you may need to use external link syntax.

{| border="1" class="wikitable"
!Description
!You type
!You get
|-
|External link to the current page's edit page
|<pre>
[https://runescape.wiki/index.php?title=Help:Links&action=edit Edit this page]

[{{fullurl:{{FULLPAGENAME}}|action=edit}} Edit this page]
</pre>

See also [[Help:Magic_words#URL_data|Help:Magic_words#URL_data]] and [[#External links|External links]] above.
|
[https://runescape.wiki/index.php?title=Help:Links&action=edit Edit this page]

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

|-
|External link to the current page's edit page, and styled to look like an internal link
|<pre><span class="plainlinks">[https://runescape.wiki/index.php?title=Help:Links&action=edit Edit this page]</span></pre>

The [[mw: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">[https://runescape.wiki/index.php?title=Help:Links&action=edit Edit this page]</span>
|}

==Interwiki links==
{{main|Help:Interlanguage links}}
Interwiki links are internal-style links to other websites (which do not have to be wikis, despite the name). For example, you can link to the article https://en.wikipedia.org/wiki/Sunflower by typing <code><nowiki>[[wikipedia:Sunflower]]</nowiki></code> or, on this wiki, the shorter <code><nowiki>[[w:Sunflower]]</nowiki></code>. Both will result in a link [[wikipedia:Sunflower]]. 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. <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]].

More details are at [[Help:Interlanguage links|Help:Interlanguage links]] and a list of all prefixes can be found at [[Special:Interwiki]].

== Limits ==
An internal wiki link is limited by maximum [[mw:page title|page title]] size.

== See also ==
* [[mw:Manual:Linked images|Manual:Linked images]]
* [[mw:Help:Links|Help:Links]] on MediaWiki
* [[wikipedia:Help:Link|Help:Link]] on Wikipedia

{{Help}}

Help:Links - Revision history

Banri: /* Internal links */

Banri: Created page with "{{Construction}} There are five types of hypertext links in MediaWiki: # '''Internal links''' to other pages in the same wiki (commonly called "wikilink..."