Aller au contenu principal

Récapitulatif de Docusaurus 2021

· 7 minutes de lecture
Joshua Chen

Docusaurus a fait de grands progrès en 2021 ! Nous avons eu beaucoup de progression et venons de franchir 30k étoiles sur GitHub !

Nous avons atteint la parité complète des fonctionnalités avec la v1 après la publication de l'internationalisation, nous avons annoncé notre première beta, et a accueilli beaucoup plus d'utilisateurs cette année.

La version officielle de la v2 est à portée de main ! Consultez la feuille de route pour les dernières nouvelles.

vignette

Points importants

Commençons par passer en revue quelques faits marquants de cette année. Vous vous souvenez de la todo-list d'il y a six ans ? Il est temps de la sortir à nouveau et de voir jusqu'où nous sommes arrivés !

  • Internationalisation : sortie officielle quatre mois après son débarquement initial, fin 2020. Un grand succès dans de nombreux projets
  • Barres latérales générées automatiquement : plus besoin de maintenir un fichier sidebars.js
  • Webpack 5 : amélioration significative des performances de construction
  • Configuration du slash de fin : intégration transparente avec n'importe quel hébergeur de contenu
  • Navigation mobile repensée : les utilisateurs mobiles bénéficient désormais de toutes les fonctionnalités de navigation comme sur le bureau
  • Améliorations de l'interface utilisateur : citations plus accessibles, meilleures admonitions, bouton de retour vers le haut...
  • Blog multi-auteurs : créditez tous les contributeurs incroyables qui ont collaboré sur un article du blog !
  • Plus de fonctionnalités pour le blog : page d'archives, données structurées pour le référencement, contenu complet des articles dans les flux - ce qui vous permet d'expédier un blog complet en un rien de temps
  • Collocation des ressources : plus besoin d'un dossier statique ballonné : colocalisez vos images avec des fichiers Markdown
  • Pages d'index des catégories de la barre latérale: les libellés de catégories peuvent maintenant être associés à des pages, permettant une meilleure organisation de la documentation

Notre base de code a également été perfectionnée au fil du temps. Nous avons amélioré la couverture des tests, migré tous les paquets vers TypeScript et réduit la taille de nos paquets publiés d'un maximum de 60 % !

Tendances

npm

Docusaurus v2 continue de croître régulièrement. L'installation de la v2 est maintenant 8 fois plus importante que la v1. En ce qui concerne les téléchargements hebdomadaires, nous avons assisté à une triple augmentation (+209,4 %), passant de 28 066 début janvier à un sommet de 86 846 à la mi-décembre.

tendance de téléchargement npm

(Ah, le classique repas de Noël...)

Nous avons libéré 18 versions, allant de 2.0.0-alpha.71 à 2.0.0-beta.14. C'est une version tous les 20 jours !

GitHub

  • Stars : 20,460 → 29,679 (+45.1% sur une année glissante). Et, juste avant que cet article du blog soit publié, nous avons atteint 30k stars !
  • Contributeurs totaux : 512 → 773 (+51.0% sur une année glissante)
  • Dépendants : 5 039 → 14,579 (+189,3% sur une année glissante) pour la v2, et 6 311 → 7 581 (+20,1% sur une année glissante) pour la v1
  • Commits : 1 187 commits au cours de la dernière année, en moyenne 23 commits par semaine
  • Issues : 619 issues ouvertes, 505 d'entre elles sont éventuellement résolues
  • Un nouveau membre de l'équipe (oui, c'est moi 😝)

Notre tendance de star est également très positive. Par rapport à des projets similaires, nous augmentons à un rythme plus rapide :

tendances des étoiles par année

Avec une augmentation de 8,4k stars, nous sommes classés numéro 3 dans le classement des stars montantes des générateurs de sites statiques JavaScript de cette année, précédés seulement par Next.js et Astro.

classement des stars montantes

Adoptions en vedette

Notre vitrine a accueilli quelques nouveaux sites « favoris » qui mettent en valeur le véritable potentiel de l'architecture pluggable de Docusaurus 2.

Iota wiki clairIota wiki sombre

Dyte clairDyte sombre

Ionic clairIonic sombre

Courier

La créativité des utilisateurs de Docusaurus dépasse notre imagination 🤩 Nous sommes impatients de voir de plus en plus d'adoptants tirer parti des fonctionnalités de contenu de Docusaurus tout en explorant des designs de thèmes originaux ! Si votre site utilise Docusaurus, nous aimerions l'avoir dans notre vitrine.

