# Paquets

Cherchez des paquets LaTeX sur CTAN et des paquets Typst sur Typst Universe, puis ajoutez-en un à votre document depuis la barre d'outils de l'éditeur.

Les documents LaTeX et Typst tirent la plupart de leurs fonctions supplémentaires des paquets. Le bouton des paquets, à l'extrémité droite de la barre d'outils de l'éditeur, ouvre une liste interrogeable pour le langage du projet et écrit pour vous la ligne qui charge un paquet. Les projets Markdown n'ont pas de bouton de paquets.

Vous pouvez aussi ouvrir la liste depuis la palette ⌘K avec **Parcourir les paquets LaTeX** ou **Parcourir les paquets Typst**.

## Paquets LaTeX

Dans un projet LaTeX, choisissez **Paquets LaTeX**. Cherchez sur CTAN par nom ou par description de paquet. Si CTAN est injoignable, ou si vous êtes hors ligne, la boîte de dialogue le dit et affiche à la place la liste intégrée d'Oleafly. Une liste qui n'a pas pu être actualisée affiche la date de son téléchargement.

Chaque ligne peut afficher ces étiquettes :

- **Dans le document** : le fichier principal charge déjà ce paquet.
- **Classe de document** : l'entrée est une classe, pas un paquet. Les classes se définissent avec `\documentclass`, la ligne permet donc de copier cette commande mais pas de l'ajouter.
- **Installé** : votre distribution TeX possède déjà le paquet.

Chaque ligne offre aussi ces contrôles :

- **Options**, un champ pour les options du paquet, par exemple `margin=2cm`. Les accolades doivent correspondre, et `]` ou `%` ne peuvent pas être utilisés.
- **Ajouter au préambule**, qui écrit `\usepackage[options]{name}` dans le préambule du fichier principal. Si le fichier charge déjà le paquet, rien ne change et la boîte de dialogue vous le dit.
- **Copier la ligne**, qui copie la même ligne `\usepackage`, ou la ligne `\documentclass` pour une classe.
- **CTAN**, qui ouvre la page du paquet sur CTAN.
- **Installer**, pour un paquet qui manque à votre distribution TeX. Voir ci-dessous.

### Installer des paquets LaTeX

Ce que signifie « installé » dépend de la façon dont le projet compile :

- **Tectonic**, le compilateur intégré, télécharge un paquet la première fois que votre document l'utilise. Il n'y a rien à installer, et la boîte de dialogue le dit en haut.
- **latexmk avec TeX Live ou TinyTeX** : quand votre distribution TeX possède `tlmgr`, Oleafly vérifie quels paquets vous avez, les marque **Installé** et propose **Installer** pour les autres. Installer exécute `tlmgr` pour ce seul paquet.
- **TeX Live de Debian, Ubuntu ou Fedora** : le gestionnaire de paquets du système le possède, donc la boîte de dialogue dit d'installer les paquets avec `apt` ou `dnf` et n'a pas de bouton **Installer**.
- **Autres installations TeX**, comme MiKTeX : Oleafly ne peut pas dire quels paquets sont présents, les lignes n'affichent donc aucun état d'installation. Utilisez MiKTeX Console pour MiKTeX.

Avec TeX Live ou TinyTeX, une compilation qui ne trouve pas un fichier propose **Trouver et installer** dans l'erreur, ce qui détermine à quel paquet le fichier appartient. Voir [Récupérer après un fichier manquant](/docs/latex-engines/#recover-from-a-missing-file).

Choisissez le compilateur depuis la flèche à côté de **Recompiler**. Voir [Moteurs et paquets LaTeX](/docs/latex-engines/).

## Paquets Typst

Dans un projet Typst, choisissez **Paquets Typst** pour parcourir Typst Universe. Cherchez par nom, mot-clé ou catégorie, ou réduisez la liste avec une pastille de catégorie. La boîte de dialogue affiche jusqu'à 100 paquets à la fois, cherchez donc quand la liste est longue.

Chaque ligne affiche le nom du paquet, sa dernière version, un badge **Modèle** pour les paquets qui sont des modèles, et une courte description. Quand un paquet exige un Typst plus récent que celui du projet, la ligne indique la version requise.

- **Insérer l'import** ajoute `#import "@preview/name:version": *` après les imports en haut du fichier `.typ` ouvert. Si le fichier importe déjà ce paquet, seul le numéro de version change. Un fichier Typst doit être ouvert dans l'éditeur.
- **Copier l'import** copie la même ligne.

### Indications de mise à jour

Quand un import `@preview` de votre fichier est plus ancien que la dernière publication sur Typst Universe, l'éditeur marque la version d'une indication telle que « cetz 0.4.2 est disponible. Cet import utilise 0.3.4. » L'action **Mettre à jour vers 0.4.2** de l'indication change le numéro en place.

### Garder les paquets avec le projet

Typst télécharge les paquets dans un cache partagé la première fois qu'un projet les importe. Pour qu'un projet transporte ses propres copies, utilisez **Paquets du projet** en bas de la boîte de dialogue :

- **Utiliser les paquets du dossier du projet** fait chercher Typst d'abord dans le dossier `typst-packages` du projet. Un projet configuré ainsi compile hors ligne et sur d'autres ordinateurs.
- **Intégrer les paquets au projet** copie chaque paquet que le projet importe, du cache vers `typst-packages`. Si un paquet n'est pas encore dans le cache, compilez une fois en ligne, puis intégrez de nouveau.

Les deux demandent Typst 0.12 ou plus récent. Sur un projet épinglé à Typst 0.11, la section le dit.

La section indique aussi combien de paquets contient le projet.

### Hors ligne

Avec le mode hors ligne activé, la boîte de dialogue utilise la liste de paquets téléchargée la dernière fois et affiche sa date. Si aucune liste n'a jamais été téléchargée, elle ne peut pas en afficher tant que vous n'êtes pas en ligne.

## Pages liées

- [L'éditeur](/docs/editor/#the-editor-toolbar) : le reste de la barre d'outils de l'éditeur
- [Compilation](/docs/compiling/) : comment les paquets sont récupérés pendant une compilation
- [Réglages du document](/docs/document-settings/) : format du papier, marges et polices sans écrire de code de paquet
