Outils d’édition
Autocomplétion et commandes slash
Commandes LaTeX adaptées aux paquets, fonctions et paquets Typst, détails de citation, chemins de fichiers, raccourcis mathématiques et snippets réutilisables.
Dans LaTeX, l’éditeur complète trois choses au fil de la frappe : les commandes, les références croisées et les citations. Ajoutez le menu slash / pour la structure, et la plupart des documents peuvent être rédigés sans saisir de code répétitif. Les fichiers Typst ont leur propre autocomplétion et leurs propres snippets, décrits dans Autocomplétion Typst.
Les suggestions apparaissent automatiquement pendant la frappe ; Ctrl+Space les appelle n’importe où. Acceptez-les avec Tab ou Enter.
Autocomplétion des commandes
Section intitulée « Autocomplétion des commandes »Tapez une barre oblique inverse et continuez : \sec… propose \section, et \fra… propose \frac. L’autocomplétion s’appuie sur un vaste catalogue de commandes LaTeX et sur les paquets utilisés par votre projet. Elle inclut aussi les commandes et environnements personnalisés présents dans votre source.
Les complétions s’insèrent sous forme de snippets avec des points de tabulation : acceptez \frac et vous obtenez \frac{│}{} avec le curseur dans le numérateur ; Tab passe au dénominateur. Les complétions d’environnements comme \itemize, \enumerate, \equation et \align insèrent tout le bloc \begin…\end avec le curseur à l’intérieur.
Autocomplétion des références
Section intitulée « Autocomplétion des références »À l’intérieur de \ref{, \eqref{, \pageref{, \autoref{, \cref{ ou \Cref{, le menu liste chaque \label{} défini dans votre document. Fini de remonter dans le fichier pour se souvenir si vous l’aviez appelé fig:arch ou fig:architecture.

Autocomplétion des citations
Section intitulée « Autocomplétion des citations »À l’intérieur de \cite{ et de ses variantes (\citep, \citet, \citeauthor, \citeyear, \parencite, \textcite), le menu liste les clés de citation des fichiers .bib de votre projet, analysés automatiquement à l’ouverture du projet.
Si l’article ne figure pas encore dans votre .bib, c’est précisément le rôle de la recherche de citations : collez un DOI ou un titre et Oleafly ajoute l’entrée et le \cite en une seule étape.
Maths et structure
Section intitulée « Maths et structure »Tapez $, \( ou \[ pour insérer son délimiteur fermant. Quand le curseur atteint un $ fermant inséré, tapez à nouveau $ pour le dépasser. Les crochets se complètent dans les maths en ligne, et une paire $$ vide devient des maths hors texte quand vous appuyez sur Enter entre les délimiteurs.
Accepter un environnement de liste insère son premier \item. Appuyez sur Enter en fin d’élément pour continuer la liste, y compris un libellé de description ou l’indentation d’une liste imbriquée. Appuyez sur Shift+Enter pour un simple retour à la ligne ; laissez le nouvel élément vide et appuyez à nouveau sur Enter pour terminer la liste.
Si vous tapez vous-même un \begin{...} non fermé, Enter ajoute le \end{...} correspondant. Utilisez ⌘⌥. (Ctrl+Alt+.) pour fermer l’environnement ouvert le plus imbriqué, ou ⌘⌥E (Ctrl+Alt+E) pour encadrer une sélection dans un environnement. Dans les maths, tapez @ pour parcourir les lettres grecques et les autres symboles.
Les suggestions de référence incluent le numéro compilé lorsqu’il est disponible après une compilation réussie. Les suggestions de citation aident à identifier l’article qui se cache derrière une clé.
Contrôler ce qui se ferme automatiquement
Section intitulée « Contrôler ce qui se ferme automatiquement »Ouvrez Paramètres → Apparence → Éditeur quand vous voulez moins, ou plus, de frappe automatique :
- Autocomplétion affiche des suggestions pendant la frappe. Ctrl+Space continue de les ouvrir lorsque ce réglage est désactivé.
- Fermeture automatique des parenthèses insère les crochets et parenthèses correspondants.
- Fermeture automatique des maths associe
$,\(et\[au délimiteur correspondant. - Fermeture automatique des environnements insère le
\end{...}correspondant quand vous appuyez sur Entrée après\begin{...}.
Désactivez uniquement l’assistant qui contrarie votre façon d’écrire. La complétion manuelle, la fermeture des environnements et les raccourcis d’encadrement restent disponibles.
Le menu slash
Section intitulée « Le menu slash »Tapez / n’importe où et un menu d’insertion s’ouvre, en se filtrant au fil de la frappe :
| Commande | Insère |
|---|---|
/section, /subsection | Commandes de sectionnement |
/itemize | Liste à puces |
/enumerate | Liste numérotée |
/item | Un élément de liste |
/equation | Environnement d’équation hors texte |
/align | Équations alignées sur plusieurs lignes |
/frac | Une fraction |
/figure | Un flottant de figure complet avec \includegraphics et \caption |
/table | Un flottant de tableau avec un tabular de départ |
/bold, /italic | \textbf{}, \textit{} |
/label | \label{} |
/usepackage | \usepackage{} |
Tout s’insère sous forme de snippet avec des points de tabulation : Tab vous guide ainsi à travers les champs à remplir (la légende, puis le label, puis la suite).
Autocomplétion Typst
Section intitulée « Autocomplétion Typst »Les fichiers Typst disposent de leur propre autocomplétion, fournie principalement par Tinymist, le serveur de langage Typst qui correspond à la version Typst du projet.
| Où vous tapez | Ce que le menu propose |
|---|---|
# suivi d’un nom | Fonctions et variables |
Une chaîne dans image(, read(, csv(, json(, yaml(, toml( ou bibliography(, ou après #include ou #import | Chemins des fichiers du projet |
@, ou < à l’intérieur de ref( ou cite( | Labels et clés de citation, issus des fichiers .bib et .yml Hayagriva |
#import "@preview/ | Paquets de Typst Universe |
style: dans #bibliography(...) ou #cite(...) | Noms de styles de bibliographie, avec en priorité les fichiers .csl propres au projet |
Tapez / en début de ligne, ou après une espace, pour les snippets Typst : /heading, /figure, /tablefigure, /table, /equation, /numberedequation, /footnote, /quote, /code, /outline, /bibliography, /pagebreak, /columns, /grid, /link, /list, /enum et /terms. Sur Typst 0.15 et ultérieur, /partbibliography ajoute une bibliographie pour une seule partie du document.
Maths et listes en Typst
Section intitulée « Maths et listes en Typst »Taper $ dans le texte insère aussi le $ fermant. Tapez une espace dans une paire vide pour obtenir des maths hors texte, $ | $, et appuyez sur Backspace dans une paire vide pour supprimer les deux signes. Avec du texte sélectionné, taper *, _, un accent grave ou $ encadre la sélection au lieu de la remplacer. Ces comportements obéissent aux réglages Fermeture automatique des parenthèses et Fermeture automatique des maths décrits plus haut.
Dans une liste, Enter démarre l’élément suivant -, +, / ou numéroté. Enter sur un élément vide supprime son marqueur, et Shift+Enter poursuit l’élément en cours sur une nouvelle ligne. Tab imbrique un élément sous celui du dessus, et Shift+Tab le fait ressortir.
Bon à savoir
Section intitulée « Bon à savoir »- Tab fait double emploi : elle accepte une suggestion ouverte, sinon elle indente.
- Les menus de complétion se ferment quand vous cliquez ailleurs ; Esc les ferme explicitement.
- Les chemins des fichiers du projet se complètent dans les commandes prises en charge telles que
\input{}et\includegraphics{}.