IdentifiantMot de passe
Loading...
Mot de passe oublié ?Je m'inscris ! (gratuit)
Navigation

Inscrivez-vous gratuitement
pour pouvoir participer, suivre les réponses en temps réel, voter pour les messages, poser vos propres questions et recevoir la newsletter

Conception Web Discussion :

La version 2.0 de Docusaurus, un générateur de site statique, est disponible avec un système de plug-ins


Sujet :

Conception Web

  1. #1
    Chroniqueur Actualités

    Homme Profil pro
    Dirigeant
    Inscrit en
    juin 2016
    Messages
    2 538
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : Bénin

    Informations professionnelles :
    Activité : Dirigeant
    Secteur : Aéronautique - Marine - Espace - Armement

    Informations forums :
    Inscription : juin 2016
    Messages : 2 538
    Points : 47 908
    Points
    47 908
    Par défaut La version 2.0 de Docusaurus, un générateur de site statique, est disponible avec un système de plug-ins
    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.

    Nom : social-card-736cfe55fc7bba07204176852d67c0d5.png
Affichages : 37611
Taille : 161,8 Ko

    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 intégration transparente avec OpenAPI et Redoc ;
    • docusaurus-preset-shiki-twoslash : il permet d'utiliser la coloration syntaxique des blocs de code Shiki avec les indices du compilateur TypeScript TwoSlash ;
    • docusaurus-search-local : il s'agit de l'une des diverses alternatives de recherche locale au plug-in Algolia intégré.


    Thématisation (Theming)

    Selon l'équipe, la thématisation est l'une des caractéristiques les plus importantes de Docusaurus 2.0. « Nous pensons qu'un site de documentation professionnel doit respecter l'image de marque de votre entreprise et créer une expérience cohérente », a-t-elle déclaré. Cela permet aux utilisateurs prêts à investir un peu plus de temps dans les personnalisations de créer des sites qui se distinguent des autres. Elle ajoute que la thématisation de Docusaurus offre une grande flexibilité à plusieurs niveaux :

    • personnalisez les variables CSS pour ajuster les couleurs, les polices, etc. ;
    • utilisez vos propres feuilles de style CSS ;
    • implémentez votre propre thème à partir de zéro ;
    • remplacez n'importe quel composant React fourni par le thème par défaut. L'équipe appelle cela "swizzling".


    Autres fonctionnalités

    Docusaurus 2.0 est livré avec une très longue liste de fonctionnalités utiles :

    • thème : mode sombre, amélioration de l'interface utilisateur et de l'ergonomie, options de configuration du thème flexibles, etc. ;
    • versionnage des documents : options de plug-in flexibles pour s'adapter à votre flux de travail ;
    • barre latérale des documents : catégorie repliable, pages d'index des catégories, etc. ;
    • blogue : auteurs multiples, carte des auteurs, page d'archives, etc. ;
    • Markdown : onglets, équations mathématiques, blocs de code dynamiques, liens, pages de garde flexibles, etc. ;
    • recherche : utilisez la nouvelle expérience Algolia DocSearch 3 ;
    • ressources : facilitez l'intégration d'images et d'autres types de fichiers ;
    • internationalisation : options de configuration, traductions du thème par défaut, etc. ;
    • accessibilité : attribut aria-label, contrastes de couleurs, saut au contenu, navigation au clavier, amélioration progressive, etc. ;
    • SEO : valeurs sensibles par défaut, facile à personnaliser, URL canonique, carte sociale, sitemap, microdata, hreflang, etc. ;
    • PWA : ajoutez le support hors ligne à votre site et rendez-le installable ;
    • fail fast : validation stricte de la configuration, détection des liens brisés et prévention des mauvais déploiements en production ;
    • support de TypeScript pour les fichiers de configuration, les plug-ins, les pages personnalisées et les auteurs de thèmes ;
    • etc.


    Parmi les alternatives à Docusaurus, on peut citer GitBook, MkDocs, Docsify et Daux.io. GitBook est un outil permettant de créer des livres/documentations en utilisant Git et Markdown. Il peut générer votre livre en plusieurs formats. Selon certains, GitBook serait la meilleure alternative à Docusaurus. MkDocs est un générateur de site statique destiné à la création de documentation de projet. Les fichiers sources de la documentation sont écrits en Markdown, et configurés avec un seul fichier de configuration YAML. Quant à Docsify, il génère votre site Web de documentation à la volée. Contrairement à GitBook, il ne génère pas de fichiers HTML statiques.

    Nom : star-history-72ae014f60d05445753e9f690e41d347.png
