La page de paramètres de l’éditeur contrôle l’apparence, le comportement de publication et le comportement de l’agent.
- Appearance : Préférences personnelles sur l’aspect et le comportement de l’éditeur. Elles ne s’appliquent qu’à vous.
- Publishing : Valeurs par défaut, à l’échelle du deployment, sur la façon dont l’éditeur commit les modifications et ouvre les pull requests. Elles s’appliquent à toutes les personnes qui publient.
- Chat : Instructions persistantes pour l’agent d’IA de l’éditeur.
- Danger zone : Actions irréversibles.
Les paramètres d’apparence sont des préférences personnelles. Ils ne modifient l’éditeur que pour vous et n’affectent ni vos coéquipiers ni votre site publié.
- Fit editor to full width : Étend la zone d’édition d’un bord à l’autre au lieu de la colonne de 768px par défaut.
- Show breadcrumbs : Affiche l’emplacement de la page dans la navigation du site au-dessus de la zone d’édition.
- Open live preview in new tab : Ouvre la page rendue dans un nouvel onglet du navigateur lors de la prévisualisation, au lieu de l’aperçu en volet partagé.
- Show all files : Affiche tous les fichiers dans la barre latérale, y compris les dotfiles, le code, les PDF et les autres fichiers masqués par défaut. Vous pouvez aussi appuyer sur Cmd + Shift + . (macOS) ou Ctrl + Shift + . (Windows) pour basculer l’affichage.
Les instructions de PR guident l’IA lorsqu’elle génère le titre et la description d’une pull request. Elles s’appliquent chaque fois que l’éditeur ouvre une pull request en votre nom, y compris depuis les flux Create pull request et Merge and publish.
Utilisez les instructions de PR pour normaliser ce que voient les relecteurs, par exemple :
- Des sections obligatoires comme Summary et Changes.
- Un modèle de description qui renvoie vers un système de suivi.
- Des exigences de ton ou de longueur pour les titres.
Exemple :
Les instructions sont limitées à 20 000 caractères.
Autocommits sur la branch main
Avec les autocommits sur la branch main activés, il n’y a ni état en attente ni possibilité de relecture. Chaque modification atteint votre site publié peu après que vous arrêtez d’écrire.
Créer les pull requests en brouillon par défaut
- Merge : Crée un commit de fusion qui conserve tout l’historique de la branch. C’est l’option par défaut.
- Squash : Combine tous les commits de la branch en un seul commit sur votre deployment branch.
- Rebase : Rejoue chaque commit de la branch sur votre deployment branch sans commit de fusion.
Si vous transmettez une méthode de fusion explicite via l’API ou l’interface de votre fournisseur Git, ce choix l’emporte.
Faites correspondre votre méthode de fusion aux règles de protection de branch de votre fournisseur Git. Si votre deployment branch n’autorise que les squash merges, choisissez Squash pour éviter les fusions en échec depuis l’éditeur.
- Aux actions Edit with AI sur une sélection, comme réécrire, développer ou corriger.
- Aux sessions de l’agent lancées depuis l’éditeur.
Chaque membre de l’équipe gère ses propres instructions, liées à son compte utilisateur. Les instructions sont limitées à 20 000 caractères.
Ajoutez des instructions d’IA lorsque vous constatez que vous répétez les mêmes consignes dans vos prompts, par exemple :
- Imposer la deuxième personne ou des titres en casse de phrase.
- Privilégier des noms de produit ou une terminologie précis.
- Interdire le langage marketing ou les formules de remplissage.
- Exiger certains composants, comme toujours utiliser
<Note> pour les encadrés.
Gardez des instructions courtes et précises. L’IA les suit à chaque demande, donc des règles vagues ou contradictoires dégradent les résultats.
Exemple :
Laissez le champ vide pour supprimer vos instructions.
Reset editor force l’éditeur à abandonner son état local et à se synchroniser avec votre dépôt Git. Réinitialisez l’éditeur s’il reste désynchronisé par rapport à votre dépôt, par exemple si l’arborescence de fichiers est vide ou affiche des erreurs comme Unable to find docs.json. Cela peut se produire alors même que le fichier existe sur votre deployment branch et que votre site se compile normalement.
Si vous réinitialisez l’éditeur, vous perdez toutes les modifications non publiées que vous n’avez pas commitées dans Git. Si vous avez des modifications en attente que vous voulez conserver, publiez-les d’abord.
