Help:Image

Images are always nice to spice up content, and in many cases they are outright needed in order to describe information from a game. Luckily, they are easy enough to add in DiabloWiki.

Adding Images

Jay Wilson, the Lead Game Designer of Diablo 3.

To insert an image on any page, you use a small piece of wiki markup, that you can see is very similar to wiki links: [[Image:filename.jpg]]. Make sure you don't forget to write the file extension. For this instruction we assume the picture is already uploaded to the wiki (more on that further down). The valid image files for DiabloWiki are:

• .gif
• .jpg
• .png

Images will automatically be made into a large size, and justificated to the left side on a page, but it's easy to change these settings with simple variables in the code. In this case we will be using the Jay Wilson image that you can see "thumbnailed" to the right.

Image Code Variables

The following variables can be added by adding a pipe ("|") after the file name:

• Type
  • |frame - Creates a frame around the picture. If a caption is added, it is shown below. Picture retains original size, regardless of "size" attributes. Picture is normally floated right.
  • |thumb - Resizes the picture to a thumbnail, adds a frame and room for a caption. Automatically aligns "right" unless overwritten with a "left" variable.
  • |thumbnail - Same as "thumb".

• Location
  • |right - Aligns the image floating to the right. Text will align around the left hand side.
  • |left - Aligns the image floating to the left. Text will align around the right hand side.
  • |center - Centers the image on the page. Text aove and below only.

• Size
  • |150px - Sets the width of the image to 150 pixels. The image size ration is preserved.
  • |150px100px - The image becomes no wider than 150 pixels and no higher than 100 pixels. The image size ration is preserved.
  • If not used, it will use the standard size.

• Caption - Any element that isn't identified as one of the above.
  • |(any text) - This will create an alternative mouseover tooltip instead of the standard "Image:Jay_Wilson.jpg" on regular images. Will add a caption below the image for "frames" and "thumbs".

Examples:

• [[Image:Jay_Wilson.jpg|left|frame|150px|Caption about [[Jay Wilson]] in a "frame".]]
• [[Image:Jay_Wilson.jpg|right|150px|Caption not working.]]
• [[Image:Jay_Wilson.jpg|thumb|150px|Caption about [[Jay Wilson]] in a "thumbnail".]]

Notice how the "150px" attribute on the "frame" image does not work, and that the caption for the regular image is only shown in the mouseover.

Caption about Jay Wilson in a "frame".

Caption about Jay Wilson in a "thumbnail".

Spacing Between Images

In order to create vertical spacing between images, or to stop text from wrapping around it, some CSS html code must be used. Add the following piece of code in order to stop any new content from being show on the side of a picture:

<div style="clear:both;"></div>

Images as Links

The wiki scripts automatically add the image page (the "article" page where the image's description, categorisation, etc is) as the source of a link that lays on top of the image. There is currently no way to make an image link to somewhere else than its image page with any type of code. Be it CSS, HTML or wiki syntax - it's just not possible.

Uploading Images

To upload images to the wiki, there are primarily two ways

Linking to Images

Sometimes you might want to link directly to an image instead of embedding it on the page. If so there are two ways to do this:

• Use a direct, external, link to the image url: Image
• Use an internal wiki link to the image page: Image

The former way works exactly like any external link (read more about that later), for the link title, URL or a little bracketed link. The latter works just like Category Links, with a ":" in front, and with the possibility to change title with a pipe ("|").

Read more at the markup link syntax.

To insert an image, just add the following code, that you can see is very similar to other wiki links: [[Image:filename.jpg]]. Make sure you don't forget to write the file extension. The valid image files for DiabloWiki are:

• .gif
• .jpg
• .png

Images will automatically be justificated to the left side on a page, but it's easy to change this with variables, to make boxes around images and to change their size. Read more about images on the Image Help page.

The example above shows a jpg, but it may use any valid file extension. Images inserted this way will be placed with left justification, and text will wrap around them.

To link to the GWO Wiki page for the image, type:

[[:Image:filename.jpg]]

Images automatically link to the full page for that image, where the image is displayed full size, along with any caption and copyright info included for it. Images may be set to link directly to other pages, though this is non-standard wiki practice, and its recommended that such links are provided in the image's caption, or are placed directly on the full image page. To link from an image:

{{clickpic|TARGET PAGE TITLE|FULL PATH OF IMAGE FILE}}

Where "FULL PATH OF IMAGE FILE" is the full path, for example http://www.imaginarywiki.com/wiki/index/image.jpg - so this works better with external images, but may be used with images you have uploaded with you use their full path instead of the usual shortcut.

(which must have been previously uploaded to the wiki)

Image Formatting

Images may be presented in various ways by adding commands within the brackets, after the image, separated by "pipes." For example, the image below this paragraph has the following code:

File:Mon-achmel1.jpg

Words about the image.

 [[Image:Mon-achmel1.jpg|center|thumb|125px|Words about the image.]]

The most common image formatting command is "frame" which simply adds a border around an image and (by default) right justifies it. Various other image formatting commands (such as thumb, or inserting a caption) will create a frame automatically, as seen in the above example.

• Right/left/center are valid justifying commands.
• Thumb will thumbnail an image, and should be used when the full image is so large it will affect a page's formatting. Default is 200 pixels wide. If a different display width is desired, simply type it in, immediately after the thumb command, separated by a pipe.
• To caption an image, simply type whatever you wish the caption to be, after the other commands, immediately before the closing double brackets. Wiki formatting is to keep captions as short and to the point as possible. Long captions will stretch the image frame beyond the image, and look ugly.