テンプレート:Nosubst/doc

これはテンプレート:Nosubstの解説サブページです。
使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。

これはメタテンプレートです。記事中から直接呼び出すためのテンプレートではありません。

テンプレート中で、subst展開の結果にテンプレート呼び出しのウィキマークアップを含めるために使います。subst展開を想定していないテンプレートでは使う意味がありません。

使い方

典型的な使いかたは次のようなものです。

{{ {{{|safesubst:}}}#if:条件
  | 条件が成立したときに展開結果に含めるウィキテキスト
  | {{ {{{|subst:}}}nosubst|テンプレート名|引数1|引数2|... }}
}}

このマークアップでは、条件が成立しないとき、当テンプレートが呼び出されます。その結果はつぎのものになります。

  {{テンプレート名|引数1|引数2|... }}

つまり、展開結果は「テンプレート名」という名のテンプレートの呼び出しになりますが、このテンプレート呼び出しそのものは展開されません。これを利用して、subst展開しても展開されないテンプレートや、ほかのテンプレート呼び出しに置き換えられるテンプレートを作ることができます。

subst展開しても展開されないテンプレートを作るのは、{{ifsubst}}と組み合わせると簡単です。

{{ {{{|safesubst:}}}ifsubst
  | {{ {{{|subst:}}}nosubst|テンプレート名|{{{1|}}}|{{{2|}}}|... }}
  | ここにテンプレートの実際の内容を書く
}}

「テンプレートの引数」は8つまで指定できます。