i18n: tsconfig-reference top-level options to zh #165

TomVista · 2022-08-25T14:23:32Z

No description provided.

ghost · 2022-08-25T14:23:45Z

All CLA requirements met.

github-actions · 2022-08-25T14:24:22Z

Thanks for the PR!

This section of the codebase is owned by @Kingwl - if they write a comment saying "LGTM" then it will be merged.

github-actions · 2022-08-25T14:42:06Z

Translation of include.md

display: "Include"

oneline: "The path to the file to be compiled or the list of matchers."

Indicates the file name or file matcher that the program contains.
They are relative tsconfig.json The directory where it resolves.

{
  "include": ["src/**/*", "tests/**/*"]
}

Included files:

.
├── scripts                ⨯
│   ├── lint.ts            ⨯
│   ├── update_deps.ts     ⨯
│   └── utils.ts           ⨯
├── src                    ✓
│   ├── client             ✓
│   │    ├── index.ts      ✓
│   │    └── utils.ts      ✓
│   ├── server             ✓
│   │    └── index.ts      ✓
├── tests                  ✓
│   ├── app.test.ts        ✓
│   ├── utils.ts           ✓
│   └── tests.d.ts         ✓
├── package.json
├── tsconfig.json
└── yarn.lock

include and exclude Matchers supported by the matcher:

* Matches zero or more characters (no directory splitter included)
? Matches any one character (does not contain a directory splitter)
**/ Matches directories of any depth

If the matcher does not contain file extensions only, files with specific extensions are supported. Supported by default .ts， .tsxand .d.ts, if on allowJs, additional support .js and .jsx。

Translation of files.md

display: "Files"

oneline: "An array, each of which is the path to the included files required for the project. and `include` The difference is that files does not support path matching. "

Clearly indicate the files that the project needs to include. If no files that can be included can be found, an error is reported.

{
  "compilerOptions": {},
  "files": [
    "core.ts",
    "sys.ts",
    "types.ts",
    "scanner.ts",
    "parser.ts",
    "utilities.ts",
    "binder.ts",
    "checker.ts",
    "tsc.ts"
  ]
}

This configuration is useful when the number of files is small and there is no need to reference some global files.
It can also be used include Enable more configuration capabilities.

Translation of extends.md

display: "Extends"

oneline: "Specify a path or node module reference to configure inheritance"

extends The value of the configuration file is the path to which you want to inherit.
The path can be either POSIX style (Linux MacOS) or Windows style (in the path \ needs to be escaped).

Configurations in TSConfig override inherited configurations. Relative path calculations are based on the profile in which they reside and are not affected by inheritance.

Note: files，include and exclude Inherited configurations are overwritten, and configuration files do not allow circular inheritance.

references is the only top-level configuration item that is not inherited.

Example

configs/base.json:

{
  "compilerOptions": {
    "noImplicitAny": true,
    "strictNullChecks": true
  }
}

tsconfig.json:

{
  "extends": "./configs/base",
  "files": ["main.ts", "supplemental.ts"]
}

tsconfig.nostrictnull.json:

{
  "extends": "./tsconfig",
  "compilerOptions": {
    "strictNullChecks": false
  }
}

A configuration item that can be configured with a relative path, and the relative path calculation is based on the configuration file in which the configuration item is located, and is not affected by inheritance.

Translation of exclude.md

display: "Exclude"

oneline: "Filter `include` Options. "

In parsing include option, you need to skip the file name or file matcher list.

Important: exclude just change include The options include the file.
exclude The specified file may still be part of your code due to being import Introduced into your code, or been types Contained, or used /// <reference Introduced, or included files Middle.

It is not one deter The mechanism by which files are included in the codebase - it just changes include What the configuration item looks for.

Translation of intro.md

Header: Introduction to TSConfig

FirstLine: The TSConfig file symbolizes that the directory in which it is located is the root directory of a TypeScript project or JavaScript project...

The TSConfig file symbolizes that the directory in which it resides is the root of a TypeScript project or JavaScript project.
TSConfig files can be tsconfig.json or jsconfig.json, they are configured the same.

This page covers all the different options available in the TSConfig file. At the same time, it is not built according to the linear narrative, but is divided into 5 main parts:

