Manuale di MediaWiki : Sommario generale —— sommario specifico per Lettori, Scrittori, Amministratori, Sviluppatori —— Altre pagine di aiuto (specifiche per questo progetto)

Questa pagina è una traduzione della corrispondente pagina del manuale in inglese di MediaWiki.

Puoi consultare (in inglese) le linee guida del manuale | la Politica editoriale

{{{{{1}}}}}

Note: per la traduzione degli elementi dell'interfaccia utente la presente pagina fa riferimento alla versione corrente (23/12/2005) di it.wiki, che potrebbe non essere allineata con il pacchetto standard di MediaWiki. Inoltre, alcuni link interni a sezioni di pagina sono stati riportati alla pagina in attesa di traduzione.


Ciascuna pagina può essere divisa in sezioni, separandole con un'opportuna sintassi.

Si veda anche la pagina MediaWiki feature list

Come creare una sezione

Per creare una sezione è sufficiente crearne il titolo; si veda la pagina en:Wikipedia:Section#Creation of sections

==Sezione==

===Sottosezione===

====Sotto-sottosezione====

Sommario

Sommario standard

Il software MediaWiki genera un sommario standard (in inglese table of contents, abbreviato TOC) per tutte le pagine che contengono più di tre titoli di sezione, con le seguenti eccezioni:

  • se l'utente ha scelto di impostare a 'off' i sommari nelle proprie preferenze
  • se l'articolo contiene in qualunque punto del testo la parola magica __NOTOC__

Viceversa, si può forzare la presenza del sommario anche sulle pagine che hanno meno di 4 titoli di sezione aggiungendo nel wikitesto la dicitura __FORCETOC__ oppure __TOC__.

Se si usa la sintassi __FORCETOC__ il sommario appare immediatamente prima del primo titolo di sezione; con la sintassi __TOC__, invece, viene inserito nel punto in cui si trova la parola magica. Con questo accorgimento si può inserire il sommario, ad esempio, sulla destra della pagina o nella cella di una tabella, o anche farlo ripetere più volte. È possibile, ad esempio, ripeterlo in ciascuna sezione (si veda m:Help talk:Section), anche se un simile accorgimento sembra giustificato soltanto quando le singole sezioni sono molto grandi e il sommario ne occupa solo una piccola parte.

È quindi possibile inserire un testo introduttivo prima del sommario, che costituisce l'"incipit" dell'articolo. Anche se di norma è preferibile avere una intestazione di sezione dopo il sommario, si può usare la nota __TOC__ per non trovarsi costretti a inserire una intestazione inutile solo per evitare che il sommario si trovi posizionato troppo in basso nella voce.

È possibile impostare le proprie preferenze personali in modo che le sezioni vengano numerate automaticamente.

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. Il testo del template che precede la sua prima sezione viene inserito nella sezione della pagina principale 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 (si veda più avanti).

Sommario compatto

Quando si hanno un gran numero di intestazioni di sezione piuttosto corte, ad esempio le lettere dell'alfabeto, il sommario può diventare lungo e ingestibile. Esiste una presentazione alternativa per il sommario, chiamata sommario compatto. Se il progetto cui si contribuisce è dotato della pagina "Template:compactTOC" (come Wikipedia) è possibile inserire il testo:

{{compactTOC}}

Per ottenere un risultato simile a questo:

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:

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, come descritto più oltre.

Si veda anche la pagina compact TOC.

Collegamento a una sezione

Il codice HTML di ciascuna sezione contiene un'àncora (elemento "a" in HTML) i cui attributi "name" e "id" sono entrambi impostati al titolo della sezione. Ciò consente di realizzare dei collegamenti ipertestuali direttamente alle singole sezioni. Le ancore di sezione vengono aggiunte automaticamente dal software MediaWiki nel momento in cui genera il sommario per la pagina, ma possono essere anche usate per creare dei collegamenti diretti a una specifica sezione all'interno di una pagina.

