![]() | このテンプレートは13,000以上のページで使われています。 余計な混乱やサーバーへの負荷を避けるために、どんな変更でも最初はテンプレートのサンドボックス・サブページ、テストケース・サブページもしくはあなた自身の利用者スペースのページで試すべきです。そうすれば、試した変更を1度の編集でこのテンプレートに加えることができます。しかし、最初にあなたの提案した変更を、この項目のノートで議論するようにお願いします。 |
![]() | Luaモジュールを使用しています: |
このテンプレートは今ここに表示されているような解説を、他のページから自動的に呼び出して表示します。このテンプレートは他のページに呼び出されるようなページに解説を加えることに使われ、おもにテンプレートでの使用を想定していますが名前空間によって制限されているわけではありません。
あなたがこのテンプレートを使用しようとしているページが「Template:テンプレート名例示用」だとすると「Template:テンプレート名例示用/doc」に解説を書いて保存し、「Template:テンプレート名例示用」に次のコードを付け足してください。
<noinclude>{{Documentation}}</noinclude>
解説が保存されているページが「Template:any page/doc」である場合、次のコードを「Template:テンプレート名例示用」に付け足してください。
<noinclude>{{Documentation|Template:any page/doc}}</noinclude>
解説を別のページに保存せず、次のように「Template:テンプレート名例示用」に直接書き込むこともできます。
<noinclude>{{Documentation|content=This is documentation.}}</noinclude>
「Template:テンプレート名例示用/doc」が存在する場合は、そちらも同時に表示されます。
次のように書き込めば、ヘッドライン(冒頭表示)を変更できます。
<noinclude>{{Documentation|heading=変更したヘッドライン}}</noinclude>
もし次のように heading 引数を空にすれば、ヘッドラインは表示されません。
<noinclude>{{Documentation|heading=}}</noinclude>
これらのコードは<noinclude>の前に余分な空白をつけずに、テンプレートやその他の解説を呼び出したいページに付け加えてください。もし、解説・説明文書のページが<includeonly>や<noinclude>といったタグを解説の一部として含むならば「<」を「<」で置き換えてください。
もし解説のページが存在しなければ、[編集]リンクはTemplate:Documentation/preloadから解説の雛形ファイルをプリロードします。
プリロードするファイルは、preload 引数で変更できます。
このテンプレートはサンドボックスとテストケースの存在を確認し、存在していればそのことを存在していなくてもそのことを通知しサンドボックスとテストケースの使用に誘導します。
この機能は、sandbox-testcases引数に「show」以外を指定することによってキャンセルできます。
このテンプレートを使用しているテンプレートが保護されていれば、そのテンプレートのページに{{pp-template}}に相当するインジケーターアイコンを表示し、さらにCategory:編集保護中のテンプレートやCategory:編集半保護中のテンプレートなどのカテゴリを付与します。
したがって本テンプレートを使用しているのであれば、テンプレートを保護しても手動で{{pp-template}}を追加する必要はありません。荒らし行為や編集合戦などを理由に一時的に保護する場合、テンプレートのページにおいて{{Documentation}}
より後ろに{{pp-vandalism|small=yes}}
のようなテンプレート呼び出しを挿入することで、インジケーターアイコンを上書きすることができます。
引数 | 指定内容 | 既定値 | 説明 |
---|---|---|---|
1 | ページ名 | {{Documentation/docname}} | 解説として読み込むページ名。 |
content | 任意の文章 | {{{{{1}}}}} | 解説として表示する文章。 |
heading | 任意の文字列 | 解説 | ヘッドラインとして表示する文字列。 |
heading-style | CSS書式 | font-size:150% | ヘッドラインのスタイル。 |
heading-padding | 単位つき数値(CSS書式) | 3px | ヘッドラインのパディング。 |
heading-margin | 単位つき数値(CSS書式) | 1ex | ヘッドラインのマージン。 |
transcluded | 任意の文字列 | show | 「show」以外を指定すると、読込先を表示しない。 |
sandbox-testcases | 任意の文字列 | show | 「show」以外を指定すると、サンドボックスとテストケースの存否を表示しない。 |
preload | ページ名 | Template:Documentation/preload | 解説のページが存在しない場合にプレロードする雛形ファイル。 |
このテンプレートが使用されているページが保護されている場合はCategory:編集保護中のテンプレートやCategory:編集半保護中のテンプレートなどのカテゴリを付与します。