Intégration Zotero

Permettez aux utilisateurs d’importer un fichier .bib depuis leur bibliothèque Zotero dans un projet.

Cette fonctionnalité a été initialement développée par davrot et yu-i-i/overleaf-cep, puis modifiée par ayaka-notes/ayakaleaf-pro pour utiliser OAuth. Elle est disponible à partir de la v6.2.0. Elle est encore en version bêta. Si vous rencontrez un problème, nous avons besoin de vos retours.

​

Configurer l’intégration Zotero

1. Ouvrez ce lien pour créer un client OAuth Zotero (comme le montre l’image)
2. Choisissez Application Type : Browser
3. Définissez l’URL de rappel (Callback URL) sur ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
4. Configurez votre 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=

​

Remarques

Lors de la mise à niveau vers la version 6.3.0 republiée d’une installation existante comportant des fichiers de bibliographie liés à Zotero, suivez les #ayakaleaf-pro-6.3.0. Les nouvelles installations n’ont pas besoin de cette migration.

Ayakaleaf étant une plateforme collaborative, afin de renforcer la sécurité, à partir de la version 6.3.0, seul le créateur d’origine d’un fichier de références bib est autorisé à mettre à jour le fichier importé.

Par exemple, supposons que le propriétaire du projet, l’utilisateur A, active le partage par lien et crée dans le projet un fichier test.bib lié à son propre compte Zotero. Si un autre utilisateur, l’utilisateur B, accède au projet via le lien partagé, il pourra toujours lire et télécharger test.bib, mais ne sera pas autorisé à mettre à jour ni à réimporter le fichier depuis Zotero. Seul l’utilisateur A, en tant que créateur d’origine du fichier de références, peut effectuer des mises à jour. Autrement dit, seul le créateur d’origine du fichier .bib a l’autorisation de le mettre à jour.

​

Questions/réponses

Comment utiliser Zotero dans un projet ?

Réponse : Après avoir lié Zotero dans Account Settings, ouvrez un projet et cliquez sur New file → From Zotero. Choisissez un nom de fichier, zotero.bib par défaut, ainsi que la bibliothèque, puis créez le fichier. Citez ses entrées comme d’habitude, par exemple avec \bibliography{zotero}.

Le fichier est en lecture seule dans l’éditeur. Après avoir modifié votre bibliothèque Zotero, ouvrez le fichier et cliquez sur Refresh pour l’importer à nouveau.

Pourquoi « Main bibliography file for this project » est-il vide ou désactivé ?

Réponse : Ce paramètre ne liste que les fichiers .bib modifiables dans l’éditeur. Les fichiers importés depuis Zotero sont en lecture seule ; ils ne sont donc pas listés. C’est le comportement attendu : vous pouvez toujours citer leurs entrées.

Mon instance doit-elle être accessible depuis Internet ?

Réponse : Non. La liaison de Zotero passe par le navigateur de l’utilisateur ; seul le serveur doit donc pouvoir joindre Zotero. S’il a besoin d’un proxy pour cela, définissez ZOTERO_PROXY_URL.