Help:Templates/ja

[[Category:ヘルプ|{{BASEPAGENAME}}]]
いくつかのページに含めたい標準的なテキストがある場合、MediaWikiの'''テンプレート機能'''が役に立ちます(上記のようなタグはHelp名前空間のページに含まれています)。

{{H2|テンプレートを作成する}}
テンプレート名の接頭辞は<code>Template:</code>で、他のwikiページと同じように作成することが出来ます。

{{H2|テンプレートを使用する}}
テンプレートは他のページで使うことが出来るwikiページで、次のような3つの方法があります:
* <code><nowiki>{{Name}}</nowiki></code>はそれを含むページが<nowiki>"[[Template:Name]]"</nowiki>を取得した瞬間にテンプレートの内容を含みます。
* <code><nowiki>{{subst:Name}}</nowiki></code>はテンプレートの内容をテキストを保存したときに通常は編集可能である<nowiki>"[[Template:Name]]"</nowiki>の形式でページのコードに追加します。
* <code><nowiki>{{msgnw:Name}}</nowiki></code>　それを含むページが取得されたとき、<code><nowiki>&lt;nowiki&gt;</nowiki></code>がするように、生のwiki構文として表示する形式でテンプレートを含みます。

{{H2|テンプレートでパラメータを使用する}}
<div style="float:right; margin:8px;">
{| {{Prettytable}} 
|-
|{{Hl2}} colspan="2" align="center" |'''数値のパラメータ付きのテンプレート'''	
|-
| colspan="2" |
<pre><nowiki> 
'''A little thank you...'''<br>
<small>for {{{1}}}.<br>
hugs, {{{2}}}</small>
</nowiki></pre> 
|-
|{{Hl2}}|'''入力するもの'''	
|{{Hl2}}|'''出力されるもの'''
|-
|<code><nowiki>{{Thankyou|all|Joe}}</nowiki></code>
|
{{Thankyou|all|Joe}}
|-
|{{Hl2}} colspan="2" align="center" |'''with named parameters'''	
|-
| colspan="2" |
<pre><nowiki> 
'''A little thank you...'''<br>
<small>for {{{reason}}}.<br>
hugs, {{{signature}}}</small>
</nowiki></pre> 
|-
|{{Hl2}}|'''You type'''	
|{{Hl2}}|'''You get'''
|-
|<pre><nowiki>{{Thankyou
|reason=all
|signature=Joe}}</nowiki></pre>
|
{{Thankyou|all|Joe}}
|}
</div>
テンプレートでのパラメータを<code><nowiki>{{{1}}}</nowiki></code>という数字もしくは<code><nowiki>{{{param}}}</nowiki></code>という名前として定義することが出来ます。

'''例:''' 他のユーザのトークページ上で設置できるlittle thank you note(ありがとうノート)が欲しいとします。理由と署名が含まれます。あなたのテキストを入力するために、テーブルの例のような[[Template:Thankyou]]を作成することが出来ます。

ページ上でテンプレートを使用する場合、パイプ文字(|)で分割されたパラメータの値を入力します: <code><nowiki>{{Thankyou|all|Joe}}</nowiki></code>。名前のあるパラメータのためにパイプ文字で分割された"name=value"を使用します: <code><nowiki>{{Thankyou|reason=all|signature=Joe}}</nowiki></code>。テンプレートで名前のあるパラメータを使う利点は順序における柔軟性です。それによって多くのパラメータがある場合、テンプレートを理解することを容易にもします。数字のパラメータの順番を変更したい場合、明確に示さなければなりません: <code><nowiki>{{Thankyou|2=Joe|1=all}}</nowiki></code>。

パラメータのためにデフォルトの値、すなわち、値がパラメータのために提供されたなかった場合に使用される値を提供することが出来ます。例えば、<code><nowiki>{{{reason|all}}}</nowiki></code>は<tt>reason</tt>パラメータのために値が提供されなかった場合、''"all"''を返します。

{{H2|テンプレートインクルージョンをコントロールする}}
<code><nowiki><noinclude></nowiki></code>と<code><nowiki><includeonly></nowiki></code>タグを使用することでテンプレートインクルージョンを管理することが出来ます。

<code><nowiki><noinclude></nowiki></code>と<code><nowiki></noinclude></nowiki></code>の間にあるものはページが直接閲覧されるときのみ表示され、インクルードされる場合は表示されません。

実行できる応用例は次の通りです:
* テンプレートのカテゴリ化
* 他の言語での似たようなインターランゲージリンク
* テンプレートを使用する方法の説明文

逆は<code><nowiki><includeonly></nowiki></code>.です。<code><nowiki><includeonly></nowiki></code>と<code><nowiki></includeonly></nowiki></code>の間のテキストはページがインクルードされたときのみ処理され表示されます。明確な応用例は与えられたテンプレートを含むすべてのページをカテゴリに追加することです。

通常の更新問題があてはまります -- 一つのテンプレート内部の複数のカテゴリを変更した場合、参照ページのカテゴリはこれらのページが編集されるまで更新されないことに気を付けて下さい。

{{H2|テンプレートの組織化}}
テンプレートを効率的にするために、ユーザがそれらを見つけ利用できることが必要です。シンプルなテクニックはテンプレートページ上に例を含めることです。
例です:
<div style="display:table; width:auto;"><pre>
<noinclude>
{{H2|使い方}}
サブジェクトへのリンクを確立することを許可します:
{{NameOfTemplate|Term1+Term2+Term3}}
</noinclude>
</pre></div>

それから編集者は同じようなページを作成するために例をコピー＆ペーストします。

{{H2|関連項目}}
*[[Help:External searches/ja]] -- テンプレートの特別な使用例です
*[[Help:Variables/ja]] -- テンプレートの中で手の込んだものがあります
*[[meta:Help:Embed page]] -- <code>Template:</code>よりも[[Manual:Namespace/ja|名前空間]]からページを埋め込みます。