What is TemplateData?

ಬದಲಾಯಿಸಿ


TemplateData is used by VisualEditor to improve the template-editing experience for the user. VisualEditor includes a wizard to edit templates, but for the wizard to be most useful, it needs to present specific information to the user about each template, such as a short description of the template's purpose and its parameters. This information is codified formally (by any wiki editor) using TemplateData.


Without TemplateData

ಬದಲಾಯಿಸಿ


Without TemplateData, each parameter needs to be added manually when inserting a new template.

No information is provided about what the value of the parameter should be.


With TemplateData, a list of supported parameters (and their description) is provided for the template.

TemplateData provides context for each parameter, and makes it much easier for users to modify templates.

Adding TemplateData

ಬದಲಾಯಿಸಿ


Anyone can help by adding TemplateData to templates (particularly high-profile ones, such as infoboxes) so that they are easier to edit in VisualEditor. The following is a minimal example, placed on a template's documentation page:

<templatedata>{
  "description": "insert description here",
  "params": {
    "first parameter": {
      "label": "x",
      "description": "x",
      "type": "string",
      "default": "default value",
      "required": false
    }
  }
}</templatedata>

The TemplateData tutorial explains in detail how to add TemplateData information to a template.

Commonly used templates

ಬದಲಾಯಿಸಿ

Here is a list of the most commonly-used templates. When you've added TemplateData to one, add a {{Tick}} mark next to it; we'll update the list with new additions as we go. Its advisable to do a null edit on the main template page to force the system to update the database.

For completed items, consult the bot-generated logging page Wikipedia:VisualEditor/TemplateData/List.

If you complete an item, mark it here with {{tick}} or {{done}} until the item appears on the logging page.

If you partly complete an item (suggested action), mark the entry below with {{partly done|<explain what still needs to be done>}} and do not remove from this list until they are completed. Partly done items will appear on the logging page as if they were completed.

Used in main-space (>5000 uses)

ಬದಲಾಯಿಸಿ

Infobox template (>5,000 uses)

ಬದಲಾಯಿಸಿ

Used in main-space (250 to 5000 uses)

ಬದಲಾಯಿಸಿ

Used in user-space (high-priority)

ಬದಲಾಯಿಸಿ

Used as meta-templates

ಬದಲಾಯಿಸಿ

Used in other namespaces

ಬದಲಾಯಿಸಿ

Main-space templates

ಬದಲಾಯಿಸಿ

Following are templates which taking parameters but are used <250 times. There are thousands of templates which contain only content for transclusion and which take no parameters. These are not considered here.

Following have no instances of use: