Merge pull request #798 from vitejs/develop/sync

Author: waynzh

.vitepress/config.ts

@@ -49,8 +49,10 @@ export default defineConfig({
       pattern: 'https://github.com/vitejs/docs-cn/edit/main/:path',
       text: '为此页提供修改建议',
     },
-    
-    outlineTitle: '本页目录',
+
+    outline: {
+      label: '本页目录'
+    },
 
     socialLinks: [
       { icon: 'mastodon', link: 'https://elk.zone/m.webtoo.ls/@vite' },
@@ -65,7 +67,45 @@ export default defineConfig({
       indexName: 'vitejs',
       searchParameters: {
         facetFilters: ['tags:cn']
-      }
+      },
+      placeholder: '搜索文档',
+      translations: {
+        button: {
+          buttonText: '搜索'
+        },
+        modal: {
+          searchBox: {
+            resetButtonTitle: '清除查询条件',
+            resetButtonAriaLabel: '清除查询条件',
+            cancelButtonText: '取消',
+            cancelButtonAriaLabel: '取消'
+          },
+          startScreen: {
+            recentSearchesTitle: '搜索历史',
+            noRecentSearchesText: '没有搜索历史',
+            saveRecentSearchButtonTitle: '保存到搜索历史',
+            removeRecentSearchButtonTitle: '从搜索历史中移除',
+            favoriteSearchesTitle: '收藏',
+            removeFavoriteSearchButtonTitle: '从收藏中移除'
+          },
+          errorScreen: {
+            titleText: '无法获取结果',
+            helpText: '你可能需要检查你的网络连接'
+          },
+          footer: {
+            selectText: '选择',
+            navigateText: '切换',
+            closeText: '关闭',
+            searchByText: '搜索供应商'
+          },
+          noResultsScreen: {
+            noResultsText: '无法找到相关结果',
+            suggestedQueryText: '你可以尝试查询',
+            reportMissingResultsText: '你认为这个查询应该有结果？',
+            reportMissingResultsLinkText: '向我们反馈'
+          }
+        }
+      },
     },
 
     carbonAds: {

LICENSE

@@ -56,7 +56,7 @@ $ pnpm dev
 
 ## 版权声明
 
-本仓库所包含的中文翻译内容（即所有 `.md` 文件），其版权为 Vite 官方中文翻译团队所有。除官方中文文档 [cn.vitejs.dev](https://cn.vitejs.dev) 之外，不得在其它域名下进行未经授权的转载或部署。
+<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/"><img alt="知识共享许可协议" style="border-width:0" src="https://i.creativecommons.org/l/by-nc-sa/4.0/88x31.png" /></a><br />本作品采用<a rel="license" href="http://creativecommons.org/licenses/by-nc-sa/4.0/">知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议  (CC BY-NC-SA 4.0) </a>进行许可。
 
 ## 贡献者统计
 
@@ -65,5 +65,7 @@ $ pnpm dev
 > 头像图生成逻辑参见：[github-contributor-svg-generator](https://github.com/ShenQingchuan/github-contributor-svg-generator)
 
 <p align="center">
-  <img src="https://cdn.jsdelivr.net/gh/ShenQingchuan/github-contributor-svg-generator@main/dist/vitejs/docs-cn.png" />
+  <a href="https://cdn.jsdelivr.net/gh/ShenQingchuan/github-contributor-svg-generator@main/.github-contributors/vitejs_docs-cn.svg">
+    <img src="https://cdn.jsdelivr.net/gh/ShenQingchuan/github-contributor-svg-generator@main/.github-contributors/vitejs_docs-cn.svg" />
+  </a>
 </p>

README.md

@@ -129,7 +129,7 @@ Git LFS 占位符会自动排除在内联之外，因为它们不包含它们所
 - **类型：** `boolean | 'inline' | 'hidden'`
 - **默认：** `false`
 
-构建后是否生成 source map 文件。如果为 `true`，将会创建一个独立的 source map 文件。如果为 `'inline'`，source map 将作为一个 data URI 附加在输出文件中。`'hidden'` 的工作原理与 `'true'` 相似，只是 bundle 文件中相应的注释将不被保留。
+构建后是否生成 source map 文件。如果为 `true`，将会创建一个独立的 source map 文件。如果为 `'inline'`，source map 将作为一个 data URI 附加在输出文件中。`'hidden'` 的工作原理与 `true` 相似，只是 bundle 文件中相应的注释将不被保留。
 
 ## build.rollupOptions {#build-rollupoptions}
 

config/build-options.md

@@ -49,7 +49,7 @@ export default defineConfig({
 
 - **类型：** [`EsbuildBuildOptions`](https://esbuild.github.io/api/#simple-options)
 
-在部署扫描和优化过程中传递给 esbuild 的选项。
+在依赖扫描和优化过程中传递给 esbuild 的选项。
 
 某些选项进行了省略，因为修改它们与 Vite 的优化方案并不兼容。
 
@@ -78,7 +78,7 @@ export default defineConfig({
 
 ## optimizeDeps.needsInterop
 
-- **Experimental**
-- **Type:** `string[]`
+- **实验性**
+- **类型:** `string[]`
 
-Forces ESM interop when importing these dependencies. Vite is able to properly detect when a dependency needs interop, so this option isn't generally needed. However, different combinations of dependencies could cause some of them to be prebundled differently. Adding these packages to `needsInterop` can speed up cold start by avoiding full-page reloads. You'll receive a warning if this is the case for one of your dependencies, suggesting to add the package name to this array in your config.
+当导入这些依赖项时，会强制 ESM 转换。Vite 能够正确检测到依赖项是否需要转换处理（interop），因此通常不需要使用此选项。然而，不同的依赖项组合可能导致其中一些包以不同方式预构建。将这些包添加到 `needsInterop` 中可以通过避免重新加载整个页面、加快冷启动速度。如果某个依赖项符合此情况，Vite 将抛出警告，建议你在配置中添加该包名。

config/dep-optimization-options.md

@@ -3,7 +3,7 @@
 ## preview.host {#preview-host}
 
 - **类型：** `string | boolean`
-- **默认：** [`server.host`](#server_host)
+- **默认：** [`server.host`](./server-options#server-host)
 
 为开发服务器指定 ip 地址。
 设置为 `0.0.0.0` 或 `true` 会监听所有地址，包括局域网和公共地址。
@@ -40,23 +40,23 @@ export default defineConfig({
 ## preview.strictPort {#preview-strictport}
 
 - **类型：** `boolean`
-- **默认：** [`server.strictPort`](#server_strictport)
+- **默认：** [`server.strictPort`](./server-options#server-strictport)
 
 设置为 `true` 时，如果端口已被使用，则直接退出，而不会再进行后续端口的尝试。
 
 ## preview.https {#preview-https}
 
 - **类型：** `boolean | https.ServerOptions`
-- **默认：** [`server.https`](#server_https)
+- **默认：** [`server.https`](./server-options#server-https)
 
-启用 TLS + HTTP/2。注意，只有在与 [`server.proxy` 选项](#server-proxy) 同时使用时，才会降级为 TLS。
+启用 TLS + HTTP/2。注意，只有在与 [`server.proxy` 选项](./server-options#server-proxy) 同时使用时，才会降级为 TLS。
 
 该值也可以传递给 `https.createServer()` 的 [options 对象](https://nodejs.org/api/https.html#https_https_createserver_options_requestlistener)。
 
 ## preview.open {#preview-open}
 
 - **类型：** `boolean | string`
-- **默认：** [`server.open`](#server_open)
+- **默认：** [`server.open`](./server-options#server-open)
 
 开发服务器启动时，自动在浏览器中打开应用程序。当该值为字符串时，它将被用作 URL 的路径名。如果你想在你喜欢的某个浏览器打开该开发服务器，你可以设置环境变量 `process.env.BROWSER` （例如 `firefox`）。欲了解更多细节，请参阅 [`open` 包的源码](https://github.com/sindresorhus/open#app)。
 
@@ -74,12 +74,12 @@ export default defineConfig({
 ## preview.cors {#preview-cors}
 
 - **类型：** `boolean | CorsOptions`
-- **默认：** [`server.cors`](#server_proxy)
+- **默认：** [`server.cors`](./server-options#server-cors)
 
 为开发服务器配置 CORS。此功能默认启用并支持任何来源。可传递一个 [options 对象](https://github.com/expressjs/cors#configuration-options) 来进行配置，或者传递 `false` 来禁用此行为。
 
 ## preview.headers {#preview-headers}
 
 - **类型：** `OutgoingHttpHeaders`
 
-指明服务器返回的响应头。
+指明服务器返回的响应头。

config/preview-options.md

@@ -16,7 +16,7 @@
 
 第一种情况是 `localhost` 被使用了。Node.js 在 v17 以下版本中默认会对 DNS 解析地址的结果进行重新排序。当访问 `localhost` 时，浏览器使用 DNS 来解析地址，这个地址可能与 Vite 正在监听的地址不同。当地址不一致时，Vite 会打印出来。
 
-你可以设置 [`dns.setDefaultResultOrder('verbatim')`](https://nodejs.org/api/dns.html#dns_dns_setdefaultresultorder_order) 来禁用这个重新排序的行为。Vite 将会将改地址打印为 `localhost`。
+你可以设置 [`dns.setDefaultResultOrder('verbatim')`](https://nodejs.org/api/dns.html#dns_dns_setdefaultresultorder_order) 来禁用这个重新排序的行为。Vite 会将地址打印为 `localhost`。
 
 ```js
 // vite.config.js
@@ -34,7 +34,6 @@ export default defineConfig({
 
 :::
 
-
 ::: tip 在 WSL2 中通过 LAN 访问开发服务器
 
 当你在 WSL2 运行 Vite 时，仅设置 `host: true` 来从局域网访问服务器是不够的。
@@ -214,13 +213,11 @@ export default defineConfig({
 ## server.middlewareMode {#server-middlewaremode}
 
 - **类型：** `'ssr' | 'html'`
+- **默认值：** `false`
 
-以中间件模式创建 Vite 服务器。（不含 HTTP 服务器）
-
-- `'ssr'` 将禁用 Vite 自身的 HTML 服务逻辑，因此你应该手动为 `index.html` 提供服务。
-- `'html'` 将启用 Vite 自身的 HTML 服务逻辑。
+以中间件模式创建 Vite 服务器。
 
-- **相关：** [SSR - 设置开发服务器](/guide/ssr#setting-up-the-dev-server)
+- **相关：** [appType](./shared-options#apptype)，[SSR - 设置开发服务器](/guide/ssr#setting-up-the-dev-server)
 
 - **示例：**
 
@@ -240,9 +237,10 @@ async function createServer() {
   app.use(vite.middlewares)
 
   app.use('*', async (req, res) => {
-    // 如果 `middlewareMode` 是 `'ssr'`，应在此为 `index.html` 提供服务.
-    // 如果 `middlewareMode` 是 `'html'`，则此处无需手动服务 `index.html`
-    // 因为 Vite 自会接管
+    // 由于 `appType` 的值是 `'custom'`，因此应在此处提供响应。
+    // 请注意：如果 `appType` 值为 `'spa'` 或 `'mpa'`，Vite 会包含
+    // 处理 HTML 请求和 404 的中间件，因此用户中间件应该在
+    // Vite 的中间件之前添加，以确保其生效。
   })
 }
 
@@ -309,9 +307,7 @@ export default defineConfig({
 - **类型：** `string[]`
 - **默认：** `['.env', '.env.*', '*.{crt,pem}']`
 
-用于限制 Vite 开发服务器提供敏感文件的黑名单。
-
-默认为 `['.env', '.env.*', '*.{pem,crt}']`。这会比 [`server.fs.allow`](#server-fs-allow) 选项的优先级更高。同时还支持 [picomatch patterns](https://github.com/micromatch/picomatch#globbing-features)。
+用于限制 Vite 开发服务器提供敏感文件的黑名单。这会比 [`server.fs.allow`](#server-fs-allow) 选项的优先级更高。同时还支持 [picomatch 模式](https://github.com/micromatch/picomatch#globbing-features)。
 
 ## server.origin {#server-origin}
 

config/server-options.md

@@ -34,7 +34,7 @@ const __dirname = fileURLToPath(new URL('.', import.meta.url))
 ```
 
 ::: tip 注意
-当在同一个 Node.js 进程中使用 `createServer` 和 `build` 时，两个函数都依赖于 `process.env.NODE_ENV` 才可正常工作，而这个环境变量又依赖于 `mode` 配置项。为了避免行为冲突，请在这两个 API 传入参数 `development` 字段中设置 `process.env.NODE_ENV` 或者 `mode` 配置项，或者你也可以生成另一个子进程，分别运行这两个 API。
+当在同一个 Node.js 进程中使用 `createServer` 和 `build` 时，两个函数都依赖于 `process.env.NODE_ENV` 才可正常工作，而这个环境变量又依赖于 `mode` 配置项。为了避免行为冲突，请在使用这两个 API 时为 `process.env.NODE_ENV` 或者 `mode` 配置项、字段设置参数值 `development`，或者你也可以生成另一个子进程，分别运行这两个 API。
 :::
 
 ## `InlineConfig` {#inlineconfig}
@@ -265,11 +265,7 @@ function mergeConfig(
 深度合并两份配置。`isRoot` 代表着 Vite 配置被合并的层级。举个例子，如果你是要合并两个 `build` 选项请设为 `false`。
 
 ::: tip NOTE
-`mergeConfig` accepts only config in object form. If you have a config in callback form, you should call it before passing into `mergeConfig`.
-:::
-
-::: tip NOTE
-`mergeConfig` accepts only config in object form. If you have a config in callback form, you should call it before passing into `mergeConfig`.
+`mergeConfig` 只接受对象形式的配置。如果有一个回调形式的配置，应该在将其传递给 `mergeConfig` 之前先调用该回调函数，将其转换成对象形式。
 :::
 
 ## `searchForWorkspaceRoot`

guide/api-javascript.md

@@ -161,7 +161,7 @@ console.log(msg)
 
 它们还有一个扩展的 `options` 参数，包含其他特定于 Vite 的属性。你可以在 [SSR 文档](/guide/ssr#ssr-specific-plugin-logic) 中查阅更多内容。
 
-一些 `resolveId` 调用的 `importer` 值可能是根目录下的通用 `index.html` 的绝对路径，因为由于 Vite 非打包的开发服务器模式无法始终推导出实际的导入者。对于在 Vite 的解析管道中处理的导入，导入者可以在导入分析阶段进行跟踪，那时所提供的 `importer` 值是正确的。
+一些 `resolveId` 调用的 `importer` 值可能是根目录下的通用 `index.html` 的绝对路径，这是由于 Vite 非打包的开发服务器模式无法始终推断出实际的导入者。对于在 Vite 的解析管道中处理的导入，可以在导入分析阶段跟踪导入者，提供正确的 `importer` 值。
 
 以下钩子在服务器关闭时被调用：
 

guide/api-plugin.md

@@ -6,7 +6,7 @@ Preact 团队的 [WMR](https://github.com/preactjs/wmr) 提供了类似的特性
 
 WMR 主要是为了 [Preact](https://preactjs.com/) 项目而设计，并为其提供了集成度更高的功能，比如预渲染。就使用范围而言，它更加贴合于 Preact 框架，与 Preact 本身一样强调紧凑的大小。如果你正在使用 Preact，那么 WMR 可能会提供更好的体验。
 
-## @web/dev-server {#webdev-server}
+## @web/dev-server {#web-dev-server}
 
 [@web/dev-server](https://modern-web.dev/docs/dev-server/overview/)（曾经是 `es-dev-server`）是一个伟大的项目，基于 koa 的 Vite 1.0 开发服务器就是受到了它的启发。
 
@@ -16,6 +16,6 @@ WMR 主要是为了 [Preact](https://preactjs.com/) 项目而设计，并为其
 
 ## Snowpack {#snowpack}
 
-[Snowpack](https://www.snowpack.dev/) 也是一个与 Vite 十分类似的非构建式原生 ESM 开发服务器。该项目已经不维护了。团队目前正在开发 [Astro](https://astro.build/)，一个由 Vite 驱动的静态站点构建工具。Astro 团队目前是我们生态中非常活跃的成员，它们帮助 Vite 进益良多。
+[Snowpack](https://www.snowpack.dev/) 也是一个与 Vite 十分类似的非构建式原生 ESM 开发服务器。该项目已经不维护了。团队目前正在开发 [Astro](https://astro.build/)，一个由 Vite 驱动的静态站点构建工具。Astro 团队目前是我们生态中非常活跃的成员，他们帮助 Vite 进益良多。
 
-除了不同的实现细节外，这两个项目在技术上比传统工具有很多共同优势。Vite 的依赖预构建也受到了 Snowpack v1（现在是 [`esinstall`](https://github.com/snowpackjs/snowpack/tree/main/esinstall)）的启发。若想了解 Vite 同这两个项目之间的一些主要区别，可以查看 [the v2 Comparisons Guide](https://v2.vitejs.dev/guide/comparisons)。
+除了不同的实现细节外，这两个项目在技术上比传统工具有很多共同优势。Vite 的依赖预构建也受到了 Snowpack v1（现在是 [`esinstall`](https://github.com/snowpackjs/snowpack/tree/main/esinstall)）的启发。若想了解 Vite 同这两个项目之间的一些主要区别，可以查看 [Vite v2 比较指南](https://v2.vitejs.dev/guide/comparisons)。