Template:File clip/doc
 | これはTemplate:File clipの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。 |
画像のトリミング表示を行います。基本形は{{File clip|ファイル名|width=横幅|上|右|下|左|w=元の横幅|h=元の縦幅|説明文}}です。
使用例
[編集]
[[File:Fuji mt s.jpg|thumb|本栖湖から眺めた富士山]]
上のような表示形式（cf. Help:画像の表示#表示形式）で入力すると、右の1つ目の画像のように出力（表示）されます。ウィキペディアではこのような表示が通例となっていますが、{{File clip}}を使うと任意の部分を切り取るようにして表示することができます。以下が入力例で、右の2つ目の画像のように出力（表示）されます。
本栖湖から眺めた富士山
{{File clip | Fuji mt s.jpg | width = 200 | 40 | 25 | 10 | 35 | w = 431 | h = 269 | 本栖湖から眺めた富士山 }}
文字などは詰めても構いません。
{{File clip|Fuji mt s.jpg|width=200|40|25|10|35|w=431|h=269|本栖湖から眺めた富士山}}
想定される追加事項の多くを入力した例を最後に示しておきます。
{{File clip|Fuji mt s.jpg|width=200|40|25|10|35|w=431|h=269|[[本栖湖]]から眺めた[[富士山]]|align=left|alt=本栖湖から眺めた富士山}}
【編集者向け】元の画像の縦横比を自動算出する方法があれば、ぜひ改良をお願いします（現在は「w」と「h」の引数によって算出しています）。バグ遭遇時にはノートページ等でご報告ください。
使用上の注意
[編集]追跡カテゴリ
[編集]このテンプレートを使用するページはCategory:切り抜き画像に追加されます。
動作環境
[編集]モバイル環境等ではUIに差異が生じている可能性があります。
ファイルのライセンスについて
[編集]画像の切り取り表示を行うため、使用する画像のライセンスが有効であるかを必ず確認してください。クリエイティブ・コモンズ 表示-継承、またはそれに準ずるライセンスを持たない画像には、当テンプレートを使用しないでください。
各項目の説明
[編集]各引数は、整数のみ対応・単位不要です。
| 名称 | 引数 | 説明 | 状態 |
|---|---|---|---|
| ファイル名 | 1 | 「ファイル:ABC.jpg」の「ABC.jpg」部分を記入。 | 必須 |
| 横幅 | width | 画像の表示したい大きさを指定。 | 必須 |
| 上 | 2 | 切り取りたい上部分を0～99%で指定。 | 必須 |
| 右 | 3 | 切り取りたい右部分を0～99%で指定。 | 必須 |
| 下 | 4 | 切り取りたい下部分を0～99%で指定。 | 必須 |
| 左 | 5 | 切り取りたい左部分を0～99%で指定。 | 必須 |
| 元の横幅 | w | 元の画像の横幅と縦幅を記入。画像の大きさ情報は、ファイルページに記載されています。 画像の縦横比を算出するための情報なので、数値の大小は問いません。 |
必須 |
| 元の縦幅 | h | 必須 | |
| 説明文 | 6 | 画像の説明文を記入。 | 任意 |
| 配置指定 | align | デフォルトは右寄せです。左寄せは「left」、中央寄せは「center」、回り込みなしは「none」 | 任意 |
| 代替画像 | thumb | 表示するサムネイル画像を変更できます（詳細はHelp:画像） | 任意 |
| 代替分 | alt | 読み上げブラウザなどのための代替文をキャプションとは別指定する際に使用します。 | 任意 |
| 開始ページ指定 | page | DjVuファイルの場合、page="ページ番号"で開始ページを指定できます。 |
任意 |
| 画像リンク | link | 別のページをリンク先にしたり、リンクをさせなくできます（※著作権に注意。詳細はHelp:画像） | 非推奨 |