Rédiger de la documentation technique est facile avec Markdown, mais créer un site web de documentation visuellement attrayant et entièrement fonctionnel, prenant en charge plusieurs langues, la recherche et le mode sombre, représente un véritable défi. J'ai découvert par hasard Docus, un framework de documentation open source sur GitHub, qui permet de générer un site de documentation entièrement fonctionnel en une seule commande. Basé sur Nuxt 4, il intègre nativement une conception réactive, un mode sombre, la recherche en texte intégral et la prise en charge de l'internationalisation, et vous pouvez également utiliser directement les composants Vue dans Markdown. GitHub : https://t.co/h4ZV53ivZ7 Il intègre Nuxt Content pour la gestion de contenu, Nuxt UI pour fournir une bibliothèque de composants, Tailwind CSS pour gérer les styles, et dispose également d'une optimisation d'images intégrée. La structure du projet généré est très claire, le contenu étant placé dans le dossier « content ». Vous pouvez facilement ajouter des composants ou des pages personnalisés sans avoir à configurer de nombreux outils de A à Z.
