Wiki della Community
Iscriviti
Advertisement
Wiki della Community

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:
<div style="background-color: #DDD2; border: 1px solid #5556; padding-top: 2em; text-align: center; width: 10em;">
{{{1}}}
</div>
  • 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:
<div style="background-color: {{{colorebg|#DDD2}}}; border: 1px solid #5556; padding: 2em; text-align: center; width: 10em;">
{{{testo}}}
</div>
{{{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:

{{Box
| colorebg    = navy
| testo       = Un riquadro blu marino
}}

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 aggiuntivo e feedback

Advertisement