ヘルプ:Images/ja

提供: ひつじ小屋別館2代目
< ヘルプ:Images
2013年6月30日 (日) 01:23時点におけるしが (トーク | 投稿記録)による版 (1版)

移動先: 案内検索
PD 注意: このページを編集すると、編集内容が CC0 のもとで公開されることに同意したと見なされます。詳細はパブリック・ドメインのヘルプ ページを参照してください。
PD
</div>

ここではウィキ上での画像表示のためのマークアップを説明しています。ページ内に画像を埋め込む前に、あなたのウィキでファイルのアップロードが有効になっている必要があります(詳しくはマニュアル参照)。更に、埋め込みたい画像がアップロードされている必要があります。

マークアップ

画像を表示するためのマークアップは次の通りです。

[[ファイル:{ファイル名}|{オプション}]]

オプションはまったく指定しなくてもよいし、複数指定することもできます。オプションはパイプ記号(|)で区切ります。

  • border, frame, thumb, または frameless: 表示形式を指定
  • left, right, center, none: テキスト内における画像の配置指定
  • baseline, sub, super, top, text-top, middle, bottom, text-bottom: テキスト内における画像の垂直配置を指定
  • {幅}px: 指定した幅に画像をサイズ変更
  • {幅}x{高さ}px: 幅と高さの上限値に収まるようにサイズ変更。x{高さ}pxとすることで高さだけを指定できる
  • 特殊な例
    • page=1: djvu ファイルの表示開始ページを指定
  • link={リンク先}: 任意のページまたはURLへのリンク、またはリンクなし (1.14+)
  • alt={代替文}: 代替テキストの別指定 (alt="") of an image (1.14+)

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

表示形式

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

説明 入力内容 表示結果
表示形式の指定なし
... text text text
[[ファイル:example.jpg|caption]]
text text text ...
... text text text

caption text text text ...

border は画像の周りを薄い灰色のボーダーで囲みます
... text text text
[[ファイル:example.jpg|border|caption]]
text text text ...
... text text text

caption text text text ...

frame
... text text text
[[ファイル:example.jpg|frame|caption]]
text text text ...
... text text text
caption

text text text ...

thumb
... text text text
[[ファイル:example.jpg|thumb|caption]]
text text text ...
... text text text
caption

text text text ...

frameless は thumb 同様、利用者の設定した画像幅にリサイズしますが、枠がなく、また右寄せになりません
... text text text
[[ファイル:example.jpg|frameless|caption]]
text text text ...
... text text text

caption text text text ...

frameless と border の併用
... text text text
[[ファイル:example.jpg|frameless|border|caption]]
text text text ...
... text text text

caption text text text ...

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

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

配置

frame および thumb を使う時には、デフォルトの配置は right になります。

説明 入力内容 表示結果
配置指定なし
... text text text
[[ファイル:example.jpg|caption]]
text text text ...
... text text text

caption text text text ...

noneを指定
... text text text
[[ファイル:example.jpg|none|caption]]
text text text ...
... text text text
caption

text text text ...

center
... text text text
[[ファイル:example.jpg|center|caption]]
text text text ...
... text text text
caption

text text text ...

left
... text text text
[[ファイル:example.jpg|left|caption]]
text text text ...
... text text text
caption

text text text ...

right
... text text text
[[ファイル:example.jpg|right|caption]]
text text text ...
... text text text
caption

text text text ...

垂直配置

text text [[ファイル:サンプル.jpg|20px]]
text text [[ファイル:サンプル.jpg|20px|baseline]]
text text [[ファイル:サンプル.jpg|20px|sub]]
text text [[ファイル:サンプル.jpg|20px|super]]
text text [[ファイル:サンプル.jpg|20px|text-top]]
text text [[ファイル:サンプル.jpg|20px|middle]]
text text [[ファイル:サンプル.jpg|20px|bottom]]
text text [[ファイル:サンプル.jpg|20px|text-bottom]]

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

text text 20px text text 20px text text 20px text text 20px text text 20px text text 20px text text 20px text text 20px

サイズ指定と表示形式の関係

サイズ指定は表示形式によって反映のされ方が異なります。

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

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

表示形式 縮小 拡大
(not specified)
[[ファイル:サンプル.jpg|50px]]

50px

[[ファイル:サンプル.jpg|200px]]

200px


border
[[ファイル:サンプル.jpg|border|50px]]

50px

[[ファイル:サンプル.jpg|border|200px]]

200px


frame
[[ファイル:サンプル.jpg|frame|50px]]
[[ファイル:サンプル.jpg|frame|200px]]


thumb
[[ファイル:サンプル.jpg|thumb|50px]]
[[ファイル:サンプル.jpg|thumb|200px]]


frameless
[[ファイル:サンプル.jpg|frameless|50px]]

50px

[[ファイル:サンプル.jpg|frameless|200px]]

200px

画像のギャラリー

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

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

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

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

例えば

<gallery>
ファイル:サンプル.jpg|項目 1
ファイル:サンプル.jpg| [[Help:Contents/ja]] へリンク
ファイル:サンプル.jpg
ファイル:サンプル.jpg
ファイル:サンプル.jpg| ''イタリック体のキャプション''
ファイル:サンプル.jpg| "{{PAGENAME}}" のページ
</gallery>

は次のようになります。

パラメータ

ギャラリータグにはいくつかのパラメータが指定可能です。

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

ファイルの説明ページへのリンク

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

[[:ファイル:サンプル.jpg]]
[[:ファイル:サンプル.jpg|Sunflowers]]

は次のようになります。

ファイル:サンプル.jpg Sunflowers

ファイルへの直接リンク

ファイルの説明ページを通らずにファイルに直接リンクするには疑似名前空間の “メディア” を使用できます。

[[メディア:サンプル.jpg]]
[[メディア:サンプル.jpg|Sunflowers]]

は次のようになります。

メディア:サンプル.jpg Sunflowers

外部サイトのファイル

外部リンクと同じ構文を利用して外部サイトにあるファイルにリンクすることが出来ます。

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

リンクラベルを変えるなら

[http://url.for/some/image.png リンクラベル]

あるいはあなたのウィキで設定が有効になっていれば( Manual:$wgAllowExternalImages参照)、外部サイトのファイルを直接埋め込むこともできます。その場合は、ただURLを埋め込むだけです。

http://url.for/some/image.png
言語: English  • 日本語

案内メニュー