Short Description
Explains the [[image]] syntax
Single images
To insert an image into the page use the following syntax:
[[image image-source attribute1="value1" attribute2="value2" ...]]
And here is the list of allowed attributes:
attribute name | allowed values | example value | description |
---|---|---|---|
link | wiki page name or URL | "wiki-page" "http://www.example.com" |
makes image a link to another page or web address; this is ignored when using Flickr as a source; prepend the link with '*' to make it open in a new window |
alt | any string | "a photo of me" | text substitution when image not available |
width | number of pixels | "200px" | forces width of a image when displaying |
height | number of pixels | "200px" | forces height of a image when displaying |
style | valid CSS style definition | "border: 1px solid red; padding: 2em;" | adds extra CSS style to the image |
class | CSS class | "mystyle" | forces the image CSS class - suggested use only with customized themes |
size | "square" - 75x75 pixels "thumbnail" - 100 on longest side "small" - 240 on longest side "medium" - 500 on longest side "large" - 1024 on longest side (only for Flickr large images) "original" - original image (Flickr only) |
any of allowed ;-) | displays a resized image; great for thumbnails if flickr is the source it pulls required size from a Flickr server; this option has effect only on local images or Flickr images |
size attribute works very well with local files (attached to pages) not only with image files, but with e.g. PDF or PostScript. See this page for more details.
The image-source can be one of the following:
source type | format | example value | description |
---|---|---|---|
URL address | any valid URL address | http://www.example.com/image.jpg | displays image from the web address |
file attachment (current page) | filename | exampleimage.jpg | displays image attached to the current page |
:first | :first | :first | displays first image attached to the current page (or nothing at all) |
file attachment (different page) | /another-page-name/filename | /another-page/exampleimage.jpg | displays image attached to a different page |
flickr image | flickr:photoid | flickr:83001279 | displays image from Flickr and links to the original Flickr page |
flickr image (private) | flickr:photoid_secret | flickr:149666562_debab08866 | displays image from Flickr and links to the original Flickr page; if the secret is provided the image is available despite being marked as non-public |
To make the linked document in a new window you can either prepend the link attribute with '*' (e.g. link="*http://www.example.com" or prepend the src element with '*' (e.g. *flickr:149666562_debab08866, *image-file etc.) for images that automatically generate links.
To choose horizontal alignment use:
- [[=image… - centered image
- [[<image… - image on left
- [[>image… - image on right
- [[f<image… - image on left floating (surrounded by text)
- [[f>image… - image on right floating (surrounded by text)