Template:Tmbox/man

Wikibooks, manuali e libri di testo liberi.
Jump to navigation Jump to search

Questo è il metatemplate {{Tmbox}} ([T]alk page [m]essage [box]) metatemplate. Questo template è richiamato dagli altri template per fornire una struttura e un aspetto coerenti ai messaggi standard utilizzati nelle pagine di discussione del progetto.

È possibile usarlo direttamente su una pagina di discussione per presentare un messaggio specifico nello stesso formato dei messaggi preimpostati, ma questo non è lo standard (se un messaggio è abbastanza importante da essere presentato in questo modulo, dovresti prendere in considerazione la creazione di un template separato in modo che sia facilmente disponibile per tutti). Tmbox offre molti colori diversi per diversi scopi, fornisce immagini predefinite se non viene fornito alcun parametro di immagine e ha alcune altre piacevoli caratteristiche. Funziona esattamente come {{Ambox}} e prevede gli stessi parametri.

Stili standard suggeriti[modifica]

The types of talkpage messageboxes follow the same naming convention as the boxes for all other namespaces, but the type of any particular talkpage messagebox may not be as obvious as in other namespaces. Al momento di decidere quale tipo di Tmbox usare,si prega di considerare le seguenti linee guida:

  • immediata da usare solamente per i template di cancellazione immediata
  • cancella da usare solamente per i template relativi alla discussione di cancellazione in corso. Per favore non usare questo tipo di messaggio soltanto per bordare di rosso un messagebox.
  • contenuto e stile devono essere utilizzati per avvisi e avvertimenti. Usa contenuto (che ha un bordo arancione) per avvisi più importanti e immediati, e stile (che ha il bordo giallo) per avvisi meno importanti. I Messageboxes di questo tipo dovrebbero idealmente essere provvisorie: non ci si dovrebbe aspettare che restino su una pagina di discussione indefinitamente.
  • sposta e protezione devono essere rispettivamente utilizzati soltanto per avvisi relativi a spostamenti ed unioni, e protezioni delle pagine.
  • Il tipo avviso deve essere utilizzato per la maggior parte degli avvisi; quelli che sono adibiti a dare o riassumere informazioni. Se un Imbox non rientra fra i casi precedenti, probabilmente è di tipo avviso.

Uso[modifica]

L'uso più semplice è questo
{{Tmbox | testo = Lorem ipsum}}


Un esempio più complesso
{{Tmbox
| tipo       = stile
| immagine   = [[File:Emblem-question-yellow.svg|40px]]
| stile      = width: 400px;
| stiletesto = color: red; font-weight: bold; font-stile: italic;
| testo      = Il testo del messaggio
}}

Tipi di avvisi per le discussioni[modifica]

Gli esempi che seguono usano differenti parametri per tipo ma non specificano nessun parametro per l'immagine. In questo modo mostrano l'immagine di default prevista per ciascun tipo.

Speciali[modifica]

Altre combinazioni di parametri.

Parametri[modifica]

Lista di tutti i parametri

