I template ti permettono di specificare dei parametri. Questi sono utilizzati per modificare il modo in cui viene visualizzato il template, come includere del testo o modificarne il design.
Nota: quasta pagina descrive la manipolazione dei templati nell'editor sorgente. Quando si inserisce un template in una pagina, il VisualEditor ti permette di definire e inserire i parametri di testo senza toccare il wikitext.
Parametri semplici
Per piccoli template, spesso è sufficiente utilizzare parametri di base senza nome. Questi parametri non sono definiti per nome, ma sono numerati usando {{{1}}}
, {{{2}}}
, {{{3}}}
, e così via.
Guida
Questa guida ti condurrà attraverso la procedura per creare un template di base con parametri semplici.
- Crea una pagina di template nella tua wiki (per esempio, "Template:Box").
- Inserisci il seguente codice in quella pagina:
- Salva la pagina e nota che visualizza il seguente contenuto:
- {{{1}}}
- Crea una pagina di articolo articolo nella tua wiki chiamata
Template test
. - Inserisci il seguente codice in questo articolo per mostrare il tuo template:
{{Box|Testo di esempio}}
- Salva la pagina e vedrai che viene visualizzato il seguente contenuto:
- Testo di esempio
Capire cosa è avvenuto
Questa sostituzione è avvenuta perché {{{1}}}
dice alla wiki di passare e visualizzare il primo parametro del template qui. Questo può essere esteso utilizzando {{{2}}}
, {{{3}}}
, etc.
Il numero rappresenta il numero del parametro:
{{Box|primo parametro|secondo parametro|terzo parametro}}
Parametri con nome e parametri di default
Per template più complessi, è spesso meglio utilizzare parametri con nome. Ciò permette più libertà nella creazione dei template, e rende anche più facile utilizzare i template per gli utenti che non sanno quale parametro influenza cosa.
Guida
Questa guida ti condurrà attraverso la procedura per creare il "Template:Box" di prima con parametri con nome.
- Usando le stesse pagine di esempio di prima, modifica "Template:Box" e sostituisci il contenuto con il seguente codice:
{{{testo}}}
introduce il concetto di parametro con nome.{{{colorebg|#DDD2}}}
introduce anche il concetto di paramentro di default: se 'colorebg' non viene specificato, viene usato di default "#DDD2
".
- Modifica l'articolo "Template test" e sostituisci il contenuto con il codice seguente:
{{box|colorebg=navy|testo=Un riquadro blu marino}}
- Salva la pagina e vedrai che viene visualizzato il seguente contenuto:
- Un riquadro blu marino
Capire cosa è avvenuto
Dal momento che i parametri hanno dei nomi, possono essere specificati in qualsiasi ordine, per cui {{box|testo=Un riquadro blu marino|colorebg=navy}}
produrrebbe lo stesso risultato.
Per via della presenza di parametri di default, se per esempio non avessi specificato il colore di sfondo (parametro "colorebg") - come in {{box|testo=Un riquadro blu marino}}
- avresti ottenuto:
- Un riquadro blu marino
I parametri con nome vengono spesso scritti in righe separate o con uno spazio tra il nome del parametro e il segno "=", per migliorarne la leggibilità. Generalmente, questo è fatto per template grandi con molto parametri. Quindi è frequente vederli scritti nel modo seguente:
I parametri di default possono essere lasciati vuoti se vuoi che un parametro opzionale non inserisca niente nella pagina.
Per esempio, se scrivessi {{{testo}}}
in un template, senza però specificare nulla per l'input text=
nell'articolo, verrebbe visualizzato come "{{{testo}}}". Tuttavia, se nel template scrivessi invece {{{testo|}}}
, il valore di default sarebbe uno spazio vuoto, per cui non verrebbe mostrato nulla nella pagina di articolo.
È anche possibile impostare un altro parametro come parametro di default di un parametro, come {{{testo|{{{1|}}}}}}
. In questo modo, se un utente usa {{box|Testo di esempio}}
, otterrebbe lo stesso risultato di {{box|testo=Testo di esempio}}
. Ciò significa che il template usa come default il parametro |testo=
, ma se non riesce a trovare un |testoxt=
, userà il parametro senza nome al suo posto; se non riesce a trovare neppure {{{1}}}
, non userà nessun testo.
Saltare un parametro
In alcuni template potrebbero esserci parametri che sono opzioni, possono essere inseriti o meno.
Quando si crea un template di questo tipo, è consigliato usare un parametro con nome per la variabile opzionale oppure renderlo l'ultimo della lista così che gli utenti possano semplicemente ignorarlo. Se non ha un nome e non è l'ultimo, non c'è alcun modo semplice per saltarlo. Un utente può inserire un valore vuoto come
{{box|primo parametro||terzo parametro}}
ma questo potrebbe non funzionare come desiderato, a seconda del template, poiché i valori vuoti si comportano diversamente rispetto ai valori non inseriti. Per esempio, i valori di default non sono usati perché il parametro è stato inserito, semplicemente con una valore vuote.
Se un template usa parametri opzionali senza nome ed è necessario saltare un parametro senza nome, è possibile farlo utilizzando esplicitamente i numeri di tutti i parametri, come:
{{box|1=primo parametro|3=terzo parametro}}
Un'altra alternativa è che il template cerchi specificatamente eventuali parametri vuoti usando funzioni parser logiche.
Vedi anche
- Aiuto sui parametri dei template su Wikipedia
- Documentazione per template, per aiutare gli utenti a conoscere come usare i parametri del template
- Template
- Infobox
- Funzioni parser
Aiuto aggiuntivo e feedback
- Naviga e cerca altre pagine di aiuto su Contenuti.
- Esplora la Wiki della Community per ulteriori fonti di aiuto o supporto.
- Leggi come contattare Fandom per problemi o segnalare errori.