Template:Nb

Da Cathopedia, l'enciclopedia cattolica.
Avviso importante! Questo template ha un codice sorgente piuttosto complesso e può richiedere buona conoscenza delle funzioni parser.

Per favore, non tentare di modificarlo se non sei certo di capirne la funzione e se non sei preparato a riparare ogni conseguente danno collaterale nel caso in cui i risultati fossero diversi da quanto avevi in mente. Tutti gli esperimenti devono essere prima condotti in una pagina di prova.

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

Il template {{Nb}} consente di visualizzare un template di navigazione in maniera uniforme e relativamente semplice e rapida. Si può utilizzare insieme col template {{Nb subgroup}}

Caratteristiche

Il Nb genera una tabella con le seguenti classi:

  • Nb - definita in MediaWiki:Common.css, imposta l'aspetto grafico standard.
  • mw-collapsible - la tabella è un "cassetto" a scomparsa; di default è inizialmente aperto se è l'unico Nb della pagina o inizialmente chiuso se ce ne sono altri. Per cambiare la condizione iniziale vedi il parametro state sotto.
  • nowraplinks - i wikilink contenuti non vanno a capo se possibile, ad es. [[Mario Rossi]] non andrà mai a capo dopo "Mario".
  • noprint - il Nb sparisce nella stampa, come è giusto che sia per ogni template di navigazione.
  • metadata - il Nb è etichettato come contenuto non enciclopedico e in particolare sparisce nella versione mobile.

Inoltre, normalmente contiene sempre una {{Tnavbar}} mini.

Uso

La sintassi deve essere copiata nella pagina del template che si vuole creare. Per favore, rimuovi i parametri non compilati.

Sintassi semplice

{{Nb
| name    = {{subst:PAGENAME}}
| state   = <!-- "collapsed" se si vuole che il template sia chiuso all'inizio -->
| title   = 

| group1  = 
| list1   = 

| group2  = 
| list2   = 

...

| group20 = 
| list20  = 
}}

Sintassi completa

