Aiuto:Note

– Sportello informazioni

Nelle voci di Cathopedia, la sezione intitolata Note contiene tutte quelle postille, aggiunte, riferimenti e chiarimenti minori che in un libro costituirebbero le cosiddette note a piè di pagina.

Le note sono particolarmente usate per soddisfare la linea guida di Cathopedia:Cita le fonti, per l'inserimento dei riferimenti bibliografici o di fonti su Internet, per chiarire informazioni controverse, o che appaiono evasive o di difficile reperimento. Per esempio, se si cita una statistica o il parere di un autore, è necessario inserire una nota con i riferimenti precisi.

Le istruzioni che seguono riguardano l'interfaccia di modifica tradizionale, che prevede l'accesso ad un'area di modifica e l'elaborazione di testo semplice e wikicodice. Se invece usi VisualEditor, consulta il suo manuale, in particolare, la sezione Aggiungere note a piè di pagina.

Dove inserire le note

La sezione riservata alle note va inserita verso il fondo della pagina, secondo il seguente schema standard:

{{Sezione accessoria|Note}}

{{Sezione accessoria|Bibliografia}}

{{Sezione accessoria|Voci correlate}}

{{Sezione accessoria|Collegamenti esterni}}

{{Sezioni accessorie fine}}

Attenzione: non inserire note dopo il tag <references />, non funzionerebbero e sarebbe invece visualizzato un vistoso messaggio di errore.

Anche se è presente una sola nota, la sezione va chiamata al plurale, "Note", e a maggior ragione vanno evitati tutti gli altri nomi (quali ad esempio "Fonti", "Riferimenti", "Note e bibliografia", e così via).

Inserimento delle note

Il testo della nota va inserito subito dopo la frase che si desidera annotare, non in fondo alla voce. Può essere infatti inserito in qualunque parte della pagina (tipicamente nel corpo della Voce), purché prima del tag <references />, potendosi usare tutti gli stili previsti da Cathopedia.

Per essere riconosciuto come nota, però, il testo deve essere inserito fra due tag <ref>…</ref> (vedi stile di inserimento delle note), nel seguente modo:

<ref>Testo della nota.</ref>

Nella sezione "Note" si deve scrivere solo:

== Note ==

<references />

Dove è stato inserito il testo della nota, apparirà un piccolo numero con il link alla nota come questo "", mentre nel paragrafo finale "Note" apparirà l'elenco delle note:

N.B. La numerazione delle note è automatica, non occorre dunque specificarne il numero.

• Importante: prima di salvare, controlla con l'Anteprima che tutto funzioni correttamente!. Se la pagina non è lunga è meglio aprire in modifica l'intera pagina, perché se modifichi solo una sezione, potrai visualizzare esclusivamente l'anteprima delle note relative a quella sezione e solo se sono definite nella stessa e pertanto potresti non renderti conto se ci sono problemi di sintassi.

N.B. Se vengono inseriti dei <ref> senza il rispettivo <references />, quest'ultimo verrà generato automaticamente in fondo alla pagina. È comunque una situazione da evitare, perché deve essere comunque creata la sezione "Note", nella giusta posizione.

Richiamo della stessa nota in più punti

A volte può capitare di dover richiamare più volte la stessa nota all'interno della pagina.

In questo caso si deve assegnare un nome (name) alla nota, usando uno dei seguenti modi:

   <ref name="Nome Nota">TestoNota </ref>
   <ref name=NomeNota>TestoNota</ref>
   <ref name=Nome_Nota>TestoNota </ref>

Al momento di fare nuovamente riferimento alla nota precedente, rispettivamente basterà scrivere:

   <ref name="Nome Nota" />
   <ref name=NomeNota />
   <ref name=Nome_Nota />

* Notare l'inserimento dello slash "/" (barra) prima della parentesi acuta di chiusa del marcatore, indispensabile affinché venga riconosciuto come richiamo e non come marcatore di inizio.

Avvertenze

• NON lasciare spazi vuoti nel nome se non si stanno usando i doppi apici: per dividere le parole è necessario usare un trattino basso " _ " (underscore) oppure inserire il nome della nota tra virgolette, altrimenti verrà visualizzato un messaggio di errore come questo:

Errore nell'uso del marcatore <ref>: nomi non validi (ad es. numero troppo elevato)

• NON assegnare più di un TestoNota allo stesso NomeNota, altrimenti verrà visualizzato un messaggio di errore come questo:

Errore nell'uso delle note: Tag <ref> non valido; il nome "NomeNota" è stato definito più volte con contenuti diversi (l'errore compare anche per contenuti identici ripetuti)

• NON inserire solo il nome della nota, senza un testo e senza il </ref> di chiusura: se ti limiti a scrivere solo <ref name=NomeNota>, il sistema darà errore.

