酥油花展现藏地指尖上的技艺
El TemplateData el xe un toco de còdexe che'l va meso inte i manua?i dei modè?i par parmetare al novo editor VisualEditor de capir cua?i che i xe i parametri de chel modèl e de propor al utente un interfacia grafega senplise e funsiona?e pa'l inserimento dei modè?i inte ?e voxe.
Vantaji che ne da TemplateData
[canbia | canbia el còdaxe]
El screenshot cuà a drita el ne mostra do modè?i co se xe drio canbiarli co VE.
Se se ingrandise se nota come che 'l secondo el sia pì senplise da editar rispeto al primo. ?a difarensa ?a consiste in "TemplateData", na moda?ità de imagaxinamento de informasion re?ative ai modè?i - ad ex. i nòmi dei parametri o na descrision - che ?a parmete a VisualEditor de recuperar ste informasion.
Una de ?e ròbe pì inportanti da far xe xontar TemplateData so i modè?i, soratuto cue?i pì in evidensa cofà i infobox, parché sto sistema el fa si che sia asé pì fasi?e editarli e xontarli so na voxe parché i parametri i vien sugerìi e par xontarli basta strucar el boton del mouse!
TemplateData el xe contro?à da l'omonima estension Mediawiki xà ativa so vec.wiki. Co'l modèl el ga sti dati el funsionarà a ?a granda co VisualEditor. El prosedimento el xe asé senplise.
?a strutura de TemplateData
[canbia | canbia el còdaxe]?a strutura de TemplateData ?a xe baxà so'l standard "JSON", e ?a xe bastansa senplise. ?a prima ròba da far xe inserir un par de tag <templatedata> inte el manual del modèl che ghemo sielto, cusì:
<templatedata> Cuà ghe va ?e info de TemplateData </templatedata>
Cuesto ghe dixe al software che tuto cue?o che se cata infrà i do tag xe "TemplateData" e che'l ga da farghe riferimento co el modèl el vien doparà. TemplateData el segue un layout standard, tipo cuesto:
<templatedata>
{
"description": "Un modèl par linkar ?a pàjina de Commons re?ativa a na voxe",
"params": {
"1": {
"label": "Tìto?o de ?a pàjina",
"description": "?a pàjina de Commons che se vol linkar",
"type": "string",
"required": true
}
}
}
</templatedata>
Inte el modèl tuta sta ròba ?a vien mostrà come na tabè?a:
Un modèl par linkar ?a pàjina de Commons re?ativa a na voxe
Paràmatri del mode?o[Xestiona TemplateData]
Parametro Descrision Tipo Stato Tìto?o de ?a pàjina 1?a pàjina de Commons che se vol linkar
Testo el ghe vole
In detajo
[canbia | canbia el còdaxe]El TemplateData el va meso inte na sotopajina del modèl steso, ciamà Modèl:PAGENAME/TemplateData che ?a xe riciamà dal modèl traverso el {{TemplateData}}, parché inserirlo diretamente so'l modèl el soracargaria i cluster de calco?o e cuindi se dovaria evitar de farlo, se manca el manua?e del modèl basta crearlo, anca so?o che co i dati de TemplateData. òcio podaria vo?erghe un fià de tenpo prima che'l modèl el rexulte efetivamente axornà e donca uxabi?e co VisualEditor.
Pasemo a ?a spiegasion del còdexe.
- El primo tag "description" (descrision), che'l descrive a cosa che serve el modèl.
- Po ghe xe el tag "params" (parametri) che'l indica che ?e sesion che segue ?e xe re?ative a ciascun parametro del modèl.
- In ogni sotosesion, el primo tag el xe cue?o del nòme del parametro, se 'l parametro el se ciama senplisemente "1", el tag el sarà "1".
- A seguir ghe xe "label" (eticheta), 'ndove va meso un tìto?o sensà pa'l paramtro che'l sarà vixua?ixà drento 'l editor dei modè?i de VE par jutar chi che xe drio efetuar el canbiamento a capir cosa che'l ga da metarghe.
- Po ghe xe "description" (descrision) che ?a xe na descrision del parametro spesifego, no de tuto el modèl.
- Dopo de che trovemo "type" (tipo), che contro?a el modo in cui 'l editor de modè?i de VE el interpretarà chel parametro; ?e posibi?ità ?e xe "string" (na secuensa de carateri), "number" (serie de cifre), "string/wiki-user-name", "string/wiki-page-name".
- Infine gh xe "required" (dimandà), che pol oviamente èsar so?o che "true" se ?a prexensa de chel parametro ?a xe obligatoria in chel modèl o "false" inte el caxo contrario.
- In ogni sotosesion, el primo tag el xe cue?o del nòme del parametro, se 'l parametro el se ciama senplisemente "1", el tag el sarà "1".
In caxo de pì parametri, basta ripetare ogni sesion (tacando dal primo tag) e conpi?arla co i dati dimandai. Da notar che in caxo de parametri multipli cogna separarli co na virgola, cusì:
"params": {
"Name": {
...
}, <-- òcio a ?a virgo?a cuà
"caption": {
...
}, <-- e cuà
"image": {
...
} <-- cuà no invese, che ?a xe l'ultema
}
Editor par TemplateData
[canbia | canbia el còdaxe]Par rendar pì fasi?e 'l inserimento de sto còdexe xe sta creai racuanti strumenti uti?i. El primo de sti strumenti el xe el script scrito da Ltrlg. Par dopararlo cogna ndar so'l pròpio JS e xontar sta riga de còdexe:
mw.loader.load('//fr.wikipedia.org/w/index.php?title=Utilisateur:Ltrlg/scripts/TemplateDataEditor.js&action=raw&ctype=text/javascript');
Po ghe xe sto strumento creà dal utente po?aco Lazowik, par dopararlo basta ndar so chel link e rienpir i vari canpi.
In ultema ghe xe el Skeleton TemplateData Generator che'l lexe el còdexe del modèl e in baxe a ?a so ana?ixi el te prexente na bosa de còdexe TemplateData che se pol sistemar co i altri do sistemi opur a man.
I modè?i che va axornai
[canbia | canbia el còdaxe]I modè?i 'ndove che serve xontar el TemplateData i se cata so ?a categoria Categoria:Mode?i sensa TemplateData. Co se sistema un modèl el va xontà so ?a lista cuà soto.
{{Stabi?e re?igioxo}}
Fato{{Ponte}} Fato{{Fiume}} Fato{{Divixion aministrativa}} Fato{{Montagna}} Fato
