|
|
| 1行目: |
1行目: |
| <noinclude>{{Documentation subpage}}</noinclude><includeonly>
| | {{書きかけ}} |
| {{Pp-template}}{{使用箇所の多いテンプレート|140,000以上}}</includeonly>
| |
| {{Mbox templates}}
| |
| <!-- 以下でテンプレートの解説を編集してください -->
| |
| '''Ambox''', '''A'''rticle '''M'''essage '''B'''ox（記事用メッセージボックス）は、{{tl|wikify}} 等の、記事に使用するお知らせ用のテンプレートを作成するためのテンプレート（'''メタテンプレート'''）です。<!--元々は記事に使用するために作られたものですが、現在ではTemplate、Categoryなど、記事以外の、ノートページでない名前空間にも使用されています。-->
| |
| | |
| Ambox にはその用途に応じた6種類の色が用意されています。画像の指定は任意ですが、画像関連のパラメータが指定されない場合は各色ごとに規定の画像が表示されます。
| |
| | |
| このメタテンプレートは、[[MediaWiki:Common.css]] に記述された ambox 用の [[Cascading Style Sheets|CSS]] クラスが適用された状態の雛形を提供するものです。これらの CSS クラスはこのテンプレートに限らず、[[Help:表の作り方#パイプ構文|パイプ構文で書かれた表]]内で直接使うこともできます。使用方法は [[:en:Wikipedia:Ambox CSS classes]] を参照してください。
| |
| | |
| == 使い方 ==
| |
| 単純な例：
| |
| | |
| <pre style="margin:.5em 10%">{{ambox | text = さくさく}}</pre>
| |
| {{ambox | text = さくさく}}
| |
| | |
| 複雑な例：
| |
| | |
| <pre style="margin:.5em 10%">{{ambox
| |
| | type = style
| |
| | image-file = Icon apps query.svg
| |
| | imageright-file = Icon apps query.svg
| |
| | image-size = 35
| |
| | text = メッセージボックスの本文
| |
| }}</pre>
| |
| {{ambox
| |
| | type = style
| |
| | image-file = Icon apps query.svg
| |
| | imageright-file = Icon apps query.svg
| |
| | image-size = 35
| |
| | text = メッセージボックスの本文
| |
| }}
| |
| | |
| == パラメータ ==
| |
| {| class="wikitable"
| |
| |+ パラメータの一覧
| |
| ! パラメータ !! 指定する内容 !! 既定値 !! 説明
| |
| |-
| |
| ! style="text-align:left;" | type
| |
| | protection / speedy / delete / content / style / move / notice || notice || 色と既定アイコンの選択。[[#type パラメータと色の対応]]
| |
| |-
| |
| ! style="text-align:left;" | image
| |
| | 画像表示の記述。例: <nowiki>[[ファイル:Some image.svg|40px]]</nowiki> / none / blank || || Wiki構文による画像指定。[[#画像指定方法の詳細]]
| |
| |-
| |
| ! style="text-align:left;" | imageright
| |
| | 画像表示の記述。例: <nowiki>[[ファイル:Some image.svg|40px]]</nowiki> || || Wiki構文による右側への画像指定。[[#画像指定方法の詳細]]
| |
| |-
| |
| ! style="text-align:left;" | image-file
| |
| | 画像ファイル名。例: Some image.svg || || [[#画像の指定]]
| |
| |-
| |
| ! style="text-align:left;" | image-size
| |
| | ピクセル数を数値で || 40 || ノーマルタイプの画像サイズ。[[#画像指定方法の詳細]]
| |
| |-
| |
| ! style="text-align:left;" | image-size-section
| |
| | ピクセル数を数値で || 40 || 節タイプの場合の画像サイズ。[[#画像指定方法の詳細]]
| |
| |-
| |
| ! style="text-align:left;" | imageright-file
| |
| | 画像ファイル名。例: Some image.svg || || 右側に表示する画像のファイル名。[[#画像指定方法の詳細]]
| |
| |-
| |
| ! style="text-align:left;" | imageright-size
| |
| | ピクセル数を数値で || (''image-size'') || ノーマルタイプの右側画像サイズ。[[#画像指定方法の詳細]]
| |
| |-
| |
| ! style="text-align:left;" | imageright-size-section
| |
| | ピクセル数を数値で || (''image-size-section'') || 節タイプの場合の右側画像サイズ。[[#画像指定方法の詳細]]
| |
| |-
| |
| ! style="text-align:left;" | section
| |
| | 空白以外。1 など || || 節タイプへのスタイル切り替え。[[#section パラメータ: 節タイプとの切り替え]]
| |
| |-
| |
| ! style="text-align:left;" | printable
| |
| | 空白以外。1 など || || 印刷時も表示する。[[#その他の設定]]
| |
| |-
| |
| ! style="text-align:left;" | style
| |
| | [[Cascading Style Sheets|CSS]] の記述 || || CSS による外観の細かい設定。<strong style="color:red">*** 廃止予定 ***</span>
| |
| |-
| |
| ! style="text-align:left;" | background
| |
| | #rrggbb / #rgb / [[:en:Web colors#HTML color names|色の名前]] / transparent || || 背景色の設定。[[#その他の設定]]
| |
| |-
| |
| ! style="text-align:left;" | text
| |
| | 任意の文章 || '''（省略不可）''' || メッセージ本文。
| |
| |-
| |
| ! style="text-align:left;" | text-section
| |
| | 任意の文章 || (''text'') || 節タイプの場合に表示するメッセージ本文。[[#section パラメータ: 節タイプとの切り替え]]
| |
| |}
| |
| | |
| === type パラメータと色の対応 ===
| |
| '''type''' パラメータには以下の6種のいずれかの値を指定します。テンプレート左側の色は値により変化するので、用途によって使い分けてください。表示されている画像は、画像関連のパラメータを指定しない場合の、それぞれの値に既定のアイコン画像です。
| |
| | |
| {{ambox
| |
| | type = protection
| |
| | text = type='''protection''' - {{tl|保護}}や{{tl|半保護}}などの保護中のお知らせ。
| |
| }}
| |
| {{ambox
| |
| | type = speedy
| |
| | text = type='''speedy''' - {{tl|即時削除}}や{{tl|sdnd}}などの即時削除に関する告知。
| |
| }}
| |
| {{ambox
| |
| | type = delete
| |
| | text = type='''delete''' - {{tl|sakujo}}などの削除に関する告知。
| |
| }}
| |
| {{ambox
| |
| | type = content
| |
| | text = type='''content''' - {{tl|観点}}や{{tl|国際化}}などの内容に関する注意。
| |
| }}
| |
| {{ambox
| |
| | type = style
| |
| | text = type='''style''' - {{tl|cleanup}}や{{tl|wikify}}などのスタイル修正に関する注意。
| |
| }}
| |
| {{ambox
| |
| | type = move
| |
| | text = type='''move''' - {{tl|改名提案}}や{{tl|字引}}などの記事の改名・分割・統合・Transwikiに関する提案。
| |
| }}
| |
| {{ambox
| |
| | type = notice
| |
| | text = type='''notice''' - {{tl|最新の出来事}}や{{tl|工事中}}などの、その他一般のお知らせ。type パラメータの指定を省略するとこれが適用されます。
| |
| }}
| |
| | |
| === section パラメータ: 節タイプとの切り替え ===
| |
| '''section''' パラメータに空白以外を指定すると、節の冒頭で使うためのもの（'''節タイプ'''）に変化します。
| |
| | |
| {{ambox
| |
| | type = style
| |
| | section = 1
| |
| | text = テンプレート本文
| |
| }}
| |
| | |
| ひとつのテンプレートに、記事冒頭で使うタイプ（'''ノーマルタイプ'''）と節タイプの両方の機能を持たせることもできます。テンプレートが section パラメータを受け取れるようにし、そのまま ambox の section パラメータに渡すだけです。
| |
| <pre style="margin:.5em 10%">{{ambox
| |
| | section = {{{section|}}}
| |
| | text = テンプレート本文
| |
| }}</pre>
| |
| | |
| ノーマルタイプと節タイプで文章を切り替えるには、'''text-section''' パラメータを指定します。
| |
| <pre style="margin:.5em 10%">{{ambox
| |
| | section = {{{section|}}}
| |
| | text = ノーマルタイプの本文
| |
| | text-section = 節タイプの本文
| |
| }}</pre>
| |
| {{ambox
| |
| | section =
| |
| | text = ノーマルタイプの本文
| |
| | text-section = 節タイプの本文
| |
| }}
| |
| {{ambox
| |
| | section = 1
| |
| | text = ノーマルタイプの本文
| |
| | text-section = 節タイプの本文
| |
| }}
| |
| | |
| === 画像の指定 ===
| |
| 上記の既定アイコンは簡便のために用意されていますが、多くの場合はより目的に合う画像を選んだ方が適切です。以下の例では '''image-file''' パラメータを指定し、既定アイコン以外の特定の画像を表示しています。
| |
| | |
| {{ambox
| |
| | type = content
| |
| | image-file = Unbalanced scales.svg
| |
| | text = type = content<br/> image-file = Unbalanced scales.svg<br/>この画像は{{tl|観点}}などでよく使われます。
| |
| }}
| |
| {{ambox
| |
| | type = style
| |
| | image-file =Wikitext.svg
| |
| | text = type = style<br/> image-file = Wikitext.svg<br/>{{tl|wikify}}などでよく使われる画像です。
| |
| }}
| |
| {{ambox
| |
| | type = move
| |
| | image-file = Merge-arrows.svg
| |
| | text = type = move<br/> image-file = Merge-arrows.svg<br/>{{tl|統合提案}}などで使われる画像です。
| |
| }}
| |
| | |
| ==== 画像指定方法の詳細 ====
| |
| 画像の指定には、'''image-file''' パラメータを使用する方法と、'''image''' パラメータを使用する方法があります。
| |
| | |
| ; image-file
| |
| : 画像のファイル名を指定します。画像サイズは '''image-size''' パラメータと '''image-size-section''' パラメータで[[ピクセル]]数を指定し、節タイプの場合は自動的に -section の指定値が反映されます。既定値はどちらも 40 です。image と image-file が同時に指定された場合、基本的に image-file が優先されます。
| |
| ; image
| |
| : <code><nowiki>[[ファイル:Unbalanced scales.svg|40px]]</nowiki></code> のように、普段画像を表示するのと同じ方法で指定します。画像サイズも含めて指定するので、節タイプでサイズを切り替えることはできません。
| |
| | |
| <pre style="margin:.5em 10%">{{ambox
| |
| | image-file = Icon apps query.svg
| |
| | image-size = 50
| |
| | image-size-section = 25
| |
| | text = ノーマルタイプ
| |
| | text-section = 節タイプ
| |
| | section = {{{section|}}}
| |
| }}</pre>
| |
| {{ambox
| |
| | image-file = Icon apps query.svg
| |
| | image-size = 50
| |
| | image-size-section = 25
| |
| | text = ノーマルタイプ
| |
| | text-section = 節タイプ
| |
| | section =
| |
| }}
| |
| {{ambox
| |
| | image-file = Icon apps query.svg
| |
| | image-size = 50
| |
| | image-size-section = 25
| |
| | text = ノーマルタイプ
| |
| | text-section = 節タイプ
| |
| | section = 1
| |
| }}
| |
| | |
| <pre style="margin:.5em 10%">{{ambox
| |
| | image = [[ファイル:Icon apps query.svg|50px]]
| |
| | text = ノーマルタイプ
| |
| | text-section = サイズが個別に指定できない
| |
| | section = {{{section|}}}
| |
| }}</pre>
| |
| {{ambox
| |
| | image = [[ファイル:Icon apps query.svg|50px]]
| |
| | text = ノーマルタイプ
| |
| | text-section = サイズが個別に指定できない
| |
| | section =
| |
| }}
| |
| {{ambox
| |
| | image = [[ファイル:Icon apps query.svg|50px]]
| |
| | text = ノーマルタイプ
| |
| | text-section = サイズが個別に指定できない
| |
| | section = 1
| |
| }}
| |
| | |
| image パラメータに特定のキーワードを指定することで、画像を非表示にできます。
| |
| ; image = none
| |
| : 画像を非表示にし、ボックス内をすべてテキスト用の領域とします。このキーワードのみ、image-file パラメータの指定よりも優先されます。
| |
| ; image = blank
| |
| : 画像を非表示にしますが、本来の表示領域をそのまま空白として残します。複数の ambox を並べたときに、テキストの左揃えの位置を一致させることができます。
| |
| | |
| {{ambox
| |
| | image = none
| |
| | text = image = none<br />全領域にテキストを表示します。
| |
| }}
| |
| {{ambox
| |
| | image = blank
| |
| | text = image = blank<br />画像の表示スペースが空白になります。
| |
| }}
| |
| {{ambox
| |
| | text = 他の画像有りの ambox と並べたときにテキストが揃います。
| |
| }}
| |
| | |
| 画像を右側にも表示させられます。
| |
| ; imageright-file, imageright-size, imageright-size-section
| |
| : image-file パラメータと同様の使い方です。節タイプで画像サイズが自動で変わるのも同様で、サイズは省略した場合 image-size と image-size-section の値がそれぞれ既定値となります（これらも省略していた場合は 40）。
| |
| ; imageright
| |
| : image パラメータと同様の使い方ですが、キーワード指定はありません。
| |
| {{ambox
| |
| | image-file = Gnome globe current event.svg
| |
| | imageright-file = Nuvola apps bookcase.svg
| |
| | text = image-file = Gnome globe current event.svg<br/>imageright-file = Nuvola apps bookcase.svg
| |
| | section =
| |
| }}
| |
| {{ambox
| |
| | image-file = Gnome globe current event.svg
| |
| | imageright-file = Nuvola apps bookcase.svg
| |
| | text = image-file = Gnome globe current event.svg / imageright-file = Nuvola apps bookcase.svg / section = 1
| |
| | section = 1
| |
| }}
| |
| {{ambox
| |
| | image = [[ファイル:Gnome globe current event.svg|42px]]
| |
| | imageright = [[ファイル:Nuvola apps bookcase.svg|40px]]
| |
| | text = image = <nowiki>[[ファイル:Gnome globe current event.svg|42px]]</nowiki><br/>imageright = <nowiki>[[ファイル:Nuvola apps bookcase.svg|40px]]</nowiki>
| |
| }}
| |
| | |
| === その他の設定 ===
| |
| '''printable''' パラメータに空白以外を指定すると、印刷時にもテンプレートが表示されるようになります。通常、お知らせ用のテンプレートは印刷時には必要ないものですが、法的・医学的な注意など印刷される必要のあるものも中には存在するので、そのような場合はこのパラメータを指定してください。
| |
| | |
| '''background''' パラメータを指定すると、ambox の背景色を変更できます。<strong style="color:#d33">テンプレート間の外観の統一に支障をきたすため、強い警告以外での使用は推奨されていません。</strong>#rrggbb 形式や[[:en:Web colors#HTML color names|色名]]での指定など、[[Cascading Style Sheets|CSS]] で色として指定できる文字列を設定します。
| |
| | |
| '''style''' パラメータには、CSS を自由に記述可能です。このパラメータは<strong style="color:#d33">テンプレート間の外観の統一に支障をきたすため、廃止が予定されています。</strong>
| |
| | |
| == 技術情報 ==
| |
| * 特殊な文字を text パラメータで使う場合は注意が必要です。'''中括弧''' ( '''{ }''' ) や'''パイプ''' ( '''|''' ) を使用する際は、<nowiki></nowiki> で囲むか、[[文字参照]] ( { } -> &#123; &#125;, | -> &#124;) を使うか、もしくは特定のテンプレートを使って ( | -> {{tl|!}}) 、テンプレートの一部と見なされないようにする必要があります。中括弧は単独であれば（2つ以上連続したり、パイプと組み合わさったりしなければ）特に影響はありません。
| |
| * このテンプレートの外観の大部分は [[Cascading Style Sheets|CSS]] クラスで指定されているので、このテンプレートを使っているテンプレートは '''type''' パラメータの指定を変更するだけで枠線の色などを[[スキン|一括変更]]することが可能です。
| |
| * テンプレート内部では、[[Help:表の作り方#パイプ文法|パイプ文法]]ではなく <table> タグ等を使用した [[Extensible HyperText Markup Language|XHTML]] マークアップを使っています。[[Help:条件文|条件文]]中でパラメータ区切りのパイプと干渉するなど、パイプ文法にはいくつかの欠点があるので、メタテンプレートの作成には XHTML マークアップを使うのが通例です。
| |
| | |
| この他の技術的詳細は[[{{TALKPAGENAME}}|ノートページ]]や'''関連項目'''以下にあるリンク先を参照してください。
| |
| | |
| == 関連項目 ==
| |
| *{{tl|ambox}} - 記事用
| |
| *{{tl|tmbox}} - ノートページ用
| |
| *{{tl|cmbox}} - カテゴリ用
| |
| *{{tl|ombox}} - その他のページ用
| |
| *{{tl|mbox}} - 名前空間を自動判定して表示形式を変えるメッセージボックス
| |
| *{{tl|fmbox}} - ヘッダ／フッタ用
| |
| *{{tl|dmbox}} - 曖昧さ回避用
| |
| *{{tl|asbox}} - 記事スタブ用
| |
| | |
| * [[:en:Wikipedia:Ambox CSS classes]] - [[Help:表の作り方|wikitable]] や [[:en:HTML element#Tables|HTML table]] で直接 ambox CSS classes を使う方法の記述（英語版）
| |
| * [[:en:Wikipedia:Article message boxes]] - article message box 作成に関する[[スタイルガイド]]（英語版）
| |
| * [[:en:Wikipedia talk:Article message boxes]] - これらの問題に関する議論（英語版）
| |
| * [[Wikipedia‐ノート:ウィキプロジェクト テンプレート/お知らせテンプレート]] - 日本語版の議論<includeonly>
| |
| | |
| <!-- カテゴリは以下に追加してください -->
| |
| {{デフォルトソート:Ambox}}
| |
| [[Category:メタテンプレート]]
| |
| </includeonly>
| |
