Skip to content

Commit c4bcaa4

Browse files
authored
fix: translation enhancement (vitejs#31)
1 parent 3a54719 commit c4bcaa4

File tree

13 files changed

+42
-37
lines changed

13 files changed

+42
-37
lines changed

.vitepress/config.js

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,11 @@ module.exports = {
1515
editLinks: true,
1616
editLinkText: '为此页提供修改建议',
1717

18+
/* algolia: {
19+
apiKey: '<API_KEY>',
20+
indexName: '<INDEX_NAME>'
21+
}, */
22+
1823
carbonAds: {
1924
carbon: 'CEBIEK3N',
2025
placement: 'vitejsdev'

blog/announcing-vite2.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -67,9 +67,9 @@ Vite 默认只支持原生支持 ESM 的现代浏览器,但可以通过官方
6767
npm init @vitejs/app
6868
```
6969

70-
接下来您可以
70+
接下来你可以
7171

7272
- 阅读 [指引文档](https://vitejs.dev/guide/) 了解 Vite 提供了哪些开箱即用的功能
73-
-[GitHub](https://github.com/vitejs/vite) 上访问源代码
73+
-[GitHub](https://github.com/vitejs/vite) 上访问源码
7474
-[Twitter](https://twitter.com/vite_js) 上关注最新进展
7575
- 或与其他 Vite 用户在 [Discord](http://chat.vitejs.dev/) 上一起讨论

config/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -526,7 +526,7 @@ export default ({ command, mode }) => {
526526

527527
默认情况下,Vite 会抓取你的 index.html 来检测需要预构建的依赖项。如果指定了 `build.rollupOptions.input`,Vite 将转而去抓取这些入口点。
528528

529-
如果这两者都不适合您的需要,则可以使用此选项指定自定义条目 - 该值需要遵循 [fast-glob 模式](https://github.com/mrmlnc/fast-glob#basic-syntax) ,或者是相对于 vite 项目根的模式数组。这将覆盖掉默认条目推断。
529+
如果这两者都不适合你的需要,则可以使用此选项指定自定义条目 - 该值需要遵循 [fast-glob 模式](https://github.com/mrmlnc/fast-glob#basic-syntax) ,或者是相对于 vite 项目根的模式数组。这将覆盖掉默认条目推断。
530530

531531
### optimizeDeps.exclude
532532

guide/api-hmr.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
:::tip 注意
44
这里是客户端 HMR API。若要在插件中处理 HMR 更新,详见 [handleHotUpdate](./api-plugin#handlehotupdate).
55

6-
手动 HMR API 主要用于框架和工具作者。作为最终用户,HMR 可能已经在特定于框架的启动器模板中为您处理过了
6+
手动 HMR API 主要用于框架和工具作者。作为最终用户,HMR 可能已经在特定于框架的启动器模板中为你处理过了
77
:::
88

99
Vite 通过特殊的 `import.meta.hot` 对象暴露手动 HMR API。

guide/assets.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ document.getElementById('hero-img').src = imgUrl
2020

2121
- 如果 Vite 使用了 Vue 插件,Vue SFC 模板中的资源引用都将自动转换为导入。
2222

23-
- 常见的图像、媒体和字体文件类型被自动检测为资源。您可以使用 [`assetsInclude` 选项](/config/#assetsinclude) 扩展内部列表。
23+
- 常见的图像、媒体和字体文件类型被自动检测为资源。你可以使用 [`assetsInclude` 选项](/config/#assetsinclude) 扩展内部列表。
2424

2525
- 引用的资源作为构建资源图的一部分包括在内,将生成散列文件名,并可以由插件进行处理以进行优化。
2626

@@ -64,15 +64,15 @@ import InlineWorker from './shader.js?worker&inline'
6464

6565
如果你有下列这些资源:
6666

67-
- 不会被源代码引用(例如 `robots.txt`
67+
- 不会被源码引用(例如 `robots.txt`
6868
- 必须保持原有文件名(没有经过 hash)
69-
- ...或者您只是不想为了获取 URL 而首先导入该资源
69+
- ...或者你只是不想为了获取 URL 而首先导入该资源
7070

7171
那么你可以将该资源放在一个特别的 `public` 目录中,它应位于你的项目根目录。该目录中的资源应该在开发时能直接通过 `/` 根路径访问到,并且打包时会被完整复制到目标目录的根目录下。
7272

7373
目录默认是 `<root>/public`,但可以通过 [`publicDir` 选项](/config/#publicdir) 来配置。
7474

7575
请注意:
7676

77-
- 引入 `public` 中的资源永远应该使用根绝对路径 - 举个例子,`public/icon.png` 应该在源代码中被引用为 `/icon.png`
77+
- 引入 `public` 中的资源永远应该使用根绝对路径 - 举个例子,`public/icon.png` 应该在源码中被引用为 `/icon.png`
7878
- `public` 中的资源不应该被 JavaScript 文件引用。

guide/build.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,7 @@
2323

2424
- 相关内容:[静态资源处理](./assets)
2525

26-
如果您正在嵌套的公共路径下部署项目,可以简单指定一个 [`build.base` 配置项](/config/#base) 然后所有资源的路径都将据此重写。这个选项也可以通过命令行参数指定,例如 `vite build --base=/my/public/path/`
26+
如果你正在嵌套的公共路径下部署项目,可以简单指定一个 [`build.base` 配置项](/config/#base) 然后所有资源的路径都将据此重写。这个选项也可以通过命令行参数指定,例如 `vite build --base=/my/public/path/`
2727

2828
由 JS 导入的资源路径,CSS 中的 `url()` 引用,和 `.html` 文件中的资源引用在构建过程中都会自动调整以适配此选项。
2929

@@ -44,7 +44,7 @@ module.exports = {
4444
}
4545
```
4646

47-
例如,您可以使用仅在构建期间应用的插件来指定多个 Rollup 输出。
47+
例如,你可以使用仅在构建期间应用的插件来指定多个 Rollup 输出。
4848

4949
## 多页面应用模式
5050

@@ -82,7 +82,7 @@ module.exports = {
8282

8383
## 库模式
8484

85-
当您开发面向浏览器的库时,您可能会将大部分时间花在该库的测试/演示页面上。使用 Vite,你可以使用 `index.html` 来获得如丝般顺滑的开发体验。
85+
当你开发面向浏览器的库时,你可能会将大部分时间花在该库的测试/演示页面上。使用 Vite,你可以使用 `index.html` 来获得如丝般顺滑的开发体验。
8686

8787
当需要构建你的库用于发布时,请使用 [`build.lib` 配置项](/config/#build-lib),请确保将你不想打包进你库中的依赖进行外部化,例如 `vue``react`
8888

guide/comparisons.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -39,7 +39,7 @@ Vite 最初是作为 [Vue.js](https://vuejs.org/) 开发工具的未来基础而
3939

4040
Preact 团队的 [WMR](https://github.com/preactjs/wmr) 提供了类似的特性集,而 Vite 2.0 对 Rollup 插件接口的支持正是受到了它的启发。
4141

42-
WMR 主要是为了 [Preact](https://preactjs.com/) 项目而设计,并为其提供了集成度更高的功能,比如预渲染。就使用范围而言,它更加贴合于 Preact 框架,与 Preact 本身一样强调紧凑的大小。如果您正在使用 Preact,那么 WMR 可能会提供更好的体验。然而,WMR 不太可能优先支持其他框架。
42+
WMR 主要是为了 [Preact](https://preactjs.com/) 项目而设计,并为其提供了集成度更高的功能,比如预渲染。就使用范围而言,它更加贴合于 Preact 框架,与 Preact 本身一样强调紧凑的大小。如果你正在使用 Preact,那么 WMR 可能会提供更好的体验。然而,WMR 不太可能优先支持其他框架。
4343

4444
## @web/dev-server
4545

guide/dep-pre-bundling.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -30,20 +30,20 @@ Pre-bundling them to speed up dev server page load...(将预构建它们以提
3030

3131
## 自动依赖搜寻
3232

33-
如果没有找到存在的缓存,Vite 将抓取你的源代码,并自动发现依赖项导入(即
33+
如果没有找到存在的缓存,Vite 将抓取你的源码,并自动发现依赖项导入(即
3434
"裸引入",期望从 `node_modules` 解析),并使用这些发现的导入作为预构建包的入口点。预绑定是用 `esbuild` 执行的,所以它通常非常快。
3535

3636
在服务器已经启动之后,如果在缓存中没有遇到新的依赖项导入,Vite 将重新运行依赖构建进程并重新加载页面。
3737

3838
## Monorepo 和链接依赖
3939

40-
在一个 monorepo 启动中,该仓库中的某个依赖可能会成为另一个包的依赖。Vite 会自动侦测没有从 `node_modules` 解析的依赖项,并将链接的依赖视为源代码。它不会尝试打包被链接的依赖,而是会分析被链接依赖的依赖列表。
40+
在一个 monorepo 启动中,该仓库中的某个依赖可能会成为另一个包的依赖。Vite 会自动侦测没有从 `node_modules` 解析的依赖项,并将链接的依赖视为源码。它不会尝试打包被链接的依赖,而是会分析被链接依赖的依赖列表。
4141

4242
## 自定义行为
4343

44-
默认的依赖项发现为启发式可能并不总是可取的。在您想要显式地从列表中包含/排除依赖项的情况下, 请使用 [`optimizeDeps` 配置项](/config/#依赖优化选项)
44+
默认的依赖项发现为启发式可能并不总是可取的。在你想要显式地从列表中包含/排除依赖项的情况下, 请使用 [`optimizeDeps` 配置项](/config/#依赖优化选项)
4545

46-
一个典型的用例对 `optimizeDeps.include``optimizeDeps.exclude` 是当您有一个不能直接在源代码中发现的导入时。例如,导入可能是插件转换的结果。这意味着 Vite 无法在初始扫描时发现导入 —— 它只能在浏览器请求文件并进行转换后发现它。这将导致服务器在启动后立即重新打包。
46+
一个典型的用例对 `optimizeDeps.include``optimizeDeps.exclude` 是当你有一个不能直接在源码中发现的导入时。例如,导入可能是插件转换的结果。这意味着 Vite 无法在初始扫描时发现导入 —— 它只能在浏览器请求文件并进行转换后发现它。这将导致服务器在启动后立即重新打包。
4747

4848
`include``exclude` 都可以用来处理这个问题。如果依赖项很大(包含很多内部模块)或者是 CommonJS,那么你应该包含它;如果依赖项很小,并且已经是有效的 ESM,则可以排除它,让浏览器直接加载它。
4949

guide/env-and-mode.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ Vite 使用 [dotenv](https://github.com/motdotla/dotenv) 在你的项目根目
3333
.env.[mode].local # 只在指定模式下加载,但会被 git 忽略
3434
```
3535

36-
加载的环境变量也会通过 `import.meta.env` 暴露给客户端源代码
36+
加载的环境变量也会通过 `import.meta.env` 暴露给客户端源码
3737

3838
为了防止意外地将一些环境变量泄漏到客户端,只有以 `VITE_` 为前缀的变量才会暴露给经过 vite 处理的代码。例如下面这个文件中:
3939

@@ -42,13 +42,13 @@ DB_PASSWORD=foobar
4242
VITE_SOME_KEY=123
4343
```
4444

45-
只有 `VITE_SOME_KEY` 会被暴露为 `import.meta.env.VITE_SOME_KEY` 提供给客户端源代码,而 `DB_PASSWORD` 则不会。
45+
只有 `VITE_SOME_KEY` 会被暴露为 `import.meta.env.VITE_SOME_KEY` 提供给客户端源码,而 `DB_PASSWORD` 则不会。
4646

4747
:::warning 安全警告
4848

4949
- `.env.*.local` 文件应是本地的,可以包含敏感变量。你应该加上 `.local` 到你的 `.gitignore` 以避免他们被检出到 git。
5050

51-
- 由于暴露在 Vite 源代码中的任何变量都将最终出现在客户端包中`VITE_*` 变量应该不包含任何敏感信息。
51+
- 由于暴露在 Vite 源码中的任何变量都将最终出现在客户端包中`VITE_*` 变量应该不包含任何敏感信息。
5252

5353
:::
5454

@@ -65,9 +65,9 @@ VITE_APP_TITLE=My App
6565

6666
在你的应用中,你可以使用 `import.meta.env.VITE_APP_TITLE` 作为渲染标题。
6767

68-
然而重要的是,要理解**模式**是一个更广泛的概念,而不仅仅是开发和生产。一个典型的例子是,您可能希望有一个 “staging” 模式,它应该具有类似于生产的行为,但环境变量与生产环境略有不同。
68+
然而重要的是,要理解**模式**是一个更广泛的概念,而不仅仅是开发和生产。一个典型的例子是,你可能希望有一个 “staging” 模式,它应该具有类似于生产的行为,但环境变量与生产环境略有不同。
6969

70-
您可以通过传递 `--mode` 选项标志来覆盖命令使用的默认模式。例如,如果你想为我们假设的 staging 模式构建应用:
70+
你可以通过传递 `--mode` 选项标志来覆盖命令使用的默认模式。例如,如果你想为我们假设的 staging 模式构建应用:
7171

7272
```bash
7373
vite build --mode staging

guide/features.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ Vite 为 Sass 和 Less 改进了 `@import` 解析,因而 Vite 别名也同样
145145

146146
由于与其 API 冲突,`@import` 别名和 URL 变基不支持 Stylus。
147147

148-
您还可以通过在文件扩展名前加上 `.module` 来结合使用 CSS modules 和预处理器,例如 `style.module.scss`
148+
你还可以通过在文件扩展名前加上 `.module` 来结合使用 CSS modules 和预处理器,例如 `style.module.scss`
149149

150150
## 静态资源处理
151151

0 commit comments

Comments
 (0)