Template:Ambox/doc
 | これはTemplate:Amboxの解説サブページです。 使用方法、カテゴリ、およびその他テンプレートページ自体に含まれない情報を収容しています。 |
 | Luaモジュールを使用しています: |
| メッセージボックス メタテンプレート | |
|---|---|
| テンプレート | 対象 |
| {{Ambox}} | 記事 |
| {{Cmbox}} | カテゴリ |
| {{Imbox}} | ファイル |
| {{Tmbox}} | ノート |
| {{Fmbox}} | フッタ / ヘッダ |
| {{Ombox}} | その他 |
| {{Mbox}} | 自動判別 |
| {{Asbox}} | 記事スタブ |
| {{Dmbox}} | 曖昧さ回避 |
 | このテンプレートは記事名前空間専用です。それ以外の名前空間では外装によっては表示されない/正しく表示されない場合があります。記事以外にも使用する場合は汎用の{{Mbox}}テンプレートを使用してください。 |
Ambox, Article Message Box（記事用メッセージボックス）は、{{出典の明記}} 等の、記事に使用するお知らせ用のテンプレートを作成するためのテンプレート（メタテンプレート）です。
Ambox にはその用途に応じた6種類の色が用意されています。画像の指定は任意ですが、画像関連のパラメータが指定されない場合は各色ごとに規定の画像が表示されます。
このメタテンプレートは、MediaWiki:Common.css に記述された ambox 用の CSS クラスが適用された状態の雛形を提供するものです。これらの CSS クラスはこのテンプレートに限らず、パイプ構文で書かれた表内で直接使うこともできます。使用方法は en:Wikipedia:Ambox CSS classes を参照してください。
記事ページにおいて、このテンプレートを用いて記事の編集についての注意事項の記述（このページを編集する際には……）など、その記事がウィキペディアの一部であるという前提に依拠した使用はしないでください。詳しくはWikipedia:ウィキペディアへの自己言及をご覧ください。編集時の注意をしたい場合は、コメントアウト<!-- -->で記事のソース内に注意書きを置いてください。
使い方
[編集]単純な例：
{{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種のいずれかの値を指定します。テンプレート左側の色は値により変化するので、用途によって使い分けてください。表示されている画像は、画像関連のパラメータを指定しない場合の、それぞれの値に既定のアイコン画像です。
 |
 |
| type=delete - {{sakujo}}などの削除に関する告知。 |
 |
 | type=style - {{wikify}}などのスタイル修正に関する注意。 |
 |
|
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 を並べたときに、テキストの左揃えの位置を一致させることができます。
image = none 全領域にテキストを表示します。 |
image = blank 画像の表示スペースが空白になります。 |
| 他の画像有りの ambox と並べたときにテキストが揃います。 |
画像を右側にも表示させられます。
- imageright
- image パラメータと同様の使い方ですが、キーワード指定はありません。
 | image = [[ファイル:Gnome globe current event.svg|42px]] imageright = [[ファイル:Nuvola apps bookcase.svg|40px]] |  |
問題と修正
[編集]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 パラメータが設定された場合、テンプレート名前空間で有効になります。 |
| パラメータ指定の無い記事メッセージボックス | テンプレート名またはデフォルトソート | パラメータに不足がある場合、テンプレート名前空間で有効になります。 |