また、ビジュアルエディタの箇所の追加もしくは翻訳が必要です。どなたでも翻訳にご協力いただくことができます。
- 原文 : w:Help:Templates。
テンプレート(Template)は、コンテンツを複数のページに埋め込むことができるように設計された特殊なタイプのページのです。テンプレート自体は、他の記事同様に独立した個々のページです。 テンプレートを使うと、複数のページに同じ内容 (同じ構成の文やデザイン) を表示することができます。そのため、テンプレートが多数のページにインクルード (含有) されるようになると、手作業によるコピー&ペーストを減らしたり、ページ間で一貫したスタイルを推進させるのに役立ちます。
テンプレートは、こんなときに便利です…
- 多くのページに載せたい内容を、あらかじめテンプレートとして作成。
- 複数のページで、 (インフォボックスなど) 一貫性を保って作成したい内容を、テンプレートとして形式 (フォーマット) 化。
- 他者とコミュニケーションをとるとき、繰り返しよく書き込む内容について簡単に入力できるショートカットを作成。
- 長く、複雑なコードをテンプレートに置き換え、他のユーザーがそのページを編集しやすいようにする。
- 編集を保護していないページで、部分的に一部箇所のみを保護する(保護したい箇所をテンプレート化し、テンプレートページを保護)。
テンプレートは、日本語版のFandomコミュニティでは通常はテンプレート 名前空間にあります。テンプレート名前空間には、ページ名が「テンプレート:
」(英語版では「Template:
」)で始まるすべてのページが含まれています (例:テンプレート:名称
)。使用されているテンプレートのリストは、Special:Templatesで見ることができ、テンプレートタイプでフィルタリングできます。
テンプレートページはソースエディタを使用して作成改変されますが挿入はどのエディターでもできます。
注意:2015年12月以降、未登録ユーザーによるテンプレート編集はできなくなりました[1]。
基本のテンプレートを作ってみましょう[]
テンプレートはとても有用にもなりますが、時として非常に複雑なものにもなりえます。もっとも簡単なテンプレートを作成して試してみることが手始めに役に立ちます。まず、次のような簡単なテンプレートを作成し、そのテンプレートをもとにいろいろと試してみてください。
- あなたのコミュニティ上でテンプレート:Exampleにアクセスし、コンテンツセクションの右上にある「作成」(または「編集」) をクリックします。これでテンプレートが作成できるソースエディタが開きます。
- テンプレートの種類をえらぶように求めるポップアップが現れるでしょうからオプションから1つチェックしてください。探しているものが見当たらない場合は「不明」にチェックします。
- エディタで、「Hello, World」または「みなさん、こんにちは。」と入力します。
- 「公開」をクリックします。たったこれだけで、先ほどの例文がテンプレートとして作成されました。
- あなたのコミュニティ上で「テンプレートテスト」という名の新しい記事を作成します。(サンドボックスのページがあれば、利用すると良いでしょう。)
- 編集エディタのビジュアルモードで、「他のテンプレートを追加」をクリックします。「Example」を検索し、Exampleテンプレートを選びます。
- ソースモードの場合は、下のコードを入力します。
{{Example}}
- 「公開」をクリックします。「テンプレートテスト」のページに、テンプレートの内容が表示されたかどうか、確認します。
これで、テンプレートを作成し、記事で使ってみることができました!そうしたらあなたのコミュニティで役に立つようにテンプレートのにコンテンツを追加してみてください。
既存のテンプレートを使う[]
コミュニティには、すでに組み込まれているデフォルトのテンプレートがあります。 そのコミュニティで利用できるテンプレートの一覧を見るには、特別:全ページ (特別:AllPages) へ行き、名前空間のドロップダウンメニューから「テンプレート」を選んでください。「表示」をクリックすると、利用できるテンプレートが、一覧で表示されます。
- 編集エディタのビジュアルモードでは、「他のテンプレートを追加」をクリックすると、すべてのテンプレート一覧から、テンプレートを検索し、使いたいテンプレートを選ぶことができます。
- ソースモードでは、コード
{{テンプレート名}}
を利用して、記事に使うテンプレートを選ぶことができます。「テンプレート名」には、テンプレートの名前が入ります。 - 上級者は、en:MediaWiki:Editor-template-listページを編集し、エディタの「テンプレート」セクションでデフォルトで利用できるテンプレートの一覧を変更できます。この一覧には、最大で4つまでのテンプレートを表示できます。
- 公式の Starter Wiki 日本語版 と、半公式の Templates Wiki 日本語版(基本的なテンプレート)およびTemplates Wiki(英語)、Fandom Developers Wiki (より高度なテンプレート) では、Fandomのサイト用に特別に設計された新しいテンプレートが追加されたり、文書の一部が改良されたりしています。ぜひ、時々チェックしてみてください。
高度なテンプレート[]
テンプレートパラメータ[]
テンプレートは、パラメータ(テンプレート引数)を追加することができます。パラメータは、テキストなど、テンプレートの表示内容を特定のものに変えたり、デザインなど、テンプレートの表示方法を変えたりすることができます。
テンプレート:Wikipedia を例とすると、{{Wikipedia}}
だけを記述すると、そのテンプレートが使われたページと同じページ名の、Wikipedia英語版のページにリンクするように設定できます。しかし、パラメータを指定することで、他のページへリンクさせることもできます。例えば、{{Wikipedia|Microsoft}}
と記述すると、Wikipedia英語版にあるページMicrosoftにリンクします。
ユーザーの入力を基にしたテンプレートの出力を変更する方法について詳しく知るには、ヘルプ:テンプレートパラメータやヘルプ:パーサー関数をご覧ください。
テンプレートの置き換え(テンプレートを展開して使う)[]
テンプレートのもうひとつの使い方に、ページに挿入したテンプレートを、テンプレートの実体があるソースコードに置換(substitute)する方法があります。テンプレートを置換するには、テンプレートの始めの中括弧2つ ( {{ ) の直後に subst:
を挿入します:{{subst:テンプレート名}}
。いったんページを保存すると、テンプレートへのリンクは除去され、置換した箇所には、編集した時点でのテンプレートの出力がその場置換されます。また、その後もとのテンプレートを更新しても、そのページ上で置換された内容には影響しなくなります。置換した箇所は、他のテキストと同じように編集できます。
さらに詳しく知るには、 ヘルプ:テンプレートの置換をご覧ください。
Luaベースのテンプレート[]
Moduleネームスペースに実装されたLuaベースのテンプレートの形式で、上級ユーザーやソフトウェアコーダーにとってより快適であるかパフォーマンスの高い、特に高度なテンプレートを提供するwikitextテンプレートの代替があります。コーディングはより複雑ですが、これらのテンプレートはより高速に実行でき、読みやすくなります。 Fandom Developers Wikiの独自のグローバルLuaモジュールリストから既存のLuaベースのテンプレートをインポートすることもできます。
詳細については、Help:Luaをご覧ください。
他のwikiからテンプレートをコピーする[]
詳しくはヘルプ:テンプレート/複製をご覧ください。
Fandomには、それぞれのコミュニティに貢献している人たちによって作られた、様々な種類のすばらしいテンプレートがあります。既にあるテンプレートをコピーして、あなたの必要に応じてそれに変更を加えるほうが、一からテンプレートを作るより簡単な場合があります。多くの場合、CC-by-SA ライセンスに基づき自由に共有テンプレートをコピーできます。ただし、コピーしようとしているそのコミュニティにおいて、コピーできるものに制限を加える他のライセンス構想がないかどうか、確認するようにしてください。コピーした先のコミュニティを褒めることを推奨されており、そのコミュニティからも感謝されるでしょう。
下記はテンプレートをコピーするための基本的なステップです:
- コピーしたいテンプレートを見つける(たいていは http://wiki名.wikia.com/wiki/Template:テンプレート名)。
- 編集ボタンを押し、Wikiテキストのすべてを選んでコピー。
- 自身のコミュニティで新しいテンプレートページを作成 (http://あなたのwiki.wikia.com/wiki/Template:テンプレート名?action=edit)。
- コピーしたWikiテキストのコードをペーストして保存ボタンを押す。
多くのテンプレートにはテンプレートのドキュメントのためのサブページが存在します。幸運にもそれらの場所はたいてい決まっており、ドキュメンテーションのコピーも簡単にできます。もし先述のようにコピーしたテンプレートがオリジナルと違って見えればドキュメンテーションが他のページにある可能性が高いです:
- コピーしたいテンプレートのドキュメンテーションを見つける(たいてい
https://
wiki名.fandom.com/wiki/Template:
テンプレート名/doc
)。 - 編集ボタンを押し、Wikiテキストのすべてを選んでコピー。
- 自身のコミュニティで新しいテンプレートのドキュメンテーション用サブページを作成(
https://''yourwiki''.fandom.com/wiki/Template:''templatename''/doc?action=edit
)。 - コピーしたWikiテキストのコードをペーストして保存ボタンを押す。
編集したテンプレートのプレビュー[]
ソースまたはクラシック編集モードを使用する場合、編集したテンプレートをプレビューすることが望ましいです。通常、プレビュー画面から「公開」をクリックできます。 VisualEditorはデフォルトでテンプレートを表示します。
関連情報[]
- ヘルプ:テンプレート/作成 - テンプレートの作成
- ヘルプ:テンプレート/レイアウト - テンプレートのレイアウト
- ヘルプ:テンプレートパラメータ
- ヘルプ:テンプレートの種類
- ヘルプ:インフォボックス - 記事内容の概要を説明するために、よく使われるテンプレートの表現方法
- ヘルプ:テンプレートの置換
- ヘルプ:Lua
- ヘルプ:共有テンプレート
- テンプレート:Documentation
- Meta Wiki トランスクルージョン
参考[]
- FandomテンプレートWiki
- Templates (Rappy Wiki)
- Wikipedia:ja:Help:テンプレート
- Wikipedia:ja:Help:テンプレート早わかり
- Wikipedia:ja:Help:テンプレートの説明文
- Wikipedia:ja:Help:テンプレートの制限
- ポケモンWiki ヘルプ:テンプレート - テンプレート名前空間にないテンプレート