Extension:Cite/Cite.php/it

From MediaWiki.org

This page was recently moved from MetaWiki. The page probably requires cleanup - please feel free to help out. Remove this template once that is done.

Cite.php è un'estensione Cite che aggiunge due tag (due parser hooks) a MediaWiki, <ref> e <references>; i due tag operano insieme per aggiungere riferimenti alle pagine.

Contents 1 Da dove scaricarla 2 Requisiti 3 Come installarla 4 Come funziona 4.1 Esempio 4.2 Uso multiplo della stessa nota a piè di pagina 4.3 <references> 5 Personalizzazione

[edit] Da dove scaricarla

• Cite.php

[edit] Requisiti

Questa versione richiede almeno Mediawiki 1.6x.

[edit] Come installarla

1. Copia il file Cite.php nella tua cartella delle estensioni, e
2. aggiungi la linea require_once( "extensions/Cite.php" ); al tuo LocalSettings.php
   ( Appena sotto alla linea: require_once( "includes/DefaultSettings.php" ); )

[edit] Come funziona

Fondamentalmente, il tag <ref> inserisce il testo incluso tra i tag 'ref' come una nota a piè di pagina in una sezione definita, che puoi indicare col tag-segnaposto <references/>. Il nuovo formato non può essere usato in modo alternativo insieme al vecchio formato - bisogna scegliere l'uno o l'altro.

Se dimentichi di includere <references/> alla fine dell'articolo, non apparirà alcuna nota a piè di pagina. Questa stessa pagina usa le note a piè di pagina, come quella alla fine di questa frase.^[1]. Se si dà un'occhiata al Wikicode di questa pagina clickando su "modifica", si può vedere un esempio funzionante di note a piè di pagina.

[edit] Esempio

Secondo gli scienziati, il sole è alquanto grande.<ref>Miller, E: "Il sole.", pag. 23. Academic Press, 2005</ref>
La luna, tuttavia, non è così grande.<ref>Smith, R: "La grandezza della luna", Scientific American, 46(78):46</ref>

==Note==
<references/>

[edit] Uso multiplo della stessa nota a piè di pagina

Per dare ad una nota a piè di pagina un identificatore unico, puoi usare <ref name="name">. In seguito, sarà possibile riferirsi di nuovo alla stessa nota a piè di pagina usando un tag 'ref' con lo stesso nome. Il testo nel secondo tag non importa, poiché il testo già esiste nel primo riferimento. Puoi copiare l'intera nota a piè di pagina, o puoi usare un tag 'ref' vuoto e terminato in questo modo: <ref name="name"/>.

Nel seguente esempio, la stessa fonte è citata tre volte.

Questo è un esempio di riferimenti multipli alla stessa nota a piè di pagina.<ref name="multiplo">Ricorda che quando ti riferisci alla stessa nota a piè di pagina più volte, è usato il testo del primo riferimento.</ref>

Tali riferimenti sono particolarmente utili quando si citano le fonti, e diverse affermazioni provengono dalla stessa fonte.<ref name="multiplo">Questo testo è superfluo, e non verrà mostrato da alcuna parte. Potremmo anche usare solo un tag vuoto.</ref>

Un modo rapido per creare riferimenti multipli è quello di usare tag 'ref' vuoti che abbiano uno slash alla fine.<ref name="multiplo" />

==Note==
<references/>

Il testo qui sopra fornisce il seguente risultato nell'articolo (vedi anche la sezione Note sotto):

Questo è un esempio di riferimenti multipli alla stessa nota a piè di pagina.^[2]

Tali riferimenti sono particolarmente utili quando si citano le fonti, e diverse affermazioni provengono dalla stessa fonte.^[2]

Un modo rapido per creare riferimenti multipli è quello di usare tag 'ref' vuoti che abbiano uno slash alla fine.^[2]

[edit] <references>

L'inserimento di <references> fa sì che venga inserito il testo di tutte le citazioni in coda, definite dai vari tag <ref>, presenti in qualsiasi punto della pagina. Ad esempio, sulla base delle citazioni di sopra, il codice:

<references/>

produrrà:

1. ↑ Questa nota a piè di pagina è usata come esempio nella sezione "Come funziona"
2. ↑ ^{2.0 2.1 2.2} Ricorda che quando ti riferisci alla stessa nota a piè di pagina più volte, è usato il testo del primo riferimento.

[edit] Personalizzazione

Il formato dell'output di <ref> e <references> è quasi interamente personalizzabile attraverso messaggi MediaWiki, che possono essere modificati, per esempio, attraverso il namespace MediaWiki in base alla configurazione del wiki.

Per una lista di messaggi che controllano l'output di <ref> e <references> e dei valori, se ci sono, che ad essi vengono passati ($1, $2, $3 ...), vedi il codice in CVS per un elenco aggiornato del loro contenuto di default.

• cite_reference_link_key_with_num
  1. key
  2. num
• cite_reference_link_prefix
• cite_reference_link_suffix
• cite_references_link_prefix
• cite_references_link_suffix
• cite_reference_link
  1. ref ID
  2. backlink ID
  3. quantità da mostrare
• cite_references_link_one
  1. backlink ID
  2. ref ID
  3. testo della nota
• cite_references_link_many
  1. backlink ID
  2. lista di links
  3. testo della nota
• cite_references_link_many_format
  1. ref ID
  2. valore numerico da usare come backlink
  3. valore personalizzato (come definito in cite_references_link_many_format_backlink_labels da usare come backlink)
• cite_references_link_many_format_backlink_labels
• cite_references_link_many_sep
• cite_references_link_many_and
• cite_references_prefix
• cite_references_suffix