A taxonomic overview of a configuration item
root fields: Tell TypeScript which files need to be processed
compilerOptions: The main content of this page
watchOptions: Configure the listening mode
typeAcquisition: Configure how JavaScript projects use types

If you are starting TSConfig from scratch, consider using it tsc --init or TSConfig base to configure.

Generated by 🚫 dangerJS against c3aa684

docs/tsconfig/zh/intro.md

Co-authored-by: Xavi Lee <[email protected]>

docs/tsconfig/zh/intro.md

Co-authored-by: Xavi Lee <[email protected]>

stevending1st · 2022-10-12T01:47:47Z

docs/tsconfig/zh/intro.md

+TSConfig 文件象征着，它所在的目录是一个 TypeScript 项目或者 JavaScript 项目的根目录。
+TSConfig 文件可以是 `tsconfig.json` 或 `jsconfig.json`，它们的配置相同。
+
+此页涵盖了 TSConfig 文件中可用的所有不同选项。同时没有按照线性叙述来构建，而是分为了5个主要部分:


Suggested change

此页涵盖了 TSConfig 文件中可用的所有不同选项。同时没有按照线性叙述来构建，而是分为了5个主要部分:

此页涵盖了 TSConfig 文件中可用的所有不同选项。同时没有按照线性叙述来构建，而是分为了 5 个主要部分:

stevending1st · 2022-10-12T01:48:27Z

docs/tsconfig/zh/intro.md


-此页涵盖了 TSConfig 文件中可用的所有不同选项。本页从每个选项的概述开始，到 JSON 文件的根属性，然后是`compilerOptions`（大部分选项），最后是 `watchOptions`。
+TSConfig 文件象征着，它所在的目录是一个 TypeScript 项目或者 JavaScript 项目的根目录。


Suggested change

TSConfig 文件象征着，它所在的目录是一个 TypeScript 项目或者 JavaScript 项目的根目录。

TSConfig 文件所在的目录是一个 TypeScript 项目或者 JavaScript 项目的根目录。

stevending1st · 2022-10-12T01:50:37Z

docs/tsconfig/zh/options/exclude.md

