Help:TemplateData/ilo



Ania kadi ti TemplateData?
Ti TemplateData ket isu ti waya ti panagipenpen ti pakaammo a maipanggep ti plantilia ken dagiti parametrona, tapno ti VisualEditor ket makaala ket makaiparang daytoy idiay editor ti plantilia, tapno mapalaka ti agurnos kadagiti plantilia.

Ti TemplateData ket mangpalubos kadagiti agara-aramat ti agsurat kadagiti bassit a naestruktura a datos iti panid ti plantilia, wenno mailak-amto iti dayta a panid ti plantilia (a kas idiay panid ti dokumentasion). Kalpasanton no adda daytoy ti naestruktura a datos, mabalinton a husto a maiparang iti VisualEditor. Bayat a daytoy ket kasla narigat, daytoy ket pudno a nalaka met.



Estruktura ti TemplateData
Ti estruktura ti TemplateData ket naibatay iti alagaden ti JSON, ken silple met laeng daytoy. Laglagipen nga amin dagiti deskripsion iti TemplateData ket nasken a naranas a testo (awan ti wikitext, wenno silsilpo, kdpy).

Ti umuna nga aramiden ket ti panangimakinilia ti paris dagiti etiketa ti, iti aniaman a lugar ti dokumentasion a subpanid ti plantilia, kasla daytoy:

Daytoy ket mangibaga ti sopwer nga amin nga adda ti baetan dagitoy dua nga etiketa ket ti TemplateData, ken nasken a maibasaran no mausar ti plantilia.



Kas pagarigan
Dagiti deskripsion ti uneg ti TemplateData ket sumurot ti alagaden a tabas; kunatayo koma nga addaanka ti plantilia a tinawtawagan ti "Commons" para iti panagisilpo ti kategoria ti Commons a maipanggep ti topiko. Daytoy ket mangala ti maysa a nasken a parametro: ti nagan ti kategoria idiay Commons. Ti TemplateData ket kastoyto ti kitana:

Daytoy ket mangiparangto, iti plantilia, a kastoy: {       "description": "Ti plantilia para iti panagisilpo ti kategoria idiay commons a maipanggep ti maysa nga artikulo", "params": { "1": {                       "label": "Kategoria ti Commons", "description": "Ti kategoria ti commons a kayatmo nga isilpo.", "default": "Category:CommonsRoot", "type": "string", "required": true }       } }



Deskripsion ken dagiti parametro
No nalpaskan, talmegam ti "idulin". No addaanka kadagiti biddut, daytoy ket saan a mangpalubos kenka nga agidulin (a makariro, ngem nasayaat ta saaka a makadadael). No makasarakka kadagiti biddut, ipadamagmo idiay pagibagaan a panid no ania ti padpadasem nga ar-aramiden, ken naragsak kaminto a tumulong kenka.

Laglagipen a ti tungngal maysa a pirgis ti pakaammo ket narikpan kadagiti marka ti sasao (malaksid para iti  ken  ), ken naisina manipud ti sumaruno a pirgis babaen ti koma (malaksid no daytoy ket ti naudi).



Dagiti parbo a nagan ti parametro
Adda met dagiti plantilia a mangpalubos ti isumet laeng a parametro nga addaan ti sabali a nagnagan.

Kas pagarigan,  ket mabalin pay a maisurat a kas ti   wenno.

Ti pananginayon ti daytoy a pakaammo iti TemplateData, simple laeng nga inayon dagiti parbo a nagan iti pakaammo ti parametro:



Dagiti nadumaduma a parametro
No addaanka kadagiti nadumaduma a parametro, uliem laeng ti tungngal maysa a paset (mangrugi manipud ti etiketa ti "1" ) ken punnuem dagitoy no mabalin. Laglagipen a no ti plantilia ket addan kadagiti nadumaduma a parametro, nasken nga ilasinmo koma ida iti TemplateData, a kasla daytoy:



Dagiti agpapada a parametro
No ti plantilia ket addan kadagiti nadumaduma a parametro, sagpaminsan nga adda dagitoy ket agpapada a kita. Iti daytoy a kaso, nasken laeng a mangtedka kadagiti napno a tagikua para iti umuna, ken dagiti dadduma ket "tawidanda" dagiti tagikuada manipud ti immuna.



Blanko a pagtabasan
Mabalinmo ti agkopia ti blanko a pagtabasan dita baba tapno makanayon ti baro a TemplateData iti plantilia. Dagiti laeng kadawyan nga etiketa ti nairaman.



Dagiti limitasion ken salsaludsod

 * Dagiti awan a langa — Ti TemplateData ket kas pagarigan laeng ti ramit a naaramid a magun-od nga addan laeng kadagiti bassit a langai, iti namnama a dagiti agar-aramat ket mangtulong a mangkuyog ti panagrang-ay dagiti langa a kayatda. No kayatmo ti agkiddaw kadagiti baro a langa para iti TemplateData, pangngaasi a pakaammuan dakami.
 * Mangtaktak ti panangipakita kadagiti plantilia — Kalpasan ti pananginayon ti TemplateData iti plantilia, ti metadata ket nasken koma a dagus a makita no ti plantilia ket nalukatan iti VisualEditor. Nupay kasta, daytoy ket mabalin nga agapaut kadagiti adu nga oras sakbay a maiparang ti metadata. Mabalinmo a piliten a pabaruen ti awan linaonna a panag-urnos ti panid ti plantilia (saan nga idiay dokumentasion a subpanid). Ti panagaramid ti awan linaonna a panag-urnos, lukatan ti panid ti plantilia para it panag-urnos, ken idulin ti panid nga awan ti panagaramid ti aniaman a panagbalaliw.
 * Dagiti agdama parikut — A list of current bugs and feature requests is available in bugzilla.



Tools

 * TemplateDataEditor — A user script that makes the process of adding TemplateData easier. It currently exists in English and French, and can easily be translated into other languages.
 * TemplateData Wizard — A tool that generates TemplateData through an interactive interface.
 * Skeleton TemplateData generator — A tool that reads the source wikicode of a template, tries to find all the parameters used and outputs a skeleton document with the parameters listed.
 * JSONLint — A tool that allows you to validate manually-written JSON to help find errors in the syntax.