Disambiguazione – Se stai cercando l'indice dell'aiuto di Wikipedia, vedi Aiuto:Manuale.
Abbreviazioni
Aiuto:TOC
WP:TOC

Il software MediaWiki genera automaticamente un indice (in inglese table of contents, abbreviato in TOC) per tutte le pagine che contengono almeno quattro sezioni. Ciascun elemento dell'indice fornisce inoltre un collegamento cliccabile che rimanda alla sezione cui si riferisce. Per tornare all'indice dopo averlo cliccato, puoi usare il pulsante "freccia indietro" del tuo browser.

Normalmente dovresti vedere un tipico indice proprio sotto questa frase.

Indice standard

modifica

L'indice standard, costituito dai titoli di tutte le sezioni della pagina, compare normalmente alla fine della sezione introduttiva (l'incipit), subito prima della prima intestazione di sezione, allineato sulla sinistra.

L'indice non compare nei seguenti casi:

  • se nella pagina ci sono meno di 4 sezioni, di qualunque livello;
  • se la pagina contiene in qualunque punto del testo la direttiva __NOTOC__.

Viceversa, si può forzare la presenza dell'indice anche sulle pagine che hanno meno di quattro titoli di sezione (ad esempio quando sono comunque molto lunghe) inserendo in un qualunque punto del testo il comando __FORCETOC__ o __TOC__; nel primo caso, l'indice appare nella posizione standard immediatamente prima del primo titolo di sezione, mentre nel secondo viene inserito nel punto in cui il comando è stato posizionato (se è stato inserito erroneamente più volte, apparirà in corrispondenza del __TOC__ più vicino alla cima della pagina, cioè quello più in alto). Il comando __TOC__ può essere usato anche nelle pagine con più di tre titoli di sezione: l'indice apparirà in questa maniera non più nella posizione standard, cioè subito prima della sezione iniziale, ma nel punto in cui si trova il comando (per gli inserimenti multipli vale la stessa regola di prima).

Note
  • I caratteri di sottolineatura "_" (underscore) all'inizio e alla fine dei comandi __FORCETOC__ e __TOC__ sono due.
  • 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 quel template è richiamato.

Indice standard in altre posizioni

modifica

Con l'uso di __TOC__ l'indice può essere riposizionato a piacimento, ma nelle voci dell'enciclopedia è bene farlo solo in caso di necessità dovute a una particolare struttura della pagina. Normalmente il lettore dovrebbe trovare l'indice nella sua posizione consueta.

Esiste un meccanismo predefinito per inserire l'indice in un riquadro sul lato destro della pagina. Questo potrebbe essere appropriato nelle voci di tipo "glossario", che hanno un gran numero di sezioni molto brevi. Grazie al Template:TOCright è sufficiente inserire nel punto desiderato il testo:

{{TOCright}}

Toc left invece fa apparire l'indice a sinistra ma affiancato al testo, anziché in fondo.

{{TOCleft}}

Comportamento dei template divisi in sezioni

modifica

In una pagina che richiama un template dotato di più sezioni, le sezioni del template 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. Anche i template divisi in sezioni hanno a volte un testo che precede la prima sezione (analogo agli incipit delle voci del namespace 0): questo testo, nel caso si richiami il template in una pagina, viene inserito nella specifica sezione di tale pagina in cui viene richiamato il template stesso; il testo che segue il template e precede il titolo di sezione successiva nella pagina principale confluisce invece nell'ultima sezione del template. Questo comportamento può essere voluto, ma di solito è meglio evitarlo.

Numerazione delle voci dell'indice

modifica

È possibile impostare le proprie preferenze personali, attivando "Numerazione automatica dei titoli di sezione", 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 {{Indice}} è sufficiente inserire nella pagina il testo:

{{Indice|numeri=no}}

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.

Indice nascosto

modifica

È infine possibile (non nelle voci) nascondere l'indice utilizzando il template {{TOChidden}}. Cliccando su espandi, lo si ripristina.

L'uso dei cassetti è fortemente sconsigliato nelle voci[1] e questi template non vanno utilizzati nel namespace principale (nemmeno nel caso di voci molto lunghe).[2][3]