Help:TemplateData/ja

でウィキテキストテンプレートとそのパラメーターの情報を保存するとVisualEditorがそれを取得してテンプレートエディタに表示するため、そのテンプレートを使用したページの編集がしやすくなります.

テンプレートデータ拡張機能はウィキメディア財団が実施するどのウィキにもインストールされています. 自分自身のwikiで使用したい場合は、Extension:TemplateDataをインストールする必要があります.

テンプレートデータ構文によりユーザーは小規模な構造化データをテンプレートページに書き込んだり、あるいは書いた構造化データをそのテンプレートページ（例えばテンプレートの解説ページ）に参照読み込みさせることができます. テンプレートが受け取ったこのような構造化データは、ビジュアルエディターに正しく表示されます. これは複雑に聞こえるかもしれませんが、実際には非常に簡単です.

テンプレートデータ編集ツール
簡単にテンプレートデータを編集するための組み込みツールがあります.

テンプレートデータ編集ツールを使用するには、テンプレートのページ（またはその解説下位ページ）を開き「編集」ボタンを押します. すると編集ウィンドウの上に 「」（訳注:図ではManage TemplateData）というボタンが表示されます.

このボタンをクリックするとGUI ツールが開き、テンプレートデータが編集できます.

編集ツールを使うとテンプレートの引数の記入と最も一般的な属性の設定ができます. 編集したページに既存の一連のテンプレートデータがある場合、該当するページをテンプレートデータ編集ツールで開くと登録済みのデータが自動で表示されます. 1番目のボックス (訳注：図のTemplate description (en)の欄) ではテンプレートの簡略な説明を平文で書いたり更新したりします. その次の欄では「提示されたパラメータ（複数）を追加」ボタンを使って、テンプレートに使用するパラメータの名前と属性を登録します（ボタンは図中に "Add suggested parameter(s)" と表示）.

テンプレートページが保護されている場合、下位ページにテンプレートコードを複写できます. まずテンプレートページの「提示されたパラメータを追加」ボタンを使ってテンプレートデータの内容をコピーします. 次に下位ページに戻って既存のテンプレートコードを削除してから、先ほどコピーしたテンプレートデータの内容をペーストします. テンプレートデータの内容を下位ページのどの位置にペーストするか確認するには、テンプレートデータを空編集します. 其の後、タグの と 及びその間に挟まれた内容を、先ほどコピーしたテンプレートデータで上書きします.

引数の名前、その引数の別名、ラベルとユーザに表示される説明文を一覧表示できます. また、引数の使用例を提示できます. 唯一の必須入力欄は名前（各行の初めにある入力欄）です. そこには、大文字・小文字を区別して正確に引数の名前を記録します. "型"ドロップダウンメニューには、引数が受け取るべき内容の種類（例えば平文の回答には「文字列」、他ページへのリンクには「ページ」、あるいは「日時」など）を選択することができます. 空白にするとテンプレートにエラーを起こす引数には、「必須」とマークします. また、よく使われる、あるいは推奨される引数には「推奨」とマークします. 「引数情報を除去」ボタンは、テンプレートデータに入力された引数を削除します.



各引数の記述が終わったら「適用」ボタンをクリックし、空いている編集ボックスに整形済みのテンプレートデータを挿入します. 編集ツールのウィンドウが閉じても作業はまだ終わりではなく、通常の「投稿」ボタンを忘れずに押して必ずページを保存します.

注意：テンプレートデータ編集ツールがテンプレートデータを配置する先は、テンプレートページか、その解説サブページのいずれか片方です. テンプレートデータを追加する場所は、それを配置するためにどのページを開く（編集する）かによって決まります. ただし、1件のテンプレートに複数ブロックのテンプレートデータが存在しても、実際にはそれらのブロックのうちの1つしか使われません. ページにテンプレートデータが既にある場合は、テンプレートデータを複数ブロック作るエラーを避けるために、ページ内の既存のテンプレートデータを編集する必要があります.

制限と質問

 * 不足している機能 — テンプレートデータをあえて機能を制限したツールのサンプルとして提供したのは、どんな機能を求めているかユーザに教えてもらうことで開発の支援をお願いできないかという考えがあるからです. テンプレートデータの新機能の提案がありましたら、ぜひお知らせください.
 * テンプレート表示が遅れる — テンプレートページへ TemplateData を追加後、ビジュアルエディタでテンプレートを開くと、メタデータがすぐに表示されるはずです. しかしながらメタデータの表示には数時間を要する可能性があります. 強制的に更新するには (説明文書の下位ページではなく) テンプレートページ自体に空編集をします. 空編集を行うテンプレートページを開き、「任意の変更を加えず編集要約欄は空欄のまま」ページを保存します.
 * 現在の問題 — 現在のバグや機能要求のリストはWikimedia バグトラッカーで利用可能です.

