Revise translation of js-with-ts (#92)

ts-zh-docs · Oct 12, 2024 · 539346d · 539346d
1 parent 77c9ba3
commit 539346d
Showing 1 changed file with 9 additions and 12 deletions.
diff --git a/docs/documentation/zh/javascript/Intro to JS with TS.md b/docs/documentation/zh/javascript/Intro to JS with TS.md
@@ -9,23 +9,22 @@ translatable: true
 在一般的代码中，TypeScript 中的类型系统的严格程度是不一样的：
 
 - 只基于 JavaScript 代码推断
-- 增强的  JavaScript 类型推断（[通过  JSDoc](/zh/docs/handbook/jsdoc-supported-types.html)）
+- 增强的 JavaScript 类型推断（[通过 JSDoc](/zh/docs/handbook/jsdoc-supported-types.html)）
 - 在 JavaScript 文件里面使用 `// @ts-check` 
 - TypeScript 代码
-- TypeScript 的 [`strict`](/tsconfig#strict) 模式
+- TypeScript 的 [`strict`](/zh/tsconfig#strict) 模式
 
 每一步都代表着向更安全的类型系统迈进，但并不是每个项目都需要级别最高的验证。
 
 ## TypeScript 与 JavaScript
 
-在使用某些编辑器时，它可以为使用 TypeScript 提供工具，如自动补全，跳转到特定位置。还有一些重构工具，如重命名。
-[主页](/) 有一个包含 TypeScript 插件的编辑器列表。
+某些编辑器会使用 TypeScript 来提供帮助，如自动补全，跳转到特定位置。此外还可以帮助重构，如重命名。[主页](/zh)有一个编辑器列表，该列表中的编辑器包含 TypeScript 插件。
 
 ## 通过 JSDoc 在 JS 中提供类型提示
 
 在 `.js` 文件里，类型通常可以被推断出来。当无法推断类型时，可以使用 JSDoc 语法来指定。
 
-声明之前的 JSDoc 注释，将用于设置该声明的类型。例如：
+位于声明语句之前的 JSDoc 注释，将用于设置该声明的类型。例如：
 
 ```js twoslash
 /** @type {number} */
@@ -35,12 +34,11 @@ x = 0; // OK
 x = false; // OK?!
 ```
 
-你可以[在 JSDoc 支持的类型列表](/zh/docs/handbook/jsdoc-supported-types.html)找到支持的 JSDoc 模式的完整说明。
+你可以在 [JSDoc 支持的类型列表](/zh/docs/handbook/jsdoc-supported-types.html)找到受支持的 JSDoc 语法的完整说明。
 
 ## `@ts-check`
 
-上述代码示例的最后一行会在 TypeScript 中引发错误，但在 JS 项目中，默认情况下不会引发错误。
-要在 JavaScript 文件显示错误，请在 `.js` 文件的第一行中添加： `// @ts-check`。
+上述代码示例的最后一行在 TypeScript 中会引发错误，但在 JS 项目中，默认情况下不会引发错误。要使 JavaScript 文件显示错误，请在 `.js` 文件的第一行中添加： `// @ts-check`。
 
 ```js twoslash
 // @ts-check
@@ -52,10 +50,9 @@ x = 0; // OK
 x = false; // Not OK
 ```
 
-如果你有许多 JavaScript 文件要显示错误，则可以使用 [`jsconfig.json`](/zh/docs/handbook/tsconfig-json.html) 来代替注释。
-你可以通过在文件中添加`// @ts-nocheck` 注释来跳过检查某些文件。
+如果你有许多 JavaScript 文件要显示错误，则可以使用 [`jsconfig.json`](/zh/docs/handbook/tsconfig-json.html) 来代替注释。你可以通过在文件中添加 `// @ts-nocheck` 注释来跳过检查某些文件。
 
-TypeScript 可能会提供你不想看到的错误，在这种情况下，你可以通过在前一行添加 `// @ts-ignore` 或 `// @ts-expect-error` 来忽略某一行上的错误。
+TypeScript 可能会提供一些你不想看到的错误，在这种情况下，你可以通过在某一行的前一行添加 `// @ts-ignore` 或 `// @ts-expect-error` 来忽略该行上的错误。
 
 ```js twoslash
 // @ts-check
@@ -67,4 +64,4 @@ x = 0; // OK
 x = false; // Not OK
 ```
 
-要了解有关 TypeScript 如何解释 JavaScript 的更多信息，请阅读 [TS 是如何解释 JS 的](/zh/docs/handbook/type-checking-javascript-files.html)。
+要详细了解 TypeScript 如何解释 JavaScript，请阅读 [TS 是如何检查 JS 的](/zh/docs/handbook/type-checking-javascript-files.html)。