View source for Template:Cita/man

Il template <code>{{tl|Cita}}</code> serve a inserire nel corpo della voce un breve riferimento cliccabile, di solito dentro una [[Aiuto:Note|nota]], che rimanda a uno dei testi presenti nella sezione [[Aiuto:Bibliografia|Bibliografia]] o nella sezione [[wp:Collegamenti esterni|Collegamenti esterni]]. Questo permette di riprodurre il tipico formato delle pubblicazioni accademiche, che contengono una bibliografia dettagliata di tutti i testi di interesse (con autore, titolo, editore ecc.), e quando vogliono richiamare un certo testo con una nota a pié di pagina, lo richiamano brevemente, ad esempio citandone solo il cognome dell'autore.

L'alternativa all'uso del template Cita è inserire direttamente nella nota la citazione completa del testo. In quel modo, però, se il testo è comunque presente in bibliografia perché di interesse generale, oppure se si vogliono citare pagine diverse dello stesso testo in note diverse, si è costretti a inserire ogni volta autore, titolo, editore ecc. Il Cita permette di richiamare il testo senza doverne ripetere ogni volta tutta la descrizione.

Affinché il collegamento cliccabile del Cita possa funzionare, al testo presente in bibliografia deve essere associato un identificativo testuale univoco (es. il cognome dell'autore). Ci sono due modi per farlo:
*Inserendo il testo in bibliografia con uno dei template {{Tl|Cita libro}}, {{Tl|Cita pubblicazione}}, {{Tl|Cita web}}, {{tl|Cita legge italiana}} ecc. e specificando l'identificativo nel parametro <code>|cid=...</code>
*Usando [[Template:Bibliografia]], che serve ad associare un identificativo a un qualsiasi testo inserito senza template (è da preferire il metodo precedente).

== Uso ==
Normalmente il template è utilizzato all'interno dei tag {{tag|ref}} per inserire una nota che verrà  visualizzata in fondo alla voce nella sezione "[[Aiuto:Note|Note]]", che a sua volta rimanda a un testo in [[Aiuto:Bibliografia|bibliografia]].

=== Sintassi minima ===
La sintassi d'uso minima del template è:
:<code><nowiki>{{Cita</nowiki>|{{colore|blue|<autore>}}<nowiki>}}</nowiki></code>
Questo presuppone che nella sezione bibliografia sia inserita una citazione con il template {{tl|Cita libro}} (o con una degli altri template di citazione) in cui il parametro <code>cid</code> sia uguale ad <code>{{colore|blue|<autore>}}</code>

:Per esempio nel testo viene inserito il riferimento: <code>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua<nowiki><ref>{{Cita</nowiki>|{{colore|blue|'''Giuliano'''}}<nowiki>}}</ref></nowiki>.</code>
:Nella bibliografia si inserisce la citazione del libro:
<code><nowiki>* {{Cita libro</nowiki>|autore=Luca Giuliano|titolo=In principio era il drago - guida al gioco di ruolo|editore=Proxima editrice|anno=1991|città=Roma|cid={{colore|blue|'''Giuliano'''}}<nowiki>}}</nowiki></code>

Il primo parametro ("Giuliano" in questo caso) serve sia a visualizzare il nome dell'autore che a collegare la citazione nella voce al testo in bibliografia.

Le pagine col parametro mancante vengono raccolte in [[:Categoria:Errori di compilazione del template Cita]].

=== Indicazione della pagina ===
Per indicare la posizione della citazione all'interno del testo (normalmente la pagina) si usa il secondo parametro del template. La sintassi diventa:
:<code><nowiki>{{Cita</nowiki>|{{colore|blue|<autore>}}|{{colore|green|p. xx}}<nowiki>}}</nowiki></code>
L'indicazione della pagina verrà automaticamente separata dall'autore da una virgola. Questo parametro è comunque a compilazione libera, quindi nel caso sia necessario è possibile inserire altri tipi di indicazione (come per esempio "prefazione" o "III capitolo")

=== Parametro cid diverso dal nome autore ===
Quando per qualche motivo il parametro cid ha un valore diverso dal nome dell'autore (per esempio perché il testo ha più autori) si può usare il terzo parametro del template per indicarlo. La sintassi diventa:
:<code><nowiki>{{Cita</nowiki>|{{colore|blue|<autore>}}|{{colore|green|p. xx}}|{{colore|green|<cid>}}<nowiki>}}</nowiki></code>

A video verrà visualizzato il valore del primo parametro, ma per collegare la citazione in bibliografia verrà usato il valore del terzo parametro per esempio: <code><nowiki>{{Cita</nowiki>|Angiolino e Sidoti|p. xx|{{colore|green|'''Angiolino'''}}<nowiki>}}</nowiki></code> può essere usato per citare il testo riportato in bibliografia come: <code><nowiki>{{Cita libro|autore=Andrea Angiolino|autore2=Beniamino Sidoti|titolo=Dizionario dei giochi|editore=Zanichelli|città=Bologna|anno=2010|isbn=978-88-08-19349-0|cid=</nowiki>{{colore|green|'''Angiolino'''}}<nowiki>}}</nowiki></code>

In questo caso verrà quindi visualizzato il primo parametro "Angiolino e Sidoti", ma questo sarà collegato attraverso il valore del terzo parametro ("Angiolino").

=== Presenza di più testi dello stesso autore ===
Nel caso di più testi dello stesso autore per poterli distinguere è possibile usare il parametro "titolo" per precisare il titolo del testo (o una sua abbreviazione se questo fosse particolarmente lungo). La sintassi diventa:
:<code><nowiki>{{Cita</nowiki>|{{colore|blue|<autore>}}|{{colore|green|p. xx}}|{{colore|green|<cid>}}|{{colore|green|2=titolo='''titolo'''}}<nowiki>}}</nowiki></code>

Per esempio:
:<code><nowiki>{{Cita</nowiki>|Appelcline|p. xx|{{colore|green|Appelcline80}}|titolo={{colore|blue|'''Designers & Dragons: the '80'''}}<nowiki>}}</nowiki></code>	
:<code><nowiki>{{Cita</nowiki>|Appelcline|p. xx|{{colore|green|Appelcline90}}|titolo={{colore|blue|'''Designers & Dragons: the '90'''}}<nowiki>}}</nowiki></code>
In questo caso sarà visualizzato il nome dell'autore, seguito dal titolo in corsivo. Il titolo sarà collegato mediante il terzo parametro alla bibliografia, che in questo caso sarà:
* <code><nowiki>{{Cita libro|autore=Shannon Appelcline|titolo=Designers & Dragons: The '80s|editore=Evil Hat Productions|anno=2014|ed=2|vol=2|lingua=inglese|cid=</nowiki>{{colore|green|Appelcline80}}}}</code>
* <code><nowiki>{{Cita libro|autore=Shannon Appelcline|titolo=Designers & Dragons: The '90s|editore=Evil Hat Productions|anno=2014|ed=2|vol=2|lingua=inglese|cid=</nowiki>{{colore|green|Appelcline90}}}}</code>

=== Uso con il template Bibliografia ===
Nel caso la bibliografia sia stata inserita usando il {{tl|Bibliografia}} anziché uno dei vari template "cita libro/cita pubblicazione/ecc..." il codice che va inserito nel template {{tl|Cita}} per far funzionare il collegamento deve corrispondere al primo parametro del template Bibliografia; per esempio, dato il seguente template Cita:
:<code><nowiki>{{Cita</nowiki>|{{colore|blue|'''Giuliano'''}}|p. xx<nowiki>}}</nowiki></code>
... ci dovrà essere un template Bibliografia in cui il primo parametro sia <code>Giuliano</code>:
:<code><nowiki>{{Bibliografia|</nowiki>{{colore|blue|'''Giuliano'''}}|Luca Giuliano, ''In principio era il drago - guida al gioco di ruolo'', Roma, 1991}}</code>

=== Uso con il template Cita legge italiana ===
Qualora sia presente una [[Aiuto:Bibliografia#Citazione di leggi e provvedimenti legislativi|bibliografia legislativa]] formattata con il template {{tl|Cita legge italiana}}, è possibile usare il template {{tl|Cita}} per richiamare più volte - nel testo o in [[Aiuto:Note|nota]] - medesimi atti.

In tal caso, la sintassi del template sarà la seguente:
:<code><nowiki>{{Cita</nowiki>|{{colore|blue|<atto legislativo ''o'' cid>}}|{{colore|green|<eventuale testo secondario>}}|{{colore|green|<cid>}}<nowiki>}}</nowiki></code>

Per esempio, dato il seguente template Cita:
:<code><nowiki>{{Cita</nowiki>|{{colore|blue|legge 289/2002}}|articolo 90<nowiki>}}</nowiki></code>
... ci dovrà essere un template Cita legge italiana il cui il parametro <code>cid</code> sia <code>legge 289/2002</code>:
:<code><nowiki>{{Cita legge italiana|</nowiki>tipo = legge|anno = 2002|mese = 12|giorno = 27|numero = 289|cid = {{colore|blue|legge 289/2002}}}}</code>

'''N.b.:''' Qualora nel template Cita legge italiana sia già specificato un articolo (ad esempio: <code>articolo = 90</code>), è possibile includerlo nel testo del link senza necessariamente allungare il <code>cid</code>:
:<code><nowiki>{{Cita</nowiki>|{{colore|blue|legge 289/2002, articolo 90}}||{{colore|green|legge 289/2002}}<nowiki>}}</nowiki></code>

== Esempi di visualizzazione ==
*<code><nowiki>{{Cita|Giuliano}}</nowiki></code>: {{Cita|Giuliano}}
*<code><nowiki>{{Cita|Giuliano|p. 10}}</nowiki></code>: {{Cita|Giuliano|p. 10}}
*<code><nowiki>{{Cita|Giuliano|p. 10|Giuliano1991}}</nowiki></code>: {{Cita|Giuliano|p. 10|Giuliano1991}}
*<code><nowiki>{{Cita|Giuliano|p. 10|titolo=In Principio era il drago}}</nowiki></code>: {{Cita|Giuliano|p. 10|titolo=In Principio era il drago}}
*<code><nowiki>{{Cita|legge 289/2002|articolo 90}}</nowiki></code>: {{Cita|legge 289/2002|articolo 90}}
*<code><nowiki>{{Cita|legge 289/2002, articolo 90||legge 289/2002}}</nowiki></code>: {{Cita|legge 289/2002, articolo 90||legge 289/2002}}

== Template correlati ==
* [[Template:Cita brevetto]]
* [[Template:Cita conferenza]]
* [[Template:Cita libro]]
* [[Template:Cita news]]
* [[Template:Cita pubblicazione]]
* [[Template:Cita TV]]
* [[Template:Cita web]]

{{progetto|fonti|template}}<noinclude>

[[Categoria:Manuali dei template|Cita]]</noinclude>