テンプレート:Ambox/doc

メッセージボックス; メタテンプレート
テンプレート	対象
{{Ambox}}	記事
{{Cmbox}}	カテゴリ
{{Imbox}}	ファイル
{{Tmbox}}	ノート
{{Fmbox}}	フッタ / ヘッダ
{{Ombox}}	その他
{{Mbox}}	自動判別
{{Asbox}}	記事スタブ
{{Dmbox}}	曖昧さ回避

40px

This is a documentation subpage for テンプレート:Ambox.
It contains usage information, categories and other content that is not part of the original テンプレート page.

[[Category:MediaWiki documentation pages{{#translation:}}]]

30px

Luaモジュールを使用しています:

モジュール:Message box

Ambox, Article Message Box（記事用メッセージボックス）は、{{出典の明記}} 等の、記事に使用するお知らせ用のテンプレートを作成するためのテンプレート（メタテンプレート）です。

Ambox にはその用途に応じた6種類の色が用意されています。画像の指定は任意ですが、画像関連のパラメータが指定されない場合は各色ごとに規定の画像が表示されます。

このメタテンプレートは、MediaWiki:Common.css に記述された ambox 用の CSS クラスが適用された状態の雛形を提供するものです。これらの CSS クラスはこのテンプレートに限らず、パイプ構文で書かれた表内で直接使うこともできます。使用方法は en:Wikipedia:Ambox CSS classes を参照してください。

使い方

単純な例：

{{Ambox | text = 文章をここに}}

複雑な例：

{{Ambox
| type  = style
| image = [[ファイル:Icon apps query.svg|35px]]
| imageright = [[ファイル:Icon apps query.svg|35px]]
| text  = メッセージボックスの本文
}}

一般的な例：最低限、必要と考えられるパラメータを設定した例です。組み合わせによって、必要なパラメータが変わる可能性があります。

{{Ambox
| name  = <!-- テンプレート名 -->
| subst = <includeonly>{{subst:substcheck}}</includeonly>
| small = {{{small|}}}
| type  = 
| image = 
| sect  = {{{1|}}}
| issue = 
| talk  = {{{talk|}}}
| fix   = 
| date  = {{{date|}}}
| cat   = 
| all   = 
}}

パラメータ

パラメータの一覧
パラメータ	指定する内容	既定値	説明
type	protection / speedy / delete / content / style / move / notice	notice	色と既定アイコンの選択。#type パラメータと色の対応
image	画像表示の記述。例: [[ファイル:Some image.svg\|40px]] / none / blank		Wiki構文による画像指定。#画像指定方法の詳細
imageright	画像表示の記述。例: [[ファイル:Some image.svg\|40px]]		Wiki構文による右側への画像指定。#画像指定方法の詳細
small	left / no	no	小型タイプへのスタイル切り替え。#small パラメータ: 小型タイプとの切り替え
printable	空白以外。1 など		印刷時も表示する。#その他の設定
style	CSS の記述		CSS による外観の細かい設定。
background	#rrggbb / #rgb / 色の名前 / transparent		背景色の設定。#その他の設定
text	任意の文章	（省略不可）	メッセージ本文。
smalltext	任意の文章	(text)	小型タイプの場合に表示するメッセージ本文。#small パラメータ: 小型タイプとの切り替え

type パラメータと色の対応

type パラメータには以下の6種のいずれかの値を指定します。テンプレート左側の色は値により変化するので、用途によって使い分けてください。表示されている画像は、画像関連のパラメータを指定しない場合の、それぞれの値に既定のアイコン画像です。

small パラメータ: 小型タイプとの切り替え

small パラメータにleftと指定すると、小型タイプに変化します。

ひとつのテンプレートに、記事冒頭で使うタイプ（ノーマルタイプ）と小型タイプの両方の機能を持たせることもできます。テンプレートが small パラメータを受け取れるようにし、そのまま ambox の small パラメータに渡すだけです。

{{ambox
| small = {{{small|}}}
| text = テンプレート本文
}}

ノーマルタイプと小型タイプで文章を切り替えるには、smalltext パラメータを指定します。

{{ambox
| small = {{{small|}}}
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}

旧来の節タイプのように幅を端いっぱい長くしたい場合は以下のように指定します。

{{ambox
| style= width:auto;
| small = left
| text = ノーマルタイプの本文
| smalltext = 小型タイプの本文
}}

画像の指定

上記の既定アイコンは簡便のために用意されていますが、多くの場合はより目的に合う画像を選んだ方が適切です。以下の例では image-file パラメータを指定し、既定アイコン以外の特定の画像を表示しています。

画像指定方法の詳細

画像の指定には、image パラメータを使用します。

image: [[ファイル:Unbalanced scales.svg|40px]] のように、普段画像を表示するのと同じ方法で指定します。
smallimage: 小型タイプの場合に指定します。

{{ambox
| image = [[ファイル:Icon apps query.svg|50px]]
| text = ノーマルタイプ
| small = {{{small|}}}
}}

{{ambox
| smallimage = [[ファイル:Icon apps query.svg|25px]]
| smalltext = 小型タイプ
| small = left
}}

image パラメータに特定のキーワードを指定することで、画像を非表示にできます。

image = none: 画像を非表示にし、ボックス内をすべてテキスト用の領域とします。このキーワードのみ、image-file パラメータの指定よりも優先されます。
image = blank: 画像を非表示にしますが、本来の表示領域をそのまま空白として残します。複数の ambox を並べたときに、テキストの左揃えの位置を一致させることができます。

画像を右側にも表示させられます。

imageright: image パラメータと同様の使い方ですが、キーワード指定はありません。

問題と修正

issue引数はその記事の問題を説明するのに使います。短く要点を書き（英語版の説明で約10-20単語とされる）、関係する方針とガイドラインへのリンクを含めます。

fix引数は、その記事を改善するためにすべきことは何かを説明します。issueの説明よりも長くなると思いますが、2行を超えないようにします。

テンプレートがコンパクト型で表示されている場合（英語版では{{複数の問題}}内にある場合）、あるいは小型の場合（|small=leftの使用）issueだけが表示されます。

その他の設定

printable パラメータに空白以外を指定すると、印刷時にもテンプレートが表示されるようになります。通常、お知らせ用のテンプレートは印刷時には必要ないものですが、法的・医学的な注意など印刷される必要のあるものも中には存在するので、そのような場合はこのパラメータを指定してください。

background パラメータを指定すると、ambox の背景色を変更できます。テンプレート間の外観の統一に支障をきたすため、強い警告以外での使用は推奨されていません。#rrggbb 形式や色名での指定など、CSS で色として指定できる文字列を設定します。

style パラメータには、CSS を自由に記述可能です。

技術情報

特殊な文字を text パラメータで使う場合は注意が必要です。中括弧 ( { } ) やパイプ ( | ) を使用する際は、<nowiki></nowiki> で囲むか、文字参照 ( { } → { }, | → |) を使うか、もしくはマジックワードやテンプレートを使って ( | → {{!}}) 、テンプレートの一部と見なされないようにする必要があります。中括弧は単独であれば（2つ以上連続したり、パイプと組み合わさったりしなければ）特に影響はありません。
このテンプレートの外観の大部分は CSS クラスで指定されているので、このテンプレートを使っているテンプレートは type パラメータの指定を変更するだけで枠線の色などを一括変更することが可能です。
テンプレート内部では、パイプ文法ではなく <table> タグ等を使用した XHTML マークアップを使っています。条件文中でパラメータ区切りのパイプと干渉するなど、パイプ文法にはいくつかの欠点があるので、メタテンプレートの作成には XHTML マークアップを使うのが通例です。

この他の技術的詳細はノートページや関連項目以下にあるリンク先を参照してください。

カテゴリ

このテンプレートは、貼り付けられたページに次のカテゴリを適用します:

カテゴリ	ソートキー	説明
記事メッセージボックス	テンプレート名またはデフォルトソート	適切に name パラメータが設定された場合、テンプレート名前空間で有効になります。
パラメータ指定の無い記事メッセージボックス	テンプレート名またはデフォルトソート	パラメータに不足がある場合、テンプレート名前空間で有効になります。