Visualizza wikitesto di Aiuto:Indice

{{Nota disambigua|l'indice dell'[[aiuto:aiuto|aiuto]] di Wikipedia|[[Aiuto:Manuale]]}}
Il software MediaWiki genera automaticamente un '''indice''' (in inglese '''table of contents''', abbreviato in '''TOC''') per tutte le pagine che contengono almeno quattro [[Aiuto:Sezioni|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.
{{TOC Aiuto|clear}}

==Indice standard==
L'indice standard, costituito dai titoli di tutte le sezioni della pagina, compare normalmente alla fine della sezione introduttiva (l'[[Aiuto:Incipit|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 [[aiuto:sezione|sezioni]], di qualunque livello;
* se la pagina contiene in qualunque punto del testo la [[aiuto:direttive|direttiva]] <code><nowiki>__NOTOC__</nowiki></code>.

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 [[aiuto:direttive|comando]] <code><nowiki>__FORCETOC__</nowiki></code> o <code><nowiki>__TOC__</nowiki></code>; 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 <code><nowiki>__TOC__</nowiki></code> più vicino alla cima della pagina, cioè quello più in alto).
Il comando <code><nowiki>__TOC__</nowiki></code> 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 <code><nowiki>__FORCETOC__</nowiki></code> e <code><nowiki>__TOC__</nowiki></code> sono due.

* I comandi sopra descritti funzionano ugualmente se sono presenti in uno dei [[Aiuto:Template|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===
Con l'uso di <code><nowiki>__TOC__</nowiki></code> l'indice può essere riposizionato a piacimento, ma nelle [[Aiuto:Voce|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:

:<code>{{tl|TOCright}}</code>

Toc left invece fa apparire l'indice a sinistra ma affiancato al testo, anziché in fondo.
:<code>{{tl|TOCleft}}</code>

===Comportamento dei template divisi in sezioni===
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 [[Aiuto:namespace|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==
È possibile impostare le proprie [[Speciale:Preferenze#mw-prefsection-rendering|preferenze]] personali, attivando "Numerazione automatica dei titoli di sezione", in modo che le sezioni vengano numerate automaticamente, secondo lo schema seguente:

{| class="wikitable" 
|-
!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 [[Aiuto:Template|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==
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 [[Aiuto:Template|template]] {{tl|Indice}} è sufficiente inserire nella pagina il testo:

:<code><nowiki>{{Indice|numeri=no}}</nowiki></code>

per ottenere un risultato simile a questo:

'''Indice:''' [[#Top|Inizio]] - [[#0-9|0-9]] [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]] [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]

Si può fare la stessa cosa nel caso di liste di anni, decenni, e simili:

[[#Top|Inizio]] - [[#1900|1900]] - [[#1910|1910]] - [[#1920|1920]] - [[#1930|1930]] - [[#1940|1940]] - [[#1950|1950]] - [[#1960|1960]] - [[#1970|1970]] - [[#1980|1980]] - [[#1990|1990]] - [[#2000|2000]]

In entrambi i casi gli esempi sopra riportati fanno uso dei [[Aiuto:Wikilink#Wikilink diretti a sezioni e sottosezioni|collegamenti alle sezioni]].

==Indice nascosto==
È infine possibile (non nelle voci) nascondere l'indice utilizzando il template {{tl|TOChidden}}. Cliccando su <code>espandi</code>, lo si ripristina.

L'uso dei cassetti è fortemente sconsigliato nelle voci<ref>[[Discussioni_aiuto:Manuale_di_stile/Archivio/3#Non_usare_i_cassetti_nelle_voci]]</ref> e questi template non vanno utilizzati nel [[Aiuto:Namespace|namespace]] principale (nemmeno nel caso di voci molto lunghe).<ref>[[Discussioni_template:TOChidden]]</ref><ref>[[Discussioni_progetto:Coordinamento/Template#TOChidden]]</ref>

== Note ==
<references/>

[[Categoria:Aiuto gestione pagine]]
[[Categoria:Scrittura delle voci]]

[[en:Wikipedia:Section#Table_of_contents_.28TOC.29]]