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

# Intégration Zotero

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

> [!NOTE]
>
> Cette fonctionnalité a été initialement développée par [davrot](https://github.com/davrot) et [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), puis modifiée par [ayaka-notes/ayakaleaf-pro](https://github.com/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.

![](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)

### Configurer l'intégration Zotero

1. Ouvrez [ce lien](https://www.zotero.org/oauth/apps) 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`

![](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=
```

### Remarques

> [!WARNING]
>
> 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](https://ayakaleaf-pro.mintlify.site/fr/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Les nouvelles installations n'ont pas besoin de cette migration.

> [!CAUTION]
>
> 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

> [accordion] 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.

> [accordion] 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.

> [accordion] 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`.


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