📦 eslint-plugin

ESLint는 코드를 정적으로 분석하고 문제점을 보고하거나 편집기에서 코드 힌트나 명령줄을 통해 모범 사례를 제안하는 도구입니다. 도큐사우루스는 최고의 도큐사우루스 경험을 적용하기 위해 ESLint 플러그인을 지원합니다.

설치

npm

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

Yarn

yarn add --dev @docusaurus/eslint-plugin

pnpm

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

사용법

.eslintrc 설정 파일에서 plugins 항목에 @docusaurus를 추가합니다.

.eslintrc

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

그리고 다음 설정 중 하나를 확장합니다(예: recommended 설정).

.eslintrc

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

각 설정은 일련의 규칙이 포함되어 있습니다. 보다 세분화된 제어를 위해 직접 사용할 규칙을 설정할 수 있습니다.

.eslintrc

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

지원하는 설정

• Recommended: 확장되어야 하는 대부분의 도큐사우루스 사이트에 대한 권장 규칙 집합니다.
• All: 모든 규칙이 활성화됩니다. 이것은 마이너 버전 간에 변경될 수 있으므로 예기치 않은 주요 변경 사항을 방지하려면 해당 옵션을 사용하지 마세요.

지원하는 규칙

옵션명	설명
@docusaurus/no-untranslated-text	JSX의 텍스트 라벨이 translate 호출로 래핑되도록 적용합니다
@docusaurus/string-literal-i18n-messages	일반 텍스트 라벨에 대해 번역 API를 강제로 호출합니다.	✅

✅ = recommended

설정 예시

다음은 설정 예시입니다:

.eslintrc.js

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