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üzenlemeDüzenle

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.

VisualEditor - Template without TemplateData.png

Parametre değerinin ne olması gerektiği hakkında bilgi verilmez.

VisualEditor - Template without TemplateData2.png

TemplateData ile düzenlemeDüzenle

TemplateData ile, şablonda kullanılabilecek parametrelerin (ve açıklamalarının) bir listesi sağlanır.

VisualEditor - Template with TemplateData1.png

TemplateData, her parametre için açıklama gösterir ve kullanıcıların şablonları değiştirmesini kolaylaştırır.

VisualEditor - Template with TemplateData2.png

TemplateData eklemeDüzenle

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.