Help:テンプレート

	このページ『テンプレート』の初版（ページ名が変更されている場合は変更前の初版）はMediawikiのPDヘルプから作成されたものであり、このページの初版はパブリックドメインにあるものとします。ただし、以後の改変がある場合、この文書はクリエイティブ・コモンズ 表示 - 非営利 - 改変禁止 3.0 非移植 ライセンスが適用されます。また、このページの内容はにくけっとデータベースに合わせて改変された部分があるため、必ずしもMediawiki一般に対するヘルプでないことに留意してください。
※このテンプレートは著作権に関係するテンプレートです。正当な理由なく除去しないでください。

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

テンプレートを作成する

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

テンプレートを使用する

テンプレートは他のページで使うことが出来るwikiページで、次のような3つの方法があります:

• {{Name}}はそれを含むページが"[[Template:Name]]"を取得した瞬間にテンプレートの内容を含みます。
• {{subst:Name}}はテンプレートの内容をテキストを保存したときに通常は編集可能である"[[Template:Name]]"の形式でページのコードに追加します。
• {{msgnw:Name}}　それを含むページが取得されたとき、<nowiki>がするように、生のwiki構文として表示する形式でテンプレートを含みます。

テンプレートでパラメータを使用する

数値のパラメータ付きのテンプレート
'''A little thank you...'''<br> <small>for {{{1}}}.<br> hugs, {{{2}}}</small>
入力するもの	出力されるもの
{{Thankyou|all|Joe}}	A little thank you... for all. hugs, Joe
with named parameters
'''A little thank you...'''<br> <small>for {{{reason}}}.<br> hugs, {{{signature}}}</small>
You type	You get
{{Thankyou |reason=all |signature=Joe}}	A little thank you... for all. hugs, Joe

テンプレートでのパラメータを{{{1}}}という数字もしくは{{{param}}}という名前として定義することが出来ます。

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

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

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

テンプレートインクルージョンをコントロールする

<noinclude>と<includeonly>タグを使用することでテンプレートインクルージョンを管理することが出来ます。

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

実行できる応用例は次の通りです:

• テンプレートのカテゴリ化
• 他の言語での類似テンプレートへのインターランゲージリンク
• テンプレートを使用する方法の説明文

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

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

テンプレートの組織化

テンプレートを効率的にするために、ユーザがそれらを見つけ利用できることが必要です。シンプルなテクニックはテンプレートページ上に例を含めることです。 例です:

<noinclude>
==使い方==
サブジェクトへのリンクを確立することを許可します:
{{NameOfTemplate|Term1+Term2+Term3}}
</noinclude>

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

関連項目

• Help:外部検索 -- テンプレートの特別な使用例です
• Help:変数 -- テンプレートの中で手の込んだものがあります
• meta:Help:Embed page -- Template:よりも名前空間からページを埋め込みます。

	《ヘルプ関連ページ》 【目次】ヘルプ目次 【閲覧】ナビゲーション/検索/変更の確認/ウォッチリスト 【基礎編集】ページの編集/新規ページの作成/フォーマット/リンク/利用者ページ/会話ページ/署名 【編集】画像/表/カテゴリ/サブページ/ファイルの管理/ページの移動/リダイレクト/ページの削除/保護されたページ/テンプレート/名前空間/マジックワード/特別ページ/外部検索/ボット 【個人設定】個人設定/スキン 【管理】管理者と権限/ページの保護と解除/管理者による削除と復帰/パトロール/利用者のブロック/IP広域ブロック/権限の付与
このテンプレートはヘルプナビゲーション用のテンプレートです。