Template:Cmbox

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


Info Istruzioni per l'uso
Le istruzioni che seguono sono contenute nella sottopagina Template:Cmbox/man (modifica · cronologia · Sandbox)


Cmbox (sigla di Category message box) è un metatemplate utilizzato per i template di avviso da inserire nelle pagine delle categorie. Prevede differenti colori utilizzabili, ha un'immagine di default (se non viene indicata una differente) e offre altre caratteristiche.

Funziona come {{Ambox}} e prevede gli stessi parametri.

Uso

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


Un esempio più complesso
{{Cmbox
| 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 categorie

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.

Altre immagini

Le immagini di default mostrate sopra sono principalmente per comodità. In molti casi può essere appropriato usare immagini più specifiche. In questi esempi è usato un parametro === immagine === per precisare un'altra immagine rispetto a quella di default.

Usi speciali

Altre combinazioni di parametri.


Parametri

Lista di tutti i parametri

{{Cmbox
| tipo  = immediata / cancella / contenuto / stile / sposta / protezione / importante / esempio / avviso
| immagine = none / [[File:Some immagine.svg|40px]]
| immaginedestra = [[File:Some immagine.svg|40px]]
| class = Una classe CSS personalizzata da applicare al template
| stile = un valore CSS
| stiletesto = un valore CSS
| plainlinks  = no
| testo  = Il testo da visualizzare all'interno del messaggio.
}}
tipo
Se il parametro tipo non viene dato, il template imposta di default avviso. Si avrà quindi uno sfondo blu.
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:Sub-arrows.svg|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]]
Anything = 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.

Dettagli tecnici

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

{{Cmbox
| 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:Cmbox/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.