> ## Documentation Index
> Fetch the complete documentation index at: https://www.mintlify.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Migrer depuis Document360

> Migrez les espaces de travail, langues, articles, catégories, médias, contenu réutilisable et références API de Document360 vers Mintlify.

Exportez un projet Document360 au format ZIP, puis convertissez ses espaces de travail, langues, catégories et articles en un projet Mintlify. Utilisez l'API Document360 et le site publié pour auditer le contenu que l'export ne représente peut-être pas complètement.

<Note>
  Le scraper Mintlify ne prend pas actuellement en charge Document360.
</Note>

<div id="create-a-migration-snapshot">
  ## Créer un instantané de migration
</div>

Avant d'exporter, créez une sauvegarde manuelle nommée dans Document360. Accédez à **Settings > Knowledge base portal > Backup & Restore**. Téléchargez un export de projet pour la migration elle-même.

Dans Document360, accédez à **Content tools > Import and export > Import and export project**.

<Note>
  Exportez chaque espace de travail et chaque langue de manière délibérée. Un export monolingue peut contenir du Markdown pour les articles créés dans l'éditeur Markdown et du HTML pour les articles WYSIWYG. Un export multilingue utilise JSON quel que soit le type d'éditeur.
</Note>

1. Cliquez sur **Export project**.
2. Sélectionnez le format d'export. Choisissez **JSON** pour un export de projet complet.
3. Dans **Include new or modified articles in**, sélectionnez **All** afin que l'export ne soit pas limité aux articles récemment modifiés.
4. Sélectionnez chaque espace de travail, langue, catégorie et sous-catégorie maintenu.
5. Sélectionnez **Include media files**.
6. Cliquez sur **Export**. L'export s'exécute en arrière-plan et vous informe lorsqu'il est prêt.
7. Téléchargez le ZIP depuis **Recent files** dès qu'il est prêt. Chaque nouvel export écrase le ZIP précédent.
8. Exportez la liste **All articles** au format CSV. Cette liste de métadonnées est utile pour rapprocher les titres, le statut de publication, les dates, les catégories et les URL.

<Tip>
  Conservez le ZIP exporté et le CSV inchangés comme instantanés sources. Faites des copies pour tout travail de conversion effectué pendant la migration.
</Tip>

<div id="inventory-content-outside-the-export">
  ## Inventorier le contenu en dehors de l'export
</div>

Notez les fonctionnalités du projet qui nécessitent un travail de migration séparé.

* Contenu et navigation du Homepage Builder
* Pages personnalisées liées depuis l'en-tête, le pied de page ou la barre latérale
* Snippets, variables, termes de glossaire et modèles
* CSS, JavaScript et intégrations personnalisés
* Groupes de lecteurs, rôles, SSO et règles de contenu privé
* Règles de redirection et domaines personnalisés
* Configuration de l'analytique, des retours, des formulaires et de la recherche
* Spécifications sources de référence API
* Fichiers Drive, arbres de décision et contenu intégré

Utilisez le sitemap publié et l'API Customer de Document360 pour comparer l'export au contenu public et privé. L'API est particulièrement utile lorsque vous devez parcourir les métadonnées de catégorie ou récupérer des champs difficiles à dériver des fichiers exportés.

<div id="recreate-navigation">
  ## Recréer la navigation
</div>

Mappez la hiérarchie Document360 à `docs.json`.

