Vikipedi:TemplateData
TemplateData (Şablon verisi), VisualEditor, 2017 vikimetin düzenleyici ve kaynak düzenleyeci ile kullanılabilen, şablon eklemeyi ve düzenlemeyi kolaylaştıran özelliğin açıklamasıdır.
Hem VisualEditor hem de 2017 vikimetin düzenleyici, şablonların düzenlenebilmesi için kullanışlı bir araç barındırır. Ancak bu aracın en kolay kullanılabilmesi için, şablonun amacının ve parametrelerinin kısa bir açıklaması gibi şablon hakkında bazı bilgilerin girilmesi gerekir. Bu bilgiler TemplateData kullanılarak kodlanır.
TemplateData olmaksızın düzenleme
değiştirTemplateData olmadan yeni bir şablon eklerken her parametrenin manüel olarak eklenmesi gerekir. Bu, yeni gelmiş ve şablonlar hakkında pek bilgili olmayan biri için zordur.
Parametre değerinin ne olması gerektiği hakkında bilgi verilmez.
TemplateData ile düzenleme
değiştirTemplateData ile, şablonda kullanılabilecek parametrelerin (ve açıklamalarının) bir listesi sağlanır.
TemplateData, her parametre için açıklama gösterir ve kullanıcıların şablonları değiştirmesini kolaylaştırır.
TemplateData ekleme
değiştirHerkes, şablonlara (özellikle bilgi kutuları gibi sık kullanılanlara) TemplateData ekleyerek VisualEditor'da daha kolay düzenlenebilmelerine yardımcı olabilir. Aşağıdaki kod, bir şablonun belge sayfasına yerleştirilmiş basit bir TemplateData örneğidir:
<templatedata>{
"description": "buraya açıklama eklenir",
"params": {
"birinci parametre": {
"label": "x",
"description": "x",
"type": "string",
"default": "varsayılan değer",
"required": false
}
}
}</templatedata>
TemplateData rehberi, bir şablona TemplateData bilgilerinin nasıl ekleneceğini ayrıntılı olarak açıklar.