Ouvrir et organiser les fichiers

L'Explorateur affiche l'arborescence du projet, et l'ouverture rapide saute directement à un chemin.

Étapes

1. Ouvrez l'ouverture rapide et saisissez n'importe quelle partie d'un chemin ; la correspondance est floue, donc « intro » trouve sections/introduction.tex.
2. Utilisez Nouveau fichier, Nouveau dossier et Téléverser en haut de l'Explorateur, ou déposez des fichiers depuis votre bureau sur l'arborescence.
3. Faites glisser un fichier sur un dossier pour le déplacer ; son menu contextuel propose Ouvrir, Copier le chemin, Renommer, Télécharger et Supprimer.
4. Un clic ouvre le fichier ; le clavier reste dans l'Explorateur, donc Entrée sous Mac ou F2 sous Windows le renomme. Les flèches déplacent la sélection ; Suppr le retire.
5. Les images, les PDF, les diagrammes (.drawio), les carnets (.ipynb) et les documents Office s'ouvrent dans un volet d'aperçu plutôt que dans l'éditeur de texte.
6. Dans l'ouverture rapide, tapez > pour exécuter une commande, ou : suivi d'un nombre pour aller à cette ligne du fichier ouvert.

Ctrl+P ouvre l'ouverture rapide ; Ctrl+Shift+E place le focus sur l'arborescence des fichiers, et un second appui ou Échap revient à l'éditeur.

Déplacer, copier et lier des fichiers

L'Explorateur agit sur plusieurs fichiers à la fois et maintient les chemins écrits dans vos sources en accord avec l'emplacement des fichiers.

Étapes

1. Maintenez Maj avec les flèches pour sélectionner plusieurs éléments, puis coupez, copiez et collez-les avec les touches habituelles ou avec Couper, Copier et Coller du menu contextuel.
2. Télécharger en ZIP, dans le menu contextuel, télécharge un dossier ou toute la sélection, et Téléverser un dossier… importe un dossier avec tout son contenu.
3. Après le déplacement ou le renommage d'un fichier, un avis indique combien de références désignent encore son ancien chemin ; choisissez Aperçu pour voir chaque réécriture, ou Mettre à jour pour les appliquer toutes.
4. Faites glisser un fichier de l'Explorateur dans le texte et maintenez Maj au moment de le déposer pour y insérer le chemin du fichier.

Diviser l'espace de travail en volets

Chaque onglet peut occuper son propre volet, pour garder visibles la source, un autre fichier et le PDF.

Étapes

1. Faites un clic droit sur un onglet, ou utilisez la palette de commandes, pour diviser l'éditeur à gauche, à droite, en haut ou en bas.
2. Faites glisser un onglet sur un autre volet pour l'y déplacer, ou sur le bord d'un volet pour créer une nouvelle division.
3. Épinglez les onglets importants depuis leur menu : ils restent sur une ligne supérieure distincte et résistent aux raccourcis et fermetures groupées.
4. Agrandissez le volet actif pour vous concentrer un instant sur un fichier sans fermer les autres.
5. Fermer les autres, Fermer à droite et Tout fermer sont dans le même menu d'onglet.

Ctrl+Shift+W ferme l'onglet actif ; Ctrl+W ne fonctionne que dans l'application installée, car les navigateurs le réservent. F6 et Shift+F6 déplacent le focus entre la barre latérale, les volets de l'éditeur, le panneau inférieur et le panneau IA. Ctrl+PgDn et Ctrl+PgUp changent d'onglet et, avec Maj, déplacent l'onglet actif ; un navigateur sous Windows ou Linux garde ces touches pour lui : utilisez alors Ctrl+F6 et Ctrl+Shift+F6 pour changer d'onglet, et la palette de commandes pour déplacer les onglets. Sur Mac, ⌘⌥→ et ⌘⌥← changent aussi d'onglet. Ctrl+1 à Ctrl+9 passent à l'onglet situé à cette position. Pour redimensionner les volets, atteignez avec Tab le séparateur entre eux, puis utilisez les flèches.