Communauté

En tant que modérateur actif sur Discord, je peux clairement voir la communauté prospérer. De nombreuses questions fréquemment posées sont désormais intégrées dans notre documentation, et certaines demandes de fonctionnalités ont également été mises en œuvre. Le projet et la communauté s'enrichissent mutuellement - à titre d'exemple, j'étais auparavant un contributeur de la communauté avant de devenir un mainteneur.

Nous sommes constamment mentionnés sur Twitter avec des commentaires inspirés :

@docusaurus est incroyable ! je n'arrive pas à croire que c'est si simple à utiliser.

Aucun plugin, outil ou étape de compilation supplémentaire. Cela fonctionne dès le départ.

J'aime @docusaurus. Sans Docusaurus, je n'aurais pas pu construire les API, les didacticiels et les blogs contenus dans mon site de manière efficace et belle dans le cadre de mon flux de travail.

Et nous gardons chacun d'entre eux dans notre petite boîte 😄 Si vous appréciez vous-même Docusaurus, continuez à nous taguer avec vos commentaires !

À l'approche de la sortie officielle, nous souhaitons en savoir plus sur ce que font les gens sur le terrain : auteurs de plugins, créateurs de sites personnalisés, et tous les nouveaux utilisateurs - veuillez nous tenir informés de vos réalisations afin que nous puissions orienter notre développement pour mieux répondre à vos besoins.

Aller de l'avant

Au cours des derniers mois, nous n'avons cessé de parler de la phase release-candidate de Docusaurus, et oui, elle est presque arrivée. Nous avons créé un jalon dédié pour garder la trace de tous les problèmes à résoudre avant de pouvoir passer en toute confiance à l'étape suivante. En bref, nous voulons construire un flux de travail de thématisation plus robuste, permettant aux créateurs de sites créatifs de personnaliser notre thème par défaut sans craindre de briser des changements lors des mises à jour. Cela comprendra :

  • Lignes directrices sur l'organisation des composants. Nous voulons que les composants du thème aient la bonne modularité, de sorte que lorsque vous souhaitez personnaliser une partie de votre site, il y a toujours un composant qui fait exactement ce dont vous avez besoin.
  • Améliorations du CLI swizzle. Nous voulons que les utilisateurs l’utilisent avec plaisir, et qu’il vous aide à travers tous les scénarios de swizzling possibles.
  • Refonte de nos API de thème. Nous voulons que tous les composants swizzlables soient réellement appropriés pour le swizzling, donc les composants non-UI seront relocalisés.
  • Docs. Nous voulons que nos documents soient le plus accessibles possible à tout le monde, des codeurs débutants aux développeurs web expérimentés. Nous l'organiserons comme un tutoriel plus évolutif qui peut être bénéfique pour tous les niveaux de compétence.

Pour en savoir plus sur les plans pour Docusaurus 2.0, consultez cette feuille de route. La version 2.0 sera une plus meilleure version avec l'aide de la communauté, alors n'hésitez pas à partager vos opinions et vos suggestions sous l'une des rubriques des jalons !

Comme l'équipe centrale travaille d'arrache-pied pour livrer la version de distribution générale, nous prévoyons de publier d'autres fonctionnalités utiles sous forme de versions mineures après la 2.0. Nous avons même fait d'autres plans pour les changements d'architecture en 3.0!

Avec la sortie officielle de Docusaurus 2.0, nous sommes certains de voir beaucoup plus de nouvelles adoptions et de migrations depuis la v1.

Nous tenons à exprimer notre gratitude à tous les contributeurs en 2021, notamment :

  • L'équipe centrale : Alexey Pyltsyn, Sébastien Lorber, Joshua Chen et Yangshun Tay pour modérer la communauté, diffuser Docusaurus, trier les problèmes et implémenter de nouvelles fonctionnalités
  • Joel Marcey pour avoir créé le Docusaurus et soutenu son développement tout au long de son parcours
  • L'équipe d'Algolia pour aider les utilisateurs de Docusaurus à migrer vers le nouveau DocSearch et répondre aux questions liées à la recherche
  • Tous les membres actifs de la communauté pour apporter de précieuses contributions de code, améliorer notre documentation et répondre aux questions sur Discord

À bientôt, 2021, et faisons un beau 2022 !