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 Lua Modulo:Citazione

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 inserità 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 di 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.

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, includere 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. 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 nome1, curatore-nome2, ... curatore-nomen e wkcuratore1, wkcuratore2, ... wkcuratoren
• no_curatore: se riempito con qualsiasi valore, es. "no_curatore=si", sopprime l'aggiunta di "(a cura di)" dopo il nome del curatore.

Altri contributori

• traduttore o traduttori: per aggiungere il traduttore/i, il template aggiungerà automaticamente "traduzione di"
• illustratore o illustratori: per aggiungere l'illustratore/i, il template aggiungerà automaticametne "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 wikilincato a un articolo di wikipedia esistente oppure si può usare url per aggiungere un collegamento esterno. È visualizzato in corsivo.
  • titolotradotto: traduzione in italiano del titolo, se la fonte è in lingua straniera. Visualizzata in 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: alternativo atitolotradotto, in questo caso il titolo originale è da inserire nel parametro titolo.

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 tesi, 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 a una voce di wikipedia o collegato a una fonte 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: 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)
• 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 referenzis 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. Normalmente compare dopo il titolo. 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.
• 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. Nel caso di pubblicazioni viene visualizzato in grassetto.
• 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, 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	collegamento	visualizzato come
csv	w:Comma-separated values	(CSV)
djvu	w:DjVu	(DjVu)
doc	w:.doc	(DOC)
docx	w:.docx	(DOCX)
epub	w:ePub	(ePub)
f4a	w:Flash Video	(F4A)
f4b	w:Flash Video	(F4B)
f4p	w:Flash Video	(F4P)
f4v	w:Flash Video	(F4V)
flv	w:Flash Video	(FLV)
gif	w:Graphics Interchange Format	(GIF)
javascript	w:JavaScript	(JavaScript)
jpg	w:JPEG	(JPG)
mp3	w:MP3	(MP3)
odt	w:OpenDocument	(Odt)
pdf	w:Portable Document Format	(PDF)
png	w:Portable Network Graphics	(PNG)
pps	w:.pps	(PPS)
ppsx	w:.ppsx	(PPSX)
ppt	w:.ppt	(PPT)
pptx	w:.pptx	(PPTX)
ps	w:PostScript	(ps)
ram	w:RealAudio	(ram)
rar	w:RAR (formato di file)	(RAR)
rtf	w:Rich Text Format	(RTF)
swf	w:Shockwave Flash	(SWF)
tiff	w:Tagged Image File Format	(TIFF)
txt	w:file di testo	(TXT)
wav	w:WAV	(WAV)
wmv	w:Windows Media Video	(WMV)
xls	w:Microsoft Excel	(XLS)
xlsx	w:.xlsx	(XLSX)
zip	w:ZIP (formato di file)	(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.

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.

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.