Utilisez Editor pour afficher et gérer les fichiers source de votre projet Atoms. Vous pouvez trouver des fichiers, prévisualiser les formats pris en charge, comparer les modifications, ajouter du code à Chat comme contexte et télécharger des fichiers individuels, des dossiers ou le projet complet.

Ce guide couvre uniquement les fichiers stockés dans l'espace de travail du projet. Les fichiers téléversés dans Chat, les médias générés, les données cloud, les versions publiées et les fichiers provenant de services connectés sont gérés séparément.

Avant de commencer

• Utilisez un navigateur de bureau. L'expérience Editor est limitée sur les appareils mobiles.
• Attendez que l'Agent ait terminé avant d'apporter des modifications manuelles aux mêmes fichiers.
• Ouvrez la dernière version du projet. Si vous consultez une version antérieure, sélectionnez Restore dans les contrôles de version, confirmez Restore, puis attendez la fin de la restauration avant de modifier quoi que ce soit.
• La modification ou le téléchargement d'un projet peut nécessiter un forfait payant éligible.

Ne placez jamais de mots de passe, de clés API, de jetons d'accès ou d'autres secrets directement dans les fichiers source ou dans Chat.

Ouvrir Editor

1. Ouvrez un projet existant.
2. Sélectionnez Editor dans la barre d'outils du projet.
3. Attendez que l'arborescence des fichiers et la visionneuse de fichiers se chargent.

L'arborescence des fichiers apparaît à gauche. Le fichier sélectionné s'ouvre à droite dans un éditeur de code ou un aperçu. Les outils affichés pour un fichier dépendent de son format et de l'état actuel du projet.

Trouver et prévisualiser des fichiers

Rechercher par nom de fichier ou de dossier

1. Sélectionnez Search au-dessus de l'arborescence des fichiers.
2. Saisissez une partie du nom d'un fichier ou d'un dossier.
3. Sélectionnez un résultat correspondant pour l'ouvrir.

La recherche correspond aux noms de fichiers et de dossiers. Elle ne recherche pas le texte à l'intérieur des fichiers. Si vous ne trouvez pas un élément, raccourcissez le terme de recherche, effacez la recherche et développez manuellement les dossiers concernés.

Rechercher dans l'arborescence des fichiers d'Editor par nom de fichier ou de dossier.

Prévisualiser un fichier

Sélectionnez un fichier dans l'arborescence. Atoms peut prévisualiser les fichiers de code et de texte courants, les fichiers HTML, Markdown, DOCX et XLSX, les images, les fichiers audio et vidéo pris en charge, les PDF, les fichiers CSV et les notebooks Jupyter. L'aperçu disponible dépend du type de fichier.

Si un fichier ou un dossier ne peut pas être prévisualisé, téléchargez-le et ouvrez-le dans une application compatible.

Modifier le code du projet

1. Ouvrez un fichier de code ou de texte pris en charge.
2. Apportez vos modifications dans l'éditeur.
3. Attendez que l'indicateur d'enregistrement se termine. L'enregistrement synchronise votre session d'édition actuelle, mais n'applique pas encore toute la session.
4. Sélectionnez Preview pour vérifier le résultat, lorsqu'un aperçu est disponible.
5. Sélectionnez Submit all pour appliquer la session, ou Discard all pour annuler les modifications de cette session.

Les modifications manuelles et les changements générés par l'Agent peuvent affecter les mêmes fichiers. Soumettez ou abandonnez vos modifications en cours avant de demander à l'Agent de modifier le projet, et utilisez l'historique du projet avant d'effectuer un changement important.

Prévisualiser, abandonner ou soumettre une session d'édition Editor.

Si Editor est en lecture seule

Editor peut temporairement empêcher les modifications pendant que l'Agent travaille, qu'un enregistrement est en cours ou que vous consultez une version antérieure du projet. Il peut également être en lecture seule pour un projet non pris en charge ou un compte ne disposant pas de l'accès requis.

Attendez la fin de l'opération en cours, ouvrez la dernière version et actualisez la page. Si vous consultez une ancienne version, sélectionnez Restore dans les contrôles de version, confirmez Restore, attendez la fin de la restauration, puis rouvrez la dernière version. Vérifiez que l'indicateur Read only n'est plus affiché avant de modifier.

Utiliser du code dans Chat et comparer les modifications

Ajouter un fichier entier à Chat

Ouvrez le fichier, cliquez sur les points verticaux ... puis sur Select file lorsque l'action est disponible. Vous pouvez également saisir # dans Chat et choisir un fichier du projet. Le fichier est ajouté comme contexte pour votre prochaine demande.

Ouvrez les actions du fichier actuel et sélectionnez Select file.

Comparer une modification

Sélectionnez Diff lorsqu'il est disponible pour comparer les versions originale et modifiée d'un fichier avant d'appliquer la modification.

Gérer les fichiers et les dossiers

Utilisez ... à côté d'un élément dans l'arborescence des fichiers pour voir les actions disponibles pour ce fichier ou dossier. Selon l'élément et l'état du projet, vous pouvez créer, téléverser, renommer, télécharger ou supprimer des fichiers et des dossiers.

1. Repérez le fichier ou le dossier dans l'arborescence.
2. Sélectionnez ....
3. Choisissez l'action requise et suivez l'invite à l'écran.

La suppression d'un fichier ou d'un dossier est irréversible. Avant de supprimer des fichiers importants du projet, créez une version sécurisée du projet ou téléchargez-en une copie.

Certaines actions sur les fichiers ne sont pas disponibles pendant que l'Agent modifie le projet ou pendant l'enregistrement d'une session d'édition. Attendez la fin de l'opération en cours et réessayez.

Télécharger le code et les fichiers

Télécharger le fichier actuel

1. Ouvrez le fichier dans Editor.
2. Sélectionnez Download dans les actions du fichier actuel.
3. Ouvrez l'emplacement de téléchargement de votre navigateur et vérifiez le fichier.

Télécharger un dossier

1. Sélectionnez ... à côté du dossier.
2. Sélectionnez Download. Atoms regroupe le dossier dans une archive ZIP.
3. Ouvrez l'archive et vérifiez son contenu.

Télécharger le projet actuel

1. Dans Editor, sélectionnez Download Project sous l'arborescence des fichiers.
2. Gardez la page ouverte pendant qu'Atoms prépare l'archive.
3. Ouvrez le ZIP téléchargé et vérifiez les fichiers dont vous avez besoin.

Vous devez être connecté. Le téléchargement du code source du projet actuel peut nécessiter un forfait payant éligible. Le téléchargement depuis Editor peut également ne pas être disponible dans une vue de projet partagée en lecture seule.

Exporter depuis Share

Vous pouvez également ouvrir Share et sélectionner Export. Cela offre une autre façon d'exporter le projet sous forme de ZIP. Vérifiez l'archive téléchargée avant de vous y fier comme transfert ou sauvegarde.

Ouvrez Share et sélectionnez Export pour télécharger le projet.