{{Nb
| name       = {{subst:PAGENAME}}
| navbar     = 
| state      = 
| titlestyle = 
| title      = 
| image      = 
| bodystyle  = <!-- (o "style =" se non sono stati utilizzati altri parametri di stile -->
| groupstyle = 
| liststyle  = 
| oddstyle   = 
| evenstyle  = 
| fontelink  = 

| abovestyle = 
| above      = 

| group1     = 
| list1      = 

| group2     = 
| list2      = 

 ...

| group20    = 
| list20     = 

| belowstyle = 
| below      = 
}}

Parametri

Obbligatori

name
Il nome del template che si vuole creare, necessario perché funzionino i link "v · d · m" ("vedi · discuti · modifica") in tutte le pagine dove il template è usato. Con {{subst:PAGENAME}} il parametro si compila automaticamente.
title
È il testo che appare al centro della barra del titolo del template. Indica usualmente l'argomento del template, ad esempio una didascalica descrizione di ciò che contiene il corpo del template. Dovrebbe essere di una sola riga, ma se è necessaria una seconda riga, si può utilizzare {{-}} in modo tale da inserire centralmente anche questa seconda riga.
Il colore di sfondo di default è #ccf (forma abbreviata di #ccccff), ma può essere cambiato usando il parametro titlestyle (vedi sotto).
listn
(ad esempio list1, list2 ecc.) Questi parametri riempiono il corpo del template, che usualmente sarà una lista di wikilink. Per dividere gli elementi della lista si consiglia di usare {{Dot}}, il quale genera un punto (Tizio · Caio). Se si dovessero usare altri separatori, per motivi tecnici bisogna evitare di andare a capo.
È obbligatorio compilare almeno un parametro list; ogni list addizionale viene visualizzato in una riga separata della tabella. Ogni listn è preceduto dal corrispondente parametro groupn, se fornito, che funge da etichetta per tutta la lista. L'allineamento della lista è di default al centro se isolata, a sinistra se accompagnata dal relativo groupn.
Di default, il background delle righe è alternato per facilitare la lettura: la prima riga (corrispondente a list1) avrà lo sfondo bianco; la seconda riga (corrispondente a list2) avrà lo sfondo #f9f9f9; la terza riga sarà di nuovo bianca e così via.

Opzionali

Celle

groupn
(ad esempio group1, group2 ecc.) Se specificati, il testo appare in una cella alla sinistra del relativo listn. Se non specificati, listn occupa l'intera larghezza della tabella.
Se è specificato solo groupn senza listn, il gruppo diventa un titolo di sezione e occupa l'intera larghezza della tabella.
Il colore di sfondo di default è #ddf (forma abbreviata di #ddddff), ma può essere cambiato usando il parametro groupstyle (vedi sotto).
image
Un'immagine viene visualizzata in una cella al di sotto del titolo e alla destra della parte di tabella che comprende i groups/lists. Affinché l'immagine sia visualizzata correttamente, il parametro list1 deve essere specificato. Il parametro image accetta il normale markup delle immagini di Wikipedia, ad esempio
[[Immagine:Esempio.jpg|100px]]
In un template dove la parte groups e/o list non occupa la tabella fino in fondo a destra, l'immagine risulterà spostata verso sinistra. Questo può essere evitato specificando right nel markup dell'immagine, ad esempio
[[Immagine:Esempio.jpg|80px|right]]
imagestyle
Gli stili CSS da applicare al parametro image, usualmente per metterla fra un riquadro o cambiare il colore di sfondo:
imagestyle = background-color:#FFFFFF
imagestyle = border:2px solid#F0D060;
above
Una cella larga come tutta la tabella verrà visualizzata tra la barra del titolo e il primo group/list, in pratica sopra la parte di tabella occupata da group, list e image. In un template senza immagine, above svolge la stessa funzione del parametro list1 senza il relativo parametro group1.
below
Una cella larga come tutta la tabella verrà visualizzata al di sotto della parte di tabella occupata da group, list e image. In un template senza immagine, below svolge la stessa funzione del parametro listn finale.

Stili

titlestyle
Gli stili CSS da applicare al parametro title, usualmente per cambiare il colore di sfondo:
titlestyle = background:#nnnnnn;
titlestyle = background:nome del colore;
bodystyle o style
Specifica gli stili CSS da applicare al corpo del template. Il nome breve style può essere usato quando nessun altro parametro di stile è stato specificato. Questa opzione dovrebbe essere usata con cautela perché potrebbe causare problemi di visualizzazione. Esempi:
background:#nnnnnn;
width:N [em/%/px];
float:[left/right/none];
clear:[right/left/both/none];
groupstyle
Stili CSS da applicare a tutte le celle groupN. Esempi:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
groupnstyle
Stili CSS da applicare ad una singola cella groupN. Esempi:
background:#nnnnnn;
color:#nnnnnn;
liststyle
Stili CSS da applicare a tutte le celle listN. Esempi:
background:#nnnnnn;
text-align:[left/center/right];
vertical-align:[top/middle/bottom];
white-space:nowrap;
listnstyle
Stili CSS da applicare ad una singola cella listN. Esempi:
background:#nnnnnn;
color:#nnnnnn;
oddstyle
evenstyle
Stili CSS da applicare a singole celle di liste dispari (oddstyle) (list1, list3 ecc.) o pari (evenstyle) (list2, list4 ecc). Di default, viene applicato un colore di sfondo alternato bianco/grigio tra le varie liste per rendere più facile la consultazione.
abovestyle
belowstyle
Stili CSS da applicare a celle opzionali al di sopra o al di sotto della tabella (vedi parametri above e below). Tipicamente si utilizza per cambiare allineamento del testo o colore di sfondo:
background:#nnnnnn;
text-align:[left/center/right];
Stili alternativi

Gli stili seguenti sono quelli che chi utilizza il Nb cambia più spesso.

titlestyle = background:#ccccff;
bodystyle = background:white; width:100%; vertical-align:middle;
groupstyle = background:#ddddff; text-align:center;
liststyle = background:transparent; text-align:center;
oddstyle = background:transparent;
evenstyle = background:#f7f7f7;
abovestyle = background:#ddddff; text-align:center;
belowstyle = background:#ddddff; text-align:center;

Altri

state
Il default è autocollapse. Un Nb con autocollapse inizierà chiuso solo se c'è almeno un altro Nb nella stessa pagina (o altri template che usano la class collapsible). Altrimenti, al momento dell'apertura della pagina il Nb verrà visualizzato aperto.
Se si inserisce collapsed, inizierà sempre chiuso, eccetto che nella pagina di descrizione del template.
Se si inserisce un altro valore qualunque, diverso da "collapsed" e "autocollapse" (che è già il default), inizierà sempre aperto.
navbar
Ha un unico valore accettato: plain, che disabilita la visualizzazione della Tnavbar, ossia i link "v · d · m" posti sulla sinistra della barra del titolo.
fontelink
Eventuale indirizzo a un sito esterno attendibile, per verificare che l'insieme dei link utilizzato dal Nb sia completo. Per esempio per verificare la rosa di una società sportiva. Genererà il link "Fonte per l'aggiornamento" sotto al "Controllo inclusione del template" e anch'esso visibile solo nel namespace Template.

Disposizione

{{Nb}} senza immagine e senza i parametri above e below (i bordi sono presenti solo a fini illustrativi):

{{Nb}} con immagine, con una sezione e con i parametri above e below (i bordi sono presenti solo a fini illustrativi):



Poni il mouse qui sopra per vedere i contributori di questa voce.