Help:Extension:TemplateWizard

テンプレートウィザードとは?

テンプレート ウィザード (TemplateWizard) という MediaWiki 拡張機能 は、ウィキテキスト にテンプレートを挿入できるようにウィキエディターツールバー用の小窓をポップアップ表示します。

この拡張機能の使い方は?

• TemplateWizard を使うには、編集対象のウィキページを（2017年版ウィキテキストエディターではなく）ウィキテキスト・エディターで開く
• テンプレートを挿入したい位置にカーソルを置いてから、ツールバーのパズルアイコン を押す -
• ダイアログ窓が出現する

テンプレートの探し方は?

テンプレートを見つける方法は以下のとおりです。

1. 検索ボックスに探したいものを記入
2. お気に入り一覧から選択
3. テンプレートのカテゴリを順に見る

詳細はテンプレート発見の解説文書 をご一読ください

• 記入欄にテンプレートの名前を入力しはじめると、選択できる候補のリストが提示される。
  

• 注記：テンプレートデータを備えたテンプレートのみ説明を表示。そのためテンプレートにはテンプレートデータの追加が推奨される。

• 目当てのテンプレートが見つかったらクリックして（あるいは矢印キーで移動して）選択、↵ Enter キーを押す。 するとデータ入力欄に遷移する。
• 頻繁に使う特定のテンプレートを以前にお気に入り登録したことがあるなら、検索窓の下の「お気に入り」タブにそれら登録したテンプレート一覧が表示されるので、そこから選びます。

選んだテンプレートにデータを入力する方法は?

• The title bar of the dialog window shows a 'back' button with which to close the template form and return to search.
• Below that is the top bar, which contains the template title, description, and a link to the template's wiki page.
• 左側にあるパラメーターの一覧は、パラメーターを必須、推奨、任意の上限3件まで分類します。この領域最下部のボタンで、必須ではない欄を一括で追加または除去できます。パラメーターが何もないテンプレートもあり、その場合はここに何も列挙されない点に注意してください。テンプレートのパラメーターをクリックすると、右側に追加されます。
• 右側は利用者が実際に値を入力する欄で、この値がウィキテキストに追加されます。ここに列挙されているパラメーターのみが編集領域に挿入されます （値のないパラメーターも含めます。テンプレートはその扱いを、全く存在しないパラメーターとは変えている可能性があるからです）。
• 詳細情報を参照するにはテンプレート欄の上にある情報アイコンをクリック。

• テンプレートウィザードが最も効果的に挙動するのは、テンプレートデータの定義、つまりパラメーターの既定値などの文書化が詳細かつ構造化された方法を採用する場合です（この作業手順の情報はテンプレートデータのヘルプを参照してください） 。テンプレートウィザードはたとえその定義がなくても 動作しますが、いくらか機能性が低下します。これら2つのモードを次の2節で説明します。

• 

  必須欄のみ既定で追加

• 

  欄の情報をポップアップ表示

• 

  ウィキのページ名を自動補完

• 

  コモンズのファイル名の自動補完

• 

  カスタム欄に日付、長文テキスト、数値など入力できる。

ウィザードをデータと使う

テンプレートウィザードで使用する欄には7つの異なる型があり、パラメーターの型はテンプレートデータの定義に基づきます。

	名前	型	使われる欄	備考
1.	数値	number	NumberInputWidget
2.	日付	date	DateInputWidget
3.	利用者名	wiki-user-name	UserInputWidget
4.	ページ	wiki-page-name	TitleInputWidget	任意のページ名（ファイル名を含む）。
5.	ファイル	wiki-file-name	TitleInputWidget	ファイル名前空間にあるタイトルに限定。サムネイル画像とともに表示。
6.	テンプレート	wiki-template-name	TitleInputWidget	テンプレート名前空間にあるタイトルに限定。
7.	それ以外		TextInputWidget	その他のすべての型は標準テキスト入力として表示され、任意のテキストを受け入れる。

テンプレートデータ自体はさらに多くの欄の型をサポートします。これらの一部は T200664 で追加されるかもしれません。

テンプレートデータなしでテンプレートウィザードを使う

テンプレートにいかなるテンプレートデータもない場合、パラメーターの名前を推定してラベルに使い、標準のテキスト記入欄として表示します。

この一覧には、非推奨パラメーター、重複あるいは欠落が含まれる可能性に注意してください。以下の例のように、テンプレートの作者がパラメーター名の異なる形式を許容していることがあるからです：{{{full name|{{{Full Name}}}}}}（大文字と小文字の違いに注意）。 パラメーターには好ましい形式がしばしばあり、これを確認するにはそのテンプレートの説明文書を読むしかありません（そして、そのときにテンプレートデータを追加しておけば、他の利用者が将来混乱せずにすむかもしれません！）。

テンプレートを挿入するには?

テンプレートの記入欄に必要と思うパラメータをすべて追加し、値を決めたら（空のパラメーターが必要だから値なしにする場合を含む）、ダイアログウィンドウ右上の「Submit」ボタンをクリックすると、テンプレートのウィキテキストはメインのページ編集ボックスのカーソルを置いた位置に挿入されます。

テンプレートのテキストは、テンプレートデータで定義した書式に従って挿入されます。指定しない場合は「インライン」書式を使います。ひとつのテンプレートが異なるカスタム書式を持つことは不可能です (しかし、もちろんテンプレートのウィキテキストは挿入後、いつでも編集できます)。

関連項目

• Help talk:Extension:TemplateWizard – この拡張機能のエンドユーザー向けヘルプ用フォーラム。
• Extension:TemplateWizard – システム管理者や開発者対象の拡張機能のホームページ。
• Phabricator:tag/TemplateWizard – バグや追加してほしい機能の問題追跡システム。