diff --git a/docs.json b/docs.json
index 53c39f92f..64c6aa202 100644
--- a/docs.json
+++ b/docs.json
@@ -325,16 +325,7 @@
"fr/index",
"fr/quickstart",
"fr/installation",
- {
- "group": "Éditeur visuel",
- "pages": [
- "fr/editor/getting-started",
- "fr/editor/content-management",
- "fr/editor/publishing",
- "fr/editor/keyboard-shortcuts",
- "fr/editor/troubleshooting"
- ]
- },
+ "fr/editor",
"fr/ai-native",
"fr/migration"
]
@@ -634,16 +625,7 @@
"es/index",
"es/quickstart",
"es/installation",
- {
- "group": "Editor visual",
- "pages": [
- "es/editor/getting-started",
- "es/editor/content-management",
- "es/editor/publishing",
- "es/editor/keyboard-shortcuts",
- "es/editor/troubleshooting"
- ]
- },
+ "es/editor",
"es/ai-native",
"es/migration"
]
@@ -943,16 +925,7 @@
"zh/index",
"zh/quickstart",
"zh/installation",
- {
- "group": "可视化编辑器",
- "pages": [
- "zh/editor/getting-started",
- "zh/editor/content-management",
- "zh/editor/publishing",
- "zh/editor/keyboard-shortcuts",
- "zh/editor/troubleshooting"
- ]
- },
+ "zh/editor",
"zh/ai-native",
"zh/migration"
]
diff --git a/es/editor.mdx b/es/editor.mdx
new file mode 100644
index 000000000..62d7358fc
--- /dev/null
+++ b/es/editor.mdx
@@ -0,0 +1,392 @@
+---
+title: "Editor visual"
+description: "Crea, mantén y publica documentación en tu navegador"
+---
+
+
+
+
+
+Accede al editor visual desde tu [dashboard](https://dashboard.mintlify.com/editor) para gestionar tu documentación directamente en el navegador.
+
+* **Edición WYSIWYG**: Realiza cambios en tu documentación con un editor WYSIWYG (what you see is what you get) que muestra cómo se verá el contenido al publicarse.
+* **Sincronización con Git**: Todos los cambios se sincronizan automáticamente con tu repositorio de Git para mantener el control de versiones.
+* **Colaboración en equipo**: Varias personas pueden trabajar en la documentación simultáneamente.
+* **Integración de componentes**: Agrega llamadas de atención, bloques de código y otros componentes con comandos de barra.
+* **Sin configuración previa**: Comienza a escribir de inmediato desde tu dashboard.
+
+
+ ## Descripción general
+
+
+Así es como normalmente trabajarás en el editor visual:
+
+
+
+ Crea una branch o realiza cambios directamente en tu rama de implementación. Recomendamos crear una branch para que puedas previsualizar tus cambios antes de que se publiquen.
+
+
+
+ Navega a un archivo existente en la barra lateral o crea uno nuevo usando el explorador de archivos.
+
+
+
+ Realiza cambios en el editor visual. Presiona / para abrir el menú de componentes.
+
+
+
+ El modo visual te muestra cómo aparecerán tus cambios en tu sitio en producción. Úsalo para verificar que todo se vea correcto.
+
+
+
+ Si estás trabajando en tu rama de implementación, publica tus cambios directamente desde el editor visual. En otras branch, crearás una solicitud de extracción para revisión antes de publicar.
+
+
+
+
+ ## Modos del editor
+
+
+El editor visual tiene dos modos para adaptarse a distintas preferencias y necesidades de edición: modo visual y Modo Markdown.
+
+Usa el conmutador de modo en la barra de herramientas del editor para cambiar de modo.
+
+
+ 
+
+ 
+
+
+
+ ### Modo visual
+
+
+El modo visual ofrece una experiencia WYSIWYG (what you see is what you get) en la que los cambios que realizas en el editor reflejan cómo se verá tu documentación publicada. Este modo es ideal cuando quieres ver en tiempo real cómo se verán tus cambios.
+
+
+ 
+
+ 
+
+
+
+ ### Modo Markdown
+
+
+Markdown mode proporciona acceso directo al código `MDX` subyacente de tu documentación. Este modo es ideal cuando necesitas un control preciso de las propiedades de los componentes o cuando prefieres escribir con la sintaxis de Markdown.
+
+
+ 
+
+ 
+
+
+
+ ## Gestionar contenido
+
+
+
+ ### Navega por tus archivos
+
+
+Usa el explorador de archivos de la barra lateral para navegar por tus archivos de documentación. Haz clic en cualquier archivo para abrirlo en el editor.
+
+Pulsa Command + P en macOS o Ctrl + P en Windows para buscar archivos por nombre.
+
+
+ ### Crear páginas nuevas
+
+
+Selecciona el icono **Create a new file** en la barra lateral del explorador de archivos.
+
+
+ 
+
+ 
+
+
+Los nombres de archivo se completan automáticamente con la extensión `.mdx`. Para cambiar el tipo de archivo, haz clic en la extensión. Selecciona el tipo de archivo que deseas en el menú desplegable.
+
+
+ 
+
+ 
+
+
+
+ ### Renombrar páginas
+
+
+Para cambiar el nombre de una página, haz clic en el icono del menú kebab del archivo que quieres renombrar. Selecciona **Renombrar** en el menú desplegable.
+
+
+ 
+
+ 
+
+
+
+ ### Eliminar páginas
+
+
+Para eliminar una página, haz clic en el icono del menú de tres puntos del archivo que quieres eliminar. Selecciona **Eliminar** en el menú desplegable.
+
+
+ 
+
+ 
+
+
+
+ ### Organiza tu navegación
+
+
+Edita tu archivo `docs.json` para agregar nuevas páginas y eliminar las páginas borradas de la navegación de tu sitio. Consulta [Navegación](/es/organize/navigation) para obtener más información sobre cómo organizar páginas.
+
+**Ejemplo: Agregar una página de Temas al grupo Profile**
+
+En este ejemplo, creaste una nueva página titulada Temas y quieres agregarla al grupo Profile en tu documentación. Agrega la ruta de la nueva página en el arreglo `pages` del grupo `Profile` en tu archivo `docs.json` para que aparezca en la navegación de tu sitio.
+
+```json title="Adding a Themes page to the Profile group" highlight="18"
+{
+ "navigation": {
+ "groups": [
+ {
+ "group": "Primeros pasos",
+ "pages": [
+ "index",
+ "quickstart",
+ "installation"
+ ]
+ },
+ {
+ "group": "Perfil",
+ "pages": [
+ "settings",
+ "account-types",
+ "dashboard",
+ "themes"
+ ]
+ }
+ ]
+ }
+}
+```
+
+
+ ### Editar contenido
+
+
+Realiza cambios en tus páginas usando el modo visual o el modo Markdown en el editor.
+
+En el modo visual, presiona / para abrir el menú de componentes. Agrega bloques de contenido, avisos, bloques de código y otros componentes para personalizar tu documentación.
+
+
+ 
+
+ 
+
+
+En el modo Markdown, editas directamente el `MDX` de tus páginas. Esto puede ser útil cuando necesitas:
+
+* Establecer propiedades específicas de componentes
+* Trabajar con componentes anidados complejos
+* Copiar y pegar contenido `MDX` de otras fuentes
+
+Consulta [Formatear texto](/es/create/text) y [Formatear código](/es/create/code) para obtener más información sobre cómo escribir con la sintaxis de Markdown.
+
+
+ ## Publica tus cambios
+
+
+La rama en la que trabajas determina cómo el editor publica tus cambios:
+
+* **Rama de implementación**: Al publicar, tu sitio en producción se actualiza de inmediato.
+* **Otras ramas**: Al publicar, se crea una solicitud de extracción para que puedas revisar los cambios antes de implementarlos en producción.
+
+
+ 
+
+ 
+
+
+
+ ### Solicitudes de extracción y revisión de cambios
+
+
+Las solicitudes de extracción te permiten proponer cambios desde tu branch para que otras personas los revisen antes de fusionarlos en tu documentación en producción. Esto ayuda a garantizar que tus cambios sean correctos y le da a tu equipo la oportunidad de colaborar en el contenido.
+
+
+ Incluso si trabajas solo, las solicitudes de extracción son útiles para previsualizar cambios y mantener un historial claro de actualizaciones.
+
+
+
+ #### Crear una solicitud de extracción
+
+
+
+
+ Selecciona **Guardar cambios** para guardar todos los cambios en tu branch.
+
+
+
+ Selecciona **Publish Pull Request** en la barra de herramientas del editor.
+
+
+
+ Escribe un título y una descripción claros que expliquen:
+
+ * Qué cambios hiciste
+ * Por qué los hiciste
+ * Cualquier área específica que necesite revisión
+
+
+
+ Selecciona **Publish Pull Request**. El editor proporcionará un enlace para ver tu solicitud de extracción.
+
+
+ 
+
+ 
+
+
+
+
+
+ #### Revisar solicitudes de extracción
+
+
+Una vez creada tu solicitud de extracción:
+
+1. **Revisar cambios**: Tú y tu equipo pueden revisar la solicitud de extracción en tu proveedor de Git, como GitHub o GitLab.
+2. **Dejar comentarios**: Añade comentarios o solicita cambios.
+3. **Realizar cambios adicionales**: Haz cambios adicionales en el editor visual. Cuando seleccionas Guardar cambios, el editor los envía a tu solicitud de extracción.
+4. **Aprobar**: Aprueba la solicitud de extracción cuando estés satisfecho con los cambios.
+5. **Fusionar**: Fusiona la solicitud de extracción cuando estés listo para implementar tus cambios en producción.
+
+
+ ## Atajos de teclado
+
+
+El editor visual admite todos los atajos de teclado comunes, como copiar, pegar, deshacer y seleccionar todo, y además los siguientes:
+
+| Comando | macOS | Windows |
+|:--------|:------|:--------|
+| **Buscar archivos** | Cmd + P | Control + P |
+| **Agregar enlace al texto seleccionado** | Cmd + K | Control + K |
+| **Insertar salto de línea** | Cmd + Enter | Control + Enter |
+| **Negrita** | Cmd + B | Control + B |
+| **Cursiva** | Cmd + I | Control + I |
+| **Subrayado** | Cmd + U | Control + U |
+| **Tachado** | Cmd + Shift + S | Control + Shift + S |
+| **Código** | Cmd + E | Control + E |
+| **Texto normal** | Cmd + Alt + 0 | Control + Alt + 0 |
+| **Encabezado 1** | Cmd + Alt + 1 | Control + Alt + 1 |
+| **Encabezado 2** | Cmd + Alt + 2 | Control + Alt + 2 |
+| **Encabezado 3** | Cmd + Alt + 3 | Control + Alt + 3 |
+| **Encabezado 4** | Cmd + Alt + 4 | Control + Alt + 4 |
+| **Lista numerada** | Cmd + Shift + 7 | Control + Shift + 7 |
+| **Lista con viñetas** | Cmd + Shift + 8 | Control + Shift + 8 |
+| **Cita** | Cmd + Shift + B | Control + Shift + B |
+| **Subíndice** | Cmd + , | Control + , |
+| **Superíndice** | Cmd + . | Control + . |
+
+
+ ## Solución de problemas
+
+
+Encuentra soluciones a problemas comunes que puedes experimentar al usar el editor visual.
+
+
+
+ **Posibles causas:**
+
+ * La implementación aún está en curso
+ * Problemas de caché del navegador
+ * Errores de compilación o de implementación
+
+ **Soluciones:**
+
+ 1. Revisa el estado de la implementación en tu dashboard.
+ 2. Actualiza forzadamente tu navegador (Ctrl + F5 o Cmd + Shift + R)
+ 3. Borra la caché de tu navegador.
+
+
+
+ **Posibles causas:**
+
+ * Permisos insuficientes en el repositorio de Git
+ * Problemas de Autenticación con tu proveedor de Git
+
+ **Soluciones:**
+
+ 1. Verifica que tengas el acceso correcto al repositorio.
+ 2. Comprueba si tu integración de Git está configurada correctamente.
+ 3. Revisa la documentación de [Permisos del editor](/es/dashboard/permissions).
+
+
+
+ **Posibles causas:**
+
+ * Problemas de conectividad de red
+ * Repositorios de documentación grandes
+
+ **Soluciones:**
+
+ 1. Revisa tu conexión a internet.
+ 2. Actualiza la página.
+ 3. Contacta al soporte si el problema persiste.
+
+
+
+ **Posibles causas:**
+
+ * Sintaxis MDX inválida en los archivos
+ * Archivos faltantes o dañados
+ * Archivos de gran tamaño que provocan tiempos de espera
+
+ **Soluciones:**
+
+ 1. Revisa la sintaxis del archivo para detectar errores de formato MDX.
+ 2. Verifica que el archivo exista en tu repositorio.
+
+
+
+
+ ## Próximos pasos
+
+
+* Aprende los conceptos fundamentales de [Git](/es/guides/git-concepts)
+* Aprende las mejores prácticas para colaborar con [branches](/es/guides/branches)
\ No newline at end of file
diff --git a/fr/editor.mdx b/fr/editor.mdx
new file mode 100644
index 000000000..7427b2a46
--- /dev/null
+++ b/fr/editor.mdx
@@ -0,0 +1,392 @@
+---
+title: "Éditeur visuel"
+description: "Créez, gérez et publiez votre documentation dans votre navigateur"
+---
+
+
+
+
+
+Accédez à l’éditeur visuel depuis votre [Dashboard](https://dashboard.mintlify.com/editor) pour gérer votre documentation directement dans votre navigateur.
+
+* **Édition WYSIWYG (What You See Is What You Get)**: Modifiez votre documentation avec un éditeur visuel qui affiche le rendu final tel qu’il sera publié.
+* **Synchronisation Git**: Toutes les modifications sont automatiquement synchronisées avec votre référentiel Git pour assurer le contrôle de version.
+* **Collaboration d’équipe**: Plusieurs personnes peuvent travailler simultanément sur la documentation.
+* **Intégration de composants**: Ajoutez des encadrés, des code blocks et d’autres composants avec des commandes au slash.
+* **Aucune configuration requise**: Commencez à rédiger immédiatement depuis votre Dashboard.
+
+
+ ## Vue d’ensemble
+
+
+Voici comment vous travaillerez généralement dans l’éditeur visuel :
+
+
+
+ Créez une branche ou apportez des modifications directement à votre branche de déploiement. Nous recommandons de créer une branche afin de pouvoir prévisualiser vos modifications avant leur mise en ligne.
+
+
+
+ Ouvrez un fichier existant dans la barre latérale ou créez-en un nouveau à l’aide de l’explorateur de fichiers.
+
+
+
+ Modifiez votre contenu dans l’éditeur visuel. Appuyez sur / pour ouvrir le menu des composants.
+
+
+
+ Le mode visuel montre comment vos modifications apparaîtront sur votre site en production. Utilisez-le pour vérifier que tout est correct.
+
+
+
+ Si vous travaillez sur votre branche de déploiement, publiez vos modifications directement depuis l’éditeur visuel. Sur les autres branches, créez une pull request (demande de fusion) pour relecture avant publication.
+
+
+
+
+ ## Modes de l’éditeur
+
+
+L’éditeur visuel propose deux modes pour s’adapter à différentes préférences et besoins d’édition : mode visuel et Mode Markdown.
+
+Utilisez le commutateur de mode dans la barre d’outils de l’éditeur pour changer de mode.
+
+
+
+
+
+
+
+
+ ### Mode visuel
+
+
+Le mode visuel offre une expérience WYSIWYG (What You See Is What You Get) où les modifications apportées dans l’éditeur reflètent l’apparence de votre documentation publiée. Ce mode est idéal lorsque vous souhaitez voir en temps réel à quoi ressembleront vos modifications.
+
+
+
+
+
+
+
+
+ ### Mode Markdown
+
+
+Le Mode Markdown donne un accès direct au code `MDX` sous-jacent de votre documentation. Ce mode est idéal lorsque vous avez besoin d’un contrôle précis des propriétés des composants ou lorsque vous préférez écrire en syntaxe Markdown.
+
+
+
+
+
+
+
+
+ ## Gérer l’objet
+
+
+
+ ### Parcourez vos fichiers
+
+
+Utilisez l’explorateur de fichiers de la barre latérale pour parcourir vos fichiers de documentation. Cliquez sur un fichier pour l’ouvrir dans l’éditeur.
+
+Appuyez sur Command + P sur macOS ou Ctrl + P sur Windows pour rechercher des fichiers par nom.
+
+
+ ### Créer de nouvelles pages
+
+
+Sélectionnez l’icône **Create a new file** dans la barre latérale de l’explorateur de fichiers.
+
+
+
+
+
+
+
+Les noms de fichiers sont automatiquement suffixés par l’extension `.mdx`. Pour changer le type de fichier, cliquez sur l’extension. Sélectionnez le type de fichier souhaité dans le menu déroulant.
+
+
+
+
+
+
+
+
+ ### Renommer des pages
+
+
+Pour renommer une page, cliquez sur l’icône du menu kebab du fichier à renommer. Sélectionnez **Renommer** dans le menu déroulant.
+
+
+
+
+
+
+
+
+ ### Supprimer des pages
+
+
+Pour supprimer une page, cliquez sur l’icône de menu à trois points du fichier que vous souhaitez supprimer. Sélectionnez **Supprimer** dans le menu déroulant.
+
+
+
+
+
+
+
+
+ ### Organisez votre navigation
+
+
+Modifiez votre fichier `docs.json` pour ajouter de nouvelles pages et retirer les pages supprimées de la navigation de votre site. Consultez [Navigation](/fr/organize/navigation) pour plus d’informations sur l’organisation des pages.
+
+**Exemple : ajouter une page Themes au groupe Profile**
+
+Dans cet exemple, vous avez créé une nouvelle page intitulée Themes et vous souhaitez l’ajouter au groupe Profile de votre documentation. Ajoutez le chemin de la nouvelle page au tableau `pages` du groupe `Profile` dans votre fichier `docs.json` pour qu’elle apparaisse dans la navigation de votre site.
+
+```json title="Adding a Themes page to the Profile group" highlight="18"
+{
+ "navigation": {
+ "groups": [
+ {
+ "group": "Prise en main",
+ "pages": [
+ "index",
+ "quickstart",
+ "installation"
+ ]
+ },
+ {
+ "group": "Profil",
+ "pages": [
+ "settings",
+ "account-types",
+ "dashboard",
+ "themes"
+ ]
+ }
+ ]
+ }
+}
+```
+
+
+ ### Modifier le contenu
+
+
+Modifiez vos pages en mode visuel ou en Mode Markdown dans l’éditeur.
+
+En mode visuel, appuyez sur / pour ouvrir le menu des composants. Ajoutez des blocs de contenu, des encadrés d’information, des blocs de code et d’autres composants pour personnaliser votre documentation.
+
+
+
+
+
+
+
+En Mode Markdown, vous modifiez directement le `MDX` de vos pages. Cela peut être utile lorsque vous devez :
+
+* Définir des propriétés spécifiques de composants
+* Travailler avec des composants imbriqués complexes
+* Copier-coller du contenu `MDX` depuis d’autres sources
+
+Consultez [Mettre en forme le texte](/fr/create/text) et [Mettre en forme le code](/fr/create/code) pour en savoir plus sur l’écriture avec la syntaxe Markdown.
+
+
+ ## Publier vos modifications
+
+
+La branche sur laquelle vous travaillez détermine la façon dont l’éditeur publie vos modifications :
+
+* **Branche de déploiement** : la publication met immédiatement à jour votre site en ligne.
+* **Autres branches** : la publication crée un pull request (demande de fusion) afin que vous puissiez examiner les modifications avant de les déployer en production.
+
+
+
+
+
+
+
+
+ ### Pull requests et revue des modifications
+
+
+Les pull requests (demandes de fusion) vous permettent de proposer des modifications depuis votre branche afin que d’autres puissent les examiner avant de les fusionner dans votre documentation en production. Cela aide à garantir l’exactitude de vos modifications et offre à votre équipe l’occasion de collaborer sur le contenu.
+
+
+ Même si vous travaillez seul, les pull requests sont utiles pour prévisualiser les modifications et maintenir un historique des mises à jour clair.
+
+
+
+ #### Créer une pull request
+
+
+
+
+ Sélectionnez **Enregistrer les modifications** pour enregistrer toutes les modifications sur votre branche.
+
+
+
+ Sélectionnez **Publier la pull request** dans la barre d’outils de l’éditeur.
+
+
+
+ Rédigez un title et une description clairs expliquant :
+
+ * Les modifications que vous avez apportées
+ * Pourquoi vous les avez apportées
+ * Les éléments spécifiques qui nécessitent une relecture
+
+
+
+ Sélectionnez **Publier la pull request**. L’éditeur fournira un lien pour afficher votre pull request.
+
+
+
+
+
+
+
+
+
+
+ #### Examiner les pull requests
+
+
+Une fois votre pull request créée :
+
+1. **Passer en revue les modifications** : Vous et les membres de votre équipe pouvez examiner votre pull request dans votre fournisseur Git, comme GitHub ou GitLab.
+2. **Laisser des commentaires** : Ajoutez des commentaires ou demandez des changements.
+3. **Apporter des modifications supplémentaires** : Apportez des modifications supplémentaires dans l’éditeur visuel. Lorsque vous enregistrez les modifications, l’éditeur les envoie vers votre pull request.
+4. **Approuver** : Approuvez la pull request lorsque vous êtes satisfait des changements.
+5. **Fusionner** : Fusionnez la pull request lorsque vous êtes prêt à déployer vos changements en production.
+
+
+ ## Raccourcis clavier
+
+
+L’éditeur visuel prend en charge tous les raccourcis clavier courants comme copier, coller, annuler et tout sélectionner, ainsi que les raccourcis suivants :
+
+| Commande | macOS | Windows |
+|:--------|:------|:--------|
+| **Rechercher des fichiers** | Cmd + P | Control + P |
+| **Ajouter un lien au texte sélectionné** | Cmd + K | Control + K |
+| **Insérer un saut de ligne** | Cmd + Enter | Control + Enter |
+| **Gras** | Cmd + B | Control + B |
+| **Italique** | Cmd + I | Control + I |
+| **Souligné** | Cmd + U | Control + U |
+| **Barré** | Cmd + Shift + S | Control + Shift + S |
+| **Code** | Cmd + E | Control + E |
+| **Texte normal** | Cmd + Alt + 0 | Control + Alt + 0 |
+| **Titre 1** | Cmd + Alt + 1 | Control + Alt + 1 |
+| **Titre 2** | Cmd + Alt + 2 | Control + Alt + 2 |
+| **Titre 3** | Cmd + Alt + 3 | Control + Alt + 3 |
+| **Titre 4** | Cmd + Alt + 4 | Control + Alt + 4 |
+| **Liste numérotée** | Cmd + Shift + 7 | Control + Shift + 7 |
+| **Liste à puces** | Cmd + Shift + 8 | Control + Shift + 8 |
+| **Bloc de citation** | Cmd + Shift + B | Control + Shift + B |
+| **Indice** | Cmd + , | Control + , |
+| **Exposant** | Cmd + . | Control + . |
+
+
+ ## Dépannage
+
+
+Trouvez des solutions aux problèmes courants que vous pourriez rencontrer avec l’éditeur visuel.
+
+
+
+ **Causes possibles :**
+
+ * Le déploiement est toujours en cours
+ * Problèmes de cache du navigateur
+ * Erreurs de build ou de déploiement
+
+ **Solutions :**
+
+ 1. Vérifiez l’état du déploiement dans votre Dashboard.
+ 2. Effectuez une actualisation forcée de votre navigateur (Ctrl + F5 ou Cmd + Shift + R)
+ 3. Videz le cache de votre navigateur.
+
+
+
+ **Causes possibles :**
+
+ * Permissions insuffisantes sur le référentiel Git
+ * Problèmes d’authentification avec votre fournisseur Git
+
+ **Solutions :**
+
+ 1. Vérifiez que vous disposez des accès appropriés au référentiel.
+ 2. Assurez-vous que votre intégration Git est correctement configurée.
+ 3. Consultez la documentation [Editor Permissions](/fr/dashboard/permissions).
+
+
+
+ **Causes possibles :**
+
+ * Problèmes de connectivité réseau
+ * Référentiels de documentation volumineux
+
+ **Solutions :**
+
+ 1. Vérifiez votre connexion internet.
+ 2. Actualisez la page.
+ 3. Contactez le support si le problème persiste.
+
+
+
+ **Causes possibles :**
+
+ * Syntaxe MDX invalide dans les fichiers
+ * Fichiers manquants ou corrompus
+ * Fichiers volumineux provoquant des expirations
+
+ **Solutions :**
+
+ 1. Vérifiez la syntaxe du fichier pour détecter d’éventuelles erreurs de formatage MDX.
+ 2. Vérifiez que le fichier existe dans votre référentiel.
+
+
+
+
+ ## Prochaines étapes
+
+
+* Découvrez les concepts fondamentaux de [Git](/fr/guides/git-concepts)
+* Découvrez les meilleures pratiques de collaboration avec des [branches](/fr/guides/branches)
\ No newline at end of file
diff --git a/zh/editor.mdx b/zh/editor.mdx
new file mode 100644
index 000000000..d3692e851
--- /dev/null
+++ b/zh/editor.mdx
@@ -0,0 +1,392 @@
+---
+title: "可视化编辑器"
+description: "在浏览器中创建、维护和发布文档"
+---
+
+
+
+
+
+从你的[控制台](https://dashboard.mintlify.com/editor)打开可视化编辑器，直接在浏览器中管理文档。
+
+* **WYSIWYG（所见即所得）编辑**：使用所见即所得（WYSIWYG）编辑器修改文档，并实时预览发布后的效果。
+* **Git 同步**：所有更改会自动与 Git 存储库同步，确保版本控制。
+* **团队协作**：多人可同时编辑文档。
+* **组件集成**：通过斜杠命令添加提示、代码块和其他组件。
+* **无需配置**：可在控制台立即开始撰写。
+
+
+ ## 概览
+
+
+以下是在可视化编辑器中的常见工作方式：
+
+
+
+ 创建一个 branch，或直接在你的 部署用分支 上进行更改。我们建议先创建一个 branch，这样你可以在更改上线前进行预览。
+
+
+
+ 在侧边栏中定位到现有文件，或通过文件资源管理器创建新文件。
+
+
+
+ 在可视化编辑器中进行修改。按下 / 打开组件菜单。
+
+
+
+ 可视化模式会展示你的更改在上线站点上的呈现效果。用它来核对一切是否正确。
+
+
+
+ 如果你在 部署用分支 上工作，可直接在可视化编辑器中发布更改。在其他 branch 上，你需要创建一个 拉取请求（PR；亦称“合并请求”/Merge Request） 以便在发布前进行评审。
+
+
+
+
+ ## 编辑器模式
+
+
+可视化编辑器提供两种模式，以满足不同的编辑偏好和需求：可视化模式和 Markdown 模式。
+
+使用编辑器工具栏中的模式切换开关在两种模式间切换。
+
+
+
+
+
+
+
+
+ ### 可视化模式
+
+
+可视化模式提供 WYSIWYG（所见即所得）体验，你在编辑器中的更改会如实呈现为已发布文档的最终效果。此模式非常适合需要实时预览更改的场景。
+
+
+
+
+
+
+
+
+ ### Markdown 模式
+
+
+Markdown 模式可让你直接访问文档的底层 `MDX` 代码。当你需要对组件属性进行精细控制，或更倾向于使用 Markdown 语法编写时，此模式非常适合。
+
+
+
+
+
+
+
+
+ ## 管理对象
+
+
+
+ ### 浏览文件
+
+
+使用侧边栏的文件浏览器查看文档文件。单击任意文件即可在编辑器中打开。
+
+在 macOS 上按 Command + P，或在 Windows 上按 Ctrl + P，即可按名称搜索文件。
+
+
+ ### 创建新页面
+
+
+在文件资源管理器侧边栏中，选择 **Create a new file** 图标。
+
+
+
+
+
+
+
+文件名会自动添加 `.mdx` 扩展名。要更改文件类型，点击该扩展名，并在下拉菜单中选择你需要的类型。
+
+
+
+
+
+
+
+
+ ### 重命名页面
+
+
+要重命名页面，点击目标文件的省略号菜单 icon，并在下拉菜单中选择**Rename**。
+
+
+
+
+
+
+
+
+ ### 删除页面
+
+
+要删除页面，点击目标文件的三点菜单 icon，然后在下拉菜单中选择**Delete**。
+
+
+
+
+
+
+
+
+ ### 组织导航
+
+
+编辑 `docs.json` 文件，在站点导航中添加新页面并移除已删除的页面。有关页面组织的更多信息，请参见 [Navigation](/zh/organize/navigation)。
+
+**示例：在 Profile 组中添加 Themes 页面**
+
+在此示例中，你创建了一个名为 Themes 的新页面，并希望将其添加到文档中的 Profile 组。将新页面的路径添加到 `docs.json` 文件中 `Profile` 组的 `pages` 数组，使其出现在站点导航中。
+
+```json title="Adding a Themes page to the Profile group" highlight="18"
+{
+ "navigation": {
+ "groups": [
+ {
+ "group": "开始使用",
+ "pages": [
+ "index",
+ "quickstart",
+ "installation"
+ ]
+ },
+ {
+ "group": "个人资料",
+ "pages": [
+ "settings",
+ "account-types",
+ "dashboard",
+ "themes"
+ ]
+ }
+ ]
+ }
+}
+```
+
+
+ ### 编辑内容
+
+
+在编辑器中使用可视化模式或 Markdown 模式修改页面。
+
+在可视化模式下，按 / 打开组件菜单。添加内容块、信息提示、代码块及其他组件，以自定义文档。
+
+
+
+
+
+
+
+在 Markdown 模式下，你可以直接编辑页面的 `MDX`。在以下情况下会很有帮助：
+
+* 设置特定的组件属性
+* 处理复杂的嵌套组件
+* 从其他来源复制并粘贴 `MDX` 内容
+
+请参阅 [格式化文本](/zh/create/text) 和 [格式化代码](/zh/create/code) 以了解更多 Markdown 语法写作方法。
+
+
+ ## 发布更改
+
+
+你当前所处的 branch 会决定编辑器如何发布你的更改：
+
+* **部署用分支**：发布后会立即更新线上站点。
+* **其他分支**：发布后会创建一个拉取请求（PR；亦称“合并请求”/Merge Request），以便你在部署到生产环境前先审查更改。
+
+
+
+
+
+
+
+
+ ### 拉取请求（PR）与变更审查
+
+
+拉取请求（PR；亦称“合并请求”/Merge Request）允许你从你的 branch 提交变更，便于他人在合并到线上文档前进行审查。这样有助于确保变更准确无误，并让团队有机会就内容进行协作。
+
+
+ 即使你独自作业，拉取请求也有助于预览变更并维护清晰的更新历史。
+
+
+
+ #### 创建拉取请求（PR）
+
+
+
+
+ 选择 **保存更改**，将你在当前 branch 上的所有更改保存。
+
+
+
+ 在编辑器工具栏中选择 **Publish Pull Request**。
+
+
+
+ 撰写清晰的标题和说明，解释：
+
+ * 你做了哪些更改
+ * 你为什么进行这些更改
+ * 哪些部分需要重点审阅
+
+
+
+ 选择 **Publish Pull Request**。编辑器会提供一个链接，供你查看拉取请求（PR）。
+
+
+
+
+
+
+
+
+
+
+ #### 审阅拉取请求（PR）
+
+
+创建拉取请求（PR）后：
+
+1. **审阅更改**：你和团队成员可以在 Git 托管平台（如 GitHub 或 GitLab）中审阅你的拉取请求（PR）。
+2. **留下反馈**：添加评论或请求修改。
+3. **进一步修改**：可在可视化编辑器中继续修改。保存更改时，编辑器会将其推送到你的拉取请求（PR）。
+4. **批准**：当你对更改满意时，批准该拉取请求（PR）。
+5. **合并**：当你准备将更改部署到生产环境时，合并该拉取请求（PR）。
+
+
+ ## 键盘快捷键
+
+
+可视化编辑器支持所有常见的键盘快捷键，如复制、粘贴、撤销和全选，以及以下快捷键：
+
+| 命令 | macOS | Windows |
+|:--------|:------|:--------|
+| **搜索文件** | Cmd + P | Control + P |
+| **为选中文本添加链接** | Cmd + K | Control + K |
+| **插入换行** | Cmd + Enter | Control + Enter |
+| **加粗** | Cmd + B | Control + B |
+| **斜体** | Cmd + I | Control + I |
+| **下划线** | Cmd + U | Control + U |
+| **删除线** | Cmd + Shift + S | Control + Shift + S |
+| **行内代码** | Cmd + E | Control + E |
+| **正文** | Cmd + Alt + 0 | Control + Alt + 0 |
+| **标题 1** | Cmd + Alt + 1 | Control + Alt + 1 |
+| **标题 2** | Cmd + Alt + 2 | Control + Alt + 2 |
+| **标题 3** | Cmd + Alt + 3 | Control + Alt + 3 |
+| **标题 4** | Cmd + Alt + 4 | Control + Alt + 4 |
+| **有序列表** | Cmd + Shift + 7 | Control + Shift + 7 |
+| **无序列表** | Cmd + Shift + 8 | Control + Shift + 8 |
+| **引用** | Cmd + Shift + B | Control + Shift + B |
+| **下标** | Cmd + , | Control + , |
+| **上标** | Cmd + . | Control + . |
+
+
+ ## 疑难解答
+
+
+查找使用可视化编辑器时常见问题的解决方案。
+
+
+
+ **可能原因：**
+
+ * 部署仍在进行
+ * 浏览器缓存导致的显示问题
+ * 构建或部署发生错误
+
+ **解决方案：**
+
+ 1. 在控制台查看部署状态。
+ 2. 强制刷新浏览器（Ctrl + F5 或 Cmd + Shift + R）。
+ 3. 清除浏览器缓存。
+
+
+
+ **可能原因：**
+
+ * 对 Git 存储库权限不足
+ * 与 Git 提供商的认证问题
+
+ **解决方案：**
+
+ 1. 确认你对存储库具有正确的访问权限。
+ 2. 检查你的 Git 集成是否已正确配置。
+ 3. 查看[编辑器权限](/zh/dashboard/permissions)文档。
+
+
+
+ **可能原因：**
+
+ * 网络连接异常
+ * 文档存储库体量较大
+
+ **解决方案：**
+
+ 1. 检查网络连接。
+ 2. 刷新页面。
+ 3. 若问题仍存在，请联系支持。
+
+
+
+ **可能原因：**
+
+ * 文件中存在无效的 MDX 语法
+ * 文件缺失或损坏
+ * 文件过大导致超时
+
+ **解决方案：**
+
+ 1. 检查文件语法是否存在 MDX 格式错误。
+ 2. 确认文件已存在于你的存储库中。
+
+
+
+
+ ## 下一步
+
+
+* 学习基础的 [Git 概念](/zh/guides/git-concepts)
+* 学习使用 [branch](/zh/guides/branches) 协作的最佳实践
\ No newline at end of file