Extension:ImageMap/ja

From MediaWiki.org
Jump to: navigation, search
マニュアル - リスト - スナップショット
Crystal Clear action run.png
ImageMap

Release status: stable

実装 Tag
説明 HTMLの画像マップ
作者 Tim Starling
MediaWiki 1.11+
ライセンス No license specified
ダウンロード Subversion

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

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

Contents

[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>

この例の出力:

Display Keyboard Foo type A Foo type Bpicture of a foo
About this image

[edit] 構文の説明

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

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

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

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

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;
    リンクの目的先として外部リンク(www.example.com)を有効にするためにこれをtrueに設定して下さい

[edit] 既知のバグ

原文を参照。

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

原文を参照。

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

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


言語: English  • 日本語
Personal tools
Namespaces
Variants
Actions
Site
Support
Download
Development
Communication
Print/export
Toolbox