Help:Images/ja

[[Category:ヘルプ|{{BASEPAGENAME}}]]
ここではウィキ上での'''画像'''表示のためのマークアップを説明しています。ページ内に画像を埋め込む前に、あなたのウィキでファイルのアップロードが有効になっている必要があります（詳しくは{{mediawiki|Manual:Configuring_file_uploads/ja|マニュアル}}参照）。更に、埋め込みたい画像が[[Help:Managing files/ja|アップロード]]されている必要があります。

{{H2|マークアップ}}
画像を表示するためのマークアップは次の通りです。
 [[{{ns:image}}:{ファイル名}|{オプション}]]

オプションはまったく指定しなくてもよいし、複数指定することもできます。オプションはパイプ記号（<code>|</code>）で区切ります。
*<code>border</code>, <code>frame</code>, <code>thumb</code>, または <code>frameless</code>: 表示形式を指定
*<code>left</code>, <code>right</code>, <code>center</code>, <code>none</code>: テキスト内における画像の配置指定
*<code>baseline</code>, <code>sub</code>, <code>super</code>, <code>top</code>, <code>text-top</code>, <code>middle</code>, <code>bottom</code>, <code>text-bottom</code>: テキスト内における画像の垂直配置を指定
*<code>{幅}px</code>: 指定した幅に画像をサイズ変更
*<code>{幅}x{高さ}px</code>: 幅と高さの上限値に収まるようにサイズ変更。<code>x{高さ}px</code>とすることで高さだけを指定できる
* 特殊な例
** <code>page=1</code>: djvu ファイルの表示開始ページを指定
*<code>link={リンク先}</code>: 任意のページまたはURLへのリンク、またはリンクなし ([[rev:41727|1.14+]])
*<code>alt={代替文}</code>: 代替テキストの別指定 (<code>alt=""</code>) of an image ([[rev:41837|1.14+]])

オプションはどの順番に指定してもかまいません。互いに矛盾するオプションがある場合、原則として後者が適用されます。ただし、表示形式の指定においては、<code>frame</code>, <code>thumb</code>, <code>frameless</code> および／または <code>border</code> の順に優先されます。与えられた文字列がいずれのオプションにも一致しない場合、キャプション用のテキスト（および代替文）として見なされます。キャプションにはウィキリンクや他の整形マークアップを使うことができます。

{{H2|表示形式}}
以下は各表示形式の指定結果を示す表です。

{| class="wikitable"
!説明
!入力内容
!表示結果
{{../frame|frame=|ex=表示形式の指定なし}}
{{../frame|frame=border|ex=border は画像の周りを薄い灰色のボーダーで囲みます}}
{{../frame|frame=frame}}
{{../frame|frame=thumb}}
{{../frame|frame=frameless|ex=frameless は thumb 同様、利用者の設定した画像幅にリサイズしますが、枠がなく、また右寄せになりません}}
{{../frame|frame=frameless|2=border|ex=frameless と border の併用}}
|}

縦長の画像にサムネイル形式を使った時に他の画像よりも目立つ大きさになってしまう時には、 <code>upright</code> オプションを使うと、より適切なサイズに調整されます。

なお、 <code>thumb={ファイル名}</code> のようにすると、サムネイル用に違う画像を指定することができます。

{{H2|配置}}
<code>frame</code> および <code>thumb</code> を使う時には、デフォルトの配置は <code>right</code> になります。

{| class="wikitable"
!説明
!入力内容
!表示結果
{{../frame|frame=|ex='''配置指定なし'''}}
{{../frame|frame=none|ex='''none'''を指定}}
{{../frame|frame=center}}
{{../frame|frame=left}}
{{../frame|frame=right}}
|}

{{H3|垂直配置}}
 text text <nowiki>[[</nowiki>{{ns:image}}:{{mediawiki:image_sample}}|20px]]
 text text <nowiki>[[</nowiki>{{ns:image}}:{{mediawiki:image_sample}}|20px|baseline]]
 text text <nowiki>[[</nowiki>{{ns:image}}:{{mediawiki:image_sample}}|20px|sub]]
 text text <nowiki>[[</nowiki>{{ns:image}}:{{mediawiki:image_sample}}|20px|super]]
 text text <nowiki>[[</nowiki>{{ns:image}}:{{mediawiki:image_sample}}|20px|text-top]]
 text text <nowiki>[[</nowiki>{{ns:image}}:{{mediawiki:image_sample}}|20px|middle]]
 text text <nowiki>[[</nowiki>{{ns:image}}:{{mediawiki:image_sample}}|20px|bottom]]
 text text <nowiki>[[</nowiki>{{ns:image}}:{{mediawiki:image_sample}}|20px|text-bottom]]

は以下のように出力されます（結果をわかりやすくするためにテキストに下線を引いています）