Il codice HTML generato all'inizio della presente sezione, ad esempio, è questo:

<p><a name="Collegamento_a_una_sezione" id="Collegamento_a_una_sezione"></a></p>
<h2>Collegamento a una sezione</h2>

Un collegamento alla sezione (Come fare un link a una sezione) si presenta così:

[[Help:Section/it#Come_fare_un_link_a_una_sezione|Come fare un link a una sezione]]

Dall'interno della stessa pagina si può usare semplicemente la sintassi [[#id|etichetta]], mentre da un'altra pagina è necessario specificare anche il nome della pagina puntata [[nome_pagina#id|etichetta]].

Se in una pagina compare più volte lo stesso titolo di sezione, per creare le ancore viene fatto seguire da un underscore _ e da un numero progressivo; se esistono tre sezioni "Esempio", per dire, i loro nomi per i collegamenti alle sezioni saranno "Esempio", "Esempio_2" ed "Esempio_3".

Si noti che l'uso della funzione di formattazione della data nelle intestazioni di sezione rende più complesso il collegamento alle sezioni.

Un link interno nell'intestazione di una sezione non crea problemi:

Al contrario, un collegamento esterno nell'intestazione di una sezione rende impossibile (a quanto pare) il collegamento da qualunque punto di un progetto MediaWiki, escluso il sommario:

Per il collegamento a un punto qualsiasi all'interno di una pagina, si veda Collegamenti ad una pagina.

Collegamenti alle sezioni e redirect

Un collegamento che specifica la sezione di una pagina costituita da un redirect viene sostituito da un collegamento all'omonima sezione della pagina cui punta il redirect.

Al contrario, un redirect che punta a una sezione di una pagina viene reindirizzato all'inizio della stessa. La sintassi si può usare comunque per chiarire meglio un concetto, e il collegamento funziona correttamente quando viene richiamato dal redirect stesso.

Un altro problema è che quando una sezione viene rinominata non si crea nessun tipo di redirect automatico. Inoltre, non esiste una funzione 'puntano qui' specifica per le sezioni; le pagine che contengono dei puntatori alla sezione vengono elencate tra le pagine che contengono link alla pagina complessiva. Ecco alcuni accorgimenti per ovviare a questi problemi:

  • inserire nel wikitesto un'àncora HTML e puntare ad essa
  • inserire nel wikitesto un commento all'inizio della sezione, elencando tutte le pagine che vi fanno riferimento
  • rendere la sezione una pagina (o un template) a sé stante e lasciare un collegamento (oppure includerlo) nella pagina madre; al posto di collegarsi alla sezione si potrà quindi collegarsi alla pagina separata.

Modifica di una sezione

Le sezioni possono essere modificate singolarmente (funzione di modifica delle sezioni) facendo clic con il tasto destro sull'intestazione oppure seguendo gli appositi collegamenti di modifica sul lato destro della pagina, a seconda delle impostazioni scelte per le proprie preferenze; è inoltre possibile inserire un'URL di questo tipo:

http://meta.wikimedia.org/w/wiki.phtml?title=Help:Section/it&action=edit&section=2

(Si noti che in quest'ultimo caso vengono usati i numeri delle sezioni, non i titoli delle stesse. Anche le sottosezioni sono indicate con un solo numero: ad esempio, la sezione 2.1 diventa 3, la successiva sezione 3 diventa 4, ecc.)

Questo meccanismo è comodo se la modifica con comprende altre sezioni e non è necessario avere sott'occhio il resto della pagina mentre la si apporta (anche se è sempre possibile aprire il collegamento di modifica della sezione in una finestra separata, o aprire il collegamento 'Annulla' in una finestra mentre si modifica la sezione). La modifica di una sezione allevia alcuni dei problemi che si presentano quando si tenta di moficare una pagina molto grande.

Per inserire una nuova sezione si può aggiungere una nuova intestazione sia alla sezione che la precede che a quella che la segue; per unire due sezioni è sufficiente eliminare l'intestazione della seconda.

Se si inserisce la parola magica "__NOEDITSECTION__" in un punto qualsiasi della pagina, non verranno visualizzati i collegamenti di modifica. La funzione di modifica delle sezioni non viene però disattivata; continua ad essere utilizzabile facendo clic con il tasto destro sull'intestazione oppure inserendo la URL appropriata.

Al momento non esiste un collegamento da seguire per modificare la sezione che precede la prima intestazione di sezione (bug 156[1] (links from mw m w)), a a meno che non si utilizzi la skin predefinita, che consente di fare clic con il tasto destro sulla intestazione della pagina stessa; funziona però il metodo della URL, ad esempio per la presente pagina:

http://meta.wikimedia.org/w/wiki.phtml?title=Help:Section&action=edit&section=0

Per maggiore comodità si può copiare un link relativo a un'altra sezione della stessa pagina e modificare a mano il numero della sezione, inserendo lo zero. Se si usa JavaScript è possibile aggiungere alla pagina un collegamento diretto (si veda la pagina w:en:Wikipedia:WikiProject User scripts/Scripts/Add Edit Top Link).

La porzione di pagina modificata comprende anche le sottosezioni. La presenza o meno della numerazione automatica delle sezioni è determinata dal numero delle stesse; ad esempio 1 più il numero di sottosezioni e sotto-sottosezioni. La numerazione delle sezioni è relativa alla porzione di pagina modificata; ciò vuol dire che in ogni momento la numerazione relativa inizia sempre da 1 al livello più alto e le relative sottosezioni sono numerate 1.1, 1.2, ecc. Durante la modifica della sezione 3.2, quindi, la sottosezione 3.2.4 apparirà come 1.4. Si noti però che il formato della intestazione è coerente con il livello assoluto, non con quello relativo.

La pagina di modifica mostra l'elenco dei template utilizzati dall'intera pagina, non solo dalla sezione in corso di modifica.

Nel caso di modifica di sezioni, quanto viene mostrato dall'anteprima non è sempre identico alla parte corrispondente dell'intera pagina; può accadere, ad esempio, che nell'impaginazione complessiva un'immagine contenuta in una sezione precedente 'sbordi' in quella modificata.

Si veda anche Help:Edit summary/it#Titoli_di_sezione_automatici_nell'oggetto, Help:Section editing demo.


Editing sections of included templates

The section editing feature can also be applied to a section of an included page or template. When clicking the edit link of the section that is transcluded, the link target will be the edit page of the separate page. This section, Help:Editing sections of included templates, is an example.

For the purpose of section editing the extent of a section is governed by the headings in the calling page itself. If there is a text before the first section heading of the separate page, this will appear as a part of the section of the parent page that includes the template tag, but clicking its section edit link will not show the wikitext of the separate page. Or if there is a text after the template tag without a specific section heading, to edit this text with section edit feature, one has to click the section headings preceding the template tag.

Therefore it tends to be confusing if the extent of sections in the rendered parent page is different from what the actual wikitext contains. To avoid this:

  • if a template has headings, do not put any text before the first heading
  • in the calling page, start a new section after a template that itself has sections

It may be convenient, where suitable, to start a template with a section heading, even if normally the contents of the template would not need a division into sections, and thus the template is only one section. The section editing feature can then be used for editing the template from a page that includes it, without specially putting an edit link. This template is an example, it does not need a division into sections, but has a heading at the top.

Note that a parameter value appearing in a template, for example "{{{1}}}", is not edited by editing the template but by editing the template tag in the calling page, even though the rendered page and its edit links do not automatically show that. Some explanatory text and/or an extra edit link can be useful.

The __NOEDITSECTION__ tag in any template affects both that template, the pages it's included on, and any other templates included on the same page. A workaround for this issue is described in phab:T48940: it is possible avoid the need to use __NOEDITSECTION__ in a template by to forcing the template to not recognize section headers as editable. Replacing mediawiki section header markup (surrounding headers with == markers to the desired depth) in the template with HTML header markup (surrounding headers with <h1></h1> tags, changing "1" to the desired depth) will result in headers visually identical to the first style, both on the template page and when transcluded, but which are not treated as editable sections.

For example, imagine a template called MyTemplate, containing the following:

==Template heading 1==
Content
===Template heading 2===
Content

Transcluding MyTemplate into another page will result in "edit section" links appearing after Template heading 1 and Template heading 2 on the page the template is transcluded into, which is often undesirable. Adding __NOEDITSECTION__ anywhere within the code of MyTemplate will result in suppression of these "edit section" links within the template, but also everywhere on pages it is transcluded into. If, however, MyTemplate contains the following rather than the above:

<h2>Template heading 1</h2>
Content
<h3>Template heading 2</h3>
Content

then the headings will be visually identical to the previous output of MyTemplate, except that they will not be accompanied by "edit section" links. Section headings elsewhere on pages where MyTemplate is transcluded will be unaffected, and abide by whatever the page's "edit section" settings are.


Modifica di una pagina con sezioni grandi

Se si desidera modificare una pagina con sezioni molto grandi, oppure una pagina molto grande non divisa in sezioni, e si incontrano delle difficoltà dovute al browser o alla propria connessione Internet, è sempre possibile:

  • aggiungere una sezione in fondo, indicando un numero di sezione molto grande (non importa se è un numero più grande rispetto alle sezioni esistenti); in questo caso però è necessario iniziare la modifica con una riga vuota prima di inserire l'intestazione di sezione
  • aggiungere i contenuti all'ultima sezione, senza iniziare la modifica con una riga vuota; tuttavia, in questo caso si rinuncia alla possibilità di annullare l'inserimento o apportare altre modifiche al testo appena inserito finché permangono le limitazioni del browser o della connessione.

Se si riesce a visualizzare il wikitesto di una sezione molto grande, si può quindi dividere la pagina in sezioni più piccole aggiungendole una ad una, per cancellare quindi in un colpo solo il contenuto precedente (aprendo una sezione grande alla volta). Poiché seguendo questo criterio per un certo tempo si avrà una duplicazione parziale dei contenuti, è consigliabile inserire una spiegazione nell'oggetto della modifica.

Aprire collegamenti alle intestazioni in una nuova finestra

Se è stata abilitata la modifica con il tasto destro del mouse, non è possibile eseguire l'azione su una intestazione per aprirla in una nuova finestra, e simili. Molti browser consentono però di ottenere lo stesso risultato con metodi alternativi (in Mozilla: clic con il tasto centrale, ctrl+clic sinistro, navigazione con TAB; in IE: shift+clic sinistro).

Linee di divisione orizzontali

Le linee di divisione orizzontali usate per separare blocchi di testo non vengono considerate nella numerazione delle sezioni e dalla funzione sommario. Non sono quindi adatte a dividere le pagine in sezioni distinte.

"Vedi anche" su una riga o una sezione?

Se una pagina è costituita da sezioni e vi è una nota "vedi anche" che fa riferimento all'intera pagina, è opportuno farne una sezione separate in modo da evitare che diventi parte della sezione precedente, da renderla visibile nel sommario e quindi facilmente accessibile attraverso di esso.

In alternativa, la nota "vedi anche" viene talvolta inserita all'inizio della pagina.

Una nota "vedi anche" che faccia riferimento unicamente a una sezione può essere inserita nella sezione stessa (come sottosezione, paragrafo a sé stante o anche all'interno di un paragrafo).

Testo grande senza intestazione di sezione

Quando si desidera usare un carattere più grande per evidenziare una porzione di testo senza che ciò comporti l'inizio di una nuova sezione, ad esempio per mostrare un particolare tipo di carattere, si può usare una sintassi simile a questa:

<b><span style="font-size:120%"> Testo di esempio </span></b>

ottenendo il seguente risultato:

Testo di esempio

Intestazioni costituite da spazi

Se l'intestazione di una sezione o sottosezione ha come unica intestazione uno spazio, il collegamento risultante nel sommario non è attivo.

Sezioni, pagine separate o pagine incluse?

Questi sono i principali vantaggi e svantaggi di più pagine piccole separate:

  • possibilità di usare la funzione puntano qui
  • redirect automatici a seguito degli spostamenti
  • impossibile fare redirect a una singola sezione
  • il caricamento delle pagine piccole è più veloce rispetto alle grandi

Questi sono i principali vantaggi e svantaggi di un'unica grande pagina con più sezioni:

  • il caricamento di un'unica pagina grande è più comodo e veloce di tante pagine piccole
  • la ricerca all'interno di un'unica pagina (wikitesto o presentazione) con una funzione di ricerca locale è più veloce e per certi aspetti migliore della ricerca estesa a più pagine (che richiede di esaminare l'intero progetto); il sommario consente inoltre una navigazione più agevole.

Un'altra alternativa è costituita dalla realizzazione di pagine composite realizzate a partire da template (creando così un documento composito per inclusione). In tal modo si facilita la ricerca nella pagina complessiva sotto forma di presentazione, ma non di wikitesto. Inoltre, è necessario fornire i vari titoli.

Suddivisioni delle pagine in generale

  • Le sezioni di una pagina sono tra loro contigue; la fine dell'ultima sezione coincide con la fine della pagina (ovvero l'intera pagina è compresa nelle varie sezioni tranne ciò che precede la prima, se presente).
  • Lo stesso principio si applica ai livelli inferiori (sezioni e sottosezioni).
  • Ciascun elemento di una lista compresa in una sezione è considerato alla stregua di una sottosezione, ma non è richiesto che le liste siano contigue tra loro (ovvero, tra due liste vi possono essere dei contenuti a livello della sezione, seguiti da altri elementi di una lista successiva, che si trovano anch'essi a livello del contenuto).
  • In HTML un elemento di una lista può contenere più sottoliste, non necessariamente contigue; può quindi accadere che alcune parti della lista si trovino non solo prima della prima sottolista, ma anche tra due sottoliste o dopo l'ultima di esse. Nelle liste realizzate con la sintassi wiki, al contrario, le sottoliste seguono le stesse regole delle sezioni (si veda il primo elemento della presente lista): l'unica parte della lista che può essere esterna a una sottolista è quella che precede la prima sottolista.

Si veda anche continuing a list item after a sub-item e Template:List demo [ talk edit history links ].

Sezioni di prova

Prova a

Questa è una sezione cui punta un collegamento da #Collegamento a una sezione.

Prova http://a

Questa è una sezione cui punta un collegamento da #Collegamento a una sezione.

Voci correlate


Sommario delle pagine di Aiuto - Pagine nel namespace Aiuto su: Meta b: n: w: q: wiktionary

Per i lettori: Vai | Ricerche | URL | Namespace | Nomi delle pagine | Sezioni | Collegamenti | Puntano qui | Piped link | Collegamenti Interwiki | Reindirizzamenti | Variabili | Categorie | Pagine speciali
Seguire i cambiamenti: Ultime modifiche | (avanzate) | Cambiamenti correlati | Segui | Cronologia | Confronti | Contributi utenti | Sommario delle modifiche | Modifiche minori | Modifiche sorvegliate
Login e preferenze: Loggarsi | Preferenze | Stile Utente
Editing: Modifica | Nuova pagina | Immagini/file | Pagina delle immagini | Caratteri speciali | Formule | Tabelle | EasyTimeline | Template | Rinominare (muovere) una pagina | Scorciatoie modifiche | Pagine discussioni | Prove || mod_corr_meta |
Altri progetti: Wikibooks | Wikinews | Wikipedia | Wikiquote | Wiktionary
modifica questo piè di pagina

Other languages: