Wikipedia:VisualEditor/TemplateData

Da Wikipedia, l'ençiclopedia libara.
Va a: navigasion, serca

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 sorxente]

VE template comparison.png

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 sorxente]

Ł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'l 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'l 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

Parametri template
Parametro Descrizione Tipo Stato
Tìtoło de ła pàjina 1

Ła pàjina de Commons che se vol linkar

Predefinito
vuoto
Esempio
vuota
Valore automatico
vuoto
string obbligatorio

In detajo[canbia | canbia sorxente]

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'l caxo contrario.

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 sorxente]

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 sorxente]

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.