Affichages : 5730
Taille : 226,8 Ko

    Au lieu de cela, il charge et analyse intelligemment vos fichiers Markdown et les affiche sous forme de site Web. Tout ce que vous avez à faire est de créer un index. En outre, Daux.io est un générateur de documentation qui utilise une structure de dossiers simple et des fichiers Markdown pour créer une documentation personnalisée à la volée. Il vous aide à créer une documentation de grande qualité d'une manière conviviale pour les développeurs. Il y a également Gatsby, un générateur de site statique doté d'un grand nombre de fonctionnalités, d'un riche écosystème de plug-ins et est capable de faire tout ce que fait Docusaurus.

    Cependant, l'on estime qu'il a une courbe d'apprentissage plus élevée. Gatsby fait beaucoup de choses bien et convient à la création de nombreux types de sites Web. Selon Meta, contrairement à Gatsby, Docusaurus essaie de bien faire une seule chose : "être le meilleur outil pour écrire et publier du contenu". GraphQL est également au cœur de Gatsby, même si vous n'avez pas nécessairement besoin de GraphQL pour créer un site Gatsby. Dans la plupart des cas, lorsque vous créez des sites Web statiques, vous n'avez pas besoin de la flexibilité offerte par GraphQL.

    L'équipe de Docusaurus reconnaît toutefois que de nombreux aspects de Docusaurus 2.0 ont été inspirés par les meilleures choses de Gatsby. Enfin, comme alternative à Docusaurus, il y a également VuePress. Cet outil présente de nombreuses similitudes avec Docusaurus : tous deux sont fortement axés sur les sites Web centrés sur le contenu et offrent des fonctionnalités de documentation sur mesure. Toutefois, VuePress est basé sur Vue, tandis que Docusaurus est basé sur React. Si vous voulez une solution basée sur Vue, VuePress serait un choix décent.

    Source : Docusaurus 2.0

    Et vous ?

    Quel est votre avis sur le sujet ?
    Que pensez-vous du générateur de site Web statique Docusaurus ?
    Quelle comparaison faites-vous entre Docusaurus et ses concurrents ?
    Quel générateur de site statique utilisez-vous pour écrire vos documentations ?
    Quelles sont les critères qui déterminent votre choix ?

    Voir aussi

    La version 2 de Redbean, un serveur Web à fichier unique qui fonctionne sur n'importe quel système d'exploitation x86-64, est disponible, avec de nouvelles API, la complétion de code, etc.

    Le fondateur de GitHub présente RedwoodJS, un framework JavaScript qui apporte le full-stack à la philosophie JAMstack et « fonctionne avec les composants de développement que vous aimez »

    PHP 8.2 apportera de nouvelles fonctionnalités et les améliorations de performances, annoncée pour la fin de 2022

    JavaScript reste le langage le plus populaire avec 16,4 millions de développeurs, mais est talonné par Python qui compte désormais 11,3 millions d'utilisateurs, selon une étude de SlashData
    Contribuez au club : corrections, suggestions, critiques, ... Contactez le service news et Rédigez des actualités

  2. #2
    Membre du Club
    Inscrit en
    mars 2010
    Messages
    22
    Détails du profil
    Informations forums :
    Inscription : mars 2010
    Messages : 22
    Points : 69
    Points
    69
    Par défaut
    Hello,

    On pourrait ajouter à la liste des concurrents [docfx](https://dotnet.github.io/docfx/) le moteur utilisé pour générer la docs de Microsoft...

  3. #3
    Membre émérite
    Homme Profil pro
    Développeur Java/Scala
    Inscrit en
    octobre 2007
    Messages
    1 086
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France

    Informations professionnelles :
    Activité : Développeur Java/Scala

    Informations forums :
    Inscription : octobre 2007
    Messages : 1 086
    Points : 2 268
    Points
    2 268
    Par défaut
    coucou, c'est Sébastien Lorber le mainteneur de Docusaurus ça me fait plaisir que ça soit relayé ici

    N'hesitez pas à poser des questions
    React-Hebdo - Newsletter pour se tenir à jour sur l'écosystème React

  4. #4
    Membre éprouvé
    Femme Profil pro
    Inscrit en
    juillet 2012
    Messages
    258
    Détails du profil
    Informations personnelles :
    Sexe : Femme
    Localisation : Italie

    Informations forums :
    Inscription : juillet 2012
    Messages : 258
    Points : 957
    Points
    957
    Par défaut
    Citation Envoyé par HerQuLe Voir le message
    ...
    J'ai connu Docusaurus chez la chaine Youtube de YoanDev! Super boulot et merci

  5. #5
    Candidat au Club
    Homme Profil pro
    Juriste
    Inscrit en
    janvier 2016
    Messages
    2
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Localisation : France, Ille et Vilaine (Bretagne)

    Informations professionnelles :
    Activité : Juriste
    Secteur : Service public

    Informations forums :
    Inscription : janvier 2016
    Messages : 2
    Points : 2
    Points
    2
    Par défaut Et le concurrent chez Google ?
    Bonjour,
    Existe t'il une version disponible du générateur d'aide utilisé par les sites de Google ?
    Merci ?

  6. #6
    Expert éminent
    Avatar de sekaijin
    Homme Profil pro
    Urbaniste
    Inscrit en
    juillet 2004
    Messages
    4 194
    Détails du profil
    Informations personnelles :
    Sexe : Homme
    Âge : 58
    Localisation : France, Yvelines (Île de France)

    Informations professionnelles :
    Activité : Urbaniste
    Secteur : Santé

    Informations forums :
    Inscription : juillet 2004
    Messages : 4 194
    Points : 9 122
    Points
    9 122
    Par défaut
    perso j'utilise asciidoc
    que je trouve plus riche que md.
    les outils de build de doc s'intègrent facilement dans les chaînes de production.

    tout est automatisé.
    mais toujours bon de voir ce qu'il se passe ailleurs.

    A+

Discussions similaires

  1. Firefox 43 est disponible avec une version 64 bits pour Windows
    Par Olivier Famien dans le forum Firefox
    Réponses: 11
    Dernier message: 22/12/2015, 08h24
  2. Réponses: 52
    Dernier message: 28/06/2012, 16h36
  3. Réponses: 0
    Dernier message: 25/01/2011, 10h16

Partager

Partager
  • Envoyer la discussion sur Viadeo
  • Envoyer la discussion sur Twitter
  • Envoyer la discussion sur Google
  • Envoyer la discussion sur Facebook
  • Envoyer la discussion sur Digg
  • Envoyer la discussion sur Delicious
  • Envoyer la discussion sur MySpace
  • Envoyer la discussion sur Yahoo