# Paramètres de l'éditeur pour l'IA et la publication (/fr/editor/settings) Related: [Comment utiliser l'éditeur](/fr/editor/tutorial.md), [Notions essentielles de Git pour l'éditeur](/fr/editor/git-essentials.md), [Créer et modifier des pages](/fr/editor/pages.md), [Ajouter des médias](/fr/editor/media.md), [Organiser la navigation](/fr/editor/navigation.md), [Aperçu en direct](/fr/editor/live-preview.md) L'éditeur web comporte deux niveaux de paramètres : * **Vos paramètres** ne s'appliquent qu'à vous et contrôlent la façon dont l'IA de l'éditeur vous assiste pendant vos modifications. * **Les paramètres de publication** s'appliquent à toutes les personnes d'un déploiement et déterminent ce qui se passe lorsque vous validez des modifications et les transformez en pull requests. Vous pouvez configurer les deux depuis le panneau des paramètres. Pour l'ouvrir, cliquez sur l'icône de paramètres dans la barre d'outils de l'éditeur.
## Instructions d'IA [#instructions-dia]
Les instructions d'IA sont des consignes persistantes que l'éditeur envoie à l'IA avec votre requête. Utilisez-les pour formuler des règles de style et de ton que vous ne voulez pas répéter à chaque fois, comme la voix, la terminologie ou les conventions de mise en forme. Vos instructions s'appliquent à : * Les actions **Edit with AI** sur une sélection, comme réécrire, développer ou corriger. * Les **sessions de l'agent** lancées depuis l'éditeur. Chaque membre de l'équipe gère ses propres instructions, liées à son compte utilisateur.
### Quand utiliser les instructions d'IA [#quand-utiliser-les-instructions-dia]
Ajoutez des instructions d'IA lorsque vous vous surprenez à répéter les mêmes consignes dans vos prompts, par exemple : * Imposer la deuxième personne ou des titres en majuscule initiale uniquement. * Privilégier des noms de produit ou une terminologie spécifiques. * Bannir le langage marketing ou les phrases de remplissage. * Exiger certains composants, comme toujours utiliser `` pour les encarts. Gardez les instructions courtes et précises. L'IA les suit à chaque requête, donc des règles vagues ou contradictoires dégradent les résultats.
### Configurer les instructions d'IA [#configurer-les-instructions-dia]
1. Cliquez sur l'icône de paramètres dans la barre d'outils de l'éditeur. 2. Dans le champ **AI instructions**, saisissez les consignes que l'IA doit suivre. 3. Enregistrez vos modifications. Exemple : ```text - Use second person ("you") and active voice. - Use sentence case for all headings. - Refer to the product as "Acme" — never "Acme Inc." or "the platform". - Wrap notes and warnings in or components. - Do not add introductory filler like "In this guide" or "Let's explore". ``` Laissez le champ vide pour supprimer vos instructions.
## Paramètres de publication [#paramètres-de-publication]
Vous configurez les paramètres de publication par déploiement, et ils s'appliquent à toutes les personnes qui publient depuis l'éditeur. Ils contrôlent la façon dont l'éditeur génère, ouvre et fusionne les pull requests et les commits. Vous devez disposer d'un accès administrateur à votre déploiement Mintlify pour modifier les paramètres de publication.
### Verrouiller la branche de déploiement [#verrouiller-la-branche-de-déploiement]
Activez cette option pour rendre votre branche de déploiement (généralement `main`) en lecture seule dans l'éditeur. Lorsque la branche est verrouillée : * L'éditeur et la vue source deviennent en lecture seule pour toute personne consultant la branche de déploiement. * Le panneau de configuration `docs.json` cesse d'enregistrer les modifications. * Les modifications de navigation — ajout de pages, réorganisation et glisser-déposer — sont masquées. * Une bannière invite les contributeurs à créer une branche de brouillon avant de faire des modifications. Votre branche de déploiement reste synchronisée avec Git, donc les push depuis votre dépôt continuent de mettre à jour votre site en direct. Le verrouillage n'affecte que les modifications effectuées depuis l'éditeur. Activer le verrouillage abandonne toutes les modifications non publiées de l'éditeur sur la branche de déploiement et force la resynchronisation de l'éditeur avec votre dépôt Git. Publiez les modifications en attente ou déplacez-les vers une branche de brouillon avant d'activer le verrouillage. Tant que le verrouillage est actif, les push Git entrants vers la branche de déploiement écrasent l'état en direct de l'éditeur, de sorte que toute modification en cours sur cette branche est remplacée par le dernier commit. Utilisez ce paramètre lorsque votre équipe souhaite que Git reste la source de vérité pour le site en direct, et que toutes les modifications faites dans l'éditeur passent par des pull requests depuis des branches de fonctionnalité. Pour modifier pendant que la branche de déploiement est verrouillée, utilisez le sélecteur de branche dans la barre supérieure pour créer une branche de brouillon ou basculer vers celle-ci. Publiez ces modifications en ouvrant une pull request depuis votre branche de brouillon, comme pour toute autre branche de l'éditeur.
### Instructions pour la pull request [#instructions-pour-la-pull-request]
Les instructions pour la pull request guident l'IA lorsqu'elle génère le titre et la description d'une pull request. Elles s'appliquent dès que l'éditeur ouvre une pull request en votre nom, y compris dans les flux **Create pull request** et **Merge and publish**. Utilisez les instructions pour la pull request afin de standardiser 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 : ```text Title: imperative mood, under 70 characters, no trailing period. Description: include a "## Summary" section (one sentence) and a "## Changes" section as a bulleted list. Link any referenced page using its relative path. ```
### Créer les pull requests en brouillon par défaut [#créer-les-pull-requests-en-brouillon-par-défaut]
Activez cette option pour que l'éditeur ouvre chaque nouvelle pull request à l'état de brouillon. Vous ne pouvez pas fusionner une pull request en brouillon avant de la marquer comme prête pour la relecture. C'est utile lorsque : * Votre équipe exige une relecture manuelle avant d'ouvrir la pull request pour approbation. * Vous voulez partager des URL de prévisualisation sans signaler que la modification est prête à être fusionnée. Vous pouvez toujours marquer une pull request comme prête pour la relecture depuis votre fournisseur Git.
### Méthode de fusion par défaut [#méthode-de-fusion-par-défaut]
Choisissez la manière dont l'éditeur fusionne les pull requests lorsque vous cliquez sur **Merge and publish** : * **Merge** : Crée un commit de fusion qui conserve l'historique complet de la branche. * **Squash** : Combine tous les commits de la branche en un seul commit sur votre branche de déploiement. * **Rebase** : Rejoue chaque commit de la branche sur votre branche de déploiement, sans commit de fusion. L'éditeur utilise la méthode sélectionnée par défaut. Si vous passez une méthode de fusion explicite via l'API ou l'interface de votre fournisseur Git, ce choix prévaut. Alignez votre méthode de fusion par défaut sur les règles de protection de branche de votre fournisseur Git. Si votre branche de déploiement n'autorise que les fusions squash, définissez la valeur par défaut sur **Squash** pour éviter les échecs de fusion depuis l'éditeur.
## Danger zone [#danger-zone]
La section **Danger zone** du panneau des paramètres de l'éditeur contient des actions qui ne peuvent pas être annulées. Ouvrez-la depuis l'icône de paramètres dans la barre d'outils de l'éditeur, puis faites défiler jusqu'à **Danger zone**.
### Reset editor [#reset-editor]
**Reset editor** force l'éditeur à abandonner son état local et à se resynchroniser depuis votre référentiel Git. Utilisez cette action lorsque l'éditeur reste désynchronisé avec votre référentiel — par exemple, lorsque l'arborescence des fichiers est vide ou affiche des erreurs comme `Unable to find docs.json or mint.json` alors que le fichier existe sur votre branche de déploiement et que votre site en production se construit normalement. Réinitialiser l'éditeur supprime toutes les modifications non publiées qui n'ont pas été validées dans Git. Si vous avez des modifications en attente que vous souhaitez conserver, publiez-les d'abord. Pour réinitialiser l'éditeur : 1. Cliquez sur l'icône de paramètres dans la barre d'outils de l'éditeur. 2. Faites défiler jusqu'à **Danger zone**. 3. Cliquez sur **Reset editor** et confirmez. L'éditeur se recharge et récupère le dernier état depuis votre référentiel. L'action **Reset editor** se trouve dans le panneau des paramètres de l'éditeur, et non dans la [Danger zone](https://app.mintlify.com/settings/organization/danger-zone) des paramètres de votre Dashboard. La Danger zone du Dashboard sert uniquement à [supprimer un déploiement](/fr/deploy/deployments#delete-a-deployment). * [Branches et publication](/fr/editor/branching-and-publishing) * [Configurations](/fr/editor/configurations)