テンプレート:Ambox/doc

提供:日本TW架空国家WIKI
<templatestyles></templatestyles> <templatestyles></templatestyles>
メッセージボックス
メタテンプレート
テンプレート 対象
{{Ambox}} 記事
{{Cmbox}} カテゴリ
{{Imbox}} ファイル
{{Tmbox}} ノート
{{Fmbox}} フッタ / ヘッダ
{{Ombox}} その他
{{Mbox}} 自動判別
{{Asbox}} 記事スタブ
{{Dmbox}} 曖昧さ回避

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

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

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

使い方

単純な例:

{{ambox | text = 文章をここに}}
<templatestyles></templatestyles>

複雑な例:

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

パラメータ

パラメータの一覧
パラメータ 指定する内容 既定値 説明
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、右に配置する場合はright。 小型タイプへのスタイル切り替え。#small パラメータ: 小型タイプとの切り替え
printable 空白以外。1 など 印刷時も表示する。#その他の設定
style CSS の記述 CSS による外観の細かい設定。
background #rrggbb / #rgb / 色の名前 / transparent 背景色の設定。#その他の設定
text 任意の文章 (省略不可) メッセージ本文。
smalltext 任意の文章 (text) 小型タイプの場合に表示するメッセージ本文。#small パラメータ: 小型タイプとの切り替え

type パラメータと色の対応

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

<templatestyles></templatestyles> <templatestyles></templatestyles> <templatestyles></templatestyles> <templatestyles></templatestyles> <templatestyles></templatestyles> <templatestyles></templatestyles> <templatestyles></templatestyles>

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

small パラメータで左側の配置したい時はleft、右側に配置したい場合はrightと指定すると、小型タイプに変化します。

<templatestyles></templatestyles>

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

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

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

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

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

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

画像の指定

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

<templatestyles></templatestyles> <templatestyles></templatestyles> <templatestyles></templatestyles>

画像指定方法の詳細

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

image
[[ファイル:Unbalanced scales.svg|40px]] のように、普段画像を表示するのと同じ方法で指定します。
smallimage
小型タイプの場合に指定します。
{{ambox
| image = [[ファイル:Icon apps query.svg|50px]]
| text = ノーマルタイプ
| small = {{{small|}}}
}}
<templatestyles></templatestyles>
{{ambox
| smallimage = [[ファイル:Icon apps query.svg|25px]]
| smalltext = 小型タイプ
| small = left
}}
<templatestyles></templatestyles>

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

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

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

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

問題と修正

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

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

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

その他の設定

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

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

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

技術情報

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

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

関連項目

  • {{ambox}} - 記事用
  • {{tmbox}} - ノートページ用
  • {{cmbox}} - カテゴリ用
  • {{ombox}} - その他のページ用
  • {{mbox}} - 名前空間を自動判定して表示形式を変えるメッセージボックス
  • {{fmbox}} - ヘッダ/フッタ用
  • {{dmbox}} - 曖昧さ回避用
  • {{asbox}} - 記事スタブ用