+在解析 [`include`](#include) 选项时，需要跳过的文件名称或文件匹配器的列表。
+
+**Important**: `exclude` _仅仅_ 改变 [`include`](#include) 选项包含的文件。
+`exclude` 指定的文件可能仍然是你代码的一部分，由于 被 `import` 引入到你的代码中，或者被 `types` 包含，或者使用 `/// <reference` 引入，或者包含在 [`files`](#files) 中。


Suggested change

`exclude` 指定的文件可能仍然是你代码的一部分，由于被 `import` 引入到你的代码中，或者被 `types` 包含，或者使用 `/// <reference` 引入，或者包含在 [`files`](#files) 中。

`exclude` 指定的文件可能仍然是你代码的一部分，由于被 `import` 引入到你的代码中，或者被 `types` 包含，或者使用 `/// <reference` 引入，或者包含在 [`files`](#files) 中。

stevending1st · 2022-10-12T01:50:57Z

docs/tsconfig/zh/options/exclude.md

+**Important**: `exclude` _仅仅_ 改变 [`include`](#include) 选项包含的文件。
+`exclude` 指定的文件可能仍然是你代码的一部分，由于 被 `import` 引入到你的代码中，或者被 `types` 包含，或者使用 `/// <reference` 引入，或者包含在 [`files`](#files) 中。
+
+它不是一种 **阻止** 文件被包含在代码库中的机制-它只是改变 [`include`](#include) 配置项查找的内容。


Suggested change

它不是一种 **阻止** 文件被包含在代码库中的机制-它只是改变 [`include`](#include) 配置项查找的内容。

它不是一种 **阻止** 文件被包含在代码库中的机制——它只是改变 [`include`](#include) 配置项查找的内容。

stevending1st · 2022-10-12T01:51:46Z

docs/tsconfig/zh/options/extends.md

+---
+
+`extends` 的值是要继承的配置文件的路径。
+路径可以使用 POSIX 风格(Linux MacOS) 或者 Windows 风格(路径中的 `\` 需要转义)。


Suggested change

路径可以使用 POSIX 风格(Linux MacOS) 或者 Windows 风格(路径中的 `\` 需要转义)。

路径可以使用 POSIX 风格（Linux MacOS）或者 Windows 风格（路径中的 `\` 需要转义）。

stevending1st · 2022-10-12T01:52:05Z

docs/tsconfig/zh/options/extends.md

+`extends` 的值是要继承的配置文件的路径。
+路径可以使用 POSIX 风格(Linux MacOS) 或者 Windows 风格(路径中的 `\` 需要转义)。
+
+TSConfig 中的配置会覆盖继承的配置。 相对路径计算是以其所在配置文件为基准，不受继承影响。


Suggested change

TSConfig 中的配置会覆盖继承的配置。相对路径计算是以其所在配置文件为基准，不受继承影响。

TSConfig 中的配置会覆盖继承的配置。相对路径计算是以其所在配置文件为基准，不受继承影响。

stevending1st · 2022-10-12T01:52:45Z

docs/tsconfig/zh/options/extends.md

+
+TSConfig 中的配置会覆盖继承的配置。 相对路径计算是以其所在配置文件为基准，不受继承影响。
+
+注意: [`files`](#files)，[`include`](#include) 和 `exclude` 会覆盖继承的配置，配置文件不允许循环继承。


Suggested change

注意: [`files`](#files)，[`include`](#include) 和 `exclude` 会覆盖继承的配置，配置文件不允许循环继承。

注意: [`files`](#files)、[`include`](#include) 和 `exclude` 会覆盖继承的配置，配置文件不允许循环继承。

stevending1st · 2022-10-12T01:53:20Z

docs/tsconfig/zh/options/extends.md

+
+[`references`](#references) 是唯一不被继承的顶级配置项。
+
+##### Example


Suggested change

##### Example

##### 示例

stevending1st · 2022-10-12T01:54:01Z

docs/tsconfig/zh/options/files.md

@@ -0,0 +1,26 @@
+---
+display: "Files"
+oneline: "一个数组，每一项是项目所需包含文件的路径。和 [`include`](#include) 不同的是， files 不支持路径匹配。"


Suggested change

oneline: "一个数组，每一项是项目所需包含文件的路径。和 [`include`](#include) 不同的是， files 不支持路径匹配。"

oneline: "一个数组，每一项是项目所需包含文件的路径。和 [`include`](#include) 不同的是，files 不支持路径匹配。"

stevending1st · 2022-10-12T01:54:54Z

docs/tsconfig/zh/options/include.md

+- `?` 匹配任何一个字符 (不包含目录分割符)
+- `**/` 匹配任何深度的目录
+
+如果匹配器不包含文件拓展名只，支持特定拓展名的文件。默认支持 `.ts`， `.tsx`和 `.d.ts`，如果开启了  [`allowJs`](#allowJs)，额外支持 `.js` 和 `.jsx`。


Suggested change

如果匹配器不包含文件拓展名只，支持特定拓展名的文件。默认支持 `.ts`， `.tsx`和 `.d.ts`，如果开启了 [`allowJs`](#allowJs)，额外支持 `.js` 和 `.jsx`。

如果匹配器不包含文件拓展名只，支持特定拓展名的文件。默认支持 `.ts`、`.tsx` 和 `.d.ts`，如果开启了 [`allowJs`](#allowJs)，额外支持 `.js` 和 `.jsx`。

i18n: tsconfig-reference top-level options to zh

635c4d8

github-actions bot added translation zh labels Aug 25, 2022

awxiaoxian2020 suggested changes Aug 26, 2022

View reviewed changes

docs/tsconfig/zh/intro.md Outdated Show resolved Hide resolved

TomVista and others added 3 commits August 26, 2022 21:00

Update half width punctuation

f4388bc

Co-authored-by: Xavi Lee <[email protected]>

Update half width punctuation

17feb91

fix: extends options zh

22d8d82

awxiaoxian2020 suggested changes Sep 23, 2022

View reviewed changes

docs/tsconfig/zh/intro.md Outdated Show resolved Hide resolved

Update docs/tsconfig/zh/intro.md

c3aa684

Co-authored-by: Xavi Lee <[email protected]>

stevending1st reviewed Oct 12, 2022

View reviewed changes

	此页涵盖了 TSConfig 文件中可用的所有不同选项。同时没有按照线性叙述来构建，而是分为了5个主要部分:
	此页涵盖了 TSConfig 文件中可用的所有不同选项。同时没有按照线性叙述来构建，而是分为了 5 个主要部分:


		此页涵盖了 TSConfig 文件中可用的所有不同选项。本页从每个选项的概述开始，到 JSON 文件的根属性，然后是`compilerOptions`（大部分选项），最后是 `watchOptions`。
		TSConfig 文件象征着，它所在的目录是一个 TypeScript 项目或者 JavaScript 项目的根目录。

	TSConfig 文件象征着，它所在的目录是一个 TypeScript 项目或者 JavaScript 项目的根目录。
	TSConfig 文件所在的目录是一个 TypeScript 项目或者 JavaScript 项目的根目录。

	`exclude` 指定的文件可能仍然是你代码的一部分，由于被 `import` 引入到你的代码中，或者被 `types` 包含，或者使用 `/// <reference` 引入，或者包含在 [`files`](#files) 中。
	`exclude` 指定的文件可能仍然是你代码的一部分，由于被 `import` 引入到你的代码中，或者被 `types` 包含，或者使用 `/// <reference` 引入，或者包含在 [`files`](#files) 中。

	它不是一种阻止文件被包含在代码库中的机制-它只是改变 [`include`](#include) 配置项查找的内容。
	它不是一种阻止文件被包含在代码库中的机制——它只是改变 [`include`](#include) 配置项查找的内容。

	路径可以使用 POSIX 风格(Linux MacOS) 或者 Windows 风格(路径中的 `\` 需要转义)。
	路径可以使用 POSIX 风格（Linux MacOS）或者 Windows 风格（路径中的 `\` 需要转义）。

	TSConfig 中的配置会覆盖继承的配置。相对路径计算是以其所在配置文件为基准，不受继承影响。
	TSConfig 中的配置会覆盖继承的配置。相对路径计算是以其所在配置文件为基准，不受继承影响。


		TSConfig 中的配置会覆盖继承的配置。相对路径计算是以其所在配置文件为基准，不受继承影响。

		注意: [`files`](#files)，[`include`](#include) 和 `exclude` 会覆盖继承的配置，配置文件不允许循环继承。

	注意: [`files`](#files)，[`include`](#include) 和 `exclude` 会覆盖继承的配置，配置文件不允许循环继承。
	注意: [`files`](#files)、[`include`](#include) 和 `exclude` 会覆盖继承的配置，配置文件不允许循环继承。


		[`references`](#references) 是唯一不被继承的顶级配置项。

		##### Example

	oneline: "一个数组，每一项是项目所需包含文件的路径。和 [`include`](#include) 不同的是， files 不支持路径匹配。"
	oneline: "一个数组，每一项是项目所需包含文件的路径。和 [`include`](#include) 不同的是，files 不支持路径匹配。"

	如果匹配器不包含文件拓展名只，支持特定拓展名的文件。默认支持 `.ts`， `.tsx`和 `.d.ts`，如果开启了 [`allowJs`](#allowJs)，额外支持 `.js` 和 `.jsx`。
	如果匹配器不包含文件拓展名只，支持特定拓展名的文件。默认支持 `.ts`、`.tsx` 和 `.d.ts`，如果开启了 [`allowJs`](#allowJs)，额外支持 `.js` 和 `.jsx`。

i18n: tsconfig-reference top-level options to zh #165

Are you sure you want to change the base?

i18n: tsconfig-reference top-level options to zh #165

Uh oh!

Conversation

TomVista commented Aug 25, 2022

Uh oh!

ghost commented Aug 25, 2022 • edited by ghost Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Aug 25, 2022

Uh oh!

github-actions bot commented Aug 25, 2022 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

oneline: "The path to the file to be compiled or the list of matchers."

oneline: "An array, each of which is the path to the included files required for the project. and include The difference is that files does not support path matching. "

oneline: "Specify a path or node module reference to configure inheritance"

Example

oneline: "Filter include Options. "

FirstLine: The TSConfig file symbolizes that the directory in which it is located is the root directory of a TypeScript project or JavaScript project...

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

ghost commented Aug 25, 2022 •

edited by ghost

Loading

github-actions bot commented Aug 25, 2022 •

edited

Loading

oneline: "An array, each of which is the path to the included files required for the project. and `include` The difference is that files does not support path matching. "

oneline: "Filter `include` Options. "