Wikibooks

Template:Ambox


Questo è la pagina del metatemplate {{Ambox}} ([A]rticle [m]essage [box]).

È usato come base per costruire la grafica dei template di avviso, come per esempio {{Da aiutare}}. Offre diversi colori, usa le immagini predefinite se non viene fornito alcun parametro immagine e ha alcune altre caratteristiche.

Parametri comuni

Il riquadra sottostante mostra i parametri più comuni accettati da {{Ambox}}. Lo scopo di ognuno verrà spiegato più sotto. 

{{Ambox
| nome  = 
| subst = <includeonly>{{subst:substcheck}}</includeonly>
| small = {{{small|}}}
| tipo  = 
| immagine = 
| sect  = {{{1|}}}
| problema = 
| talk  = {{{talk|}}}
| fix   = 
| data  = {{{date|}}}
| cat   = 
| all   = 
}}

nome

Il parametro nome nome specifica il nome del template, senza il prefisso del namespace "Template". Per esempio per il {{Da aiutare}} va specificato nome=Da aiutare.

Questo parametro va aggiornato se il template viene spostato ad un altro nome. Lo scopo di questo parametro è duplice:

  • Se non sostituito correttamente, consente al meta-template di notificare il nome del template che è stato sostituito, il che può Da aiutare gli utenti a risolvere il problema.
  • Consente al template di avere una visualizzazione più utile sulla sua pagina, ad esempio per mostrare la data anche se non specificata e per applicare la categorizzazione del template stesso.

subst

Il parametro subst permette al meta-template di rilevare quando il template viene substato in maniera errata e visualizza il relativo avviso. Questo permetterà inoltre di aggiungere la pagina alla categoria Pagine con template substati scorrettamente. Basta copiare il codice esattamente come appare nel riquadro.


small

Il paramentro small deve essere passato attraverso il template, questo permetterà di usare il formato piccolo specificando |small=left in un articolo:

Altrimenti verrà visualizzato il formato standard:

Altre varianti:

  • Per i modelli che non dovrebbero "mai" essere piccoli, scrivi |small=no o non passare il parametro small del tutto.
  • Per i modelli che dovrebbero "sempre" essere piccoli, basta scrivere |small=left.
  • Per i modelli che dovrebbero essere piccoli di default, prova |small=left. Ciò consentirà a un utente di sovrascriverlo utilizzando |small=no su un articolo.

Vedi , sotto, per informazioni su come limitare la visualizzazione di |small=no ai casi in cui il template viene usato per una sezione invece che per l'intero articolo (consigliato, per evitare la visualizzazione inconsistente della parte superiore dell'articolo).

tipo

Il parametro tipo definisce il colore della barra a sinistra e l'immagine che viene usata di default. Il tipo viene scelto non per motivi estetici, ma è bastato sulla tipologia di problema che il template descrive. Le sette scelte e le loro immagini sono mostrate di seguito.

Se il parametro tipo non viene specificato, il template sceglierà automaticamente tipo=avviso.

immagine

Puoi scegliere un'immagine specifica per il template usando il parametro immagine. Le immagini vanno specificate usando la sintassi standard per inserire le immagini su Wikibooks (vedi: Aiuto:Markup immagini.) solitamente immagini larghe 40-50px sono la norma. Per esempio:

  • Nel {{Da tradurre}} è specificato |image = [[File:Exquisite-kwrite.png|left|40px|Stubby]] ed appare così:

Nota:

  • Se non viene specificata l'immagine, l'immagine visualizzata sarà quella di default corrispondente al tipo usato. (Guarda #tipo sopra.)
  • Se un'immagine è puramente decorativa e di dominio pubblico, l'accessibilità può essere migliorata eliminando il collegamento alla pagina del file aggiungendo "|link |alt".
  • Se viene specificato il parametro |immagine = nessuna, non verranno visualizzate immagini e il testo utilizzerà l'intera area del messaggio. (per garantire la retrocompatibilità, i parametri |immagine = trasparente, |immagine = blank, |immagine = none). Ad esempio:
  • Per inserire una immagine a destra si compila la variabile immagineadestra indicando il nome del file e la dimensione. Come si vede, dove non viene inserita la variabile immagine il template aggiunge l'icona standard. Nell'esempio: | immaginedestra = [[File:Face-smile-big.svg|40px]]

sect

Molti avvisi nei template iniziano con il testo Questo articolo ... ed è spesso preferibile che questa formulazione cambi in Questa sezione ... il template venisse usato all'interno di una sezione. Il valore di questo parametro sostituirà la parola "articolo". Le varie possibilità per l'uso includono: |sect=lista, |sect=tabella, |sect|"Nella cultura popolare" materiale, etc.

Se vuoi usare questa funzione, assicurati di togliere le prime due parole ("Questo articolo") dal testo del template, altrimenti verranno duplicate.

Una pratica comune per semplificare questa funzione è usare |sect={{{1|}}}. Questo permetterà agli utenti di digitare sezione, per esempio, come primo parametro senza nome di un template per cambiare la dicitura. Per esempio, produce:

Un altro approccio è quello di passare |sect={{{a sezione|{{{sect|}}}}}} per fornire un valore nominale.

Si consiglia inoltre di limitare l'uso del parametro |small in modo che venga reso contingente al modello applicato a una sezione (o a qualsiasi altra cosa) anziché all'intero articolo, per evitare che la versione ridotta del modello sia utilizzata nella parte superiore dell'articolo nella quale sarebbe incoerente con altri banner di pulizia/contestazione a livello di articolo:

|small = {{#if:{{{sect|{{{a sezione|{{{1|}}}}}}}}}|{{#if:{{{small|{{{left|}}}}}}|left}}}} (In questo caso, ogni valore di |small oppure |left innescheranno lo small, visualizzazione a sinistra, finché verrà fornito anche un valore di |sect o uno dei suoi alias in quel modello.) Questo codice può essere copiato e utilizzato con il suddetto blocco di codice.

A causa della diversificazione che la lingua italiana fa con genere e numero, si rende necessario aggiungere anteponendola, la desinenza che avrebbe "questo" rapportata al termine correlato, esempi pratici:

  • |sect = o manuale
  • |sect = a appendice
  • |sect = i termini
  • |sect = e istruzioni

problema e fix

Il parametro problema è usato per descrivere il problema dell'articolo. Cerca di essere conciso (approssimativamente 10-20 parole) e assicurati di includere un link a un argomento pertinente.

Il parametro fix contiene del testo che descrive cosa dovrebbe essere fatto per migliorare l'articolo. Potrebbe essere più lungo del testo contenuto in "problema", ma di solito non dovrebbe essere più di due frasi

Quanto il template è nella forma compatta (quando viene usato |small = left), il problema è l'unico testo che verrà visualizzato. Per esempio:

  • |problema=Questo articolo ''ha uno stile di scrittura poco chiaro''.
  • |fix=Le convenzioni di stile usate nelle pagine dovrebbero essere quelle riportate nel [[Wikibooks:Manuale di stile|manuale di stile]].
Versione estesa, con i tre parametri visibili
Versione ridotta con solo il parametro "problema" visibile, nonostante anche "fix" sia dichiarato come sopra

talk

Molti template includono un link alla pagina di discussione, e permettono ad un utente di specificare un'intestazione da visualizzare con un link diretto alla sezione pertinente. Per aggiungere questa possibilità basta passare attraverso il parametro talk, per esempio |talk = {{{talk|}}}

Questo parametro può essere usato da un utente nei seguenti modi:

  • |talk = SECTION HEADING - il link punterà alla sezione specifica nella discussione dell'articolo, esempio |talk = Foo
  • |talk = FULL PAGE NAME - il template linkerà alla pagina specificata (che può includere un'ancora di sezione), esempio |talk|discussioni:banana#Foo

Nota:

  • Quando questo parametro viene usato da un template, il link alla pagina di discussione apparirà nel template stesso (per dimostrarne la funzionalità) ma questo verrà mostrato solo sugli articoli se il parametro è effettivamente definito.
  • Per assicurarti che ci sia sempre un link alla pagina di discussione, puoi usare |talk = {{{talk|#}}}.
  • Se la pagina di discussione non esiste, non apparirà nessun link, qualsiasi sia il valore del parametro che viene passato.

data

Passando il parametro data al meta-template è possibile specificare la data in cui un utente (o più comunemente un bot) ha apposto l'avviso nella pagina. Questa verrà visualizzata dopo il messaggio in un font più piccolo.

Questo parametro abilita anche categorizzazione pulizia mensile quando viene definito anche il parametro cat.

info

Questo parametro è usato per specificare informazioni aggiuntive. Qualsiasi cosa tu aggiunga qui apparirà dopo la data.

noteRimozione

Se specifichi il |noteRimozione = yes, dopo la data e dopo info verrà visualizzato il messaggio seguente:

cat

Questo parametro definisce una categoria di lavoro sporco mensile. Se |cat = CATEGORY allora:

  • gli articoli saranno inseriti nella Categoria:CATEGORY from DATE se |date = DATE è specificato.
  • gli articoli saranno inseriti nella Categoria:CATEGORY se la dat non è stata specificata.

Il parametro cat non dovrebbe essere scritto sotto forma di link, né avere il prefisso Categoria:.

all

Il parametro all definisce una categoria entro cui tutti gli articoli devono essere inseriti.

Il parametro all non dovrebbe essere scritto sotto forma di link, né avere il prefisso Categoria:.

Tutti i parametri

Il box "Tutti i parametri" mostra tutte i possibili parametri per questo template. Tuttavia, non è consigliabile copiarlo perché non sarà mai necessario utilizzare tutti i parametri contemporaneamente.

Tutti i parametri 

{{Ambox
| nome			= 
| subst			= <includeonly>{{subst:substcheck}}</includeonly>
| small			= {{{small|}}}
| tipo			= 
| immagine		= 
| immaginedestra	= 
| immaginepiccola	= 
| immaginepiccoladestra	= 
| class			= 
| stile			= 
| stiletesto		= 
| sect			= {{{1|}}}
| problema		= 
| talk			= {{{talk|}}}
| fix			= 
| data			= {{{date|}}}
| testo			= 
| testopiccolo		= 
| plainlinks		= no
}}<noinclude>
{{Man}}
</noinclude>

immaginedestra

È possibile visualizzare un'immagine sul lato destro del messaggio usando questo parametro. La sintassi è la stessa del parametro immagine, tranne per il fatto che l'impostazione predefinita è "nessuna immagine".

immaginepiccola e immaginepiccoladestra

Le immagini per il template di formato ridotto possono essere specificate utilizzando questi parametri. Questi non avrnno effetto se il parametro |small = left non è specificato.

class

Una classe CSS personalizzata da applicare al messaggio.

stile and stiletesto

Un valore CSS opzionale che può essere definito, senza le virgolette " " ma con il punto e virgola finale ; .

  • stile specifica lo stile utilizzato dall'intera tabella della casella di messaggio.
  • stiletesto si riferisce alla cella di testo.

testo and testopiccolo

Invece di specificare "problema" e "fix", è possibile utilizzare il parametro "testo". Il testo personalizzato per il piccolo formato può essere definito usando "testo piccolo".

Solitamente su Wikizioanrio, i link esterni hanno l'icona di una freccia, come questo Example.com. Tuttavia, nei box dei messaggi, l'icona della freccia è soppressa come impostazione predefinita, come questo Example.com.

Per visualizzare il normale stile dei link esterni con l'icona della freccia, usa |plainlinks = no.

cat2, cat3, all2, and all3

  • cat2 e cat3 prevedere categorie mensili aggiuntive; si veda #cat.
  • all2 e all3 fornire ulteriori categorie in cui sono collocati tutti gli articoli, proprio come #all.

Note tecniche

  • Se intendi usare caratteri speciale nel parametro del testo, devi ovviare in questo modo:
{{Ambox
| testo  = <div>
Il segno uguale = e le parentesi graffe, sia aperte che chiuse { }  funzionano bene così come sono.
Ma ecco un pipe &#124; e due parentesi graffe chiuse <nowiki>}}</nowiki>.
Ed ora un pipe e due parentesi graffe chiuse <nowiki>|}}</nowiki>.
</div>
}}
  • Il tag <div> che circonda il testo nell'esempio sopra solitamente non è necessario. Ma se il testo contiene interruzioni di riga, a volte otteniamo una spaziatura di linea strana. Ciò si verifica in particolare quando si utilizzano elenchi puntati verticali. Quindi usa i tag div per risolverlo.
  • Questo template usa classi CSS contenute nella sottopagina Template:Ambox/styles.css (oltre che in Template:Mbox/common.css per la parte comune ai template "box" e in MediaWiki:Common.css per la parte relativa allo stile compatto), quindi è totalmente personabilizzabile
  • Questo template richiama Modulo:Message box che contiene la maggior parte del codice per {{Ambox}}, mentre {{Ambox}} esegue la pre-elaborazione dei parametri.
  • Internamente, questo meta-template utilizza markup HTML invece di wikimarkup per il codice tabella. Questo è il modo in cui di solito vengono creati i meta-template, dal momento che il wikimarkup presenta diversi inconvenienti. Ad esempio, rende più difficile usare funzioni parser (vedi pagina aggiornata su mediawiki.org) e alcuni caratteri speciali nei parametri.
  • Le immagini predefinite in questo meta-template sono in formato png invece che svg. La ragione principale è che alcuni web browser più datati hanno difficoltà con lo sfondo trasparente del render che MediaWiki usa per le immagini svg. Le immagini png qui hanno il colore di sfondo trasparente ottimizzato in modo che siano gradevoli in tutti i browser. Nota che le icone svg hanno un aspetto un po' brutto nei vecchi browser, quindi il problema dell'ottimizzazione vale solo per le icone molto usate.
  • Per maggiori dettagli tecnici guarda la pagina di discussione e i link "vedi anche" scritti sotto. Dal momento che questo modello funziona quasi esattamente come {{Tmbox}}, {{Imbox}}, {{Cmbox}} e {{Ombox}} le loro pagine di discussione e pagine correlate potrebbero contenere anche maggiori dettagli.

Vedi anche

Ci sono sette metatemplates nella famiglia del Modulo:Message box:

  • {{Ambox}}, per gli avvisi nelle pagine dei moduli.
  • {{Cmbox}}, per gli avvisi nelle pagine delle categorie.
  • {{Imbox}}, per gli avvisi nelle pagine dei file (immagini).
  • {{Tmbox}}, per gli avvisi nelle pagine di discussione.
  • {{Fmbox}}, per gli avvisi in cima e in fondo alla pagina.
  • {{Ombox}}, per gli avvisi negli altri tipi di pagine.
  • {{Mbox}}, per gli avvisi che vengono usati in namespace diversi e devono cambiare stile di conseguenza.

Altre pagine su wikipedia in lingua inglese

Estratto da "https://it.wikibooks.org/w/index.php?title=Template:Ambox&oldid=347880"