Aiuto:Indici: differenze tra le versioni

Contenuto cancellato Contenuto aggiunto
IPork (discussione | contributi)
m Lavori in corso sulla pagina
IPork (discussione | contributi)
m Aggiornata pagina di aiuto
Riga 1:
{{WIP|iPork}}
 
{{TOCright Aiuto}}
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 ==
Se la pagina contiene più di tre titoli, l'indice standard compare <u>automaticamente</u> alla fine della sezione introduttiva (''incipit'') della voce, subito prima della prima intestazione di sezione.
[[Image:Aiuto indice standard.png|frame|none|L'indice standard. Ci sono 4 sezioni e compare automaticamente sotto l'incipit della pagina.]]
 
=== Indice standard a destra ===
Per inserire l'indice in un riquadro sul lato destro della pagina si utilizza il template {{Tl|TOCright}} inserendo nel testo il seguente codice:
 
{{Ambox
| tipo = stile
| immagine = nessuna
| testo =
<nowiki>{{TOCright}}</nowiki>
}}
 
[[Image:Aiuto indice standard a destra.png|frame|none|L'indice standard a destra. L'indice compare dove viene inserito il template, in questo caso all'inizio della pagina.]]
L'indice non compare nei seguenti casi:
* se l'utente ha scelto di disattivare la visualizzazione degli indici nelle proprie [[aiuto:Preferenze/Varie|preferenze]]
* se la pagina contiene in qualunque punto del testo il comando <tt><nowiki>__NOTOC__</nowiki></tt>
 
=== Indice standard a sinistra ===
Viceversa, si può forzare la presenza del'indice anche sulle pagine che hanno meno di 4 titoli di sezione:
Per inserire l'indice in un riquadro sul lato destro della pagina si utilizza il template {{Tl|TOCleft}} inserendo nel testo il seguente codice:
 
{{Ambox
* se la pagina contiene in qualunque punto del testo il comando <tt><nowiki>__FORCETOC__</nowiki></tt>; in questo caso l'indice appare immediatamente prima del primo titolo di sezione
| tipo = stile
* se la pagina contiene (anche più volte) il comando <tt><nowiki>__TOC__</nowiki></tt>; in questo caso l'indice viene inserito in ciascun punto in cui si trova il comando.
| immagine = nessuna
| testo =
<nowiki>{{TOCleft}}</nowiki>
}}
 
[[Image:Aiuto indice standard a sinistra.png|frame|none|L'indice standard a sinistra. L'indice compare dove viene inserito il template, in questo caso all'inizio della pagina.]]
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.
 
=== Indice standard per le pagine di aiuto ===
'''Nota:''' i caratteri di sottolineatura "_" (''underscore'') all'inizio e alla fine dei comandi sono due.
Per inserire l'indice nelle pagine di aiuto (come questa) si utilizza il template {{Tl|TOCright Aiuto}} inserendo nel testo il seguente codice:
 
{{Ambox
===Indice standard a destra===
| tipo = stile
| immagine = nessuna
| testo =
<nowiki>{{TOCright Aiuto}}</nowiki>
}}
 
== Indice compatto ==
{{TOCright}}
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.
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:
 
In questo caso si utilizza il template {{Tl|CompactTOC}} inserendo nel testo il seguente codice:
:<tt><nowiki>{{TOCright}}</nowiki></tt>
 
{{Ambox
per ottenere un risultato simile a quello visualizzato qui a destra.
| tipo = stile
| immagine = nessuna
| testo =
<nowiki>{{CompactTOC}}</nowiki>
}}
 
[[Image:Aiuto indice compatto.png|frame|none|L'indice compatto. L'indice compare dove viene inserito il template, in questo caso sotto l'incipit della pagina.]]
==Numerazione delle voci dell'indice==
 
== Come posizionare l'indice dove si vuole ==
È possibile impostare le proprie preferenze personali in modo che le sezioni vengano numerate automaticamente, secondo lo schema seguente:
Volendo posizionare l'indice in un posto diverso da quello standard (subito sotto l'incipit della pagina) si utilizza il comando <tt><nowiki>__TOC__</nowiki></tt> inserendo nel testo il seguente codice:
 
{{Ambox
| tipo = stile
| immagine = nessuna
| testo =
<nowiki>__TOC__</nowiki>
}}
 
[[Image:Aiuto indice toc.png|frame|none|Come si vede l'indice compare subito sotto la seconda sezione dove è stato inserito il codice <tt><nowiki>__TOC__</nowiki></tt>.]]
 
== Come non far comparire l'indice ==
Può risultare comodo non far apparire l'indice. In questo caso si utilizza il comando <tt><nowiki>__NOTOC__</nowiki></tt> inserendo nel testo il seguente codice:
 
{{Ambox
| tipo = stile
| immagine = nessuna
| testo =
<nowiki>__NOTOC__</nowiki>
}}
 
[[Image:Aiuto indice notoc.png|frame|none|Come si vede, nonostante nella pagina ci siano 4 sezioni, l'indice non compare. È stato inserito il codice <tt><nowiki>__NOTOC__</nowiki></tt>.]]
 
Inoltre è possibile disattivare la visualizzazione degli indici nelle proprie [[Aiuto:Preferenze/Varie|preferenze]].
 
== Come forzare la presenza dell'indice ==
In alcuni casi è utile mostrare l'indice anche se la pagina ha meno di quattro sezioni. In questo caso si utilizza il comando <tt><nowiki>__FORCETOC__</nowiki></tt> inserendo nel testo il seguente codice:
 
{{Ambox
| tipo = stile
| immagine = nessuna
| testo =
<nowiki>__FORCETOC__</nowiki>
}}
 
[[Image:Aiuto indice forcetoc.png|frame|none|Come si vede, nonostante nella pagina ci siano 2 sezioni, l'indice compare. È stato inserito il codice <tt><nowiki> __FORCETOC__ </nowiki></tt>.]]
 
== Numerazione delle voci dell'indice ==
È possibile impostare le proprie [[Aiuto:Preferenze/Varie|preferenze]] personali in modo che le sezioni vengano numerate automaticamente, secondo lo schema seguente:
 
{| {{prettytable}}
Line 50 ⟶ 110:
|-
|}
<!-- Che significa?!?!
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. -->
 
== Domande? ==
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.
Se hai domande, dubbi, proposte o necessiti di chiarimenti sugli ''indici'' <span class="plainlinks">[http://it.wikisource.org/w/index.php?title=Discussioni_aiuto:Indice&action=edit&section=new premi qui] e lascia un messaggio nella pagina di discussione.</span>
 
==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 [[:Template:CompactTOC]] è sufficiente inserire nella pagina il testo:
 
:<tt><nowiki>{{compactTOC}}</nowiki></tt>
 
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 collegamenti alle sezioni.
 
[[Categoria:Aiuto|{{PAGENAME}}]]
[[Categoria:Pagine di aiuto con immagini|{{PAGENAME}}]]