×
Namespaces

Variants
Actions

Help:Links

From Nokia Developer Wiki
Jump to: navigation, search
Help.png
This Help topic explains how to link to other pages and files in the wiki.

For more detailed information on links, including inter-wiki and inter-language links see the generic mediawiki links topic: Help:Links.

Contents

Linking to articles

The easiest way to insert a link to another article is to use the Wiki Editor's Insert Link tool (Insert-link.png) which is displayed whenever you edit a page.

WikiEditorAdvancedLinkTool.png

The Insert Link dialog then allows you to enter the target page name (using an auto-complete field), optional text to display instead of the target page name, and whether the link is internal (to another wiki page) or external (to a URL).

When you press the Insert Link button on the dialog the appropriate wiki text for the link is added to the page.

If you want to edit the link manually, then the Wiki Editor provides basic help on the formatting for both external and internal links in the "Help" section, as shown in the figure above, or you can copy the syntax below. Note that you can do all of these formats in the Wiki Editor, except for linking to a specific heading in a page.

Link type Syntax Appearance
Internal link [[Target Page Name]] Target Page Name
Internal link (with link display text) [[Target Page Name|Link Text to Display]] Link Text to Display
Internal link to heading in page [[Target Page Name#Target heading name|Link Text to Display]] Link Text to Display
External link (bare format) http://www.beer.com http://www.beer.com
External link (no name) [http://www.beer.com] [1]
External link (with link display text) [http://www.beer.com Beer.com] Beer.com

Linking to files

Files can be linked to using the same internal link syntax as any other page. Note however that if you want to specify link text other than the filename then you need to add a preceding colon (":") before the "File" namespace, as shown below:

Link type Syntax Appearance
File link [[File:NotifierExample.zip]] File:NotifierExample.zip
File link (with different display text) [[:File:NotifierExample.zip|Notifier UI]] Notifier UI
Download file (bypass file page) [[Media:NotifierExample.zip|Notifier UI]] Notifier UI

Linking to images

To link to images you must use a colon preceding the namespace (as discussed above) or the image itself will be displayed instead of the link. Examples of the right and wrong way shown below

Link type Syntax Appearance
File link (incorrect) [[File:insert-link.png]] Insert-link.png
File link (correct) [[:File:insert-link.png]] File:insert-link.png
File link (correct, with new link text) [[:File:insert-link.png|Image link text]] Image link text
Image link [[:Image:insert-link.png]] Image:insert-link.png

Common mistakes

  1. Not putting space after a bare link. This fails because the URL includes any attached characters. It isn't always obvious on inspection either, for example when a link is followed by a comma, braces or characters in other languages. For example, the following all fail:
    • http://www.symbian.com,
    • http://www.symbian.com(Symbian signed)
    • (http://www.symbian.com)
    • http://www.symbian.com可从诺"
  2. Putting an additional bracket around the external link format. This works, but you end up with an unnecessary bracket. For example:
    • [[http://www.symbian.com Symbian Signed]] renders as [Symbian Signed]
  3. Putting your link inside a Note, Tip, Warning or InfoBox can break it if the URL contains the equals (=) or pipe (|) characters. If this is the case you must replace it with their HTML entities (= and |, respectively) or HTML encoded values (%3D and %7C, respetively).
 
×