# Citations et bibliographie

Trouver une source, examiner ses métadonnées, l'ajouter à la bonne bibliographie, la citer au curseur, choisir un style de citation Typst et nettoyer une bibliothèque sans perdre l'original.

Une citation est une chaîne : l'affirmation pointe vers une clé, la clé pointe vers une entrée de bibliographie et l'entrée pointe vers une source réelle. Oleafly garde cette chaîne visible pour qu'une recherche rapide ne devienne pas une référence mystérieuse plus tard.

![Le panneau Références d'Oleafly. Basculez entre Références, Citations et Symboles ; filtrez la vue courante depuis le champ de recherche.](https://cdn.oleafly.com/images/screenshots/desktop/docs/references-panel-dark-window-v2.png#view=0,45,344,703)

## Citer en écrivant

![Citer depuis le projet ouvre le sélecteur de bibliographie. Cherchez par clé, auteur ou titre ; Trouver et ajouter une nouvelle citation ouvre la recherche en ligne.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-citation-picker-dark-window-v2.png#view=415,77,365,467)

Dans la barre d'outils LaTeX ou Typst, choisissez **Citer depuis le projet** (l'icône `@`). Cherchez dans la bibliographie courante par clé, auteur ou titre, puis sélectionnez une entrée.

Vous pouvez aussi lancer **Ajouter une citation** depuis la palette de commandes ⌘K ou Ctrl+K. Oleafly insère la syntaxe du projet actif :

- `\cite{key}` en LaTeX ;
- `@key` en Typst, en ajoutant une ligne `#bibliography(...)` à la fin du document principal quand il n'en a pas ;
- `[@key]` en Markdown, en ajoutant une ligne `bibliography:` au front matter si nécessaire.

Avec Zotero connecté, **Ajouter une citation** liste d'abord les correspondances de votre bibliothèque Zotero.

## Citer depuis votre bibliothèque Zotero

Une fois [Zotero connecté](/docs/integrations/research-sources/#zotero), tapez `@` et une partie du nom d'un auteur, un mot du titre, une année ou une clé. Toute votre bibliothèque Zotero apparaît à côté des références propres au projet. Choisissez un article et Oleafly insère la citation comme le document cite déjà. LaTeX reçoit la commande que le document utilise le plus, comme `\citep` ou `\parencite` ; Typst reçoit `@key`, et Markdown reçoit `[@key]`. Taper `@` à l'intérieur d'un `\cite{...}` existant y ajoute une clé de plus.

Seule cette entrée entre dans le `.bib` du projet, à la fin du fichier, et le reste du fichier reste tel quel. Un article déjà présent dans le `.bib`, sous sa clé ou son DOI, n'est jamais ajouté deux fois. Les entrées n'incluent jamais les chemins des PDF de votre ordinateur. Si le projet n'a pas encore de ligne de bibliographie, Oleafly en ajoute une : `\bibliography` ou `\addbibresource` en LaTeX, `#bibliography` en Typst, ou `bibliography:` dans le front matter Markdown. Quand le projet compte plusieurs fichiers `.bib`, Oleafly demande une seule fois quel fichier reçoit les nouvelles références et se souvient de votre réponse.

La première fois que vous citez depuis Zotero dans un article LaTeX qui liste ses références à la main, dans un environnement `thebibliography`, Oleafly propose de déplacer cette liste dans le `.bib`. Chaque référence partage alors une seule liste numérotée.

### Garder le .bib synchronisé avec Zotero

Une clé citée, absente du `.bib` mais présente dans Zotero, propose **Ajouter depuis Zotero**. Lancez **Ajouter depuis Zotero les citations manquantes** depuis la palette ⌘K pour vérifier toutes les clés citées d'un coup. La commande ajoute celles que Zotero possède, liste celles qui manquent et signale les clés qui citent un article déjà présent dans votre bibliographie.

Quand un article change dans Zotero, son entrée `.bib` propose **Mettre à jour depuis Zotero**. **Mettre à jour les entrées .bib depuis Zotero** dans la palette passe en revue chaque entrée modifiée. Une entrée que vous avez modifiée à la main n'est remplacée qu'après votre confirmation. **Synchroniser la bibliothèque Zotero** relit la bibliothèque. Oleafly ne retire jamais rien du `.bib` de sa propre initiative.

![Une partie du titre d'un article collée, et son entrée BibTeX enregistrée dans refs.bib.](https://cdn.oleafly.com/images/gifs/desktop/add-citation.gif?v=2)

## Trouver et ajouter une nouvelle référence

Choisissez **Trouver et ajouter une nouvelle citation** dans le sélecteur. Commencez par l'un de ceux-ci :

- un DOI comme `10.1145/3592979` ;
- un identifiant arXiv comme `1706.03762` ;
- un ISBN-10 ou ISBN-13 ;
- un ID PubMed (PMID) ;
- une URL contenant l'un de ces identifiants ;
- un titre d'article.

Les recherches par DOI, arXiv, ISBN et PubMed utilisent leurs catalogues publics. Une recherche par titre renvoie les correspondances possibles avec auteurs, année et revue, pour que vous choisissiez au lieu d'accepter une supposition.

Examinez le BibTeX renvoyé, puis choisissez **Ajouter au .bib et citer**. Oleafly :

1. ajoute une clé sans collision à la bibliographie active ;
2. réutilise une entrée existante quand le DOI est déjà présent ;
3. insère la citation à l'emplacement du curseur ;
4. rafraîchit immédiatement l'arborescence de fichiers et le panneau Références.

Les métadonnées sont modifiables. Corrigez la fiche avant qu'elle ne fasse partie du manuscrit.

Quand le document déclare plusieurs bibliographies, le dialogue affiche un menu **Bibliographie**. L'entrée va dans le fichier que vous choisissez, et Oleafly se souvient de ce choix pour ce projet.

## Comment Oleafly choisit la bibliographie

Les projets LaTeX suivent les déclarations du document principal effectif :

- `\addbibresource{references.bib}` pour `biblatex` ;
- `\bibliography{references}` pour les flux de travail BibTeX.

Les chemins sont résolus avec le même comportement d'extension et de chemin relatif que celui qu'attend la chaîne d'outils TeX. Une déclaration qui pointe vers un fichier manquant est signalée à la ligne du source concernée, au lieu d'écrire en silence ailleurs.

Les projets Typst suivent l'appel `#bibliography(...)`, qu'il nomme un fichier ou une liste, et que les fichiers soient des `.bib` BibTeX ou des `.yml` et `.yaml` Hayagriva. Une nouvelle citation va dans le fichier que le document déclare. Si ce fichier est Hayagriva, Oleafly convertit l'entrée BibTeX avant de l'écrire. Quand l'appel nomme plusieurs fichiers, choisissez la cible dans le menu **Bibliographie** du dialogue.

Les projets Markdown suivent le champ `bibliography:` du front matter.

Quand aucune bibliographie n'est déclarée, Oleafly utilise le premier `.bib` du projet. S'il n'en existe aucun, il crée `references.bib` et le rend disponible dans l'arborescence de fichiers et dans le sélecteur de citations.

Pour un projet qui compte plusieurs bibliothèques, examinez la cible sélectionnée avant d'ajouter une fiche.

## Choisir un style de citation Typst

Quand un document Typst contient un appel `#bibliography(...)`, le bas de la vue **Citations** du panneau Références affiche un menu **Style de citation**. Il liste les styles intégrés de Typst pour la version Typst du projet, plus les fichiers `.csl` présents dans le projet. Choisir un style l'écrit dans l'argument `style:` de cet appel. Sans style, Typst utilise `ieee`.

Pour LaTeX, réglez le style dans le source. `\bibliographystyle{` complète les styles BibTeX habituels ; avec `biblatex`, utilisez son option `style=`.

## Importer toute une bibliothèque de références

Dans le panneau Références, choisissez **Importer une bibliothèque de références**. Vous pouvez importer un fichier ou votre bibliothèque Zotero.

**Depuis un fichier**, choisissez une bibliothèque exportée :

| Format source | Fichier |
| --- | --- |
| BibTeX | `.bib` |
| RIS | `.ris` |
| EndNote XML | `.xml` |
| Zotero RDF | `.rdf` |

**Depuis Zotero**, connectez une fois votre compte zotero.org dans **Paramètres → Intégrations → Zotero**, puis choisissez **Importer la bibliothèque Zotero** sur la carte Zotero. Oleafly importe jusqu'à 5 000 éléments. [Connecter les sources de recherche](/docs/integrations/research-sources/#zotero) détaille la configuration.

Oleafly convertit les fiches en BibTeX et saute toute référence dont le DOI est déjà présent dans la bibliothèque cible ou plus tôt dans le même lot. Il crée des clés sans collision et ajoute le résultat en une seule écriture. Le message indique combien de références ont été ajoutées et combien étaient déjà présentes. Un import de bibliothèque n'insère pas de citation au curseur.

Après l'import, cherchez les nouvelles entrées dans le sélecteur de citations et vérifiez un échantillon auprès du catalogue d'origine.

## Nettoyer une bibliothèque de références

Le panneau Références peut prévisualiser un nettoyage avant de modifier des fichiers.

1. Ouvrez le projet et choisissez **Nettoyer la bibliothèque de références** dans le panneau Références.
2. Sélectionnez le fichier `.bib` quand le projet en compte plusieurs.
3. Lisez la liste d'actions et le diff avant/après.
4. Examinez chaque renommage de clé proposé, chaque doublon de DOI supprimé et chaque avis.
5. N'appliquez que lorsque l'aperçu correspond à votre intention.

Le nettoyeur renomme les clés selon un schéma cohérent auteur-année-titre et met à jour les citations dans les fichiers source du projet. Il ne supprime un doublon de DOI que si l'entrée conservée préserve tous les champs de l'entrée supprimée. Les fiches DOI en conflit et les titres similaires sont signalés pour examen, pas fusionnés sur une simple supposition.

Les commentaires et les définitions de chaînes BibTeX sont conservés. Au moment d'appliquer, Oleafly vérifie que la bibliothèque correspond toujours à l'aperçu et écrit une sauvegarde avant de modifier les fichiers. Les diffs volumineux montrent les 500 premières lignes dans l'aperçu ; les fichiers complets restent utilisés lors de l'application des changements.

:::caution[Examiner avant d'appliquer]
Deux éditions, des traductions, une version préprint et une version de revue, ou des articles aux titres similaires peuvent être séparés à dessein. Lisez l'avis et comparez les sources réelles avant toute fusion manuelle.
:::

## Compléter et parcourir les références

Dans les commandes de citation LaTeX comme `\cite{}`, `\citep{}`, `\citet{}`, `\parencite{}` et `\textcite{}`, la complétion automatique cherche dans tous les fichiers `.bib` du projet. En Typst, `@` complète les clés des fichiers `.bib` et Hayagriva. Avec Zotero connecté, la liste inclut aussi votre bibliothèque Zotero.

Une citation vers une entrée ajoutée au `.bib` pendant que ce fichier n'était pas ouvert, par exemple par l'assistant ou depuis Zotero, se résout immédiatement. Vous n'avez pas besoin de taper d'abord dans le document.

- F12 ou un clic avec modificateur passe d'une clé de citation à son entrée.
- ⇧F12 liste toutes les utilisations d'une source.
- F2 renomme une clé dans les fichiers source et de bibliographie.
- Le survol affiche la cible ; les clés non résolues ou ambiguës sont signalées avant la compilation.

[Intelligence du code](/docs/code-intelligence/) explique le modèle de navigation complet.

## Citer Oleafly

Si Oleafly a contribué à un article, lancez **Citer Oleafly dans cet article** depuis la palette de commandes ou depuis le bas de la vue **Citations** du panneau Références. Oleafly ajoute une entrée avec la clé `oleafly` à la bibliographie que le document déclare, en BibTeX ou, pour un fichier Hayagriva, en Hayagriva. Un message indique le fichier et la syntaxe à utiliser, comme `\cite{oleafly}` ou `@oleafly`, avec **Annuler** à côté. Si l'entrée est déjà présente, vous recevez plutôt un rappel de la clé.

Un projet sans fichier de bibliographie reste inchangé et un dialogue affiche l'entrée à copier. La même entrée se trouve toujours dans [Paramètres → Aide et à propos](/docs/settings/help/#cite-oleafly-in-a-paper).

## Bibliographie et Biber à la compilation

Pour `biblatex`, Oleafly relance l'étape Biber correspondante quand le compilateur n'a pas produit de `.bbl` utilisable. Les messages de Biber, y compris un chemin `.bib` manquant, apparaissent dans le journal de compilation et dans les diagnostics de l'éditeur.

Quand Biber lui-même échoue, le journal de compilation en donne la raison. Il nomme une bibliothèque système manquante et suggère `\usepackage[backend=bibtex]{biblatex}` pour compiler sans Biber. Sous Fedora, le `.rpm` d'Oleafly recommande les deux bibliothèques dont Biber a besoin.

Si des références restent non définies :

1. Vérifiez la déclaration et le chemin de la bibliographie.
2. Ouvrez **Journaux** et cherchez le premier message de Biber ou de bibliographie.
3. Confirmez que la clé de citation n'existe qu'une seule fois.
4. Recompilez après avoir enregistré le fichier `.bib`.

Consultez [Compilation et journaux](/docs/compiling/) et [Moteurs et packages LaTeX](/docs/latex-engines/) pour le rétablissement propre à chaque moteur.

## Outils de références autonomes

Vous pouvez préparer des références sans ouvrir de projet :

- Le [Générateur de citations](/docs/tools/citation-generator/) accepte des identifiants, des titres, des champs structurés ou du BibTeX.
- Le [Générateur de bibliographie](/docs/tools/bibliography-generator/) construit et valide une liste.
- Les [Générateurs de citations par style](/docs/tools/citation-styles/) comparent huit styles.
- Des outils dédiés gèrent les [DOI](/docs/tools/doi-to-bibtex/), les [ISBN](/docs/tools/isbn-to-bibtex/), les [ID PubMed](/docs/tools/pubmed-to-bibtex/), [arXiv](/docs/tools/arxiv-citation-generator/) et les [adresses web](/docs/tools/url-to-bibtex/).

La modification manuelle et la mise en forme des citations restent locales. La recherche par identifiant ou par titre exige une connexion. Le [Mode hors ligne](/docs/settings/general/#offline-mode) bloque ces recherches, tandis que la complétion et la navigation de bibliographie existantes continuent de fonctionner.

## Trouver des preuves, puis les vérifier

[Trouver des citations](/docs/tools/find-citations/) interroge des index scientifiques ou parcourt le brouillon ouvert à la recherche de passages qui pourraient avoir besoin d'un appui. Lisez l'article avant de le citer et gardez chaque affirmation dans les limites de ce que les méthodes et les résultats établissent.
