Template:Cita testo/man

Il template {{Cita testo}} serve a citare le fonti in Wikipedia utilizzando un formato standard e omogeneo, conforme a quanto previsto dalle convenzioni bibliografiche di Wikipedia. Il template è generico e può essere utilizzato sia per citare libri, riviste, siti web o conferenze.

Il template viene effettivamente implementato attraverso il modulo Citazione scritto in Lua.

Sintassi minima

Di seguito alcuni esempi di sintassi minime di dichiarazione del template per diversi casi possibili di testi:

Libro

{{cita testo |autore= |titolo= |data= |editore= |città= }}

Sito web

{{cita testo |autore= |titolo= |url= |data= |editore= |accesso= }}

News

{{cita testo |autore= |url= |titolo= |pubblicazione= |data= |accesso= }}

Pubblicazione

{{cita testo |autore= |data= |titolo= |rivista= |editore= |città= |volume= |numero= |url= |accesso= }}

Conferenza

{{cita testo |autore= |titolo= |conferenza= |editore= |anno= |città= |url= |accesso= }}

Sintassi estesa

Tutti i nomi dei campi devono essere minuscoli. Copia una versione vuota per iniziare. Ricorda che il carattere "|" deve separare ogni campo. Cancella i campi inutilizzati, per evitare di sovraffollare la finestra di modifica. Vedi anche la descrizione dei campi.

versione estesa (copia e incolla il testo sotto, poi cancella i parametri che non ti servono)
Nota: per semplicità non sono comunque compresi tutti i parametri, non compaiono le versioni alternative, né quelli deprecati, né i vari identificatori eccetto il generico id.

(legenda colori)

{{Cita testo
|lingua =
|autore =
|wkautore =
|curatore =
|altri =
|titolo =
|pubblicazione = <!-- alternative: rivista, giornale, sito -->
|editore =
|città =
|data =
|dataoriginale =
|url =
|urlcapitolo =
|formato =
|serie =
|ed =
|vol =
|numero =
|pp = <!-- da usare per citare più di una pagina, antepone "pp." -->
|p = <!-- da usare per citare una singola pagina, antepone "p." -->
|id = <!-- identificatore generico, quando possibile usare quello specifico ISBN, ISSN, doi, ecc.. -->
|cid =
|citazione =
|accesso =
|urlarchivio =
|dataarchivio =
|urlmorto =
}}

Parametri

I parametri indicati in verde e rientrati rispetto a quelli principali sono parametri secondari che vengono ignorati se non è stato compilato il parametro principale corrispondente (ad esempio se non viene inserito il cognome dell'autore viene ignorato l'inserimento del nome).

I parametri in rosso sono alternativi rispetto ai parametri rossi dello stesso gruppo, in caso venga usato più di un parametro alternativo il template inserirà la voce nella categoria:Errori del modulo citazione - citazioni con parametri ridondanti (vedi Citazione/Aiuto per maggiori informazioni sulla gestione degli errori).

Nessun singolo parametro è obbligatorio, ma almeno uno tra titolo, capitolo, titolotradotto, capitolotradotto o rivista (o un suo alias come sito, pubblicazione, ecc...) deve essere definito.

I parametri scritti in grigio sono deprecati e mantenuti per motivi di compatibilità con i precedenti template.

Autore

• autore: autore della fonte. Se ha una voce dedicata su wikipedia si può wikilinkare o usare wkautore per collegarla. Per indicare un autore collettivo (per esempio una redazione) come autore usa autore per inserirlo nello stesso formato della fonte. Alias: autore1, cognome, cognome1.
• OPPURE
  • cognome: cognome dell'autore della fonte.
  • nome: nome dell'autore, includere eventuali secondi nomi. Non usare wikilink (usare wkautore per questo scopo). Alias: nome1.
• wkautore: collegamento alla voce di wikipedia sull'autore. Non creare collegamenti alla stessa pagina, ad esempio se si cita un libro di Adam Smith nella sua voce. Alias wkautore1, linkautore
• etal: se riempito con qualsiasi valore, es. "etal=si", aggiunge la dicitura et al. (usare quando ci sono molti autori e si vuol indicare solo il primo)
• OPPURE
  • per autori multipli usare autore1, autore2, ... autoren. Nella stessa maniera sono disponibili i corrispondenti cognome1, cognome2, ... cognomen, nome1, nome2, ... nomen e wkautore1, wkautore2, ... wkautoren
  • coautori: deprecato, serviva a indicare gli autori successivi al primo con il vecchio template in cui non era possibile usare più di un campo autore.

