Template:Cita testo

La matrice di questo template contiene più parametri opzionali e funzioni complesse.

Modificalo solo se sei certo di capirne la funzione e sei preparato a riparare ogni conseguente danno collaterale. Tutti gli esperimenti devono essere prima condotti nell'apposita sandbox.

Istruzioni per l'uso
Le istruzioni che seguono sono contenute nella sottopagina Template:Cita testo/man (modifica · cronologia · sandbox)

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 w: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 = 
| editore =
| città =
| data =
| dataoriginale =
| url =
| urlcapitolo =
| formato =
| serie =
| ed =
| vol =
| numero =
| pp = 
| p = 
| id = 
| 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 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 dell'editore. 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

Altri contributori

altri: per aggiungere altri contributori, per esempio "tradotto da Paolo Rossi" o "illustrato da Gino Bianchi". 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.

Per inserire un'interruzione di riga nel titolo usare il codice 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 da spazio., per esempio lingua=|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, sito, periodico, enciclopedia, dizionario
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, in assenza di indicazione dell'autore (parametro cognome o suo alias) o di curatore (parametro curatore o suo alias) compare prima del titolo.
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 automaticametne "p. "
OPPURE pp: come sopra, ma quando le pagine della fonte a cui si fa riferimento, separare intervalli di pagine consecutive con un trattino "-"; separere 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; richiede dataarchivio
  - dataarchivio: la data di archiviazione dell'URL originale. Inserire la data per esteso. Non inserire wikilink.
  - 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: da usare quando l'URL è ancora valido, ma per sicurezza è stata comunque salvata una copia d'archivio. Inserire urlmorto=no, altri valori tratteranno url come se non fosse più valido. Alias deadurl
formato: il formato della fonte a cui fa riferimento l'url, l'HTML è sottinteso e non dovrebbe essere specificato. Inserito tra parentesi dopo il titolo. Alcuni formati vengono automaticamente collegati alla loro pagina di descrizione su it.wiki.

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.

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 tratta 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 w:arXiv, per esempio "arxiv=hep-th/9205027".
bibcode: w:Bibcode; usato da diverse base dati astronomiche, per esempio: "bibcode=1924MNRAS..84..308E".
doi: w: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-812695-93-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: w:Jahrbuch über die Fortschritte der Mathematik.
jstor: abstract w:JSTOR, per esempio "jstor=3793107".
lccn: w:Library of Congress Control Number.
mr: w:Mathematical Reviews.
oclc: identificatore w:OCLC.
ol: w:Open Library.
osti: w:Office of Scientific and Technical Information.
pmc: numero di archiviazione di un articolo w:PubMed Central disponibile gratuitamente.
pmid: identificatore w:PubMed.
rfc: identificatore w:Request for Comments.
sbn: identificatore usato dal w:Servizio bibliotecario nazionale, per esempio "sbn=IT\ICCU\MIL\0841387"
ssrn: identificatore w:Social Science Research Network.
zbl: identificatore w: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.