{{Imbox
| tipo  = immediata / cancella / contenuto / stile 
          protezione / altro / avviso / sposta
| immagine = none / [[File:Some immagine.svg|40px]]
| immaginedestra = [[File:Some immagine.svg|40px]]
| stile = un valore CSS
| stiletesto = un valore CSS
| plainlinks  = no
| testo  = Il testo da visualizzare all'interno del messaggio.
| small = {{{small|}}} / yes 
| immaginepiccola = none / [[File:Some immagine.svg|30px]]
| immaginepiccoladestra = none / [[File:Some immagine.svg|30px]]
| testopiccolo  = Un messaggio in piccolo.
}}
tipo
Se il parametro tipo non viene dato, il template imposta di default avviso. Si avrà quindi un bordo grigio.
immagine
Nessun parametro = se il parametro immagine non è dato, il template usa l'immagine di default, che dipende dal parametro tipo che si è impostato.
Un'immagine = dovrebbe essere un'immagine inserita con il solito wikitesto. Solitamente ha una larghezza di 40px - 50px con allineamento a destra, ma dipende dal rapporto height-to-width (manualmente si può comunque inserire qualsiasi larghezza).
Per esempio: immagine = [[File:Crystal package settings.png|40px]]
none = significa che non è stata usata nessuna immagine.
immaginedestra
Nessun parametro = se nessun parametro immaginedestra è dato, nessuna immagine sarà mostrata sul lato destro.
Un'immagine = dovrebbe essere un'immagine con un significato immediatamente riconoscibile. Solitamente ha una larghezza di 40px - 50px con allineamento a destra, ma dipende dal rapporto height-to-width (manualmente si può comunque inserire qualsiasi larghezza).
Per esempio: immaginedestra = [[File:Nuvola apps bookcase.png|40px]]
Altro = Qualsiasi altro oggetto vuoi che sia mostrato sul lato destro.
stile
Un CSS usato per l'intero box di avviso. Non necessità delle virgolette " " ma con la semi colonna finale ;.
For example: stile = margin-bottom: 0.5em;
stiletesto
Un CSS opzionale usato dalla casella di testo.
Per esempio: stiletesto = text-align: center;
plainlinks
Normalmente, su Wikizionario i link esterni sono segnalati da una piccola freccia, come qui: Example.com. Nei box degli avvisi questa freccia è soppressa di default, come qui: Example.com. Per avere lo stile normale previsto per i link esterni, usa |plainlinks=no.
testo
Il testo del messaggio.

Il parametro small[modifica]

small
yes = Rende il template più piccolo e lo piazza a sinistra. Questo rende anche le immagini di default più piccole. Si noti che tutti i dati forniti con i parametri immaginepiccola, immaginepiccoladestra e testopiccolo avranno effetto solo se viene usato anche "small=yes". Per fare in modo che il tuo modello comprenda anche il parametro small puoi usare questo codice:
small = {{{small|}}}

immaginepiccola

Nessun parametro = se non viene usato nessun parametro immaginepiccola questo template userà immagine come parametro. Se il parametro immagine viene lasciato vuoto, verrà usata l'immagine di predefinita per quello stile.
Un'immagine = Dovrebbe essere un'immagine con la normale notazione wiki. La larghezza di 30 px è in genere corretta. Per esempio:
immaginepiccola = [[File:Replacement filing cabinet.svg|30px]]
none = Significa che non viene utilizzata nessuna immagine. Questo sostituisce qualsiasi immagine dichiarata con immagine, quando "small=yes".
testopiccolo
Una versione più piccola del testo nel corpo del messaggio. Se non viene assegnato alcun parametro testopiccolo, questo modello utilizzerà il valore del parametro testo

Dettagli tecnici[modifica]

Se devi usate caratteri speciali nel testo, puoi usare questi caratteri di escape:

{{Tmbox
| testo  = <div>
Il segno uguale = e le parentesi graffe, sia aperte che chiuse { }  funzionano bene così come sono.
Ma ecco un pipe {{!}} e due parentesi graffe chiuse <nowiki>}}</nowiki>.
Ed ora un pipe e due parentesi graffe chiuse <nowiki>|}}</nowiki>.
</div>
}}
  • Questo template usa classi CSS contenute nella sottopagina Template:Tmbox/styles.css (oltre che in Template:Mbox/common.css per la parte comune ai template "box"), quindi è totalmente personabilizzabile
  • Al suo interno questo metatemplate usa codice HTML invece che il markup wiki per le tabelle. Questo perché nei metatemplate il markup wiki presenta alcuni inconvenienti. Per esempio rende più difficile usare le funzioni parser e i caratteri speciali nei parametri.
  • Le immagini di default di questo metatemplate sono in formato PNG invece che in SVG. La ragione principale è che alcuni browser più datati hanno problemi con lo sfondo trasparente che genera Mediawiki con le immagini SVG. Le immagini PNG qui usate sono ottimizzate in modo da essere visualizzate correttamente su qualunque browser. Si noti che le SVG sembrano solo peggiori con i vecchi browser, così vale la pena fare l'ottimizzazione per le icone più utilizzate.
  • Per maggiori dettagli tecnici guarda la pagina di discussione. Dal momento che questo modello funziona quasi esattamente come {{Ombox}}, {{Imbox}}, {{Cmbox}} e {{Ambox}} le loro pagine di discussione e pagine correlate potrebbero contenere anche maggiori dettagli.