Help:Images

From GAWDAwiki

This page explains the image syntax when editing the wiki. Before using images in your page, your wiki must have file uploads enabled, and you have to upload a file.

Only members of the Sysops group can upload files. If you are not a sysop and would like to add an image to the wiki, please email the image, its description and any copyright information to editor@gawdawiki.org.

Syntax

The full syntax for displaying an image is:

[[Image:{filename}|{options}]]

Where options can be zero or more of the following, separated by pipes:

• border, frame, thumb, or frameless: Controls how the image is formatted
• left, right, center, none: Controls the alignment of the image within a text
• baseline, sub, super, top, text-top, middle, bottom, text-bottom: Controls the vertical alignment of the image within a text
• {width}px: Resizes the image to the given width in pixels
• {width}x{height}px: Resizes the image to fit within the given width and height in pixels; it is possible to specify only the height by writing x{height}px
• Special cases:
  • page=1: Displays the specified page when showing a djvu file
• link={destination}: Allows to link to an arbitrary title, URL or just nowhere
• alt={alternative text}: For changing the alternative text (alt="") of an image

The options can be given in any order. If the given options conflict each other, the latter is applied, except for the format options, where the options take the priority in the order of frame, thumb, and frameless and/or border. 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.

Link to description page

If you put a colon (:) before Image:, the image will not be embedded and the link will lead to the description page of the file.

[[:Image:Example.jpg]]
[[:Image:Example.jpg|Sunflowers]]

results in

Image:Example.jpg Sunflowers

Files at other websites

You can link to an external file using the same syntax used for linking to an external web page.

[http://url.for/some/image.png]

Or with different text:

[http://url.for/some/image.png link text here]

If it is enabled on your wiki, you can also embed external images. To do that, simply insert the image's url:

http://url.for/some/image.png

For questions regarding uploading images, please contact editor@gawdawiki.org.