diff --git a/src/user-guide/configuring/configuration-files-new.md b/src/user-guide/configuring/configuration-files-new.md index 5663db1..f1cc28a 100644 --- a/src/user-guide/configuring/configuration-files-new.md +++ b/src/user-guide/configuring/configuration-files-new.md @@ -35,21 +35,21 @@ export default [ 每个配置对象都包括了 ESLint 检查一组文件所需的所有信息。配置对象由以下属性组成: -* `files` - 用于表示配置适用的文件范围的 glob 模式数组。在没有指定的情况下,配置对象适用于所有文件。 -* `ignores` - 一个表示配置对象不应适用的文件的 glob 模式数组。如果没有指定,配置对象将适用于所有由 `files` 匹配的文件。 -* `languageOptions` - 一个对象,包含与如何为 linting 配置 JavaScript 有关的设置。 +* `files` - 表示配置适用的文件范围的 glob 模式数组。在没有指定的情况下,配置对象适用于所有与其他配置对象匹配的文件。 +* `ignores` - 表示配置对象不应适用的文件的 glob 模式数组。如果没有指定,配置对象将适用于所有由 `files` 匹配的文件。 +* `languageOptions` - 包含如何配置检查过程中 JavaScript 设置的对。 * `ecmaVersion` - 支持 ECMAScript 的版本。可以是任何年份(`2022`)或版本(`5`)。设置为 `"latest"` 则使用受支持的最新版本(默认为 `"latest"`)。 - * `sourceType` - JavaScript 源码类型。传统脚本文件可以使用 `"script"`,ECMAScript 模块(ESM)可以用 `"module"` ,CommonJS 文件使用 `"commonjs`(默认情况下,用于 `.js` 和 `.mjs` 文件使用 `"module"`;`.cjs` 文件使用 `"commonjs"`) - * `globals` - 用于指定额外对象的对象,这些对象应该在 linting 期间被添加到全局范围。 - * `parser` - 包含 `parse()`方法的对象,或者表示插件内解析器名称的字符串(如 `"pluginName/parserName"`,默认为 `"@/espree"`) + * `sourceType` - JavaScript 源码类型。传统脚本文件可以使用 `"script"`,ECMAScript 模块(ESM)可以用 `"module"` ,CommonJS 文件使用 `"commonjs`(默认情况下,`.js` 和 `.mjs` 文件使用 `"module"`;`.cjs` 文件使用 `"commonjs"`) + * `globals` - 指定额外对象的对象,这些对象应该在检查期间会被添加到全局范围。 + * `parser` - 包含 `parse()` 方法的对象,或者表示插件内解析器名称的字符串(如 `"pluginName/parserName"`,默认为 `"@/espree"`) * `parserOptions` - 指定额外选项的对象,直接传递给解析器的 `parser()` 方法。可用选项基于解析器。 * `linterOptions` - 对象,包含与提示过程有关的设置。 - * `noInlineConfig` - 布尔值,表示是否允许内联配置。 - * `reportUnusedDisableDirectives` - 一个布尔值,表示是否应该跟踪和报告未用的禁用指令。 + * `noInlineConfig` - 表示是否允许内联配置布尔值。 + * `reportUnusedDisableDirectives` - 表示是否应该跟踪和报告未用的禁用指令的布尔值。 * `processor` - 包含 `preprocess()` 和 `postprocess()` 方法的对象,或者表示插件内处理器名称的字符串(如 `"pluginName/processorName"`)。 * `plugins` - 包含插件名称与对应的插件对象的名值对对象。如果指定了 `files`,则只适用于与之匹配匹配的文件。 * `rules` - 包含规则配置的对象。如果指定了 `files` 或 `ignores`,则规则配置只适用于与之匹配匹配的文用。 -* `settings` - 包括名值对的对象,这些信息应该对所有规则可用。 +* `settings` - 包含对所有规则可供的名值对的对象。 ### 指定 `files` 和 `ignores` diff --git a/src/user-guide/core-concepts.md b/src/user-guide/core-concepts.md index ea5849e..a0bed90 100644 --- a/src/user-guide/core-concepts.md +++ b/src/user-guide/core-concepts.md @@ -47,38 +47,36 @@ ESLint 插件是一个包含 ESLint 规则、配置、解析器和环境变量 ## 解析器 -ESLint 解析器 converts code into an abstract syntax tree that ESLint can evaluate. By default, ESLint uses the built-in [Espree](https://github.com/eslint/espree) parser, which is compatible with standard JavaScript runtimes and versions. - ESLint 解析器将代码转换为 ESLint 可以评估的抽象语法树(AST, abstract syntax tree)。默认情况下,ESLint 使用内置的与标准 JavaScript运行时和版本兼容的 [Espree](https://github.com/eslint/espree) 解析器。 自定义解析器让 ESLint 可以解析非标准的 JavaScript 语法。通常自定义解析器会被包含在可共享配置或插件中,这一你就不需要直接使用它们了。 -比如用于让 ESLint 可以解析 TypeScript 代码的 [@typescript-eslint/parser](https://www.npmjs.com/package/@typescript-eslint/parser) 解析器就被包含在 [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint) 项目中。 +比如用于让 ESLint 可以解析 TypeScript 代码的 [@typescript-eslint/parser](https://www.npmjs.com/package/@typescript-eslint/parser) 解析器就被包含在 [typescript-eslint](https://github.com/typescript-eslint/typescript-eslint) 项目中。 ## 自定义处理器 -ESLint 处理器可以从其他类型的文件中提取 JavaScript 代码,然后让 ESLint 对 JavaScript 代码进行检查。另外,你也可以在用 ESLint 解析 JavaScript 代码之前使用一个处理器对其进行处理。 +ESLint 处理器可以从其他类型的文件中提取 JavaScript 代码,然后让 ESLint 对 JavaScript 代码进行检查。另外,你也可以在用 ESLint 解析 JavaScript 代码之前使用处理器先对其进行处理。 例如 [eslint-plugin-markdown](https://github.com/eslint/eslint-plugin-markdown) 就包括一个自定义处理器,让你可以对 Markdown 代码块内的 JavaScript 代码进行检查。 ## 格式化工具 -ESLint 格式化工具决定了命令行检查结果的样子。 +ESLint 格式化工具决定了命令行输出的检查结果的样子。 更多信息请参见[格式化工具](./formatters/)。 ## 集成 -ESLint 相关集成生态是使 ESLint 成为如此有用的工具的原因之一。例如,许多代码编辑器都有 ESLint 扩展,这让工作时,可以即刻在文件中查看相关的代码 ESLint 结果,这样你就不需要使用 ESLint CLI 来查看检查结果。 +ESLint 相关集成生态是使 ESLint 成为如此有用的工具的原因之一。例如,许多代码编辑器都有 ESLint 扩展,这让工作时,可以即刻在文件中查看相关的代码 ESLint 结果,这样你就不需要使用 ESLint 命令行来查看检查结果。 更多信息请参见[集成](./integrations)。 -## CLI & Node.js API +## 命令行 & Node.js API -ESLint CLI 是一个命令行界面,让你可以在终端进行检查。CLI 有各种可以传递给命令的选项。 +ESLint 命令行是一个命令行界面,让你可以在终端进行检查。命令行有各种可以传递给命令的选项。 ESLint 的 Node.js API 让你可以在 Node.js 代码中以编程的方式使用 ESLint。该 API 在开发插件、集成和其他与 ESLint 相关的工具时非常有用。 -除非你以某种方式扩展 ESLint,否则你就应该使用 CLI。 +除非你要以某种方式扩展 ESLint,否则你就应该使用命令行。 更多信息请参见[命令行界面](./command-line-interface)和 [Node.js API](../developer-guide/nodejs-api)。