Aiuto:Indice
 – Bar di Wikiversità
|
Il software MediaWiki genera un indice (in inglese table of contents, abbreviato TOC) per tutte le pagine che contengono più di tre titoli di sezione.
Indice standard
[modifica]L'indice standard, costituito dai titoli di tutte le suddivisioni della pagina (eventuamente preceduti da un numero), compare alla fine della sezione introduttiva (incipit) della voce, subito prima della prima intestazione di sezione.
L'indice non compare nei seguenti casi:
- se l'utente ha scelto di disattivare la visualizzazione degli indici nelle proprie preferenze
- se la pagina contiene in qualunque punto del testo il comando
__NOTOC__
Viceversa, si può forzare la presenza dell'indice anche sulle pagine che hanno meno di 4 titoli di sezione:
- se la pagina contiene in qualunque punto del testo il comando
__FORCETOC__; in questo caso l'indice appare immediatamente prima del primo titolo di sezione - se la pagina contiene (anche più volte) il comando
__TOC__; in questo caso l'indice viene inserito in ciascun punto in cui si trova il comando.
Con quest'ultimo accorgimento si può evitare, ad esempio, di inserire una intestazione inutile solo per far sì che l'indice si trovi posizionato abbastanza in alto in una voce con incipit particolarmente lungo.
Nota: i caratteri di sottolineatura "_" (underscore) all'inizio e alla fine dei comandi sono due.
Attenzione!: i comandi sopra descritti funzionano ugualmente se sono presenti in uno dei template inclusi nella pagina. In altre parole: includere uno dei comandi in un template comporta l'applicazione del comando a tutte le pagine in cui è richiamato il template.
Indice standard a destra
[modifica]Esiste un meccanismo predefinito per inserire l'indice in un riquadro sul lato destro della pagina. Grazie al Template:TOCright è sufficiente inserire nel punto desiderato il testo:
{{TOCright}}
per ottenere un risultato simile a quello visualizzato qui a destra.
{{TOCleft}}
Toc left invece fa apparire l'indice a sinistra ma affiancato al testo, anziché in fondo.
Numerazione delle voci dell'indice
[modifica]È possibile impostare le proprie preferenze personali in modo che le sezioni vengano numerate automaticamente, secondo lo schema seguente:
| Divisione della pagina | Livello | Numerazione nell'indice |
|---|---|---|
| Titolo di sezione | 1 | 1 |
| Titolo di sottosezione | 2 | 1.1 |
| Titolo di sotto-sottosezione | 3 | 1.1.1 |
| Suddivisione di 4° livello | 4 | 1.1.1.1 |
| Suddivisione di 5° livello | 5 | 1.1.1.1.1 |
In una pagina che richiama un template dotato di più sezioni, le sezioni di quest'ultimo vengono numerate in base alla posizione nella pagina in cui sono incluse; ad esempio, se il richiamo al template avviene nella terza sezione, la prima sezione del template è indicata dal numero 4. Il testo del template che precede la sua prima sezione viene inserito nella sezione della pagina in cui viene richiamato il template stesso; il testo che segue il template e precede il titolo di sezione successiva nella pagina richiamante confluisce invece nell'ultima sezione del template.
Indice compatto
[modifica]Quando si hanno un gran numero di intestazioni di sezione piuttosto corte, ad esempio le lettere dell'alfabeto, l'indice può diventare lungo e ingestibile. Per gestire queste situazioni è stata realizzata una presentazione alternativa, chiamata indice compatto, adatta anche a essere inserita più volte nel corpo di una voce molto lunga, come ausilio per la navigazione.
Grazie al Template:CompactTOC è sufficiente inserire nella pagina il testo:
{{compactTOC}}
per ottenere un risultato simile a questo:
Indice: Inizio - 0-9 A B C D E F G H I J K L M N O P Q R S T U V W X Y Z
Si può fare la stessa cosa nel caso di liste di anni, decenni, e simili:
Inizio - 1900 - 1910 - 1920 - 1930 - 1940 - 1950 - 1960 - 1970 - 1980 - 1990 - 2000
In entrambi i casi gli esempi sopra riportati fanno uso dei collegamenti alle sezioni.