テンプレート:Pp-meta/docのソースを表示

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}
{{翻訳中途|1=[http://en.wikipedia.org/w/index.php?title=Template:Pp-meta/doc&oldid=274979637 英語版 "Template:Pp-meta/doc" 18:47, 4 March 2009 (UTC)]|date=2012年4月}}</noinclude>
<includeonly>{{複雑なテンプレート}}</includeonly>
この{{Tl|Pp-meta}} は[[Wikipedia:Template メッセージの一覧/メンテナンス|保護用のお知らせボックス]]を作成するためのメタテンプレートです。

このメタテンプレートは名前空間に応じて自動的に適切な書式を選択します。また、小さな南京錠アイコンをページ右上に表示するだけの縮小版にも対応しています。
__TOC__

== 例==
このページの右上にある南京錠アイコンもこのメタテンプレートで作成している例です。このテンプレートで指定している場所は、「秀逸な記事」用の星印アイコンなどと衝突しないように設計されています。

<!--右上南京錠アイコンを表示させるタグ-->
<includeonly>{{Pp-template|demolevel=full|categories=no|small=yes}}</includeonly>

=== 通常名前空間 ===
{{Pp-meta|demospace=main|demolevel=sysop|categories=no|reason=<保護の理由>}}

=== ノートページ ===
{{Pp-meta|demospace=talk|demolevel=sysop|categories=no|small=no|reason=<保護の理由>}}

=== その他の名前空間===
{{Pp-meta|demospace=other|demolevel=sysop|categories=no|reason=<保護の理由>}}

== 使い方 ==
<pre><nowiki>
{{Pp-meta
| type = <保護の種類に応じて"full", "semi", "indef", "semiindef", "move", "create", "office" のいずれかを選択>
| disallowlevel = < move または create 以外の種類で、特定の保護レベルでのみ使用されるテンプレートであれば "autoconfirmed" または "sysop" を指定>
| small = {{{small|}}} <常に縮小版を使う場合は "yes"、どんなときも縮小させないのであれば  "no" または空に>
| expiry = {{{expiry|}}} <無期限用テンプレートでは空に>
| reason = &amp;#32;<保護の理由>
| xfd = <タイプが "create" の場合 "{{{xfd|}}}"、それ以外では空に>
| demospace = {{{demospace|}}} <決まった名前空間で使うのでなければこのように。もし決まった名前空間で使うのならば、その名前空間を "main", "talk", または "other" に設定>
| demolevel = {{{demolevel|undefined}}} <ここを変更すると保護レベルのチェックが機能しなくなります>
| image = <画像を名前空間用プレフィクスなしで指定>
| icon-link = <アイコンからリンクするページを [[]] なしで指定>
| icon-text = <アイコンの代替文を変更する場合、その代替文を句読点付きで。プレインテキストで指定のこと。>
| icon-reason = <句読点なしの理由。プレインテイストのみ。>
| reason-text = <理由全文。句読点と内部リンクは可能だが、文字装飾はしないこと>
| explanation-text = <説明全文>
| categories = {{{categories|<テンプレートを添付したページを入れるカテゴリがあれば指定、無ければ "no">}}}
}}
</nowiki></pre>

== 引数 ==
This template is designed to be both defining of the major types of protection notice, but flexible enough to allow exceptions. All parameters have some fallback to allow for [[フォールトトレラントシステム|graceful failure]], but some should almost always be applied.

===通常は必須の引数===
;<code>type</code>:The '''type''' parameter applies most default settings for the broad classes of protection templates. It can have values equal to any of the following: <code>full</code>, <code>semi</code>, <code>indef</code>, <code>semiindef</code>, <code>move</code>, <code>create</code>, and <code>office</code> (all case-insensitive). These values apply default boilerplate text, images, and links. This parameter should almost always be used, as the default settings require little other input, making the code of templates such as <span style="font-family:monospace;"><nowiki>{{</nowiki>[[Template:Pp-semi-protected|pp-semi-protected]]<nowiki>}}</nowiki></span> very clean. Note that not supplying this parameter causes the image to default to [[:Image:Transparent.gif]].
;<code>small</code>: The '''small''' parameter lets the template decide whether to display a small icon version or a large boilerplate version. It can take any value, but the only one which will be acted on is "<code>yes</code>" (case-insensitive). As instance templates should be able to decide, using their input, whether or not to apply <code>small</code>, this should usually be set to <code><nowiki>{{{small|}}}</nowiki></code>, which defaults to non-small but allows small to be specified. Not supplying this parameter will cause the template to always be expanded big.
;<code>expiry</code>: This '''expiry''' parameter allows, when <code>type</code> is defined normally, the expiry date to be automatically displayed properly for both the tooltip of the small version and in text for the large version. It should typically take the input <code><nowiki>{{{expiry|}}}</nowiki></code>, which allows instances using this template to be provided input specifying the expiry date. It should be left blank for templates where <code>type</code> is set to <code>indef</code>, as it has no effect because indefinite protection templates clearly do not need expiry dates to be specified.
;<code>dispute</code>:The '''dispute''' parameter adds some boilerplate text disclaiming against endorsement of the protected version or title. It is not dependent on the <code>type</code> parameter, but the <code>explanation-text</code> parameter described below overrides it when applicable.
;<code>reason</code>:The '''reason''' parameter allows a particular reason to be applied to the template to explain why the page is protected. The code used in this parameter should be prefixed with <code>&amp;#32;</code> so that there are proper spaces between words as <code><nowiki>{{{reason|}}}</nowiki></code> in the code is not prefixed with a space, such that the requisite full stop is not prefixed by a space when <code>reason</code> is null. Instances which want to pass through the reason should use code along the general lines of <code><nowiki>{{{reason|a default reason}}}</nowiki></code>.
;<code>categories</code>: The '''categories''' parameter is relatively strict in the input form instances of this template should use: if the template has categories that it should apply to pages upon which it is placed, they should be implemented within the container of <code><nowiki>{{{categories|</nowiki></code> and <code><nowiki>}}}</nowiki></code>, which will cause categories to be disabled in the instances if they are given <code>|categories=no</code> as an argument. If the template applies no categories, there is no use for this parameter.
;<code>demospace</code>: Although the '''demospace''' parameter is primarily useful for testing purposes, its name betrays its purpose: demonstration. Instances should generally use the code <code>demospace=<nowiki>{{{demospace|}}}</nowiki></code> so as to allow them to be forced to display as though they were in a particular namespace. If a template is to be always used in a particular namespace and never in another, it is also possible to set <code>demospace</code> to any of <code>main</code>, <code>talk</code>, or <code>other</code> (all case-insensitive) to specify the messagebox type typical for that namespace or namespace family such that it will never change from that type.
;<code>demolevel</code>: The '''demolevel''' parameter, like the <code>demospace</code> parameter, is useful for demonstration and testing. Instances should generally use the code <code>demospace=<nowiki>{{{demolevel|undefined}}}</nowiki></code> so as to allow them to be forced to display as though they were on a page with a particular level of protection. This must have the default of "undefined" if it is used, as a null value will cause the template to fail. Failing the demolevel test causes the template to disappear and the page to be placed into [[:Category:不適切な保護テンプレートのあるページ]].

===タイプによって使用する引数===
;<code>xfd</code>: If the <code>type</code> applied is <code>create</code>, and <code>explanation-text</code> as below does not over-ride it, then the parameter '''xfd''' should be applied as equal to <code><nowiki>{{{xfd|}}}</nowiki></code> so that this input is passed through and the explanation can be more descriptive.

===任意===
;<code>image</code>:The '''image''' parameter allows an alternate icon to be chosen if so desired. This image should typically be chosen from [[Commons:Padlock icons]], though any image can be chosen. Only the name of the alternate image should be applied; ''do not'' supply the "Image:" prefix.
;<code>icon-link</code>:The '''icon-link''' parameter allows one to change the page to which the small version's icon links. This probably shouldn't generally be used if <code>type</code> is in use as <code>type</code> applies proper links to [[Wikipedia:保護の方針]], but it allows for exceptions and can define the link to sections within that page. Input given to this parameter should ''not'' be supplied within <nowiki>[[double brackets]]</nowiki>.
;<code>icon-text</code>: The '''icon-text''' parameter, like the <code>icon-link</code> parameter, affects only the small version. This one, however, affects the text outputted as the tooltip for the protection icon. It completely replaces, when used, the default text and any specified by <code>type</code>, ''including'' the final full stop.
;<code>icon-reason</code>: The '''icon-reason''' parameter allows text to be added to the default text of the small version's tooltip as supplied by <code>type</code>. It is over-written by <code>icon-text</code> if that parameter is used.
;<code>reason-text</code>: This parameter, '''reason-text''', allows one to over-ride the first, bolded line of the text of the expanded version of any instance. It, when used, over-rides input as initially defined by <code>type</code>, <code>expiry</code>, and <code>reason</code>, ''including'' the final full stop.
;<code>explanation-text</code>:This code over-rides the explanation text following the bolded reason line; it over-rides text initially provided by the template itself, <code>type</code>, <code>dispute</code>, and, if applicable, <code>xfd</code>.
;<code>disallowlevel</code>:This code disallows a particular level of protection for templates which do not have the type <code>move</code> or <code>create</code>. It can be set to either <code>autoconfirmed</code> or <code>sysop</code> to disable the template on semi-protected or full-protected pages respectively. If the page is protected at the disallowed level and <code>demolevel</code> is not set to the allowed level, the template will not appear and the page will be placed into [[:Category:不適切な保護テンプレートのあるページ]].

===引数一覧===

<pre><nowiki>
{{pp-meta
| type =
| disallowlevel =
| small =
| expiry =
| reason =
| xfd =
| demospace =
| demolevel =
| image =
| icon-link =
| icon-text =
| icon-reason =
| reason-text =
| explanation-text =
| categories =
}}
</nowiki></pre>

== 関連項目 ==
*  [[Wikipedia:Template メッセージの一覧/メンテナンス]]
{{protection templates}}

<includeonly>{{sandbox other||
<!-- カテゴリは以下に追加してください -->
[[Category:タイトル表示テンプレート]]
[[Category:メタテンプレート]]
[[Category:保護テンプレート|旧Pp-meta]]
}}</includeonly>