From 736298822afde47401a2c2255c18c898f04078f0 Mon Sep 17 00:00:00 2001 From: huzhengen Date: Thu, 11 Apr 2024 17:58:23 +0800 Subject: [PATCH 01/14] docs: update guide/index.md --- guide/index.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/index.md b/guide/index.md index f64c8588..0a4f2635 100644 --- a/guide/index.md +++ b/guide/index.md @@ -72,7 +72,7 @@ $ bun create vite 你还可以通过附加的命令行选项直接指定项目名称和你想要使用的模板。例如，要构建一个 Vite + Vue 项目，运行: ```bash -# npm 7+, extra double-dash is needed: +# npm 7+, 需要额外加 --: npm create vite@latest my-vue-app -- --template vue # yarn From 38522053c7d07f45618c9afb156ad48262e5dbdf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9C=9B?= <1501034130@qq.com> Date: Sat, 13 Apr 2024 13:26:52 +0800 Subject: [PATCH 02/14] Update static-deploy.md Missing slash --- guide/static-deploy.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/static-deploy.md b/guide/static-deploy.md index c2cb1b7f..89a342b2 100644 --- a/guide/static-deploy.md +++ b/guide/static-deploy.md @@ -60,7 +60,7 @@ $ npm run preview 如果你正要部署到 `https://.github.io/`，或者通过 GitHub Pages 部署到一个自定义域名（例如 `www.example.com`），请将 `base` 设置为 `'/'`。或者，你也可以从配置中移除 `base`，因为它默认为 `'/'`。 - 如果你正在部署到 `https://.github.io//`（例如你的仓库地址为 `https://github.com/`），那么请将 `base` 设置为 `'//'`。 + 如果你正在部署到 `https://.github.io//`（例如你的仓库地址为 `https://github.com//`），那么请将 `base` 设置为 `'//'`。 2. 进入仓库 settings 页面的 GitHub Pages 配置，选择部署来源为“GitHub Actions”，这将引导你创建一个构建和部署项目的工作流程，我们提供了一个安装依赖项和使用 npm 构建的工作流程样本： From 4626f9b8bcadf79a6079f488dba8d137a1a1a467 Mon Sep 17 00:00:00 2001 From: ShenQingchuan Date: Fri, 26 Apr 2024 22:58:17 +0800 Subject: [PATCH 03/14] chore: remove viteconf23 badge --- index.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/index.md b/index.md index 405c7dc1..a8b07498 100644 --- a/index.md +++ b/index.md @@ -21,9 +21,6 @@ hero: - theme: alt text: 在 GitHub 上查看 link: https://github.com/vitejs/vite - - theme: brand - text: 🎉 ViteConf 23! - link: https://viteconf.org/23/replay?utm=vite-homepage features: - icon: 💡 @@ -53,4 +50,4 @@ import { fetchReleaseTag } from './.vitepress/utils/fetchReleaseTag.js' onMounted(() => { fetchReleaseTag() }) - \ No newline at end of file + From 4a160bcf59449e161eaaa39e11252e0c74c79b02 Mon Sep 17 00:00:00 2001 From: Leedom <30711792+leedom92@users.noreply.github.com> Date: Thu, 9 May 2024 00:49:48 +0800 Subject: [PATCH 04/14] fix: typo --- guide/features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/features.md b/guide/features.md index 4f2b8926..073c6de3 100644 --- a/guide/features.md +++ b/guide/features.md @@ -112,7 +112,7 @@ Vite 默认不会转译 TypeScript，而是使用 `esbuild` 的默认行为。 - [`alwaysStrict`](https://www.typescriptlang.org/tsconfig#alwaysStrict) ::: tip `skipLibCheck` -Vite 启动模板默认情况下会设置 `"skipLibCheck": "true"`，以避免对依赖项进行类型检查，因为它们可能只支持特定版本和配置的 TypeScript。你可以在 [vuejs/vue-cli#5688](https://github.com/vuejs/vue-cli/pull/5688)。 +Vite 启动模板默认情况下会设置 `"skipLibCheck": "true"`，以避免对依赖项进行类型检查，因为它们可能只支持特定版本和配置的 TypeScript。你可以在 [vuejs/vue-cli#5688](https://github.com/vuejs/vue-cli/pull/5688) 了解更多信息。 ::: ### 客户端类型 {#client-types} From bf29aaf7c2ae53829ae8de0bd39730bc3fd43894 Mon Sep 17 00:00:00 2001 From: Leedom <30711792+leedom92@users.noreply.github.com> Date: Wed, 15 May 2024 21:33:45 +0800 Subject: [PATCH 05/14] docs(cn): translate --- guide/features.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/features.md b/guide/features.md index cb0d3db5..5cc48617 100644 --- a/guide/features.md +++ b/guide/features.md @@ -166,7 +166,7 @@ Vite 为 Vue 提供第一优先级支持： - Vue 3 单文件组件支持：[@vitejs/plugin-vue](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue) - Vue 3 JSX 支持：[@vitejs/plugin-vue-jsx](https://github.com/vitejs/vite-plugin-vue/tree/main/packages/plugin-vue-jsx) - Vue 2.7 SFC 支持：[@vitejs/plugin-vue2](https://github.com/vitejs/vite-plugin-vue2) -- Vue 2.7 JSX support via [@vitejs/plugin-vue2-jsx](https://github.com/vitejs/vite-plugin-vue2-jsx) +- Vue 2.7 JSX 支持：[@vitejs/plugin-vue2-jsx](https://github.com/vitejs/vite-plugin-vue2-jsx) ## JSX {#jsx} From e75f81c62b7c0a37e58c22562c32ece0c222f008 Mon Sep 17 00:00:00 2001 From: heappynd Date: Wed, 22 May 2024 20:47:25 +0800 Subject: [PATCH 06/14] docs(env-and-mode): translate node-env-and-modes --- guide/env-and-mode.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/guide/env-and-mode.md b/guide/env-and-mode.md index 4323c16a..55f64fc4 100644 --- a/guide/env-and-mode.md +++ b/guide/env-and-mode.md @@ -153,9 +153,9 @@ VITE_APP_TITLE=My App (staging) NODE_ENV=development ``` -## NODE_ENV and Modes +## NODE_ENV 和 模式 {#NODE_ENV and Modes} -It's important to note that `NODE_ENV` (`process.env.NODE_ENV`) and modes are two different concepts. Here's how different commands affect the `NODE_ENV` and mode: +需要注意的是，`NODE_ENV`（`process.env.NODE_ENV`）和模式是两个不同的概念。以下是不同命令如何影响 `NODE_ENV` 和模式： | Command | NODE_ENV | Mode | | ---------------------------------------------------- | --------------- | --------------- | @@ -164,7 +164,7 @@ It's important to note that `NODE_ENV` (`process.env.NODE_ENV`) and modes are tw | `NODE_ENV=development vite build` | `"development"` | `"production"` | | `NODE_ENV=development vite build --mode development` | `"development"` | `"development"` | -The different values of `NODE_ENV` and mode also reflect on its corresponding `import.meta.env` properties: +`NODE_ENV` 和模式的不同值也会反映在相应的 `import.meta.env` 属性上： | Command | `import.meta.env.PROD` | `import.meta.env.DEV` | | ---------------------- | ---------------------- | --------------------- | @@ -178,9 +178,9 @@ The different values of `NODE_ENV` and mode also reflect on its corresponding `i | `--mode development` | `"development"` | | `--mode staging` | `"staging"` | -:::tip `NODE_ENV` in `.env` files +:::tip `.env` 文件中的 `NODE_ENV` -`NODE_ENV=...` can be set in the command, and also in your `.env` file. If `NODE_ENV` is specified in a `.env.[mode]` file, the mode can be used to control its value. However, both `NODE_ENV` and modes remain as two different concepts. +`NODE_ENV=...` 可以在命令中设置，也可以在 `.env` 文件中设置。如果在`.env.[mode]`文件中指定了`NODE_ENV`，则可以使用模式来控制其值。不过，`NODE_ENV` 和模式仍然是两个不同的概念。 -The main benefit with `NODE_ENV=...` in the command is that it allows Vite to detect the value early. It also allows you to read `process.env.NODE_ENV` in your Vite config as Vite can only load the env files once the config is evaluated. +命令中使用 `NODE_ENV=...` 的主要好处是，它允许 Vite 提前检测到该值。这也使你能够在 Vite 配置中读取 `process.env.NODE_ENV`，因为 Vite 只有在解析配置之后才能加载环境变量文件。 ::: From bae0396c3e99d3b6a79921b663d0e21446a14170 Mon Sep 17 00:00:00 2001 From: waynzh Date: Fri, 24 May 2024 10:01:22 +0800 Subject: [PATCH 07/14] docs(cn): format --- guide/env-and-mode.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/env-and-mode.md b/guide/env-and-mode.md index 55f64fc4..c3e9baef 100644 --- a/guide/env-and-mode.md +++ b/guide/env-and-mode.md @@ -153,7 +153,7 @@ VITE_APP_TITLE=My App (staging) NODE_ENV=development ``` -## NODE_ENV 和 模式 {#NODE_ENV and Modes} +## NODE_ENV 和 模式 {#node-env-and-modes} 需要注意的是，`NODE_ENV`（`process.env.NODE_ENV`）和模式是两个不同的概念。以下是不同命令如何影响 `NODE_ENV` 和模式： @@ -180,7 +180,7 @@ NODE_ENV=development :::tip `.env` 文件中的 `NODE_ENV` -`NODE_ENV=...` 可以在命令中设置，也可以在 `.env` 文件中设置。如果在`.env.[mode]`文件中指定了`NODE_ENV`，则可以使用模式来控制其值。不过，`NODE_ENV` 和模式仍然是两个不同的概念。 +`NODE_ENV=...` 可以在命令中设置，也可以在 `.env` 文件中设置。如果在 `.env.[mode]` 文件中指定了 `NODE_ENV`，则可以使用模式来控制其值。不过，`NODE_ENV` 和模式仍然是两个不同的概念。 命令中使用 `NODE_ENV=...` 的主要好处是，它允许 Vite 提前检测到该值。这也使你能够在 Vite 配置中读取 `process.env.NODE_ENV`，因为 Vite 只有在解析配置之后才能加载环境变量文件。 ::: From 6357fa2d1882f58843c57cc409d722660429ceb9 Mon Sep 17 00:00:00 2001 From: amonduuuul <92299558+yuemeng200@users.noreply.github.com> Date: Mon, 15 Jul 2024 23:39:35 +0800 Subject: [PATCH 08/14] Update why.md MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 翻译与原文不符，理解困难。 --- guide/why.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guide/why.md b/guide/why.md index ad7511fd..dbd63327 100644 --- a/guide/why.md +++ b/guide/why.md @@ -33,7 +33,7 @@ import esmSvg from '../images/esm.svg?raw' ### 缓慢的更新 {#slow-updates} -基于打包器启动时，重建整个包的效率很低。原因显而易见：因为这样更新速度会随着应用体积增长而直线下降。 +基于打包启动时，当源文件被修改后，重新构建整个包是低效的，原因显而易见：更新速度会随着应用体积的增加而线性下降。 一些打包器的开发服务器将构建内容存入内存，这样它们只需要在文件更改时使模块图的一部分失活[[1]](#footnote-1)，但它也仍需要整个重新构建并重载页面。这样代价很高，并且重新加载页面会消除应用的当前状态，所以打包器支持了动态模块热替换（HMR）：允许一个模块 “热替换” 它自己，而不会影响页面其余部分。这大大改进了开发体验 —— 然而，在实践中我们发现，即使采用了 HMR 模式，其热更新速度也会随着应用规模的增长而显著下降。 From 88dff9b2092973538f0e2ea0c6e804c5655ce40f Mon Sep 17 00:00:00 2001 From: thinkasany <480968828@qq.com> Date: Mon, 22 Jul 2024 17:49:34 +0800 Subject: [PATCH 09/14] chore(packageManager): lock in pnpm@8.9.0 --- package.json | 1 + 1 file changed, 1 insertion(+) diff --git a/package.json b/package.json index 2367335c..dd901f27 100644 --- a/package.json +++ b/package.json @@ -20,6 +20,7 @@ "vite": "^5.1.6", "yorkie": "^2.0.0" }, + "packageManager": "pnpm@8.9.0", "scripts": { "dev": "vitepress dev .", "build": "vitepress build .", From 29aaec35ffb52f586a1af4baa954d7908d58e869 Mon Sep 17 00:00:00 2001 From: thinkasany <480968828@qq.com> Date: Mon, 22 Jul 2024 18:00:12 +0800 Subject: [PATCH 10/14] docs: improve descriptions --- guide/static-deploy.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/guide/static-deploy.md b/guide/static-deploy.md index 0dd62b8b..413cf1a9 100644 --- a/guide/static-deploy.md +++ b/guide/static-deploy.md @@ -183,7 +183,7 @@ $ ntl deploy --prod 4. 点击 **部署** 5. 你的 Vite 应用就部署完成了！ -在你的项目被导入和部署后，所有对生产分支以外的其他分支（可能来自合并请求）的后续推送都会生成 [预览部署](https://docs.netlify.com/site-deploys/deploy-previews/)，所有对生产分支（通常是 “main”）都会生成一个 [生产部署](https://docs.netlify.com/site-deploys/overview/#definitions)。 +在你的项目被导入和部署后，所有对生产分支以外的其他分支（可能来自合并请求）的后续推送都会生成 [预览部署](https://docs.netlify.com/site-deploys/deploy-previews/)，所有对生产分支（通常是 "main"）的更改都会生成一个 [生产部署](https://docs.netlify.com/site-deploys/overview/#definitions)。 ## Vercel {#vercel} @@ -208,7 +208,7 @@ Vercel CLI 3. Vercel 会检测到你正在使用 Vite，并会为你的部署开启相应的正确配置。 4. 你的应用被部署好了！（示例：[vite-vue-template.vercel.app](https://vite-vue-template.vercel.app/)） -在你的项目被导入和部署后，所有对分支的后续推送都会生成 [预览部署](https://vercel.com/docs/concepts/deployments/environments#preview)，而所有对生产分支（通常是“main”）的更改都会生成一个 [生产构建](https://vercel.com/docs/concepts/deployments/environments#production) +在你的项目被导入和部署后，所有对分支的后续推送都会生成 [预览部署](https://vercel.com/docs/concepts/deployments/environments#preview)，而所有对生产分支（通常是"main"）的更改都会生成一个 [生产构建](https://vercel.com/docs/concepts/deployments/environments#production) 查看 Vercel 的 [Git 集成](https://vercel.com/docs/concepts/git) 了解更多细节。 From 8e18f6268e893e1402b116aa18c4977f753e3799 Mon Sep 17 00:00:00 2001 From: Kylin <1159469891@qq.com> Date: Tue, 23 Jul 2024 11:32:24 +0800 Subject: [PATCH 11/14] docs: using template strings --- config/build-options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/build-options.md b/config/build-options.md index ef171215..b339d51a 100644 --- a/config/build-options.md +++ b/config/build-options.md @@ -32,7 +32,7 @@ import 'vite/modulepreload-polyfill' 此 polyfill 可以通过 `{ polyfill: false }` 来禁用。 -每个动态导入要预加载的块列表将由 Vite 计算。默认情况下，在载入这些依赖时，会使用一个包含 `base` 的绝对路径。如果 `base` 是相对路径（`''` 或者 './'），解析时则会使用 `import.meta.url`，以避免出现依赖于最终部署基路径的绝对路径。 +每个动态导入要预加载的块列表将由 Vite 计算。默认情况下，在载入这些依赖时，会使用一个包含 `base` 的绝对路径。如果 `base` 是相对路径（`''` 或者`'./'`），解析时则会使用 `import.meta.url`，以避免出现依赖于最终部署基路径的绝对路径。 目前有一个实验性功能支持使用 `resolveDependencies` 函数对依赖项列表及其路径进行细粒度控制。可以在这里 [提供反馈](https://github.com/vitejs/vite/discussions/13841)。它期望接收一个 `ResolveModulePreloadDependenciesFn` 类型的函数: From 0dfb792f4ddbdd9178c2e7adaa7791a897412d9b Mon Sep 17 00:00:00 2001 From: LeviDing Date: Thu, 25 Jul 2024 17:46:16 +0800 Subject: [PATCH 12/14] =?UTF-8?q?fix:=20shared-options.md=20=E7=BF=BB?= =?UTF-8?q?=E8=AF=91=E9=94=99=E8=AF=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- config/shared-options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/shared-options.md b/config/shared-options.md index 85f3749d..aac089fa 100644 --- a/config/shared-options.md +++ b/config/shared-options.md @@ -18,7 +18,7 @@ 开发或生产环境服务的公共基础路径。合法的值包括以下几种： - 绝对 URL 路径名，例如 `/foo/` -- 完整的 URL，例如 `https://foo.com/`（原始的部分在开发环境中不会被使用） +- 完整的 URL，例如 `https://foo.com/`（域名部分在开发环境中不会被使用，因此该值与 `/foo/` 相同） - 空字符串或 `./`（用于嵌入形式的开发） 更多信息详见 [公共基础路径](/guide/build#public-base-path)。 From ae53ab482698e9e1c6b0d4e547ad420c699093f3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=B2=88=E9=9D=92=E5=B7=9D?= <46062972+ShenQingchuan@users.noreply.github.com> Date: Sat, 27 Jul 2024 00:32:28 +0800 Subject: [PATCH 13/14] Update config/shared-options.md --- config/shared-options.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/config/shared-options.md b/config/shared-options.md index aac089fa..d0fe27df 100644 --- a/config/shared-options.md +++ b/config/shared-options.md @@ -18,7 +18,7 @@ 开发或生产环境服务的公共基础路径。合法的值包括以下几种： - 绝对 URL 路径名，例如 `/foo/` -- 完整的 URL，例如 `https://foo.com/`（域名部分在开发环境中不会被使用，因此该值与 `/foo/` 相同） +- 完整的 URL，例如 `https://bar.com/foo/ `（域名部分在开发环境中不会被使用，因此该值与 `/foo/` 相同） - 空字符串或 `./`（用于嵌入形式的开发） 更多信息详见 [公共基础路径](/guide/build#public-base-path)。 From daf073e1d60fcda5166228bdf908c4f07473c98e Mon Sep 17 00:00:00 2001 From: waynzh Date: Sun, 4 Aug 2024 18:35:57 +0800 Subject: [PATCH 14/14] docs(cn): format --- config/build-options.md | 2 +- guide/index.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/config/build-options.md b/config/build-options.md index b339d51a..2c7e51b7 100644 --- a/config/build-options.md +++ b/config/build-options.md @@ -32,7 +32,7 @@ import 'vite/modulepreload-polyfill' 此 polyfill 可以通过 `{ polyfill: false }` 来禁用。 -每个动态导入要预加载的块列表将由 Vite 计算。默认情况下，在载入这些依赖时，会使用一个包含 `base` 的绝对路径。如果 `base` 是相对路径（`''` 或者`'./'`），解析时则会使用 `import.meta.url`，以避免出现依赖于最终部署基路径的绝对路径。 +每个动态导入要预加载的块列表将由 Vite 计算。默认情况下，在载入这些依赖时，会使用一个包含 `base` 的绝对路径。如果 `base` 是相对路径（`''` 或者 `'./'`），解析时则会使用 `import.meta.url`，以避免出现依赖于最终部署基路径的绝对路径。 目前有一个实验性功能支持使用 `resolveDependencies` 函数对依赖项列表及其路径进行细粒度控制。可以在这里 [提供反馈](https://github.com/vitejs/vite/discussions/13841)。它期望接收一个 `ResolveModulePreloadDependenciesFn` 类型的函数: diff --git a/guide/index.md b/guide/index.md index bbf961de..2e510263 100644 --- a/guide/index.md +++ b/guide/index.md @@ -74,7 +74,7 @@ $ bun create vite ::: code-group ```bash [NPM] -# npm 7+, 需要额外加 --: +# npm 7+，需要添加额外的 --： $ npm create vite@latest my-vue-app -- --template vue ```