I riferimenti bibliografici sono una componente fondamentale dei testi accademici: non un semplice elenco di fonti, ma un sistema pensato per supportare ogni affermazione, attraverso l'indicazione di fonti rintracciabili, garantendo trasparenza e riproducibilità.

Questa è la ragione per cui esistono tante complicate convenzioni di citazione che si iniziano a conoscere di solito all’università, e che sono legate tanto ai diversi settori disciplinari, quanto alle lingue, alle singole riviste o case editrici.

Fortunatamente, esistono software per la gestione delle bibliografie che svolgono la doppia funzione di:

• facilitare la raccolta e l'organizzazione delle fonti, nonché le note e gli appunti (“bibliografia”);
• e di facilitare l’inserimento dei riferimenti nei testi (“citations”) in maniera coerente rispetto ad uno stile di citazione dato (APA, MLA, Chicago, ecc.).

Generalmente, questi sistemi si basano sul sistema BibTeX, nato per essere utilizzato in LaTeX, ma che oggi è usato anche in Pandoc, e dunque in Markdown, RMarkdown, Word, e altri sistemi di scrittura.

I due software più diffusi, entrambi gratuiti, sono Zotero e Mendeley.

Zotero, come vedremo, è meglio integrato negli editor visuali di RStudio e Positron (in Quarto e RMarkdown).

Di base, il sistema si basa su due file:

• il file .bib con la bibliografia (l'elenco delle fonti)
• il file .csl con le regole di citazione (autore-anno, in nota, ecc.), da associare ad una lingua (per la punteggiatura, i numeri e altre convenzioni)

I due file vanno inseriti nella cartella del progetto¹⁾, e indicati nel blocco YAML del front matter, dove andranno indicate le opzioni che verranno passate a Pandoc direttamente da RMarkdown o Quarto (di seguito, abbiamo indicato anche la lingua):

---
title: "Titolo del documento"
author: "Mio Nome"
bibliography: mia-biblio.bib
csl: apa.csl
lang: it
---

Il file .bib è un file di testo che contiene lista di record bibliografici, ciascuno identificato da una chiave univoca (citation key: foucault_parole_1985).

@book{foucault_parole_1985,  
  title = {{Le parole e le cose: un'archeologia delle scienze umane}},  
  author = {Foucault, Michel},  
  year = 1985,  
  publisher = {Rizzoli},  
  address = {Milano},  
  isbn = {88-17-12158-4 978-88-17-12158-3}  
}

Questo file può essere creato, gestito ed esportato da Zotero o da un altro sistema di gestione delle bibliografie.

La citation key è l’identificativo unico del record, che andrà inserito nel testo, preceduto da @: Pandoc cercherà il record nel file .bib attraverso questo identificativo, e inserirà la citazione nel testo, formattata secondo le regole dello stile di citazione, e il riferimento nella bibliografia finale.

Nel corpo del documento Markdown, in pratica, si inserirà una citazione seguendo le regole presentate in Tabella 2).

Secondo @foucault_parole_1985, le formazioni discorsive sono indissolubilmente legate al potere.

E nel documento finale (es. in PDF o DOCX), troveremo la citazione formattata.

Secondo Foucault (1985), le formazioni discorsive sono indissolubilmente legate al potere.

oppure

Le formazioni discorsive sono indissolubilmente legate al potere [@foucault_parole_1985].

Le formazioni discorsive sono indissolubilmente legate al potere (Foucault 1985).

Per ulteriori opzioni della sintassi, vedi la guida di Pandoc

È anche importante indicare la lingua nel front matter, in quanto influenza il rendering del testo. Ad esempio, la posizione delle note (prima o dopo la punteggiatura), o la lingua delle stesse citazioni: “Smith & Doe, Eds., 2005” (inglese), vs. “Smith e Doe, a c. di, 2005” (italiano)²⁾.

Per inserire nella bibliografia testi non esplicitamente citati, questi potranno essere aggiunti nel front matter:

---
nocite: |
  @tizio03, @caio88
---

Ad esempio:

---
title: "Titolo del documento"
author: "Mio Nome"
bibliography: mia-biblio.bib
csl: apa.csl
lang: it
nocite: |
  @tizio03, @caio88
---
 
@smith04 sostiene che ...

I riferimenti bibliografici includeranno @tizio03, @caio88 e @smith04.

I riferimenti bibliografici (ovvero l'elenco dei testi citati), a meno che non diversamente indicato, verranno inseriti alla fine del documento³⁾.

Poiché esistono diverse convenzioni per le citazioni, il file .csl definisce il modo in cui si farà riferimento alle fonti, sia nel corpo del testo sia nella bibliografia finale.

Zotero supporta (e permette di esportare) tutti gli stili principali (Chicago, MLA, APA, Vancouver, ecc.) e stili specifici di migliaia di riviste ed editori. Altrimenti, gli stili possono essere scaricati dal sito dell'editore o della società scientifica, oppure dal sito https://citationstyles.org/.

La figura 1 mostra alcuni stili: la prima riga mostra il formato della citazione; la seconda riga mostra il formato del riferimento all'interno della bibliografia.

Typora è un editor di markdown visuale e minimale a cui faccio cenno qui in quanto è l'unico che apre i file rmd e qmd. Non esegue ovviamente i blocchi di codice, ma neanche li altera. Può essere utile per rivedere il testo senza la “distrazione” del codice e dell'analisi.

Al momento non supporta nativamente il sistema dei riferimenti bibliografici. Per generare un documento con i riferimenti bibliografici, è necessario passare direttamente da Pandoc, indicando nel frontmatter il file di bibliografia e di stile, ed impostando una voce Custom nel menu di Esportazione.

Dal menu File > Impostazioni > Esportazione:

Nella casella “Comando”, si scriverà:

pandoc "${currentFileName}.md" -o "${outputPath}" --citeproc

Il formato del file di esportazione verrà ricavato dal percorso e dall'estensione (es.: .docx) del file.

Non tutta la sintassi supportata da Typora potrebbe essere supportata da Pandoc o dal file di destinazione (Typora, così come RMarkdown o Quarto, elaborano i file prima di passarli a Pandoc; vedi Pandoc: guida introduttiva).