From 1e9b2fe563083f4d308ba936f437129130f052b1 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 28 Jul 2026 20:11:13 +0000 Subject: [PATCH] docs: translate editor drafts deprecation to es/fr/zh --- es.json | 1 - es/changelog.mdx | 2 +- es/editor/drafts.mdx | 111 ------------------------------------- es/editor/index.mdx | 6 +- es/editor/settings.mdx | 6 +- es/editor/suggestions.mdx | 2 +- es/editor/tutorial.mdx | 4 +- es/guides/git-concepts.mdx | 2 +- fr.json | 1 - fr/changelog.mdx | 2 +- fr/editor/drafts.mdx | 111 ------------------------------------- fr/editor/index.mdx | 6 +- fr/editor/settings.mdx | 6 +- fr/editor/suggestions.mdx | 2 +- fr/editor/tutorial.mdx | 4 +- fr/guides/git-concepts.mdx | 2 +- zh.json | 1 - zh/changelog.mdx | 2 +- zh/editor/drafts.mdx | 111 ------------------------------------- zh/editor/index.mdx | 6 +- zh/editor/settings.mdx | 6 +- zh/editor/suggestions.mdx | 2 +- zh/editor/tutorial.mdx | 4 +- zh/guides/git-concepts.mdx | 2 +- 24 files changed, 24 insertions(+), 378 deletions(-) delete mode 100644 es/editor/drafts.mdx delete mode 100644 fr/editor/drafts.mdx delete mode 100644 zh/editor/drafts.mdx diff --git a/es.json b/es.json index 3979e6ca33..af738555e4 100644 --- a/es.json +++ b/es.json @@ -71,7 +71,6 @@ "es/editor/media", "es/editor/navigation", "es/editor/live-preview", - "es/editor/drafts", "es/editor/branching-and-publishing", "es/editor/publish", "es/editor/comments", diff --git a/es/changelog.mdx b/es/changelog.mdx index af8e0744ee..95e1db1ea2 100644 --- a/es/changelog.mdx +++ b/es/changelog.mdx @@ -76,7 +76,7 @@ noindex: true ## Mejoras del editor - - **Borradores:** Trabaja en cambios sin publicar sin crear una rama ni usar comandos de Git. Consulta [Borradores](/es/editor/drafts) para obtener más información. + - **Borradores:** Trabaja en cambios sin publicar sin crear una rama ni usar comandos de Git. Consulta [Borradores](/es/editor/branching-and-publishing) para obtener más información. - **Bloquea la rama de despliegue:** El editor ahora te pide bloquear tu rama de despliegue si detecta protecciones de rama. - **[Agente del editor](/es/editor) más rápido con mejor función de deshacer/rehacer:** Las actualizaciones del agente ahora se transmiten al instante, la navegación es más rápida y los cambios de contenido y del árbol de navegación se pueden deshacer y rehacer de forma limpia. - **El estado de los encabezados plegables se mantiene por usuario:** Tus preferencias de secciones expandidas y colapsadas se conservan entre sesiones del editor. diff --git a/es/editor/drafts.mdx b/es/editor/drafts.mdx deleted file mode 100644 index 9b74c57841..0000000000 --- a/es/editor/drafts.mdx +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: "Borradores" -description: "Crea borradores aislados en el editor que se mantienen privados hasta que solicitas revisión y los publicas, sin gestionar branches de Git por tu cuenta." -keywords: ["editor", "borrador", "publicar", "guardado automático"] ---- - -Usa los borradores para trabajar en cambios en el editor antes de publicarlos en tu sitio en producción. Un borrador es un espacio de trabajo aislado donde redactas, previsualizas y editas contenido. Tus cambios solo están disponibles en el editor hasta que decides publicarlos. - -Los borradores son la forma recomendada de hacer cambios en el editor. Cada borrador tiene una branch de Git y una pull request que el editor gestiona por ti, de modo que puedes trabajar sin cambiar de branch ni abrir pull requests. - -
- ## Cómo funcionan los borradores -
- -**Cada edición se guarda automáticamente.** A medida que escribes, el editor guarda tu trabajo en los servidores de Mintlify y, en segundo plano, confirma los cambios en la branch del borrador. Tus cambios se conservan entre pestañas, dispositivos e interrupciones de red. - -**Cada borrador lleva su propio historial de versiones.** El editor confirma los cambios a medida que trabajas, por lo que un borrador acumula un historial de cambios en su branch. También mantiene abierta una pull request que refleja el estado actual del borrador. - -**Nada se publica hasta que tú lo publicas.** Un borrador nunca afecta a tu sitio en producción mientras lo editas. Tú controlas cuándo se despliegan sus cambios. - -**Mantén varios borradores a la vez.** Trabaja en varios conjuntos de cambios en paralelo, cada uno en su propio borrador, y publícalos por separado. - - - Los borradores están separados de la branch de implementación que compila tu sitio en producción. Editar un borrador nunca cambia tu sitio en producción hasta que publicas el borrador. - - -
- ## Crear un borrador -
- -1. Haz clic en el selector de implementación en la barra de herramientas del editor. Cuando editas tu branch de implementación, muestra **Live site**. Cuando editas un borrador, muestra el nombre del borrador. - - El selector de implementación en la barra de herramientas del editor mostrando el sitio en producción. -El selector de implementación en la barra de herramientas del editor mostrando el sitio en producción en modo oscuro. - -2. Haz clic en la pestaña **Drafts**. -3. Haz clic en **New draft**. - -El editor crea el borrador y cambia a él. Los borradores nuevos empiezan con el nombre "Untitled draft". Renombra tus borradores con nombres descriptivos para poder identificarlos más adelante. - -
- ## Cambiar entre borradores -
- -1. Haz clic en el selector de implementación en la barra de herramientas del editor. -2. Haz clic en **Live site** para volver a tu branch de implementación, o haz clic en otro borrador para cambiar a él. - -La pestaña **Drafts** enumera tus borradores con la hora de la última actualización de cada uno, del más reciente al más antiguo. Usa el campo de búsqueda para filtrar los borradores por nombre. - -
- ## Publicar un borrador -
- -Cuando tu borrador esté listo, abre el menú de publicación para revisar tus cambios y publicarlos. Las acciones disponibles dependen de si tu branch de implementación requiere revisión antes de que los cambios se publiquen. - - - - Haz clic en **Publish** en la barra de herramientas del editor. El menú enumera todos los cambios pendientes del borrador. Haz clic en cualquier cambio para revisarlo. - - - Si tu branch de implementación requiere revisión, haz clic en **Request review** para marcar la pull request del borrador como lista para que tu equipo la revise. Los revisores aprueban la pull request desde el editor o desde tu proveedor de Git. - - - Haz clic en **Publish** para fusionar el borrador en tu branch de implementación y desplegarlo. Si tu equipo exige revisiones, **Publish** solo estará disponible después de que la pull request reciba aprobación. - - Solo puede haber una publicación a la vez por borrador. Si ya hay una publicación en curso, espera a que termine antes de volver a publicar. - - - -
- ## Renombrar un borrador -
- -1. Haz clic en el selector de implementación en la barra de herramientas del editor. -2. Haz clic en la pestaña **Drafts**. -3. Pasa el cursor sobre el borrador y haz clic en el icono de renombrar. -4. Introduce un nombre nuevo y pulsa Enter. - -Renombrar un borrador también actualiza el título de su pull request. - -
- ## Eliminar un borrador -
- -1. Haz clic en el selector de implementación en la barra de herramientas del editor. -2. Haz clic en la pestaña **Drafts**. -3. Pasa el cursor sobre el borrador y haz clic en el icono de eliminar. -3. Confirma la eliminación. - - - Eliminar un borrador descarta de forma permanente sus cambios sin publicar y cierra su pull request. No puedes deshacer esta acción. - - -
- ## Borradores frente a branches -
- -Tanto los borradores como las branches te permiten trabajar en cambios de forma aislada antes de publicarlos. Elige según cómo trabaje tu equipo: - -- **Usa borradores** si quieres que el editor gestione Git por ti. -- **Usa branches** si sigues un flujo de trabajo basado en Git y quieres nombrar branches, gestionar pull requests directamente o coordinarte con cambios hechos fuera del editor. Consulta [Branching y publicación](/es/editor/branching-and-publishing). - -Ambas opciones están disponibles en el selector de implementación, de modo que puedes moverte entre los dos enfoques en cualquier momento. diff --git a/es/editor/index.mdx b/es/editor/index.mdx index 7accc3053a..5f245a6b53 100644 --- a/es/editor/index.mdx +++ b/es/editor/index.mdx @@ -23,7 +23,7 @@ Abre el editor desde la pestaña [Editor](https://app.mintlify.com/editor) en tu -**Los cambios se guardan automáticamente.** A medida que escribe, el editor guarda su borrador. Su trabajo persiste entre pestañas, dispositivos e interrupciones de red. Los cambios solo se publican cuando usted los publica. +**Los cambios se guardan automáticamente.** A medida que escribe, el editor guarda su trabajo. Sus cambios persisten entre pestañas, dispositivos e interrupciones de red. Los cambios solo se publican cuando usted los publica. **Git se mantiene sincronizado.** Cuando alguien envía cambios a su repositorio desde fuera del editor, esos cambios aparecen automáticamente en el editor. No necesita hacer pull ni actualizar. El editor fusiona los cambios que no entran en conflicto y resalta lo que requiere su atención. @@ -55,10 +55,6 @@ Abre el editor desde la pestaña [Editor](https://app.mintlify.com/editor) en tu - - Trabaje los cambios en un borrador aislado que permanece sin publicar hasta que solicite la revisión y lo publique. - - Cómo las branches y las reglas de protección determinan lo que sucede al publicar, y cómo gestionar el proceso de revisión de pull requests. diff --git a/es/editor/settings.mdx b/es/editor/settings.mdx index cdc38600fd..f9e3620ccf 100644 --- a/es/editor/settings.mdx +++ b/es/editor/settings.mdx @@ -1,7 +1,7 @@ --- title: "Configuración del editor para IA y publicación" -description: "Configure instrucciones de IA, valores predeterminados de pull requests, comportamiento de borradores y método de fusión en el editor web de Mintlify." -keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "draft", "merge", "lock branch"] +description: "Configure instrucciones de IA, valores predeterminados de pull requests y el método de fusión predeterminado para controlar cómo el editor web de Mintlify publica los cambios." +keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"] --- El editor web tiene dos capas de configuración: @@ -94,7 +94,7 @@ Tu rama de despliegue permanece sincronizada con Git, por lo que los push desde Mientras el bloqueo esté activo, los push entrantes de Git a la rama de despliegue sobrescriben el estado en vivo del editor, por lo que cualquier edición en curso en esa rama se reemplaza con el último commit. -Usa este ajuste cuando tu equipo quiera que Git siga siendo la fuente de verdad del sitio en producción, y que todos los cambios del editor pasen por pull requests desde ramas borrador. +Usa este ajuste cuando tu equipo quiera que Git siga siendo la fuente de verdad del sitio en producción, y que todos los cambios del editor pasen por pull requests desde ramas de funcionalidad. Para editar mientras la rama de despliegue está bloqueada, usa el selector de ramas en la barra superior para crear una rama borrador o cambiarte a una. Publica esos cambios abriendo un pull request desde tu rama borrador, igual que con cualquier otra rama del editor. diff --git a/es/editor/suggestions.mdx b/es/editor/suggestions.mdx index cc8839dd4b..db19a96a59 100644 --- a/es/editor/suggestions.mdx +++ b/es/editor/suggestions.mdx @@ -43,7 +43,7 @@ Las sugerencias pendientes aparecen como texto resaltado en el editor y se muest 1. Haz clic en el texto de la sugerencia resaltada. 2. Haz clic en el botón **Accept** para aplicar el cambio propuesto. -Aceptar una sugerencia resuelve y elimina el hilo de la sugerencia. El cambio aceptado pasa a formar parte del borrador actual y se publica la próxima vez que [publiques](/es/editor/branching-and-publishing). +Aceptar una sugerencia resuelve y elimina el hilo de la sugerencia. El cambio aceptado pasa a formar parte de tu branch actual y se publica la próxima vez que [publiques](/es/editor/branching-and-publishing).
## Rechazar una sugerencia diff --git a/es/editor/tutorial.mdx b/es/editor/tutorial.mdx index 18e60a50a5..ef703572fa 100644 --- a/es/editor/tutorial.mdx +++ b/es/editor/tutorial.mdx @@ -8,9 +8,7 @@ Este tutorial le guía a través de una actualización completa de contenido usa - Una branch es una copia temporal de su contenido. Es donde realiza sus cambios sin afectar a su sitio en producción. - - Piense en las branches como borradores. Puede fusionarlas con su sitio en producción o descartarlas de forma segura si decide no aplicar los cambios. + Una branch es una copia temporal de su contenido. Es donde realiza sus cambios sin afectar a su sitio en producción. Puede fusionarla con su sitio en producción o descartarla de forma segura si decide no aplicar los cambios. Trabajar en una branch mantiene sus ediciones separadas de su sitio en producción hasta que esté listo para compartir el contenido con sus usuarios. diff --git a/es/guides/git-concepts.mdx b/es/guides/git-concepts.mdx index 704d476df3..b1ae2166af 100644 --- a/es/guides/git-concepts.mdx +++ b/es/guides/git-concepts.mdx @@ -140,7 +140,7 @@ El editor web se conecta a tu repositorio de Git a través de la [Aplicación de Cuando: * **Abres un archivo**: El editor obtiene la versión más reciente de tu repositorio, asegurando que siempre trabajes con contenido actualizado. -* **Realizas cambios**: El editor rastrea tus cambios como un borrador que puede convertirse en una confirmación cuando estés listo para guardar tu trabajo. +* **Realizas cambios**: El editor rastrea tus cambios y los convierte en una confirmación cuando guardas tu trabajo. * **Guardas cambios**: El editor crea una confirmación con tus cambios, preservando tu trabajo en el historial del proyecto. * **Creas una branch**: El editor crea una nueva branch en tu repositorio que puede ser utilizada por cualquier persona con acceso al repositorio para colaborar y revisar cambios. * **Publicas en tu rama de implementación**: El editor confirma y hace push directamente a tu rama de implementación, lo que publica tus cambios de inmediato. diff --git a/fr.json b/fr.json index a754385cba..18bf7e5ab3 100644 --- a/fr.json +++ b/fr.json @@ -71,7 +71,6 @@ "fr/editor/media", "fr/editor/navigation", "fr/editor/live-preview", - "fr/editor/drafts", "fr/editor/branching-and-publishing", "fr/editor/publish", "fr/editor/comments", diff --git a/fr/changelog.mdx b/fr/changelog.mdx index 45c8a92f93..732af4c6f4 100644 --- a/fr/changelog.mdx +++ b/fr/changelog.mdx @@ -76,7 +76,7 @@ noindex: true ## Améliorations de l'éditeur
- - **Brouillons :** Travaillez sur des modifications non publiées sans créer de branche ni utiliser de commandes Git. Consultez [Brouillons](/fr/editor/drafts) pour plus d'informations. + - **Brouillons :** Travaillez sur des modifications non publiées sans créer de branche ni utiliser de commandes Git. Consultez [Brouillons](/fr/editor/branching-and-publishing) pour plus d'informations. - **Verrouiller la branche de déploiement :** L'éditeur propose désormais de verrouiller votre branche de déploiement s'il détecte des protections de branche. - **[Agent de l'éditeur](/fr/editor) plus rapide avec un meilleur annuler/rétablir :** Les mises à jour de l'agent s'affichent désormais instantanément, la navigation est plus rapide, et les modifications de contenu et d'arborescence de navigation peuvent être annulées et rétablies proprement. - **État des titres repliables conservé par utilisateur :** Vos préférences de sections dépliées et repliées sont conservées d'une session à l'autre de l'éditeur. diff --git a/fr/editor/drafts.mdx b/fr/editor/drafts.mdx deleted file mode 100644 index 43b198890a..0000000000 --- a/fr/editor/drafts.mdx +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: "Brouillons" -description: "Créez des brouillons isolés dans l'éditeur qui restent privés jusqu'à publication, sans avoir à gérer vous-même les branches Git ni les demandes de révision." -keywords: ["éditeur", "brouillon", "publier", "enregistrement automatique"] ---- - -Utilisez les brouillons pour travailler sur des modifications dans l'éditeur avant de les publier sur votre site en production. Un brouillon est un espace de travail isolé où vous rédigez, prévisualisez et modifiez du contenu. Vos modifications ne sont disponibles que dans l'éditeur jusqu'à ce que vous choisissiez de les publier. - -Les brouillons sont la méthode recommandée pour apporter des modifications dans l'éditeur. Chaque brouillon dispose d'une branche Git et d'une pull request que l'éditeur gère pour vous, ce qui vous permet de travailler sans changer de branche ni ouvrir de pull requests. - -
- ## Fonctionnement des brouillons -
- -**Chaque modification est enregistrée automatiquement.** Au fur et à mesure que vous tapez, l'éditeur enregistre votre travail sur les serveurs de Mintlify, puis en arrière-plan commite les modifications sur la branche du brouillon. Vos modifications persistent d'un onglet, d'un appareil et d'une interruption réseau à l'autre. - -**Chaque brouillon a son propre historique de versions.** L'éditeur commite les modifications à mesure que vous travaillez, si bien qu'un brouillon accumule un historique de modifications sur sa branche. Il maintient également une pull request ouverte qui reflète l'état actuel du brouillon. - -**Rien n'est mis en ligne tant que vous ne publiez pas.** Un brouillon n'affecte jamais votre site en production pendant que vous le modifiez. C'est vous qui décidez quand ses modifications sont déployées. - -**Conservez plusieurs brouillons en même temps.** Travaillez en parallèle sur plusieurs jeux de modifications, chacun dans son propre brouillon, et publiez-les séparément. - - - Les brouillons sont distincts de la branche de déploiement qui construit votre site en production. Modifier un brouillon ne change jamais votre site en production tant que vous ne publiez pas le brouillon. - - -
- ## Créer un brouillon -
- -1. Cliquez sur le sélecteur de déploiement dans la barre d'outils de l'éditeur. Lorsque vous modifiez votre branche de déploiement, il affiche **Live site**. Lorsque vous modifiez un brouillon, il affiche le nom du brouillon. - - Le sélecteur de déploiement dans la barre d'outils de l'éditeur affichant le site en production. -Le sélecteur de déploiement dans la barre d'outils de l'éditeur affichant le site en production en mode sombre. - -2. Cliquez sur l'onglet **Drafts**. -3. Cliquez sur **New draft**. - -L'éditeur crée le brouillon et bascule vers celui-ci. Les nouveaux brouillons portent au départ le nom "Untitled draft". Renommez vos brouillons avec des noms descriptifs pour pouvoir les identifier plus tard. - -
- ## Passer d'un brouillon à un autre -
- -1. Cliquez sur le sélecteur de déploiement dans la barre d'outils de l'éditeur. -2. Cliquez sur **Live site** pour revenir à votre branche de déploiement, ou cliquez sur un autre brouillon pour y basculer. - -L'onglet **Drafts** liste vos brouillons avec l'heure de dernière mise à jour de chacun, du plus récent au plus ancien. Utilisez le champ de recherche pour filtrer les brouillons par nom. - -
- ## Publier un brouillon -
- -Lorsque votre brouillon est prêt, ouvrez le menu de publication pour passer en revue vos modifications et publier. Les actions disponibles dépendent du fait que votre branche de déploiement exige ou non une révision avant la mise en ligne des modifications. - - - - Cliquez sur **Publish** dans la barre d'outils de l'éditeur. Le menu liste toutes les modifications en attente dans le brouillon. Cliquez sur n'importe quelle modification pour la passer en revue. - - - Si votre branche de déploiement exige une révision, cliquez sur **Request review** pour marquer la pull request du brouillon comme prête à être révisée par votre équipe. Les relecteurs approuvent la pull request depuis l'éditeur ou depuis votre fournisseur Git. - - - Cliquez sur **Publish** pour fusionner le brouillon dans votre branche de déploiement et le déployer. Si votre équipe exige des révisions, **Publish** ne devient disponible qu'après approbation de la pull request. - - Une seule publication à la fois peut avoir lieu par brouillon. Si une publication est déjà en cours, attendez qu'elle se termine avant de republier. - - - -
- ## Renommer un brouillon -
- -1. Cliquez sur le sélecteur de déploiement dans la barre d'outils de l'éditeur. -2. Cliquez sur l'onglet **Drafts**. -3. Survolez le brouillon et cliquez sur l'icône de renommage. -4. Saisissez un nouveau nom et appuyez sur Entrée. - -Renommer un brouillon met également à jour le titre de sa pull request. - -
- ## Supprimer un brouillon -
- -1. Cliquez sur le sélecteur de déploiement dans la barre d'outils de l'éditeur. -2. Cliquez sur l'onglet **Drafts**. -3. Survolez le brouillon et cliquez sur l'icône de suppression. -3. Confirmez la suppression. - - - Supprimer un brouillon élimine définitivement ses modifications non publiées et ferme sa pull request. Vous ne pouvez pas annuler cette action. - - -
- ## Brouillons ou branches -
- -Les brouillons et les branches vous permettent tous deux de travailler sur des modifications de manière isolée avant de les publier. Choisissez en fonction de la façon dont votre équipe travaille : - -- **Utilisez les brouillons** si vous voulez que l'éditeur gère Git à votre place. -- **Utilisez les branches** si vous suivez un flux de travail basé sur Git et souhaitez nommer les branches, gérer directement les pull requests ou vous coordonner avec des modifications effectuées en dehors de l'éditeur. Voir [Branching et publication](/fr/editor/branching-and-publishing). - -Les deux options sont disponibles dans le sélecteur de déploiement, ce qui vous permet de passer d'une approche à l'autre à tout moment. diff --git a/fr/editor/index.mdx b/fr/editor/index.mdx index 38c54f1f00..ceee4d9b26 100644 --- a/fr/editor/index.mdx +++ b/fr/editor/index.mdx @@ -21,7 +21,7 @@ Ouvrez l'éditeur depuis l'onglet [Editor](https://app.mintlify.com/editor) de v -**Les modifications sont enregistrées automatiquement.** Au fur et à mesure que vous tapez, l'éditeur enregistre votre brouillon. Votre travail est conservé entre les onglets, les appareils et les coupures réseau. Les modifications ne sont mises en ligne que lorsque vous les publiez. +**Les modifications sont enregistrées automatiquement.** Au fur et à mesure que vous tapez, l'éditeur enregistre votre travail. Vos modifications sont conservées entre les onglets, les appareils et les coupures réseau. Les modifications ne sont mises en ligne que lorsque vous les publiez. **Git reste synchronisé.** Lorsqu'une autre personne pousse des modifications vers votre référentiel depuis l'extérieur de l'éditeur, ces modifications apparaissent automatiquement dans l'éditeur. Vous n'avez pas besoin de faire un pull ni d'actualiser. L'éditeur fusionne les modifications sans conflit et met en évidence les éléments nécessitant votre attention. @@ -53,10 +53,6 @@ Ouvrez l'éditeur depuis l'onglet [Editor](https://app.mintlify.com/editor) de v - - Travaillez sur vos modifications dans un brouillon isolé qui reste non publié jusqu'à ce que vous demandiez une revue et le publiiez. - - Comment les branches et les règles de protection déterminent ce qui se passe lorsque vous publiez, et comment gérer le processus de revue par pull request. diff --git a/fr/editor/settings.mdx b/fr/editor/settings.mdx index 9987956c85..d02447ada9 100644 --- a/fr/editor/settings.mdx +++ b/fr/editor/settings.mdx @@ -1,7 +1,7 @@ --- title: "Paramètres de l'éditeur pour l'IA et la publication" -description: "Configurez les instructions IA, les valeurs par défaut des pull requests, les brouillons et la méthode de fusion utilisée par l'éditeur web." -keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "draft", "merge", "lock branch"] +description: "Configurez les instructions IA, les valeurs par défaut des pull requests et la méthode de fusion par défaut pour contrôler la façon dont l'éditeur web Mintlify publie les modifications." +keywords: ["editor", "settings", "ai", "instructions", "publishing", "pull request", "merge", "lock branch"] --- L'éditeur web comporte deux niveaux de paramètres : @@ -94,7 +94,7 @@ Votre branche de déploiement reste synchronisée avec Git, donc les push depuis 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 brouillon. +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. diff --git a/fr/editor/suggestions.mdx b/fr/editor/suggestions.mdx index 2e31a4eb8b..4fe880cbbd 100644 --- a/fr/editor/suggestions.mdx +++ b/fr/editor/suggestions.mdx @@ -43,7 +43,7 @@ Les suggestions en attente apparaissent sous forme de texte surligné dans l'éd 1. Cliquez sur le texte de la suggestion surligné. 2. Cliquez sur le bouton **Accept** pour appliquer le changement proposé. -Accepter une suggestion résout et supprime le fil de la suggestion. Le changement accepté fait partie du brouillon actuel et est mis en ligne la prochaine fois que vous [publiez](/fr/editor/branching-and-publishing). +Accepter une suggestion résout et supprime le fil de la suggestion. Le changement accepté fait partie de votre branche actuelle et est mis en ligne la prochaine fois que vous [publiez](/fr/editor/branching-and-publishing).
## Rejeter une suggestion diff --git a/fr/editor/tutorial.mdx b/fr/editor/tutorial.mdx index 419af98a56..e6cac53a70 100644 --- a/fr/editor/tutorial.mdx +++ b/fr/editor/tutorial.mdx @@ -8,9 +8,7 @@ Ce tutoriel vous guide à travers une mise à jour de contenu complète avec l' - Une branche est une copie temporaire de votre contenu. C'est là que vous effectuez vos modifications sans affecter votre site en production. - - Voyez les branches comme des brouillons. Vous pouvez les fusionner dans votre site en production ou les abandonner en toute sécurité si vous choisissez de ne pas appliquer les modifications. + Une branche est une copie temporaire de votre contenu. C'est là que vous effectuez vos modifications sans affecter votre site en production. Vous pouvez fusionner une branche dans votre site en production ou l'abandonner en toute sécurité si vous choisissez de ne pas appliquer les modifications. Travailler sur une branche permet de garder vos modifications séparées de votre site en production jusqu'à ce que vous soyez prêt à partager le contenu avec vos utilisateurs. diff --git a/fr/guides/git-concepts.mdx b/fr/guides/git-concepts.mdx index 20d7647356..7e6890a52c 100644 --- a/fr/guides/git-concepts.mdx +++ b/fr/guides/git-concepts.mdx @@ -140,7 +140,7 @@ L’éditeur web se connecte à votre référentiel Git via la [GitHub App](/fr/ Lorsque vous : * **Ouvrez un fichier** : l’éditeur récupère la dernière version depuis votre référentiel, pour que vous travailliez toujours avec un contenu à jour. -* **Apportez des modifications** : l’éditeur suit vos modifications comme un brouillon, qui pourra devenir un commit lorsque vous serez prêt à enregistrer votre travail. +* **Apportez des modifications** : l’éditeur suit vos modifications et les transforme en un commit lorsque vous enregistrez votre travail. * **Enregistrez les modifications** : l’éditeur crée un commit avec vos modifications, conservant votre travail dans l’historique du projet. * **Créez une branche** : l’éditeur crée une nouvelle branche dans votre référentiel, utilisable par toute personne ayant accès au référentiel afin de collaborer et de passer les changements en revue. * **Publiez sur votre branche de déploiement** : l’éditeur crée un commit et pousse directement vers votre branche de déploiement, ce qui publie immédiatement vos modifications. diff --git a/zh.json b/zh.json index 58ea7d65ec..536e637646 100644 --- a/zh.json +++ b/zh.json @@ -70,7 +70,6 @@ "zh/editor/navigation", "zh/editor/configurations", "zh/editor/live-preview", - "zh/editor/drafts", "zh/editor/collaborate", "zh/editor/comments", "zh/editor/suggestions", diff --git a/zh/changelog.mdx b/zh/changelog.mdx index ad4bf71f96..8e928c34b3 100644 --- a/zh/changelog.mdx +++ b/zh/changelog.mdx @@ -76,7 +76,7 @@ noindex: true ## 编辑器改进
- - **草稿：** 无需创建分支或使用任何 Git 命令，即可处理未发布的更改。有关更多信息，请参阅[草稿](/zh/editor/drafts)。 + - **草稿：** 无需创建分支或使用任何 Git 命令，即可处理未发布的更改。有关更多信息，请参阅[草稿](/zh/editor/branching-and-publishing)。 - **锁定部署分支：** 如果检测到分支保护，编辑器现在会提示您锁定部署分支。 - **更快的[编辑器代理](/zh/editor)与更完善的撤销/重做：** 代理更新现在会即时流式显示，导航速度更快，内容和导航树更改也可以干净地撤销和重做。 - **可折叠标题状态按用户持久化：** 您展开和折叠章节的偏好会在多个编辑器会话之间保留。 diff --git a/zh/editor/drafts.mdx b/zh/editor/drafts.mdx deleted file mode 100644 index 78843690ce..0000000000 --- a/zh/editor/drafts.mdx +++ /dev/null @@ -1,111 +0,0 @@ ---- -title: "草稿" -description: "在编辑器中创建隔离的草稿,在你请求审阅并发布之前,它们始终保持私密,而且你无需自己管理 Git 分支。" -keywords: ["editor", "draft", "publish", "autosave"] ---- - -在将更改发布到生产站点之前,使用草稿在编辑器中进行修改。草稿是一个隔离的工作区,你可以在其中撰写、预览和编辑内容。在你选择发布之前,你的更改仅在编辑器中可见。 - -草稿是在编辑器中进行更改的推荐方式。每个草稿都有一个由编辑器为你管理的 Git 分支和 pull request,让你无需切换分支或打开 pull request 即可开展工作。 - -
- ## 草稿的工作原理 -
- -**每次编辑都会自动保存。** 你在输入时,编辑器会将你的工作保存到 Mintlify 的服务器,然后在后台将更改提交到该草稿的分支。你的更改可以跨标签页、设备和网络中断持续保留。 - -**每个草稿都有自己的版本历史。** 编辑器会在你工作时提交更改,因此草稿会在其分支上累积一份变更历史。它还会保持一个打开的 pull request,反映草稿的当前状态。 - -**只有在你发布时,内容才会上线。** 你在编辑草稿时,它不会影响你的生产站点。何时部署其更改由你决定。 - -**可以同时保留多个草稿。** 并行处理多组更改,每组更改都在自己的草稿中,并可以分别发布。 - - - 草稿与用于构建生产站点的部署分支相互独立。在你发布草稿之前,编辑草稿绝不会更改你的生产站点。 - - -
- ## 创建草稿 -
- -1. 点击编辑器工具栏中的 部署选择器。当你编辑部署分支时,它显示为 **Live site**。当你编辑草稿时,它显示该草稿的名称。 - - 编辑器工具栏中的部署选择器,显示生产站点。 -编辑器工具栏中的部署选择器,在深色模式下显示生产站点。 - -2. 点击 **Drafts** 标签页。 -3. 点击 **New draft**。 - -编辑器会创建草稿并切换到它。新草稿的初始名称为 "Untitled draft"。请为你的草稿起一个描述性的名字,方便你以后识别它们。 - -
- ## 在草稿之间切换 -
- -1. 点击编辑器工具栏中的 部署选择器。 -2. 点击 **Live site** 返回你的部署分支,或点击另一个草稿以切换到它。 - -**Drafts** 标签页按最近更新时间倒序列出你的所有草稿。使用搜索框可按名称筛选草稿。 - -
- ## 发布草稿 -
- -当你的草稿准备就绪时,打开发布菜单以审阅你的更改并发布。可用的操作取决于你的部署分支是否要求在更改上线之前进行审阅。 - - - - 点击编辑器工具栏中的 **Publish**。菜单会列出草稿中的每一处待发布更改。点击任意更改即可对其进行审阅。 - - - 如果你的部署分支需要审阅,请点击 **Request review**,将该草稿的 pull request 标记为可供团队审阅。审阅者可以在编辑器中或在你的 Git 提供商处批准该 pull request。 - - - 点击 **Publish** 将草稿合并到部署分支并进行部署。如果你的团队要求审阅,只有在 pull request 获得批准后,**Publish** 才会变为可用状态。 - - 每个草稿一次只能进行一次发布。如果已经有发布在进行中,请等待其完成后再重新发布。 - - - -
- ## 重命名草稿 -
- -1. 点击编辑器工具栏中的 部署选择器。 -2. 点击 **Drafts** 标签页。 -3. 将鼠标悬停在草稿上,然后点击 重命名图标。 -4. 输入新名称并按 Enter。 - -重命名草稿也会同步更新其 pull request 的标题。 - -
- ## 删除草稿 -
- -1. 点击编辑器工具栏中的 部署选择器。 -2. 点击 **Drafts** 标签页。 -3. 将鼠标悬停在草稿上,然后点击 删除图标。 -3. 确认删除。 - - - 删除草稿会永久丢弃其未发布的更改,并关闭其 pull request。此操作无法撤销。 - - -
- ## 草稿与分支的对比 -
- -草稿和分支都能让你在发布前以隔离方式处理更改。根据你的团队工作方式进行选择: - -- **使用草稿**:如果你希望由编辑器为你管理 Git。 -- **使用分支**:如果你遵循基于 Git 的工作流,并希望自己命名分支、直接管理 pull request,或与在编辑器之外进行的更改保持一致。请参见 [分支和发布](/zh/editor/branching-and-publishing)。 - -这两种方式都可以在部署选择器中使用,你随时可以在两种方式之间切换。 diff --git a/zh/editor/index.mdx b/zh/editor/index.mdx index 064212da9e..309d49cde2 100644 --- a/zh/editor/index.mdx +++ b/zh/editor/index.mdx @@ -21,7 +21,7 @@ keywords: ["editor", "visual", "collaborative", "web editor"] ## 编辑器的工作原理 -**更改自动保存。** 你在输入时，编辑器会自动保存更改。你的工作会在不同标签页、设备以及网络中断后持续保留。 +**更改自动保存。** 你在输入时，编辑器会自动保存你的工作。你的更改会在不同标签页、设备以及网络中断之间保持不变。只有在你发布时更改才会上线。 **Git 持续保持同步。** 当他人从编辑器之外向你的仓库推送更改时，这些更改会自动出现在编辑器中。你无需拉取或刷新。编辑器会自动合并无冲突的更改，并突出显示需要你关注的内容。 @@ -37,10 +37,6 @@ keywords: ["editor", "visual", "collaborative", "web editor"] ## 探索编辑器 - - 在隔离的草稿中处理更改，草稿会保持未发布状态，直到你请求评审并发布。 - - 了解 branch 和保护规则如何决定你在发布时发生的行为，以及如何管理拉取请求审查流程。 diff --git a/zh/editor/settings.mdx b/zh/editor/settings.mdx index 18680adf78..6207c2c822 100644 --- a/zh/editor/settings.mdx +++ b/zh/editor/settings.mdx @@ -1,7 +1,7 @@ --- title: "用于 AI 与发布的编辑器设置" -description: "配置 AI 指令、pull request 默认值、草稿行为以及默认合并方式，以控制 Mintlify Web 编辑器发布变更的方式。" -keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "草稿", "合并", "锁定分支"] +description: "配置 AI 指令、pull request 默认值以及默认合并方式，以控制 Mintlify Web 编辑器发布变更的方式。" +keywords: ["编辑器", "设置", "ai", "指令", "发布", "pull request", "合并", "锁定分支"] --- Web 编辑器有两层设置： @@ -85,7 +85,7 @@ AI 指令是编辑器随你的请求一起发送给 AI 的持续生效指令。 在锁定开启期间，向部署分支推送的 Git 提交会覆盖编辑器的实时状态，因此该分支上任何进行中的编辑都会被最新的提交替换。 -当你的团队希望 Git 继续作为线上站点的唯一可信来源，并让所有编辑器更改都通过从草稿分支发起的 pull request 提交时，可使用此设置。 +当你的团队希望 Git 继续作为线上站点的唯一可信来源，并让所有编辑器更改都通过从功能分支发起的 pull request 提交时，可使用此设置。 在部署分支被锁定时进行编辑，请使用顶栏中的分支选择器创建或切换到草稿分支。像其他编辑器分支一样，从你的草稿分支发起 pull request 即可发布这些更改。 diff --git a/zh/editor/suggestions.mdx b/zh/editor/suggestions.mdx index a3361cfaf6..02c8b3b6c9 100644 --- a/zh/editor/suggestions.mdx +++ b/zh/editor/suggestions.mdx @@ -43,7 +43,7 @@ keywords: ["建议", "提议", "协作", "审阅"] 1. 点击高亮的建议文本。 2. 点击 **Accept** 按钮以应用建议的更改。 -接受建议会解决并删除该建议线程。 已接受的更改会成为当前草稿的一部分，并在你下次[发布](/zh/editor/branching-and-publishing)时上线。 +接受建议会解决并删除该建议线程。 已接受的更改会成为你当前分支的一部分，并在你下次[发布](/zh/editor/branching-and-publishing)时上线。
## 拒绝建议 diff --git a/zh/editor/tutorial.mdx b/zh/editor/tutorial.mdx index b86dfd3f94..d0649823ce 100644 --- a/zh/editor/tutorial.mdx +++ b/zh/editor/tutorial.mdx @@ -8,9 +8,7 @@ keywords: ["编辑器", "教程", "分支", "发布"] - 分支是你内容的临时副本。这是你在不影响线上站点的情况下进行更改的地方。 - - 可以把分支想象成草稿。你可以将它们合并到线上站点，或在选择不进行更改时安全地丢弃它们。 + 分支是你内容的临时副本。这是你在不影响线上站点的情况下进行更改的地方。你可以将分支合并到线上站点，或在选择不进行更改时安全地丢弃它。 在分支上工作可以让你的编辑与线上站点保持隔离，直到你准备好与用户分享内容为止。 diff --git a/zh/guides/git-concepts.mdx b/zh/guides/git-concepts.mdx index ea4547ba65..4366f32b51 100644 --- a/zh/guides/git-concepts.mdx +++ b/zh/guides/git-concepts.mdx @@ -140,7 +140,7 @@ Web 编辑器通过 [GitHub 应用](/zh/deploy/github) 或 [GitLab 集成](/zh/d 当你： * **打开文件**：编辑器会从你的存储库获取最新版本，确保你始终在处理最新内容。 -* **进行更改**：编辑器会将你的更改作为草稿进行跟踪，当你准备保存时可生成一次提交。 +* **进行更改**：编辑器会跟踪你的更改，并在你保存工作时将其转换为一次提交。 * **保存更改**：编辑器会基于你的更改创建一次提交，将你的工作保存在项目历史中。 * **创建 branch**：编辑器会在你的存储库中创建一个新的 branch，任何具有存储库访问权限的人都可以使用它来协作并审阅更改。 * **在你的部署用分支上发布**：编辑器会直接向你的部署用分支提交并推送，从而立即发布你的更改。