Aller au contenu
Oleaflyv0.4.12

Outils du document

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.

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.

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.

Choisissez le compilateur depuis la flèche à côté de Recompiler. Voir Moteurs et paquets LaTeX.

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.

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.

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.

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.

  • 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
Aperçu de l’image

Impossible de charger les réponses de l’IA

Réessayez ou cherchez dans la documentation.