Extension:ImageMap/ja

ImageMapはクライアントサイドのクリック可能な画像マップです. An image map is a list of coordinates in a specific image, which hyperlinks areas of the image to multiple destinations (in contrast to a normal image link, in which the entire area of the image links to a single destination). For example, a map of the world may have each country hyperlinked to further information about that country. The intention of an image map is to provide an easy way of linking various parts of an image without dividing the image into separate image files.

説明文のない簡単な例


上図の例では、図の中のどの場所をクリックしてもメインページにリンクされます. 図についてより詳しい情報を知りたい時は、青い「i」のアイコンをクリックして下さい. 次のように記せば、この拡張を使わずにこれと同じようなリンクを作成することができます.

Complex example with caption


The above example links to many different pages, depending on where you click it. To find out more about the image, click on the double-rectangle icon.

構文の説明
&lt;imagemap>タグの内容は空白行、(#で始まる)コメント、論理行で構成されます. 最初の論理行は表示される画像を指定します. と で閉じられていないことを除いて、これは通常のMediaWikiの画像リンクと同じ画像でなければなりません. 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.

追加の行はトークンに分割され、空白で分離されます. それぞれの行の機能は行の最初のトークンによって決定されます. すべての座標は見える画像ではなくフルサイズの画像に従います. They should be specified as distance from left edge (horizontal pixel count), distance from top (vertical pixel count).


 * desc : Specifies the location of a blue "i" icon [[Image:Desc-20.png|link=|alt=]], which links to the image description. 可能な値: top-right、 bottom-right、bottom-left、top-left、noneです. This parameter is ignored for " " or " " images, which instead employ the usual double-rectangle icon [[Image:Magnify-clip.png|link=|alt=]].


 * Example:


 * poly: 多角形です. 頂点の座標が与えられ、角括弧のリンクが後に続きます.


 * rect : 長方形. パラメーターはtop-leftとbottom-rightコーナーの座標で、角括弧内のタイトルへのリンクが続きます.


 * circle: 円です. 最初の2つのパラメーターは円の座標、3番目は半径です. 座標の後に角括弧のリンクが続きます.


 * default: これは他の領域が指定されない、デフォルトのリンクを表示します.

すべての座標はソースの画像に相対的に指定されます. 画像はサムネイルの構文で縮小拡大できます. その場合画像マップの座標も自動的に同様の縮小拡大が行われます.

すべてのリンクは Page title もしくは description の形式のどちらかで与えられます. 後者の場合、パイプ"|"の後の部分は多くのブラウザではリンクのタイトル属性になります. ユーザーがそれをホーバーするときツールチップとしてポップアップします. 明示的なリンクの説明が与えられていない場合、ページタイトルが使われます.

重複するエリアはリストで示された最初のリンクを優先します.

セットアップ

 * 1) LocalSettings.phpの最後に次の記述を追記して下さい:
 * 2) あなたのwikiのSpecial:Versionページにアクセスすれば、インストールされたかが確認できます.

トラブルシューティング

 * 1) PHPのDOMが有効になっているかチェックして下さい. 存在しない場合はインストールする必要があります.
 * 2) ImageMagickがインストールされているかチェックして下さい.  リサイズに関してこの拡張機能が/usr/bin/convertに依存しているからです. 存在しない場合、XMLエラーのみのページが表示されることになります(ティップ: ブラウザでback-buttonを使って下さい. まだページを編集できるからです).

外部リンクを使用できるようにするパラメーター
古いリリース用です:
 * 注: 拡張機能のパラメーターは下記の拡張機能のrequire_onceの下になければなりません
 * $wgImageMapAllowExternalLinks = false;
 * リンクの目的先として外部リンク(www.example.com)を有効にするためにこれをtrueに設定して下さい

Usage with templates, magic words, or parser functions.
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 :