Aiuto:Indice: differenze tra le versioni

Wikibooks, manuali e libri di testo liberi.
Contenuto cancellato Contenuto aggiunto
Diablo (discussione | contributi)
Diablo (discussione | contributi)
Riga 86: Riga 86:
=== Indice verticale ===
=== Indice verticale ===


Se volete realizzare un indice di navigazione verticale, e non avete voglia o non sapete come fare a crearne uno personalizzato, basta copiare il contenuto di questo template: {{fullurl:Template:Sommario V|edit}} e incollarlo nel template che desideriamo, ad esempio, {{fullurl:Template:Corso di turco}.
Se volete realizzare un indice di navigazione verticale, e non avete voglia o non sapete come fare a crearne uno personalizzato, basta copiare il contenuto di questo template: {{fullurl:Template:Sommario V|edit}} e incollarlo nel template che desideriamo, ad esempio, {{fullurl:Template:Corso di turco}}.


È stato creato un template con il nome di {{Corso di turco}}, che è possibile mettere all'inizio di ogni capitolo, per ottenere il proprio indice di navigazione; tuttavia otterrete un insoddisfacente:
È stato creato un template con il nome di {{Corso di turco}}, che è possibile mettere all'inizio di ogni capitolo, per ottenere il proprio indice di navigazione; tuttavia otterrete un insoddisfacente:
Riga 98: Riga 98:


'''Attenzione''': è presente un altro parametro {{{titolo}}}, in basso. Se esistente, inserire il nome della categoria del wikibook, altrimenti cancellare questa riga: [[Categoria:{{{titolo}}}]]
'''Attenzione''': è presente un altro parametro {{{titolo}}}, in basso. Se esistente, inserire il nome della categoria del wikibook, altrimenti cancellare questa riga: [[Categoria:{{{titolo}}}]]

=== Indice orizzontale ===
=== Indice orizzontale ===



Versione delle 13:06, 20 ago 2006

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

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.

Indice standard a destra

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.

Numerazione delle voci dell'indice

È 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

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}}

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 di navigazione

Per indice di navigazione s'intende un template che, posto all'interno di ogni capitolo di un wikibook, permette di navigare facilmente in ogni sua sezione, ad esempio, andando da Capitolo I a Capitolo V con un semplice click.

La sua realizzazione potrebbe risultare complicata, tuttavia è consigliabile cimnetarsi nel farlo perchè aumenta notevolmente la qualità di un wikibook.

Come fare?

Per approfondire, vedi Aiuto:Template.

In questa sezione, verrà spiegato come realizzare un indice di navigazione, senza conoscere a fondo il markup wiki. Per far capire al software che la pagina che stiamo andando a creare sia un template, bisognerà servirsi del namespace Template:. Ad esempio, il seguente indirizzo: //it.wikibooks.org/wiki/Template:Nuovo_template, creerà un template con il nome Nuovo Template. Per chiamare il template, per esempio, Corso di inglese è sufficiente scrivere Corso di inglese al posto di Nuovo template, in questo modo: //it.wikibooks.org/wiki/Template:Corso_di_inglese.

Una volta creato il template, è sufficiente cliccare su modifica, come se fosse un normalissimo modulo, per poter cominciare a strutturare il proprio indice di navigazione.

In questo senso, sono disponibili due template già pronti all'uso: uno verticale, {{Sommario V}}, e uno orizzontale, {{Sommario}}. Questi due template sono generici nel senso che è possibile adattarli ad ogni libro, l'unico incoveniente è che non sono personalizzabili e quindi, in un wikibook sulla lingua turca, anzichè scrivere {{Corso turco}} in ogni capitolo per ottnere l'indice di navigazione, sarà necessario scrivere:

Indice del libro

e così via, all'inizio di ogni capitolo. Quest'operazione è sconsigiabile perchè, qualora venga aggiunta una nuova sezione per esempio Pronuncia, sarà necessario aggiornare ogni capitolo aggiungendo Pronuncia:

Indice del libro

, il chè sicuramente è un dispendio di energia.

Per ovviare a questo problema, è fortemente consigliato copiare il contenuto del template e sostituire ai vari paramentri quelli del nostro wikibook. In generale, è preferibile il template verticale perchè più fruibile, alcune volte però il template si sovrappone al testo delle pagine, in quei casi è consigliato usare il template orizzontale. Il loro funzionamento è spiegato di seguito.

Indice verticale

Se volete realizzare un indice di navigazione verticale, e non avete voglia o non sapete come fare a crearne uno personalizzato, basta copiare il contenuto di questo template: //it.wikibooks.org/w/index.php?title=Template:Sommario_V&edit e incollarlo nel template che desideriamo, ad esempio, //it.wikibooks.org/wiki/Template:Corso_di_turco.

È stato creato un template con il nome di Template:Corso di turco, che è possibile mettere all'inizio di ogni capitolo, per ottenere il proprio indice di navigazione; tuttavia otterrete un insoddisfacente:

Template:Sommario V: È necessario inserire il parametro "titolo" con il titolo del libro.

Ora, passiamo alla personalizazzione, basterà infatti sostituire i parametri del template:

  • Al posto di {{{titolo}}}, inseriremo Corso di turco
  • Al posto di {{{contenuto}}}, inseriremo tutti i capitoli del nostro wikibook, ognuno con un # davanti, in modo da numerarli; e un * per i sottocapitoli.

Attenzione: è presente un altro parametro {{{titolo}}}, in basso. Se esistente, inserire il nome della categoria del wikibook, altrimenti cancellare questa riga: [[Categoria:{{{titolo}}}]]

Indice orizzontale