Outils du document
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
Section intitulée « 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\documentclasspour 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
Section intitulée « 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écutetlmgrpour 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
aptoudnfet 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.
Choisissez le compilateur depuis la flèche à côté de Recompiler. Voir Moteurs et paquets LaTeX.
Paquets Typst
Section intitulée « 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.typouvert. 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
Section intitulée « 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
Section intitulée « 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-packagesdu 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
Section intitulée « 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
Section intitulée « Pages liées »- L’éditeur : le reste de la barre d’outils de l’éditeur
- Compilation : comment les paquets sont récupérés pendant une compilation
- Réglages du document : format du papier, marges et polices sans écrire de code de paquet