Autore capitolo

• autore-capitolo: autore di uno specifico capitolo di una fonte di diverso autore che si intende citare. Se ha una voce dedicata su wikipedia si può wikilinkare o usare wkautore-capitolo per collegarla. Alias: autore-capitolo1, autore-capitolo-cognome, autore-capitolo1-cognome, autore-capitolo-cognome1.
• OPPURE
  • autore-capitolo-cognome: cognome dell'autore del capitolo. Alias: autore-capitolo1-cognome, autore-capitolo-cognome1.
  • autore-capitolo-nome: nome dell'autore, compresi eventuali secondi nomi. Alias: autore-capitolo1-nome e autore-capitolo-nome1.
• wkautore-capitolo: collegamento alla voce di wikipedia sull'autore. Non creare collegamenti alla stessa pagina, ad esempio se si cita un capitolo nella voce del suo autore. Alias wkautore-capitolo1
• OPPURE
  • per autori multipli usare autore-capitolo1 autore-capitolo2 ... autore-capitolon. Come per il parametro autore introdotto nella sezione precedente sono disponibili i corrispondenti autore-capitolo-cognome1, autore-capitolo-cognome2, ... autore-capitolo-cognomen e autore-capitolo-nome1, autore-capitolo-nome2, ... autore-capitolo-nomen e wkautore-capitolo1, wkautore-capitolo2, ... wkautore-capitolon
• OPPURE
  • nel nome dei suddetti parametri va sostituita al posto di "capitolo" la parola contributo, voce, articolo o sezione in concordanza con ciò che si sta citando.

Curatore

• curatore: cognome del curatore. Se ha una voce dedicata su wikipedia si può wikilinkare o usare usare wkcuratore per collegarla. Viene visualizzato con l'aggiunta di "(a cura di)". Se autore non è definito ne prende il posto altrimenti viene visualizzato dopo autore (e dopo un eventuale capitolo. Alias: curatore1, curatore1-cognome, curatore-cognome1
• OPPURE
  • curatore-cognome: cognome del curatore della fonte. Alias: curatore1-cognome e curatore-cognome1.
  • curatore-nome: nome del curatore della fonte, compresi eventuali secondi nomi. Alias: curatore1-nome e curatore-nome1.
• wkcuratore: collegamento alla voce di wikipedia sul curatore. Non creare collegamenti alla stessa pagina, ad esempio se si cita un libro curato da Adam Smith nella sua voce. Alias: wkcuratore1.
• etalcuratori: se riempito con qualsiasi valore, es. "etalcuratori=si", aggiunge la dicitura et al. (usare quando ci sono molti curatori e si vuol indicare solo il primo)
  • OPPURE per curatori multipli usare curatore1 curatore2 ... curatoren. Come per l'autore sono disponibili i corrispondenti curatore-cognome1, curatore-cognome2, ... curatore-cognomen e curatore-nome1, curatore-nome2, ... curatore-nomen e wkcuratore1, wkcuratore2, ... wkcuratoren

Altri contributori

• traduttore o traduttori: per indicare il traduttore/i; il template aggiunge automaticamente "traduzione di"
• illustratore o illustratori: per indicare l'illustratore/i; il template aggiunge automaticamente "illustrazioni di"
• altri: per aggiungere altri contributori, per esempio "postfazione di Paolo Rossi". Formato libero, viene inserito dopo il titolo.

Titolo

• titolo: titolo della fonte. Può essere wikilinkato manualmente a una voce di Wikipedia esistente dedicata all'opera, oppure si può usare wktitolo per indicare il titolo della voce da linkare, oppure si può usare url (vedi #URL) per aggiungere un collegamento esterno. È visualizzato in corsivo.
  • titolotradotto: traduzione in italiano del titolo, se la fonte citata è in lingua straniera. titolotradotto è visualizzato tra parentesi quadre dopo titolo. Se url è definito allora titolotradotto è incluso nel collegamento. In questo caso si raccomanda di usare il parametro lingua per indicare la lingua della fonte.
  • titolooriginale: titolo originale dell'opera, da utilizzare solo in presenza di due condizioni: 1. la fonte citata è una traduzione in italiano di un'opera in lingua straniera; 2. il titolo dell'edizione italiana non è una traduzione letterale del titolo originale. titolooriginale è visualizzato tra parentesi quadre dopo titolo e se url è definito allora titolooriginale è incluso nel collegamento.

I titoli che contengono alcuni caratteri saranno visualizzati scorrettamente e il link non funzionerà a meno che questi non siano codificati:

carattere	a capo	[	]	|
codificarlo con	spazio	[	]	|

• tipo: informazioni aggiuntive sul media della fonte, per esempio libretto, custodia di cd, notizia stampa. Formattato tra parentesi e inserito dopo il titolo.
• lingua: la lingua in cui è scritta la fonte, se diversa dell'italiano. Viene visualizzato all'inizio della citazione tra parentesi tonde. Per i codici utilizzabili vedere il template:Lingue. Se si devono inserire più lingue (per un testo o sito web bilingue o più) inserire i codici lingua separati dalla virgola, per esempio |lingua = en, it.
• capitolo: il titolo del capitolo della fonte. Può essere un collegamento manuale a una voce di wikipedia dedicata all'opera, oppure si può usare wkcapitolo per indicare il titolo della voce da linkare, oppure si può collegare a una pagina esterna usando urlcapitolo, ma non entrambi. Visualizzato in corsivo.
  • OPPURE, al posto di capitolo possono essere usati contributo, voce, articolo o sezione.

Pubblicazioni periodiche / collane di libri

• pubblicazione: nome del periodico, se ha una sua voce su wikipedia può essere un collegamento. Alias: opera, giornale, rivista, sito, periodico, enciclopedia, dizionario. Nel caso di {{Cita web}} la pubblicazione è intesa come il nome generale del sito, e quando non è specificata viene usato in automatico il dominio dell'URL (es. per https://www.tizio.org/caio appare tizio.org)
• supplementodi: se la pubblicazione, o direttamente il titolo, è un supplemento di qualche altra pubblicazione, indicarne qui il nome. Normalmente va inserito solo il nome non formattato, ma è possibile anche inserire una frase seguita da un titolo in corsivo (in tal caso non verrà aggiunta altra formattazione)
• collana: titolo della collana editoriale della quale fa parte la specifica edizione citata
• numero: quando la pubblicazione è parte di una serie pubblicata regolarmente

Data

• data: data di pubblicazione della fonte, normalmente per un libro si inserisce solo l'anno, per un periodico il "mese anno" (o per alcuni periodici può essere "stagione anno" o un "bimestre anno", per esempio "inverno 2010" o "gennaio/febbraio 2011"), per un giornale viene indicata la data di pubblicazione completa. Normalmente il mese si scrive per esteso e nel caso si referenzi il primo giorno del mese questo è scritto come "1º". Per esempio "1º gennaio 2013", "15 marzo 2013". Non wikilinkate la data.
• OPPURE: anno: anno di pubblicazione della fonte
  • mese: mese di pubblicazione della fonte
    • giorno: giorno di pubblicazione della fonte
• annooriginale: anno di pubblicazione originale, per chiarezza siate specifici, per esempio "prima pubblicazione 1859" o "composto 1904". Viene visualizzato tra parentesi quadre dopo la data o l'anno.

Editore

• editore: editore della fonte, normalmente non viene incluso per le testate periodiche. Sigle relative all'organizzazione aziendale come "Ltd", "Spa", ecc... normalmente non sono incluse. Compare dopo il luogo di pubblicazione. Nel caso di testi cartacei digitalizzati e pubblicati su un sito si deve inserire comunque l'editore originale (del testo cartaceo), nel caso venga linkato il sito su cui è ospitato usare il parametro via per indicarne il nome.
• ente: l'istituzione che ha curato o promosso la pubblicazione
• città: città (o luogo geografico) di pubblicazione, normalmente non viene inserito per le pubblicazioni salvo casi di ambiguità (per esempio The Times testata di Chicago o The Times testata del Sud Africa, rispetto al più noto The Times britannico)

Edizione, serie e volume

• edizione: per citare l'edizione della fonte usata quando questa ne ha più di una. Se è un numero aggiunge automaticamente "ª ed."
• OPPURE ed: come sopra, ma aggiunge automaticamente "ª ed."
• serie: quando la numerazione dei volumi di una pubblicazione è ripartita (per esempio 2ª serie). Viene visualizzato prima dei volumi. Alias versione
• volume: per una pubblicazione edita in volumi.
• OPPURE vol: come sopra ma antepone automaticamente "vol. ".
• numero: per una pubblicazione pubblicata in diversi volumi. Se è un numero antepone automaticamente "nº "

Pagina