Rechercher et remplacer dans le projet

La vue Rechercher parcourt tous les fichiers texte du projet, pas seulement ceux qui sont ouverts.

Étapes

1. Ouvrez Rechercher depuis la barre d'activité ou son raccourci, puis saisissez votre requête.
2. Activez Respecter la casse ou Utiliser une expression régulière, et ouvrez la ligne de détails pour ajouter des motifs d'inclusion et d'exclusion comme *.tex ou opencode/**.
3. Utilisez Afficher le remplacement pour modifier les correspondances sur place ; Tout remplacer est désactivé tant que les résultats sont incomplets, affinez donc d'abord les filtres.
4. Les fichiers générés et binaires (.pdf, .svg, .aux, .ipynb, fichiers de verrouillage) sont ignorés, sauf si un motif d'inclusion les nomme.

Ctrl+Shift+F ouvre la vue Rechercher ; Ctrl+F ne cherche que dans le fichier en cours d'édition.

Exécuter des commandes et régler l'éditeur

La palette de commandes réunit les actions du projet et toutes celles de l'éditeur de code lui-même.

Étapes

1. Ouvrez la palette et tapez : compiler, synchroniser avec le PDF, insérer une citation, ouvrir les paramètres, diviser les volets, commandes de mise en forme.
2. Masquez la barre latérale ou le panneau inférieur quand il vous faut plus de place pour la source.
3. Activez ou désactivez le retour à la ligne, la mini-carte et la vérification orthographique depuis la palette ; vos choix sont mémorisés.
4. Ouvrez les paramètres du projet depuis la palette pour la compilation et le document racine.
5. Lancez « Activer/désactiver le mode écriture concentrée » pour masquer la barre latérale, le panneau inférieur et le panneau IA et pour activer Mode focus et Défilement machine à écrire pendant que vous écrivez ; appuyez sur Échap pour en sortir.
6. Pour garder l'un ou l'autre effet en permanence, ouvrez les paramètres du projet, allez dans Éditeur et activez Mode focus, qui estompe tous les paragraphes sauf celui où vous écrivez, ou Défilement machine à écrire, qui garde la ligne courante centrée.

Ctrl+Shift+P ou F1 ouvre la palette ; Ctrl+Shift+B bascule la barre latérale ; Ctrl+` bascule le panneau inférieur ; Ctrl+Alt+B bascule le panneau IA ; Alt+Z bascule le retour à la ligne ; Ctrl+Alt+Z bascule le mode écriture concentrée.

Modifier avec les touches Vim

L'éditeur peut utiliser les modes et les commandes de Vim à la place de ses propres touches.

Étapes

1. Ouvrez les paramètres du projet, allez dans Éditeur et choisissez Vim sous Clavier, ou lancez « Activer/désactiver les touches Vim » depuis la palette de commandes ; le choix est enregistré dans votre compte et vous suit sur tous les appareils où vous vous connectez.
2. La barre d'état affiche le mode et les touches déjà saisies, et : et / y ouvrent leur ligne de saisie.
3. L'enregistrement est continu, il n'y a donc pas de fichier à écrire : :w compile à la place, :q ferme l'onglet, et :wq ou :x compile puis ferme.
4. u et Ctrl-R annulent et rétablissent uniquement vos propres modifications, jamais celles d'un collaborateur.
5. Sous Windows et Linux, Ctrl+S, Ctrl+P et Ctrl+J gardent leur rôle habituel dans tous les modes ; hors du mode insertion, les autres touches Control utilisées par Vim (par exemple Ctrl+F, Ctrl+B, Ctrl+D et Ctrl+U) reviennent à Vim. Sur un Mac, rien ne change, car les raccourcis de l'application utilisent Cmd.

:w compile ; :q ferme l'onglet ; :wq ou :x compile puis ferme ; :e ouvre « Aller au fichier » ; :sp et :vs divisent l'éditeur ; gt / gT et :bn / :bp changent d'onglet ; Ctrl-W puis w, l ou j passe au volet suivant, et Ctrl-W puis h ou k au précédent.