Integrazione con Zotero

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

Questa funzionalità è stata sviluppata inizialmente da davrot e yu-i-i/overleaf-cep e modificata da 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.

​

Configurare l’integrazione con Zotero

1. Apri questo link 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

config/variables.env

#################
#    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

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. Le nuove installazioni non necessitano di questa migrazione.

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

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.

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.

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.