<u>text text [[{{ns:image}}:{{mediawiki:image_sample}}|20px]]
text text [[{{ns:image}}:{{mediawiki:image_sample}}|20px|baseline]]
text text [[{{ns:image}}:{{mediawiki:image_sample}}|20px|sub]]
text text [[{{ns:image}}:{{mediawiki:image_sample}}|20px|super]]
text text [[{{ns:image}}:{{mediawiki:image_sample}}|20px|text-top]]
text text [[{{ns:image}}:{{mediawiki:image_sample}}|20px|middle]]
text text [[{{ns:image}}:{{mediawiki:image_sample}}|20px|bottom]]
text text [[{{ns:image}}:{{mediawiki:image_sample}}|20px|text-bottom]]</u>

{{H2|サイズ指定と表示形式の関係}}
サイズ指定は表示形式によって反映のされ方が異なります。

* 表示形式が未指定、または <code>border</code> のみが指定されている時には、サイズ指定がそのまま反映されます。
* <code>frame</code> を指定すると、全てのサイズ指定が無視されます。
* <code>thumb</code> および <code>frameless</code> では縮小は可能ですが、画像のもともとの大きさを越えて拡大することはできません。

サイズを指定しない時の表示結果については、上記の[[#表示形式|表示形式]]のセクションを参照してください。

{| class="wikitable"
!表示形式!!縮小!!拡大
{{../size|frame=}}
{{../size|frame=border}}
{{../size|frame=frame}}
{{../size|frame=thumb}}
{{../size|frame=frameless}}
|}

{{H2|画像のギャラリー}}
<code><nowiki><gallery></nowiki></code>タグを使って、簡単にサムネイルのギャラリを作成できます。マークアップは次の通りです。

 <nowiki><gallery></nowiki>
 {{ns:image}}:{ファイル名}|{キャプション}
 {{ns:image}}:{ファイル名}|{キャプション}
 {...}
 </gallery>

画像ファイルの指定を角括弧で囲まない点に注意してください。

キャプションは指定してもしなくてもかまいません。リンクなどの整形が使えます。

例えば
 <nowiki><gallery></nowiki>
 {{ns:image}}:{{mediawiki:image_sample}}|項目 1
 {{ns:image}}:{{mediawiki:image_sample}}| <nowiki>[[</nowiki>Help:Contents/ja]] へリンク
 {{ns:image}}:{{mediawiki:image_sample}}
 {{ns:image}}:{{mediawiki:image_sample}}
 {{ns:image}}:{{mediawiki:image_sample}}| <nowiki>''イタリック体のキャプション''</nowiki>
 {{ns:image}}:{{mediawiki:image_sample}}| "<nowiki>{{</nowiki>PAGENAME}}" のページ
 </gallery>
は次のようになります。
<gallery>
Image:Example.jpg|項目 1
Image:Example.jpg|[[Help:Contents/ja]] へリンク
Image:Example.jpg
Image:Example.jpg
Image:Example.jpg|''イタリック体のキャプション''
Image:Example.jpg| "{{PAGENAME}}" のページ
</gallery>

{{H3|パラメータ}}
ギャラリータグにはいくつかのパラメータが指定可能です。
<pre><gallery {パラメータ}>
{画像}
</gallery></pre>

* <code>caption={キャプション}</code>: ギャラリーのキャプション
* <code>widths={幅}px</code>: 画像の最大幅
* <code>heights={高さ}px</code>: 画像の最大高さ
* <code>perrow={整数}</code>: 一行あたりのセル数

{{H2|ファイルの説明ページへのリンク}}
コロン (<code>:</code>) を <code>{{ns:image}}:</code> の前に追加すると、画像をページ内に埋め込む代わりに、ファイルの説明ページへリンクします。

 <nowiki>[[</nowiki>:{{ns:image}}:{{mediawiki:image_sample}}]]
 <nowiki>[[</nowiki>:{{ns:image}}:{{mediawiki:image_sample}}|Sunflowers]]

は次のようになります。

[[:{{ns:image}}:{{mediawiki:image_sample}}]]
[[:{{ns:image}}:{{mediawiki:image_sample}}|Sunflowers]]

{{H2|ファイルへの直接リンク}}
ファイルの説明ページを通らずにファイルに直接リンクするには疑似名前空間の “{{ns:media}}” を使用できます。

 <nowiki>[[</nowiki>{{ns:media}}:{{mediawiki:image_sample}}]]
 <nowiki>[[</nowiki>{{ns:media}}:{{mediawiki:image_sample}}|Sunflowers]]

は次のようになります。

[[{{ns:media}}:{{mediawiki:image_sample}}]]
[[{{ns:media}}:{{mediawiki:image_sample}}|Sunflowers]]

{{H2|外部サイトのファイル}}
外部リンクと同じ構文を利用して外部サイトにあるファイルにリンクすることが出来ます。
<pre>[http://url.for/some/image.png]</pre>
リンクラベルを変えるなら
<pre>[http://url.for/some/image.png リンクラベル]</pre>
あるいはあなたのウィキで設定が有効になっていれば（ {{mediawiki|Manual:$wgAllowExternalImages}}参照）、外部サイトのファイルを直接埋め込むこともできます。その場合は、ただURLを埋め込むだけです。
<pre>http://url.for/some/image.png</pre>