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.
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!
```
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.
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élioration de l'annonce aux lecteurs d'écran lors du passage du mode clair au mode 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
etbaseUrl
plus sûrs et moins sensibles à la présence ou à l'absence d'un slash de début ou de fin
Traductions
Nous avons terminé la prise en charge par défaut de la traduction du thème 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
Compléter les traductions de thèmes est 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
Les autres changements notables sont les suivants :
- #8210 : le CLI
docusaurus swizzle
a une nouvelle option--config
- #8109 : optimisations de performance de navigation mobile, pré-récupération des ressources plus tôt
- #8059 : les listes déroulantes de la barre de navigation versions/locales conservent le hachage et la chaîne de recherche lors de la navigation
- #8227 : le plugin de redirection du client conserve le hash et la chaîne de recherche lors de la redirection
Consultez l'entrée 2.2.0 du changelog pour une liste exhaustive des changements.