• p: per specificare la pagina della fonte a cui si fa riferimento. Viene anteposto automaticamente "p. "
• OPPURE pp: come sopra, ma quando le pagine della fonte a cui si fa riferimento sono più di una; separare intervalli di pagine consecutive con un trattino "-"; separare intervalli di pagine non consecutivi con un una virgola ",". Da non usare per indicare il numero totale di pagine della fonte. Viene anteposto automaticamente "pp. "
• OPPURE posizione: da usare quando è inappropriato indicare una pagina (per esempio "copertina", "retro di copertina", "stanza", "verso"); formato libero, viene riportato come inserito.
• OPPURE pagina: mantenuto per compatibilità con i template precedenti, tenta di determinare in automatico se anteporre o meno "pp." secondo il valore passato e il tipo di template utilizzato. Usare piuttosto p
• OPPURE pagine: mantenuto per compatibilità con i template precedenti, tenta di determinare in automatico se anteporre o meno "pp." secondo il valore passato e il tipo di template utilizzato. Usare piuttosto pp

URL

• url: URL di una risorsa online dove si può trovare il testo della fonte. Non può essere usato se titolo contiene un wikilink. Se possibile il collegamento dovrebbe puntare alla specifica pagina a cui si fa riferimento. Non collegate siti di venditori commerciali come Amazon.com, vedi Collegamenti vietati.
  • accesso: la data di ultimo accesso all'URL. Inserire la data per esteso. Non inserire wikilink. In alternativa sono disponibili i tre parametri separati annoaccesso, meseaccesso e giornoaccesso.
  • urlarchivio: l'url di una copia d'archivio di una pagina web (vedi Aiuto:Collegamenti interrotti). Generalmente fa riferimento a servizi come WebCite o Internet Archive; è obbligatorio compilare anche dataarchivio, a meno che la data sia codificata all'interno dell'url, nel qual caso viene estratta in automatico. Nel caso di Internet Archive, anche se l'url archiviato viene inserito direttamente nel parametro url verrà interpretato automaticamente come archiviato e ne verrà estratto l'url originale.
    • dataarchivio: la data di archiviazione dell'URL originale. Inserire la data per esteso e senza wikilink. Non è necessario indicarla quando è estratta automaticamente dagli url degli archivi Wayback (come quelli utilizzati da Internet Archive) e da alcuni url degli archivi Webcite e Archiveis.
    • urlarchivio2: l'url di una seconda copia d'archivio. Ignorato se non è presente urlarchivio; richiede dataarchivio2
      • dataarchivio2: la data di archiviazione della seconda copia dell'URL originale. Inserire la data per esteso. Non inserire wikilink.
    • urlmorto: compilare questo parametro con "no" se il collegamento originale è ancora disponibile nonostante sia stata indicata una versione archiviata dell'URL. Compilare con "sì" se l'URL originale non è funzionante e la versione archiviata non è stata indicata. Alias deadurl
• via: il nome del sito su cui è ospitata l'opera, quando questi non è l'editore dell'opera stessa (per esempio la copia digitale di un libro medievale ospitato sul sito di una biblioteca)
• formato: il formato della fonte a cui fa riferimento l'url, se si tratta di un file diverso da una pagina HTML. Compare tra parentesi dopo il titolo. Alcuni formati vengono automaticamente collegati alla loro pagina di descrizione su it.wiki. Inoltre, se l'URL termina con uno di questi codici come estensione, il formato viene riconosciuto in automatico e non è necessario compilare il parametro.

codice	Testo popup
csv	file di testo con valori separati da virgole
djvu	documento in formato DjVu
doc	documento Word 97-2003
docx	documento Word 2007-
epub	documento in formato ePub
f4a	audio in formato Flash per Adobe Flash Player
f4b	audiolibro in formato Flash per Adobe Flash Player
f4p	video in formato Flash protetto per Adobe Flash Player
f4v	video in formato Flash per Adobe Flash Player
flv	video in formato Flash
gif	immagine in formato GIF
gzip	archivio compresso in formato Gzip
javascript	codice sorgente JavaScript
jpg	immagine in formato JPG
mp3	audio in formato MP3
odt	documento in formato OpenDocument
pdf	documento in formato PDF
png	immagine in formato PNG
pps	presentazione PowerPoint 97-2003 (solo visualizzazione)
ppsx	presentazione PowerPoint 2007- (solo visualizzazione)
ppt	presentazione PowerPoint 97-2003
pptx	presentazione PowerPoint 2007-
ps	documento in formato PostScript
ram	audio in formato RealAudio
rar	archivio compresso in formato RAR
realmedia	audiovideo in formato RealMedia
realvideo	video in formato RealMedia
rm	audiovideo in formato RealMedia
rtf	documento in formato RTF
swf	animazione o applicazione in formato Flash
tiff	immagine in formato TIFF
txt	documento di puro testo
wav	audio in formato WAV
wmv	video in formato WMV
xls	cartella di lavoro Excel 97-2003
xlsx	cartella di lavoro Excel 2007-
xml	file di testo in formato XML
zip	archivio compresso in formato ZIP

