Template:Parametro: differenze tra le versioni

Da La Barriera Wiki.
Vai alla navigazione Vai alla ricerca
mNessun oggetto della modifica
Nessun oggetto della modifica
 
(10 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:
<includeonly>'''<span style="cursor: help; color:
<includeonly><nowiki>|</nowiki>&nbsp;'''<span style="cursor: help; color:
{{#switch:{{{2}}}
{{#switch:{{{Tipologia}}}
| F
| F = green;" title="Parametro facoltativo"
| facoltativo
| P = red;" title="Attenzione: compilare seguendo scrupolosamente le istruzioni"
| O
| O = black;" title="Parametro obbligatorio"
| opzionale = green;" title="Parametro facoltativo"
}}>{{{Nome}}}&nbsp;=</span>'''&nbsp;{{#if:{{{Valore|}}}|{{{Valore}}}&nbsp;}}{{#if:{{{Commento|}}}|''<span style="color:gray">&lt;!-- {{{Commento|}}} --&gt;</span>''}}</includeonly>
| A
<noinclude>Il template [[Template:Parametro|Parametro]] serve per compilare le liste di parametri nelle pagine di istruzioni dei template.
| attenzione = red;" title="Attenzione: compilare seguendo scrupolosamente le istruzioni"
| C
| consigliato = blue;" title="Parametro facoltativo ma consigliato"
| #default= black;" title="Parametro obbligatorio"
}}>{{{1}}}&nbsp;=</span>'''&nbsp;{{#if:{{{valore|}}}|{{{valore}}}}}{{#if:{{{commento|}}}|{{#if:{{{valore|}}}|&nbsp;}}''<span style="color:gray">&lt;!-- {{{commento|}}} --&gt;</span>''}}<br/></includeonly>


<noinclude>
Il template [[Template:Parametro|Parametro]] serve per compilare le liste di parametri nelle pagine di istruzioni dei template.


== Parametri ==
__TOC__


=== Nome del parametro ===
== Utilizzo ==


Il primo parametro previsto dal template è il nome del parametro. Questo parametro è obbligatorio.
Per utilizzare il template è sufficiente eseguire un copia/incolla del seguente codice:
Alimentando il template solo con questo parametro:


<nowiki>{{Parametro|Nome}}</nowiki>
<nowiki>{{</nowiki>'''Parametro'''<br />
{{Parametro | Nome = Nome | Tipologia = O | Commento = Nome del parametro}}
{{Parametro | Nome = Tipologia | Tipologia = O | Commento = Tipologia del parametro}}
{{Parametro | Nome = Valore | Tipologia = F | Commento = Valore di esempio}}
{{Parametro | Nome = Commento | Tipologia = F | Commento = Stringa di commento}}
<nowiki>}}</nowiki>


Si ottiene:
== Esempi di utilizzo ==


{{Parametro|Nome}}
Alimentando il template nelle maniere indicate:


=== Colore del testo ===
<nowiki>{{Parametro | Nome = NomeParametro1}}</nowiki>
<nowiki>{{Parametro | Nome = NomeParametro2 | Tipologia = O | Valore = ValoreParametro2}}</nowiki>
<nowiki>{{Parametro | Nome = NomeParametro3 | Tipologia = F | Valore = ValoreParametro3 | Commento = CommentoParametro3}}</nowiki>


È possibile indicare anche un secondo parametro:
Si ottiene:
 
* aggiungendo come secondo parametro il testo "''opzionale''", "''O''", "''facoltativo''" oppure "''F''" si ottiene il testo in <span style="color:green;">'''verde'''</span>;
* aggiungendo come secondo parametro il testo "''consigliato''" oppure "''C''" si ottiene il testo in <span style="color:blue;">'''blu'''</span>;
* aggiungendo come secondo parametro il testo "''attenzione''" oppure "''A''" si ottiene il testo in <span style="color:red;">'''rosso'''</span>;
 
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>
 
si ottiene:
 
{{Parametro|Esempioparametro_obbligatorio}}
{{Parametro|Esempioparametro_opzionale|opzionale}}
{{Parametro|Esempioparametro_consigliato|consigliato}}
{{Parametro|Esempioparametro_attenzione|attenzione}}
 
Il template contiene nel codice le interruzioni di riga necessarie, che non devono essere inserite manualmente.
 
==Funzioni avanzate==
Tramite il campo facoltativo "''commento''" è possibile specificare un breve commento direttamente accanto al parametro, ad esempio:
 
<nowiki>{{Parametro|Data|consigliato|commento=solo l'anno}}</nowiki>
 
genera:
 
{{Parametro|Data|consigliato|commento=solo l'anno}}
 
Tramite il campo facoltativo "''valore''" è possibile specificare un valore accanto al parametro, come se fosse già compilato. Questo è utile per mostrare esempi e per parametri che hanno un contenuto fisso o in parte fisso. Usare &lt;nowiki> per eventuale formattazione. Ad esempio:
 
<nowiki>{{Parametro|Paese|consigliato|valore=&lt;nowiki>{{ITA}}&lt;/nowiki>}}</nowiki>
 
genera:
 
{{Parametro|Paese|consigliato|valore=<nowiki>{{ITA}}</nowiki>}}
 
==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.
''Se hai problemi a visualizzare i colori, passa col mouse sopra i nomi dei parametri per far apparire una breve descrizione.''


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.
{{Parametro | Nome = NomeParametro1}}
{{Parametro | Nome = NomeParametro2 | Tipologia = O | Valore = ValoreParametro2}}
{{Parametro | Nome = NomeParametro3 | Tipologia = F | Valore = ValoreParametro3 | Commento = CommentoParametro3}}


[[Categoria:Sottotemplate]]
[[Categoria:Sottotemplate]]</noinclude>
</noinclude>

Versione attuale delle 13:46, 15 mag 2014

Il template Parametro serve per compilare le liste di parametri nelle pagine di istruzioni dei template.


Utilizzo

Per utilizzare il template è sufficiente eseguire un copia/incolla del seguente codice:

{{Parametro
Nome = <!-- Nome del parametro -->

Tipologia = <!-- Tipologia del parametro -->

Valore = <!-- Valore di esempio -->

Commento = <!-- Stringa di commento -->

}}

Esempi di utilizzo

Alimentando il template nelle maniere indicate:

{{Parametro | Nome = NomeParametro1}}
{{Parametro | Nome = NomeParametro2 | Tipologia = O | Valore = ValoreParametro2}}
{{Parametro | Nome = NomeParametro3 | Tipologia = F | Valore = ValoreParametro3 | Commento = CommentoParametro3}}

Si ottiene:

NomeParametro1 = 

NomeParametro2 = ValoreParametro2 

NomeParametro3 = ValoreParametro3 <!-- CommentoParametro3 -->