Help:Links

From FamilySearch Wiki

(Difference between revisions)
(cat)
Line 1: Line 1:
{{PD Help Page}}
+
{{PD Help Page}}  
 +
 
 +
<br>{{Contributor Help badge}}<br><br>
 +
 
 
There are four sorts of links in MediaWiki:  
 
There are four sorts of links in MediaWiki:  
# '''[[#Internal links|internal links]]''' to other pages in the wiki
 
# '''[[#External links|external links]]''' to other websites
 
# '''[[#Interwiki links|interwiki links]]''' to other websites registered to the wiki in advance
 
# '''[[#Interlanguage links|Interlanguage links]]''' to other websites registered as other language versions of the wiki
 
  
== Internal links ==
+
#'''[[#Internal_links|internal links]]''' to other pages in the wiki
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.
+
#'''[[#External_links|external links]]''' to other websites
Selflinks to the current page are not transformed in URLs but displayed in bold.
+
#'''[[#Interwiki_links|interwiki links]]''' to other websites registered to the wiki in advance
(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.)
+
#'''[[#Interlanguage_links|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 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 <nowiki>[[#top|current page]]</nowiki> 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).
+
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"
+
{| class="wikitable" border="1"
!Description
+
!You type
+
!You get
+
 
|-
 
|-
|Internal link
+
! Description
|<pre>[[Main Page]]</pre>
+
! You type
|[[Main Page]]
+
! You get
 
|-
 
|-
|Piped link  
+
| Internal link  
|<pre>[[Main Page|different text]]</pre>
+
| <pre>[[Main Page]]</pre>
|[[Main Page|different text]]
+
| [[Main Page]]
 
|-
 
|-
|Shortened sort-of-piped link  
+
| Piped link  
|<pre>[[Internationalisation]]s</pre>
+
| <pre>[[Main Page|different text]]</pre>
|[[Internationalisation]]s
+
| [[Main Page|different text]]
 
|-
 
|-
|Redirect
+
| Shortened sort-of-piped link
|<pre>#REDIRECT [[Main Page]]</pre>
+
| <pre>[[Internationalisation]]s</pre>
 +
| [[Internationalisation]]s
 +
|-
 +
| Redirect  
 +
| <pre>#REDIRECT [[Main Page]]</pre>
 
See also [[Help:Redirects]]
 
See also [[Help:Redirects]]
| &rarr; [[Main Page]]
+
 
 +
| [[Main Page]]
 
|-
 
|-
|Internal link to an anchor
+
| Internal link to an anchor  
|<pre>[[#See also]]</pre>
+
| <pre>[[#See also]]</pre>
 
[[Help:Formatting|Section headings]] and the [[#top|top]] of the page are automatically anchored.
 
[[Help:Formatting|Section headings]] and the [[#top|top]] of the page are automatically anchored.
|[[#See also]]
+
 
 +
| [[#See_also]]
 
|-
 
|-
|Internal link to an anchor at another page
+
| Internal link to an anchor at another page  
|<pre>[[Help:Images#See also]]</pre>
+
| <pre>[[Help:Images#See also]]</pre>
|[[Help:Images#See also]]
+
| [[Help:Images#See_also]]
 
|-
 
|-
|Internal link to the current page's talk page
+
| Internal link to the current page's talk page  
|<pre>[[{{TALKPAGENAME}}|Discussion]]</pre>
+
| <pre>[[{{TALKPAGENAME}}|Discussion]]</pre>
See also [[Help:Magic_words#Page_names]]
+
See also [[Help:Magic words#Page_names]]
|[[{{TALKPAGENAME}}|Discussion]]
+
 
 +
| [[{{TALKPAGENAME}}|Discussion]]
 
|-
 
|-
|Internal link to a subpage
+
| Internal link to a subpage  
|<pre>[[/example]]</pre>
+
| <pre>[[/example]]</pre>
 
Shortcut for <nowiki>[[Help:Links/example]]</nowiki>. See also [[Help:Subpages]].
 
Shortcut for <nowiki>[[Help:Links/example]]</nowiki>. See also [[Help:Subpages]].
|[[/example]]
+
 
 +
| [[/example]]
 
|-
 
|-
|Internal link to a category page
+
| Internal link to a category page  
|<pre>[[:Category:Help]]</pre>
+
| <pre>[[:Category:Help]]</pre>
 
See also [[Help:Categories]]
 
See also [[Help:Categories]]
|[[:Category:Help]]
+
 
 +
| [[:Category:Help]]
 
|-
 
|-
|Internal link to an image or a file of other types
+
| Internal link to an image or a file of other types  
|<pre>[[media:example.jpg]]
+
| <pre>[[media:example.jpg]]
  
 
[[media:example.pdf]]</pre>
 
[[media:example.pdf]]</pre>
 
See also [[Help:Images]]
 
See also [[Help:Images]]
|[[media:example.jpg]]
 
  
[[media:example.pdf]]
+
| [[Media:Example.jpg]]
 +
[[Media:Example.pdf]]
 +
 
 
|}
 
|}
  
== External links ==
+
== External links ==
{| border="1" class="wikitable"
+
 
!style="width:15%"|Description
+
{| class="wikitable" border="1"
!style="width:45%"|You type
+
!style="width:40%"|You get
+
 
|-
 
|-
|External link
+
! style="width: 15%" | Description
|<pre>http://mediawiki.org</pre>
+
! style="width: 45%" | You type
|http://mediawiki.org
+
! style="width: 40%" | You get
 
|-
 
|-
|External link with different label
+
| External link  
|<pre>[http://mediawiki.org MediaWiki]</pre>
+
| <pre>http://mediawiki.org</pre>
|[http://mediawiki.org MediaWiki]
+
| http://mediawiki.org
 
|-
 
|-
|External link numbered
+
| External link with different label
|<pre>[http://mediawiki.org]</pre>
+
| <pre>[http://mediawiki.org MediaWiki]</pre>
|[http://mediawiki.org]
+
| [http://mediawiki.org MediaWiki]
 
|-
 
|-
|External link icons
+
| External link numbered
|<pre>
+
| <pre>[http://mediawiki.org]</pre>
[http://en.wikipedia.org/wiki/.avi video]
+
| [http://mediawiki.org]
 +
|-
 +
| External link icons
 +
| <pre>[http://en.wikipedia.org/wiki/.avi video]
 
[http://en.wikipedia.org/wiki/.wav sound]
 
[http://en.wikipedia.org/wiki/.wav sound]
 
[http://en.wikipedia.org/wiki/.pdf document]
 
[http://en.wikipedia.org/wiki/.pdf document]
 
</pre>
 
</pre>
 
External link icons may differ depending on the file type of the target.
 
External link icons may differ depending on the file type of the target.
|
+
 
[http://en.wikipedia.org/wiki/.avi video]
+
|  
[http://en.wikipedia.org/wiki/.wav sound]
+
[http://en.wikipedia.org/wiki/.avi video] [http://en.wikipedia.org/wiki/.wav sound] [http://en.wikipedia.org/wiki/.pdf document]
[http://en.wikipedia.org/wiki/.pdf document]
+
 
 
|-
 
|-
|External link to the same host
+
| External link to the same host  
|<pre>[http://{{SERVERNAME}}/pagename]</pre>
+
| <pre>[http://{{SERVERNAME}}/pagename]</pre>
|[http://{{SERVERNAME}}/pagename]
+
| [http://{{SERVERNAME}}/pagename]
 
|-
 
|-
|External link to other host passing the pagename
+
| External link to other host passing the pagename  
|<pre>[http://google.com/search?q={{PAGENAMEE}}]</pre>
+
| <pre>[http://google.com/search?q={{PAGENAMEE}}]</pre>
|[http://google.com/search?q={{PAGENAMEE}}]
+
| [http://google.com/search?q={{PAGENAMEE}}]
 
|-
 
|-
|Mailto link
+
| Mailto link  
|<pre>[mailto:info@example.org email me]</pre>
+
| <pre>[mailto:info@example.org email me]</pre>
|[mailto:info@example.org email me]
+
| [mailto:info@example.org email me]
 
|-
 
|-
|Mailto named with subject line and body
+
| Mailto named with subject line and body  
|<pre>[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</pre>
+
| <pre>[mailto:info@example.org?Subject=URL%20Encoded%20Subject&amp;body=Body%20Text info]</pre>
|[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
+
| [mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
 
|}
 
|}
  
 
{{admin tip|tip=
 
{{admin tip|tip=
 
Which protocols (like http:) are allowed for links is controlled by the {{mediawiki|Manual:$wgUrlProtocols|$wgUrlProtocols}}<!--Should these admin tips even be here? This is supposed to be end user help is it not? --> setting.  
 
Which protocols (like http:) are allowed for links is controlled by the {{mediawiki|Manual:$wgUrlProtocols|$wgUrlProtocols}}<!--Should these admin tips even be here? This is supposed to be end user help is it not? --> setting.  
}}
+
}} {{admin tip|tip=
{{admin tip|tip=
+
 
To remove the “external link icons“ from next to each of the external links, add the following to the page located at <code>MediaWiki:Monobook.css</code> on your wiki.
 
To remove the “external link icons“ from next to each of the external links, add the following to the page located at <code>MediaWiki:Monobook.css</code> on your wiki.
  
Line 125: Line 135:
 
#bodyContent a.external,
 
#bodyContent a.external,
 
#bodyContent a[href ^="gopher://"] {
 
#bodyContent a[href ^="gopher://"] {
        background: none;
+
background: none;
        padding-right: 0;
+
padding-right: 0;
 
}
 
}
 
</source>
 
</source>
}}
+
}}  
 +
 
 +
=== How to avoid auto-links  ===
 +
 
 +
By default, when you write a URL as is, it will be transformed to an external link.
 +
 
 +
To avoid that effect, put the URL between <code>&lt;nowiki&gt;</code> tags as in:
 +
 
 +
<nowiki><nowiki>http://mediawiki.org</nowiki>&lt;/nowiki&gt;
 +
 
 +
== Interwiki links  ==
  
=== How to avoid auto-links ===
+
Interwiki links are links with the internal link markup to a website registered in advance. For example, you can link to the Sunflower article on http://en.wikipedia.org by typing <code><nowiki>[[wikipedia:Sunflower]]</nowiki></code>, which will result in a link [[wikipedia:Sunflower|RTENOTITLE]]. 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.''
By default, when you write a URL as is, it will be transformed to an external link.
+
  
To avoid that effect, put the URL between <code>&lt;nowiki&gt;</code> tags as in:
+
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>.
<nowiki><nowiki>http://mediawiki.org</nowiki></nowiki>
+
  
== Interwiki links ==
+
Basically this is an abbreviation for longer URLs. A very similar link could be created as a normal external link by typing <code><nowiki>[http://en.wikipedia.org/wiki/Sunflower Sunflower]</nowiki></code>, but interwiki links allow you to type out an easy and compact link, almost as if you are linking to a page on your own wiki.  
Interwiki links are links with the internal link markup to a website registered in advance. For example, you can link to the Sunflower article on http://en.wikipedia.org 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.''
+
  
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>.
+
{{admin tip|tip=See {{mediawiki|Manual:Interwiki}} for the management of interwiki links of your wiki.}}
  
Basically this is an abbreviation for longer URLs. A very similar link could be created as a normal external link by typing <code><nowiki>[http://en.wikipedia.org/wiki/Sunflower Sunflower]</nowiki></code>, but interwiki links allow you to type out an easy and compact link, almost as if you are linking to a page on your own wiki.
+
=== Interlanguage links ===
  
{{admin tip|tip=See {{mediawiki|Manual:Interwiki}} for the management of interwiki links of your wiki.}}
+
If your wiki has other language versions, you may find “interlanguage links” in the [[Help:Navigation#Sidebar|sidebar]], just below [[Help:Navigation#Toolbox|toolbox]] in the box named “{{lcfirst:{{int:otherlanguages}}}}.”
  
=== Interlanguage links ===
+
Interlanguage links behave similar 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:ISO 639|ISO language code]]).  
If your wiki has other language versions, you may find “interlanguage links” in the [[Help:Navigation#Sidebar|sidebar]], just below [[Help:Navigation#Toolbox|toolbox]] in the box named “{{lcfirst:{{int:otherlanguages}}}}.
+
  
Interlanguage links behave similar 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:ISO 639|ISO language code]]).
+
If you want to make the interlanguage link to appear in the content of the page, you can add a colon before the language prefix, e. g. <code><nowiki>[[:en:Sunflower]]</nowiki></code>.  
  
If you want to make the interlanguage link to appear in the content of the page, you can add a colon before the language prefix, e. g. <code><nowiki>[[:en:Sunflower]]</nowiki></code>.
+
== See also ==
  
== See also ==
+
*[[Help:Linked images|Linked images]]
* [[Help:Linked images|Linked images]]
+
  
{{Languages}}
+
{{Languages}}  
  
 
[[Category:Help]]
 
[[Category:Help]]

Revision as of 20:23, 19 April 2011

PD Important note: This page started out as a copy of one of the Public Domain Help Pages, which can be freely copied into fresh wiki installations and/or distributed with MediaWiki software; see mw:Help:Contents for an overview of all pages. See Project:PD help/Copying for instructions. PD



Help-content.png Questions?
Visit the Wiki Contributor Help Forum to receive help with contributing to the Wiki.



There are four sorts of links in MediaWiki:

  1. internal links to other pages in the wiki
  2. external links to other websites
  3. interwiki links to other websites registered to the wiki in advance
  4. Interlanguage links to other websites registered as other language versions of the wiki

Contents

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]]
Main Page
Piped link
[[Main Page|different text]]
different text
Shortened sort-of-piped link
[[Internationalisation]]s
Internationalisations
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 at another page
[[Help:Images#See also]]
Help:Images#See_also
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 [[Help:Links/example]]. See also Help:Subpages.

/example
Internal link to a category page
[[:Category:Help]]

See also Help:Categories

Category:Help
Internal link to an image or a file of other types
[[media:example.jpg]]

[[media:example.pdf]]

See also Help:Images

Media:Example.jpg

Media:Example.pdf

External links

Description You type You get
External link
http://mediawiki.org
http://mediawiki.org
External link with different label
[http://mediawiki.org MediaWiki]
MediaWiki
External link numbered
[http://mediawiki.org]
[1]
External link icons
[http://en.wikipedia.org/wiki/.avi video]
[http://en.wikipedia.org/wiki/.wav sound]
[http://en.wikipedia.org/wiki/.pdf document]

External link icons may differ depending on the file type of the target.

video sound document

External link to the same host
[http://{{SERVERNAME}}/pagename]
[2]
External link to other host passing the pagename
[http://google.com/search?q={{PAGENAMEE}}]
[3]
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
Tools.png Tip for wiki admins: Which protocols (like http:) are allowed for links is controlled by the $wgUrlProtocols setting.
Tools.png Tip for wiki admins: To remove the “external link icons“ from next to each of the external links, add the following to the page located at MediaWiki:Monobook.css on your wiki.

<source lang="css">

  1. bodyContent a.external,
  2. bodyContent a[href ^="gopher://"] {
background: none;
padding-right: 0;

} </source>

How to avoid auto-links

By default, when you write a URL as is, it will be transformed to an external link.

To avoid that effect, put the URL between <nowiki> tags as in:

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

Interwiki links

Interwiki links are links with the internal link markup to a website registered in advance. For example, you can link to the Sunflower article on http://en.wikipedia.org by typing [[wikipedia:Sunflower]], which will result in a link RTENOTITLE. 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.

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

Basically this is an abbreviation for longer URLs. A very similar link could be created as a normal external link by typing [http://en.wikipedia.org/wiki/Sunflower Sunflower], but interwiki links allow you to type out an easy and compact link, almost as if you are linking to a page on your own wiki.

Tools.png Tip for wiki admins: See Manual:Interwiki for the management of interwiki links of your wiki.

Interlanguage links

If your wiki has other language versions, you may find “interlanguage links” in the sidebar, just below toolbox in the box named “in other languages.”

Interlanguage links behave similar 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 language code).

If you want to make the interlanguage link to appear in the content of the page, you can add a colon before the language prefix, e. g. [[:en:Sunflower]].

See also

Template:Languages