Extension:ImageMap/zh

ImageMap的插件允許點擊image maps. image map是圖像中的坐標列表，該坐標將圖像的區域超鏈接到多個目標（與普通圖像鏈接相反，在常規圖像鏈接中，圖像的整個區域都鏈接到單個目標）. 例如，世界地圖可能使每個國家/地區超鏈接到有關該國家/地區的更多信息. image map的目的是提供一種鏈接圖像各個部分的簡便方法，而無需將圖像分為單獨的圖像文件.

沒有標題的簡單示例
無論在哪裡點擊，上面的示例始終連結到主頁. 若想要瞭解更多該圖像的資訊，請點擊藍色的“i”圖標. 不使用此擴展來創建這類連結圖像的方法是用

帶有標題的複雜示例
This example display a thumbnail with dimensions (width × height) 500 × 250 pixels; the original image has dimensions 9,600 × 4,800 pixels. The coordinates of each vertex are given in pixels and represent a point on the original image. So for example, the vertices of the polygon surrounding "Jude" (second to the far right in the image) has horizontal-coordinates (measured in pixels from the left) ranging between  –   and vertical-coordinates (measured in pixels from the top) ranging between   – , which are far outside of the range of the displayed 500 × 250 thumbnail but within range of the 9,600 × 4,800 original image. Note that one vertex of the polygon surrounding "Simon" (at the very right of the image), specifically the vertex with coordinate, lies outside of the bounds of the original 9,600 × 4,800 image.

上面的示例連結到許多不同的頁面，具體取決於點擊的位置. 若想要瞭解更多圖像的資訊，請點擊雙矩形圖標. .

語法描述
The contents of an 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 (see Images help), except without the enclosing  and   markup. If the first line specifies a " " or " " image, then the first line's caption and any alt parameter are treated as the image's caption and alt text in the usual way; otherwise, the first line's alt parameter (or, if absent, any caption) specifies the image's alt text. In neither case does the image itself have title text (often used for tooltips); any title text is taken from the regions described in later lines.

Further lines are split into tokens, separated by whitespace. The function of each line is determined by the first token in the line.

A coordinate consists of two tokens. The first token is the horizontal (X) position and the second token is the vertical (Y) position. ''' All coordinates are according to the full-size image, not the visible image. ''' The X and Y tokens should be specified as distance from left edge (horizontal pixel count) and distance from top (vertical pixel count) of the full-size image.


 * desc
 * Specifies the location of a blue "i" icon [[Image:Desc-20.png|link=|alt=]], which links to the image description. Possible values:,   (default),  ,  ,  . This parameter is ignored for " " or " " images, which instead employ the usual double-rectangle icon [[Image:Magnify-clip.png|link=|alt=]].


 * poly
 * A polygon. The coordinates of the vertices are given, followed by a link in square brackets.


 * 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.
 * Example


 * 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 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; the part after the pipe also becomes the alt text for the link. If no explicit link description is given, the page title is used.

Areas which overlap give precedence to the first link listed.

安装
Make sure that uploads and ImageMagick are installed:


 * Troubleshooting
 * 1) Check to see if your php DOM is turned on. You may need to install it if it is not.
 * 2) Check whether  is installed, since this extension relies on /usr/bin/convert for the resizing. If it is not present, you could get a page with only XML errors (tip: use the back-button in the browser, because you can still edit the page).
 * 3) On OVH mutualized hosting $wgUseImageMagick should be like:

Composer
You can also install this extension using built-in Composer support.

composer require mediawiki/image-map @dev

使用模板，魔術詞或解析器功能.
If you want this extension (as with most tag extensions) to parse template parameters, magic words, or parser functions, you will need to use #tag syntax, such as w:Template:Click did. In this case the vertical bar  must be replaced by a template , where the source text of the template is   (except when they appear inside links or parameters).


 * Example - standard form:


 * Example - with variable :


 * Example – Modified to accept an input parameter to control image size:

These modifications allow the template size to be adjusted on the edited (target) page and eliminate the need to create duplicate templates of various image sizes.

Where is the input parameter “1” and a default image size of 640px. Note: the input parameter requires a text string ending with “px” to function properly. For example, calling a template will display the template at 400 pixels.

 To convert the standard (existing) image maps to this optional format: 
 * Replace the initial  with   (the trailing braces).

参见

 * Instructions
 * A simple guide on how to use the Image Map editor with the ImageMap extension can be found at ImageMapEdit Howto on meta.
 * A detailed guide for using the maschek image map editor can be found at this site.
 * Wikimedia Commons also has a resource page on image maps: c:Commons:Image_map_resources
 * Existing image maps examples: w:Category:Wikipedia image maps


 * Wiki tools
 * meta:User:Dapete/ImageMapEdit - ImageMapEdit script, a graphical tool to determine the coordinates that can be installed on any wiki.


 * Online tools
 * http://www.maschek.hu/imagemap/imgmap Online image map editor, supports all shapes, Extension:ImageMap compatible.
 * http://www.image-maps.com/index.php? Basic on-line image mapper.
 * http://summerstyle.github.io/summer/ - Open-source interactive online image mapper


 * Similar functionalities
 * - working with diagrams and drawings