Help:Images

From RationalWiki
(Difference between revisions)
Jump to: navigation, search
(nn px: added upright)
(cleanup)
Line 16: Line 16:
 
(''Note: a standard block of  latin text is used throughout to demonstrate wrapping.'')  
 
(''Note: a standard block of  latin text is used throughout to demonstrate wrapping.'')  
  
<nowiki>[[Image:</nowiki>’’Image name’’]] places the actual image  on the page:  <nowiki>[[Image:Stilton.jpg]]</nowiki> puts the image unaltered and unadorned on the page: [[Image:Stilton.jpg]]{{lorem ipsum}}<br> It will be inline and appear in the place where the ''call'' is made but, as can be seen here, will probably disrupt page formatting. ‘’(don’t forget to include the filetype – in the above case “.jpg”){{clear}}
+
<nowiki>[[Image:</nowiki>’’Image name’’]] places the actual image  on the page:  <nowiki>[[Image:Stilton.jpg]]</nowiki> puts the image unaltered and unadorned on the page: [[Image:Stilton.jpg]]
  
 +
It will be inline and appear in the place where the ''call'' is made but, as can be seen here, will probably disrupt page formatting. ‘’(don’t forget to include the filetype – in the above case “.jpg”){{clear}}
  
 
+
Additional "controls" should be separated by '''pipes''' ('''|'''):
<big><big><big>'''♦'''</big></big></big> Additional "controls" should be separated by '''pipes''' ('''|'''):<br>
+
  
 
===frame and thumb===
 
===frame and thumb===
 
To define the  formatting of the image use : ''frame'' or ''thumb''<br><nowiki>[[Image:Stilton.jpg|frame]]</nowiki> produces: <br>[[Image:Stilton.jpg|frame]] which puts the image at actual size in a frame and wraps text to the left:  
 
