📦 eslint-plugin

ESLint est un outil qui analyse statiquement votre code et signale les problèmes ou suggère les meilleures pratiques par le biais d'astuces pour l'éditeur et la ligne de commande. Docusaurus fournit un plugin ESLint pour appliquer les meilleures pratiques de Docusaurus.

Installation

npm

npm install --save-dev @docusaurus/eslint-plugin

Yarn

yarn add --dev @docusaurus/eslint-plugin

pnpm

pnpm add --save-dev @docusaurus/eslint-plugin

Utilisation

Ajoutez @docusaurus à la section plugins de votre fichier de configuration .eslintrc :

.eslintrc

{
  "plugins": ["@docusaurus"]
}

Ensuite, vous pouvez étendre une des configurations (par exemple la configuration recommended) :

.eslintrc

{
  "extends": ["plugin:@docusaurus/recommended"]
}

Chaque configuration contient un ensemble de règles. Pour un contrôle plus précis, vous pouvez également configurer les règles que vous voulez utiliser directement :

.eslintrc

{
  "rules": {
    "@docusaurus/string-literal-i18n-messages": "error",
    "@docusaurus/no-untranslated-text": "warn"
  }
}

Configurations prises en charge

• Recommended : ensemble de règles recommandées pour la plupart des sites Docusaurus qui devraient être étendus.
• All : toutes les règles sont activées. Cela changera entre les versions mineures, donc vous ne devriez pas l'utiliser si vous voulez éviter des changements de rupture inattendus.

Règles prises en charge

Nom	Description
@docusaurus/no-untranslated-text	Oblige les libellés de texte en JSX à être enveloppés par des appels de traduction
@docusaurus/string-literal-i18n-messages	Force les API de traduction à être appelées sur les libellés en texte brut	✅

✅ = recommended

Exemple de configuration

Voici un exemple de configuration :

.eslintrc.js

module.exports = {
  extends: ['plugin:@docusaurus/recommended'],
  plugins: ['@docusaurus'],
  rules: {
    '@docusaurus/no-untranslated-text': [
      'warn',
      {ignoredStrings: ['·', '—', '×']},
    ],
  },
};