Wikipedia:VisualEditor/TemplateData: differenze tra le versioni
Contenuto cancellato Contenuto aggiunto
→Vantaggi nell'implementazione del TemplateData: Riformulazione minima Etichette: Modifica da mobile Modifica da web per mobile |
m aggiungo un po' di padding |
||
(24 versioni intermedie di 15 utenti non mostrate) | |||
Riga 1:
{{
{{VisualEditor}}
</div>
▲| [[File:Gestisci documentazione template.png|thumb|right|216px|Accesso all'interfaccia visuale]] '''Attenzione:''' è ora disponibile una nuova [[#Interfaccia visuale di TemplateData|interfaccia ''visuale'']] per modificare/inserire TemplateData. Vi si accede tramite {{tasto|{{MediaWiki:Templatedata-editbutton}}}} dopo aver cliccato su ''Modifica sorgente'' nella sottopagina che contiene/conterrà i TemplateData (solitamente la sottopagina /TemplateData o /man del template stesso).
Il '''TemplateData''' è un codice che va implementato nei [[Wikipedia:Template|template]] che vengono utilizzati nelle voci, per permettere al nuovo editor [[WP:VE|VisualEditor]] di capire quali sono i parametri di quel template e di proporre all'utente un'interfaccia grafica semplice e funzionale per l'inserimento dei template. ''Non'' bisogna inventarsi o imparare niente di particolare: è solo una trasposizione diversa di dati già a nostra disposizione, contenuti nei [[Aiuto:Manuali dei template|manuali dei template]]. Peraltro più in basso sono elencati diversi strumenti che fanno la maggior parte del lavoro al posto nostro!
Riga 27 ⟶ 25:
== Dove mettere TemplateData ==
Il TemplateData va inserito in
La sottopagina va richiamata nella pagina base del template
All'inizio della sottopagina va invece
In caso la pagina base del template sia [[Wikipedia:Politica di protezione delle pagine|protetta]], la sottopagina "/TemplateData" <u>va comunque creata</u>: sarà infatti possibile richiamarla apponendo temporaneamente la stringa <code><nowiki><includeonly>{{TemplateData}}</includeonly></nowiki></code> nella sottopagina del manuale, prima di {{tag|noinclude}}.
▲All'inizio della sottopagina va invece inserito <kbd><nowiki><noinclude>{{TemplateData sottopagina}}</noinclude></nowiki></kbd>, che ha il compito tra l'altro di far comparire la sottopagina nella [[:Categoria:TemplateData]].
Potrebbe volerci del tempo
== La struttura di TemplateData ==
La struttura di TemplateData è basata sullo standard "[[JavaScript Object Notation|JSON]]"
<pre>
Riga 77 ⟶ 78:
== Codice ==
Passiamo alla spiegazione del codice. Le [[virgolette]], i [[due punti]], le [[Virgola|virgole]] e le [[Parentesi#Le parentesi graffe|parentesi graffe]] sono elementi importanti del codice di TemplateData e sono da '''non''' modificare. Se si vogliono inserire le virgolette nella descrizione del template (o di un parametro) è necessario scrivere ogni virgoletta preceduta da
*"'''description'''" (descrizione): dopo i due punti, tra le virgolette, si può inserire una breve descrizione del template.
*"'''params'''" (parametri): indica che le sezioni che seguono sono relative a ciascun parametro del template da non modificare.
Riga 143 ⟶ 144:
Puoi specificare un "valore automatico" per un parametro. Quando un utente aggiunge il template alla pagina, questo valore viene aggiunto automaticamente. Per esempio, molti template di avviso devono avere una data di inserimento; se specifichi un valore automatico per il parametro "data di inserimento", la data verrà aggiunta automaticamente.
Per aggiungere questa informazione a TemplateData, devi
Dovrai, probabilmente, utilizzare <code>subst:</code> per rendere i valori fissi:
Riga 190 ⟶ 191:
== Modello vuoto ==
Questo è un modello vuoto, contenente solo i parametri più
<syntaxhighlight lang="javascript">
<templatedata>
{
"label": "",▼
"
"type": "",▼
"description": "",▼
},
"
"label": "",
▲ "description": "",
▲"required":
"type": "",
}
},
▲"label": "",
"paramOrder": [
"1",
"2"
],
▲"type": "",
"format": ""
▲"required":
}
</templatedata>
Riga 224 ⟶ 222:
[[File:Gestisci documentazione template.png|130px]]
[[File:Gestisci documentazione template 3.png|right|border|430px]]
È disponibile un editor visuale di TemplateData direttamente nella pagina di modifica di Wikipedia. Vi si accede tramite il pulsante "Gestisci TemplateData" dopo aver cliccato su Modifica sorgente nella sottopagina che contiene o dovrà contenere i TemplateData, solitamente la sottopagina Template:NOMETEMPLATE/TemplateData
L'editor si presenta come una finestra dove sono presenti i parametri (se ve ne sono già) disposti su più linee, ognuna composta da sette caselle che permettono di impostare i relativi attributi di ogni parametro. Nell'esempio a destra è mostrato l'editor dei TemplateData del template {{Tl|Commons}} che corrisponde alla struttura:
Riga 283 ⟶ 281:
== Validazione codice JSON ==
Nel caso di un TemplateData particolarmente lungo può essere difficile scovare un errore e quindi capire perché non riusciamo a salvare la pagina. In questo caso può essere utile avere
== I template su cui lavorare ==
Riga 293 ⟶ 291:
Questo dovrebbe aiutarci a restringere inizialmente il campo. Inoltre, si possono momentaneamente saltare i template di navigazione. I link rossi possono essere ignorati. Grazie a Oliver (WMF) per aver generato questo elenco.
{{cassetto inizio
|titolo = Template cui aggiungere TemplateData, in ordine di utilizzo
}}
Quelli non segnati (
{| class="wikitable sortable"
Riga 668 ⟶ 664:
|182||[[Template:Corpo celeste/Calcolato]]||{{nonfatto|usato solo da altri template}}
|-
|183||[[Template:Non firmato]]||{{fatto}}
|-
|184||[[Template:Naz/ZAF]]||{{nonfatto|usato solo da altri template}}
Riga 674 ⟶ 670:
|185||[[Template:Naz/FIN]]||{{nonfatto|usato solo da altri template}}
|-
|186||[[Template:Demografia]]||{{fatto}}
|-
|187||[[Template:PD-Utente]]||
Riga 710 ⟶ 706:
|203||[[Template:Cancellazione/avvisoutente]]||{{nonfatto|usato solo da altri template}}
|-
|204||[[Template:Cita]]||{{fatto}}
|-
|205||[[Template:Naz/NOR]]||{{nonfatto|usato solo da altri template}}
Riga 1 224 ⟶ 1 220:
|460||[[Template:GRC]]||{{nonfatto|nessun parametro}}
|-
|461||[[Template:BloccoInfinito]]||{{fatto}}
|-
|462||[[Template:Goal]]||
Riga 1 414 ⟶ 1 410:
|555||[[Template:AggNaz/Italia]]||{{nonfatto|usato solo da altri template}}
|-
|556||[[Template:
|-
|557||[[Template:Nf]]||{{Non fatto|va nella pagina di discussione}}
Riga 1 472 ⟶ 1 468:
|584||[[Template:Naz/Russia]]||{{nonfatto|usato solo da altri template}}
|-
|585||[[Template:
|-
|586||[[Template:Commento]]||
Riga 1 484 ⟶ 1 480:
|590||[[Template:Coll]]||{{Fatto}}
|-
|591||[[Template:
|-
|592||[[Template:HRV]]||{{nonfatto|nessun parametro}}
Riga 1 618 ⟶ 1 614:
|657||[[Template:Naz/CIV]]||{{nonfatto|usato solo da altri template}}
|-
|658||[[Template:
|-
|659||[[Template:
|-
|660||[[Template:Naz/GHA]]||{{nonfatto|usato solo da altri template}}
Riga 1 630 ⟶ 1 626:
|663||[[Template:StagioniTV/Elenco]]||{{nonfatto|usato solo da Template:StagioniTV}}
|-
|664||[[Template:Torneo
|-
|665||[[Template:MEX]]||{{nonfatto|nessun parametro}}
Riga 1 706 ⟶ 1 702:
|701||[[Template:BGR]]||{{nonfatto|nessun parametro}}
|-
|702||[[Template:
|-
|703||[[Template:
|-
|704||[[Template:Naz/QAT]]||{{nonfatto|usato solo da altri template}}
Riga 1 738 ⟶ 1 734:
|717||[[Template:User]]||{{nonfatto|redirect a Template:Utente}}
|-
|718||[[Template:StagioniTV]]||{{fatto}}
|-
|719||[[Template:StagioniTV/Nomealt]]||{{nonfatto|usato solo da Template:StagioniTV}}
Riga 1 802 ⟶ 1 798:
|749||[[Template:Problematico/segnalazione]]||
|-
|750||[[Template:
|-
|751||[[Template:Problematico]]||
Riga 1 970 ⟶ 1 966:
|833||[[Template:Evento olimpico]]||{{fatto}}
|-
|834||[[Template:IPcondiviso]]||{{
|-
|835||[[Template:NFLS]]||{{Fatto}}
|