imgbox プラグイン *
imgbox プラグインは画像を表示するためのプラグインです。
#imgbox(画像ファイル名){{ URL で外部のファイルを指定するか、Wiki の添付ファイル名へのパスを絶対指定または相対指定 alt=代替テキスト title=タイトルテキスト cap=キャプション pos=(left|right|center) 左右への回り込み、または中央寄せの指定 width=幅 (0 を指定、または省略すると画像本来の幅) height=高さ (0 を指定、または省略すると画像本来の高さ) link=リンク先 (ページ名または URL) nolink (リンクを一切しない) nocap (キャプションをつけない) noborder (ボーダーを表示しない) }}
なお、回り込みを解除するには #clear プラグインを使用してください。
例 1 : 最低限の利用法 *
#imgbox(../sample.png)
既定ではキャプションなし、代替テキストなし、タイトルテキストなし、拡大縮小なし、リンクなし、右回り込みで表示されます。
この例では省いていますが、原則としてキャプションかタイトルテキストは付けるようにしてください。
例 2 : 画像の大きさを指定する *
#imgbox(../sample.png){{ cap=大きさを 100px × 100px に指定 width=100 height=100 }}
#imgbox(../sample.png){{ cap=大きさを 100px × 100px に指定 (nolink) width=100 height=100 nolink }}
画像の大きさを指定すると、自動的に元画像へリンクが張られます。リンクが張られると困る場合は、nolink を指定してください。
- 指定している画像が Wiki の添付画像の場合
- 自動的にサムネイル画像 (JPEG 形式固定) が生成され、以後の表示にはそのサムネイル画像が送出されます。なお、透過色付き画像やアルファチャネル付き画像を指定した場合は背景色は黒になります。
- 指定している画像が Wiki 外部の画像の場合
- サムネイル画像は生成されず、img 要素の width 属性および height 属性の指定で縮小表示されるだけになります。
例 3 : 位置指定 *
#imgbox(../sample.png){{ cap=右側へ回り込み (既定) width=100 height=100 pos=right }}
右側へ回り込ませた例。右側への回り込みは既定設定なので、pos を指定しなくても右側へ回り込みますが、明示的に指定することもできます。
#imgbox(../sample.png){{ cap=左側へ回り込み width=100 height=100 pos=left }}
左側へ回り込ませた例。
#imgbox(../sample.png){{ cap=中央寄せ width=100 height=100 pos=center }}
画像だけを中央に寄せて表示します。これは回り込みではありません。画像をしっかり見せたいときになどに使います。
例 4 : 他のページへのリンク *
#imgbox(../sample.png){{ cap=FrontPage (トップページ) へのリンク width=100 height=100 link=FrontPage }}
Wiki 内のページへリンクを張る際はページ名をそのまま記述してください。そのページが実在すればリンクが張られます。
#imgbox(../sample.png){{ cap=Left 4 Dead シリーズ公式サイトへのリンク width=100 height=100 link=http://www.l4d.com/ }}
外部サイトへリンクを張る際は URL を記述してください。
#imgbox(../sample.png){{ cap=Left 4 Dead シリーズ公式サイトへはリンクされません width=100 height=100 link=http://www.l4d.com/ nolink }}
なお、nolink も同時に指定した場合は nolink が優先されます。
例 5 : その他のパラメータ *
#imgbox(../sample.png){{ cap=nocap を指定 width=100 height=100 nocap }}
nocap を指定するとキャプションが表示されなくなります。
- cap を指定していて、title も指定している場合
- img 要素の title 属性は title の内容になります。
- cap を指定していて、title は指定していない場合
- img 要素の title 属性は cap の内容になります。
- cap を指定していなくて、title は指定している場合
- img 要素の title 属性は title の内容になります。
- cap を指定していなくて、title も指定していない場合
- img 要素の title 属性は省かれます。
#imgbox(../sample.png){{ cap=noborder を指定 width=100 height=100 noborder }}
noborder を指定すると枠線 (および背景色) が表示されなくなります。