Difference between revisions of "Help:Image"

Latest revision as of 01:49, 29 November 2013

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[edit source]

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[edit source]

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.
- |none - The image will have no floating alignment. Best for tables.

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

Link
- |link= - Makes it possible to use the image as a link. Works on both external and internal links. Can't be used with the "thumb" variable.

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".]]
[[Image:Jay_Wilson.jpg|right|150px|link=Jay Wilson]]

Notice how the "150px" attribute on the "frame" image does not work, and that the link for the lowest image leads to Jay Wilson directly, rather than to the image of him.

Caption about Jay Wilson in a "frame".

Caption about Jay Wilson in a "thumbnail".

Spacing Between Images[edit source]

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[edit source]

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[edit source]

To upload images to the wiki, there are primarily two ways; either create the wiki syntax for the image first, and then click on the red link to upload, just like you would when creating a new article, or you can go to the upload page of the wiki.

When uploading, make sure to adhere to the title policies of DiabloWiki, and to add it in the appropriate categories. You might want to check with the category structure to see what categories it will fit in.

Gallery of Images[edit source]

The other functional use of pictures on a page is to make a gallery of pictures. The wiki code "<gallery></gallery>" will create a 4xX gallery that auto-fills with more pictures. The gallery will be four columns of pictures wide, and any number of rows. The gallery can either be just thumbnails, or thumbnails with captions. Just make wiki syntax like illustrated below, and add one DiabloWiki image page name per row:

<gallery>
File:Jay_Wilson.jpg
File:Jay_Wilson.jpg|Caption 1
File:Jay_Wilson.jpg|Caption 2
File:Jay_Wilson.jpg|Link: [[Jay Wilson]]
File:Jay_Wilson.jpg|Lead Designer D3
File:Jay_Wilson.jpg
File:Jay_Wilson.jpg|Last pic
</gallery>

This is what it would look like:

Caption 1
Caption 2
Link: Jay Wilson
Lead Designer D3
Last pic

Notice that the 8th picture place is empty until one more picture is added.

Linking to Images[edit source]

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 ("|").

@@ Line 22: / Line 22: @@
 ** <span style="color:white;">|left</span> - Aligns the image floating to the left. Text will align around the right hand side.
 ** <span style="color:white;">|center</span> - Centers the image on the page. Text aove and below only.
+** <span style="color:white;">|none</span> - The image will have no floating alignment. Best for [[Help:Table|tables]].
 * '''Size'''
-** <span style="color:white;">|150px</span> - Sets the width of the image to 150 pixels. The image size ration is preserved.
+** <span style="color:white;">|150px</span> - Sets the width of the image to 150 pixels. The image size ratio is preserved.
-** <span style="color:white;">|150px100px</span> - The image becomes no wider than 150 pixels and no higher than 100 pixels. The image size ration is preserved.
+** <span style="color:white;">|150px100px</span> - The image becomes no wider than 150 pixels and no higher than 100 pixels. The image size ratio is preserved.
 ** If not used, it will use the standard size.
+* '''Link'''
+** <span style="color:white;">|link=</span> - Makes it possible to use the image as a link. Works on both external and internal links. Can't be used with the "thumb" variable.
 * '''Caption''' - Any element that isn't identified as one of the above.
 ** <span style="color:white;">|(any text)</span> - 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:
@@ Line 35: / Line 40: @@
 * <nowiki>[[Image:Jay_Wilson.jpg|right|150px|Caption not working.]]</nowiki>
 * <nowiki>[[Image:Jay_Wilson.jpg|thumb|150px|Caption about [[Jay Wilson]] in a "thumbnail".]]</nowiki>
+* <nowiki>[[Image:Jay_Wilson.jpg|right|150px|link=Jay Wilson]]</nowiki>
+Notice how the "150px" attribute on the "frame" image does not work, and that the link for the lowest image leads to Jay Wilson directly, rather than to the image of him.
+[[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".]]
+[[Image:Jay_Wilson.jpg|right|150px|link=Jay Wilson]]
-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.
-[[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".]]
 <div style="clear:both;"></div>
@@ Line 63: / Line 73: @@
 ==Uploading Images==
-To upload images to the wiki, there are primarily two ways
+To upload images to the wiki, there are primarily two ways; either create the wiki syntax for the image first, and then click on the red link to upload, just like you would when creating a new [[Help:Article|article]], or you can go to the [[Special:Upload|upload page]] of the wiki.
+When uploading, make sure to adhere to the [[{{WikiTitle}}:Policy|title policies]] of {{WikiTitle}}, and to add it in the appropriate [[Help:Category|categories]]. You might want to check with the [[Help:Structure|category structure]] to see what categories it will fit in.
 ==Gallery of Images==
+The other functional use of pictures on a page is to make a ''gallery'' of pictures. The wiki code "<nowiki><gallery></gallery></nowiki>" will create a 4xX gallery that auto-fills with more pictures. The gallery will be four columns of pictures wide, and any number of rows. The gallery can either be just thumbnails, or thumbnails with captions. Just make wiki syntax like illustrated below, and add one {{WikiTitle}} image page name per row:
+<blockquote><pre>
+<gallery>
+File:Jay_Wilson.jpg
+File:Jay_Wilson.jpg|Caption 1
+File:Jay_Wilson.jpg|Caption 2
+File:Jay_Wilson.jpg|Link: [[Jay Wilson]]
+File:Jay_Wilson.jpg|Lead Designer D3
+File:Jay_Wilson.jpg
+File:Jay_Wilson.jpg|Last pic
+</gallery>
+</pre></blockquote>
+This is what it would look like:
+<gallery>
+File:Jay_Wilson.jpg
+File:Jay_Wilson.jpg|Caption 1
+File:Jay_Wilson.jpg|Caption 2
+File:Jay_Wilson.jpg|Link: [[Jay Wilson]]
+File:Jay_Wilson.jpg|Lead Designer D3
+File:Jay_Wilson.jpg
+File:Jay_Wilson.jpg|Last pic
+</gallery>
+Notice that the 8th picture place is empty until one more picture is added.
 ==Linking to Images==
@@ Line 85: / Line 114: @@
-To insert an image, just add the following code, that you can see is very similar to other wiki links: <nowiki>[[Image:filename.jpg]]</nowiki>. Make sure you don't forget to write the file extension. The valid image files for {{WikiTitle}} 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 [[Help:Image|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:
-<pre>
-[[:Image:filename.jpg]]
-</pre>
-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:
-<pre>
-{{clickpic|TARGET PAGE TITLE|FULL PATH OF IMAGE FILE}}
-</pre>
-Where "FULL PATH OF IMAGE FILE" is the full path, for example <nowiki> http://www.imaginarywiki.com/wiki/index/image.jpg </nowiki> - 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 [[Special:Upload|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:
-[[Image:Mon-achmel1.jpg|center|thumb|125px|Words about the image.]]
-  <nowiki>[[Image:Mon-achmel1.jpg|center|thumb|125px|Words about the image.]]</nowiki>
-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.
 {{Help navbox}}