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

# Recherche avancée de références

> Trouvez une référence par son auteur, son titre, sa revue ou son année, et insérez-la dans une citation.

La recherche de références parcourt tous les fichiers `.bib` de votre projet : vous trouvez ainsi une référence sans vous souvenir de sa clé de citation. Rien n'est à configurer.

Votre projet a besoin d'au moins un fichier `.bib`. Vous pouvez en téléverser un, ou importer votre bibliothèque depuis [Zotero](https://ayakaleaf-pro.mintlify.site/fr/on-premises/user-guide/users/zotero-integration.md) ou [Mendeley](https://ayakaleaf-pro.mintlify.site/fr/on-premises/user-guide/users/mendeley-integration.md).

## Insérer une citation

**1. Commencer une citation**

Dans un fichier `.tex`, tapez `\cite{`. L'éditeur ajoute l'accolade fermante. Sous le curseur, vous voyez les clés de citation et un encadré bleu, **Open advanced reference search**.

![L'éditeur avec \cite\{}, la liste des clés de citation et l'encadré bleu avec un bouton Search](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-hint.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=1438156d0ee9a9c866987e23c0aa8a15)

L'encadré bleu sous une citation

Le bouton **Insert citation** de la barre d'outils, ainsi que **Insert** puis **Citation**, commencent aussi un `\cite{}` pour vous. L'encadré apparaît également pour d'autres commandes de citation, comme `\citep`, `\autocite`, `\parencite` et `\textcite`.

**2. Ouvrir la recherche**

Cliquez sur **Search** dans l'encadré bleu, ou appuyez sur Ctrl+Espace entre les accolades. La boîte de dialogue liste toutes les entrées, avec leur titre, clé de citation, auteur, revue et année.

![La boîte de dialogue Search the .bib files in this project listant cinq entrées](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-dialog.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=e6ee13f3a5f3b1f95c2dbeb9d2cc1e29)

Toutes les entrées du projet

**3. Trouver l'entrée**

Tapez dans le champ de recherche. Il cherche dans la clé de citation, l'auteur, le titre, la revue et l'année, et surligne ce qu'il trouve. Chaque mot doit correspondre : `turing 1936` trouve donc l'article de Turing de 1936. Les autres champs, comme l'éditeur, ne sont pas recherchés.

![Le champ de recherche avec turing 1936 et une entrée avec les correspondances en rouge](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-filter.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=7690a4c194fdf292980d229b60ef6f1e)

Recherche par auteur et par année

**4. Choisir une ou plusieurs entrées**

Cliquez sur une entrée. Elle devient verte et sa clé apparaît au-dessus de la liste. Pour en ajouter une autre, cliquez dessus ou lancez une nouvelle recherche : vos choix sont conservés. Pour en retirer une, cliquez de nouveau dessus ou sur le **×** à côté de sa clé.

![Les clés knuth1984 et einstein1905 au-dessus de la liste, et leurs entrées en vert](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-selected.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=a660175f9908e03c671ed61062f4ef8f)

Deux entrées choisies

**5. Cliquer sur Insert**

Les clés apparaissent entre les accolades, séparées par des virgules. Si votre document n'a pas encore de bibliographie, ajoutez ces lignes avant `\end{document}`, en utilisant les noms de vos fichiers `.bib` sans l'extension :

```latex theme={null}
\bibliographystyle{plain}
\bibliography{refs,more}
```

Cliquez sur **Recompile**. Les références apparaissent dans le PDF.

![L'éditeur avec \cite\{knuth1984, einstein1905} et le PDF avec les deux références](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-compiled.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=b0928f1bbd09e6cb56ecc1b2ed239ccd)

La citation compilée

La recherche fonctionne de la même façon dans l'éditeur **Visual**.

## Modifier une citation

**Ajouter une référence :** placez le curseur entre les accolades d'une citation existante et ouvrez la recherche. **Insert** ajoute les nouvelles clés après celles déjà présentes.

**Remplacer des références :** sélectionnez les clés dans l'éditeur, puis appuyez sur Ctrl+Espace. Les clés apparaissent au-dessus de la liste et le bouton indique désormais **Replace**. Retirez celles dont vous ne voulez pas, ajoutez-en d'autres, puis cliquez sur **Replace**. Une clé qui ne figure dans aucun fichier `.bib` reste jusqu'à ce que vous la retiriez.

![La boîte de dialogue avec knuth1984, missing2000 et turing1936 au-dessus de la liste et le bouton Replace](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/reference-search-replace.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=74a8cac10eb8fff69c5961039e678004)

Remplacer les clés sélectionnées

## Utiliser le clavier

| Touche | Ce qu'elle fait |
| - | - |
| **Flèche bas** | Passe du champ de recherche à la liste, puis descend dans la liste |
| **Flèche haut** | Remonte dans la liste |
| **Espace** | Choisit l'entrée, ou la retire de vos choix |
| **Entrée** | Insère vos choix, lorsque vous êtes dans la liste |
| **Tab** | Passe du champ de recherche à la liste et aux boutons |
| **Échap** | Ferme la boîte de dialogue sans rien modifier |

## D'où viennent les entrées

La recherche couvre tous les fichiers `.bib` du projet, y compris ceux importés depuis Zotero ou Mendeley. Lorsque vous modifiez un fichier `.bib`, la recherche suivante trouve les nouvelles entrées.

## En cas de problème

| Ce que vous voyez | Pourquoi | Que faire |
| - | - | - |
| La liste de la boîte de dialogue est vide | Le projet n'a aucun fichier `.bib` | Téléversez-en un ou créez-en un |
| Pas d'encadré bleu, et Ctrl+Espace liste des commandes LaTeX | Le curseur n'est pas entre les accolades d'une citation | Cliquez entre les accolades |
| Ctrl+Espace ne fait rien | Votre ordinateur utilise ce raccourci pour autre chose | Cliquez sur **Search** dans l'encadré bleu |
| Une entrée est introuvable | La recherche ne couvre que la clé, l'auteur, le titre, la revue et l'année | Recherchez par l'un de ces champs |


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