WikiSysop: Bot: Automatski unos stranica

2021-10-29T06:04:41Z

Bot: Automatski unos stranica

Nova stranica

{{prijevod-eng}}

__TOC__

== What is TemplateData? ==
TemplateData is the standardized description of a template, used by [[Wikipedia:VisualEditor|VisualEditor]], the [[mw:2017 wikitext editor|2017 wikitext editor]] and other tools to improve the template-editing experience for the user. Both VisualEditor and the 2017 wikitext editor include 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.

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

[[File:VisualEditor - Template without TemplateData.png|frameless|500px]]

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

[[File:VisualEditor - Template without TemplateData2.png|frameless|500px]]

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

[[File:VisualEditor - Template with TemplateData1.png|frameless|500px]]

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

[[File:VisualEditor - Template with TemplateData2.png|frameless|500px]]

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

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

You can also add or edit TemplateData using a [[GUI]], by pressing the following button which appears at the top of the edit page: <span class="oo-ui-buttonElement-button" style="color: #757575;border: solid 1px #cdcdcd;margin: 0.1em 0;padding: 0.2em 0.8em;border-radius: 2px;transition: background 0.1s ease-in-out,color 0.1s ease-in-out,box-shadow 0.1s ease-in-out;font-weight: bold;display: inline-block;vertical-align: top;text-align: center;cursor: pointer;">Manage TemplateData

The '''[[Wikipedia:VisualEditor/TemplateData tutorial|TemplateData tutorial]]''' explains in detail how to add TemplateData information to a template.

==Commonly used templates==

===List maintenance===
Here is a list of the most commonly used templates. When you've added TemplateData to one, add a {{tl|Done}} mark behind it; we'll update the list with new additions as we go. It's advisable to do a [[WP:NULL|null edit]] on the main template page to force the system to update the database. You can also look at [https://tools.wmflabs.org/bawolff/templatedata.htm this list of popular templates with no TemplateData] or [https://phabricator.wikimedia.org/P632 this list of popular templates] from May 2015.

*'''For completed items''', consult the bot-generated logging page [[Wikipedia:VisualEditor/TemplateData/List]].
*'''If you complete an item''', add <nowiki>{{Done}}</nowiki> after the entry until the item appears on [[Wikipedia:VisualEditor/TemplateData/List|the logging page]].
*'''If you partly complete an item''', add <nowiki>{{Partly done|<explain what still needs to be done>}}</nowiki> to the entry and do not remove it from this list until it is completed. Partly done items will appear on [[Wikipedia:VisualEditor/TemplateData/List|the logging page]] as if they were completed.
*'''Templates not suitable for TemplateData or with technical problems''': add <nowiki>{{Not done|<briefly explain why TemplateData couldn't be added>}} </nowiki> after the entry.

====Data sources====
*Raw data for the initial template usage statistics are stored on Phabricator in [https://phabricator.wikimedia.org/P632 this list].
*A formatted, partially cleaned up version of this data with usage count values is stored at [[Wikipedia:TemplateData/Template usage count]].
*Previous lists, based on data of 2013, have been archived at [[Wikipedia:TemplateData/Archive1]], including lists of meta-templates and templates in other namespaces.
*This list depends on [[:Category:TemplateData documentation]] for filtering and may include a limited number of already "logged" Template Data additions. Those templates just need a  in their TemplateData section and should be marked as "Done".

==See also==
*[[Wikipedia:VisualEditor/TemplateData/List]] A list of all pages with TemplateData

Wikipedija:TemplateData - Povijest promjena

WikiSysop: Bot: Automatski unos stranica