テンプレート:Ambox/doc

この文書は草案です。まだ公式なものではありません。内容に関してノートページで議論を行っています。

これはテンプレート:Amboxの解説サブページです。
使用方法、カテゴリ、およびその他テンプレートページ自体に含まれない情報を収容しています。

このテンプレートは、以下のCSSスタイルシートを使用しています。

このテンプレートは、以下のLuaモジュールを使用しています。

経緯

メタのテンプレート {{ambox}} は、記事内のお知らせボックス（Article message box）です。

これは記事に置くメッセージ箱のテンプレートを構築し、{{style}} などに使います。見た目の要素は背景色とアイコン画像など複数を指定でき、その他の機能も備えています。アイコン画像はパラメータを指定しないと既定の画像になります。

このテンプレートは親から派生したものです。ただしウィキペディアにある同名のテンプレートと全てが同じではなく、当テンプレートは CSS をテンプレートに統合してある点、一部の機能が使えない点が異なります。それでも非常に便利です。

お知らせの表示方法は以下を参照してください。

 {{Ambox
 | type  = notice
 | text  = このページには問題があるようです。
 | fix   = 編集して修正しましょう。
 }}

上記のコードは、実際に次の表示になります。

パラメータのうち「type」（タイプ）で左側の縦帯の色、既定で表示するアイコン画像を指定。このタイプの基準は見た目の美しさではなく、テンプレートが説明する問題のタイプに応じて選びます。利用可能なタイプ7件、その既定の見た目は以下をご覧ください。

外枠と文字列はページを印刷すると表示されません。これは仕様で決まっており、お知らせそのものの価値はページ管理の通知が有効かどうかが重要だからです。つまり必要十分条件とは利用者がオンライン状態であること（ページの編集が可能）と、実際に問題を修正できること（紙版やPDFではない）。