Aller au contenu
⌘K

Ardo vs Nimbus

Comparez les méthodes de documentation React et Astro, la propriété de l’interface, les références API, les services pour agents et les migrations.

Voir en Markdown
Sur cette page

Ardo et Nimbus conservent la documentation dans votre dépôt et publient du HTML statique ainsi que du Markdown pour les agents. Le choix dépend surtout du modèle de composants, de la maintenance des fichiers d’interface et du type de référence API nécessaire.

Vérifié le 10 novembre 2026 avec les versions publiées Ardo 6.5.0, Nimbus 0.19.4 et le générateur Nimbus 0.8.3. Les sources Nimbus ci-dessous sont figées au commit de publication 0.19.4, sans utiliser le main non publié. La référence Ardo est son tag 6.5.0.

Quelle méthode vous convient ?

Choisissez Ardo si la documentation et les exemples doivent partager un modèle de composants React, si l’API provient de TypeScript et si vous préférez mettre à jour une interface distribuée en paquet. Des composants racine et des layouts React personnalisés restent possibles.

Choisissez Nimbus si posséder les fichiers de layouts, de composants et de styles est essentiel à votre travail, ou si vous avez besoin de sa référence OpenAPI plus étendue et de services optionnels pour agents côté serveur. Sa structure de projet sépare vos fichiers de la dépendance au framework ; les mises à jour n’écrasent pas simplement votre site.

Comparaison des fonctionnalités

DomaineArdo 6.5.0Nimbus 0.19.4
Modèle de pagePages React et MDX, prérendues puis hydratées ; navigation classique entre documents.Pages Astro et MDX. Les composants de framework interactifs utilisent les îlots Astro.
Propriété de l’interfaceL’interface est fournie par le paquet ; composez-la ou remplacez-la avec React.Les layouts, composants et styles générés résident dans votre dépôt.
Référence APIRéférence TypeScript native et générateur statique OpenAPI local.OpenAPI 3.x, avec opérations, schémas, versions d’API et interface de référence dédiés.
LangagesArborescences statiques complètes par langue ; les quatre langues de ce site utilisent des catalogues Palamedes.Nimbus expose une langue de document pour le site ; le routage linguistique et la traduction relèvent du projet Astro.
Gestion des versionsInstantanés statiques par version majeure ; les répertoires de guides/API peuvent être versionnés indépendamment des pages du site.Collections et chemins distincts pour les anciennes versions de documentation ; les versions d’API ont leur propre modèle.
RechercheMiniSearch intégré avec index générés.Recherche Pagefind statique, ou fournisseur défini par le projet.
Fichiers pour agentsMarkdown par page, llms.txt, llms-full.txt et découverte optionnelle des Agent Skills.Markdown et llms.txt, avec des services optionnels pour les agents.
MCPPas de point d’accès MCP à l’exécution fourni par le framework.MCP distant optionnel : list_pages et get_page ; nécessite un adaptateur serveur et le SDK.
Vérification et lintardo check sans build, ardo lint pour la rédaction et vérification des liens internes au build.nimbus-docs check et lint, avec corrections et vérifications des mises à niveau.
Recettesardo add affiche des recettes adaptées à la version, sans écrire de fichiers.add copie le code des composants ; les fonctionnalités transmettent des recettes à un agent.
JavaScript dans le navigateurHydratation React et interface interactive ; pas de routeur client.Îlots Astro avec les composants et scripts choisis ; le volume transféré dépend de cet assemblage.
HébergementFichiers statiques sur tout hébergement statique.Statique par défaut ; le rendu à la demande et MCP distant nécessitent un adaptateur serveur.

Le guide API, la configuration, l’internationalisation et les instructions pour agents d’Ardo détaillent sa partie du tableau. Nimbus est antérieur à la version 1.0 ; consultez ses notes de version avant de supposer qu’une version mineure ultérieure se comporte de la même manière.

Venir de Nimbus

Projet NimbusÉquivalent Ardo ou travail de migration
src/content/docs/Déplacez les textes dans app/routes/, avec les répertoires de langue et guide selon la configuration. Préservez les anciennes URL par des redirections explicites.
title, description, sidebar.orderConservez title et description ; remplacez sidebar.order par order. Vérifiez les autres champs de frontmatter individuellement.
mode: customUtilisez layout: bare pour une page sans cadre de documentation.
src/components.ts et composants AstroVérifiez chaque composant et ses props ; portez le code Astro vers React ou utilisez les composants MDX d’Ardo. La conversion des composants n’est pas automatique.
astro.config.ts et nimbus()Utilisez ardo.config.ts pour les options du framework et les plugins Vite personnalisés, et app/root.tsx pour composer l’interface.
Références OpenAPICommencez par la configuration openapi locale d’Ardo. Les versions d’API, vues de schémas et commandes interactives de référence de Nimbus ne se transposent pas directement.

Vérifiez les brouillons, les pages masquées et les règles de publication avant de déplacer le contenu ; les indicateurs Nimbus ne conservent pas automatiquement leur sens dans Ardo. Suivez les instructions d’installation et vérifiez les routes publiées, les liens et les exemples dans un aperçu de production.

Limites et travaux en cours

Nimbus prend aussi en charge les sources de contenu Git et les builds partiels. Les propositions correspondantes pour Ardo restent #473 et #474. Un checkout dans la CI suivi d’un mappage de contenu local est déjà possible.

Les composants de rédaction, les commandes check/lint, le rendu Mermaid statique et les recettes d’Ardo sont déjà implémentés : #469, #470, #472 et #475. Les images de partage automatiques des pages sont suivies dans #471 ; elles ne font pas partie de la version publiée 6.5.0 utilisée ici.

Modifier cette page sur GitHubDernière mise à jour: 13 novembre 2026