Visualizza wikitesto di Template:Parametro/man

<div class="toccolours" style="clear:both; margin-bottom:.5em; font-size:95%">
Il template {{tl|Parametro}} serve per compilare le liste di parametri nelle pagine di istruzioni dei template. (vedere {{tl|TabellaTemplate/man}} )

Completato col nome del parametro:

 <nowiki>{{Parametro|Nomeparametro|valoresuggerito|nota=}}</nowiki>

Genera:

{{Parametro|Nomeparametro}}

É possibile indicare anche un secondo parametro:

* aggiungendo come secondo parametro il testo "''opzionale''", "''O''", "''facoltativo''" oppure "''F''" si ottiene il testo in {{Verde|verde|G}};
* aggiungendo come secondo parametro il testo "''consigliato''" oppure "''C''" si ottiene il testo in {{Blu|blu|G}};
* aggiungendo come secondo parametro il testo "''attenzione''" oppure "''A''" si ottiene il testo in {{Rosso|rosso|G}};
* aggiungendo come secondo parametro il testo "''sconsigliato''" oppure "''S''" si ottiene il testo in {{Grigio|grigio|G}};
* aggiungendo come secondo parametro il testo "''particolare''" oppure "''P''" si ottiene il testo in {{Arancio|arancio|G}};
* aggiungendo come secondo parametro il testo "''deprecato''" oppure "''D''" si ottiene il testo in {{Giallo|giallo|G}}.
* '''nota''' = nota da inserire nel tag <nowiki><ref>...</ref></nowiki>.

Ad esempio con
 <nowiki>{{Parametro|Esempioparametro_obbligatorio}}</nowiki><br />
 <nowiki>{{Parametro|Esempioparametro_opzionale|opzionale}}</nowiki><br />
 <nowiki>{{Parametro|Esempioparametro_consigliato|consigliato}}</nowiki><br />
 <nowiki>{{Parametro|Esempioparametro_attenzione|attenzione}}</nowiki><br />
 <nowiki>{{Parametro|Esempioparametro_sconsigliato|sconsigliato}}</nowiki><br />
 <nowiki>{{Parametro|Esempioparametro_particolare|particolare}}</nowiki>
 <nowiki>{{Parametro|Esempioparametro_deprecato|deprecato}}</nowiki>

si ottiene:

{{Parametro|Esempioparametro_obbligatorio}}
{{Parametro|Esempioparametro_opzionale|opzionale}}
{{Parametro|Esempioparametro_consigliato|consigliato}}
{{Parametro|Esempioparametro_attenzione|attenzione}}
{{Parametro|Esempioparametro_sconsigliato|sconsigliato}}
{{Parametro|Esempioparametro_particolare|particolare}}
{{Parametro|Esempioparametro_deprecato|deprecato}}

Seguono alcuni consigli d'uso dei parametri secondo il colore, utilizzabili nel manuale del template:
<div class="toccolours" style="clear:left; margin-bottom: 0.5em;">
* I parametri scritti in {{Rosso|rosso|G}} devono essere '''obbligatoriamente compilati'''. Questo vuol dire che deve essere presente il nome campo seguito da = e un valore.

* Quando esistono e sono noti, i parametri scritti in {{Blu|blu|G}} sono '''fortemente consigliati'''. Nel caso di campi blu che non vengono utilizzati, le relative righe vanno lasciate col solo nome campo seguito da = e senza nessun valore. Questi campi '''non vanno comunque mai rimossi''', per futuri possibili inserimenti di informazioni.

* I parametri scritti in {{Verde|verde|G}} sono '''facoltativi'''. Nel caso di campi facoltativi che non vengono utilizzati, le relative righe possono venir lasciate col solo nome campo seguito da = e senza nessun valore, nel caso si sia sicuri che tali parametri non vangano compilati successivamente (per esempio perch* non pertinenti alla voce) è possibile cancellarli.

* I parametri scritti in {{Grigio|grigio|G}} sono '''sconsigliati'''. Sono inseriti per supportare casi particolari, ma esistono altri parametri sostitutivi che sarebbe meglio utilizzare.

* I parametri scritti in {{Arancio|arancio|G}} sono '''particolari'''. Sono inseriti per dei parametri che sono caratteristici solo per determinati template come {{tl|UNESCO}}.
</div>

Il template contiene nel codice le interruzioni di riga necessarie, che non devono essere inserite manualmente.

Come '''terzo parametro''' si può suggerire un valore probabile o certo (per esempio, il valore suggerito del parametro ''appellativo'' di un vescovo sarebbe ''monsignor''). Il parametro suggerito comparirà dopo il segno di uguale (=). In tal caso, per evitare malfunzionamenti del template, occorre obbligatoriamente specificare anche il secondo parametro (si usi ''N'' per ottenere il colore '''nero''').

==Legenda colori==
*I parametri scritti in '''nero''', sono obbligatori, la loro valorizzazione è determinante per il corretto funzionamento del template.
*I parametri scritti in <span style="color:green">'''verde'''</span>, sono facoltativi. Questo vuol dire che se non vengono inseriti, non compaiono all'interno del template. 
*I parametri scritti in <span style="color:blue">'''blu'''</span>, sono facoltativi, ma il loro uso è fortemente consigliato. Questo vuol dire che se non vengono inseriti, non compaiono all'interno del template.
*I parametri scritti in <span style="color:red">'''rosso'''</span>, richiedono particolare attenzione per la loro compilazione. Si raccomanda di leggere attentamente la sezione istruzione per dettagli in proposito.
* I parametri scritti in <span style="color:grey;">'''grigio'''</span> sono '''sconsigliati'''. Esistono altri parametri sostitutivi che sarebbe meglio utilizzare.
* I parametri scritti in {{Arancio|arancio|G}} sono '''particolari'''. Utilizzati solo con particolari condizioni.

Nel caso di campi facoltativi che non vengono utilizzati, le relative righe possono venir lasciate col solo nome campo seguito da = e senza nessun valore. Se si è sicuri che un parametro facoltativo non verrà mai utilizzato (per esempio perché non pertinente alla voce in oggetto) lo stesso può essere eliminato dalla tabella inserita nella voce.

<noinclude>

[[Categoria:Manuali dei template|Parametro]]</noinclude>

== Pagine correlate ==
*[[Template:TabellaTemplate]]