• Prestare attenzione all'esatta corrispondenza tra i nomi: name="Nome Nota" è diverso da name="Nome_Nota" (con trattino basso al posto dello spazio); name="Nome Nota" è diverso da name="Nome nota" (mancata corrispondenza tra maiuscole e minuscole); name=”Nome Nota” è diverso da name="Nome Nota" (utilizzo di tipologie differenti di virgolette, la prima delle quali è deprecata).

Suggerimenti

• Ricorda che non sei l'unico autore della pagina, per cui i nomi assegnati alle note devono essere comprensibili con facilità a tutti gli utenti. Un nome adeguato, nel caso di pubblicazioni, è quello dell'autore del testo (con l'anno di pubblicazione, nel caso le pubblicazioni siano più di una) o il titolo del periodico o, comunque, della tipologia di fonte utilizzata, possibilmente limitandosi ad una sola parola. Si consiglia, insomma, di non utilizzare:
  • nomi eccessivamente lunghi o poco intuitivi;
  • abbreviazioni eccessive, singole lettere o acronimi difficili da interpretare;
  • nomi generici (del tipo "ref1");
• Anche in caso di molte note, è bene non utilizzare nomi simili o che possano essere confusi.
• Il parametro è sensibile alle maiuscole, ma date le precedenti avvertenze è meglio non creare note il cui nome differisca solo per il maiuscolo/minuscolo, per evitare confusione. È bene, anzi, usare solo lettere minuscole, garantendo in tal modo la massima uniformità di utilizzo.

Più fonti nella stessa nota

È anche possibile, quando necessario, inserire all'interno di una sola nota il richiamo a più fonti della voce che si sta trattando.

Se ad esempio il concetto espresso da corredare di fonti è richiamato da più autori utilizzati nella bibliografia della voce, è possibile citarli tutti all'interno di una sola nota, anziché formare più note singole per esprimere il medesimo concetto.

Per separare le varie fonti è sufficiente adoperare il punto e virgola (o dove lo si ritiene necessario il punto fermo):

<ref> TestoNota1; TestoNota2; TestoNota3; </ref>

È possibile adoperare questo metodo anche con il template {{Cita}}, per cui si otterrà:

<ref> <autore1> op. cit., p. xx; <autore2> op. cit., p. yy; <autore3> op. cit., p. zz; </ref>

Uso del Template:ref

Per facilitare la scrittura dei tag <ref></ref> è stato creato il template {{ref}}.

ATTENZIONE: il template non è progettato per essere inserito direttamente nelle voci, ma solo per aiutare la scrittura delle note. Va quindi usato con l'utilizzo del prefisso "subst":

{{subst:ref|TestoNota|NomeNota}}

Nella pagina salvata il template verrà automaticamente sostituito dal codice col tag <ref>.

• Qualora non si voglia assegnare alcun nome alla nota, basta lasciar vuoto il secondo parametro:

{{subst:ref|TestoNota}} 

• Per scrivere un richiamo ad un'altra nota, invece, basta scrivere:

{{subst:ref||NomeNota}}

Note su più colonne

Quando le note sono più di 10, e se la risoluzione video del lettore è adeguatamente ampia, il comando <references/> distribuisce automaticamente le note su più colonne di larghezza costante, evitando di spezzare una nota tra una colonna e l'altra. Questa funzionalità è disponibile dal marzo 2017, prima era necessario inserire a mano il template {{references}}.

L'incolonnamento è utile perché la sezione, quando contiene un gran numero di note, soprattutto se brevi, può diventare troppo lunga e sprecare spazio vuoto in orizzontale. Il limite minimo di 10 note e la larghezza fissa delle colonne fanno sì che non ci sia alcun incolonnamento quando è poco utile o quando sarebbe fastidioso per chi ha uno schermo piccolo. Se, per particolari motivi, si desidera evitare in ogni caso la creazione di più colonne, si può aggiungere l'attributo "responsive" con valore zero: <references responsive="0"/>.

Il numero effettivo di colonne visualizzate varia in modo automatico a seconda dell'aspect ratio dello schermo utilizzato, della dimensione del carattere, della risoluzione e della larghezza della finestra. In questo caso:

Attenzione: questo layout potrebbe non essere visualizzato in modo corretto su tutti i browser web; in genere, i browser che non lo supportano si limitano a elencare le note senza colonne, quindi non succede nulla di grave. Inoltre, qualora la nota riporti l'indicazione di un indirizzo web in chiaro e per esteso, quest'ultimo verrà stampato senza interruzione a capo; il rischio concreto è quello che il testo dell'indirizzo invada la colonna adiacente, sovrapponendosi alle note e compromettendone la leggibilità.

Se inoltre fosse veramente necessario inserire le note in colonne ancora più strette del normale (ad esempio quando gran parte delle note sono dei semplici {{Cita}}), è possibile utilizzare il template {{Note strette}}.

Raggruppamento delle note

È possibile raggruppare le note nel seguente modo:

   <ref group="Gruppo Nota">TestoNota</ref> 
   <ref group=GruppoNota>TestoNota</ref> 
   <ref group=Gruppo_Nota>TestoNota</ref>

e richiamare le singole note appartenenti a un solo gruppo utilizzando:

{{Sezione accessoria|Note}}
   <references group="Gruppo Nota"/>

Per richiamare più volte la stessa nota all'interno della pagina, è possibile combinare nome e gruppo:

   <ref name=NomeNota group=GruppoNota>TestoNota</ref>

e farne riferimento così:

   <ref name="NomeNota" group="GruppoNota" /> 

Il nome del gruppo viene mostrato per esteso prima del numeretto, in questo modo. La numerazione ricomincia da 1 per ogni gruppo.

I gruppi sono una funzionalità avanzata e spesso non necessaria. Pertanto, si raccomanda di:

• usare i gruppi solo in casi particolari: ad es., nel caso di note molto numerose o da mostrare in punti diversi
• usare nomi di gruppi molto brevi (lettere o abbreviazioni)
• evitare nomi di gruppi numerici (per non confonderli con i numeri delle note).

Note dentro note

Per una limitazione tecnica non è possibile inserire una nota all'interno di un'altra nota con il normale <ref>. Se proprio è necessario questo annidamento, lo si può fare inserendo la nota più esterna con il comando #tag. Ad esempio:

{{#tag:ref|Nota principale<ref>Nota annidata</ref>}}

Produce:

Anche in questo caso sono utilizzabili name e group:

{{#tag:ref|Nota principale<ref name="..." group="...">Nota annidata</ref>|name=...|group=...}}

Definizione delle note in formato lista

Se necessario, per una questione di leggibilità del wikicodice, è tecnicamente possibile definire tutte le note (o anche solo quelle che nel testo risulterebbero troppo ingombranti) elencandole all'interno dei tag <references>…</references>, che andranno a sostituire <references />. Occorre tuttavia valutare attentamente se questa funzione sia davvero necessaria: pur semplificando il wikicodice, rende meno immediata l'identificazione e la modifica delle note definite separatamente.

Ad esempio, scrivere:

Bla bla bla<ref>Questa è una classica nota</ref>
Bla bla bla<ref name="nota1">Questa è un'altra classica nota</ref>
Bla bla bla<ref name="nota1"/>
Bla bla bla<ref name="nota2">Questa è una nota troppo ingombrante!</ref>
Bla bla bla<ref name="nota3">Questa è un'altra nota troppo ingombrante!</ref>

<references/>

è equivalente a:

Bla bla bla<ref>Questa è una classica nota</ref>
Bla bla bla<ref name="nota1">Questa è un'altra classica nota</ref>
Bla bla bla<ref name="nota1"/>
Bla bla bla<ref name="nota2"/>
Bla bla bla<ref name="nota3"/>

<references>
<ref name="nota2">Questa è una nota troppo ingombrante!</ref>
<ref name="nota3">Questa è un'altra nota troppo ingombrante!</ref>
</references>

Esempi

Note singole e multiple

	Markup	Risultato
Inserimento della nota	Frase 1<ref name="nome1">Testo della nota da ripetere.</ref> Frase 2<ref name="nome1"/> Frase 3<ref name="nome1"/> Frase 4<ref>Testo di una nota singola.</ref>	Frase 1 Frase 2 Frase 3 Frase 4
Richiamo della nota	Alla fine del testo, nella sezione dedicata alle note a piè di pagina (intitolata "Note"), si inserisce il codice: <references/>

Per le note singole, cliccando la freccia blu si ritorna al punto del testo cui fa riferimento la nota; per le note multiple, si clicca sulla lettera in apice corrispondente.

Raggruppamenti

	Markup	Risultato
Inserimento della nota	Frase 1<ref group="nome gruppo">Testo della prima nota del gruppo "nome gruppo".</ref> Frase 2<ref group="nome gruppo">Testo della seconda nota del gruppo "nome gruppo".</ref> Frase 3<ref group="nome gruppo">Testo della terza nota del gruppo "nome gruppo".</ref> Frase 4<ref>Testo di una nota non appartenente al gruppo.</ref>	Frase 1 Frase 2 Frase 3 Frase 4
Richiamo della nota	Dove si vogliono richiamare le note del gruppo "nome gruppo", si inserisce il codice: <references group="nome gruppo"/>
	Alla fine del testo, nella sezione dedicata alle note a piè di pagina (intitolata "Note"), si inserisce il codice: <references/>

Stile di inserimento

• Ogni nota, all'interno dei <ref>...</ref> deve aprirsi con una maiuscola e chiudersi con un punto, senza spazi:

...testo non della nota,<ref>Testo della nota.</ref> testo non della nota...
...testo non della nota<ref>Testo della nota.</ref>, testo non della nota...

• Le note possono essere inserite prima o dopo dei segni di interpunzione:

1. ...dell'amministrazione comunale.
2. ...dell'amministrazione comunale.

Entrambi gli usi sono corretti e adottabili nella stesura delle voci. Importante è tuttavia mantenere la più completa omogeneità all'interno di ogni singola voce, adeguando i nuovi inserimenti allo stile già adottato.

Nota bene: sebbene le convenzioni ammettano entrambi gli stili citati, va tenuto presente che nella Cathopedia in italiano, a differenza di altre, l'indice della nota risulta piuttosto ingombrante per le dimensioni e per la presenza di parentesi. Nel caso si adotti lo stile di inserimento che pospone il segno di interpunzione alla nota, va tenuto conto che lo spostamento a destra del segno può essere eccessivo e la resa grafica, sia a video che in stampa, poco gradevole. È quindi sovente preferibile posporre la nota ai segni di interpunzione, come per esempio previsto nella Cathopedia in lingua inglese.

• Il <ref> di apertura deve seguire immediatamente la parola cui si riferisce la nota:

...parola<ref>Testo della nota...

• Qualunque stile d'inserimento si scelga, le note che si riferiscono al contenuto di un inciso fra parentesi o lineette devono essere all'interno dell'inciso stesso (nel secondo caso perché la nota non può essere preceduta dallo spazio, che le lineette richiedono), mentre le note che si riferiscono a una citazione (vedi il manuale di stile per lo stile di citazione) devono essere poste dopo la fine della citazione stessa, comprensiva delle eventuali virgolette:

...testo non della nota, fra parentesi<ref>Testo della nota.</ref>)  testo non della nota, fuori della parentesi...
...testo non della nota, fra lineette<ref>Testo della nota.</ref> –  testo non della nota, fuori dell'inciso..
...testo della citazione, fra virgolette»,<ref>Testo della nota.</ref> testo non della citazione, fuori delle virgolette...
...testo della citazione, fra virgolette»<ref>Testo della nota.</ref>, testo non della citazione, fuori delle virgolette...

• In presenza di WikiCode il <ref> di apertura va sempre posto dopo:

...parola]]'''<ref>Testo della nota...

• È sconsigliato l'uso di note nei titoli di sezioni e sottosezioni.

Convenzioni e template per alcuni tipi di testo nota

Per alcuni tipi di testo nota vi sono delle convenzioni e dei template per facilitarne la scrittura e utilizzare un formato standard e omogeneo, conforme a quanto previsto dalle convenzioni bibliografiche di Cathopedia.

• {{Cita conferenza}} per i convegni e le conferenze
• {{Cita corano}} per il Corano
• {{Cita libro}}
• {{Cita news}} per le fonti di notizie
• {{Cita pubblicazione}} per le pubblicazioni accademiche
• {{Cita web}} per i siti web
• {{Passo biblico}} per la Bibbia
• {{P.}} per citare i numeri di pagina

Altri template di citazione disponibili sono categorizzati in Categoria:Template citazione fonti.

Note duplicate e {{Cita}}

In una voce talvolta si fanno frequenti riferimenti allo stesso libro. Il semplice uso del tag <ref>...</ref> obbliga a ripetere ogni volta le informazioni del libro. Esiste tuttavia la possibilità di utilizzare il Template:Cita all'interno del tag <ref>...</ref> per citare più volte lo stesso libro, richiamando apposite "etichette" inserite in corrispondenza dei libri elencati nella bibliografia.
Il {{Cita}} funziona cioè esclusivamente in abbinamento con altri template, permettendo di evitare le ripetizioni nell'elenco delle note. È possibile dunque scrivere la bibliografia utilizzando i normali {{Cita libro}}, {{cita news}}, {{cita web}}, ma avendo cura di riempire in ciascuno di essi il parametro cid=... con detta "etichetta".

Per approfondire, vedi Template:Cita

Limitazioni

A causa di una limitazione del software, all'interno delle note non è possibile utilizzare il subst, le firme e i pipe trick. In questi casi, è possibile aggirare il problema utilizzando {{subst:#tag:ref|testo della nota}} per inserire i tag <ref>…</ref>.

Voci correlate

• {{Vedi anche}}: richiamo ad argomenti approfonditi in altre voci
• {{NN}}: per voci con riferimenti bibliografici non contestualizzati