Manuel de l’utilisateur

Onglets de documents et de navigateur

Les onglets du volet central ne contiennent pas uniquement des terminaux. Ce chapitre présente deux autres types d’onglets : les onglets de document (l’éditeur Markdown et l’éditeur de code intégrés) et les onglets de navigateur (pages web intégrées). Ils partagent la barre d’onglets avec les onglets de session, et l’ouverture d’une session ne les remplace jamais.

1. Onglets de document

1.1 Ouverture

Un onglet de document s’ouvre lorsque vous :

  • exécutez vopen <file> dans n’importe quelle session (dans Claude Code, la compétence /vopen produit le même résultat une fois les « Vela Skills » installées depuis Paramètres ▸ Général) ;
  • double-cliquez sur un fichier dans l’onglet Fichiers du panneau de droite, ou choisissez « Ouvrir dans l’éditeur » ;
  • ouvrez une note depuis la base de connaissances (voir Bases de connaissances locales) ;
  • cliquez sur « Nouveau document » à l’extrémité droite de la barre d’onglets.

La vue est choisie en fonction du type de fichier :

TypeVue
md / markdown / mdxÉditeur Markdown avec les modes « Visuel », « Code source » et « Comparaison » ; s’ouvre en mode Visuel
Images (png, jpg, jpeg, gif, webp, svg, bmp, ico, avif)Visionneuse d’images avec « Ajuster » et « 1:1 »
Tous les autres fichiersÉditeur de code avec une coloration syntaxique déterminée d’après le nom du fichier

Un document Markdown ouvert avec vopen

1.2 L’éditeur Markdown

  • Visuel est un éditeur WYSIWYG, qui affiche le document tel qu’il sera rendu. Saisissez / pour ouvrir le menu d’insertion (titres, listes, listes de tâches, citations, blocs de code, tableaux, formules mathématiques, images et séparateurs). Les blocs de code délimités mermaid sont rendus sous forme de diagrammes sous le bloc.
  • Code source affiche le texte du fichier exactement tel qu’il est enregistré, y compris un éventuel en-tête YAML (front matter), avec la coloration syntaxique Markdown.
  • Comparaison affiche Visuel et Code source côte à côte et les maintient synchronisés pendant que vous modifiez l’un ou l’autre.
  • ⌘/ (Ctrl+/ sous Windows et Linux) bascule entre Visuel et Code source. Un changement de mode sans modification du contenu ne modifie pas le fichier.
  • Si vous collez ou déposez une image dans un document enregistré, l’image est stockée dans un dossier assets situé à côté du document, et un lien relatif vers celle-ci est inséré.

1.3 Modification et enregistrement

  • ⌘S ou le bouton « Enregistrer » écrit le fichier sur le disque. Un point sur l’onglet signale des modifications non enregistrées.
  • Le document actif vérifie le disque toutes les deux secondes. Si un autre programme modifie le fichier, un bandeau propose « Recharger » et « Ignorer » ; si vous avez également des modifications non enregistrées, le bouton de rechargement devient « Recharger (abandonner mes modifications) ». Si le fichier a été modifié sur le disque après le début de vos modifications, l’enregistrement demande une confirmation dans une boîte de dialogue « Conflit d’enregistrement » avant d’écraser le fichier.
  • La fermeture d’un onglet contenant des modifications non enregistrées vous invite à choisir « Enregistrer et fermer », « Fermer sans enregistrer » ou « Annuler ».
  • ⌘F ouvre la barre de recherche, qui permet de rechercher, remplacer, tout remplacer et « Respecter la casse » ; elle fonctionne de la même façon dans tous les modes.
  • Le bouton « Panneau latéral » affiche le « Plan » du document et une « Arborescence » de son dossier ; cliquez sur un fichier de cette arborescence pour l’ouvrir. Le panneau latéral peut être redimensionné.
  • Les fichiers de plus de 10 Mo s’ouvrent en lecture seule et n’affichent que leurs 10 premiers Mo, afin qu’un enregistrement ne puisse pas tronquer le reste du fichier.
  • Le clic droit sur un onglet de document propose « Recharger le fichier » et, pour les fichiers Markdown, « Exporter en PDF », en plus des actions de fermeture habituelles.

