Help:画像がぞう

From mediawiki.org
This page is a translated version of the page Help:Images and the translation is 94% complete.
PD 注意ちゅうい: このページを編集へんしゅうすると、編集へんしゅう内容ないようCC0 のもとで公開こうかいされることに同意どういしたとなされます。詳細しょうさいパブリック・ドメインのヘルプ ページ参照さんしょうしてください。 PD

このページでは、ウィキを編集へんしゅうするさい画像がぞう構文こうぶん説明せつめいします。 ページで画像がぞう使用しようするには、通常つうじょう、あなたまたはべつ利用りようしゃ画像がぞうをアップロードする必要ひつようがあります。

MediaWiki サーバーに保存ほぞんされた画像がぞうは、通常つうじょうFile: 名前なまえ空間くうかん接頭せっとう使用しようして (ただし、ふるImage: 名前なまえ空間くうかん接頭せっとうも、同様どうよう役割やくわりたすものとしてサポートされています)、MediaWiki のページへのリンクターゲットとして表示ひょうじされます。 変種へんしゅMedia:名前なまえ空間くうかん接頭せっとうは、もとのメディアファイルの中身なかみ参照さんしょうするのに使つかえます(そのファイルをべつ表示ひょうじまたはダウンロードする、MediaWIki ページ以外いがいのため)。

必要ひつよう条件じょうけん

利用りようしゃ自分じぶんのページで画像がぞう使用しようするまえに、ウィキのシステム管理かんりしゃから画像がぞうアップロード権限けんげん画像がぞうのアップロードおこないます。 システム管理かんりしゃはまた、ウィキメディア・コモンズなど外部がいぶサイトのリポジトリからウィキにファイルをれる設定せっていができます。 サーバがわ画像がぞうのリサイズをするには、(GD2ImageMagickなど)スケーラを構成こうせいする必要ひつようがあります。

対応たいおうしている画像がぞうのメディアの種類しゅるい

既定きていでは以下いかのファイル形式けいしき対応たいおうしています:

  • .jpg または .jpeg - 標準ひょうじゅん JPEG 形式けいしき圧縮あっしゅくされたビットマップ画像がぞう (この可逆かぎゃく形式けいしきは、写真しゃしんもっとてきしています)
  • .png - Portable Network Graphics形式けいしきのビットマップ画像がぞう ("W3 Consortium"で指定していされています)
  • .gif - レガシーのグラフィック インターチェンジ形式けいしきのビットマップ画像がぞう
  • .webp - WebP supports both lossy and lossless compression while reducing image size by up to 45%.

