「Help:テンプレート早わかり」の版間の差分
削除された内容 追加された内容
Template:fooが編集(作成)されていたのでnowiki化 |
AE-SkyLiner (会話 | 投稿記録) |
||
(23人の利用者による、間の32版が非表示) | |||
1行目:
{{
▲このページは、'''テンプレートの概要'''を簡単に説明しています。詳細については[[Help:テンプレート]]を参照してください。
テンプレートとは他のページから読み込んで使う定型文の枠組みのことです。ウィキペディアではしばしば「テンプレ」とも呼ばれます。<code><nowiki>[[Template:</nowiki>テンプレート名<nowiki>]]</nowiki></code>のように、通常は「Template[[Help:名前空間|名前空間]]」にあるページです。編集時に <code><nowiki>{{</nowiki>テンプレート名<nowiki>}}</nowiki></code> と書き込むことでテンプレートの中身の文章を挿入することができます。テンプレートも通常の記事と同じように作成・編集できます。プログラミング言語を使うことで定型文に部分的な変更を行ったりできますが、高度なものとなります。
== テンプレートの仕組み ==
テンプレートとは
[[Image:Transclusion-multiple-foo.
例えば上図では、ページ「A」、「P」、「Q」に <code><nowiki>{{B}}</nowiki></code> と書き込んでテンプレート「B」を呼び出しています。これで、ページ「A」、「P」、「Q」では、いつでもテンプレートページ「B」の内容である “foo” が表示されます。
[[Image:Transclusion-multiple-twit.
テンプレート「B」の内容を “twit” に変更すると、ページ「A」、「P」、「Q」すべてで <code><nowiki>{{B}}</nowiki></code> の部分が自動的に “twit” に更新されます。このようにすることで、多くのページで共通に表示する内容を簡単な作業で一挙に更新することができます。
=== subst展開 ===
テンプレートを使いたいページに、 <code><nowiki>{{</nowiki>subst:テンプレート名<nowiki>}}</nowiki></code> と書きこむこともできます。このようなやり方でテンプレートを埋め込むことを '''subst 展開'''(サブスト展開)や、substitution (サブスティテューション)といいます。こうすると、ページを保存した時に、テンプレートタグの文字列のあった部分にその時点でのテンプレートの中身が代入されます([[代入]]のことを英語で substitution といいます)。 例えば、ページ「S」に中身が “foo” であるテンプレート「B」を subst 展開したとしましょう。ページ「S」の保存時には、 <code><nowiki>{{subst:B}}</nowiki></code> の部分がそっくり <code>foo</code> に置き換わり、その後にテンプレート「B」の中身を "twit" に更新しても、ページ「S」の内容は'''更新されません'''。意図的にこのようにしたい場合もあるでしょう。▼
[[Image:TC-subst.PNG|frame|left|テンプレートsubst展開の概念図]][[Image:TC-subst-twit.PNG|left|frame|テンプレートsubst展開の概念図2]]
▲テンプレートを使いたいページに、 <code><nowiki>{{</nowiki>subst:テンプレート名<nowiki>}}</nowiki></code> と書きこむこともできます。このようなやり方でテンプレートを埋め込むことを '''subst 展開'''(サブスト展開)や、substitution (サブスティテューション)といいます。こうすると、ページを保存した時に、テンプレートタグの文字列のあった部分にその時点でのテンプレートの中身が代入されます([[変数 (プログラミング)|代入]]のことを英語で substitution といいます)
例えば、ページ「S」に中身が “foo” であるテンプレート「B」を subst 展開したとしましょう。ページ「S」の保存時には、 <code><nowiki>{{subst:B}}</nowiki></code> の部分がそっくり <code>foo</code> に置き換わり、その後にテンプレート「B」の中身を "twit" に更新しても、ページ「S」の内容は'''更新されません'''。
なお、<tt>“Template:”</tt> ではじまっていない他の名前空間のページも、テンプレート呼び出しや subst 展開することができます(これについては[[Help:テンプレート#Template名前空間以外のページの呼び出し方]]参照)。▼
subst展開は一般に、署名や依頼時に書式を一定にするために使われるテンプレートなど、保存時点での情報を固定する必要がある時に用いられます。
{{-}}
▲なお、
== テンプレートの編集・作成 ==
編集したいテンプレートが、例えば <code><nowiki>{{foo}}</nowiki></code> のようにページ内に書きこまれていたら、<nowiki> [[Template:foo]] </nowiki>に
# 使われているページの編集画面を開き、その状態でページの一番下にリストされている「このページで使われているテンプレート:」のリンクを利用する。
# テンプレート名を[[Help:検索|
# <code><nowiki>
目的のテンプレートページに
テンプレートを新しく作る場合も、通常の[[Help:新規ページの作成|新規ページの作成]]と同じです。ただ、ページ名の最初に <code>Template:</code> をつけるだけです。 <code>Template:</code> のあとにつけた[[Help:ページ名|ページ名]]がテンプレート名となります。
== よくある質問 (FAQ) ==
; テンプレートにはどのようなものがありますか?
; あるテンプレートを複数のプロジェクトで使用できますか? : できません。例えば、あるテンプレートを2つの異なる言語のウィキペディアで使いたい場合は、それを2度作成する必要があります。▼
: [[Wikipedia:Template メッセージの一覧]]や[[:Category:ウィキペディアのテンプレート]]を参照してください。
; テンプレート名では大文字と小文字が区別されますか? : 区別されます。ただし、通常最初の文字は区別されません。[[Help:ページ名]]を参照してください。▼
; あるテンプレートを複数のプロジェクトで使用できますか?
; パラメータ(引数)は使えますか? : 使えます。詳しくは[[Help:テンプレート]]を見てください。▼
▲
; 1ページの中にいくつテンプレートを使えますか? : いくつという制限はありません(古いバージョンでは同じテンプレートは、5回までしか使えませんでした)。ただし呼び出すデータ量が多すぎるとそれ以上は呼び出せません。詳しくは[[Help:テンプレートの制限]]を参照してください。▼
; テンプレート名では大文字と小文字が区別されますか?
; テンプレートの編集をしましたが、それを使ったページに反映されないのは何故ですか? : キャッシュが残っているためです。テンプレートを呼び出しているページの編集画面を開き、何も変更を加えずに保存すると、強制的にキャッシュをクリアできます(ページの履歴には残らないので、要約欄は記入不要です)。または、Ctrl + F5 を押して更新するとたいてい直ります。または、URLに <code>&action=purge</code> を加えてもいいでしょう(例: <code><nowiki>http://ja.wikipedia.org/w/index.php?title=Template:Foo&action=purge </nowiki></code>)。▼
; テンプレートの名前を変えることはできますか? : できます。通常ページでの[[Help:ページの移動|ページの移動]]と全く同じ方法でできます。ページに呼び出されているテンプレートがリダイレクトの場合、リダイレクト先が呼び出されます。▼
;
; テンプレートで使われるプログラミング言語のマニュアルはどこにありますか?: テンプレートで使われている言語は、他のウィキマークアップと同じ言語ですが、テンプレートではより複雑な条件文などを使っていることがよくあります。詳しくは[[Help:条件文]]や、高度な編集についてのヘルプページを見てください。▼
; テスト用に使えるテンプレートはありますか?
: あります。{{Tl|テスト}}、{{Tl|X1}}、{{Tl|X2}}です。
; 1ページの中にいくつテンプレートを使えますか?
▲
; 半角コロン ({{:}}) や半角イコール (=) を含む文字列を値として入力したいのですが、うまく表示されません。
: それぞれウィキテキストの箇条書きの説明文としてのコロン([[Help:箇条書き]])や、変数名指定用のイコールと判定されてしまっています。半角コロンに関してはテンプレートの方の「<nowiki>{{{変数名}}}</nowiki>」を「<nowiki>{{replace|{{{変数名}}}|:|&#58;}}</nowiki>」に書き換えることで、コロンを純粋なテキストに変換することができます。また半角スペースに関しては、「<nowiki>{{Template|ABC=XXX}}</nowiki>」の部分を「<nowiki>{{Template|1=ABC=XXX}}</nowiki>」のように、その引数の序数(前から数えて何番目か。この例なら一番目なので半角の1に相当)を変数として指定する事で、エラーを回避する方法もあります。
; テンプレートの編集をしましたが、それを使ったページに反映されないのは何故ですか?
▲
; テンプレートの名前を変えることはできますか?
▲
; テンプレートの中にテンプレートを使えますか?
: [[Image:TC-dbl.PNG|frame|テンプレート内のテンプレート使用の概念図]]できます。
; テンプレートで使われるプログラミング言語のマニュアルはどこにありますか?
▲
[[Category:ウィキペディアのテンプレート|*Hてんふれえとはやわかり]]
|