Extension:ImageMap/ja

From MediaWiki.org

MediaWiki Extensions
List of MediaWiki Extensions

ImageMap Release status: stable
Implementation	Tag
Description	HTMLの画像マップ
Author(s)	Tim Starling
MediaWiki	1.11+
Download	Subversion

ImageMapはクライアントサイドのクリック可能な画像マップです。

この拡張機能とMcNaughtのimagemap拡張機能はの両方を含む別の実装はExtension:ImageMap (Alternate)で利用できます。 どちらのImageMap拡張機能を使うのか決心する前にchoosing an ImageMap extensionを考えてみて下さい。

Contents 1 構文の例 2 構文の説明 3 インストレーションガイド 3.1 パラメータ 4 既知のバグ 5 既知の機能リクエスト 6 画像マップエディタ

[edit] 構文の例

<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]]
# コメント、この行は無視されます
circle 57 57 20    [[Foo type B]]
desc bottom-left
</imagemap>

この例の出力:

[edit] 構文の説明

<imagemap>タグの内容は空白行、(#で始まる)コメント、論理行で校正されます。最初の論理行は表示される画像を指定します。[[ と ]]で閉じられていないことを除いて、これは通常のMediaWikiの画像リンクと同じ画像でなければなりません。

追加の行はトークンに分割され、空白で分離されます。それぞれの行の機能は行の最初のトークンによって決定されます。すべての座標は見える画像ではなくフルサイズの画像に従います。

desc 

画像の説明リンクの位置を指定します。top-right、bottom-right、 bottom-left、top-leftもしくはnoneのどれか1つです。

これによって画像の説明ページにリンクする青い"i"アイコンが指定されたコーナーに設置されます。デフォルトはbottom-rightです。説明リンクを隠すため、noneに設定して下さい。可能な値: top-right、 bottom-right、bottom-left、top-left、 noneです。

rect 

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

circle

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

poly

多角形です。頂点の座標が与えられ、角括弧のリンクが後に続きます。
多角形は他の形式の前に定義しなければなりません！

default

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

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

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

[edit] インストレーションガイド

1. extensionsディレクトリ内にディレクトリを作って下さい: ImageMap
2. このディレクトリで Subversionからすべてのファイルをダウンロードして下さい
3. require_once( "$IP/extensions/ImageMap/ImageMap.php" );をLocalSettings.phpに追加して下さい。

テストのインストレーション:

1. Image:Foo.jpgをダウンロードしてあなたのwikiにアップロードして下さい。
2. 新しいImageMapという記事を作りこの記事のテキスト(少なくとも"syntax example"のセクション)をその記事にコピー＆ペーストして下さい

トラブルシューティング:

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

[edit] パラメータ

注: このパラメータは最新のバージョン(リビジョン23292以降)で削除されています。これは現在常に外部リンクを許可します。 古いリリース用です:

注: 拡張機能のパラメータは下記の拡張機能のrequire_once()の下になければなりません

• $wgImageMapAllowExternalLinks = false

  リンクの目的先として外部リンク(http://www.example.com)を有効にするためにこれをtrueに設定して下さい

[edit] 既知のバグ

原文を参照。

[edit] 既知の機能リクエスト

原文を参照。

[edit] 画像マップエディタ

• 座標を決定するグラフィカルなツール。 著者: meta:User:Dapete
• ImageMap拡張機能でImage Mapエディタを使う方法のシンプルなガイドはwikiHowで読むことができます。

加えて、HTML形式の画像マップ情報をこの拡張機能のための形式に変換するためにImage Map Conversion special pageを利用できます。これはExtension:ImageMap (Alternate)#Utilities and linksで一覧が表示されているファイルベースの画像マップのためのユーティリティからの出力を変換するために使うことができます。

Warning: Default sort key "ImageMap/ja" overrides earlier default sort key "IMAGEMAP/JA".