Après une longue phase alpha afin d'assurer la parité des fonctionnalités et la qualité, nous sommes heureux de publier officiellement la première Docusaurus 2 bêta.
Avec l'annonce de cette version bêta, l'équipe est encore plus convaincue que Docusaurus 2 est prêt à être adopté par le grand public !
Adoption de Docusaurus
Ne craignez pas le tag bêta !
Docusaurus 2 est largement adopté et se développe rapidement :
Pour mieux comprendre la qualité des sites Docusaurus 2 actuels, notre nouvelle page showcase vous permet de filtrer les sites Docusaurus par fonctionnalités, afin que vous puissiez vous inspirer de sites de production réels ayant un cas d'utilisation similaire au vôtre !
Ne manquez pas nos sites préférés, ils se distinguent tous par quelque chose d'unique :
Pourquoi Docusaurus v2 a-t-il été en alpha pendant si longtemps ?
Il est difficile de croire que la première version alpha v2.0.0-alpha.0 date d'il y a 2 ans 😳 , une durée inhabituellement longue pour une alpha de logicielle.
Comme il s'agissait d'une ré-architecture importante de la base de code, nous voulions nous assurer que nous avions confiance dans la stabilité et les fonctionnalités de Docusaurus 2 avant de passer à la phase bêta, puisque la phase bêta suggère un haut niveau de qualité. Nous sommes heureux d'annoncer que Docusaurus 2 a atteint la parité des fonctionnalités avec Docusaurus 1 avec [i18n](https://docusaurus. io/blog/2021/03/09/releasing-docusaurus-i18n), et il a été successivement adopté par de nombreux sites Docusaurus (voir galerie i18n).
Nous sommes désormais convaincus que les fonctions principales de Docusaurus 2 sont suffisamment stables pour être en version bêta.
Quels sont les objectifs de la bêta ?
Maintenant que Docusaurus 2 est stable et que ses principales fonctionnalités sont terminées, l'objectif de la version bêta est d'inspirer la confiance aux nouveaux utilisateurs quant à la capacité de production de Docusaurus 2, de faire migrer un plus grand nombre d'utilisateurs de Docusaurus 1 vers la version 2, et de déprécier officiellement Docusaurus 1. Nous continuerons bien sûr à résoudre les problèmes et les bogues qui pourraient être découverts.
De plus, nous utiliserons la phase bêta pour améliorer notre système de thématisation.
Nous voulons réussir :
-
faciliter l'implémentation d'un thème personnalisé, y compris pour nous-mêmes. Nous voulons fournir plusieurs thèmes officiels (y compris Tailwind CSS) pour une longue période.
-
plus sûr pour faire évoluer un thème existant : il peut être pénible de mettre à jour un site Docusaurus hautement personnalisé, car les personnalisations peuvent entrer en conflit avec les modifications internes. Nous devons faire en sorte que la surface de l'API publique du thème soit plus explicite, et préciser ce qu'il est possible de personnaliser en toute sécurité.
Nous allons construire une meilleure infrastructure de thème et remanier le thème classique pour l'utiliser.
Si vous personnalisez votre site, vous pourriez trouver ces améliorations prévues très utiles.
Quoi de neuf ?
Au cas où vous l'auriez manqué, nous avons récemment apporté deux améliorations majeures :
- Barres latérales générées automatiquement : plus besoin de maintenir un fichier
sidebars.js! - Webpack 5 / PostCSS 8 : la mise en cache persistante accélère significativement le temps de reconstruction !
Et ensuite ?
Livraison de la version officielle 2.0 !
Pour y parvenir, nous continuerons à corriger les bogues et implémenter les fonctionnalités les plus souhaitées, notamment :
- Pages d'index des catégories de la barre latérale
- Meilleure interface de navigation mobile UX
- Meilleure conception d'admonition
- Prise en charge de CSS-in-JS
- Améliorer les performances du temps de construction
- Étendre les plugins Docusaurus, intégration CMS
- Correction des slashes de fin et des problèmes de lien relatif
- Meilleure compatibilité avec CommonMark
- Mise à jour vers MDX 2.0
Conclusion
C'est un moment passionnant pour Docusaurus.
Nous sommes inspirés par les commentaires positifs sur Docusaurus et découvrons de nouveaux sites en ligne chaque jour.
Nous sommes très heureux de cette version bêta. Nous avons recherché la qualité et la stabilité tout en continuant à essayer d'accroître l'adoption de Docusaurus. Pour ceux qui ont hésité à migrer un site Docusaurus existant vers Docusaurus 2, c'est le moment idéal pour le faire. Nous voulons que vous utilisiez l'infrastructure la plus récente lorsque nous abandonnerons Docusaurus 1 à la fin de cette période bêta. Faites-nous savoir comment nous pouvons aider.
Merci à tous ceux qui nous lisent et à toute la communauté qui soutient Docusaurus. 🤗