Difference between revisions of "Help:Links"

From SacredWiki
Jump to navigation Jump to search
m (1 revision(s))
(One intermediate revision by the same user not shown)
Line 3: Line 3:
 
# internal links to other pages in the wiki
 
# internal links to other pages in the wiki
 
# external links to websites
 
# external links to websites
# [[Help:Interwiki linking|inter-wiki links]] (links to other wikis)
+
# [[#Interwiki links|interwiki links]] (links to other wikis)
 
# inter-language links to other language versions of the same wiki
 
# inter-language links to other language versions of the same wiki
  
Line 16: Line 16:
 
|{{Hl3}}|'''You type'''
 
|{{Hl3}}|'''You type'''
 
|{{Hl3}}|'''You get'''
 
|{{Hl3}}|'''You get'''
|-
 
|Sacred Underworld Link
 
|Push the [img]http://www.darkmatters.org/SacredWiki/images/buttons/S1internallink.jpg[/img] button found when editing a page.
 
|-
 
|Sacred 2:Fallen Angel Link
 
|Push the [img]http://www.darkmatters.org/SacredWiki/images/buttons/S2internallink.jpg[/img] button found when editing a page.
 
 
|-
 
|-
 
|Internal link
 
|Internal link
 
|<tt><nowiki>[[Main Page]]</nowiki></tt>
 
|<tt><nowiki>[[Main Page]]</nowiki></tt>
 
|[[Main Page]]
 
|[[Main Page]]
|-
 
|Internal link stored on intranet server
 
|<tt><nowiki>[file:///\\server_name123\pubshare_name\internal_webpage.htm internal_webpage.htm]</nowiki></tt>
 
|internal_webpage.htm
 
|-
 
|Category link
 
|<tt><nowiki>[[:Category:Help]]</nowiki></tt>
 
|[[:Category:Help]]
 
 
|-
 
|-
 
|Piped link  
 
|Piped link  
 
|<tt><nowiki>[[Main Page|different text]]</nowiki></tt>
 
|<tt><nowiki>[[Main Page|different text]]</nowiki></tt>
 
|[[Main Page|different text]]
 
|[[Main Page|different text]]
|-
 
|Anchor link
 
|<tt><nowiki>[[#External links|Anchor link]]</nowiki></tt>
 
|[[#External links|Anchor link]]
 
 
|-
 
|-
 
|External link
 
|External link
 
|<tt><nowiki>http://mediawiki.org</nowiki></tt>
 
|<tt><nowiki>http://mediawiki.org</nowiki></tt>
 
|http://mediawiki.org
 
|http://mediawiki.org
|-
 
|External link from internal image
 
|<tt><nowiki>[http://targetURL {{Server}}/wiki/images/imagelocation]</nowiki></tt>
 
|Internal image
 
 
|-
 
|-
 
|External link,<br />
 
|External link,<br />
Line 57: Line 35:
 
|-
 
|-
 
|External link,<br />
 
|External link,<br />
unnamed
+
numbered
 
|<tt><nowiki>[http://mediawiki.org]</nowiki></tt>
 
|<tt><nowiki>[http://mediawiki.org]</nowiki></tt>
 
|[http://mediawiki.org]
 
|[http://mediawiki.org]
 
|-
 
|-
|External link,<br />
+
|Anchor link  
same host unnamed
+
|<tt><nowiki>[[#See also]]</nowiki></tt>
|<tt><nowiki>[http://{{SERVERNAME}}/pagename]</nowiki></tt>
+
|[[#See also]]
|[http://{{SERVERNAME}}/pagename]
+
|-
 +
|Anchor link at another page
 +
|<tt><nowiki>[[Help:Images#See also]]</nowiki></tt>
 +
|[[Help:Images#See also]]
 +
|-
 +
|Category link
 +
|<tt><nowiki>[[:Category:Help]]</nowiki></tt>
 +
|[[:Category:Help]]
 +
|-
 +
|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]]
 
|-
 
|-
 
|Interwiki link
 
|Interwiki link
Line 70: Line 63:
 
|[[Wikipedia:MediaWiki]]
 
|[[Wikipedia:MediaWiki]]
 
|-
 
|-
|mailto
+
|mailto link
|<tt><nowiki>mailto:info@example.org</nowiki></tt>
+
|<tt><nowiki>[mailto:info@example.org email me]</nowiki></tt>
|mailto:info@example.org
+
|[mailto:info@example.org email me]
|-
 
|mailto unnamed
 
|<tt><nowiki>[mailto:info@example.org]</nowiki></tt>
 
|[mailto:info@example.org]
 
|-
 
|mailto named
 
|<tt><nowiki>[mailto:info@example.org info]</nowiki></tt>
 
|[mailto:info@example.org info]
 
 
|-
 
|-
 
|redirect
 
|redirect
Line 87: Line 72:
 
|}
 
|}
  
== External links ==
+
=== More advanced ===
{{meta|Help:Link}}
+
 
 +
{| {{Prettytable}}
 +
|-
 +
|{{Hl3}}|'''Description'''
 +
|{{Hl3}}|'''You type'''
 +
|{{Hl3}}|'''You get'''
 +
|-
 +
|Piped link,<br />
 +
different title
 +
|<tt><nowiki>[[Main Page|<span title="different title">different text</span>]]</nowiki></tt>
 +
|[[Main Page|<span title="different title">different text</span>]]
 +
|-
 +
|External link,<br />
 +
same host unnamed
 +
|<tt><nowiki>[http://{{SERVERNAME}}/pagename]</nowiki></tt>
 +
|[http://{{SERVERNAME}}/pagename]
 +
|-
 +
|External link,<br />
 +
other host, pass pagename
 +
|<tt><nowiki>[http://google.com/search?q={{PAGENAMEE}}]</nowiki></tt>
 +
|[http://google.com/search?q={{PAGENAMEE}}]
 +
|-
 +
|mailto named with subject line and body
 +
|<tt><nowiki>[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]</nowiki></tt>
 +
|[mailto:info@example.org?Subject=URL%20Encoded%20Subject&body=Body%20Text info]
 +
|}
 +
 
 +
 
 +
----
 +
 
 +
{{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 ==
 +
 
 +
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 &lt;nowiki&gt; start & end tags as in:
 +
 
 +
&lt;nowiki&gt;<nowiki>http://mediawiki.org</nowiki>&lt;/nowiki&gt;
 +
 
 +
== 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]]
 +
 
 +
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>
 +
 
 +
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.
 +
 
 +
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 ==
 +
* [[Help:Linked images|Linked images]]
 
   
 
   
 
+
{{Languages|Help:Links}}
  
 
[[Category:Help|Links]]
 
[[Category:Help|Links]]
 
[[Category:Link]]
 
[[Category:Link]]

Revision as of 16:44, 28 October 2008

PD Important note: When you edit this page, you agree to release your contribution into the public domain. If you don't want this or can't do this because of license restrictions, please don't edit. This page is one of the Public Domain Help Pages, which can be freely copied into fresh wiki installations and/or distributed with MediaWiki software; see Help:Contents for an overview of all pages. See Project:PD help/Copying for instructions. PD

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:info@example.org email me] email me
redirect #REDIRECT [[Main Page]] Main Page

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: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 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