テンプレート:告知/docのソースを表示

<includeonly>{{テンプレート文書呼出}}</includeonly><noinclude>{{テンプレート文書直接表示}}</noinclude>
<!-- 以下でテンプレートの解説を編集してください -->
== このテンプレートについて ==
このテンプレートは、記事の内容に関する質問や提案をしたことを告知するために、ページ本文冒頭に貼り付けるテンプレートです。主に次のような場合に使用します。
* ノートや別ページに質問・提案・議論の投稿をしたが、しばらくしても反応がないとき
* ノートや別ページに投稿した質問・提案・議論に対して、進展を促したいとき
* ノートや別ページでの議論が停滞しているとき

=== 作成の経緯・特徴 ===
これまで&#123;&#123;[[Template:SeeTalk|SeeTalk]]&#125;&#125;や&#123;&#123;[[Template:お知らせ|お知らせ]]&#125;&#125;が使用されてきましたが、この2つのテンプレートの機能を併せ持ったテンプレートがこの'''&#123;&#123;告知&#125;&#125;'''となります。今後はこのテンプレートを使用してください。

このテンプレートの最大の特徴は、これまでの「対象ページがノートなら&#123;&#123;SeeTalk&#125;&#125;、別ページなら&#123;&#123;お知らせ&#125;&#125;」という使い分けの必要がなくなることです。もちろん、テンプレート引数指定もこれまでの流れを受けてシンプルなものとしています。詳しくは以下を参照してください。

== 使い方と例 ==
ページ本文冒頭に <code>&#123;&#123;告知&#125;&#125;</code> と記述します。

=== 簡単な方法 ===
 <code><nowiki>{{告知|1.タイプ（質問や議論 等）|2.要約|3.リンク先|4.リンク先の対象節}}</nowiki></code>
; 例1：ノートページに提案がある場合
 <code><nowiki>{{告知|提案|カテゴリを変更してはどうか}}</nowiki></code>
と記入すると、以下のようになります。
{{告知|提案|カテゴリを変更してはどうか}}
; 例2：[[Wikipedia:井戸端]]に議論がある場合
 <code><nowiki>{{告知|議論|テンプレート一覧ページの整理方法|Wikipedia:井戸端}}</nowiki></code>
と記入すると、以下のようになります。
{{告知|議論|テンプレート一覧ページの整理方法|Wikipedia:井戸端}}

=== 変数 ===
==== 標準機能 ====
以下のように「数字」と「英字」で変数を指定しているためどちらも使用可能です（日本語の変数は指定していません）。但し、数字の方が優先されます。

いずれの引数指定も省略可能です。
; タイプ
: <code>1</code> - <code>notice-type</code> （デフォルト値は「質問」。「質問」「提案」「議論」はデフォルト画像がそれぞれ設定されています。）
; 要約
: <code>2</code> - <code>notice-summary</code>
; リンク先
: <code>3</code> - <code>page</code> （記入しない場合はノートとなります。存在しないページを指定した場合は注意文が表示されます。）
; リンク先の対象節
: <code>4</code> - <code>section</code>

==== 拡張機能 ====
; page-name
: リンク先のページ名の表示を指定します。
; （ソートキー）
: （カテゴライズの際のソートキーを指定します。）<br />'''カテゴライズについては現在議論中です。'''
; situation
: 「この○○」の「○○」を指定します。デフォルト値は「ページ」です。
; level
: 「注目度」の意味で、1〜3の数字で指定します。数字が大きくなるほど背景色が濃くなっていきます。Lv.1が「#ffffff（白）」、Lv.2が「<span style="background: #eeeeff;">#eeeeff</span>」、Lv.3が「<span style="background: #ccccff;">#ccccff</span>」となっています。1〜3以外を指定した場合はLv.1となります。
; width
: テンプレートの幅を指定します。デフォルト値は「90%」です。
; background-color
: テンプレートの背景色を指定します。デフォルト値は「#ffffff（白）」で、この変数を指定すると「level」は無視されます。
; border-color
: 外枠の色を指定します。デフォルト値は「<span style="background: #6699cc;">#6699cc</span>」です。
; image
: 左側の画像を指定したいときに使います。
; image-size
: 左側の画像のサイズを指定したいときに使います。

== ヒントと注意 ==
* 告知をしたい投稿が複数ある場合は、<code>section</code> を使わずに <code>notice-summary</code> で直接それらの節への内部リンクを貼ることで対処できます。
* 表示する画像として使えるアイコンが[[commons:Category:Icons]]にあります。
* '''告知内容によっては、より適切なテンプレートがあります。'''その場合はそちらを使用するようにしてください。詳しくは[[:Wikipedia:Template メッセージの一覧]]をご覧ください。
* '''質問や提案が解決したら、速やかに外してください。'''

== 関連テンプレート ==
* <code>&#123;&#123;[[Template:注意|注意]]&#125;&#125;</code> - 注意を促す専用のテンプレート
* <code>&#123;&#123;[[Template:Notice|Notice]]&#125;&#125;</code> - ノートを参照する必要がないとき
* 旧テンプレート
** <code>&#123;&#123;[[Template:SeeTalk|SeeTalk]]&#125;&#125;</code>
** <code>&#123;&#123;[[Template:お知らせ|お知らせ]]&#125;&#125;</code>

<includeonly>
[[Category:お知らせテンプレート|* 告知]]
</includeonly>