| Document360                             | Mintlify                                                                                                                                                                 |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Espace de travail                       | [Version](/docs/fr/organize/navigation#versions), [produit](/docs/fr/organize/navigation#products), [onglet](/docs/fr/organize/navigation#tabs) ou arborescence de navigation distincte |
| Langue                                  | [Élément de navigation par langue](/docs/fr/organize/navigation#languages)                                                                                                    |
| Catégorie de type dossier               | Groupe de navigation                                                                                                                                                     |
| Catégorie d'index ou de page            | Groupe avec une page `root`                                                                                                                                              |
| Article ou sous-article                 | Page ou groupe imbriqué                                                                                                                                                  |
| Page personnalisée                      | Page MDX standard ou mise en page personnalisée                                                                                                                          |
| Navigation d'en-tête et de pied de page | Liens de barre de navigation, ancrages, menus ou liens de pied de page                                                                                                   |

Choisissez le mappage des espaces de travail en fonction de la manière dont vos lecteurs les utilisent. Un espace de travail nommé `v1` est généralement une version, tandis que des bases de connaissances de produits distinctes peuvent mieux correspondre à des produits ou à des onglets. Voir [Navigation](/docs/fr/organize/navigation) pour plus d'informations sur les éléments de navigation Mintlify.

Les réponses de l'API de catégorie Document360 n'incluent que les enfants directs. Si vous utilisez l'API pour créer un inventaire, demandez chaque catégorie enfant de manière récursive et récupérez le contenu séparément pour les catégories d'index et de page.

<div id="convert-article-content">
  ## Convertir le contenu des articles
</div>

Copiez les articles Markdown dans des fichiers `.mdx` et convertissez le HTML ou JSON exporté en MDX. Ajoutez un frontmatter contenant au moins un `title`, et conservez les descriptions, mots-clés, métadonnées de publication et routes canoniques lorsque cela est utile.

Passez en revue la sortie spécifique à la plateforme de chaque éditeur :

| Contenu Document360                     | Traitement Mintlify                                                                                    |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------ |
| Callouts info, warning et error         | Convertir en [callouts Mintlify](/docs/fr/components/callouts).                                             |
| Onglets et accordéons                   | Convertir en [`Tabs`](/docs/fr/components/tabs) ou [`AccordionGroup`](/docs/fr/components/accordions).           |
| Guides étape par étape                  | Convertir en [`Steps`](/docs/fr/components/steps).                                                          |
| Onglets de code                         | Convertir en [`CodeGroup`](/docs/fr/components/code-groups).                                                |
| Notes privées                           | Supprimez-les ou déplacez les instructions internes hors de la documentation publique.                 |
| Modèles d'article                       | Convertir la structure répétée en fichiers de démarrage ou en snippets réutilisables.                  |
| Formulaires, vidéos et widgets intégrés | Remplacer par des embeds pris en charge, des liens ou des composants personnalisés.                    |
| Arbres de décision                      | Reconstruire sous forme de guides, de liens de branchement ou d'une expérience interactive appropriée. |

Document360 et Mintlify affichent tous deux le `title` du frontmatter comme H1 de la page, donc les corps de page commencent au H2. N'ajoutez pas de H1 en double pendant la conversion.

<div id="convert-reusable-content">
  ## Convertir le contenu réutilisable
</div>

Inventoriez les variables, snippets, termes de glossaire et chaque utilisation avant de les remplacer.

* Convertissez les blocs de contenu réutilisables en [snippets Mintlify](/docs/fr/create/reusable-snippets).
* Remplacez les variables par du texte explicite, du contenu généré ou une autre source de vérité maintenable.
* Remplacez les infobulles de glossaire par des liens ou des composants d'infobulle pris en charge.
* Préservez les variations spécifiques à chaque langue plutôt que de consolider un texte qui ne semble identique que dans une seule locale.

Vérifiez le site source rendu ainsi que l'export pour déterminer si chaque élément réutilisable apparaît sous forme de contenu développé ou de référence spécifique à la plateforme.

<div id="migrate-api-references">
  ## Migrer les références API
</div>

Téléchargez le fichier OpenAPI original de chaque catégorie de référence API Document360 ou récupérez-le depuis le système qui synchronise la spécification.

1. Ajoutez la spécification originale au référentiel Mintlify.
2. Configurez des [pages générées par OpenAPI](/docs/fr/api-playground/openapi-setup).
3. Préservez les descriptions ou exemples d'endpoints personnalisés que les éditeurs ont ajoutés après l'import.
4. Comparez la hiérarchie des tags, l'ordre des endpoints, les serveurs, l'authentification, les exemples et les échantillons de code.
5. Remplacez toute automatisation de resynchronisation Document360 par le workflow de déploiement Mintlify.

Ne convertissez pas les articles d'endpoints générés lorsque la spécification source est disponible.

<div id="migrate-media-and-files">
  ## Migrer les médias et les fichiers
</div>

Incluez les médias dans l'export du projet et copiez les fichiers dont vous êtes propriétaire dans votre référentiel de projet Mintlify. Vérifiez les liens Document360 Drive, les vignettes, les SVG, les fichiers téléchargeables, les images d'arrière-plan CSS et le contenu intégré depuis des services externes.

Mettez à jour les chemins de ressources après avoir réorganisé les pages. Ne laissez pas de ressources de production requises sur les domaines Document360, sauf si vous comptez maintenir cet hébergement actif.

<div id="preserve-urls-and-access-rules">
  ## Préserver les URL et les règles d'accès
</div>

Les routes Document360 peuvent inclure des slugs d'espace de travail et de langue, ainsi que des slugs de catégorie et d'article. Construisez une carte d'URL à partir du sitemap publié et du CSV d'articles exporté, puis ajoutez des [redirections](/docs/fr/create/redirects) pour chaque route modifiée.

Recréez la documentation privée avec l'[authentification et le contrôle d'accès](/docs/fr/deploy/authentication-setup). Créez des groupes de lecteurs et des restrictions basées sur les rôles qui reflètent votre configuration de contrôle d'accès précédente. Testez en tant que chaque groupe avant de publier votre site.

<div id="review-your-migration">
  ## Vérifier votre migration
</div>

Vérifiez que votre ZIP exporté, votre CSV d'articles, votre inventaire d'API et votre sitemap publié sont alignés, puis testez le changement de langue et chaque sélecteur d'espace de travail.

Recherchez dans vos fichiers convertis tout contenu Document360 non converti : HTML brut, références de snippets et de variables, notes privées et embeds de widgets.

## Lancez votre nouveau site

* Instaurez un gel de contenu sur votre ancien site et suivez chaque modification qui y est apportée après votre instantané de migration.
* Confirmez votre branche de production et votre référentiel sur la page [Paramètres Git](https://app.mintlify.com/settings/deployment/git-settings) de votre tableau de bord.
* Notez vos enregistrements DNS existants et gardez votre ancien site en ligne jusqu'à ce que vous ayez vérifié que votre déploiement Mintlify est actif.
* Vérifiez la barre de navigation, le pied de page, le favicon, le logo, les couleurs et la typographie.
* Vérifiez les métadonnées du site et des pages, les URL canoniques et les préférences d'indexation. Voir [Paramètres SEO et de recherche](/docs/fr/organize/settings-seo).
* Installez toutes les [intégrations d'analytique](/docs/fr/integrations/analytics/overview) requises, et ajoutez éventuellement une [page 404 personnalisée](/docs/fr/customize/custom-404-page).
* Si vous avez migré une référence API, comparez les pages d'endpoints, la structure de navigation, les URL de serveur, les schémas d'authentification et les exemples avec votre ancien site.
* Prévisualisez votre commit de lancement exact dans un [déploiement de prévisualisation](/docs/fr/deploy/preview-deployments). Vérifiez les mises en page desktop et mobile, les pages de chaque section de navigation, la recherche et vos redirections.
* Vérifiez la console du navigateur et l'onglet réseau pour détecter d'éventuelles erreurs sur les pages qui utilisent des composants ou des scripts personnalisés.
* Basculez votre domaine avec le [guide sur les domaines personnalisés](/docs/fr/customize/custom-domain), qui couvre la bascule sans interruption pour un domaine qui sert déjà de la documentation.
* Après le lancement, surveillez les erreurs 404, les échecs de redirection et les échecs de build.

<div id="document360-references">
  ## Références Document360
</div>

* [Exporter un ZIP de projet](https://docs.document360.com/help/docs/exporting-your-document360-project-as-a-zip-file-json)
* [Exporter tous les articles](https://docs.document360.com/help/docs/export-bulk-operations)
* [Sauvegarde et restauration](https://docs.document360.com/help/docs/backup-restore)
* [Espaces de travail et langues](https://docs.document360.com/docs/workspaces-languages)
* [Éditeur Markdown](https://docs.document360.com/docs/markdown-editor)
* [Snippets](https://docs.document360.com/help/docs/snippets)
* [Gérer les références API](https://docs.document360.com/docs/manage-api-references)
* [API de catégorie](https://apidocs.document360.com/v2-api/apidocs/get-category)
* [Pages personnalisées](https://docs.document360.com/docs/custom-pages)


## Related topics

- [Migrer depuis Docusaurus](/docs/fr/migration/docusaurus.md)
- [Migrer depuis Fern](/docs/fr/migration/fern.md)
- [Migrer depuis une autre plateforme](/docs/fr/migration/manual.md)