Aller au contenu principal

Docusaurus 2.1

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

Nous sommes heureux d'annoncer Docusaurus 2.1, notre toute première version mineure.

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.1

Points importants

Améliorations de DocCardList

Dans le 8008, nous avons simplifié l'utilisation du composant <DocCardList> qui est notamment utilisé sur les pages d'index générées par la catégorie de la barre latérale.

La prop items est désormais facultative, et sera automatiquement déduite du contenu de la catégorie parent de la barre latérale :

import DocCardList from '@theme/DocCardList';
- import {useCurrentSidebarCategory} from '@docusaurus/theme-common';

- <DocCardList items={useCurrentSidebarCategory().items}/>
+ <DocCardList/>

De plus, nous avons fait en sorte qu'il soit possible de l'utiliser sur n'importe quel document, y compris les documents ordinaires non liés à une catégorie de la barre latérale.

composant DocCardList simplifié

Améliorations de noindex

Nous avons amélioré la prise en charge de la directive meta robots noindex, qui permet de signaler aux moteurs de recherche que vous ne souhaitez pas qu'une page spécifique soit indexée.

Dans le 7963, nous permettons de configurer noindex sur la base de chaque version de docs.

Utilisez les options suivantes du plugin pour indiquer aux crawlers que vous ne voulez pas que la version 1.0.0 soit indexée :

const options = {
versions: {
'1.0.0': {
noIndex: true,
},
},
};

En pratique, Docusaurus ajoutera la méta suivante à chaque page de cette version :

<meta name="robots" content="noindex, nofollow" />

Dans le 7964, nous avons également corrigé un bogue qui permettait au plugin sitemap de contenir des pages comportant une directive noindex. Désormais, le plugin sitemap filtrera de manière fiable toutes les pages contenant des directives noindex.

Remplacement des balises méta par défaut

Dans le 7952, il devient possible de remplacer les métabalises html par défaut, ce qui n'était pas possible auparavant :

<>
{siteConfig.noIndex && <meta name="robots" content="nofollow, noindex" />}
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
</>

Il est maintenant possible d'utiliser <Head> ou themeConfig.metadata :

  • pour remplacer le méta viewport
  • pour remplacer la méta robots : vous pouvez marquer votre site comme noIndex, mais à l'exception de pages spécifiques qui doivent être indexées

Traductions ukrainiennes

Dans le 7953, nous avons ajouté des traductions par défaut du thème classique pour la langue ukrainienne.

Autres modifications

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