Wikimediaで使つかわれ、それ以外いがいのどこでも一般いっぱんてき有効ゆうこう形式けいしき(これらはデフォルトで有効ゆうこうぶんくわえ、特別とくべつ設定せってい必要ひつよう場合ばあいがあります)

  • .svg - Scalable Vector Graphics形式けいしきのベクター画像がぞう(「W3 Consortium」で策定さくていManual:画像がぞう管理かんり#SVG参照さんしょうしてください。
  • .tiff - タグけされた画像がぞう書式しょしき しばしば、資料しりょう保存ほぞんのための高画質こうがしつ写真しゃしんもちいられます。 しばしば、Extension:PagedTiffHandler 一緒いっしょもちいられます。
  • .ogg, .oga, .ogv - Ogg マルチメディア (音声おんせいまたは動画どうが) 画像がぞう形式けいしきではありませんが、同様どうようあつかわれます。 しばしば、Extension:TimedMediaHandler 一緒いっしょもちいられます。(訳注やくちゅう: Extension:OggHandler は廃止はいしみ)
  • .pdf - Portable Document Format形式けいしき複数ふくすうページドキュメント(当初とうしょは “Adobe” によって策定さくていされていました) しばしば、Extension:PdfHandler 一緒いっしょもちいられます。
  • .djvu - DjVu 形式けいしき複数ふくすうページのビットマップ文書ぶんしょ (ほとんどの場合ばあい書籍しょせきのスキャンに使つかわれます)。 Manual:How to use DjVu with MediaWiki 参照さんしょうしてください
    いち表示ひょうじできる .pdf / .djvu ファイルは 1 てんのみです。

のメディアタイプもサポートできますが、インラインに表示ひょうじできないかもれません。

単純たんじゅん画像がぞう処理しょり

構文こうぶん

画像がぞう表示ひょうじするための完全かんぜん構文こうぶん以下いかとおりです:

[[File:filename.extension|options|caption]]

ただし オプション は、以下いかのいずれかを 0 以上いじょうべてパイプ記号きごう (|) で区切くぎったものです。

  • 書式しょしき オプション: border (余白よはく) および/または frameless (わくなし)、frame (わくあり)、thumb (サムネイル、thumbnail)。 Note: border can be used in combination with frameless but will be ignored if used with one of the other options.
    ページない画像がぞう描写びょうしゃする書式しょしきみの方式ほうしきめます。
  • サイズ調整ちょうせいのオプション:以下いかのいずれか
    • {width}px — ピクセル単位たんいはば上限じょうげんわせる。たかさは調整ちょうせい。 (整数せいすう画素がそのみサポートされます。 はば指定していと「px」のあいだに空白くうはくスペースがはいっても問題もんだいありません。)
    • x{height}px — ピクセル単位たんいはば調整ちょうせいたかさは上限じょうげん 整数せいすう画素がそのみサポートされます。 たかさのと"px"のあいだ空白くうはく文字もじがあってもよい。
    • {width}x{height}px — ピクセル単位たんいはばたかさも上限じょうげん 整数せいすう画素がそのみサポートされます。 はば指定していと「px」のあいだに空白くうはくスペースがはいっても問題もんだいありません。
    • uprightResizes an image to a multiple of the user's thumbnail size preferences – or the default thumbnail size, for logged-out users or logged-in users who have not changed their preferences – to fit within reasonable dimensions. This option is often useful for images whose height is larger than their width. Requires either thumb or frameless. |upright=1.0|設定せっていにより、画像がぞう利用りようしゃ既定きてい画像がぞうはば表示ひょうじ|upright=2.0| により、はば利用りようしゃ既定きていの2ばい画像がぞう表示ひょうじ
    画像がぞう縦横じゅうおうつね再現さいげんされます。
    スケーラブルではない画像がぞう縮小しゅくしょう可能かのうですが、拡大かくだいはできません。たとえばビットマップ画像がぞうがこれに該当がいとう
    upright設定せってい等号とうごう不要ふようです。|upright 2.0|しるすだけで|upright=2.0|おな指定していになります。
    数値すうちもしくは等号とうごうがない場合ばあい (たとえば|upright|のみ)、既定きてい|upright=0.75|になります (ただし|upright=||upright=1.0|同等どうとうになる)
    既定きてい最大さいだいサイズはformat要素ようそ内部ないぶ画像がぞうサイズ指定してい依存いぞん(メディアの種類しゅるいべつことなります)。
  • 水平すいへい位置いちオプション:leftrightcenternoneのいずれかひとつ。 複数ふくすうのオプションを記述きじゅつした場合ばあい、1番目ばんめのみ採用さいよう
    画像がぞう文章ぶんしょう水平すいへい方向ほうこう位置いち関係かんけい(テキストのまわみの有無うむ)をめます(既定きていなし)。
  • 垂直すいちょく位置いちオプションbaselinesubsupertoptext-topmiddlebottomのいずれかひとつ。
    おなじブロックない前後ぜんごのテキストにたいして、浮動ふどうインライン画像がぞう垂直すいちょく方向ほうこう配置はいちめます(既定きてい垂直すいちょく方向ほうこう配置はいちmiddle)。
  • リンク オプション: 以下いかのいずれか
    • link={target}生成せいせいされたリンクのリンクさきを (任意にんいのページめいまたは URL に) 変更へんこうできるようにする。レンダリングされた画像がぞうじょう使用しようできる。れい: [[File:Example.jpg|20px|link=http://www.wikipedia.org]] (外部がいぶリンク) として、[[File:Example.jpg|20px|link=MediaWiki]] (内部ないぶリンク) としてレンダリングされる。
    • link= (そら場合ばあい) — (MediaWiki 1.14+) リンクをつけない画像がぞう表示ひょうじれい [[File:Example.jpg|20px|link=]]として処理しょり
    もしlink等号とうごうのあいだに空白くうはくスペースがはいると、リンクはキャプションとして表示ひょうじされます。
    "たいして%22使用しようするなど、いくつかのHTML文字もじ相当そうとうするものをふくめると、リンクぶん説明せつめいぶんとしてあつかわれることがあります(phabricator:T306216をごらんください)。
    ! MW 1.24以前いぜん場合ばあい|link=| (empty) に設定せっていするとtitle処理しょりされません。(phabricator:T23454参照さんしょう。)
  • その固有こゆうのオプション:
    • alt={alternative text} — (MediaWiki 1.14+) 特定とくてい画像がぞう代替だいたいテキストを指定してい (作成さくせいされた ‎<img /> 要素ようそたいするHTML属性ぞくせいとしてalt="..."し)、指定していした画像がぞうのダウンロードとみに失敗しっぱいした場合ばあいや、サポートメディアが代替だいたい説明せつめいぶん使用しようする必要ひつようがある状況じょうきょう (点字てんじリーダーの使用しようちゅうまたは利用りようしゃがブラウザーのアクセシビリティのオプションを設定せってい) で表示ひょうじします。
    もしalt等号とうごうのあいだに空白くうはくスペースがはいると、代替だいたいぶんはキャプションとして表示ひょうじされます。
    • page={number}特定とくていのページ番号ばんごう表示ひょうじ現状げんじょうでは.djvuもしくは.pdf形式けいしきのファイルにのみ適用てきよう)。
    • thumbtime={number}Renders a thumbnail from the video at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
    • start={number}When video playback is started it will start at the specified timestamp in seconds or MM:SS or HH:MM:SS format (only applicable when showing a video file).
    • mutedWhen media playback is started, audio will be muted.
    • loopMedia will loop continuously. (only applies to audio and video)
    • lossy={false} — (PagedTiffHandler ) For using PNG instead of JPG thumbnails for Tiff images
    • class={html class} — (MediaWiki 1.20+)クラスを定義ていぎします (生成せいせいされた ‎<span>...‎</span> 要素ようそまわりにラップされた ‎<img /> 要素ようその HTML 属性ぞくせい class="..." にマップします)。
Default behavior since MediaWiki 1.40, optional since MediaWiki 1.36.[1] Previously the class was applied directly to the ‎<img /> element.[2]
    • lang={language code} — (MediaWiki 1.22+) SVGファイルに<switch>ぶんふく場合ばあいシステム言語げんご属性ぞくせい依存いぞんしてファイルを解析かいせきする言語げんご選択せんたくします。 既定きていはページの言語げんごです (既定きていおおくのプロジェクトでプロジェクトの既定きてい言語げんごです)。

属性ぞくせい適合てきごうするものがまったくない場合ばあいは、キャプションの文章ぶんしょうなされます。 パラメータではない文字もじれつを2以上いじょう記入きにゅうすると、最後さいごパラメータ文字もじれつをキャプションとして表示ひょうじ。 キャプションの文章ぶんしょうとは、thumbおよびframeモードで画像がぞう下部かぶ表示ひょうじされ、その書式しょしきだとツールチップに表示ひょうじされます。 thumbおよびframeモードで表示ひょうじするキャプションの文章ぶんしょうには、ウィキリンクその書式しょしきふくむことができます。 MediaWiki の拡張かくちょう機能きのう追加ついかてきなオプションを追加ついかする場合ばあいがあります。

'alt'を指定していしないままキャプションをけると、代替だいたいぶんはキャプションから書式しょしき削除さくじょして自動じどう生成せいせいされます。例外れいがいとしてthumbもしくはframeモードではスクリーンリーダーでりが可能かのうなため、この処理しょり対象たいしょうから除外じょがいします。

実際じっさいのデフォルトの動作どうさは、マルチメディアファイルをフルサイズで表示ひょうじします。 このため、ファイルはばがページよりおおきい場合ばあい、レスポンシブに問題もんだい発生はっせいすることがあります。 くわしくはphab:T113101のタスクをごらんください。


書式しょしき

つぎひょうは、使用しよう可能かのうすべての効果こうかしめしています。

サムネイルが横長よこながではなく縦長たてなが表示ひょうじサイズがおおきすぎる場合ばあいupright=N設定せっていできます。「N」は画像がぞう縦横じゅうおうはば÷たかさ)で、既定きていは0.75。 そのわりに、希望きぼうする画像がぞうたかさに上限じょうげん(ピクセル単位たんい)を指定していすることができます。

thumb={filename}指定していすると、サムネイルにべつ画像がぞう利用りようできます。

サイズとフレーム

サイズ属性ぞくせい効果こうかは、書式しょしきわると下記かきのようにことなることがあります。

  • サイズを指定していしなかった場合ばあい表示ひょうじは、上記じょうき書式しょしきふし参照さんしょうしてください。
  • 書式しょしき指定してい、もしくはborderきとだけ指定していした場合ばあい画像がぞう任意にんいおおきさに縮小しゅくしょう拡大かくだいもできます。
  • 下記かきのサンプル画像がぞうのサイズは本来ほんらい、400 × 267 ピクセルです。
  • An image with frame always ignores the size specification; the original image will be reduced if it exceeds the maximum size defined in user preferences, and the page information will display a Linter error.
  • thumb および frameless画像がぞうは、縮小しゅくしょうはできますが、画像がぞうもとのサイズをえて拡大かくだいすることはできません。
書式しょしき 縮小しゅくしょう 拡大かくだい
(指定してい)
[[File:example.jpg|50px]]

[[File:example.jpg|500px]]


border
[[File:example.jpg|border|50px]]

[[File:example.jpg|border|500px]]


frame
[[File:example.jpg|frame|50px]]
[[File:example.jpg|frame|500px]]


thumb
[[File:example.jpg|thumb|50px]]
[[File:example.jpg|thumb|500px]]


frameless
[[File:example.jpg|frameless|50px]]

[[File:example.jpg|frameless|500px]]

水平すいへい位置いち

frameまたはthumb[nail]書式しょしき使つか場合ばあい、デフォルトの水平すいへい位置いちひだりからみぎへの言語げんごでは right となり、みぎからひだりへの言語げんごでは left となることに注意ちゅういしてください。

説明せつめい 入力にゅうりょく内容ないよう 出力しゅつりょく結果けっか
水平すいへい位置いち指定していもしくは既定きてい
浮動ふどうブロックとしてレンダリング: いいえ
インラインでレンダリング: はい
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
[[File:example.jpg|100px|キャプション]]
本文ほんぶん 本文ほんぶん 本文ほんぶん ...
... 本文ほんぶん 本文ほんぶん 本文ほんぶん

キャプション 本文ほんぶん 本文ほんぶん 本文ほんぶん ...

水平すいへい位置いち指定してい: なし
浮動ふどうブロックとしてレンダリング: いいえ
インラインでレンダリング: いいえ
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
[[File:example.jpg|none|100px|キャプション]]
本文ほんぶん 本文ほんぶん 本文ほんぶん ...
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
キャプション
キャプション

本文ほんぶん 本文ほんぶん 本文ほんぶん ...

水平すいへい位置いち指定してい: センター
浮動ふどうブロックとしてレンダリング: いいえ
インラインでレンダリング: いいえ
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
[[File:example.jpg|center|100px|キャプション]]
本文ほんぶん 本文ほんぶん 本文ほんぶん ...
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
キャプション
キャプション

本文ほんぶん 本文ほんぶん 本文ほんぶん ...

水平すいへい位置いち指定してい: ひだり
浮動ふどうブロックとしてレンダリング: はい
インラインでレンダリング: いいえ
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
[[File:example.jpg|left|100px|キャプション]]
本文ほんぶん 本文ほんぶん 本文ほんぶん ...
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
キャプション
キャプション

本文ほんぶん 本文ほんぶん 本文ほんぶん ...

水平すいへい位置いち指定してい: みぎ
浮動ふどうブロックとしてレンダリング: はい
インラインでレンダリング: いいえ
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
[[File:example.jpg|right|100px|キャプション]]
本文ほんぶん 本文ほんぶん 本文ほんぶん ...
... 本文ほんぶん 本文ほんぶん 本文ほんぶん
キャプション
キャプション

本文ほんぶん 本文ほんぶん 本文ほんぶん ...

垂直すいちょく位置いち

水平すいへい位置いち指定していオプションが有効ゆうこうになる条件じょうけんとは、画像がぞうがインラインの要素ようそとして解析かいせきされ、なおかつ浮動ふどうブロックではない場合ばあいです。 インラインの画像がぞうは、おなじブロックないにある前後ぜんごのテキストと同時どうじ解析かいせきし、このオプションによって垂直すいちょく位置いちわせがまります。

注意ちゅうい事項じこうとして、右記うき配置はいち制約せいやくしたが行間ぎょうかんひろげると、画像がぞう挿入そうにゅうした解析かいせきみのテキストぎょう(ならびに現在げんざいくだりつづいて解析かいせきするテキストぎょう)をした移動いどうし、インライン画像がぞう完全かんぜん表示ひょうじできることに注意ちゅういしてください(フォントサイズが可変かへん文字もじれつうえ文字もじした文字もじ使用しようでも同様どうよう行間ぎょうかんひろげることが可能かのうです)。

ソースコード表示ひょうじ
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''top:''' [[File:Example.jpg|20px|top]] [[File:Example.jpg|40px|top]] [[File:Example.jpg|100px|top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-top:''' [[File:Example.jpg|20px|text-top]] [[File:Example.jpg|40px|text-top]] [[File:Example.jpg|100px|text-top]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sup>super:</sup> [[File:Example.jpg|20px|super]] [[File:Example.jpg|40px|super]] [[File:Example.jpg|100px|super]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''baseline:''' [[File:Example.jpg|20px|baseline]] [[File:Example.jpg|40px|baseline]] [[File:Example.jpg|100px|baseline]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
<sub>'''sub:'''</sub> [[File:Example.jpg|20px|sub]] [[File:Example.jpg|40px|sub]] [[File:Example.jpg|100px|sub]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''default:''' [[File:Example.jpg|20px]][[File:Example.jpg|40px]] [[File:Example.jpg|100px]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''middle:''' [[File:Example.jpg|20px|middle]] [[File:Example.jpg|40px|middle]] [[File:Example.jpg|100px|middle]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''text-bottom:''' [[File:Example.jpg|20px|text-bottom]] [[File:Example.jpg|40px|text-bottom]] [[File:Example.jpg|100px|text-bottom]]
<del>text</del></u></span></p>
 
<p style="border:1px solid #AAA;padding:0;font-size:150%;line-height:2">
<span style="background:#FFF;color:#000;text-decoration:overline"><u><del>text</del>
'''bottom:'' [[File:Example.jpg|20px|bottom]] [[File:Example.jpg|40px|bottom]] [[File:Example.jpg|100px|bottom]]
<del>text</del></u></span></p>

位置いち指定してい結果けっかをより明確めいかくしめすには、文字もじたかさの上下じょうげ罫線けいせんしめし、フォントのサイズは200%に拡大かくだい段落だんらくブロックをほそわくせんかこんであります。さらにことなるサイズの画像がぞう配置はいちしました。

text top: text

text text-top: text

text super: text

text baseline: text

text sub: text

text default: text

text middle: text

text text-bottom: text

text bottom: text

注記ちゅうき:

  1. 通常つうじょう画像がぞう位置いち指定してい垂直すいちょく方向ほうこうの"middle"(既定きてい中央ちゅうおう配置はいち)とは、テキストのたかさxとベースラインの中心ちゅうしん(ここに画像がぞうたかさの中心ちゅうしんわせ文字もじ中心ちゅうしん横切よこぎ)であって、"text-top"と "text-bottom"のあいだ空間くうかんしめすフォントたかさのくだりたかさの中心ちゅうしんではありません。フォントたかさは以下いか除外じょがいします。
    • くだりくだりあいだ補完ほかんする空白くうはくで、通常つうじょうはフォントたかさの上下じょうげに、くだり余白よはく2箇所かしょ均等きんとう配分はいぶんされます(このサンプルは200%拡大かくだいしてあるため0.5em)。
    • くだりくだりあいだ補完ほかんする空白くうはくで、うえ文字もじした文字もじによって追加ついかされます。
  2. しかしながら画像がぞうたかさが原因げんいんで、画像がぞう上辺うわべまたは下辺かへんがテキストの正常せいじょうくだりぜんこうよりうえもしくはした位置いちする場合ばあいは、画像がぞうおさまってただしい位置いちになるようにうえまたはしたくだりマージンをやして中心ちゅうしん位置いち調整ちょうせいし、すべての画像がぞうたかさがひくいものをふくめ)を調節ちょうせつ中心ちゅうしん位置いち配置はいちします(コンピュータ処理しょりじょう有効ゆうこうくだりたかさ、解析かいせきしたれつごとにたかさがおおきめのフォントを考慮こうりょれます)。
  3. "text-top"と"text-bottom"位置いち配置はいちはやはりうえ文字もじした文字もじによって追加ついかされたぶん行間ぎょうかん除外じょがいするものの、行高ゆきたかさの指定していえた行間ぎょうかんふくめます。
  4. "top"と"bottom"位置いち配置はいちでは、あらゆる行間ぎょうかんやす要素ようそ解析かいせきしたくだりスパンないうえ文字もじした文字もじふくむ)を考慮こうりょれます。 画像がぞう配置はいち指定してい原因げんいんで、画像がぞう正常せいじょう行間ぎょうかんよりうえまたはしたにはみさないために画像がぞう位置いちただしく配置はいちされない場合ばあいには、"top"と"bottom"の配置はいちは(まるでうえ文字もじした文字もじのように)画像がぞう影響えいきょうけ、解析かいせきしたテキストぎょう有効ゆうこうくだりたかさはおおきくなります。
  5. 文字もじ装飾そうしょくの"underline"と"overline"、"overstrike"の位置いちはこれら2つの制限せいげん範囲はんいないおさまるべきで、使用しようするフォントの種類しゅるいたかさの影響えいきょうけることもあります (ブラウザーによってはうえ文字もじした文字もじのスタイルが考慮こうりょされるものの、通常つうじょうはそれらのスタイルは無視むしされ装飾そうしょく位置いち調整ちょうせいけません)。このように装飾そうしょく文字もじはテキストにたいするのとはことなり、通常つうじょう画像がぞう垂直すいちょく方向ほうこう配置はいち影響えいきょうあたえません。

まわみの解除かいじょ

ときにはテキスト(あるいはそののインラインの浮動ふどうしない画像がぞう)が浮動ふどう画像がぞうまわみしないようにするほうがよい場合ばあいがあります。 テキストを画像がぞう右側みぎがわながむと、ふし見出みだし (たとえば == わたし見出みだし ==) がウェブ ブラウザーの画像がぞう解像度かいぞうどその条件じょうけんにより、本来ほんらい利用りようしゃ画像がぞうしたにあると期待きたいしているのに、画面がめん右側みぎがわ表示ひょうじされることがあります。 まわんだ画像がぞうしたにテキストを表示ひょうじするには、そのテキストのまえ<br clear=all>このみにより<div style="clear: both"></div>でも可能かのう)をくと、まわみを解除かいじょできます。 (空行くうぎょう使つかわずおな効果こうかるには、まわみをする画像がぞうふくふし<div style="overflow: hidden"></div>はさみ、div要素ようそ内部ないぶ画像がぞうまわみをすべて解除かいじょできます。)

ブロックない解析かいせきした画像がぞうまわみをせず中央ちゅうおう(center)かひだり(left)に配置はいちしたりみぎ(right)にまわんだ、つまりframedthumbnailモードのまわみをする画像がぞう)はすべて、表面ひょうめんじょうはそうはえないものの、周囲しゅういのテキストぎょう区切くぎっています(現在げんざい画像がぞうまえのテキストブロックをわらせて、そのうしろにあたらしい段落だんらく作成さくせいしテキストをながむからです)。 それら画像がぞうつぎに、左右さゆう位置いちわせマージン(または中央ちゅうおういた画像がぞうのマージンの中心ちゅうしんせん)に沿って、上下じょうげかさなります。

既定きていのリンク ターゲットの変更へんこう

リンクターゲットの変更へんこう削除さくじょ方法ほうほう以下いかのテーブルにしめします(既定きてい画像がぞう説明せつめいページ)。 リンクだけえても、上記じょうきふし説明せつめいしたフォーマットは変更へんこうできません。

警告けいこく:

利用りようのウィキによっては、ライセンス要件ようけんとして著者ちょしゃ帰属きぞく著作ちょさくけんかんする記述きじゅつ適用てきようされるライセンス条項じょうこう、あるいはまたレンダリングされた画像がぞう詳細しょうさいな(修正しゅうせい履歴りれきふくむ)説明せつめい表示ひょうじする説明せつめいページへの必要ひつようなリンクは、一切いっさい削除さくじょ許可きょかされません。
もし特定とくてい画像がぞうのターゲットリンクを変更へんこうまたは削除さくじょする場合ばあい、ページのべつ場所ばしょにこの説明せつめいページへの明示めいじてきなリンクを提供ていきょうするか、または画像がぞうんだページ自体じたい該当がいとうする要素ようそことなる場合ばあいは、著作ちょさくけん著者ちょしゃ記述きじゅつならびに該当がいとうするライセンスへのリンクを表示ひょうじする必要ひつようがあります。
利用りようのウィキの方針ほうしんによっては、代替だいたいのリンク属性ぞくせい使用しよう制限せいげんしたり、みメディアファイルに代替だいたいリンク属性ぞくせいつよ禁止きんしすることもあり(この場合ばあいにはリンク属性ぞくせい無視むし)あるいはまた、権限けんげんあたえられたユーザーまたは管理かんりしゃによる検証けんしょうのみ、それらをれます。

画像がぞうのギャラリー表示ひょうじ処理しょり

ギャラリーの構文こうぶん

‎<gallery>タグを使用しようし、画像がぞうのギャラリー表示ひょうじ簡単かんたん指定していできます。 構文こうぶん以下いかとおりです:

<gallery>
File:file_name.ext|caption|alt=alt language
File:file_name.ext|caption|alt=alt language
{...}
</gallery>

ギャラリータグないでは、画像がぞうのコードをだいカッコ([[]])にれないてん注意ちゅういしてください。

キャプションをけて、ウィキリンクその書式しょしき指定していができます。

キャプションとして使用しようされている「center」「left」「right」といった単語たんごは、Linter エラーのあやま検出けんしゅつこします。 詳細しょうさいタスク T275074参照さんしょうしてください。

サムネイルの表示ひょうじめる変数へんすうのうち、具体ぐたいてきにファイルを変更へんこうするものを使用しようできます。(ページない表示ひょうじする画像がぞう位置いち指定していはしません。) いちれいとして、pdfなど複数ふくすうページで構成こうせいされるメディアの場合ばあいpage=4、ビデオの場合ばあいthumbtime=10のような指定していができます。

File: 接頭せっとう省略しょうりゃく可能かのう。 しかしながら省略しょうりゃくせずにのこしておくと、ウィキぶんから画像がぞう識別子しきべつしさがしやすくなります(たとえばページのレイアウトを刷新さっしんするときなどに便利べんり)。

れい:

<gallery>
File:Example.jpg|Item 1
File:Example.jpg|a link to [[Help:Contents]]
File:Example.jpg
File:Example.jpg|alt=An example image. It has flowers
File:Example.jpg|''italic caption''
File:Example.jpg|Links to external website|link=https://example.com
File:Example.jpg|link=w:Main_Page|Internal link
Example.jpg|on page "{{PAGENAME}}"
File:Using Firefox.pdf|page=72
</gallery>

上記じょうき表示ひょうじつぎのとおりです。

mode パラメーター

MediaWiki バージョン:
1.22

1.22 以降いこうmode パラメーターの利用りようはじまり、以下いかのオプションを使用しようできます:

  • traditional は MediaWiki の既定きていのギャラリー表示ひょうじです。(訳注やくちゅう: わくせんあり)
  • nolinestraditionalていますが、わくせんがありません。
  • packed画像がぞうたかさのみ統一とういつし、はばもとのサイズに比例ひれいします。画像がぞうあいだにわずかな隙間すきまがあります。 このレスポンシブウェブデザイン下図したず)では、れつはば画面がめんはばわせて自動的じどうてき調整ちょうせいします。
  • packed-overlay画像がぞううえはん透明とうめいしろいボックスをかさね、キャプションを表示ひょうじします。
  • packed-hoverpacked-overlayていて、マウスオーバーしたときのみ、はん透明とうめいのボックスにキャプションを表示ひょうじします。
  • slideshow では画像がぞうのスライドショーを作成さくせいします。

れい:

<gallery mode="packed-hover">
Image:Astronotus_ocellatus.jpg|''[[commons:Astronotus ocellatus|Astronotus ocellatus]]'' (Oscar)
Image:Salmonlarvakils.jpg|''[[commons:Salmo salar|Salmo salar]]'' (Salmon Larva)
Image:Georgia Aquarium - Giant Grouper.jpg|''[[commons:Epinephelus lanceolatus|Epinephelus lanceolatus]]'' (Giant grouper)
Image:Pterois volitans Manado-e.jpg|''[[commons:Pterois volitans|Pterois volitans]]'' (Red Lionfish)
Image:Macropodus opercularis - front (aka).jpg|''[[commons:Macropodus opercularis|Macropodus opercularis]]'' (Paradise fish)
Image:Canthigaster valentini 1.jpg|''[[commons:Canthigaster valentini|Canthigaster valentini]]'' (Valentinni's sharpnose puffer)
Image:Flughahn.jpg|[[Image:POTY ribbon 2007.svg|25px]] ''[[commons:Dactylopterus volitans|Dactylopterus volitans]]'' (Flying gurnard)
Image:Fishmarket 01.jpg|''[[commons:Semicossyphus pulcher|Semicossyphus pulcher]]'' (California Sheephead)
Image:Pseudorasbora parva(edited version).jpg|''[[commons:Category:Pseudorasbora parva|Pseudorasbora parva]]'' (Topmouth gudgeon)
Image:MC Rotfeuerfisch.jpg|''[[commons:Category:Pterois antennata|Pterois antennata]]'' (Antennata Lionfish)
Image:Cleaning station konan.jpg|''[[commons:Novaculichthys taeniourus|Novaculichthys taeniourus]]''
Image:Synchiropus splendidus 2 Luc Viatour.jpg|''[[commons:Synchiropus splendidus|Synchiropus splendidus]]'' (Mandarin fish)
File:Psetta maxima Luc Viatour.jpg|''[[commons:Psetta maxima|Psetta maxima]]'' (Turbot)
File:Australian blenny.jpg|''[[commons:Category:Ecsenius|Ecsenius axelrodi]]''
</gallery>

上記じょうき表示ひょうじつぎのとおりです(packed-hoverモード)

そののモードのれい:

mode="traditional"

mode="nolines"

mode="packed"

mode="packed-overlay"

mode="packed-hover"

MediaWiki バージョン:
1.28

mode="slideshow"

ギャラリーのその属性ぞくせい

ギャラリーのタグ自体じたい、その属性ぞくせいをいくつかそなえており、それぞれ属性ぞくせいめいのペアとしてあらわします。

<gallery {parameters}>
{images}
</gallery>
  • caption="{caption}":キャプション(2単語たんご以上いじょうぶん欧文おうぶん半角はんかくじゅう引用いんようはさんで指定してい)をギャラリーの上辺うわべ中央ちゅうおうそろえで配置はいちします。キャプションのぶんは、書式しょしき指定していやテンプレートそののマークアップは無効むこうです。
  • widths={width}px画像がぞうはば最大さいだい)を指定してい既定きていは120px。 (It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) 複数ふくすうがたの widths であることにご注意ちゅういください.
  • heights={heights}px: :画像がぞうたかさ(最大さいだい)を指定してい既定きていは120px。 (It has no effect if mode is set to slideshow.)
  • perrow={integer}:1れつ画像がぞう点数てんすう設定せってい(It has no effect if mode is set to one of the following: packed, packed-overlay, packed-hover, slideshow.) 0 にすると、画面がめんはばわせて自動じどう調整ちょうせい
  • showfilename={anything}画像がぞう1てんごとのキャプションにファイルめい表示ひょうじ(1.17以降いこう)。
  • mode={traditional|nolines|packed|packed-hover|packed-overlay|slideshow}上記じょうきふし参照さんしょう(1.22以降いこう。"slideshow"は1.28以降いこう)。
  • showthumbnails: 「スライドショー」モード限定げんていで、スライドショー下部かぶ既定きてい帯状おびじょう画像がぞうのサムネイルを表示ひょうじ (1.29以降いこう)。
はばたかさの変数へんすう余白よはくなしで画像がぞう間隔かんかくめた"packed"(およびその応用おうようがた)モードの絶対ぜったいではなく、推奨すいしょうとして解釈かいしゃくされます。 "packed"モードでは複数ふくすうれつよこはばひとしくなるように、画像がぞう1てんごとのはば自動じどう調整ちょうせいします。
れい 1

構文こうぶん:

<gallery widths=300px heights=200px>
File:Example.jpg|Lorem ipsum
File:Example.jpg|Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy eirmod tempor invidunt ut
</gallery>

結果けっか:

れい2

構文こうぶん:

<gallery widths=60px heights=60px perrow=7 caption="sunflowers are groovy">
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
File:Example.jpg
</gallery>

結果けっか:

ブラウザー画面がめんはばわせ画像がぞうつぎれつかえ

はばことなる複数ふくすう画像がぞうならべるには、"thumb"、"left"あるいは"none"モードではうまくいきません。 "thumb"モードを使用しようしない場合ばあい (つまりキャプションなし) は、画像がぞうはブラウザー画面がめんはばわせ、つぎれつかえして表示ひょうじされます。 画像がぞうつぎれつかえすかどうかたしかめたい場合ばあいは、ブラウザー画面がめん縮小しゅくしょうしてみます。

[[File:Example.jpg|220px]]
[[File:Example.jpg|100px]]
[[File:Example.jpg|150px]]
[[File:Example.jpg|250px]]
[[File:Example.jpg|200px]]
[[File:Example.jpg|50px]]
[[File:Example.jpg|220px]]
[[File:Example.jpg|175px]]

キャプションきではばことなる画像がぞうれつかえすには統一とういつせいのない一覧いちらんにdiv HTMLをもちいる必要ひつようがあります。style="display: inline-block;"併用へいようします。詳細しょうさいならびにかんがかたは、右記うき外部がいぶリンクで参照さんしょうできます:Give Floats the Flick in CSS Layouts(CSSレイアウトで浮動ふどう表示ひょうじに Flick を追加ついか)。

<div><ul> 
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
  • Caption 1
  • Caption 2
  • Caption 3
  • Caption 4
  • Caption 5
  • Caption 6
  • Caption 7
  • Caption 8

画像がぞう上端じょうたんそろえるには、vertical-alignコマンドを追加ついかします。

<div><ul> 
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 1]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|100px|Caption 2]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|150px|Caption 3]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|250px|Caption 4]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|200px|Caption 5]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|50px|Caption 6]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|220px|Caption 7]] </li>
<li style="display: inline-block; vertical-align: top;"> [[File:Example.jpg|thumb|none|175px|Caption 8]] </li>
</ul></div>
  • Caption 1
  • Caption 2
  • Caption 3
  • Caption 4
  • Caption 5
  • Caption 6
  • Caption 7
  • Caption 8

wikiファーム(wikiホスティングサービス)によっては、ギャラリー表示ひょうじのオプションを一部いちぶしかそなえていません(れい:"widths")。 あるいはまた、ユーザーがおなれつならべる画像がぞうそれぞれのはばえようとすることもあります。 画像がぞうならべるとブラウザーの画面がめんはばわせて自動的じどうてき配置はいちするため、ギャラリー表示ひょうじつまり div HTML を使用しようせずに、画像がぞうにひとつずつ個別こべつのキャプションをけることはできません。 実際じっさいためしてみましょう。ウィキぶん使つかっても、ギャラリー表示ひょうじ以外いがいではうまくキャプションをけられません。画像がぞう右側みぎがわにある要素ようそうえかさなってしまうか、強制きょうせいてき水平すいへいのスクロールバーを表示ひょうじしてしまいます。

画像がぞう左側ひだりがわまわみ(「left」)を複数ふくすう画像がぞうもちいるとき、いくつかの画像がぞうに「none」を設定せっていした場合ばあいも、画像がぞう右側みぎがわにサイドバーがある場合ばあいとくに、挙動きょどう一貫いっかんしません。 奇妙きみょう現象げんしょうこることがあります。 ブラウザーのウィンドウはばまたはモニター画面がめんはばせま場合ばあいれつはばからはみした画像がぞうはページのかなり下方かほうの、右側みぎがわのサイドバーののち表示ひょうじされます。

リンクの挙動きょどう

画像がぞう既定きていのリンクさきは、その画像がぞう解説かいせつページになります。 「link=」オプションを使つかい、既定きてい挙動きょどうえさせてそののページもしくは外部がいぶサイトにリンクさせたり、画像がぞうのリンク機能きのう無効むこうにしたりできます。

あるいはべつ方法ほうほうとして、文字もじれつでリンクを記述きじゅつし、ファイルの説明せつめいページへ、あるいはファイルそれ自体じたいぶことができます。 Help:ファイルへのリンク 参照さんしょうしてください。

画像がぞう表示ひょうじし、のページもしくは外部がいぶサイトにリンクさせる

「link=」オプションを使つかい、画像がぞうのページもしくは外部がいぶサイトとリンクします。

下記かき画像がぞうをクリックすると、MediaWikiびます:

[[File:MediaWiki-2020-logo.svg|50px|link=MediaWiki]]

下記かき画像がぞうをクリックすると、外部がいぶリンクexample.comびます:

[[File:MediaWiki-2020-logo.svg|50px|link=http://example.com]]

リンクをかくして画像がぞう表示ひょうじする

「link=」オプションを使つかい、リンク表示ひょうじリンクのそら設定せっていします。以下いか画像がぞうはリンクではありません。

[[File:MediaWiki-2020-logo.svg|50px|link=]]

画像がぞうにリンクする

作成さくせいするリンクに接頭せっとうとして:追加ついかします。

[[:File:MediaWiki-2020-logo.svg]]

File:MediaWiki-2020-logo.svg

[[:File:MediaWiki-2020-logo.svg|Wiki]]

Wiki

画像がぞうへの直接ちょくせつリンク

上記じょうきれいでは、画像がぞう説明せつめいページにリンクしています。 画像がぞう直接ちょくせつリンクするために、以下いかのMediaWikiのページで擬似ぎじ名前なまえ空間くうかんであるMedia:使用しようすることができます。

[[Media:MediaWiki-2020-logo.svg]]

Media:MediaWiki-2020-logo.svg

外部がいぶサイトからの直接ちょくせつリンク

もうひとつの可能かのうせいは、Special:Redirect/fileページ(またはそのエイリアスであるSpecial:Filepath)を利用りようすることです。 上記じょうきれいとはことなり、MediaWikiのページだけでなく、外部がいぶのWebサイトからもリンクすることができます。

[[Special:Redirect/file/Wikipedia.png]]

また、heightおよwidthのパラメータを追加ついかすることで、特定とくていのサイズの画像がぞうかえすことも可能かのうです。 画像がぞう縦横じゅうおうつね維持いじされます。

https://www.mediawiki.org/w/index.php?title=Special:Redirect/file/Wikipedia.png&width=100&height=100

画像がぞう完全かんぜんな URL の取得しゅとく

上記じょうきのようにリダイレクトをとおさずに)画像がぞうのフルパスを取得しゅとくするには、いくつかのマジックワード 使用しようすることができます。

{{filepath:MediaWiki-2020-logo.svg}}

出力しゅつりょく結果けっか

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

これを実行じっこうしたテンプレートからFile:名前なまえ空間くうかん削除さくじょする必要ひつようがある場合ばあいには、{{PAGENAME}}使つかいます。

{{filepath:{{PAGENAME:File:MediaWiki-2020-logo.svg}}}}

出力しゅつりょく結果けっか

//upload.wikimedia.org/wikipedia/commons/d/dd/MediaWiki-2020-logo.svg

外部がいぶサイトのファイル

オンラインで参照さんしょうできる外部がいぶサイトのファイルにリンクするには、外部がいぶサイトへのリンクに使用しようする構文こうぶん流用りゅうようできます。 その構文こうぶんかいすると、当該とうがい画像がぞうをレンダリングするわりに、リンクさきしめ文字もじれつのみ表示ひょうじします。

[http://url.for/some/image.png]

あるいは表示ひょうじようべつ文言もんごん代入だいにゅうします。

[http://url.for/some/image.png ここにリンクする文言もんごん記入きにゅう]

表示ひょうじよう文言もんごんとして、そののMediaWikiマークアップあるいはHTML/CSS形式けいしき(インラインの要素ようそ)の使用しようみとめられます(前後ぜんごのリンクをこわ場合ばあいみリンクを除外じょがい)。

[http://www.example.com/some/image.png サンプル'''<del>リッチな</del>''' ''<ins>リンクする文言もんごん</ins>''をここに記入きにゅう。]

すると以下いか表示ひょうじになります。 サンプルリッチな リンクする文言もんごんをここに記入きにゅう

利用りようのウィキで利用りよう可能かのうにすると(Manual:$wgAllowExternalImages 参照さんしょう)、外部がいぶ画像がぞうみも可能かのうです。手順てじゅん画像がぞうのURLを記入きにゅうするだけです。

http://url.for/some/image.png

現状げんじょうでは画像がぞうのサイズ変更へんこう不可能ふかのうですが、MediaWikiマークアップあるいはHTML/CSSコードではさんで書式しょしきめることはできます。

もしこのウィキのオプションが無効むこう場合ばあい画像がぞうまれないわりに外部がいぶサイトへの文字もじれつのリンクとして、上記じょうきのように記述きじゅつされます。

関連かんれん項目こうもく