Aiuto:Template sinottici
Questa pagina spiega al lato pratico come creare un template sinottico.
| 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).
 – Sportello informazioni
|
Nomi dei parametri
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
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
Vediamo come creare la tabella di un sinottico tipico.
Inizio
Iniziare sempre la tabella con:
{| class="sinottico"
Se fosse necessario variare la larghezza della tabella, aggiungere ad esempio:
{| class="sinottico" style="width:300px;"
Titolo
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
Per ogni campo fisso, che appare anche se il relativo parametro è vuoto, inserire:
|-
! Etichetta
| {{{Parametro|}}}
Campo opzionale
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
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
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
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
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 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
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
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
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
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}}
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. | ||||||||||||||||
