Aiuto:Template sinottici
Questa pagina spiega all'atto 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).
Di solito non si scrive il wikicodice della tabella, in quanto è 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.
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.
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:
|Nome1 = Regione
|Valore1 = [[{{{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.
Notare anche che, se un parametro è opzionale, l'aggiunta di formattazione va fatta solo quando il parametro è veramente presente. Nell'esempio precedente:
|Nome1 = Regione
|Valore1 = {{#if:{{{Regione|}}}|[[{{{Regione}}}]]}}
Altrimenti, in assenza del parametro la casella apparirebbe ugualmente, riempita soltanto con "[[]]".
Categorizzazione del 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.
Come per altri tipi di template, di solito all'interno dello stesso noinclude si inseriscono prima il {{man}} e poi la categoria/e.
Metodi manuali[modifica | modifica wikitesto]
Di solito questi metodi non si utilizzano più, a meno che servano cose particolari che il template:Infobox non può fare. In generale Infobox non fa altro che creare una tabella di due colonne proprio come la creerebbe il wikicodice sottostante.
Codice della tabella[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
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.
- Piede
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:
|}
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.
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|{{{immagine|}}}|{{{didascalia|}}}|proprietà=P18}}
{{Box|Frutto|{{{frutto}}}}}
{{Box opzionale|Animale|{{{animale|}}}}}
{{Box formattato|Peso|{{{peso|}}}|{{{peso}}} kg}}
{{Box sezione|Sezione!}}
{{Box esteso|{{{città|}}}}}
{{Box sito|{{{url|}}}|{{{nomeurl|}}}}}
{{Box fine|fine!}}
| Prova titolo | |
|---|---|
 | |
| Frutto | Pera |
| Animale | Elefante marino |
| Peso | 333 kg |
| Sezione! | |
| Cervignano d'Adda | |
| Sito Web | Sito istituzionale |
| fine! | |
Esempio di utilizzo del sinottico (a sinistra il codice inserito in una voce, a destra il risultato):
{{Prova
|frutto = Pera
|immagine = Pears.jpg
|didascalia = Una pera
|animale = Elefante marino
|peso = 333
|città = Cervignano d'Adda
|url = http://www.comune.cervignanodadda.lo.it/
|nomeurl = Sito istituzionale
}}
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.
