Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs(en): merge docs-cn/sync-docs into docs-cn/dev @ 8944e1d1 #816

Merged
merged 6 commits into from
Aug 25, 2023
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 2 additions & 3 deletions config/build-options.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,7 +83,7 @@ modulePreload: {
## build.assetsInlineLimit {#build-assetsinlinelimit}

- **类型:** `number`
- **默认:** `4096` (4kb)
- **默认:** `4096` (4 KiB)

小于此阈值的导入或引用资源将内联为 base64 编码,以避免额外的 http 请求。设置为 `0` 可以完全禁用此项。

Expand Down Expand Up @@ -218,7 +218,6 @@ npm add -D terser

## build.copyPublicDir {#build-copypublicdir}

- **实验性:** [提供反馈](https://github.com/vitejs/vite/discussions/13807)
- **类型:** `boolean`
- **默认:** `true`

Expand All @@ -236,7 +235,7 @@ npm add -D terser
- **类型:** `number`
- **默认:** `500`

规定触发警告的 chunk 大小。(以 kbs 为单位)。它将与未压缩的 chunk 大小进行比较,因为 [JavaScript 大小本身与执行时间相关](https://v8.dev/blog/cost-of-javascript-2019)。
规定触发警告的 chunk 大小。(以 kB 为单位)。它将与未压缩的 chunk 大小进行比较,因为 [JavaScript 大小本身与执行时间相关](https://v8.dev/blog/cost-of-javascript-2019)。

## build.watch {#build-watch}

Expand Down
2 changes: 1 addition & 1 deletion guide/backend-integration.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@

这对于图片等资源的正确加载是必需的。

如果你正使用 `@vitejs/plugin-react` 配合 React,你还需要在上述脚本前添加下面这个,因为插件不能修改你正在服务的 HTML:
如果你正使用 `@vitejs/plugin-react` 配合 React,你还需要在上述脚本前添加下面这个,因为插件不能修改你正在服务的 HTML(请将 `http://localhost:5173` 替换为 Vite 正在运行的本地 URL)

```html
<script type="module">
Expand Down
10 changes: 7 additions & 3 deletions guide/build.md
Original file line number Diff line number Diff line change
Expand Up @@ -168,8 +168,8 @@ export { Foo, Bar }
```
$ vite build
building for production...
dist/my-lib.js 0.08 KiB / gzip: 0.07 KiB
dist/my-lib.umd.cjs 0.30 KiB / gzip: 0.16 KiB
dist/my-lib.js 0.08 kB / gzip: 0.07 kB
dist/my-lib.umd.cjs 0.30 kB / gzip: 0.16 kB
```

推荐在你库的 `package.json` 中使用如下格式:
Expand Down Expand Up @@ -212,14 +212,18 @@ dist/my-lib.umd.cjs 0.30 KiB / gzip: 0.16 KiB
}
```

::: tip 注意
::: tip 文件扩展名
如果 `package.json` 不包含 `"type": "module"`,Vite 会生成不同的文件后缀名以兼容 Node.js。`.js` 会变为 `.mjs` 而 `.cjs` 会变为 `.js` 。
:::

::: tip 环境变量
在库模式下,所有 `import.meta.env.*` 用法在构建生产时都会被静态替换。但是,`process.env.*` 的用法不会被替换,所以你的库的使用者可以动态地更改它。如果不想允许他们这样做,你可以使用 `define: { 'process.env.NODE_ENV': '"production"' }` 例如静态替换它们。
:::

::: warning 进阶用法
库模式包括了一种简单而又有见地的配置,适用于面向浏览器和 JS 框架的库。如果你正在构建非面向浏览器的库,或需要高级构建流程,可以直接使用 [Rollup](https://rollupjs.org) 或 [esbuild](https://esbuild.github.io)。
:::

## 进阶基础路径选项 {#advanced-base-options}

::: warning
Expand Down