diff --git a/docs.json b/docs.json index 1b0f3ed425..583fe8a060 100644 --- a/docs.json +++ b/docs.json @@ -481,7 +481,9 @@ "help-center/preview-deployment-not-created-for-fork-branch", "help-center/branch-missing-from-editor-branch-list", "help-center/style-card-icons-with-custom-css", - "help-center/can-i-rename-my-deployment-or-organization" + "help-center/can-i-rename-my-deployment-or-organization", + "help-center/migrate-docs-from-a-zip-export", + "help-center/migrate-from-confluence" ] } ] diff --git a/es.json b/es.json index a5ee044a99..dbcce63f7c 100644 --- a/es.json +++ b/es.json @@ -459,7 +459,9 @@ "es/help-center/preview-deployment-not-created-for-fork-branch", "es/help-center/branch-missing-from-editor-branch-list", "es/help-center/style-card-icons-with-custom-css", - "es/help-center/can-i-rename-my-deployment-or-organization" + "es/help-center/can-i-rename-my-deployment-or-organization", + "es/help-center/migrate-docs-from-a-zip-export", + "es/help-center/migrate-from-confluence" ] } ] diff --git a/es/help-center/migrate-docs-from-a-zip-export.mdx b/es/help-center/migrate-docs-from-a-zip-export.mdx new file mode 100644 index 0000000000..3a8386b5a0 --- /dev/null +++ b/es/help-center/migrate-docs-from-a-zip-export.mdx @@ -0,0 +1,38 @@ +--- +title: "Migrar documentación a Mintlify desde una exportación ZIP" +description: "Mintlify no tiene carga directa de ZIP. Aprende a convertir una exportación ZIP de Document360, ReadMe u otra plataforma en un proyecto de Mintlify." +keywords: ["importar zip", "exportación zip", "subir zip", "migrar desde zip", "zip de Document360", "zip de ReadMe", "migración de archivo zip"] +--- + +Mintlify no tiene una función directa de "importar ZIP". Mintlify construye tu sitio a partir de archivos en un repositorio de Git, así que migrar desde una exportación ZIP implica convertir los archivos exportados en páginas Markdown o MDX en tu repositorio de documentación. El camino correcto depende de qué plataforma generó el ZIP. + +
+## Si el ZIP proviene de Document360 +
+ +Sigue la [guía de migración de Document360](/es/migration/document360) dedicada. Explica cómo exportar cada espacio de trabajo e idioma como un ZIP del proyecto y convertir los artículos, categorías, medios y contenido reutilizable. + +
+## Si el ZIP proviene de ReadMe +
+ +Sigue la [guía de migración de ReadMe](/es/migration/readme) dedicada. Cubre la estructura de una exportación ZIP de ReadMe, incluidas guías, recetas, páginas personalizadas y archivos de OpenAPI. Ten en cuenta que las exportaciones ZIP de ReadMe referencian las imágenes alojadas por URL en lugar de incluir los archivos de imagen, así que descarga esos recursos por separado. + +
+## Si el ZIP proviene de otra plataforma +
+ +Usa el [flujo de trabajo de migración manual](/es/migration/manual): + +1. Descomprime la exportación y conserva el ZIP original sin cambios como instantánea de origen. Haz el trabajo de conversión en una copia. +2. Crea un inventario de páginas con el origen, la ruta de destino y el estado de migración de cada página. +3. Convierte el contenido exportado en Markdown, HTML o JSON en páginas MDX. +4. Recrea tu navegación en `docs.json` y revisa las páginas en busca de sintaxis residual de la plataforma de origen. + +Si el sitio de origen también está disponible públicamente, hacer scraping puede ser más rápido que convertir los archivos exportados. Consulta [Convertir páginas individuales](/es/migration/index#scrape-individual-pages). + +
+## Exportar tu documentación de Mintlify como ZIP +
+ +Si buscas la dirección opuesta, un archivo ZIP de tu documentación de Mintlify publicada para verla sin conexión o distribuirla de forma privada, usa `mint export`. Consulta [Exportación sin conexión](/es/deploy/export). diff --git a/es/help-center/migrate-from-confluence.mdx b/es/help-center/migrate-from-confluence.mdx new file mode 100644 index 0000000000..bc3db68e97 --- /dev/null +++ b/es/help-center/migrate-from-confluence.mdx @@ -0,0 +1,30 @@ +--- +title: "Migrar de Confluence a Mintlify" +description: "Mintlify no tiene una guía dedicada para Confluence. Usa el flujo de migración manual para convertir contenido exportado en un proyecto de Mintlify." +keywords: ["migración de Confluence", "Confluence a Mintlify", "exportación de Confluence", "migrar wiki", "migración de plataforma no compatible"] +--- + +Mintlify no tiene una guía de migración dedicada y automatizada para Confluence. Aun así, puedes migrar contenido de Confluence exportándolo y siguiendo el [flujo de trabajo de migración manual](/es/migration/manual). + +
+## Migrar contenido de Confluence manualmente +
+ +1. Exporta tu contenido desde Confluence. El flujo manual acepta una exportación nativa en Markdown o HTML, contenido obtenido a través de la API de la plataforma o HTML renderizado del sitio publicado. +2. Conserva la exportación original sin cambios y haz el trabajo de conversión en una copia. +3. Crea un inventario de páginas con el origen, la ruta de destino y el estado de migración de cada página. +4. Convierte el contenido en páginas MDX y recrea tu navegación en `docs.json`. + +Si tu sitio de Confluence es de acceso público, también puedes convertir páginas con el scraper en lugar de trabajar desde una exportación. Consulta [Convertir páginas individuales](/es/migration/index#scrape-individual-pages). + +
+## Usar Confluence como contexto para el agente de Mintlify +
+ +Independientemente de la migración, el agente de Mintlify puede conectarse a Confluence como fuente de contexto. Esto permite que el agente lea páginas de tus espacios de Confluence al redactar o actualizar documentación, y las automatizaciones pueden activarse cuando se crea una página de Confluence o se agrega contenido a un espacio. Consulta [Integraciones para el agente y las automatizaciones](/es/automations/integrations). + +
+## Solicitar una guía dedicada +
+ +Si quieres soporte de migración de Confluence de primera clase, envía una [solicitud de función](https://github.com/orgs/mintlify/discussions/categories/feature-requests). diff --git a/es/migration/manual.mdx b/es/migration/manual.mdx index 63b3d93279..9f67f1d2cf 100644 --- a/es/migration/manual.mdx +++ b/es/migration/manual.mdx @@ -1,7 +1,7 @@ --- title: "Migrar desde otra plataforma" description: "Convierte la documentación de cualquier plataforma en páginas, navegación, componentes, referencias de API, recursos y redirecciones de Mintlify." -keywords: ["migración manual de documentación", "migración de Markdown", "migración de MDX", "docs.json"] +keywords: ["migración manual de documentación", "migración de Markdown", "migración de MDX", "docs.json", "Confluence", "exportación ZIP", "plataforma no compatible"] --- import MigrationLaunchChecklist from "/snippets/es/migration-launch-checklist.mdx"; diff --git a/fr.json b/fr.json index 83788648a5..995b25349c 100644 --- a/fr.json +++ b/fr.json @@ -459,7 +459,9 @@ "fr/help-center/preview-deployment-not-created-for-fork-branch", "fr/help-center/branch-missing-from-editor-branch-list", "fr/help-center/style-card-icons-with-custom-css", - "fr/help-center/can-i-rename-my-deployment-or-organization" + "fr/help-center/can-i-rename-my-deployment-or-organization", + "fr/help-center/migrate-docs-from-a-zip-export", + "fr/help-center/migrate-from-confluence" ] } ] diff --git a/fr/help-center/migrate-docs-from-a-zip-export.mdx b/fr/help-center/migrate-docs-from-a-zip-export.mdx new file mode 100644 index 0000000000..f550933a05 --- /dev/null +++ b/fr/help-center/migrate-docs-from-a-zip-export.mdx @@ -0,0 +1,38 @@ +--- +title: "Migrer la documentation vers Mintlify depuis un export ZIP" +description: "Mintlify n'a pas d'import ZIP direct. Découvrez comment convertir un export ZIP de Document360, ReadMe ou d'une autre plateforme en projet Mintlify." +keywords: ["importer zip", "export zip", "téléverser zip", "migrer depuis zip", "zip Document360", "zip ReadMe", "migration d'archive zip"] +--- + +Mintlify n'a pas de fonctionnalité directe d'« import ZIP ». Mintlify construit votre site à partir des fichiers d'un dépôt Git, donc migrer depuis un export ZIP consiste à convertir les fichiers exportés en pages Markdown ou MDX dans votre dépôt de documentation. Le bon chemin dépend de la plateforme qui a produit le ZIP. + +
+## Si le ZIP provient de Document360 +
+ +Suivez le [guide de migration Document360](/fr/migration/document360) dédié. Il explique comment exporter chaque espace de travail et chaque langue sous forme de ZIP de projet, puis convertir les articles, catégories, médias et contenus réutilisables. + +
+## Si le ZIP provient de ReadMe +
+ +Suivez le [guide de migration ReadMe](/fr/migration/readme) dédié. Il couvre la structure d'un export ZIP ReadMe, y compris les guides, recettes, pages personnalisées et fichiers OpenAPI. Notez que les exports ZIP de ReadMe référencent les images hébergées par URL au lieu d'inclure les fichiers d'images, donc téléchargez ces ressources séparément. + +
+## Si le ZIP provient d'une autre plateforme +
+ +Utilisez le [flux de migration manuelle](/fr/migration/manual) : + +1. Décompressez l'export et conservez le ZIP d'origine inchangé comme instantané source. Effectuez le travail de conversion dans une copie. +2. Créez un inventaire des pages avec la source, le chemin de destination et le statut de migration de chaque page. +3. Convertissez le contenu exporté en Markdown, HTML ou JSON en pages MDX. +4. Recréez votre navigation dans `docs.json` et vérifiez les pages pour repérer la syntaxe résiduelle de la plateforme source. + +Si le site source est aussi accessible publiquement, le scraping peut être plus rapide que la conversion des fichiers exportés. Consultez [Convertir des pages individuelles](/fr/migration/index#scrape-individual-pages). + +
+## Exporter votre documentation Mintlify en ZIP +
+ +Si vous cherchez la direction inverse, une archive ZIP de votre documentation Mintlify publiée pour une consultation hors ligne ou une diffusion privée, utilisez `mint export`. Consultez [Export hors ligne](/fr/deploy/export). diff --git a/fr/help-center/migrate-from-confluence.mdx b/fr/help-center/migrate-from-confluence.mdx new file mode 100644 index 0000000000..53768bafb1 --- /dev/null +++ b/fr/help-center/migrate-from-confluence.mdx @@ -0,0 +1,30 @@ +--- +title: "Migrer de Confluence vers Mintlify" +description: "Mintlify n'a pas de guide dédié pour Confluence. Utilisez le flux de migration manuelle pour convertir le contenu exporté en projet Mintlify." +keywords: ["migration Confluence", "Confluence vers Mintlify", "export Confluence", "migrer un wiki", "migration de plateforme non prise en charge"] +--- + +Mintlify n'a pas de guide de migration dédié et automatisé pour Confluence. Vous pouvez néanmoins migrer du contenu Confluence en l'exportant et en suivant le [flux de migration manuelle](/fr/migration/manual). + +
+## Migrer manuellement le contenu Confluence +
+ +1. Exportez votre contenu depuis Confluence. Le flux manuel accepte un export natif Markdown ou HTML, du contenu récupéré via l'API de la plateforme ou du HTML rendu du site publié. +2. Conservez l'export d'origine inchangé et effectuez le travail de conversion dans une copie. +3. Créez un inventaire des pages avec la source, le chemin de destination et le statut de migration de chaque page. +4. Convertissez le contenu en pages MDX et recréez votre navigation dans `docs.json`. + +Si votre site Confluence est accessible publiquement, vous pouvez aussi convertir des pages avec le scraper au lieu de partir d'un export. Consultez [Convertir des pages individuelles](/fr/migration/index#scrape-individual-pages). + +
+## Utiliser Confluence comme contexte pour l'agent Mintlify +
+ +Indépendamment de la migration, l'agent Mintlify peut se connecter à Confluence comme source de contexte. L'agent peut ainsi lire les pages de vos espaces Confluence lors de la rédaction ou de la mise à jour de la documentation, et les automatisations peuvent se déclencher lorsqu'une page Confluence est créée ou que du contenu est ajouté à un espace. Consultez [Intégrations pour l'agent et les automatisations](/fr/automations/integrations). + +
+## Demander un guide dédié +
+ +Si vous souhaitez une prise en charge de premier ordre de la migration Confluence, soumettez une [demande de fonctionnalité](https://github.com/orgs/mintlify/discussions/categories/feature-requests). diff --git a/fr/migration/manual.mdx b/fr/migration/manual.mdx index e940523735..0b0e089517 100644 --- a/fr/migration/manual.mdx +++ b/fr/migration/manual.mdx @@ -1,7 +1,7 @@ --- title: "Migrer depuis une autre plateforme" description: "Convertissez la documentation de toute plateforme vers les pages, la navigation, les composants, les références API, les ressources et les redirections de Mintlify." -keywords: ["migration manuelle de documentation", "migration Markdown", "migration MDX", "docs.json"] +keywords: ["migration manuelle de documentation", "migration Markdown", "migration MDX", "docs.json", "Confluence", "export ZIP", "plateforme non prise en charge"] --- import MigrationLaunchChecklist from "/snippets/fr/migration-launch-checklist.mdx"; diff --git a/help-center/migrate-docs-from-a-zip-export.mdx b/help-center/migrate-docs-from-a-zip-export.mdx new file mode 100644 index 0000000000..6e189eaaad --- /dev/null +++ b/help-center/migrate-docs-from-a-zip-export.mdx @@ -0,0 +1,30 @@ +--- +title: "Migrate docs into Mintlify from a ZIP export" +description: "Mintlify has no direct ZIP upload. Learn how to convert a ZIP export from Document360, ReadMe, or another platform into a Mintlify project." +keywords: ["import zip", "zip export", "upload zip", "migrate from zip", "Document360 zip", "ReadMe zip", "zip archive migration"] +--- + +Mintlify does not have a direct "import ZIP" feature. Mintlify builds your site from files in a Git repository, so migrating from a ZIP export means converting the exported files into Markdown or MDX pages in your docs repo. The right path depends on which platform produced the ZIP. + +## If the ZIP came from Document360 + +Follow the dedicated [Document360 migration guide](/migration/document360). It walks through exporting each workspace and language as a project ZIP and converting the articles, categories, media, and reusable content. + +## If the ZIP came from ReadMe + +Follow the dedicated [ReadMe migration guide](/migration/readme). It covers the structure of a ReadMe ZIP export, including guides, recipes, custom pages, and OpenAPI files. Note that ReadMe ZIP exports reference hosted images by URL instead of including the image files, so download those assets separately. + +## If the ZIP came from another platform + +Use the [manual migration workflow](/migration/manual): + +1. Unzip the export and keep the original ZIP unchanged as a source snapshot. Do conversion work in a copy. +2. Create an inventory of pages with each page's source, destination path, and migration status. +3. Convert the exported Markdown, HTML, or JSON content into MDX pages. +4. Recreate your navigation in `docs.json` and review pages for leftover source-platform syntax. + +If the source site is also publicly available, scraping it can be faster than converting exported files. See [Scrape individual pages](/migration/index#scrape-individual-pages). + +## Exporting your Mintlify docs as a ZIP + +If you want the opposite direction, a ZIP archive of your published Mintlify docs for offline viewing or private distribution, use `mint export`. See [Offline export](/deploy/export). diff --git a/help-center/migrate-from-confluence.mdx b/help-center/migrate-from-confluence.mdx new file mode 100644 index 0000000000..eaa21108f9 --- /dev/null +++ b/help-center/migrate-from-confluence.mdx @@ -0,0 +1,24 @@ +--- +title: "Migrate from Confluence to Mintlify" +description: "Mintlify has no dedicated Confluence migration guide. Use the manual migration workflow to convert exported Confluence content into a Mintlify project." +keywords: ["Confluence migration", "Confluence to Mintlify", "Confluence export", "migrate wiki", "unsupported platform migration"] +--- + +Mintlify does not have a dedicated, automated migration guide for Confluence. You can still migrate Confluence content by exporting it and following the [manual migration workflow](/migration/manual). + +## Migrate Confluence content manually + +1. Export your content from Confluence. The manual workflow accepts a native Markdown or HTML export, content retrieved through the platform's API, or rendered HTML from the published site. +2. Keep the original export unchanged and do conversion work in a copy. +3. Create an inventory of pages with each page's source, destination path, and migration status. +4. Convert the content into MDX pages and recreate your navigation in `docs.json`. + +If your Confluence site is publicly accessible, you can also convert pages with the scraper instead of working from an export. See [Scrape individual pages](/migration/index#scrape-individual-pages). + +## Use Confluence as context for the Mintlify agent + +Separately from migration, the Mintlify agent can connect to Confluence as a context source. This lets the agent read pages in your Confluence spaces when drafting or updating docs, and automations can trigger when a Confluence page is created or content is added to a space. See [Integrations for the agent and automations](/automations/integrations). + +## Request a dedicated guide + +If you want first-class Confluence migration support, submit a [feature request](https://github.com/orgs/mintlify/discussions/categories/feature-requests). diff --git a/migration/manual.mdx b/migration/manual.mdx index 72396584b9..5c7c5aadde 100644 --- a/migration/manual.mdx +++ b/migration/manual.mdx @@ -1,7 +1,7 @@ --- title: "Migrate from another platform" description: "Convert documentation from any source platform to Mintlify pages, navigation, components, API references, assets, and redirects." -keywords: ["manual documentation migration", "Markdown migration", "MDX migration", "docs.json"] +keywords: ["manual documentation migration", "Markdown migration", "MDX migration", "docs.json", "Confluence", "ZIP export", "unsupported platform"] --- import MigrationLaunchChecklist from "/snippets/migration-launch-checklist.mdx"; diff --git a/zh.json b/zh.json index 162465a0de..3069023825 100644 --- a/zh.json +++ b/zh.json @@ -459,7 +459,9 @@ "zh/help-center/preview-deployment-not-created-for-fork-branch", "zh/help-center/branch-missing-from-editor-branch-list", "zh/help-center/style-card-icons-with-custom-css", - "zh/help-center/can-i-rename-my-deployment-or-organization" + "zh/help-center/can-i-rename-my-deployment-or-organization", + "zh/help-center/migrate-docs-from-a-zip-export", + "zh/help-center/migrate-from-confluence" ] } ] diff --git a/zh/help-center/migrate-docs-from-a-zip-export.mdx b/zh/help-center/migrate-docs-from-a-zip-export.mdx new file mode 100644 index 0000000000..4fe7b95ba8 --- /dev/null +++ b/zh/help-center/migrate-docs-from-a-zip-export.mdx @@ -0,0 +1,38 @@ +--- +title: "从 ZIP 导出迁移文档到 Mintlify" +description: "Mintlify 不支持直接上传 ZIP。了解如何将 Document360、ReadMe 或其他平台的 ZIP 导出转换为 Mintlify 项目。" +keywords: ["导入 zip", "zip 导出", "上传 zip", "从 zip 迁移", "Document360 zip", "ReadMe zip", "zip 压缩包迁移"] +--- + +Mintlify 没有直接的"导入 ZIP"功能。Mintlify 基于 Git 仓库中的文件构建你的站点,因此从 ZIP 导出迁移意味着把导出的文件转换为文档仓库中的 Markdown 或 MDX 页面。正确的路径取决于生成该 ZIP 的平台。 + +
+## 如果 ZIP 来自 Document360 +
+ +请遵循专门的 [Document360 迁移指南](/zh/migration/document360)。它介绍了如何将每个工作区和语言导出为项目 ZIP,并转换其中的文章、分类、媒体和可复用内容。 + +
+## 如果 ZIP 来自 ReadMe +
+ +请遵循专门的 [ReadMe 迁移指南](/zh/migration/readme)。它涵盖了 ReadMe ZIP 导出的结构,包括指南、配方、自定义页面和 OpenAPI 文件。请注意,ReadMe 的 ZIP 导出通过 URL 引用托管的图片,而不包含图片文件本身,因此需要单独下载这些资源。 + +
+## 如果 ZIP 来自其他平台 +
+ +使用[手动迁移工作流](/zh/migration/manual): + +1. 解压导出文件,并将原始 ZIP 保持不变作为源快照。在副本中进行转换工作。 +2. 创建页面清单,记录每个页面的来源、目标路径和迁移状态。 +3. 将导出的 Markdown、HTML 或 JSON 内容转换为 MDX 页面。 +4. 在 `docs.json` 中重建导航,并检查页面中残留的源平台语法。 + +如果源站点也可以公开访问,抓取可能比转换导出文件更快。参见[转换单个页面](/zh/migration/index#scrape-individual-pages)。 + +
+## 将你的 Mintlify 文档导出为 ZIP +
+ +如果你需要相反的方向,即获取已发布 Mintlify 文档的 ZIP 压缩包用于离线查看或私下分发,请使用 `mint export`。参见[离线导出](/zh/deploy/export)。 diff --git a/zh/help-center/migrate-from-confluence.mdx b/zh/help-center/migrate-from-confluence.mdx new file mode 100644 index 0000000000..515353aa9d --- /dev/null +++ b/zh/help-center/migrate-from-confluence.mdx @@ -0,0 +1,30 @@ +--- +title: "从 Confluence 迁移到 Mintlify" +description: "Mintlify 没有专门的 Confluence 迁移指南。使用手动迁移工作流将导出的 Confluence 内容转换为 Mintlify 项目。" +keywords: ["Confluence 迁移", "Confluence 到 Mintlify", "Confluence 导出", "迁移 wiki", "不支持平台的迁移"] +--- + +Mintlify 没有针对 Confluence 的专门自动化迁移指南。你仍然可以通过导出内容并遵循[手动迁移工作流](/zh/migration/manual)来迁移 Confluence 内容。 + +
+## 手动迁移 Confluence 内容 +
+ +1. 从 Confluence 导出你的内容。手动工作流接受原生 Markdown 或 HTML 导出、通过平台 API 获取的内容,或已发布站点的渲染 HTML。 +2. 保持原始导出不变,在副本中进行转换工作。 +3. 创建页面清单,记录每个页面的来源、目标路径和迁移状态。 +4. 将内容转换为 MDX 页面,并在 `docs.json` 中重建导航。 + +如果你的 Confluence 站点可以公开访问,也可以使用抓取工具转换页面,而不必从导出文件开始。参见[转换单个页面](/zh/migration/index#scrape-individual-pages)。 + +
+## 将 Confluence 用作 Mintlify agent 的上下文 +
+ +与迁移无关,Mintlify agent 可以连接 Confluence 作为上下文来源。这样 agent 在起草或更新文档时可以读取你 Confluence 空间中的页面,自动化也可以在创建 Confluence 页面或向空间添加内容时触发。参见 [agent 和自动化的集成](/zh/automations/integrations)。 + +
+## 申请专门的指南 +
+ +如果你希望获得一流的 Confluence 迁移支持,请提交[功能请求](https://github.com/orgs/mintlify/discussions/categories/feature-requests)。 diff --git a/zh/migration/manual.mdx b/zh/migration/manual.mdx index 0b8c71a528..ee21be7ec8 100644 --- a/zh/migration/manual.mdx +++ b/zh/migration/manual.mdx @@ -1,7 +1,7 @@ --- title: "从其他平台迁移" description: "将文档从任意平台转换为 Mintlify 的页面、导航、组件、API 参考、资源和重定向。" -keywords: ["手动文档迁移", "Markdown 迁移", "MDX 迁移", "docs.json"] +keywords: ["手动文档迁移", "Markdown 迁移", "MDX 迁移", "docs.json", "Confluence", "ZIP 导出", "不支持的平台"] --- import MigrationLaunchChecklist from "/snippets/zh/migration-launch-checklist.mdx";