> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrazione con Zotero

> Consenti agli utenti di importare in un progetto un file .bib dalla propria libreria Zotero.

> [!NOTE]
>
> Questa funzionalità è stata sviluppata inizialmente da [davrot](https://github.com/davrot) e [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep) e modificata da [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) con OAuth. È stata introdotta a partire dalla v6.2.0. È ancora in fase beta. Se riscontri problemi, abbiamo bisogno del tuo feedback.

![](https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-b751b9f6.png?fit=max\&auto=format\&n=x9kfDjtWlyyhG_mR\&q=85\&s=80eb902caf484c8cfc1c776017ac2c66)

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-41.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=366c8e9396506163e23ffdc92fbe8c02)

### Configurare l'integrazione con Zotero

1. Apri [questo link](https://www.zotero.org/oauth/apps) per creare un client OAuth di Zotero (come mostrato nell'immagine)
2. Scegli **Application Type**: **Browser**
3. Imposta il Callback URL con il tuo `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback`
4. Configura il tuo `config/variables.env`

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-42.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=7b2ed79ba28f7d77bc07711068ca71fc)

```dotenv title="config/variables.env" theme={null}
#################
#    Zotero     #
#################
# 'zotero' must be in ENABLED_LINKED_FILE_TYPES (set in develop/docker-compose.yml)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,zotero

# From a Zotero OAuth client (register at https://www.zotero.org/oauth/apps)
# Application Type: Browser 
# Callback URL -> ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
ZOTERO_CLIENT_ID=
ZOTERO_CLIENT_SECRET=
# Encrypts the Zotero API key in mongo (set in dev to avoid writing a key file
# to /var/lib/overleaf/data, which the dev web container can't create)
# How to generate: `openssl rand -hex 32`
ZOTERO_CIPHER_PASSWORD=dev-zotero-cipher-password
# Optional: route the module's server-side Zotero requests (OAuth + API) through
# an HTTP proxy (must be reachable from the web container; same as github-sync)
# http://10.0.0.1:10808
# (Optional) ZOTERO_PROXY_URL=
```

### Note

> [!WARNING]
>
> Quando aggiorni un'installazione esistente che contiene file di bibliografia collegati a Zotero alla versione 6.3.0 ripubblicata, segui le [#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/it/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Le nuove installazioni non necessitano di questa migrazione.

> [!CAUTION]
>
> Poiché Ayakaleaf è una piattaforma collaborativa, per migliorare la sicurezza, a partire dalla versione 6.3.0 solo il creatore originale di un file `bib` di riferimenti potrà aggiornare il file importato.

Ad esempio, supponiamo che il proprietario del progetto, l'Utente A, abiliti la condivisione tramite link e crei nel progetto un file `test.bib` collegandolo al proprio account Zotero. Se un altro utente, l'Utente B, accede al progetto tramite il link condiviso, l'Utente B potrà comunque leggere e scaricare `test.bib`, ma non potrà aggiornare né reimportare il file da Zotero. Solo l'Utente A, in quanto creatore originale del file di riferimenti, può eseguire gli aggiornamenti. In altre parole, solo il creatore originale del file `.bib` ha il permesso di aggiornarlo.

### Q\&A

> [accordion] Come uso Zotero in un progetto?
>
> **Risposta:** Dopo aver collegato Zotero in **Account Settings**, apri un progetto e fai clic su **New file → From Zotero**. Scegli un nome di file, `zotero.bib` per impostazione predefinita, e la libreria, quindi crea il file. Cita le sue voci come di consueto, ad esempio con `\bibliography{zotero}`.
>
> Il file è in sola lettura nell'editor. Dopo aver modificato la tua libreria Zotero, apri il file e fai clic su **Refresh** per importarlo di nuovo.

> [accordion] Perché «Main bibliography file for this project» è vuoto o disabilitato?
>
> **Risposta:** Questa impostazione elenca solo i file `.bib` modificabili nell'editor. I file importati da Zotero sono in sola lettura, quindi non vengono elencati. È il comportamento previsto: puoi comunque citarne le voci.

> [accordion] La mia istanza deve essere raggiungibile da Internet?
>
> **Risposta:** No. Il collegamento di Zotero passa dal browser dell'utente, quindi solo il server deve raggiungere Zotero. Se per farlo serve un proxy, imposta `ZOTERO_PROXY_URL`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.