テンプレート:Nosubst
テンプレートの解説この解説はテンプレート:Nosubst/docから読み込まれています。(編 | 歴)
編集する方へ: テンプレート本体をカテゴリに入れず、代わりに解説ページの
編集する方へ: テンプレート本体をカテゴリに入れず、代わりに解説ページの
<includeonly></includeonly>内に記述してください。これはメタテンプレートです。記事中から直接呼び出すためのテンプレートではありません。
テンプレート中で、subst展開の結果にテンプレート呼び出しのウィキマークアップを含めるために使います。subst展開を想定していないテンプレートでは使う意味がありません。
使い方
編集典型的な使いかたは次のようなものです。
{{ {{{|safesubst:}}}#if:条件
| 条件が成立したときに展開結果に含めるウィキテキスト
| {{ {{{|subst:}}}nosubst|テンプレート名|引数1|引数2|... }}
}}
このマークアップでは、条件が成立しないとき、当テンプレートが呼び出されます。その結果はつぎのものになります。
{{テンプレート名|引数1|引数2|... }}
つまり、展開結果は「テンプレート名」という名のテンプレートの呼び出しになりますが、このテンプレート呼び出しそのものは展開されません。これを利用して、subst展開しても展開されないテンプレートや、ほかのテンプレート呼び出しに置き換えられるテンプレートを作ることができます。
subst展開しても展開されないテンプレートを作るのは、{{ifsubst}}と組み合わせると簡単です。
{{ {{{|safesubst:}}}ifsubst
| {{ {{{|subst:}}}nosubst|テンプレート名|{{{1|}}}|{{{2|}}}|... }}
| ここにテンプレートの実際の内容を書く
}}
「テンプレートの引数」は8つまで指定できます。
制限事項
編集- 引数に指定したものはそれぞれ展開されてしまいます。
- 名前つき引数には、現在のところ対応していません。
関連テンプレート
編集- {{subst!}}、{{require subst}} - subst展開しないとエラーを表示。
- {{subst only}} これらを使ったテンプレートの説明文において使用。常にsubst展開することを注意喚起する。
- {{issubst}} - subst展開をすると"yes"を返す。
- {{ifsubst}} - subst展開の有無を判定。
- {{nosubst}} - subst展開されるテンプレートの中で、subst展開されないテンプレートの呼び出しを作る。