Aiuto:Template sinottici

Da Wikipedia, l'enciclopedia libera.
Questa pagina di aiuto è riferita alla linea guida: Wikipedia:Template sinottici

Questa pagina spiega al lato pratico come creare un template sinottico. Per sapere perché crearlo e quali contenuti metterci, vedi la linea guida.

Esempio: Roma
Regione Lazio
Abitanti 5.555.555
Sezione
bla bla

La struttura portante di un sinottico è una tabella, generalmente a 2 colonne, che riporta una serie di campi (singoli dati), ciascuno corrispondente a un parametro. I nomi dei campi (Regione, Abitanti nell'esempio a fianco), che qui chiamiamo etichette, sono intestazioni della tabella; i valori (Lazio, 5.555.555) sono caselle normali. Anche il titolo è un'intestazione, ma estesa sulle due colonne. Possono esserci sezioni, divisioni orizzontali con ulteriori intestazioni a due colonne, e anche certi valori possono estendersi su due colonne (tipicamente le immagini; "bla bla" nell'esempio).

Nuvola apps khelpcenter.pngSportello informazioni

Nomi dei parametri[modifica | modifica wikitesto]

I nomi dei parametri corrispondono possibilmente alle etichette (nell'esempio sarebbero probabilmente {{{Regione}}}, {{{Abitanti}}}), ma potrebbero non essere identici. Nelle etichette è importante la correttezza, nei parametri la semplicità; ad esempio {{{Data sindaco}}} potrebbe generare l'etichetta "Data di elezione del sindaco".

Come per tutti i template non va trascurato il manuale, particolarmente complesso per i sinottici visto l'alto numero di parametri.

Classi[modifica | modifica wikitesto]

L'aspetto grafico della tabella è regolato da classi CSS definite in MediaWiki:Common.css. Le classi sono:

  • sinottico - aspetto generale della tabella
  • sinottico_testata - per il titolo
  • sinottico_divisione - per titoli di sezioni
  • sinottico_piede - per eventuale piede, riga finale evidenziata.

Per garantire uniformità e accessibilità, evita di differenziare il template dalla grafica standard. A parte il colore dei titoli, l'inserimento di stili HTML in linea dovrebbe avvenire soltanto in caso di particolari necessità. Se desideri un aspetto diverso per questione di gusti, modifica piuttosto la classe sinottico nel tuo Common.css personale (vedi Aiuto:Stile utente), e lo otterrai automaticamente in tutti i sinottici.

Codice della tabella[modifica | modifica wikitesto]

Vediamo come creare la tabella di un sinottico tipico.

Inizio[modifica | modifica wikitesto]

Iniziare sempre la tabella con:

{| class="sinottico"

Se fosse necessario variare la larghezza della tabella, aggiungere ad esempio:

{| class="sinottico" style="width:300px;"

Titolo[modifica | modifica wikitesto]

Proseguire con il titolo, definito ad esempio dal parametro "Titolo":

|- class="sinottico_testata"
! colspan="2" | {{{Titolo}}}

Per il titolo spesso si definisce un colore personalizzato in base all'argomento del sinottico, in questo caso il codice è ad esempio:

|- class="sinottico_testata"
! colspan="2" style="background-color:red; color:white;" | {{{Titolo}}}

Dove background-color è il colore della barra del titolo, e color del testo, se diverso dal nero (esempio).

Campo obbligatorio[modifica | modifica wikitesto]

Per ogni campo fisso, che appare anche se il relativo parametro è vuoto, inserire:

|-
! Etichetta
| {{{Parametro|}}}

Campo opzionale[modifica | modifica wikitesto]

Se un campo deve apparire solo quando il parametro è effettivamente usato, inserire:

|-
{{#if:{{{Parametro|}}}|! Etichetta
{{!}} {{{Parametro}}} }}

In passato è stato usato anche un altro metodo, basato sulla classe hiddenStructure, che sfruttava l'attributo display:none. Metodi di questo tipo vanno evitati in quanto non supportati da tutti i browser.

Titolo di sezione[modifica | modifica wikitesto]

Per iniziare una nuova sezione:

|- class="sinottico_divisione"
! colspan="2" | Titolo sezione

Se si desidera colorare la barra, ad esempio con gli stessi colori del titolo, aggiungere l'attributo style come per il titolo.

Una sezione potrebbe contenere soltanto campi opzionali, in tal caso è bene far sparire anche il titolo di sezione quando nessuno dei campi è presente. Ecco un esempio di titolo di sezione basata su 3 campi opzionali (Param1, Param2 e Param3).

|- class="sinottico_divisione"
{{#if:{{{Param1|}}}{{{Param2|}}}{{{Param3|}}}|! colspan="2" {{!}} Titolo sezione }}

Casella estesa[modifica | modifica wikitesto]

Una casella che si estende su tutta la larghezza del sinottico (due colonne), usata a volte per testi corposi, si realizza così:

|-
| colspan="2" | {{{Parametro|}}}

Ovviamente non c'è un'etichetta sulla sinistra; l'etichetta per questi campi si pone sopra, realizzandola come un titolo di sezione (vedi sopra).

Spesso si dà un allineamento centrato al testo:

|-
| colspan="2" align="center" | {{{Parametro|}}}

Immagine[modifica | modifica wikitesto]

Un'immagine di solito utilizza una casella estesa, ed è un campo opzionale.

|-
{{#if:{{{Immagine|}}}|{{!}} colspan="2" align="center" {{!}} [[File:{{{Immagine}}}|240px]] {{#if:{{{Didascalia|}}}|<br />{{{Didascalia}}}}} }}

Nell'esempio il parametro Immagine va valorizzato soltanto con il nome del file. La larghezza in px di norma è impostata a poco meno di quella del sinottico (default 250px).
Si può usare Template:Immagine sinottico.

Fine[modifica | modifica wikitesto]

Talvolta in fondo alla tabella si mette un piede:

|- class="sinottico_piede"
| colspan="2" | Testo piede

Se si desidera un piede vuoto (solo barra senza testo) inserire &nbsp; come testo. Se si desidera colorare il piede, ad esempio con gli stessi colori del titolo, aggiungere l'attributo style come per il titolo.

In ogni caso, come tutte le tabelle, terminare con:

|}

Formattazione dei valori[modifica | modifica wikitesto]

A volte si aggiunge della formattazione automatica all'interno delle singole caselle dei valori. Ad esempio, al campo sulla regione si potrebbe aggiungere il wikilink:

|-
! Regione
| [[{{{Regione|}}}]]

Questo permette a chi inserisce il sinottico nelle voci di scrivere soltanto |Regione = Lazio. Attenzione però, può causare limitazioni: nell'esempio non è più possibile inserire nel campo Regione una nota o un titolo disambiguato (es. Centro (regione francese)), a meno di ulteriori complicazioni. Valutare caso per caso se sia davvero conveniente formattare in automatico.

Categorizzazione template[modifica | modifica wikitesto]

I template sinottici vanno categorizzati nell'apposita categoria inserendo negli stessi il seguente codice:

<noinclude>[[Categoria:Template sinottici]]</noinclude>

oppure dove presente nella sottocategoria per argomento inserendo il seguente codice:

<noinclude>[[Categoria:Template sinottici - <argomento>]]</noinclude>

sostituendo <argomento> con valore appropriato.

Infobox[modifica | modifica wikitesto]

Magnifying glass icon mgx2.svg Lo stesso argomento in dettaglio: Template:Infobox.

Anziché scrivere il wikicodice della tabella è possibile utilizzare il sottotemplate {{Infobox}}, per il quale si rimanda al relativo manuale. La pagina Template:Nome_del_sinottico conterrà a sua volta Infobox, che non va utilizzato direttamente nelle voci.

Template box[modifica | modifica wikitesto]

Un altro metodo basato su sottotemplate è dato da Categoria:Template box. Questi template sono pezzi componibili che vanno inseriti in ordine nella pagina Template:Nome_del_sinottico (non nelle voci), dove ciascuno definisce una riga del sinottico.

Esempio di uso dei template box

I template box sono dei sottotemplate utili a costruire dei template sinottici. Ciascuno genera un pezzo della tabella che compone il sinottico. Non vanno utilizzati direttamente nelle singole voci.

Esempio di "Template:Prova" costruito con i box:

{{Box titolo|Prova titolo|colore=#FF00FF}}
{{Box immagine|Pears.jpg|Una pera}}
{{Box|Frutto|{{{frutto}}}}}
{{Box opzionale|Animale|{{{animale|}}}}}
{{Box formattato|Peso|{{{peso|}}}|{{{peso}}} kg}}
{{Box sezione|Sezione!}}
{{Box esteso|{{{città|}}}}}
{{Box fine|fine!}}

Prova titolo
Pears.jpg
Una pera
Frutto Pera
Animale Elefante marino
Peso 333 kg
Sezione!
Cervignano d'Adda
fine!

Esempio di utilizzo del sinottico (a sinistra il codice inserito in una voce, a destra il risultato):

{{Prova
|frutto = Pera
|animale = Elefante marino
|peso = 333
|città = Cervignano d'Adda
}}

L'esempio non usa tutti i possibili template box, altri sono presenti nella categoria. Inoltre, i box possono sempre essere mescolati con parti di tabella fatte a mano (come in aiuto:Template sinottici), quando occorre fare cose particolari.


Pagine correlate[modifica | modifica wikitesto]

template Progetto Template: collabora a Wikipedia sull'argomento template