テンプレートデータの位置
テンプレートデータはそれを説明する対象のページに配置するか、もしくはそこに参照読み込みします. テンプレート内では常にタグで挟みます. ページの通常のレンダリングでは#例に示したように自動生成された説明文書を表示します.

テンプレートデータの構造
テンプレートデータの構造は JSON 標準に基づいています. テンプレートデータ内のすべての記述は、平文つまりプレーンテキスト (ウィキテキストやリンクその他を使えない) でなければならないことに気をつけてください.

はじめにやることは、テンプレートのdocサブページのどこかに タグを対になるように記入することです. 例えば:

こうすると2つのタグの間のすべてがTemplateDataであり、ソフトウェアがテンプレートを使用する際に必ず参照するよう指示します.

例
The descriptions inside TemplateData follow a standard layout; let's say that you have a template called "Commons" for linking to a Commons category about a topic. It takes one mandatory parameter: the name of the category on Commons. The TemplateData would look something like this:

記入すると、例えば以下のようにテンプレートページに表示されます.

{   "description": "これは記事についてコモンズカテゴリにリンクするためのテンプレートです. ", "params": { "1": {           "label": "コモンズのカテゴリー", "description": "リンクするコモンズのカテゴリ. ", "default": "Category:CommonsRoot", "type": "string", "required": true }   } }

説明とパラメーター
Once you're done, hit "save". If you've made errors, it will not let you save (which is disruptive, but means you can't break anything). Should you run into errors, explain on the feedback page what you were trying to do, and we will be happy to help.

Note that each bit of information is enclosed in quotation marks (except for  and  ), and separated from the next bit by a comma (unless it's the last one).

Custom formats
When editing custom format strings in the TemplateData editor you can either type  or press the enter key to represent a newline; in either case it will display as   in the entry field.

{| class="wikitable" ! style="width:25%" | Objective ! Format string ! Output each template on its own line
 * + Examples of formats you can use
 * Inline formatting
 * Block formatting
 * No space before the parameter name,
 * Block formatting
 * No space before the parameter name,
 * Block formatting
 * No space before the parameter name,
 * No space before the parameter name,
 * No space before the parameter name,
 * No space before the parameter name,
 * Indent each parameter
 * Align all parameter names to a given length
 * Align all parameter names to a given length
 * Align all parameter names to a given length
 * Align all parameter names to a given length
 * Align all parameter names to a given length
 * Pipe characters at the end of the previous line
 * Inline style with more spaces, must be at start of line
 * Inline style with more spaces, must be at start of line
 * Inline style with more spaces, must be at start of line
 * Inline style with more spaces, must be at start of line
 * Inline style with more spaces, must be at start of line
 * Template at the start of a line, indent-aligned parameters, pipe beforehand
 * could also be written as  or.
 * could also be written as  or.

To add this information to TemplateData, you simply need to add the aliases to the parameter's information:

自動値
You can specify an "autovalue" for a parameter. When users add the template to a page, this value will be added automatically. For example, many clean-up templates need to have the date added; if you specify an autovalue for the template's date parameter, then the date will be filled in automatically.

To add this information to TemplateData, simply add the autovalue to the parameter's information. You will probably want to use the prefix  with the values to make them stick:

複数のパラメーター
If you have multiple parameters, just repeat each section (starting from the "1" tag) and fill it out as you see fit. Note that if a template has multiple parameters, you need to separate them with a comma in the templatedata, like so:

同様のパラメーター
When a template has multiple parameters, sometimes some of them can be of the same kind. In this case, you only need to provide full properties for the first one, and the others can "inherit" their properties from it.

ブランク定型
以下に示す値が空の定型を複写して使用すると、特定のテンプレートに新規にテンプレートデータを記入できます. タグは最も一般的なタグのみ提供してあります.

その他のツール

 * : ツールバーのダイアログウィンドウ. テンプレートデータから生成したフォームを使い、テンプレートにウィキテキストを記入するために使用.
 * TemplateData Wizard: テンプレートデータを生成するツール. インタラクティブなインターフェースを使用.
 * Skeleton TemplateData generator: テンプレートのソースウィキコードを解読するツール. 使用するすべてのパラメータ（引数）を検出し、値が空のドキュメントとパラメータの一覧を出力.
 * JSONLint: 手入力したJSONが正しいかどうか確認するツール. 構文エラーの発見に役立つ.
 * このウィキにあるテンプレートデータを備えたテンプレートの一覧
 * ドイツ語版ウィキペディアのテンプレートに備わったテンプレートデータでは、ボックス内にテンプレートのデータを表示. テンプレートはそのデータとともにドイツ語版ウィキペディアの特定のカテゴリに分類される