Aiuto:Template

L'applicazione degli elementi di stile ai contenuti avviene per mezzo dei modelli (o Template). Ne esistono di due tipi, i modelli per una specifica tipologia di articoli e i modelli per applicare gli stili ai contenuti frequenti degli articoli.

Uso

I modelli (o Template) sono utilizzati per inserire finestre di avviso e informative nelle pagine in maniera uniforme, per aggiungere messaggi pre-formattati, per creare box di navigazione e rendere possibile l'inclusione di testi tra lingue diverse del Wiki.

È possibile aggiungere il contenuto di un modello (template) ad una pagina digitando {{nometemplate}}.

I Template sono da utilizzarsi per

  • Visualizzare avvisi importanti o messaggi
  • Garantire un aspetto ed una impostazione uniformi attraverso tutto il wiki
  • Rendere più semplice la redazione degli articoli in presenza del medesimo testo che viene ripetuto in un gran numero di articoli
  • Aggiungere tag ad un articoli quando si eseguono operazioni di manutenzione

I Template non sono da utilizzarsi per

  • Creare elenchi di collegamenti ad altri articoli, quando una categoria o un elenco di cose da Vedere anche possono svolgere la stessa funzione.

Modelli standardizzati

Consultare la pagina Template standard per avere un elenco dei template messaggio standard.

Disponiamo anche di pagine relative a template standard da usarsi per svariate situazioni:

Creare nuovi modelli

Icon-warning.png
Attenzione! Si prega, se possibile, di non creare nuovi modelli, ad eccezione di nuove barre di navigazione.

Si richiede di osservare queste regole quando si crea un nuovo template che sia assolutamente necessario:

  • Il titolo del template deve iniziare con Template:.
  • I Template sono case sensitive (ovvero distinguono tra lettere minuscole e maiuscole), ad eccezione della prima lettera.
  • Il nome del Template deve seguire le convenzioni sui nomi (vedere qui per un articolo in italiano). In breve solo la prima lettera deve essere maiuscola e il cosiddetto CamelCase non è ammesso.
  • I Template possono essere spostati verso un nome nuovo. Ad essere incluso sarà l'obiettivo del rinvio (o redirect) al posto della pagina di rinvio stessa.
  • I Template possono essere usati all'interno di altri modelli.
  • Le dimensioni dell'icona dovrebbero essere uguali a 32px.
    • In rari casi in cui il modello è particolarmente grosso, usare allora 48px o 64px.
    • Se l'icona occupa troppo spazio nelle tabelle, inserire allora style="width:32px" nella cella precedente l'icona e la dimensione verrà ridotta a 32px.
  • La larghezza del Template dovrebbe essere uguale a width:100% della larghezza di pagina. Se dovesse essere più piccola controllare allora che il testo venga disposto attorno al modello.
  • Il testo dovrebbe essere posizionato sulla sinistra. Il testo che non sia allineato in modo da iniziare dalla stessa posizione risulta più scomodo da leggere dato che gli occhi devono andare alla ricerca del punto di partenza, e se questo succede ad ogni riga diventa una esperienza davvero sgradevole.

Per altre domande riguardanti i modelli, fare riferimento all'articolo Wikipedia Help:Template (e al corrispondente italiano Aiuto:Template). Vedere anche ParserFunctions per accedere ad altre pagine di aiuto avanzate sul loro funzionamento.

Documentazione per il modello

Ciascun modello deve essere accompagnato dalla propria documentazione in una sottopagina /doc a parte. Per esempio, la documentazione di Template:Info si trova nella sottopagina Template:Info/doc. Il sorgente della documentazione per il modello dovrebbe essere simile a questo esempio:

* '''Codice:''' <code><nowiki>{{</nowiki>[[Template:Info|Info]]|Testo di informazione<nowiki>}}</nowiki></code>
* '''Descrizione:''' Aggiunge informazioni importanti.
* '''Dove:''' Ovunque
* '''Template correlati:''' [[Template:Warning|Attenzione]], [[Template:Forbidden|Vietato]]
<noinclude>
[[Categoria:Documentazione template]]
</noinclude>

Il tag Codice: illustra il codice che l'autore dovrà scrivere per utilizzare il template, con i suoi possibili argomenti. Codice:, assieme a Descrizione: e Dove: sono tag che non devono mancare in un template di documentazione, mentre Template correlati: è facoltativo e si dovrebbe usare solo se è opportuno farlo per il dato template. Non ci si dovrà inoltre scordare di aggiungere la documentazione a Categoria:Documentazione template, mediante i tag <noinclude>.

Il seguente frammento di codice deve essere aggiunto in coda al template, al fine di visualizzare la documentazione per il template sulla pagina del modello stesso:

<noinclude>
{{{{PAGENAME}}/doc}}
</noinclude>

Esiste un'eccezione alla regola secondo la quale ogni template deve venire documentato usando la sottopagina /doc. Tali eccezioni sono i modelli preformattati (in gergo "boilerplate template"), che non sono concepiti per essere inclusi (o "transclusi", come si dice in gergo) all'interno di altre pagine, ma piuttosto per venire sostituiti quando si crea una nuova pagina. Esempi di queste pagine sono en:Template:Article, en:Template:Userpage o Template:Portal.

Categorizzazione dei modelli

È opportuno assegnare ogni modello ad una o più sotto-categorie della Categoria:Template. Se non si sa a quale categoria debba appartenere il nuovo template creato, oppure se si ritiene che sia necessaria una nuova categoria per il template, si dovrebbe prima chiedere nella mailing list del wiki.

Vedere inoltre Speciale:TemplateSenzaCategorie.


Collegamenti esterni