From StrategyWiki, the video game walkthrough and strategy guide wiki
Jump to navigation Jump to search
(moving content from StrategyWiki:Guide/Starting a new guide)
(merging image map info from appendix, since they are basically duplicates anyway)
Line 113: Line 113:
</gallery>
</gallery>


==Imagemaps==
==Image maps==
{{details|StrategyWiki:Guide/Image maps}}
Image maps are welcome on StrategyWiki. They are images of which certain portions are clickable as links. You can use visual editors such as [http://www.boutell.com/mapedit/ Mapedit] to assist with drawing the shapes, although this free [http://toolserver.org/~dapete/ImageMapEdit/ImageMapEdit.html?en image map editor] is more than sufficient.
Image maps are welcome on StrategyWiki. They can be inserted as follows:
 
<pre>
<imagemap>
Image:Foo.jpg|200px|Picture of a foo.
poly 131 45 213 41 210 110 127 109 [[Display]]
poly 104 126 105 171 269 162 267 124 [[Keyboard]]
rect 15 95 94 176  [[Foo type A]]
# A comment, this line is ignored
circle 57 57 20    [[Foo type B]]
desc bottom-left
</imagemap>
</pre>
 
Standard image map notation is used. You can use visual editors such as [http://www.boutell.com/mapedit/ Mapedit] to assist with drawing the shapes.
 
See [[The Legend of Zelda: Ocarina of Time/Maps/Overworld]] for a good example of an image map, and see [http://www.mediawiki.org/wiki/Extension:ImageMap the extension's documentation] for further information.


===Syntax description===
===Syntax description===
:''The following comes from [[mw:Extension:ImageMap|ImageMap at MediaWiki.org]]''
The contents of an <nowiki><imagemap></nowiki> tag consists of blank lines, comments (starting with #) and logical lines. The first logical line specifies the image to be displayed. This must be in the same format as an ordinary MediaWiki image link, except without the enclosing <nowiki>[[</nowiki> and <nowiki>]]</nowiki>.  
The contents of an <nowiki><imagemap></nowiki> tag consists of blank lines, comments (starting with #) and logical lines. The first logical line specifies the image to be displayed. This must be in the same format as an ordinary MediaWiki image link, except without the enclosing <nowiki>[[</nowiki> and <nowiki>]]</nowiki>.  


Further lines are split into tokens, separated by whitespace. The function of each line is determined by the first token in the line. '''All coordinates are according to the full-size image, not the visible image'''.
Further lines are split into tokens, separated by whitespace. The function of each line is determined by the first token in the line. '''All coordinates are according to the full-size image, not the visible image'''.


; desc : Specifies the location of the image description link. May be either <tt>top-right</tt>, <tt>bottom-right</tt>, <tt>bottom-left</tt>, <tt>top-left</tt>, or <tt>none</tt>. This puts a blue "i" icon in the specified corner, linking to the image description page. The default is bottom-right. To hide the description link, set it to <tt>none</tt>.
*'''desc''': Specifies the location of the image description link. May be either <tt>top-right</tt>, <tt>bottom-right</tt>, <tt>bottom-left</tt>, <tt>top-left</tt>, or <tt>none</tt>. This puts a blue "i" icon in the specified corner, linking to the image description page. The default is bottom-right. To hide the description link, set it to <tt>none</tt>.
*'''poly''': A polygon. The coordinates of the vertices are given, followed by a link in square brackets. '''Polygons must be defined before any other form!'''
*'''rect''': A rectangle. The parameters are the coordinates of the top-left and bottom-right corners, followed by a title to link to in square brackets.
*'''circle''': A circle. The first two parameters are the coordinates of the center, the third is the radius. The coordinates are followed by a link in square brackets.
*'''default''': This gives the default link, where no other regions are specified.  


; rect : A rectangle. The parameters are the coordinates of the top-left and bottom-right corners, followed by a title to link to in square brackets.  
All coordinates are specified relative to the source image. The image can be scaled using thumbnail syntax, in which case the image map coordinates will be automatically scaled as well.  


; circle: A circle. The first two parameters are the coordinates of the center, the third is the radius. The coordinates are followed by a link in square brackets.
All links are given in either the form <nowiki>[[Page title]]</nowiki> or <nowiki>[[Page title|description]]</nowiki>. In the latter case, the part after the pipe "|" becomes the title attribute of the link – in most browsers, it will pop up as a tooltip when the user hovers over it. If no explicit link description is given, the page title will be used.


; poly: A polygon. The coordinates of the vertices are given, followed by a link in square brackets. '''Polygons must be defined before any other form!'''
Areas which overlap give precedence to the first link listed.


; default: This gives the default link, where no other regions are specified.  
===Example===
<pre><center>
<imagemap>
Image:PKMNGS_JhotoMap.png|Map of Jhoto
rect 543 383 576 416 [[Pokémon Gold and Silver/New Bark Town]]
rect 383 383 416 416 [[Pokémon Gold and Silver/Cherrygrove City]]
rect 319 222 352 255 [[Pokémon Gold and Silver/Violet City]]
rect 255 480 288 513 [[Pokémon Gold and Silver/Azalea Town]]
rect 191 352 224 385 [[Pokémon Gold and Silver/Goldenrod City]]
rect 255 158 288 191 [[Pokémon Gold and Silver/Ecruteak City]]
rect 126 222 159 255 [[Pokémon Gold and Silver/Olivine City]]
rect 61 383 94 416 [[Pokémon Gold and Silver/Cianwood City]]
rect 413 158 436 191 [[Pokémon Gold and Silver/Mahagony Town]]
rect 510 158 543 191 [[Pokémon Gold and Silver/Blackthorn City]]
desc bottom-left
</imagemap>
</center></pre>


All coordinates are specified relative to the source image. The image can be scaled using thumbnail syntax, in which case the image map coordinates will be automatically scaled as well.  
Will give the following image map. Hover mouse over the orange squares to see how the links work.


All links are given in either the form <nowiki>[[Page title]]</nowiki> or <nowiki>[[Page title|description]]</nowiki>. In the latter case, the part after the pipe "|" becomes the title attribute of the link – in most browsers, it will pop up as a tooltip when the user hovers over it. If no explicit link description is given, the page title will be used.
<center>
 
<imagemap>
Areas which overlap give precedence to the first link listed.
Image:PKMNGS_JhotoMap.png|Map of Jhoto
rect 543 383 576 416 [[Pokémon Gold and Silver/New Bark Town]]
rect 383 383 416 416 [[Pokémon Gold and Silver/Cherrygrove City]]
rect 319 222 352 255 [[Pokémon Gold and Silver/Violet City]]
rect 255 480 288 513 [[Pokémon Gold and Silver/Azalea Town]]
rect 191 352 224 385 [[Pokémon Gold and Silver/Goldenrod City]]
rect 255 158 288 191 [[Pokémon Gold and Silver/Ecruteak City]]
rect 126 222 159 255 [[Pokémon Gold and Silver/Olivine City]]
rect 61 383 94 416 [[Pokémon Gold and Silver/Cianwood City]]
rect 413 158 436 191 [[Pokémon Gold and Silver/Mahagony Town]]
rect 510 158 543 191 [[Pokémon Gold and Silver/Blackthorn City]]
desc bottom-left
</imagemap>
</center>


==Attribution==
==Attribution==

Revision as of 22:34, 28 August 2009

One significant feature of StrategyWiki guides is that you can add images, and place them anywhere you like. This page deals with the specifics of placing and uploading images on pages.

A picture is worth a thousand words. If you're trying to describe a route or puzzle solution that takes a lot of words to explain, it might be easier to draw it and refer to the map. Please use restraint when uploading images or other media to a game guide. While you are encouraged to use as many images as you feel necessary for describing elements of the game, each should be relevant, important, and include informative captions (where appropriate). An image should add to the informative value of a guide. Do not upload images for the sole purpose of making a guide "look cool".

Uploading

For more details on image naming and categorization, see the image policy.

You can upload images from the upload page. The first part to uploading an image is to choose the file that you are about to upload. To do this click on "Browse" and select the wanted file. The default name provided will match the name of the file on your local computer, so it will need to be renamed if it doesn't conform to the image naming policy. If you are uploading from a source on the web, enter the full URL into the provided box. When copying an image from another website, you will have to enter the filename yourself. Remember to place the URL you copied from in the summary section so that others know where it was copied from (this helps others verify that the image complies with StrategyWiki's licensing). Alternatively, you can click on a red image link to be taken to the upload page with the named filled in from the link.

Follow these steps when uploading an image:

  1. Naming: properly name your image with the name of the guide to which it belongs or its abbreviation, followed by a one or two word description of the image, such as a character's name or a level's name. The extension, ".jpg", ".png", ".gif", etc., is case-sensitive and all lowercase is preferred.
  2. Summary: here you put a description of the image with a link to the guide on which it will be used. For example, "Box art from [[Super Mario Bros.]]." If the image is from someone else, attribute them here, preferably with a URL.
  3. Categories: below the summary, put any applicable image categories and the guide-specific category. For example, "[[Category:Box artwork]][[Category:Super Mario Bros. images]]". Note that the word "images" in the guide-specific category is lowercase.

Image Formats

As a general rule, "When in doubt, use PNG". The most common formats are listed here.

  • PNG has excellent lossless compression as well as multiple levels of transparency. Use PNG for images with transparency, smaller images and images with cleanly separated areas of color.
  • GIF has good compression, but not as good as PNG in most cases. It only supports a small palette (216/256 colors), and dithers anything outside that palette. Use GIF for images containing a few, clearly separate solid colors, or animated images (QuickTime animations or movies are good alternatives).
  • JPEG is good for pictures with thousands of colors, but its compression method corrupts simpler images with compression artifacts. Use JPEG for photos and complex images involving gradients, such as most current box artwork. Also, avoid saving your JPEG images with Microsoft Paint when possible, as it's been known to cause compatibility issues among certain clients.
  • SVG is a vector graphic image. Currently most browsers don't fully support the SVG format, which gives your computer commands to draw the picture rather than a bit for bit stream of each pixel used. These images are fantastic for scalability, as shrunken down or blown up they retain their original quality. The MediaWiki software is able to upload SVG images, which are then converted to PNG and displayed as such. Vector images are more complex to create, and it's unlikely you'll find any when searching, but eventually this format may replace all other ones on the Internet.
  • BMP is lossless but has no compression. Never use BMPs, use an alternate format instead.

Of course, there are many other image formats out there, but StrategyWiki generally only welcomes the first three mentioned above. When in doubt, consult a sysop or other knowledgeable individual.

Using uploaded files

To use an image or other file which has been uploaded to the wiki, use:

  • [[Image:SMB NES Box.jpg]]

If you add a pipe (|) and some text after the filename, the text will be used as alternative text for text-only browsers and for the tooltip when you hover the mouse of it:

  • [[Image:SMB NES Box.jpg|alternative text]]

If you don't want to display the image, you can link to the file's description page, by adding a colon:

  • [[:Image:SMB NES Box.jpg]]

To bypass the description page and link directly to a file , use the "Media" pseudo-namespace:

  • [[Media:SMB NES Box.jpg]]

You can also make piped links if you want some other text to be used:

  • [[:Image:SMB NES Box.jpg|link text]]
  • [[Media:SMB NES Box.jpg|link text]]

Image placement

Description You type… You get…
Embed image (with alt text)

[[Image:SMB NES Box.jpg|Super Mario Bros.]]

Super Mario Bros.

Link to description page

[[:Image:SMB NES Box.jpg]]
[[:Image:SMB NES Box.jpg|Super Mario Bros.]]

Image:SMB NES Box.jpg
Super Mario Bros.

Link directly to file

[[Media:SMB NES Box.jpg]]
[[Media:SMB NES Box.jpg|Super Mario Bros.]]

Media:SMB NES Box.jpg
Super Mario Bros.

Thumbnail (100 pixels wide, with caption)

[[Image:SMB NES Box.jpg|thumb|Super Mario Bros.]]

Super Mario Bros.

Advanced options

The full syntax for displaying an image is:

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

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

  • thumb, thumbnail, or frame: Controls how the image is formatted. Thumbnailed images are typically smaller, and what should normally be used for in-guide images. Framed images are similar to thumbnailed images, but are not scaled down, while if this option is left out entirely, the image is displayed at full size without any border or embellishment.
  • left, right, none: Controls the alignment of the image or thumbnail on the page. Thumbnail images default to floating to the right.
  • {width}px: Resizes the image to the given width in pixels. Note that use of this option is discouraged for thumbnailed images, as it means people can't specify the thumbnail size they want to view in their preferences.
  • {caption text}: A short description of the image and what it shows. This will be displayed under the image for thumb and frame images.

The options can be given in any order. 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.

Gallery of images

It's easy to make a gallery of thumbnails with the <gallery> tag. The syntax is:

<gallery>
Image:{filename}|{caption}
Image:{filename}|{caption}
{...}
</gallery>

Captions are optional, and may contain wiki links or other formatting. You can also add a caption to the gallery itself, by using the caption="{caption}" parameter in the <gallery> tag. Note that you cannot use wiki links or other formatting in gallery captions.

For example:

<gallery caption="Super Mario Bros. boxes">
Image:SMB NES Box.jpg|Item 1
Image:SMB NES Box.jpg|a link to [[Help:Contents]]
Image:SMB NES Box.jpg
Image:SMB NES Box.jpg
Image:SMB NES Box.jpg|''italic caption''
</gallery>

is formatted as:

Image maps

Image maps are welcome on StrategyWiki. They are images of which certain portions are clickable as links. You can use visual editors such as Mapedit to assist with drawing the shapes, although this free image map editor is more than sufficient.

Syntax description

The following comes from ImageMap at MediaWiki.org

The contents of an <imagemap> tag consists of blank lines, comments (starting with #) and logical lines. The first logical line specifies the image to be displayed. This must be in the same format as an ordinary MediaWiki image link, except without the enclosing [[ and ]].

Further lines are split into tokens, separated by whitespace. The function of each line is determined by the first token in the line. All coordinates are according to the full-size image, not the visible image.

  • desc: Specifies the location of the image description link. May be either top-right, bottom-right, bottom-left, top-left, or none. This puts a blue "i" icon in the specified corner, linking to the image description page. The default is bottom-right. To hide the description link, set it to none.
  • poly: A polygon. The coordinates of the vertices are given, followed by a link in square brackets. Polygons must be defined before any other form!
  • rect: A rectangle. The parameters are the coordinates of the top-left and bottom-right corners, followed by a title to link to in square brackets.
  • circle: A circle. The first two parameters are the coordinates of the center, the third is the radius. The coordinates are followed by a link in square brackets.
  • default: This gives the default link, where no other regions are specified.

All coordinates are specified relative to the source image. The image can be scaled using thumbnail syntax, in which case the image map coordinates will be automatically scaled as well.

All links are given in either the form [[Page title]] or [[Page title|description]]. In the latter case, the part after the pipe "|" becomes the title attribute of the link – in most browsers, it will pop up as a tooltip when the user hovers over it. If no explicit link description is given, the page title will be used.

Areas which overlap give precedence to the first link listed.

Example

<center>
<imagemap>
Image:PKMNGS_JhotoMap.png|Map of Jhoto
rect 543 383 576 416 [[Pokémon Gold and Silver/New Bark Town]]
rect 383 383 416 416 [[Pokémon Gold and Silver/Cherrygrove City]]
rect 319 222 352 255 [[Pokémon Gold and Silver/Violet City]]
rect 255 480 288 513 [[Pokémon Gold and Silver/Azalea Town]]
rect 191 352 224 385 [[Pokémon Gold and Silver/Goldenrod City]]
rect 255 158 288 191 [[Pokémon Gold and Silver/Ecruteak City]]
rect 126 222 159 255 [[Pokémon Gold and Silver/Olivine City]]
rect 61 383 94 416 [[Pokémon Gold and Silver/Cianwood City]]
rect 413 158 436 191 [[Pokémon Gold and Silver/Mahagony Town]]
rect 510 158 543 191 [[Pokémon Gold and Silver/Blackthorn City]]
desc bottom-left
</imagemap>
</center>

Will give the following image map. Hover mouse over the orange squares to see how the links work.

Map of JhotoPokémon Gold and Silver/New Bark TownPokémon Gold and Silver/Cherrygrove CityPokémon Gold and Silver/Violet CityPokémon Gold and Silver/Azalea TownPokémon Gold and Silver/Goldenrod CityPokémon Gold and Silver/Ecruteak CityPokémon Gold and Silver/Olivine CityPokémon Gold and Silver/Cianwood CityPokémon Gold and Silver/Mahagony TownPokémon Gold and Silver/Blackthorn City
Map of Jhoto

Attribution

Like the rest of the site, do not use attribution on your image; this information instead goes in the edit summary when uploading the image. Each image should have a specific purpose, such as demonstrating a particular task (such as finding the correct book to open a secret passage), illustrating a boss's various evolutions or movement patterns, or listing enemies so the player can learn to recognise and differentiate between them, etc.

Maps and other explanatory images are a priority. Featuring an overworld or screenshot map without any annotations is probably of little value. They should instead serve to either show all the major locations in the game world or else to highlight hidden goodies, enemies, etc. If the thing in question is not clearly visible, it may be useful to draw a circle or arrow indicating it. For the sake of simplicity do not write on the screenshot; the explanation should instead go in the picture caption or in the walkthrough body. For more involved steps, it may be necessary to label different parts "A" and "B" or similar.

Also, take care that images are high quality, clear, and easy to understand. Do not upload grainy pictures taken with video cameras. Either take a direct screenshot with a computer, or use a capture device of some sort.

Do not, under any circumstances, use images with watermarks on them. Additionally, images copyrighted by others cannot be used here. All images must be original or compatibly licensed with the CC-BY-SA license to avoid conflicts of intellectual property.

Other files

You can link to an external file using the same syntax used for linking to an external web page, however, it is highly recommended that you upload the images to StrategyWiki instead of hotlinking to other sites.

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

Or with different text:

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

You can also embed images via their direct URLs. To do that, simply insert the URL:

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

You can also use an external image as a link:

  • [http://destination.page/here/ http://image.url/here.png]

Note that if you want an image to link to an internal page you will need to use the external form of the link (e.g. http://strategywiki.org/wiki/Main_Page) rather than the internal one (e.g. Main Page).