Help:Extension:TemplateWizard/ja

テンプレートウィザードとは?
テンプレートウィザード (TemplateWizard) はWikiEditorツールバーにボタンを作る MediaWiki で、にテンプレートを挿入する設定欄をポップアップで表示します.

この拡張機能の使い方は?
- ジグソーパズルのピースの形
 * 編集するページをウィキテキスト翻訳機能で開く (2017年版ウィキテキスト翻訳機能は非対応)
 * テンプレートを挿入する位置にカーソルを置いてから、ツールバーのOOjs UI icon puzzle-ltr.svgアイコンを押す
 * 設定用のダイアログ枠が表示される

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

 * 記入欄にテンプレートの名前を1文字目から入力しはじめると、選択できる候補のリストが表示される.
 * 注記：テンプレートデータTemplateDataを備えたテンプレートのみ説明を表示. そのためテンプレートにはTemplateDataの記入が推奨される.


 * 目当てのテンプレートが見つかったらクリックして (あるいは矢印キーで) 選択、Enterキー.を押す. するとデータ入力欄に遷移する.

選んだテンプレートにデータを入力する方法は?
$screenshotinfo 下記の2節を使い、テンプレートデータの有無によるモードの違いを説明します.
 * 画面上部にテンプレート挿入用メニューバーが現れテンプレート名と説明を表示し、OOjs UI icon link-ltr-progressive.svgボタンでテンプレートのウィキページへ遷移します. バーはOOjs UI icon trash-destructive.svgで閉じ、通常の検索バーが使えるようになります.
 * 挿入指定欄の左半分はパラメータ(属性) 一覧で必須、推奨、オプションの3つに分類されます. 欄の一番下にあるボタンを使い、利用しない欄を一括で除去できます. パラメータのないテンプレートはこの欄に何も表示がありません. テンプレートの特定のパラメータをクリックすると右欄に追加できます. 
 * 挿入指定欄の右半分は利用者が値を記入するデータ記入欄で、実際にウィキテキストに挿入するテンプレートに反映されます. ウィキページの編集欄に入力されるのは、この欄にあるパラメータに限定されます (欄がある限り値が空でもテンプレートはパラメータとして処理し、パラメータ欄がない場合と異なる結果を出力します).
 * データ欄の詳細は、テンプレート表示欄の枠外上部にあるアイコンをそれぞれクリックすると参照できます.
 * テンプレートウィザードが最も効果的に作動するには、対応するテンプレートデータの定義が欠かせません. つまりパラメータの詳細は、既定の値のほか構造化データとして保存されます. (この作業手順の情報はテンプレートデータのヘルプを参照してください. ) テンプレートデータの定義がなくてもテンプレートウィザードは有効ですが、一部の機能は制限されます.
 * The left-side list of parameters, divided into up to three parts for required, suggested, and optional parameters. This area also has a button at the bottom with which to add or remove all non-required fields at once. Note that some templates have no parameters, and in these cases nothing will be listed here. When you click on a template parameter, it gets added to the right side.
 * The right-side form containing the actual data-entry fields into which you put the values that will be added to the wikitext. Only those parameters that are listed here will be inserted into the editing area (including those that contain no value, as templates can treat this differently from the parameter not being present at all).
 * You can click on the info icons above the template fields to read more information about them.
 * TemplateWizard works most effectively with templates that have TemplateData defined: i.e. their parameters have been documented in a detailed and structured way, including default values etc. (information about how to do that is in the TemplateData help pages). It also works without TemplateData definitions, although with some reduced functionality. These two modes are described in the next two sections.

      

ウィザードをデータと使う
テンプレートウィザードにある7タイプの入力欄はテンプレートデータに定義してあります.

テンプレートデータは上記の説明以外にもさまざまなタイプの欄に対応する. に投稿するとよい場合もある.

テンプレートデータを利用せずにテンプレートウィザードを使うには
テンプレートに対応するテンプレートデータがない場合、パラメータの名前を推定してラベルに使い、標準のテキスト記入欄に組みこんで表示します.

注記としてこの一覧には重複や廃止済みのパラメータが混入したり、パラメータによっては載っていない可能性があります. 原因はテンプレートの作者が以下の例のようなパラメータ名のブレを生じさせがちだからです. (パイプ記号の前は小文字で後は大文字という違いに注意). パラメータにはこうあるべきという定型がしばしばあり、確認するにはそのテンプレートの説明文書を読むしかありません (自作のテンプレートの説明文書を読み直すのなら、そのときにテンプレートデータを記入しませんか、今後の利用者が混乱するのを予防できます!).

テンプレートを挿入するには?
テンプレートの記入欄に必要と思うパラメータをすべて追加し、値を決めたら (空のパラメータを設定するため値を空にする場合を含む) ダイアログ枠右上の「Submit」ボタンを押すと、その時点でメインの編集ボックスにあるカーソルの位置にテンプレートのウィキテキストが挿入されます.

挿入されるテンプレートの文字列は、テンプレートデータで設定した書式に従います. つまり設定がない場合は地の文と同じ「インライン」書式です. 特定のテンプレートに個別の書式を当てることは不可能です (もちろんテンプレートのウィキテキストは挿入後、編集が可能です).

関連項目

 * Help talk:Extension:TemplateWizard – エンドユーザ向け. この拡張機能のヘルプ用フォーラム.
 * – システム管理者と開発者向け. 公式ホームページ.
 * tag/TemplateWizard – バグと不足した機能の追跡用システム.