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

> Liez votre compte Zotero, importez une bibliothèque dans un fichier .bib, citez à partir de celui-ci, actualisez-le et supprimez la liaison.

Importez une bibliothèque Zotero dans un projet sous forme de fichier `.bib`, puis citez à partir de celui-ci comme d'habitude. Le fichier est une copie : il ne change que lorsque vous cliquez sur **Refresh**.

> [!NOTE]
>
> Si vous ne voyez aucune option Zotero dans **Account settings**, demandez à votre administrateur d'activer l'[intégration Zotero](https://ayakaleaf-pro.mintlify.site/fr/on-premises/configuration/overleaf-toolkit/integrations/zotero-integration.md).

## Lier votre compte Zotero

Vous ne le faites qu'une seule fois.

**1. Ouvrir les paramètres de votre compte**

Cliquez sur **Account**, puis sur **Account settings**. Sous **Reference managers**, trouvez **Zotero** et cliquez sur **Link to Zotero**.

![La section Zotero des paramètres du compte avec un bouton Link to Zotero](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-link.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=bd8103eadfb8c79e5d2f58a83a5ac33e)

Zotero dans les paramètres du compte

La carte **Zotero** du panneau **Integrations** de l'éditeur vous amène au même endroit, dans le même onglet.

![Le panneau Integrations avec la carte Zotero](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-integrations.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=ee6c0da4ffd26db23956a92eebf60765)

Le panneau Integrations

**2. Autoriser sur Zotero**

Zotero s'ouvre. Connectez-vous si on vous le demande, puis autorisez l'application. Elle demande uniquement à lire votre bibliothèque et vos groupes : elle ne peut donc rien modifier dans Zotero.

**3. Vérifier la liaison**

Vous revenez aux paramètres du compte. Un message vert indique **Reference manager linked**, et le bouton affiche désormais **Unlink**.

![La section Zotero des paramètres du compte avec un message vert et un bouton Unlink](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-linked.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=185a0e5c172d3a5f6a9e50a325f32cf3)

Votre compte Zotero est lié

Si vous n'autorisez pas l'accès sur Zotero, la même section indique **Sorry, something went wrong**. Cliquez sur **Link to Zotero** pour réessayer.

## Créer un fichier à partir de votre bibliothèque

**1. Ouvrir la boîte de dialogue Add files**

Ouvrez un projet. Dans l'arborescence des fichiers, cliquez sur **New file**, puis sur **From Zotero**. Cette entrée n'apparaît qu'une fois votre compte lié.

**2. Choisir le nom du fichier et la bibliothèque**

**File Name** vaut d'abord `zotero.bib`. Conservez l'extension `.bib` : sans elle, vous n'avez pas d'aperçu, et ni `\cite` ni `\bibliography` ne trouvent ses entrées.

**Library** vaut d'abord **My Library** et liste aussi vos bibliothèques de groupe. Un fichier contient une bibliothèque.

![L'onglet From Zotero de la boîte de dialogue Add files avec zotero.bib et My Library](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-new-file.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=707728eb955b49101ab3977d1b19baa6)

Un fichier issu de votre bibliothèque personnelle

**3. Cliquer sur Create**

La boîte de dialogue se ferme et le fichier apparaît dans l'arborescence. Cliquez dessus : il indique quand il a été importé, ainsi que ses entrées. Vous ne pouvez pas le modifier dans l'éditeur.

![Le fichier zotero.bib importé ouvert dans l'éditeur avec un bouton Refresh](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-file.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=b2d3560f942619fcc479ea875e7f7957)

Le fichier importé

Si **Create** semble ne rien faire, un fichier portant ce nom existe déjà. Choisissez un autre nom.

### Importer une bibliothèque de groupe

Recommencez avec un nom de fichier propre et choisissez le groupe sous **Library**. Un projet peut contenir plusieurs de ces fichiers.

![L'onglet From Zotero avec le nom de fichier reading-group.bib et la bibliothèque Reading group](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-group.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=a5cb43fdf5d97546eb1609160147aeee)

Un fichier issu d'une bibliothèque de groupe

## Citer à partir du fichier

**1. Commencer une citation**

Dans un fichier `.tex`, tapez `\cite{`. La liste affiche les entrées de tous les fichiers `.bib` du projet. Cliquez sur l'une d'elles pour l'insérer.

![L'éditeur listant des clés de citation sous une citation](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-cite.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=394bda9a2a326e5d878fc16932ec0322)

Les entrées des fichiers importés

**2. Ou rechercher par titre ou par auteur**

Cliquez sur **Search** sous la liste, ou appuyez sur Ctrl+Espace entre les accolades. Tapez pour filtrer, cliquez sur une ou plusieurs entrées, puis sur **Insert**.

![La boîte de dialogue Search the .bib files in this project avec une entrée sélectionnée](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-search.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=027a2212a2b3cb83b7017014fe40ce22)

La recherche de références

**3. Ajouter la bibliographie**

Ajoutez ces lignes avant `\end{document}`, en utilisant les noms de vos fichiers sans `.bib`, séparés par des virgules :

```latex theme={null}
\bibliographystyle{plain}
\bibliography{reading-group,zotero}
```

Cliquez sur **Recompile**. La référence apparaît dans le PDF.

![L'éditeur avec la citation et la bibliographie, et le PDF compilé avec une référence](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-compiled.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=9c593d72f5d12495dc4ec2863dd0546d)

La référence compilée

Les fichiers importés ne sont pas proposés dans **Settings** sous **References**, **Main bibliography file for this project** : la liste reste donc vide si le projet n'a pas d'autre fichier `.bib`. Vous pouvez quand même citer à partir d'eux.

![L'onglet References des paramètres du projet avec une liste vide et désactivée](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-settings-references.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=48dad4818c2dac63afc46decea21790f)

La liste vide est normale

## Actualiser le fichier

Les modifications de votre bibliothèque Zotero n'arrivent pas d'elles-mêmes dans le projet, et la compilation ne les récupère pas.

**1. Ouvrir le fichier**

Dans l'arborescence des fichiers, cliquez sur le fichier importé.

**2. Cliquer sur Refresh**

Le fichier entier est réimporté depuis la bibliothèque choisie lors de sa création : les nouvelles entrées apparaissent et celles supprimées disparaissent. L'heure affichée en haut change.

![Le fichier zotero.bib actualisé avec une nouvelle entrée et une nouvelle heure d'importation](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-refresh.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=aa095ac91264ef0e4517a860fb94b5c9)

Le fichier actualisé

**3. Recompiler**

Les nouvelles entrées figurent tout de suite dans la liste `\cite{`. Cliquez sur **Recompile** pour mettre à jour le PDF.

Chaque fichier s'actualise séparément : actualisez à part le fichier de votre groupe. Pour savoir qui peut actualiser un fichier dans un projet partagé, consultez les [remarques pour les administrateurs](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/integrations/zotero-integration.md#notes).

## Supprimer la liaison de votre compte Zotero

Dans **Account settings**, sous **Zotero**, cliquez sur **Unlink**, puis de nouveau sur **Unlink** dans la boîte de dialogue. Le bouton affiche à nouveau **Link to Zotero**.

![La boîte de dialogue Unlink Zotero Account](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-unlink.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=3783d8622dee66277c2420154294220e)

Supprimer la liaison de votre compte

Les fichiers importés restent dans vos projets et se compilent toujours. **From Zotero** disparaît de la boîte de dialogue **Add files**, et **Refresh** affiche une erreur jusqu'à ce que vous liiez à nouveau votre compte.

![Un fichier importé avec l'erreur Could not load references from Zotero, please re-link your account and try again](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-relink-error.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=d0c678b299fa6604d857398aad9bca18)

Actualisation sans compte lié

Une fois le compte lié à nouveau, **Refresh** fonctionne sur les mêmes fichiers.

## En cas de problème

**Could not load references from Zotero, please re-link your account and try again**, ou **There was an error accessing your Zotero data** dans la boîte de dialogue **Add files** : Overleaf ne peut plus lire votre bibliothèque, par exemple parce que vous avez retiré son accès sur Zotero. Dans **Account settings**, cliquez sur **Unlink**, puis sur **Link to Zotero**. D'ici là, **Create** échoue aussi, avec le message **The project that contains this file is not shared with you**, même dans votre propre projet.

![L'onglet From Zotero avec les deux messages d'erreur](https://mintcdn.com/ayakaleaf-pro/Obqf0nQWnHIHMjO7/images/on-premises/zotero-access-error.png?fit=max\&auto=format\&n=Obqf0nQWnHIHMjO7\&q=85\&s=65bee2963ce16aec585fb55945e6554d)

Overleaf ne peut plus lire votre bibliothèque

**The remote service produced an error** lorsque vous cliquez sur **Refresh** : la requête vers Zotero a échoué. Le fichier conserve son contenu. Cliquez à nouveau sur **Refresh** plus tard.


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