1.4 Nouveaux documents et export PDF

  • « Nouveau document » ouvre un brouillon vide qui n’existe pas encore sur le disque et n’apparaît pas dans l’arborescence du projet. Le premier enregistrement vous demande où le stocker : l’application de bureau utilise la boîte de dialogue Enregistrer sous du système, tandis que les clients navigateur et les fenêtres de connexion à distance affichent une boîte de dialogue Enregistrer sous pour la machine qui exécute la session. La coloration syntaxique suit le nom de fichier choisi. Le clic droit sur l’onglet d’un brouillon propose aussi « Enregistrer sur le disque… ».
  • « Exporter en PDF » convertit un document Markdown en PDF vectoriel, avec des sauts de page automatiques et des polices CJK incorporées. L’application de bureau demande où enregistrer le fichier ; les clients navigateur le téléchargent.

2. Onglets de navigateur (application de bureau uniquement)

Les onglets de navigateur affichent de véritables pages web dans VelaTerm, ce qui permet de garder une documentation, des pages de tickets ou un aperçu local à côté de vos sessions. Ils ne sont disponibles que dans l’application de bureau, et non dans les clients navigateur, les fenêtres de connexion à distance ou la disposition mobile.

Ouvrir un onglet de navigateur :

  • le bouton « Navigateur intégré » à l’extrémité droite de la barre d’onglets ;
  • le raccourci ⌘⇧B ;
  • vopen <URL> dans une session ;
  • « Nouvelle page de navigateur » dans le menu contextuel d’un projet ou d’un groupe de la barre latérale.

Barre d’outils : « Retour », « Avancer », « Recharger » (ou « Arrêter le chargement » pendant le chargement d’une page), une barre d’adresse (« Saisir une URL ou des termes de recherche » ; un texte qui n’est pas une adresse est recherché sur Google), « Ouvrir dans le navigateur système » et une ligne « Accès rapide » avec ChatGPT, Claude, Gemini et Google.

Deux formes :

  • Onglet de navigateur : ouvert avec le bouton, ⌘⇧B ou vopen <URL>. Il n’est pas enregistré dans l’arborescence du projet et ne subsiste pas après un redémarrage.
  • Nœud de page de navigateur : créé avec « Nouvelle page de navigateur ». Il s’agit d’un nœud de l’arborescence du projet qui mémorise son adresse et reste présent après un redémarrage.

Liens qui ouvrent de nouvelles fenêtres : lorsqu’une page ouvre un lien dans une nouvelle fenêtre (par exemple un lien target="_blank"), VelaTerm l’ouvre dans un nouvel onglet de navigateur.

Pages autonomes : le bouton « Centre de jeux », à l’extrémité droite de la barre d’onglets, ouvre le centre de jeux de VelaTerm sous forme de page autonome. Une page autonome ne comporte ni barre d’adresse ni ligne d’accès rapide, mais seulement « Retour », « Avancer » et « Recharger » ; les liens qu’elle ouvre restent dans le même onglet.

Limite de sécurité : une page intégrée est traitée comme un site web externe ordinaire. Elle ne reçoit aucune autorisation ni aucun identifiant de VelaTerm, et seules les adresses http et https peuvent être ouvertes.

3. Cohabitation des types d’onglets

  • Les onglets de session, de document et de navigateur partagent une même barre d’onglets, et ⌘1–9 permet de passer de l’un à l’autre.
  • L’ouverture d’une session depuis l’arborescence ne réutilise que les onglets de session ; les onglets de document et de navigateur ne sont jamais remplacés.
  • Les onglets de document et de navigateur ne peuvent pas être divisés. ⌘W les ferme directement (un document contenant des modifications non enregistrées demande d’abord une confirmation).