Aller au contenu principal

Docusaurus 2.2

· 3 minutes de lecture
Sébastien Lorber
Sébastien Lorber
Mainteneur de Docusaurus, rédacteur de This Week In React

Nous sommes heureux d'annoncer Docusaurus 2.2.

La mise à jour devrait être facile : comme expliqué dans notre documentation sur le processus de version, les versions mineures respectent le versionnement sémantique.

Carte sociale Docusaurus 2.2

Points importants​

Diagrammes Mermaid​

Dans le #7490, nous avons ajouté le support des diagrammes de Mermaid. Cela comble le vide entre GitHub Flavored Markdown qui a également ajouté la prise en charge récemment. Vous pouvez créer des diagrammes Mermaid en utilisant des blocs de code Markdown :

```mermaid
sequenceDiagram
    participant Alice
    participant Bob
    Alice->>John: Hello John, how are you?
    loop Health check
        John->>John: Fight against hypochondria
    end
    Note right of John: Rational thoughts <br/>prevail!
    John-->>Alice: Great!
    John->>Bob: How about you?
    Bob-->>John: Jolly good!
```
http://localhost:3000

Veillez à consulter la documentation, et les exemples plus avancés

Config headTags​

Dans le #8151, nous avons ajouté la possibilité d'appliquer des balises HTML arbitraire <head> à toutes les pages de votre site.

docusaurus.config.js
module.exports = {
  headTags: [
    {
      tagName: 'link',
      attributes: {
        rel: 'icon',
        href: '/img/docusaurus.png',
      },
    },
  ],
};

Accessibilité​

Nous avons fait plusieurs améliorations d'accessibilité :

  • #8207 : amélioration de la navigation au clavier pour le bouton de menu du hamburger mobile
  • #8161 : amélioration de la navigation au clavier pour les onglets
  • #8204 : permet au bouton "Aller au contenu principal" de prendre en charge les améliorations progressives
  • #8174: améliore l'annonce du lecteur d'écran en basculant entre les modes clair/sombre

Expérience de développeur​

Nous avons rendu la validation plus stricte et amélioré les messages d'erreur :

  • #8234 : en cas d'échec du traitement du doc, imprime le chemin du fichier markdown problématique dans le message d'erreur
  • #8192 et #8159 : valide siteConfig.url plus strictement et avec un meilleur message d'erreur
  • #8066 : rend la config url et baseUrl plus sûrs et moins sensibles à la présence ou à l'absence d'un slash de début ou de fin

Traductions​

Nous avons ajouté la prise en charge de la traduction du thème par défaut pour plusieurs langues :

  • 🇹🇷 #8105 : traductions complètes en turc
  • 🇷🇺 #8253 : traductions complètes en russe
  • 🇫🇷 #8243 : traductions complètes en français
  • 🇯🇵 #8075 : traductions complètes en japonais
astuce

Traduire les thèmes représente un effort constant et un moyen facile de contribuer à Docusaurus. Nous ajoutons régulièrement de nouvelles fonctionnalités de thème, pour lesquelles nous avons souvent besoin de nouvelles traductions.

Autres modifications​

Voici les autres changements notables :

  • #8210 : le CLI docusaurus swizzle a une nouvelle option --config
  • #8109 : optimisation des performances de navigation mobile, pré-chargement précoce des ressources
  • #8059 : les listes déroulantes de la barre de navigation versions/locales conservent le hachage et les paramètres de requête lors de la navigation
  • #8227 : le plugin de redirection du client conserve le hachage et les paramètres de requête lors de la redirection

Consultez l'entrée 2.2.0 du changelog pour une liste exhaustive des changements.