# L'éditeur

Écrivez du LaTeX, du Typst et du Markdown avec l'édition source et visuelle, des outils de document et un PDF à côté de votre brouillon.

Oleafly réunit l'édition source, la navigation dans le document et l'aperçu PDF dans un seul espace de travail. Son éditeur CodeMirror prend en charge LaTeX, Typst et Markdown. Les numéros de ligne, la correspondance des parenthèses et le surlignage de la ligne active sont toujours actifs. Les longues lignes passent à la ligne, sauf si vous désactivez **Renvoyer les longues lignes** dans **Paramètres → Apparence → Éditeur**.

Les raccourcis ci-dessous indiquent d'abord la touche macOS ; sous Windows et Linux, lisez ⌘ comme Ctrl.

![LLaMA ouvert dans Oleafly. L'arborescence de fichiers est à gauche, la source LaTeX au milieu et l'article compilé à droite.](https://cdn.oleafly.com/images/screenshots/desktop/docs/llama-writing-dark-window-v2.png)

## Choisissez votre guide d'écriture

Chaque moteur de document a sa propre barre d'outils et sa propre syntaxe source. Ces guides expliquent chaque contrôle et contiennent un manuscrit que vous pouvez coller puis compiler :

| Moteur | Commencez ici |
| --- | --- |
| LaTeX | [Structure, mise en forme, citations, figures, tableaux, maths et navigation dans le code](/docs/writing/latex/) |
| Typst | [Titres, listes, mise en forme, maths, figures, citations, étiquettes et blocs de code](/docs/writing/typst/) |
| Markdown | [Édition source et visuelle, mise en forme Pandoc, liens, images et tableaux](/docs/writing/markdown/) |

## La barre d'outils de l'éditeur

Les trois barres d'outils suivent la même disposition :

- **Code / Visuel** vient en premier et bascule le fichier ouvert entre la source et l'[édition visuelle](#visual-editing).
- **Annuler** et **Rétablir** viennent ensuite. Chacun est grisé quand il n'y a rien à annuler ou à rétablir.
- Les boutons de mise en forme et d'insertion remplissent le milieu. Les boutons qui ne tiennent pas passent dans **Plus d'options de mise en forme** (`…`) quelle que soit la largeur, un éditeur étroit ne perd donc jamais un contrôle.
- L'extrémité droite garde les outils de document visibles : **Paquets LaTeX** ou **Paquets Typst** (voir [Paquets](/docs/packages/)), [Analyse du document](/docs/document-insights/), [Réglages du document](/docs/document-settings/), **Infos du projet**, **Rechercher** et **Aller au PDF**.

Markdown n'a pas de bouton de paquets. Vous pouvez aussi ouvrir ces outils depuis la palette ⌘K : **Parcourir les paquets LaTeX**, **Parcourir les paquets Typst**, **Analyse du document** et **Réglages du document**.

## Garder vos repères

Le contexte ancré garde visible la section ou l'environnement englobant pendant le défilement. Dans les fichiers Typst, les titres au-dessus du curseur restent épinglés de la même façon. **Défilement ancré** dans **Paramètres → Apparence → Éditeur** le désactive.

Une barre de fil d'Ariane au-dessus des fichiers `.tex` et `.typ` nomme le fichier et les sections où se trouve le curseur. Cliquez sur un élément du fil pour sauter à ce titre. Le plan du projet vous aide à passer d'un chapitre à l'autre, tandis que la navigation par références et citations vous conduit à la source derrière un symbole. [La complétion automatique](/docs/autocomplete/) inclut les commandes LaTeX des paquets, la saisie des maths et les détails des citations.

Chaque vue de la barre latérale mémorise sa position de défilement, ses dossiers dépliés et ses sections ouvertes pour chaque projet : vous revenez donc au même endroit.

![L'application passée au thème sombre, puis en mode Zen avec seulement le source et le PDF.](https://cdn.oleafly.com/images/gifs/desktop/theme-zen.gif?v=2)

## Mode Zen

Le mode Zen masque la barre d'outils du projet, la barre latérale, l'assistant, le terminal, ainsi que les onglets et la barre de mise en forme de l'éditeur lui-même. Il ne reste que votre texte, et l'éditeur conserve toute sa largeur.

Appuyez sur Ctrl+⌘⇧F sous macOS ou Shift+F11 sous Windows et Linux pour l'activer. Vous pouvez aussi choisir **Mode Zen** dans le menu **Disposition** de la barre d'outils du projet ou dans le menu macOS **Affichage**, ou exécuter **Activer ou désactiver le mode Zen** depuis la palette ⌘K. Appuyez à nouveau sur la même touche, ou deux fois sur Esc, pour le quitter.

En mode Zen, le bouton **Compiler** se place dans le coin supérieur droit, au-dessus du PDF quand il est ouvert, et apparaît quand le pointeur s'approche. Une petite pastille y affiche **Compilation en cours** pendant une compilation. Après une compilation échouée, elle indique **Échec de la compilation**, et un clic dessus affiche ou masque le journal de compilation. ⌘↵ compile toujours, et ⌘⌥P affiche ou masque le PDF sans quitter le mode Zen.

Deux options se trouvent sous [Paramètres → Apparence → Projet](/docs/settings/appearance/#zen-mode-settings). **Passer en plein écran** remplit l'écran pendant que le mode Zen est actif. **Afficher le PDF à la compilation** ouvre le PDF à côté de l'éditeur à chaque compilation alors qu'il est masqué. La touche elle-même peut être changée dans **Paramètres → Raccourcis clavier**.

## Thèmes, couleurs et polices

L'éditeur utilise un thème quand l'application est claire et un autre quand elle est sombre. Choisissez les deux, changez la couleur de n'importe quelle partie de la source, et choisissez la police de l'éditeur, la taille, l'interligne, l'espacement des caractères et le curseur sous [Paramètres → Apparence → Éditeur](/docs/settings/appearance/#editor-themes). Une [police CJK](/docs/settings/appearance/#cjk-font) distincte définit la police des caractères chinois, japonais et coréens, pour que le texte latin puisse rester dans une police de code. Les couleurs suivent des rôles qui signifient la même chose en LaTeX, Typst et Markdown. En LaTeX, une commande de section et son titre utilisent tous deux la couleur des titres, les clés de citation et les noms d'environnement prennent la couleur de leur commande, et les maths sont d'une seule couleur. Les citations Markdown telles que `[@key]` et `@key` sont surlignées comme des citations, pas comme des liens.

## Rechercher et remplacer

Appuyez sur ⌘F pour un widget façon VS Code dans le coin supérieur droit de l'éditeur :

- les bascules **Respecter la casse** (`Aa`), **Mot entier** (`ab`) et **Expression régulière** (`.*`)
- un compteur de correspondances en direct (`3 of 41`), avec les états `No results` et `Invalid`, plafonné à `2000+` pour les très gros documents
- Enter saute à la correspondance suivante, Shift+Enter à la précédente, Esc ferme
- **Sélectionner toutes les correspondances** transforme chaque correspondance en curseur pour une édition simultanée
- le chevron déploie la ligne **Remplacer** : remplacer le suivant, **Tout remplacer**, et une bascule **Conserver la casse** qui reporte la casse du mot d'origine sur le remplacement (remplacer `figure` par `image` transforme ainsi aussi `Figure` en `Image`)

⌘A sélectionne tout le fichier, y compris les lignes sorties de la zone visible, une copie ou une suppression juste après emporte donc tout.

## Pliage du code

Cliquez sur la flèche dans la gouttière pour replier.

- En LaTeX, un environnement `\begin…\end` se replie en un bloc (en respectant l'imbrication), et une section se replie jusqu'à la section suivante de même niveau ou de niveau supérieur.
- En Typst, un titre se replie jusqu'au titre suivant de même niveau ou de niveau supérieur. Les blocs de code dans `{…}`, les blocs de contenu dans `[…]`, les listes d'arguments, les équations, les blocs bruts et les commentaires en bloc se replient aussi.

Repliez un chapitre pendant que vous en modifiez un autre plus loin.

## Mettre des lignes en commentaire

Appuyez sur ⌘/ pour mettre en commentaire ou décommenter la ligne actuelle ou les lignes sélectionnées. Les lignes LaTeX reçoivent `%` et les lignes Typst `//`. En dehors de l'éditeur, cette touche ouvre la référence des raccourcis.

## Curseurs multiples et sélection en bloc

L'éditeur prend en charge les sélections multiples : **glisser avec Alt** pour une sélection rectangulaire (en colonne), et **Sélectionner toutes les correspondances** dans le widget de recherche pour un curseur par correspondance. Tous les curseurs saisissent, suppriment et collent ensemble.

## Indentation et parenthèses

L'éditeur indente pendant la frappe, quatre espaces par niveau, sauf si vous changez **Taille de tabulation** dans **Paramètres → Apparence → Éditeur**. Tab indente, ou accepte la suggestion de complétion ouverte. Les parenthèses et les guillemets se ferment automatiquement, la touche retour arrière supprime les paires ensemble, et la parenthèse correspondante se surligne au curseur.

## Aides à la saisie Typst

Les fichiers Typst ont quelques aides qui leur sont propres :

- Tapez `$` et le `$` de fermeture vient avec. Appuyez sur Space dans la paire vide pour la transformer en maths en affichage, `$ … $`. Backspace dans une paire vide supprime les deux signes.
- Sélectionnez du texte et tapez `*`, `_`, `` ` `` ou `$` pour l'entourer en texte fort, en emphase, en texte brut ou en maths.
- Sur un élément de liste, Enter commence l'élément suivant avec la même marque (`-`, `+`, `/` ou un nombre). Shift+Enter commence une nouvelle ligne dans l'élément, et Backspace juste après une marque vide la supprime. Tab imbrique l'élément d'un niveau plus profond et Shift+Tab le fait ressortir.
- Tapez `/` en début de ligne ou après une espace pour ouvrir les extraits Typst : titre, figure, figure de tableau, tableau, équation, équation numérotée, note de bas de page, citation, code, table des matières, bibliographie, saut de page, colonnes, grille, lien et les trois sortes de listes.
- ⇧⌥F (Shift+Alt+F) met le fichier en forme avec typstyle. Activez **Formater à l'enregistrement** sous **Typst** dans **Paramètres → Apparence → Éditeur** pour formater à chaque pression de ⌘S. L'enregistrement automatique ne reformate jamais.

L'appariement de `$` exige à la fois **Fermeture automatique des parenthèses** et **Fermeture automatique des maths**, et l'entourage d'une sélection exige **Fermeture automatique des parenthèses**. Les deux bascules sont dans **Paramètres → Apparence → Éditeur**. Les touches de liste sont toujours actives. La complétion, le renommage, l'aller à la définition et l'aide à la signature viennent du serveur de langage Typst ; voir [Complétion automatique](/docs/autocomplete/) et [Intelligence du code](/docs/code-intelligence/).

## Insérer figures, tableaux et références en Typst

Typst a les mêmes outils d'insertion que LaTeX, et chacun écrit du Typst. Ils se trouvent sur la barre d'outils Typst et dans le menu contextuel de l'éditeur :

- **Insérer une figure** ouvre la boîte de dialogue des figures. Choisissez une image du projet ou importez-en une, puis réglez sa largeur, sa légende, son étiquette, son texte alternatif et son placement. Avec le curseur dans un `#figure` existant, le même bouton ouvre **Modifier la figure** pour changer n'importe lequel de ces réglages.
- Collez ou déposez un fichier image dans l'éditeur. Oleafly l'enregistre dans `figures/` quand le projet a ce dossier, sinon à côté du document principal, et insère une figure qui l'utilise.
- **Insérer un tableau** ajoute un tableau vide de la taille que vous choisissez. **Tableau depuis un CSV/XLSX…** dans le menu contextuel importe un fichier CSV, TSV, Excel ou JSON, avec une légende et une étiquette facultatives. Activez **Garder le lien avec le fichier de données** et Oleafly copie les données dans le dossier `data` du projet. Le tableau lit ce fichier à chaque compilation : quand vous modifiez les données, le tableau suit.
- **Citer depuis le projet** écrit `@key` pour une entrée de la bibliographie du projet. Si le document n'a pas encore de `#bibliography`, Oleafly en ajoute une.
- **Ajouter une étiquette** pose une étiquette sur le titre, la figure ou l'équation au curseur, ou sélectionne celle qu'il possède déjà. **Insérer un renvoi** liste les étiquettes du projet et écrit `@label`.
- Les boutons maths insèrent des maths en ligne, une équation en affichage, une équation numérotée avec étiquette ou des équations alignées. Si le document n'a pas de règle de numérotation des équations, une note propose **Ajouter la règle**.
- **Symboles** insère chaque symbole sous son nom Typst.

[Écrire en Typst](/docs/writing/typst/) couvre chaque bouton de la barre d'outils.

## Édition visuelle

Chaque fichier LaTeX, Typst et Markdown a une bascule **Code / Visuel** au début de sa barre d'outils. Les nouveaux projets s'ouvrent en Code, et chaque projet mémorise le mode dans lequel vous l'avez laissé. Markdown a aussi **Les deux**, qui montre la source et le texte mis en forme empilés ou côte à côte.

En LaTeX et en Typst, le mode Visuel est le même éditeur avec le balisage dessiné en place. Placez le curseur dans un titre, une équation ou une commande et sa source revient sur cette ligne. Éloignez le curseur et la forme rendue revient. Le fichier reste l'unique copie, les numéros de ligne, le pliage, la recherche et le remplacement, l'orthographe et les erreurs de compilation continuent donc de fonctionner. Chaque bouton de la barre d'outils écrit la même source qu'en mode Code.

Dans un fichier Typst, le mode Visuel affiche :

- les titres, le texte fort et en emphase, le texte brut, les liens et le texte coloré
- les listes à puces, numérotées et de termes avec leurs marques
- les maths en ligne et en affichage, dessinées par Typst
- les images et les figures, avec la légende en texte brut
- les tableaux comme une grille dans laquelle vous pouvez saisir. Sélectionnez une cellule et une barre d'outils apparaît pour les bordures, l'alignement, l'ajout ou la suppression de lignes et de colonnes, et la suppression du tableau.
- les références et citations sous forme de pastilles, et les notes de bas de page comme petite marque

Les lignes `#set`, `#show`, `#import` et `#let` en haut d'un fichier Typst se replient en une barre **Afficher les réglages du document**. Cliquez dessus pour les ouvrir en place. Le préambule LaTeX se replie de la même façon.

Le mode Visuel convient à une passe de prose. Passez en Code pour la structure ou les commandes personnalisées. Tout ce que le mode Visuel ne sait pas dessiner reste à l'écran en source modifiable.

## Aperçu des maths

Avec le curseur dans une équation, le résultat rendu apparaît juste au-dessus. KaTeX dessine les maths LaTeX et Typst dessine les maths Typst. Le menu de l'aperçu peut le masquer jusqu'à ce que vous quittiez l'équation, ou le désactiver. **Aperçu des maths** dans **Paramètres → Apparence → Éditeur** le réactive.

Collez des maths LaTeX dans un fichier Typst, par exemple `$\frac{a}{b}$` ou un environnement `equation`, et un bouton **Coller en maths Typst** apparaît dessous. Cliquez dessus pour échanger ce que vous avez collé contre des maths Typst, ou appuyez sur Esc pour garder le LaTeX. Pour des maths déjà présentes dans le fichier, sélectionnez-les et choisissez **Convertir les maths LaTeX en Typst** dans le menu contextuel.

## Erreurs de compilation dans la source

Après une compilation échouée, chaque erreur est soulignée dans le fichier auquel elle appartient. Pour Typst, le soulignement couvre l'intervalle exact signalé par Typst, et une erreur levée à l'intérieur d'un paquet pointe la ligne de votre fichier qui l'a appelé. Survolez le soulignement pour lire le message. Les erreurs Typst courantes, comme un nom inconnu, un fichier ou un paquet manquant, ou une parenthèse non fermée, sont accompagnées d'une explication simple de ce qui n'a pas marché et de ce qu'il faut vérifier.

Le [panneau des journaux](/docs/compiling/#reading-the-logs) liste chaque erreur avec sa ligne source et les indications de Typst.

## Le linter LaTeX intégré

L'éditeur vérifie les fichiers LaTeX à la recherche de problèmes structurels pendant la frappe, avant toute compilation :

- `\end{itemize}` sans `\begin` correspondant, ou paires désaccordées (`expected \end{figure}, got \end{table}`)
- Environnements non fermés
- Clés `\label{}` en double
- Un nombre impair de `$` sur une ligne (presque toujours un délimiteur mathématique oublié)

Les erreurs reçoivent des ondulations rouges, les avertissements ambre, avec des marqueurs dans la gouttière. Le linter ne lit que le LaTeX, il n'arrête donc jamais une compilation Typst ou Markdown. Les erreurs de compilation de l'exécution LaTeX proprement dite apparaissent à part dans le [panneau des journaux](/docs/compiling/#reading-the-logs), et [Prévérification](/docs/preflight/) ajoute ses propres contrôles au niveau de la source, en ligne.

## Nombre de mots

Exécutez **Nombre de mots** depuis la palette ⌘K pour obtenir les mots, caractères et lignes du fichier actif. Les fichiers Typst sont comptés selon les règles de Typst, le code et les commentaires restent donc hors du total.

## Touches Vim et Emacs

Choisissez **Vim** ou **Emacs** sous **Raccourcis clavier** dans **Paramètres → Apparence → Éditeur**, ou exécutez **Activer le mode Vim** depuis la palette ⌘K. Vim vous donne `hjkl`, les opérateurs et objets de texte (`dd`, `ciw`), `:w` et le mode visuel. Le changement s'applique immédiatement, et les raccourcis Oleafly de cette page continuent de fonctionner à côté.

## Au-delà du .tex

Les fichiers s'ouvrent avec une coloration adaptée à leur extension : BibTeX, Markdown, JSON, YAML, TOML, CSS, scripts shell et plus encore. Les images et les PDF s'ouvrent en vues rendues plutôt qu'en texte, et les formats binaires sont protégés contre toute altération accidentelle ; voir [Fichiers et dossiers](/docs/files/#how-different-file-types-open).

Si un fichier change sur le disque alors que vous y avez des modifications non enregistrées, un bandeau nomme le fichier et propose **Comparer**, **Garder ma version** et **Recharger**. Les fichiers LaTeX, Typst et Markdown en bénéficient tous.

## Pages liées

- [Complétion automatique et commandes slash](/docs/autocomplete/) : la complétion des commandes, références, citations et le menu d'insertion `/`
- [Intelligence du code](/docs/code-intelligence/) : aller à la définition, renommage, cartes au survol, aperçu des maths
- [Orthographe et grammaire](/docs/spellcheck-grammar/) : vérification Hunspell et Harper hors ligne qui comprend le LaTeX
- [Paquets](/docs/packages/), [Analyse du document](/docs/document-insights/) et [Réglages du document](/docs/document-settings/) : les outils de document à droite de la barre d'outils
- [Raccourcis clavier](/docs/keyboard-shortcuts/) : la référence complète
- [Éditions IA en ligne](/docs/ai-inline-edit/) : appuyez sur ⌘L sur une sélection et décrivez le changement
