Template:File link/doc

このテンプレートは、ファイルへのリンクのウィキテキストを生成します。ほかのテンプレートで（多くのオプションを指定する）複雑なファイルリンクを作成する場合に使用されます。オプションを1、2つ使う程度のシンプルなファイルリンクを作成する場合はウィキテキストをそのまま書いたほうが軽いです。ファイルリンクのウィキテキストに関する詳細はmediawiki.orgでの解説文を参照してください。

使い方

最低限の引数

{{File link|file=ファイル名}}

全ての引数

{{File link
| file       = ファイル名
| format     = 
| formatfile = 
| border     = 
| location   = 
| alignment  = 
| size       = 
| upright    = 
| link       = 
| alt        = 
| caption    = 
| page       = 
| class      = 
| lang       = 
| start      = 
| end        = 
| thumbtime  = 
}}

引数

引数の前後にあるホワイトスペースは除去され、空の値は無視されます。[[File:Symbol support vote.svg|link=]]のように、空の値を指定したい場合は_BLANKを指定してください。モジュール本体で空の値に変換されます。

• file - 入力必須。ファイル名を拡張子付き、名前空間名なしで入力します。
• format - ファイルのフォーマット。'thumb'、'thumbnail'、'frame'、'framed'、'frameless'を入力できます。
• formatfile - 自動生成のサムネイルを使用しない場合、サムネイル画像のファイル名を指定します。
• border - "yes"またはそれに類する値（モジュール:Yesnoで真と判定される値）を入力した場合、画像ボーダーが表示されます。
• location - ファイルの水平位置。'right'、'left'、'center'、'none'を入力できます。
• alignment - ファイルの垂直位置。'baseline'、'middle'、'sub'、'super'、'text-top'、'text-bottom'、'top'、'bottom'を入力できます。
• size - 画像サイズ。例：'100px'、'x100px'、'100x100px'。
• upright - 'upright'引数。縦長の画像の場合に指定します。
• link - ファイルのリンク先を指定します。既定はファイルページですが、どこにもリンクしない場合は_BLANKを指定します。
• alt - 代替テキスト。既定の代替テキストを表示させない場合は_BLANKを指定してください。
• caption - キャプション。
• page - PDFなど複数ページにわたるファイルの場合、ページ番号を指定します。
• class - 画像リンクがHTMLにレンダリングされるとき、生成される<img />要素のclass="..."属性の値を入力します。
• lang - ファイルのレンダリングが行われる言語を指定します。
• start - 音声と動画ファイルの場合、開始時間を指定します。
• end - 音声と動画ファイルの場合、終了時間を指定します。
• thumbtime - 動画ファイルの場合、サムネイル画像に使用する時間を指定します。

これらのオプションの詳細はmediawiki.orgでの解説文を参照してください。

使用例

説明	入力	出力ウィキテキスト	表示
ファイル名のみ指定	{{file link|file=Symbol support vote.svg}}	[[File:Symbol support vote.svg]]
format、size、link、captionを指定	{{file link|file=Symbol support vote.svg|format=thumb|size=220px|link=Wikipedia:サンドボックス|caption=これは例です。}}	[[File:Symbol support vote.svg|thumb|220px|link=Wikipedia:サンドボックス|これは例です。]]	これは例です。
format、size、borderを指定	{{file link|file=Symbol support vote.svg|format=frameless|size=220px|border=true}}	[[File:Symbol support vote.svg|frameless|border|220px]]
_BLANKを指定	{{file link|file=Symbol support vote.svg|format=thumb|link=_BLANK}}	[[File:Symbol support vote.svg|thumb|link=]]