• urlcapitolo: URL di un capitolo individuale di una fonte online. Dovrebbe essere sullo stesso sito di url se questo è definito. Da usare solo se link web del capitolo differisce da quello iniziale dell'opera.
• s: facilita il collegamento a una pagina di Wikisource; il link viene posizionato sul capitolo (alternativo a urlcapitolo) se è definito un capitolo, altrimenti sul titolo (alternativo a url). Indicare il titolo della pagina su Wikisource, senza prefisso "s:". Funziona anche per Wikisource straniere; usa automaticamente la stessa lingua della citazione. Se il titolo e l'eventuale capitolo su Wikisource hanno esattamente lo stesso nome che hanno nella citazione, si può inserire soltanto "1" per usare automaticamente gli stessi valori.

N.B.: Gli URL devono iniziare con uno schema URI supportato: http:// e https:// sono supportati da tutti i browser, altri come irc://, ircs://, ftp://, news:, mailto: e gopher:// potrebbero richiedere un plugin o un'applicazione esterna e dovrebbero essere evitati.

N.B.: Se un URL contenuto in alcuni parametri contiene certi caratteri questi verranno mostrati in modo scorretto. Questi caratteri devono essere codificati, per esempio uno spazio deve essere sostituito da %20. Per codificare un URL rimpiazzate questi caratteri:

carattere	spazio	"	'	<	>	[	]	|	}
codifica	%20	%22	%27	%3c	%3e	%5b	%5d	%7c	%7d

Non occorre wikificare un singolo apostrofo, ma più apostrofi consecutivi verrebbero trattati come wikicodice per corsivo o grassetto. Nella stessa maniera una singola parentesi graffa chiusa non necessità di essere codificata, ma una coppia di parentesi graffe chiuse verrebbe interpretata come chiusura del template.

Riferimento

• cid: codice da assegnare alla fonte da usare in coppia con il {{Cita}}.

Citazione

• citazione: Testo citato dalla fonte. Visualizzato racchiuso tra parentesi angolari.

Identificatori

Questi identificatori creano un collegamento alla fonte e sono pensati per accettare ciascuno un singolo valore. Usare più di un valore per parametro rompe il collegamento o invalida il parametro.

• id: parametro generico per un identificatore non previsto da quelli elencati sotto, formato libero.
• arxiv: identificatore arXiv, per esempio "arxiv=hep-th/9205027".
• bibcode: Bibcode; usato da diverse base dati astronomiche, per esempio: "bibcode=1924MNRAS..84..308E".
• bnf: codice della Bibliothèque nationale de France
• doi: Digital object identifier; per esempio: "doi=10.1038/news070508-7"; il template verifica che inizi con 10..
  • doi_brokendate: data da cui il DOI non è più valido. usare lo stesso formato di altre date nell'articolo.
• isbn: International Standard Book Number. Inserire senza precedere con "ISBN", per esempio "isbn=0-8126-9593-3". Controllato per lunghezza, caratteri non validi e cifra di controllo corretta. Se si è certi che l'ISBN non esista si può segnalarlo inserendo "isbn=no"
• issn: International Standard Serial Number; usato per identicare periodici, come pubblicazioni e riviste. Per esempio "issn=0000-0019".
• jfm: Jahrbuch über die Fortschritte der Mathematik.
• jstor: abstract JSTOR, per esempio "jstor=3793107".
• lccn: Library of Congress Control Number.
• mr: Mathematical Reviews.
• oclc: identificatore OCLC.
• ol: Open Library.
• osti: Office of Scientific and Technical Information.
• pmc: numero di archiviazione di un articolo PubMed Central disponibile gratuitamente.
• pmid: identificatore PubMed.
• rfc: identificatore Request for Comments.
• sbn: identificatore usato dal Servizio bibliotecario nazionale, per esempio "sbn=IT\ICCU\MIL\0841387"
• ssrn: identificatore Social Science Research Network.
• zbl: identificatore Zentralblatt MATH.

Altri parametri

• postscript: se settato al valore "nessuno" impedisce l'aggiunta di un punto finale alla citazione, da usare per esempio quando la citazione è all'interno di parentesi tonde.