Extension:ImageMap/ja

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki 拡張機能マニュアル
Crystal Clear action run.svg
ImageMap
リリースの状態: 安定
実装 Tag
説明 HTMLのクリッカブル画像マップを使用できるようにする
作者 Tim Starlingtalk
最新バージョン continuous updates
MediaWiki 1.19 以降
PHP 5.3 以降
データベースの変更 いいえ
Composer mediawiki/image-map
ライセンス あらゆる OSI 承認済みライセンス
ダウンロード
log
Children's encyclopedia
使用するフック
ParserFirstCallInit
translatewiki.net で翻訳を利用できる場合は、ImageMap 拡張機能の翻訳にご協力ください
使用状況とバージョン マトリクスを確認してください。
問題点 未解決のタスク · バグを報告

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.

[edit]

説明文のない簡単な例[edit]

<imagemap>
Image:Example2.png|150px|alt=Alt text
default [[Main Page|メインページに移動]]
</imagemap>
Alt text
About this image

上図の例では、図の中のどの場所をクリックしてもメインページにリンクされます。図についてより詳しい情報を知りたい時は、青い「i」のアイコンをクリックして下さい。次のように記せば、この拡張を使わずにこれと同じようなリンクを作成することができます。: [[Image:Example2.png|150px|alt=Alt text|title=メインページに移動|link=Main Page]]

Complex example with caption[edit]

<imagemap>
Image:JoshuaReynoldsParty.jpg|thumb|center|400px|alt=Dining room with nine men seated around a table. The dinner has been finished, and a large man at the head talks and gesticulates while the others eagerly listen. The men wear wigs and clothing of late 18th century Britain, and the furniture, hangings, and chandelier are of similar vintage. A liveried servant is entering with a tray bearing two high-shouldered decanters of wine.|Image map example. Clicking on a person in the picture causes the browser to load the appropriate article.

poly 133 343 124 287 159 224 189 228 195 291 222 311 209 343 209 354 243 362 292 466 250 463 [[w:Samuel Johnson|Dr Johnson - Dictionary writer]]
poly 76 224 84 255 43 302 62 400 123 423 121 361 137 344 122 290 111 234 96 225 [[w:James Boswell|Boswell - Biographer]]
poly 190 276 208 240 229 228 247 238 250 258 286 319 282 323 223 323 220 301 200 295 [[w:Joshua Reynolds|Sir Joshua Reynolds - Host]]
poly 308 317 311 270 328 261 316 246 320 228 343 227 357 240 377 274 366 284 352 311 319 324 [[w:David Garrick|David Garrick - actor]]
poly 252 406 313 343 341 343 366 280 383 273 372 251 378 222 409 228 414 280 420 292 390 300 374 360 359 437 306 418 313 391 272 415 [[w:Edmund Burke|Edmund Burke - statesman]]
rect 418 220 452 287 [[w:Pasquale Paoli|Pasqual Paoli - Corsican patriot]]
poly 455 238 484 253 505 303 495 363 501 377 491 443 429 439 423 375 466 352 [[w:Charles Burney|Charles Burney - music historian]]
poly 501 279 546 237 567 239 572 308 560 326 537 316 530 300 502 289 [[w:Thomas Warton|Thomas Warton - poet laureate]]
poly 572 453 591 446 572 373 603 351 562 325 592 288 573 260 573 248 591 243 615 254 637 280 655 334 705 396 656 419 625 382 609 391 613 453 [[w:Oliver Goldsmith|Oliver Goldsmith - writer]]
rect 450 86 584 188 [[w:Joshua Reynolds|prob.The Infant Academy 1782]]
rect 286 87 376 191 [[w:Joshua Reynolds|unknown painting]]
circle 100 141 20 [[w:Joshua Reynolds|An unknown portrait]]
poly 503 192 511 176 532 176 534 200 553 219 554 234 541 236 525 261 506 261 511 220 515 215 [[w:Francis Barber|servant - poss. Francis Barber]]
rect 12 10 702 500 [[w:The Club (Literary Club)|Use button to enlarge or use hyperlinks]]
</imagemap>
Dr Johnson - Dictionary writerBoswell - BiographerSir Joshua Reynolds - HostDavid Garrick - actorEdmund Burke - statesmanPasqual Paoli - Corsican patriotCharles Burney - music historianThomas Warton - poet laureateOliver Goldsmith - writerprob.The Infant Academy 1782unknown paintingAn unknown portraitservant - poss. Francis BarberUse button to enlarge or use hyperlinksDining room with nine men seated around a table. The dinner has been finished, and a large man at the head talks and gesticulates while the others eagerly listen. The men wear wigs and clothing of late 18th century Britain, and the furniture, hangings, and chandelier are of similar vintage. A liveried servant is entering with a tray bearing two high-shouldered decanters of wine.
Image map example. Clicking on a person in the picture causes the browser to load the appropriate article.

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 .

