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).
Il wikicodice della tabella non viene scritto a mano: si utilizza invece 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.
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.