La version 2.0 de Docusaurus, un générateur de site statique qui convertit les fichiers Markdown en site Web de documentation, est disponible,

Avec un système de plug-ins et la thématisation

L'équipe de développement de Docusaurus a publié lundi la deuxième version majeure du générateur de site Web statique. Docusaurus 2.0 est livré avec le support du format de fichier MDX pour permettre aux utilisateurs d'intercaler des composants React dans Markdown, la prise en charge des conventions de système de fichiers pour faciliter davantage l'ajout de nouvelles pages lors de la création d'une documentation, ainsi que l'ajout de nouveaux plug-ins. Une autre fonctionnalité clé de cette version est la thématisation qui, selon l'équipe, permet de créer une expérience cohérente dans une documentation.

Docusaurus est un générateur de site statique open source qui convertit les fichiers Markdown en site Web de documentation. Créé par Facebook (aujourd'hui Meta), Docusaurus est développé avec Node.js. « L'objectif principal de ce projet est de vous permettre de démarrer votre site Web en quelques secondes. Au-delà de la création du site, Docusaurus met l'accent sur la rapidité du développeur et de l'utilisateur final en suivant le modèle PRPL (Push, Render, Pre-cache, Lazy-load) et en s'appuyant sur une construction incrémentale pour les changements de contenu », a écrit l'entreprise à propos de son générateur de site Web statique.

Docusaurus permet aux développeurs d'utiliser des outils qu'ils connaissent déjà comme Markdown ou le format MDX pour rédiger de la documentation ou des blogues. Désormais, avec React comme colonne vertébrale de Docusaurus, les développeurs peuvent personnaliser leur site Web en fonction de leur cas d'utilisation. Cet outil de création de sites Web est également doté de fonctions de recherche et de localisation. Les projets construits avec Docusaurus tirent parti d'Algolia pour un moteur de recherche intégré et de Crowdin pour la prise en charge des langues. Docusaurus synchronise également automatiquement les modifications apportées au code.


Docusaurus a été mis à la disposition du public pour la première fois par l'équipe open source de Meta en 2017. Selon l'équipe, des milliers d'organisations utiliseraient à jour Docusaurus pour alimenter leurs sites Web de documentation. Le projet est disponible sous la licence MIT. Docusaurus 2.0 a été publié lundi avec de nombreuses nouvelles fonctionnalités et quelques corrections de bogue. Voici ci-dessous les nouveautés clés de cette version :

Prise en charge de MDX

MDX est un format de fichier standard qui combine Markdown et JSX. Cela signifie que vous pouvez utiliser la syntaxe laconique de Markdown pour une documentation et intégrer librement des blocs de composants JSX à n'importe quel endroit du fichier. Rappelons que JSX est une extension React de la syntaxe du langage JavaScript qui permet de structurer le rendu des composants à l'aide d'une syntaxe familière à de nombreux développeurs. Il est similaire en apparence au HTML.

Ainsi, avec la prise de MDX, Docusaurus 2.0 vous permet désormais d'entrelacer des composants React dans Markdown. Cela vous permet de construire facilement des expériences de documentation interactive de premier ordre. MDX dispose de son propre système de plug-ins. Vous pouvez personnaliser votre expérience de création Markdown, et même créer votre propre syntaxe Markdown.

Conventions du système de fichiers et plug-ins

« Notre objectif est de rendre l'utilisation de Docusaurus très intuitive », a déclaré l'équipe. Ainsi, elle a ajouté des conventions de système de fichiers qui, selon elle, rendent l'ajout d'une page à votre documentation aussi facile que de créer un fichier Markdown. En outre, l'équipe a également déclaré que Docusaurus a maintenant une architecture modulaire avec un système de plug-ins - les fonctions principales comme les documents, le blogue, les pages et la recherche sont toutes alimentées par des plug-ins individuels. Selon elle, cela permet à la communauté d'améliorer Docusaurus avec des fonctionnalités supplémentaires.


« L'API des plug-ins est très facile à utiliser et suffisamment puissante pour que je puisse porter l'exemple de code de rendu d'un site Web TypeScript en quelques heures », a déclaré Orta Therox, ancien membre de l'équipe TypeScript chez Microsoft. Voici quelques exemples :

• redocusaurus : ce plug-in permet une...