The Wiki for Tale 5 is in read-only mode and is available for archival and reference purposes only. Please visit the current Tale 11 Wiki in the meantime.

If you have any issues with this Wiki, please post in #wiki-editing on Discord or contact Brad in-game.

Difference between revisions of "Help:Links"

From ATITD5
Jump to navigationJump to search
 
(Created page with "There are four sorts of links in MediaWiki: # internal links to other pages in the wiki # external links to websites # interwiki links (links to other wikis...")
Line 1: Line 1:
{{PD Help Page}}
 
 
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
+
# internal links to other pages in the wiki
# '''[[#External links|external links]]''' to other websites
+
# external links to websites
# '''[[#Interwiki links|interwiki links]]''' to other websites registered to the wiki in advance
+
# [[#Interwiki links|interwiki links]] (links to other wikis)
# '''[[#Interlanguage links|Interlanguage links]]''' to other websites registered as other language versions of the wiki
+
# inter-language links to other language versions of the same 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, empty pages are displayed in red. Selflinks to the current page are not transformed in URLs but displayed in bold.
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 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"
+
== How to link ==
!Description
+
{| {{Prettytable}}
!You type
+
|-
!You get
+
|{{Hl3}}|'''Description'''
 +
|{{Hl3}}|'''You type'''
 +
|{{Hl3}}|'''You get'''
 
|-
 
|-
 
|Internal link
 
|Internal link
|<pre>[[Main Page]]</pre>
+
|<tt><nowiki>[[Main Page]]</nowiki></tt>
 
|[[Main Page]]
 
|[[Main Page]]
 
|-
 
|-
 
|Piped link  
 
|Piped link  
|<pre>[[Main Page|different text]]</pre>
+
|<tt><nowiki>[[Main Page|different text]]</nowiki></tt>
|[[Main Page|different text]]
+
|[[Main Page|different text]]
 
|-
 
|-
|Shortened sort-of-piped link  
+
|External link
|<pre>[[Internationalisation]]s</pre>
+
|<tt><nowiki>http://mediawiki.org</nowiki></tt>
|[[Internationalisation]]s
+
|http://mediawiki.org
 
|-
 
|-
|Redirect
+
|External link,<br />
|<pre>#REDIRECT [[Main Page]]</pre>
+
different title
See also [[Help:Redirects]]
+
|<tt><nowiki>[http://mediawiki.org MediaWiki]</nowiki></tt>
| &rarr; [[Main Page]]
+
|[http://mediawiki.org MediaWiki]
 +
|-
 +
|External link,<br />
 +
numbered
 +
|<tt><nowiki>[http://mediawiki.org]</nowiki></tt>
 +
|[http://mediawiki.org]
 
|-
 
|-
|Internal link to an anchor
+
|Anchor link  
|<pre>[[#See also]]</pre>
+
|<tt><nowiki>[[#See also]]</nowiki></tt>
[[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
+
|Anchor link at another page
|<pre>[[Help:Images#See also]]</pre>
+
|<tt><nowiki>[[Help:Images#See also]]</nowiki></tt>
 
|[[Help:Images#See also]]
 
|[[Help:Images#See also]]
 
|-
 
|-
|Internal link to the current page's talk page
+
|Category link
|<pre>[[{{TALKPAGENAME}}|Discussion]]</pre>
+
|<tt><nowiki>[[:Category:Help]]</nowiki></tt>
See also [[Help:Magic_words#Page_names]]
+
|[[:Category:Help]]
|[[{{TALKPAGENAME}}|Discussion]]
+
|-
 +
|Internal link to image file
 +
|<tt><nowiki>[[media:example.jpg]]</nowiki></tt>
 +
|[[media:example.jpg]]
 +
|-
 +
|Internal link to pdf file
 +
|<tt><nowiki>[[media:example.pdf]]</nowiki></tt>
 +
|[[media:example.pdf]]
 
|-
 
|-
|Internal link to the current page's edit page
+
|Interwiki link
|<pre>[{{fullurl:{{PAGENAME}}|action=edit}} Edit]</pre>
+
|<tt><nowiki>[[Wikipedia:MediaWiki]]</nowiki></tt>
See also [[Help:Magic_words#URL_data]] and [[#External links]]
+
|[[Wikipedia:MediaWiki]]
|[{{fullurl:{{PAGENAME}}|action=edit}} Edit]
 
 
|-
 
|-
|Internal link to a subpage
+
|mailto link
|<pre>[[/example]]</pre>
+
|<tt><nowiki>[mailto:info@example.org email me]</nowiki></tt>
Shortcut for <nowiki>[[Help:Links/example]]</nowiki>. See also [[Help:Subpages]].
+
|[mailto:info@example.org email me]
|[[/example]]
 
 
|-
 
|-
|Internal link to a subpage without the leading slash
+
|redirect
|<pre>[[/example/]]</pre>
+
|<tt><nowiki>#REDIRECT [[Main Page]]</nowiki></tt>
Shortcut for <nowiki>[[Help:Links/example|example]]</nowiki>.
+
| &rarr; [[Main Page]]
|[[/example/]]
 
 
|-
 
|-
|Internal link to a category page
+
|External link to video file (.avi, .mpg)
|<pre>[[:Category:Help]]</pre>
+
|<tt><nowiki>[http://en.wikipedia.org/wiki/.avi .avi]</nowiki></tt>
See also [[Help:Categories]]
+
|[http://en.wikipedia.org/wiki/.avi .avi]
|[[:Category:Help]]
 
 
|-
 
|-
|Internal link to an image or a file of other types
+
|External link to sound file (.mp3, .ogg, .wav)
|<pre>[[media:example.jpg]]
+
|<tt><nowiki>[http://en.wikipedia.org/wiki/.wav .wav]</nowiki></tt>
 
+
|[http://en.wikipedia.org/wiki/.wav .wav]
[[media:example.pdf]]</pre>
 
See also [[Help:Images]]
 
|[[media:example.jpg]]
 
 
 
[[media:example.pdf]]
 
 
|-
 
|-
|Internal link to the user's user page
+
|External link to a document (.doc, .pdf)
|<pre>[[Special:MyPage]]</pre>
+
|<tt><nowiki>[http://en.wikipedia.org/wiki/.doc .doc]</nowiki></tt>
|[[Special:MyPage]]
+
|[http://en.wikipedia.org/wiki/.doc .doc]
 
|}
 
|}
  
== External links ==
+
=== More advanced ===
{| border="1" class="wikitable"
+
 
!style="width:15%"|Description
+
{| {{Prettytable}}
!style="width:45%"|You type
 
!style="width:40%"|You get
 
 
|-
 
|-
|External link
+
|{{Hl3}}|'''Description'''
|<tt><nowiki>http://mediawiki.org</nowiki></tt>
+
|{{Hl3}}|'''You type'''
|http://mediawiki.org
+
|{{Hl3}}|'''You get'''
 
|-
 
|-
|External link with different label
+
|Piped link,<br />
|<tt><nowiki>[http://mediawiki.org MediaWiki]</nowiki></tt>
+
different title
|[http://mediawiki.org MediaWiki]
+
|<tt><nowiki>[[Main Page|<span title="different title">different text</span>]]</nowiki></tt>
 +
|[[Main Page|<span title="different title">different text</span>]]
 
|-
 
|-
|Numbered external link
+
|External link,<br />
|<tt><nowiki>[http://mediawiki.org]</nowiki></tt>
+
same host unnamed
|[http://mediawiki.org]
+
|<tt><nowiki>[http://{{SERVERNAME}}/pagename]</nowiki></tt>
 +
|[http://{{SERVERNAME}}/pagename]
 
|-
 
|-
|External links with file icons
+
|External link,<br />
|<tt><nowiki>
+
other host, pass pagename
[http://en.wikipedia.org/wiki/.avi video]
+
|<tt><nowiki>[http://google.com/search?q={{PAGENAMEE}}]</nowiki></tt>
[http://en.wikipedia.org/wiki/.ogg sound]
+
|[http://google.com/search?q={{PAGENAMEE}}]
[http://en.wikipedia.org/wiki/.pdf document]
 
</nowiki></tt>
 
<small>Currently supported extensions: ogm, avi, mpeg, mpg (video); ogg, mid, midi, mp3, wav, wma (audio); and pdf (document)</small>
 
|
 
[http://en.wikipedia.org/wiki/.avi video]<br/>
 
[http://en.wikipedia.org/wiki/.ogg sound]<br/>
 
[http://en.wikipedia.org/wiki/.pdf document]<br/>
 
|-
 
|External link to the same host
 
|<tt><nowiki>http://{{SERVERNAME}}/pagename</nowiki></tt>
 
|http://{{SERVERNAME}}/pagename
 
|-
 
|External link to other host passing the pagename
 
|<tt><nowiki>http://google.com/search?q={{PAGENAMEE}}</nowiki></tt>
 
|http://google.com/search?q={{PAGENAMEE}}
 
|-
 
|Mailto link
 
|<tt><nowiki>[mailto:[email protected] email me]</nowiki></tt>
 
|[mailto:[email protected] email me]
 
 
|-
 
|-
|Mailto named with subject line and body
+
|mailto named with subject line and body
|<tt><nowiki>[mailto:[email protected]?Subject=URL%20Encoded%20Subject&amp;body=Body%20Text info]</nowiki></tt>
+
|<tt><nowiki>[mailto:[email protected]?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki></tt>
 
|[mailto:[email protected]?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
 
|[mailto:[email protected]?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
 
|}
 
|}
  
=== 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></nowiki>
+
 
 +
{{admin tip|tip=
 +
Which protocols (like http:) are allowed for links is controlled by the [http://www.mediawiki.org/wiki/Manual:%24wgUrlProtocols $wgUrlProtocols]<!-- deliberate use of http url, these pages get exported. Should these admin tips even be here? This is supposed to be end user help is it not? --> setting.
 +
}}
 +
 
 +
{{admin tip|tip=
 +
To remove the 'external link image' from next to each of the external links, add the following to the page located at <code>MediaWiki:Monobook.css</code> on your wiki.
 +
 
 +
<pre>
 +
#bodyContent a.external,
 +
#bodyContent a[href ^="gopher://"] {
 +
        background: none;
 +
        padding-right: 0;
 +
}
 +
</pre>
 +
}}
 +
 
 +
== How to avoid auto-links ==
  
== Interwiki links ==
+
By default, when you write a URL as is, it will be transformed to an external link.
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.'' 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>.
+
To avoid that effect, put the URL between &lt;nowiki&gt; start & end tags as in:
  
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 big yellow flower]</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.
+
&lt;nowiki&gt;<nowiki>http://mediawiki.org</nowiki>&lt;/nowiki&gt;
  
To edit the {{mediawiki|Manual:Interwiki table|interwiki table}} on your site, see the {{mediawiki|Extension:InterWiki|InterWiki extension}}.
+
== Interwiki links ==
 +
Interwiki links are links from the local wiki to another wiki. For example you can link to the Sunflower article on wikipedia.org by typing <tt><nowiki>[[wikipedia:Sunflower]]</nowiki></tt>. This results in a link like this: [[wikipedia:Sunflower]]
  
=== Interlanguage links ===
+
Similar to internal page links, you can create piped links, with alternate link text. e.g. <tt><nowiki>[[wikipedia:Sunflower|big yellow flower]]</nowiki></tt>
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]]).
+
Basically this is an abbreviation for longer URLs. A very similar link could be created as a normal external link by typing <tt><nowiki>[http://en.wikipedia.org/wiki/Sunflower Sunflower]</nowiki></tt>, 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.
  
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>.
+
Some interesting things to note:
 +
* Interwiki links are displayed slightly differently to external links, without the little external link icon.
 +
* Complex page names with spaces and other characters are handled elegantly, just as they would be for an internal page link, making this more tidy than creating an external link to a full URL. For example <tt><nowiki>[[wikipedia:Sunflower County, Mississippi]]</nowiki></tt> is in some ways tidier and more elegant than the full URL : <tt>http://en.wikipedia.org/wiki/Sunflower_County%2C_Mississippi</tt>
  
 
== See also ==
 
== See also ==
 
* [[Help:Linked images|Linked images]]
 
* [[Help:Linked images|Linked images]]
 
+
{{Languages}}
 
 
 
 
[[Category:Help|Links]]
 
[[Category:Help|Links]]
[[Category:Link|Links]]
+
[[Category:Link]]

Revision as of 01:34, 7 August 2010

There are four sorts of links in MediaWiki:

  1. internal links to other pages in the wiki
  2. external links to websites
  3. interwiki links (links to other wikis)
  4. inter-language links to other language versions of the same 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, empty pages are displayed in red. Selflinks to the current page are not transformed in URLs but displayed in bold.

The first letter of the target page is automatically capitalized 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).

How to link

Description You type You get
Internal link [[Main Page]] Main Page
Piped link [[Main Page|different text]] different text
External link http://mediawiki.org http://mediawiki.org
External link,

different title

[http://mediawiki.org MediaWiki] MediaWiki
External link,

numbered

[http://mediawiki.org] [1]
Anchor link [[#See also]] #See also
Anchor link at another page [[Help:Images#See also]] Help:Images#See also
Category link [[:Category:Help]] Category:Help
Internal link to image file [[media:example.jpg]] media:example.jpg
Internal link to pdf file [[media:example.pdf]] media:example.pdf
Interwiki link [[Wikipedia:MediaWiki]] Wikipedia:MediaWiki
mailto link [mailto:[email protected] email me] email me
redirect #REDIRECT [[Main Page]] Main Page
External link to video file (.avi, .mpg) [http://en.wikipedia.org/wiki/.avi .avi] .avi
External link to sound file (.mp3, .ogg, .wav) [http://en.wikipedia.org/wiki/.wav .wav] .wav
External link to a document (.doc, .pdf) [http://en.wikipedia.org/wiki/.doc .doc] .doc

More advanced

Description You type You get
Piped link,

different title

[[Main Page|<span title="different title">different text</span>]] different text
External link,

same host unnamed

[http://{{SERVERNAME}}/pagename] [2]
External link,

other host, pass pagename

[http://google.com/search?q={{PAGENAMEE}}] [3]
mailto named with subject line and body [mailto:[email protected]?Subject=URL%20Encoded%20Subject&body=Body%20Text info] info



20px Tip for wiki admins: Which protocols (like http:) are allowed for links is controlled by the $wgUrlProtocols setting.
20px Tip for wiki admins: To remove the 'external link image' from next to each of the external links, add the following to the page located at MediaWiki:Monobook.css on your wiki.
#bodyContent a.external,
#bodyContent a[href ^="gopher://"] {
        background: none;
        padding-right: 0;
}

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> start & end tags as in:

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

Interwiki links

Interwiki links are links from the local wiki to another wiki. For example you can link to the Sunflower article on wikipedia.org by typing [[wikipedia:Sunflower]]. This results in a link like this: wikipedia:Sunflower

Similar to internal page links, you can create piped links, with alternate link text. 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.

Some interesting things to note:

  • Interwiki links are displayed slightly differently to external links, without the little external link icon.
  • Complex page names with spaces and other characters are handled elegantly, just as they would be for an internal page link, making this more tidy than creating an external link to a full URL. For example [[wikipedia:Sunflower County, Mississippi]] is in some ways tidier and more elegant than the full URL : http://en.wikipedia.org/wiki/Sunflower_County%2C_Mississippi

See also