To define the  formatting of the image use : ''frame'' or ''thumb''<br><nowiki>[[Image:Stilton.jpg|frame]]</nowiki> produces: <br>[[Image:Stilton.jpg|frame]] which puts the image at actual size in a frame and wraps text to the left:  
{{lorem ipsum}}{{clear}}
+
{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
 
<nowiki>[[Image:Stilton.jpg|thumb]]</nowiki> produces: <br>[[Image:Stilton.jpg|thumb]] This constrains the size of the image to the  viewer’s preferred size (as set in preferences) or 180 pixels wide if no preference has been set, and puts it in a frame. The image will appear on the right and text will flow around the left
 
<nowiki>[[Image:Stilton.jpg|thumb]]</nowiki> produces: <br>[[Image:Stilton.jpg|thumb]] This constrains the size of the image to the  viewer’s preferred size (as set in preferences) or 180 pixels wide if no preference has been set, and puts it in a frame. The image will appear on the right and text will flow around the left
{{lorem ipsum}} {{clear}}
+
{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
  
 
[[#top|Back to top]]
 
[[#top|Back to top]]
  
 
===right, left, center===
 
===right, left, center===
To change the horizontal positioning of the image use '''right''' (default: i.e. if no position is specified the positioning will be ''right''), '''left''' or '''center''' (''left'' & ''right'' cause the accompanying text to ''wrap'' around the picture).<br><nowiki>[[Image:Stilton.jpg|thumb|left]]</nowiki> produces:<br> [[Image:Stilton.jpg|thumb|left]]which puts the image (in this case thumbnailed) on the left with text flowing to the right.
+
To change the horizontal positioning of the image use '''right''' (default: i.e. if no position is specified the positioning will be ''right''), '''left''' or '''center''' (''left'' & ''right'' cause the accompanying text to ''wrap'' around the picture).
{{lorem ipsum}} {{clear}}
+
 
<nowiki>[[Image:Stilton.jpg|frame|center]]</nowiki> produces:[[Image:Stilton.jpg|frame|center]]with '''no''' text wrapping.<br>{{lorem ipsum}}
+
<nowiki>[[Image:Stilton.jpg|thumb|left]]</nowiki> produces:
 +
 
 +
[[Image:Stilton.jpg|thumb|left]] which puts the image (in this case thumbnailed) on the left with text flowing to the right.
 +
{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}} {{clear}}
  
 +
<nowiki>[[Image:Stilton.jpg|frame|center]]</nowiki> produces:[[Image:Stilton.jpg|frame|center]] with '''no''' text wrapping.<br>{{lorem ipsum}}
  
  
(''Note: to prevent or stop wrapping place template <nowiki>{{clear}}</nowiki> at teh point required.''){{clear}}
+
(''Note: to prevent or stop wrapping place template <nowiki>{{clear}}</nowiki> at the point required.''){{clear}}
  
 
[[#top|Back to top]]
 
[[#top|Back to top]]
Line 44: Line 48:
 
The size of a any image can be specified by declaring the ''width'' in pixels.  The height is adjusted proportionally automatically.
 
The size of a any image can be specified by declaring the ''width'' in pixels.  The height is adjusted proportionally automatically.
  
<nowiki>[[Image:Stilton.jpg|thumb|left|40px]]</nowiki> produces:<br>[[Image:Stilton.jpg|thumb|left|40px]]<br>{{lorem ipsum}}{{clear}}
+
<nowiki>[[Image:Stilton.jpg|thumb|left|40px]]</nowiki> produces:
 +
 
 +
[[Image:Stilton.jpg|thumb|left|40px]]{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
  
 
Both width and height can be specified. The image will be scaled proportionally so that it fits withing the specified rectangle.
 
Both width and height can be specified. The image will be scaled proportionally so that it fits withing the specified rectangle.
  
<nowiki>[[Image:Stilton.jpg|thumb|left|400x60px]]</nowiki> produces:<br>[[Image:Stilton.jpg|thumb|left|400x60px]]<br>{{lorem ipsum}}{{clear}}
+
<nowiki>[[Image:Stilton.jpg|thumb|left|400x60px]]</nowiki> produces:
 +
 
 +
[[Image:Stilton.jpg|thumb|left|400x60px]]{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
  
 
Specifying the size overrides the viewer's thumbnail size preference. Images with ''thumb'' should not have a pixel size for this reason.
 
Specifying the size overrides the viewer's thumbnail size preference. Images with ''thumb'' should not have a pixel size for this reason.
Line 57: Line 65:
 
Tall images can become too large compared to other thumbnails. To fix this, the ''upright'' option can be used to make them narrower.
 
Tall images can become too large compared to other thumbnails. To fix this, the ''upright'' option can be used to make them narrower.
  
<nowiki>[[Image:Stalactite.jpg|thumb]]</nowiki> produces:<br>[[Image:Stalactite.jpg|thumb]]<br>{{lorem ipsum|2}}{{clear}}
+
<nowiki>[[Image:Stalactite.jpg|thumb]]</nowiki> produces:
 +
 
 +
[[Image:Stalactite.jpg|thumb]]{{lorem ipsum|2|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
 +
 
 +
<nowiki>[[Image:Stalactite.jpg|thumb|upright]]</nowiki> produces:
  
<nowiki>[[Image:Stalactite.jpg|thumb|upright]]</nowiki> produces:<br>[[Image:Stalactite.jpg|thumb|upright]]<br>{{lorem ipsum|2}}{{clear}}
+
[[Image:Stalactite.jpg|thumb|upright]]{{lorem ipsum|2|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
  
 
Upright resizes the image so that its width is .8 times the normal thumbnail size. It also allows specifying a different value.
 
Upright resizes the image so that its width is .8 times the normal thumbnail size. It also allows specifying a different value.
  
<nowiki>[[Image:GISP2D1837.jpg|thumb|left]]</nowiki> produces:<br>[[Image:GISP2D1837.jpg|thumb|left]]<br>{{lorem ipsum}}{{clear}}
+
<nowiki>[[Image:GISP2D1837.jpg|thumb|left]]</nowiki> produces:
  
<nowiki>[[Image:GISP2D1837.jpg|thumb|left|upright=.5]]</nowiki> produces:<br>[[Image:GISP2D1837.jpg|thumb|left|upright=.5]]<br>{{lorem ipsum}}{{clear}}
+
[[Image:GISP2D1837.jpg|thumb|left]]{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
 +
 
 +
<nowiki>[[Image:GISP2D1837.jpg|thumb|left|upright=.5]]</nowiki> produces:
 +
 
 +
[[Image:GISP2D1837.jpg|thumb|left|upright=.5]]{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
  
 
Values greater than 1.0 are also allowed.
 
Values greater than 1.0 are also allowed.
  
<nowiki>[[Image:GISP2D1837.jpg|thumb|left|upright=1.2]]</nowiki> produces:<br>[[Image:GISP2D1837.jpg|thumb|left|upright=1.2]]<br>{{lorem ipsum}}{{clear}}
+
<nowiki>[[Image:GISP2D1837.jpg|thumb|left|upright=1.2]]</nowiki> produces:
  
However, thumbnails will never be enlarged above their original size, so this will have no effect on images that are smaller than the thumbnail size.
+
[[Image:GISP2D1837.jpg|thumb|left|upright=1.2]]{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
 +
 
 +
However, thumbnails will never be enlarged above their original size, so this will have no effect on images that are smaller than the thumbnail size. The resulting size will be rounded to the nearest multiple of 10.
 +
 
 +
[[#top|Back to top]]
  
 
===''Caption''===
 
===''Caption''===
A caption can be included in the frame (quotation marks are '''not''' required);<br><nowiki>[[Image:Stilton.jpg|frame|left|Cheese]]</nowiki> produces:<br>[[Image:Stilton.jpg|frame|left|Cheese]]<br>{{lorem ipsum}}{{clear}}
+
A caption can be included in the frame (quotation marks are '''not''' required);
<nowiki>[[Image:Stilton.jpg|thumb|center|100px|Cheese]]</nowiki> produces:<br>[[Image:Stilton.jpg|thumb|center|100px|Cheese]]<br>{{lorem ipsum}}{{clear}}
+
 
 +
<nowiki>[[Image:Stilton.jpg|frame|left|Cheese]]</nowiki> produces:
 +
 
 +
[[Image:Stilton.jpg|frame|left|Cheese]]{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
 +
 
 +
<nowiki>[[Image:Stilton.jpg|thumb|center|100px|Cheese]]</nowiki> produces:
 +
 
 +
[[Image:Stilton.jpg|thumb|center|100px|Cheese]]{{lorem ipsum|1|2=<span style="color:lightgrey;">|3=</span>}}{{clear}}
  
 
[[#top|Back to top]]
 
[[#top|Back to top]]
Line 171: Line 198:
 
===Example===
 
===Example===
 
[[Image:Stilton.jpg|alt text]]
 
[[Image:Stilton.jpg|alt text]]
 
==New syntax for images==
 
 
[[Image:Stilton.jpg|thumb|100px|left|A lovely piece of cheese]]
 
In the syntax <tt><nowiki>[[</nowiki>Image:''filename''|''options''<nowiki>]]</nowiki></tt> (e.g. <tt><nowiki>[[Image:Stilton.jpg|thumb|100px|left| A lovely piece of cheese]]</nowiki></tt> shown in the left), several options can be set when including an image. Those affect the placing of the image, its size or the way the image will be presented. The options are <tt>right</tt>, <tt>left</tt>, <tt>center</tt>, <tt>none</tt>, <tt>''size''px</tt>, <tt>thumbnail</tt> (<tt>thumb</tt>), <tt>frame</tt>, and <tt>''alternate (caption) text''</tt>.{{clear}}
 
 
[[Image:Stilton.jpg|thumb|Stilton.jpg|200px|right| A lovely piece of cheese]]
 
* The options can be combined, and vertical bars ("|") are used to separate options from each other.
 
* Do not put spaces around the vertical bars for readability &ndash; options will not be interpreted correctly.
 
* The options can be put in any order. 
 
* An unknown option is taken as the caption text, but this will appear only if <tt>thumbnail</tt> or <tt>frame</tt> are specified. 
 
* If there are two or more unknown options, the last one upstages the rest: <tt><nowiki>[[Image:Stilton.jpg|thumb|Stilton.jpg|200px|right| A lovely piece of cheese]]</nowiki></tt> (shown on the right).{{clear}}
 
 
Here is the description of the options other than the caption text:
 
 
; <tt>right</tt> : [[Image:Stilton.jpg|right|70px|]]The image is right-aligned, and text floats to the left of the image: <tt><nowiki>[[Image:Stilton.jpg|right|70px|]]</nowiki></tt> (shown on the right).{{clear}}
 
; <tt>left</tt> : [[Image:Stilton.jpg|left|70px|]]The image is left aligned, and text floats to the right of the image: <tt><nowiki>[[Image:Stilton.jpg|left|70px|]]</nowiki></tt> (shown on the left).{{clear}}
 
; <tt>center</tt> : The image is centered, and...[[Image:Stilton.jpg|center|70px|]]the text following the image starts below it: <tt><nowiki>[[Image:Stilton.jpg|center|70px|]]</nowiki></tt> (shown above).{{clear}}
 
; <tt>none</tt> : The image is put at the left, and...[[Image:Stilton.jpg|none|70px|]]the text following does not float to the right (or to the left, obviously), and starts below it: <tt><nowiki>[[Image:Stilton.jpg|none|70px|]]</nowiki></tt> (shown above).{{clear}}
 
 
 
:: '''Notes:'''{{clear}}
 
::[[Image:Stilton.jpg|none|right|center|left|70px|]]The above four options are incompatible.  When used combined, the last one overrides the rest: <tt><nowiki>[[Image:Stilton.jpg|none|right|center|left|70px|]]</nowiki></tt> (shown on the left).{{clear}}
 
 
::[[Image:Stilton.jpg|70px|right]]What is between the last vertical bar and the closing brackets ("]]"), void or not, is taken as the last option, and works as usual.  For instance, when the last option is <tt>right</tt>, the image is right-aligned, and text floats to the left: <tt><nowiki>[[Image:Stilton.jpg|70px|right]]</nowiki></tt> (shown on the right).{{clear}}
 
 
::[[Image:Stilton.jpg|thumb|This text is not displayed.|70px|left|]][[Image:Stilton.jpg|thumb|This text is displayed.|70px|right]]In particular, if the last option is the void text (that is, if there is nothing between the last vertical bar and the closing brackets), the caption is not displayed: <tt><nowiki>[[Image:Stilton.jpg|thumb|This text is not displayed.|70px|left|]]</nowiki></tt> (shown on the left) and <tt><nowiki>[[Image:Stilton.jpg|thumb|This text is displayed.|70px|right]]</nowiki></tt> (shown on the right).{{clear}}
 
 
; <tt>''size''px</tt> : [[Image:Stilton.jpg|right|50px|]]This option renders a version of the image that's ''[size]'' pixels wide (e.g. <tt><nowiki>[[Image:Stilton.jpg|right|50px|]]</nowiki></tt> shown on the right). Height is computed to keep [[wp:aspect ratio (image)|aspect ratio]] (i.e. the shape of the image){{clear}}
 
 
:: '''Notes:'''{{clear}}
 
::Specifying a size does not just change the apparent image size using HTML; it actually generates a resized version of the image on the fly and links to it appropriately.  This happens whether or not you use '''size''' in conjunction with '''thumb'''.''
 
 
::This means the server does all the work of changing the image size, not the web browser of the user.  By having the server do all the work means faster downloading of pages.  It also means that larger images can be stored on the server without any slowdown by the browser (especially on dial up telephone lines.)  Only the data for the actual size on the page is transmitted.
 
 
::From [|MediaWiki 1.5]] the default thumbnail width can be set in the preferences, so it is recommended ''not'' to specify "px", in order to respect the users' preferences (unless, for a special reason, a specific size is required regardless of preferences, or a size is specified outside the range of widths 120–300px that can be set in the preferences).
 
 
:: If you specify a "frame" option the image will not be scaled, and no size specifiers will be in the HTML.  The image will be rendered at full size{{clear}}
 
 
:: [[Image:Stilton.jpg|right|50px|80px]]When there are two or more "size" options, only the last one is valid: <tt><nowiki>[[Image:Stilton.jpg|right|50px|80px]]</nowiki></tt> (shown on the right).{{clear}}
 
 
; <tt>thumbnail</tt>, <tt>thumb</tt> : [[Image:Stilton.jpg|thumbnail|left|100px|]][[Image:Stilton.jpg|thumb| A lovely piece of cheese]]The <tt>thumbnail</tt> (<tt>thumb</tt>) option generates a thumbnail image. It is automatically resized when the "size" attribute is not specified. Without the options <tt>left</tt>, <tt>center</tt>, and <tt>none</tt>, the image is  normally on the right.  If the image has a caption text, it is displayed in the lower margin. E.g. <tt><nowiki>[[Image:Stilton.jpg|thumbnail|left|100px|]]</nowiki></tt> (shown on the left) and <tt><nowiki>[[Image:Stilton.jpg|thumb| A lovely piece of cheese]]</nowiki></tt> (shown on the right).  ''Note: thumbnail (thumb) cannot be used in lists.''
 
{{clear}}
 
 
The above has been copied and adapted from [[wp:Extended image syntax|Wikipedia]]. There is more information on that page.
 
  
 
{{Helpnav}}{{keyword|helpkey=Image}}
 
{{Helpnav}}{{keyword|helpkey=Image}}

Revision as of 11:08, 25 October 2009

Note: throughout this page: Namespace "Image" should be replaced with namespace "File" because of Mediawiki upgrade. ("Image" still works, however)

Contents

Uploading an Image

To upload an image click upload image in the toolbox at the left of the screen, and browse on your hard drive for the image you want. Please try to give it a useful, descriptive name.

If the file is out there on the web somewhere, first save it to your hard drive, after ascertaining that it is not copyrighted. It is good form to include in your upload notes where the source was, even if the image is public domain, and especially if it falls under some type of "copyleft" permission. If the image is large or includes redundant white space (etc.), please edit it on your computer first.

Often, images seen on a web page are not the full size - you might want to click on the image to save the full size version, and then adapt it yourself to whatever size is appropriate for this site.

DISCLAIMER: Persons of delicate sensibilities or with any kind of cheese phobia or dairy food allergy should be warned that many depictions of Blue Stilton Cheese appear on this page. The management disclaim any responsibility for any harm accruing to viewers who continue beyond this warning. Anyone confused by the text accompanying the example images should see here.

Placing an image on a page

Summary: [[Image:name|thumb/frame|left/right/center|size px|caption ]]


(Note: a standard block of latin text is used throughout to demonstrate wrapping.)

[[Image:’’Image name’’]] places the actual image on the page: [[Image:Stilton.jpg]] puts the image unaltered and unadorned on the page: Stilton.jpg

It will be inline and appear in the place where the call is made but, as can be seen here, will probably disrupt page formatting. ‘’(don’t forget to include the filetype – in the above case “.jpg”)

Additional "controls" should be separated by pipes (|):

frame and thumb

To define the formatting of the image use : frame or thumb
[[Image:Stilton.jpg|frame]] produces:
Stilton.jpg
which puts the image at actual size in a frame and wraps text to the left:

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

[[Image:Stilton.jpg|thumb]] produces:
Stilton.jpg
This constrains the size of the image to the viewer’s preferred size (as set in preferences) or 180 pixels wide if no preference has been set, and puts it in a frame. The image will appear on the right and text will flow around the left

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Back to top

right, left, center

To change the horizontal positioning of the image use right (default: i.e. if no position is specified the positioning will be right), left or center (left & right cause the accompanying text to wrap around the picture).

[[Image:Stilton.jpg|thumb|left]] produces:

Stilton.jpg
which puts the image (in this case thumbnailed) on the left with text flowing to the right.

Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

[[Image:Stilton.jpg|frame|center]] produces:
Stilton.jpg
with no text wrapping.
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.


(Note: to prevent or stop wrapping place template {{clear}} at the point required.)

Back to top

nn px

The size of a any image can be specified by declaring the width in pixels. The height is adjusted proportionally automatically.

[[Image:Stilton.jpg|thumb|left|40px]] produces:

Stilton.jpg
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Both width and height can be specified. The image will be scaled proportionally so that it fits withing the specified rectangle.

[[Image:Stilton.jpg|thumb|left|400x60px]] produces:

Stilton.jpg
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Specifying the size overrides the viewer's thumbnail size preference. Images with thumb should not have a pixel size for this reason.

Back to top

upright

Tall images can become too large compared to other thumbnails. To fix this, the upright option can be used to make them narrower.

[[Image:Stalactite.jpg|thumb]] produces:

Stalactite.jpg
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

[[Image:Stalactite.jpg|thumb|upright]] produces:

Stalactite.jpg
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Curabitur pretium tincidunt lacus. Nulla gravida orci a odio. Nullam varius, turpis et commodo pharetra, est eros bibendum elit, nec luctus magna felis sollicitudin mauris. Integer in mauris eu nibh euismod gravida. Duis ac tellus et risus vulputate vehicula. Donec lobortis risus a elit. Etiam tempor. Ut ullamcorper, ligula eu tempor congue, eros est euismod turpis, id tincidunt sapien risus a quam. Maecenas fermentum consequat mi. Donec fermentum. Pellentesque malesuada nulla a mi. Duis sapien sem, aliquet nec, commodo eget, consequat quis, neque. Aliquam faucibus, elit ut dictum aliquet, felis nisl adipiscing sapien, sed malesuada diam lacus eget erat. Cras mollis scelerisque nunc. Nullam arcu. Aliquam consequat. Curabitur augue lorem, dapibus quis, laoreet et, pretium ac, nisi. Aenean magna nisl, mollis quis, molestie eu, feugiat in, orci. In hac habitasse platea dictumst.

Upright resizes the image so that its width is .8 times the normal thumbnail size. It also allows specifying a different value.

[[Image:GISP2D1837.jpg|thumb|left]] produces:

GISP2D1837.jpg
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

[[Image:GISP2D1837.jpg|thumb|left|upright=.5]] produces:

GISP2D1837.jpg
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Values greater than 1.0 are also allowed.

[[Image:GISP2D1837.jpg|thumb|left|upright=1.2]] produces:

GISP2D1837.jpg
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

However, thumbnails will never be enlarged above their original size, so this will have no effect on images that are smaller than the thumbnail size. The resulting size will be rounded to the nearest multiple of 10.

Back to top

Caption

A caption can be included in the frame (quotation marks are not required);

[[Image:Stilton.jpg|frame|left|Cheese]] produces:

Cheese
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

[[Image:Stilton.jpg|thumb|center|100px|Cheese]] produces:

Cheese
Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Back to top

Setting up a "Gallery"

A title, height/width to display, and the number of images across can be stipulated. Each image can be individually captioned if desired:

<gallery caption="Buttons gallery" widths="100px" heights="100px" perrow="3">
Image:bold-button.png|<center>This '''Bolds'''</center>
Image:HeaderButt.png
Image:ImageButt.png|Lets you add an ''image''
Image:IntLinkButt.png|Gives you an internal link
Image:ItalicButton.png|''Slopes''
Image:LineButt.png
Image:MathButt.png|<small>Doesn't appear to work.</small>
Image:MediaButt.png|But we've '''no''' media. 
Image:NetLinkButt.png
Image:NoWikiButt.png|Makes things <br>[[Not Work]]
Image:SigButt.png
</gallery> 

produces:

Back to top

Fillers

There are 3 fillers: 1pxBlack, 1pxGray and 1pxWhite. These are usually used to create buffer space:

[[Image:1pxBlack.gif|150px]] [[Image:1pxWhite.gif|250px]] [[Image:1pxGray.gif|77px]]{{clear}}

produces:
File:1pxBlack.gif File:1pxWhite.gif File:1pxGray.gif

What use these may be, who knows, but they're there if you need them.

Wikipedia Help file (amended)

In brief, the syntax for displaying an image is:

[[Image:{name}|{type}|{location}|{size}|{upright}|{border}|{caption}]]

Only [[Image:{name}]] is required. Most images should use [[Image:{name}|thumb|Example image caption]] (and should not specify a size). The other details are optional and can be placed in any order.


Type 
'thumb' / 'thumbnail' or 'frame'. Causes image to be displayed with specific formatting (see below).
Location 
'right', 'left', 'center' or 'none'. Determines placement of the image on the page. Defaults to 'right'.
Size 
{width}px or {width}x{height}px, scales the image to be no greater than the given width and height, keeping its aspect ratio.
Upright 
primarily intended for use on tall images, this option sets the width to 0.8 times the viewer's preferred thumbnail size. The factor can be specified explicitly, e.g. upright=0.6 or upright=1.2.
Border 
adds a border around the image
Caption 
Any element which cannot be identified as one of the above is assumed to be caption text.

Detailed syntax

Type

  • "thumbnail" or "thumb": Image is scaled down to a standard, user specified width, by default 180 pixels, and a box is added around the image. If a caption is written, it is shown below the image. Image defaults to placement on the 'right' unless overridden with the 'Location' attribute (see above).
  • "frame": Original image size is preserved, and a box is added around the image. If a caption is written, it is shown below the image.
  • (nothing specified): Original image size is preserved, no border is added around the image. If a caption is written, it is not shown.
  • "border": Same as if nothing is specified, but a border is added around the image.

Location

  • "right": Image including its box is placed on the right side of the page. The article text that follows the image flows around the image.
  • "left": Image including its box is placed on the left side of the page. The article text that follows the image flows around the image.
  • "center": Image including its box is placed in the center of the page. The article text that follows the image is placed below the image.
  • "none": Image including its box is placed on the left side of the page. The article text that follows the image is placed below the image.

Size

  • "100px": Scales the image down to make it 100 pixels wide. Replace any number for 100. If you specify "thumbnail" and a value here, this value will take precedence. If the image is already smaller than your specified value, the image stays at its size.
  • "100x200px": Scales the image to be no wider than 100 pixels and no higher than 200 pixels. Image will keep its original aspect ratio.
  • (nothing specified): Uses the size specified in preferences for logged in users, uses a size determined by resolution for anonymous users.

Caption

Any element which cannot be identified as one of the above is assumed to be caption text.

Syntax to use an image in uploaded size, with a caption

To use an image as uploaded with a caption use [[Image:Stilton.jpg|frame|none|caption text]]. This is the syntax you should use to update images that used the original image markup of the form [[Image:Stilton.jpg|caption]]

caption text

Syntax for images with no automatic caption or formatting

Example

alt text

Personal tools
Namespaces

Variants
Actions
Navigation
Community
Tools
support