Comparaisons
En quoi Fumadocs est-il différent des autres frameworks existants ?
Suivant
Fumadocs est fortement inspiré de Nextra. Par exemple, les conventions de routage. C'est pourquoi
meta.json existe également dans Fumadocs.
Nextra est plus opiniâtre que Fumadocs. Fumadocs est accéléré par App Router. En conséquence, il fournit de nombreuses fonctions côté serveur et vous devez configurer les choses manuellement par rapport à la simple modification d'un fichier de configuration.
Fumadocs fonctionne très bien si vous voulez plus de contrôle sur tout, comme en l'ajoutant à une base de code existante ou en implémentant un routage avancé.
Tableau des fonctionnalités
| Fonctionnalité | Fumadocs | Nextra |
|---|---|---|
| Génération statique | Oui | Oui |
| En cache | Oui | Oui |
| Mode clair/obscur | Oui | Oui |
| Mise en évidence de la syntaxe | Oui | Oui |
| Table des matières | Oui | Oui |
| Recherche en texte intégral | Oui | Oui |
| i18n | Oui | Oui |
| Dernière heure de modification Git | Oui | Oui |
| Icônes de pages | Oui | Oui, via les fichiers _meta.js |
| RSC | Oui | Oui |
| Source distante | Oui | Oui |
| Référencement | Via les métadonnées | Oui |
| Composants intégrés | Oui | Oui |
| Mise en page RTL | Oui | Oui |
Fonctionnalités supplémentaires
Les fonctionnalités prises en charge via des bibliothèques tierces telles que TypeDoc ne seront pas répertoriées ici.
| Fonctionnalité | Fumadocs | Nextra |
|---|---|---|
| Intégration OpenAPI | Oui | Non |
| Génération de documents TypeScript | Oui | Non |
| TypeScript deux barres obliques | Oui | Oui |
Mintlify
Mintlify est un service de documentation, contrairement à Fumadocs, il propose un niveau gratuit mais n'est pas entièrement gratuit et open source.
Fumadocs n'est pas aussi puissant que Mintlify, par exemple l'intégration OpenAPI de Mintlify. En tant que créateur de Fumadocs, je ne recommanderais pas de passer à Fumadocs depuis Mintlify si vous êtes satisfait de la façon actuelle dont vous créez des documents. Cependant, je pense que Fumadocs est un outil approprié pour tous les développeurs Next.js qui souhaitent disposer de documents élégants.
Docusaure
Docusaurus est un framework puissant basé sur React.js. Il offre beaucoup de cool fonctionnalités avec des plugins et des thèmes personnalisés.
Meilleur DX
Puisque Fumadocs est construit sur Next.js, vous devrez démarrer le développement Next.js serveur à chaque fois pour examiner les modifications, et le code passe-partout initial est relativement plus par rapport à Docusaurus.
Pour une documentation simple, Docusaurus pourrait être un meilleur choix si vous n'avez besoin d'aucune fonctionnalité spécifique à Next.js.
Cependant, lorsque vous souhaitez utiliser Next.js ou rechercher une personnalisation supplémentaire, comme le réglage des composants d'interface utilisateur par défaut, Fumadocs pourrait être un meilleur choix.
###Plugins
On peut facilement réaliser beaucoup de choses avec les plugins, leur écosystème est en effet plus vaste et maintenu par de nombreux contributeurs.
En comparaison, la flexibilité de Fumadocs vous permet de les mettre en œuvre vous-même, cela peut prendre plus de temps pour l'ajuster à votre satisfaction.
AI Magic 3DDocs