Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 3 additions & 1 deletion docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
]
}
]
Expand Down
4 changes: 3 additions & 1 deletion es.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
]
}
]
Expand Down
38 changes: 38 additions & 0 deletions es/help-center/migrate-docs-from-a-zip-export.mdx
Original file line number Diff line number Diff line change
@@ -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.

<div id="if-the-zip-came-from-document360">
## Si el ZIP proviene de Document360
</div>

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.

<div id="if-the-zip-came-from-readme">
## Si el ZIP proviene de ReadMe
</div>

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.

<div id="if-the-zip-came-from-another-platform">
## Si el ZIP proviene de otra plataforma
</div>

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).

<div id="exporting-your-mintlify-docs-as-a-zip">
## Exportar tu documentación de Mintlify como ZIP
</div>

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).
30 changes: 30 additions & 0 deletions es/help-center/migrate-from-confluence.mdx
Original file line number Diff line number Diff line change
@@ -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).

<div id="migrate-confluence-content-manually">
## Migrar contenido de Confluence manualmente
</div>

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).

<div id="use-confluence-as-context-for-the-mintlify-agent">
## Usar Confluence como contexto para el agente de Mintlify
</div>

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).

<div id="request-a-dedicated-guide">
## Solicitar una guía dedicada
</div>

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).
2 changes: 1 addition & 1 deletion es/migration/manual.mdx
Original file line number Diff line number Diff line change
@@ -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";
Expand Down
4 changes: 3 additions & 1 deletion fr.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
]
}
]
Expand Down
38 changes: 38 additions & 0 deletions fr/help-center/migrate-docs-from-a-zip-export.mdx
Original file line number Diff line number Diff line change
@@ -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.

<div id="if-the-zip-came-from-document360">
## Si le ZIP provient de Document360
</div>

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.

<div id="if-the-zip-came-from-readme">
## Si le ZIP provient de ReadMe
</div>

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.

<div id="if-the-zip-came-from-another-platform">
## Si le ZIP provient d'une autre plateforme
</div>

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).

<div id="exporting-your-mintlify-docs-as-a-zip">
## Exporter votre documentation Mintlify en ZIP
</div>

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).
30 changes: 30 additions & 0 deletions fr/help-center/migrate-from-confluence.mdx
Original file line number Diff line number Diff line change
@@ -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).

<div id="migrate-confluence-content-manually">
## Migrer manuellement le contenu Confluence
</div>

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).

<div id="use-confluence-as-context-for-the-mintlify-agent">
## Utiliser Confluence comme contexte pour l'agent Mintlify
</div>

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).

<div id="request-a-dedicated-guide">
## Demander un guide dédié
</div>

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).
2 changes: 1 addition & 1 deletion fr/migration/manual.mdx
Original file line number Diff line number Diff line change
@@ -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";
Expand Down
30 changes: 30 additions & 0 deletions help-center/migrate-docs-from-a-zip-export.mdx
Original file line number Diff line number Diff line change
@@ -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).
24 changes: 24 additions & 0 deletions help-center/migrate-from-confluence.mdx
Original file line number Diff line number Diff line change
@@ -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

Check warning on line 9 in help-center/migrate-from-confluence.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

help-center/migrate-from-confluence.mdx#L9

'Migrate Confluence content manually' should use sentence-style capitalization.

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).

Check warning on line 20 in help-center/migrate-from-confluence.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

help-center/migrate-from-confluence.mdx#L20

In general, use active voice instead of passive voice ('is created').

Check warning on line 20 in help-center/migrate-from-confluence.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

help-center/migrate-from-confluence.mdx#L20

In general, use active voice instead of passive voice ('is added').

## 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).
2 changes: 1 addition & 1 deletion migration/manual.mdx
Original file line number Diff line number Diff line change
@@ -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";
Expand Down Expand Up @@ -48,7 +48,7 @@
| Translated documentation | Languages |
| Group overview | A group with a `root` page |

Add every page path to `docs.json` unless you intend to hide the page. A [hidden page](/organize/hidden-pages) remains reachable by URL, but it is excluded from site search, sitemaps, search engine indexing, and AI context by default.

Check warning on line 51 in migration/manual.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

migration/manual.mdx#L51

In general, use active voice instead of passive voice ('is excluded').

## Convert your content

Expand Down Expand Up @@ -87,7 +87,7 @@

Copy images, videos, fonts, and downloadable files that you own into your repository. Preserve existing public paths where practical to reduce link changes.

Review the following patterns to identify assets that need to be migrated.

Check warning on line 90 in migration/manual.mdx

View check run for this annotation

Mintlify / Mintlify Validation (mintlify) - vale-spellcheck

migration/manual.mdx#L90

In general, use active voice instead of passive voice ('be migrated').

- Markdown image and link destinations
- HTML `<img>` and `<video>` elements
Expand Down
4 changes: 3 additions & 1 deletion zh.json
Original file line number Diff line number Diff line change
Expand Up @@ -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"
]
}
]
Expand Down
38 changes: 38 additions & 0 deletions zh/help-center/migrate-docs-from-a-zip-export.mdx
Original file line number Diff line number Diff line change
@@ -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 的平台。

<div id="if-the-zip-came-from-document360">
## 如果 ZIP 来自 Document360
</div>

请遵循专门的 [Document360 迁移指南](/zh/migration/document360)。它介绍了如何将每个工作区和语言导出为项目 ZIP,并转换其中的文章、分类、媒体和可复用内容。

<div id="if-the-zip-came-from-readme">
## 如果 ZIP 来自 ReadMe
</div>

请遵循专门的 [ReadMe 迁移指南](/zh/migration/readme)。它涵盖了 ReadMe ZIP 导出的结构,包括指南、配方、自定义页面和 OpenAPI 文件。请注意,ReadMe 的 ZIP 导出通过 URL 引用托管的图片,而不包含图片文件本身,因此需要单独下载这些资源。

<div id="if-the-zip-came-from-another-platform">
## 如果 ZIP 来自其他平台
</div>

使用[手动迁移工作流](/zh/migration/manual):

1. 解压导出文件,并将原始 ZIP 保持不变作为源快照。在副本中进行转换工作。
2. 创建页面清单,记录每个页面的来源、目标路径和迁移状态。
3. 将导出的 Markdown、HTML 或 JSON 内容转换为 MDX 页面。
4. 在 `docs.json` 中重建导航,并检查页面中残留的源平台语法。

如果源站点也可以公开访问,抓取可能比转换导出文件更快。参见[转换单个页面](/zh/migration/index#scrape-individual-pages)。

<div id="exporting-your-mintlify-docs-as-a-zip">
## 将你的 Mintlify 文档导出为 ZIP
</div>

如果你需要相反的方向,即获取已发布 Mintlify 文档的 ZIP 压缩包用于离线查看或私下分发,请使用 `mint export`。参见[离线导出](/zh/deploy/export)。
Loading