Timo.Kouwenhoven: Created page with "If you want to include images in an article, you can use uploaded files or you can link to external files. ==Uploaded files== To use an image or other file which has been [[Help..."

2010-11-17T15:03:45Z

Created page with "If you want to include images in an article, you can use uploaded files or you can link to external files. ==Uploaded files== To use an image or other file which has been [[Help..."

New page

If you want to include images in an article, you can use uploaded files or you can link to external files.

==Uploaded files==
To use an image or other file which has been [[Help:Managing files|uploaded to the wiki]], use:
<code><nowiki>[[File:Example.jpg]]</nowiki></code>
If you add a pipe (|) and some text after the filename, the text will be used as alternative text for text-only browsers:
<code><nowiki>[[File:Example.jpg|alternative text]]</nowiki></code>
If you don't want to display the image, you can link to the file's description page, by adding a colon:
<code><nowiki>[[:File:Example.jpg]]</nowiki></code>
To bypass the description page and link directly to a file , use the "Media" pseudo-namespace:
<code><nowiki>[[Media:Example.jpg]]</nowiki></code>
You can also make piped links if you want some other text to be used:
<code><nowiki>[[:File:Example.jpg|link text]]</nowiki></code>
<code><nowiki>[[Media:Example.jpg|link text]]</nowiki></code>

==External images==
You can embed external images using the same syntax used for linking to an external web page.
<code><nowiki>[http://url.for/some/image.png]</nowiki></code>
Or with different text:
<code><nowiki>[http://url.for/some/image.png link text here]</nowiki></code>

==Syntax for displaying an image==
The full syntax for displaying an image is:
<code><nowiki>[[File:{name}|{options}]]</nowiki></code>
Where options can be zero or more of the following, separated by pipes:
*<code>thumb</code>, <code>thumbnail</code>, or <code>frame</code>: Controls how the image is formatted
*<code>left</code>, <code>right</code>, <code>center</code>, <code>none</code>: Controls the alignment of the image on the page
*<code>{width}px</code>: Resizes the image to the given width in pixels
*<code>{caption text}</code>
The options can be given in any order. If a given option does not match any of the other possibilities, it is assumed to be the caption text. Caption text can contain wiki links or other formatting.

==Gallery of images==
It's easy to make a gallery of thumbnails with the <code><nowiki><gallery></nowiki></code> tag. The syntax is:
<pre>
<gallery>
Image:{filename}|{caption}
Image:{filename}|{caption}
{...}
</gallery>
</pre>
Captions are optional, and may contain wiki links or other formatting.

for example:
<pre>
<gallery>
Image:Example.jpg|Item 1
Image:Example.jpg|a link to [[Help:Contents]]
Image:Example.jpg
Image:Example.jpg
Image:Example.jpg|''italic caption''
</gallery>
</pre>
is formatted as:
<gallery>
Image:Example.jpg|Item 1
Image:Example.jpg|a link to [[Help:Contents]]
Image:Example.jpg
Image:Example.jpg
Image:Example.jpg|''italic caption''
</gallery>

==Examples==

{| {{Prettytable}}
|-
||'''Description'''
||'''You type'''
||'''You get'''
|-
|Embed image (with alt text)
|
<code><nowiki>[[File:Example.jpg|Sunflowers]]</nowiki></code>
|
[[File:Example.jpg|Sunflowers]]
|-
|Link to description page
|
<code><nowiki>[[:File:Example.jpg]]</nowiki></code> 
<code><nowiki>[[:File:Example.jpg|Sunflowers]]</nowiki></code>
|
[[:File:Example.jpg]] 
[[:File:Example.jpg|Sunflowers]]
|-
|Link directly to file
|
<code><nowiki>[[Media:Example.jpg]]</nowiki></code> 
<code><nowiki>[[Media:Example.jpg|Sunflowers]]</nowiki></code>
|
[[Media:Example.jpg]] 
[[Media:Example.jpg|Sunflowers]]
|-
|Thumbnail (centered, 100 pixels wide, with caption)
|
<code><nowiki>[[File:Example.jpg|center|thumb|100px|Sunflowers]]</nowiki></code>
|
[[File:Example.jpg|center|thumb|100px|Sunflowers]]
|-
|Border (100 pixels) Results in a very small gray border

|
<code><nowiki>[[File:Example.jpg|border|100px]]</nowiki></code>
|
[[File:Example.jpg|border|100px]]
|-
|Frameless Like thumbnail, respect user preferences for image width but without border and no right float.
|
<code><nowiki>[[File:Example.jpg|frameless]]</nowiki></code>
|
[[File:Example.jpg|frameless]]
|}

__NOEDITSECTION__

[[Category:Help]]

Help:Images - Revision history

Timo.Kouwenhoven: Created page with "If you want to include images in an article, you can use uploaded files or you can link to external files. ==Uploaded files== To use an image or other file which has been [[Help..."