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

TemplateData 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

TemplateData 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

Herkes, ş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.