View source for Help:Navigational image

{{H:h|editor toc}}
:''If you are not reading this in [http://meta.wikimedia.org/wiki/Help:Navigational_image Meta] it is advised that you go there to view this page otherwise some links in this page will not work''

By default an image is linked to its [[Help:Image page|image page]]: <nowiki>[[Image:Catapult.jpg|80px]]</nowiki> [[Image:Catapult.jpg|80px]]

However, an image can be made to link to another page.

== Link parameter ==

Example:

 <nowiki>[[Image:Catapult.jpg|80px|link=Main Page]]</nowiki>
gives:
[[Image:Catapult.jpg|80px|link=Main Page]]

See [[Help:Images_and_other_uploaded_files#Link]] for details.

== ImageMap ==

All Wikipedia sites seem to have the [[:mw:Extension:ImageMap]] installed. Although aimed at multiple areas with different links on an image, one can use it also to link the whole image to a single page. It works on internal and interwiki links.

<imagemap>
Image:Foo.jpg|200px|Help on images (text outside link area)
default [[w:Help:Images_and_other_uploaded_files|Help on images]]
desc none
#use desc bottom-left to have a blue i link to the image page
</imagemap>

<pre>
<imagemap>
Image:Foo.jpg|200px|Help on images (text outside link area)
desc none
#use desc bottom-left to have a blue i link to the image page
default [[w:Help:Images_and_other_uploaded_files]]
</imagemap>
</pre>

== Using the external link format ==

In projects that allow [[Help:Images_and_other_uploaded_files#Embedding_external_images|the embedding of external_images]] (in which case you see images in the lefthand column of the table below) there are the following possibilities:

(The image can be an internally or externally held image, and the target can be an external URL or a wiki page).

<table border="1" cellpadding="2" cellspacing="0">
<tr>
<th>What it looks like</th>
<th>What you type</th>
</tr>

<tr valign="top"><td>An external image linking to an external page, image, etc.:<br>
[http://www.google.com http://www.google.com/images/logo.gif]
</td>

<td><pre><nowiki>
[http://www.google.com http://www.google.com/images/logo.gif]</nowiki></pre>
</td>
</tr>

<tr>
<td>
An external image linking to an internal page:<br>
[[Help:Redirect|http://www.google.com/images/logo.gif]] <u>'''does not work!'''</u>
</td>

<td>
<pre><nowiki>[[Help:Redirect|http://www.google.com/images/logo.gif]]</nowiki></pre>
</td>
</tr>

<tr><td>
An external image linking to an internal page with external link style, with :<br>
[{{SERVER}}{{localurl:Help:Redirect}} http://www.google.com/images/logo.gif]
</td>

<td><pre><nowiki>
[{{SERVER}}{{localurl:Help:Redirect}} http://www.google.com/images/logo.gif]
</nowiki></pre>
</td>
</tr>

<tr><td>
An internal image linking to an internal page with external link style:<br>
[{{SERVER}}{{localurl:Help:Redirect}} http:../upload/b/bc/Wiki.png] Again, there is no automatic link to the image page, use [[:Image:wiki.png]]. With this method, the same image can be used on another page linking as usual to the image page, or linking to a different target.
</td>

<td><pre><nowiki>
[{{SERVER}}{{localurl:Help:Redirect}} http:../upload/b/bc/Wiki.png]

[[Image:wiki.png]]
</nowiki></pre>
</td>
</tr>

<tr><td>
If you don't want the small icon indicating it is an external link to appear, because it is actually an internal link (and looks untidy), you can surround the image link with code to supress it. This will be most useful to people running their own corporate or independent wikis, rather than Wikimedia sites.<br>
<span class="plainlinks">[{{SERVER}}{{localurl:Help:Redirect}} http:../upload/b/bc/Wiki.png]</span>
<br><font size=1>''If you are looking at this on Meta, you will not see the effect here as it doesn't allow embedding of 'external' images...''</font>
</td>

<td><pre><nowiki>
<span class="plainlinks">[{{SERVER}}{{localurl:Help:Redirect}} http:../upload/b/bc/Wiki.png]</span>
</nowiki></pre>
*Using 'span' instead of 'div' means a navigational image can be embedded within text without linebreaks spoiling the show
</td>
</tr>

<tr><td>
To make it easy to create navigational images based on the above method, a template can be employed. In this example a template called ''''clickpic'''' is created that takes two parameters: target page name and image path. <font size=1>''(''''clickpic'''' template not to be confused with ''''click'''' template mentioned in [[#Method 3: Using 'Click' template|Method 3]])''.</font>

{{clickpic|Main Page|http:../upload/b/bc/Wiki.png}}

<small>For more info on using this template, see [[User:CharlesC/Template for navigational images on Mediawiki websites]].</small>

Now you can easily have proper internal linking with images in MediaWiki sites - hooray!
</td>

<td>
*Create template called 'clickpic'. Probably easiest method is to type 'template:clickpic' at the end of your wiki's URL, then click 'edit'.
*This is the text you need add to your template page (see Meta's one at [[:Template:Clickpic]]):
<pre><nowiki>
<span class="plainlinks">[{{SERVER}}{{localurl:{{{1}}}}} {{{2}}}]</span>
</nowiki></pre>
*Using the template above, this is all that needs to be written to create a navigational image:
<pre><nowiki>
{{clickpic|Main Page|http:../upload/b/bc/Wiki.png}}
</nowiki></pre>
*This creates a navigational image that has 'Main Page' as the target page and displays the image stored at 'http:../upload/b/bc/Wiki.png'
</td>
</tr>

</table>

=== Thumbnail ===
One application is linking a small version of an image to a large one. Example where both are external:

<pre><nowiki>[http://pennine.demon.co.uk/photos/seakayak/xga/Lunga-P7-100-3086.jpg  http://pennine.demon.co.uk/photos/seakayak/small/Lunga-P7-100-3086.jpg]</nowiki></pre>

gives

[http://pennine.demon.co.uk/photos/seakayak/xga/Lunga-P7-100-3086.jpg  http://pennine.demon.co.uk/photos/seakayak/small/Lunga-P7-100-3086.jpg]

The alternate text is the name of the image, after the last slash in the URL. If you have control over the image, give it a meaningful name; you could even include a text like "click to enlarge" in the name.

== Superimposing a hyperlink onto an image ==
A linked text can be superimposed onto an image, see [[Help:Composite images]]. In particular there can be a dummy text such as an &amp;nbsp; character in a very large font, covering the whole image.

Using {{tim|navimg}}:

<pre><nowiki>top{{navimg|xsize=50|ysize=50|image=Foo.jpg|link=MediaWiki}}bottom</nowiki></pre> gives:{{clear}}

top{{navimg|xsize=50|ysize=50|image=Foo.jpg|link=MediaWiki}}bottom


Similarly with {{tim|navimgx}} for an external link:

<pre><nowiki>top{{navimgx|xsize=50|ysize=50|image=Wikimedia-logo.svg|link=http://meta.wikimedia.org/w/index.php?title=Help:Navigational_image&action=edit&section=4}}bottom</nowiki></pre> gives:{{clear}}

top{{navimgx|xsize=50|ysize=50|image=Wikimedia-logo.svg|link=http://meta.wikimedia.org/w/index.php?title=Help:Navigational_image&action=edit&section=4}}bottom

However, if the browser is set to ignore font sizes specified in web pages then only part of the area in the image links to the specified page, and the rest of the image to the image page. Check the hoverbox or status line to see the target at any position of the mouse cursor. Some versions of the template have the same hoverbox for the two areas.

The image cannot be inline. Positioning can be done e.g. with a table.

Image links were easy to do with the navimg template, but I thought the directions here were lacking a bit;

The Template looks like - 

<nowiki> <div style="position: relative; width: {{{xsize|{{{size|}}}}}}px; height: {{{ysize|{{{size|}}}}}}px; overflow: hidden;"><div style="position: absolute; top: 0; left: 0; font-size: 200pt; width: {{{xsize|{{{size|}}}}}}px; height: {{{ysize|{{{size|}}}}}}px;  overflow: hidden; line-height: {{{ysize|{{{size|}}}}}}px; z-index: 3;">[[:{{{link|}}}|{{{linktext|&nbsp;}}}]]</div><div style="position: absolute; top: 0; left: 0; z-index: 2;">[[Image:{{{image|}}}|{{{xsize|{{{size|}}}}}}px|image page]]</div></div> </nowiki>
<noinclude>

Example: <nowiki>{{navimg|xsize=25|ysize=25|image=Wikibooks-logo.png|link=Documentation_Guidelines}}</nowiki><br>
; All attributes are required.
: xsize = horizontal
: ysize = veritacal
: image = internal image file
: link = internal link location.
</noinclude>

The image will always show up on a newline on the left unless you put the image in a table. 
:; Example of image appearing on the right.
<nowiki>{| border="0" cellspacing="0" align="right" style="text-align: left;"
|-
| {{navimg|xsize=25|ysize=25|image=Wikibooks-logo.png|link=Documentation_Guidelines}}>
|}</nowiki>

See also:
*{{tiw|click}}.
*{{tiw|nl|klikafb}}
*[[wikt:de:Template:Link-Bild]]

==See also==
*[[w:Wikipedia:Images linking to articles]]
*[[Help:Images_and_other_uploaded_files#Navigational_maps|Navigational maps]]
*[[Help:Composite images]] - Allows superimposing a linked text onto an image.
*[[w:Template:Annotated image]]
{{h:f|enname=Navigational image}}
[[Category:Editor handbook]]