構文の説明[edit]

<imagemap>タグの内容は空白行、(#で始まる)コメント、論理行で構成されます。最初の論理行は表示される画像を指定します。[[ と ]]で閉じられていないことを除いて、これは通常のMediaWikiの画像リンクと同じ画像でなければなりません。If the first line specifies a "thumb" or "frame" 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 , which links to the image description. 可能な値: top-rightbottom-rightbottom-lefttop-leftnoneです。This parameter is ignored for "thumb" or "frame" images, which instead employ the usual double-rectangle icon .
例:
<imagemap>
Image:PolierMartinWombwellZoffany.jpg|thumb|200px|Colonel Antoine Polier
rect 269 140 344 305 [[Claude Martin]]
rect 124 147 181 298 [[Antoine Polier|Antoine-Louis Polier]]
desc none
</imagemap>
poly
多角形です。頂点の座標が与えられ、角括弧のリンクが後に続きます。
rect 
長方形。パラメーターはtop-leftとbottom-rightコーナーの座標で、角括弧内のタイトルへのリンクが続きます。
circle
円です。最初の2つのパラメーターは円の座標、3番目は半径です。座標の後に角括弧のリンクが続きます。
default
これは他の領域が指定されない、デフォルトのリンクを表示します。

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

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

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

インストール[edit]

この拡張機能は MediaWiki 1.21 以降にバンドルされています。このため、別途ダウンロードする必要はありません。


  • ダウンロードして、ファイルを extensions/ フォルダー内の ImageMap という名前のディレクトリ内に配置します。
  • 以下のコードを LocalSettings.php の末尾に追加します:
    require_once "$IP/extensions/ImageMap/ImageMap.php";
    
  • Yes 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。
トラブルシューティング
  1. PHPのDOMが有効になっているかチェックして下さい。存在しない場合はインストールする必要があります。
  2. ImageMagickがインストールされているかチェックして下さい。 リサイズに関してこの拡張機能が/usr/bin/convertに依存しているからです。存在しない場合、XMLエラーのみのページが表示されることになります(ティップ: ブラウザでback-buttonを使って下さい。まだページを編集できるからです)。

Composer[edit]

For MediaWiki 1.22+, you may install this extension using built-in Composer support. MediaWiki versions prior to 1.22 can use Composer via Extension:ExtensionInstaller.

composer require mediawiki/image-map @dev
Using Composer to install this extension will cause installation of the latest development version of this extension each time you do a "composer update" command.

Usage with templates, magic words, or parser functions.[edit]

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).

例 - standard form
<imagemap>
Image:ExamplePlant80.png|60px|ExamplePlant
rect 0 107 294 260 [[Plants/ExamplePlant|ExamplePlant]]
desc none
</imagemap>
例 - with variable {{PAGENAME}}
{{#tag:imagemap|
Image:ExamplePlant80.png{{!}}60px{{!}}ExamplePlant
rect 0 107 294 260 [[{{PAGENAME}}/ExamplePlant|ExamplePlant]]
desc none
}}

関連ページ[edit]

Instructions
Online tools
Extensions


言語: English  • 日本語