docs(cn): update with mainstream

Author: ShenQingchuan

.gitignore

@@ -7,4 +7,5 @@ node_modules/
 package-lock.json
 yarn.lock
 .vitepress/dist
-*.local
+*.local
+.vitepress/cache

.vitepress/config.ts

@@ -33,6 +33,13 @@ export default defineConfig({
     ],
   ],
 
+  locales: {
+    root: { label: '简体中文' },
+    en: { label: 'English', link: 'https://vitejs.dev' },
+    ja: { label: '日本語', link: 'https://ja.vitejs.dev' },
+    es: { label: 'Español', link: 'https://es.vitejs.dev' },
+  },
+
   vue: {
     reactivityTransform: true,
   },
@@ -67,15 +74,6 @@ export default defineConfig({
       placement: 'vitejsdev',
     },
 
-    localeLinks: {
-      text: '简体中文',
-      items: [
-        { text: 'English', link: 'https://vitejs.dev' },
-        { text: '日本語', link: 'https://ja.vitejs.dev' },
-        { text: 'Español', link: 'https://es.vitejs.dev' },
-      ],
-    },
-
     footer: {
       copyright:
         '本中文文档内容版权为 Vite 官方中文翻译团队所有，保留所有权利。'

.vitepress/theme/styles/vars.css

@@ -18,13 +18,13 @@
 
 :root {
   --vp-button-brand-border: var(--vp-c-brand-light);
-  --vp-button-brand-text: var(--vp-c-text-dark-1);
+  --vp-button-brand-text: var(--vp-c-white);
   --vp-button-brand-bg: var(--vp-c-brand);
   --vp-button-brand-hover-border: var(--vp-c-brand-light);
-  --vp-button-brand-hover-text: var(--vp-c-text-dark-1);
+  --vp-button-brand-hover-text: var(--vp-c-white);
   --vp-button-brand-hover-bg: var(--vp-c-brand-light);
   --vp-button-brand-active-border: var(--vp-c-brand-light);
-  --vp-button-brand-active-text: var(--vp-c-text-dark-1);
+  --vp-button-brand-active-text: var(--vp-c-white);
   --vp-button-brand-active-bg: var(--vp-button-brand-bg);
 }
 

.vitepress/utils/fetchReleaseTag.js

@@ -3,6 +3,7 @@ export function fetchReleaseTag() {
     .then((res) => res.json())
     .then((json) => json.tag_name ?? '')
     .then(releaseTag => {
+      if (!releaseTag) return;
       const tagLineParagragh = document.querySelector('div.VPHero.has-image.VPHomeHero > div > div.main > p.tagline')
       const docsReleaseTagSpan = document.createElement('samp')
       docsReleaseTagSpan.classList.add('docs-cn-github-release-tag')

_data/team.js

@@ -113,6 +113,7 @@ export const core = [
     title: 'Frontend Developer',
     desc: 'Passionate by tooling around TypeScript and React.',
     links: [{ icon: 'github', link: 'https://github.com/ArnaudBarre' }],
+    sponsor: 'https://github.com/sponsors/ArnaudBarre',
   },
   {
     avatar: 'https://github.com/dominikg.png',

config/build-options.md

@@ -6,7 +6,7 @@
 - **默认：** `'modules'`
 - **相关内容：** [浏览器兼容性](/guide/build#browser-compatibility)
 
-设置最终构建的浏览器兼容目标。默认值是一个 Vite 特有的值——`'modules'`，这是指 [支持原生 ES 模块](https://caniuse.com/es6-module)、[原生 ESM 动态导入](https://caniuse.com/es6-module-dynamic-import) 和 [`import.meta`](https://caniuse.com/mdn-javascript_operators_import_meta) 的浏览器。
+设置最终构建的浏览器兼容目标。默认值是一个 Vite 特有的值：'modules'`，这是指 [支持原生 ES 模块](https://caniuse.com/es6-module)、[原生 ESM 动态导入](https://caniuse.com/es6-module-dynamic-import) 和 [`import.meta`](https://caniuse.com/mdn-javascript_operators_import_meta) 的浏览器。Vite 将替换 `modules` 为 `['es2020', 'edge88', 'firefox78', 'chrome87', 'safari14']`
 
 另一个特殊值是 “esnext” —— 即假设有原生动态导入支持，并且将会转译得尽可能小：
 
@@ -20,7 +20,7 @@
 ## build.modulePreload {#build-modulepreload}
 
 - **类型：** `boolean | { polyfill?: boolean, resolveDependencies?: ResolveModulePreloadDependenciesFn }`
-- **默认值：** `true`
+- **默认值：** `{ polyfill: true }`
 
 默认情况下，一个 [模块预加载 polyfill](https://guybedford.com/es-module-preloading-integrity#modulepreload-polyfill) 会被自动注入。该 polyfill 会自动注入到每个 `index.html` 入口的的代理模块中。如果构建通过 `build.rollupOptions.input` 被配置为了使用非 HTML 入口的形式，那么必须要在你的自定义入口中手动引入该 polyfill：
 
@@ -126,9 +126,9 @@ Git LFS 占位符会自动排除在内联之外，因为它们不包含它们所
 
 ## build.rollupOptions {#build-rollupoptions}
 
-- **类型：** [`RollupOptions`](https://rollupjs.org/guide/en/#big-list-of-options)
+- **类型：** [`RollupOptions`](https://rollupjs.org/configuration-options/)
 
-自定义底层的 Rollup 打包配置。这与从 Rollup 配置文件导出的选项相同，并将与 Vite 的内部 Rollup 选项合并。查看 [Rollup 选项文档](https://rollupjs.org/guide/en/#big-list-of-options) 获取更多细节。
+自定义底层的 Rollup 打包配置。这与从 Rollup 配置文件导出的选项相同，并将与 Vite 的内部 Rollup 选项合并。查看 [Rollup 选项文档](https://rollupjs.org/configuration-options/) 获取更多细节。
 
 ## build.commonjsOptions {#build-commonjsoptions}
 
@@ -169,8 +169,8 @@ Git LFS 占位符会自动排除在内联之外，因为它们不包含它们所
 ## build.ssr {#build-ssr}
 
 - **类型：** `boolean | string`
-- **默认值：** `undefined`
-- **相关链接：** [Server-Side Rendering](/guide/ssr)
+- **默认值：** `false`
+- **相关链接：** [服务端渲染](/guide/ssr)
 
 生成面向 SSR 的构建。此选项的值可以是字符串，用于直接定义 SSR 的入口，也可以为 `true`，但这需要通过设置 `rollupOptions.input` 来指定 SSR 的入口。
 
@@ -233,7 +233,7 @@ npm add -D terser
 
 ## build.watch {#build-watch}
 
-- **类型：** [`WatcherOptions`](https://rollupjs.org/guide/en/#watch-options)`| null`
+- **类型：** [`WatcherOptions`](https://rollupjs.org/configuration-options/#watch)`| null`
 - **默认：** `null`
 
 设置为 `{}` 则会启用 rollup 的监听器。对于只在构建阶段或者集成流程使用的插件很常用。

config/index.md

@@ -78,7 +78,7 @@ export default defineConfig(async ({ command, mode }) => {
 })
 ```
 
-## 环境变量 {#environment-variables}
+## 在配置中使用环境变量 {#using-environment-variables-in-config}
 
 环境变量通常可以从 `process.env` 获得。
 

config/preview-options.md

@@ -60,10 +60,12 @@ export default defineConfig({
 
 开发服务器启动时，自动在浏览器中打开应用程序。当该值为字符串时，它将被用作 URL 的路径名。如果你想在你喜欢的某个浏览器打开该开发服务器，你可以设置环境变量 `process.env.BROWSER` （例如 `firefox`）。欲了解更多细节，请参阅 [`open` 包的源码](https://github.com/sindresorhus/open#app)。
 
+`BROWSER` 和 `BROWSER_ARGS` 是两个特殊的环境变量，你可以在 `.env` 文件中设置它们用以配置本选项。查看 [`open` 这个包](https://github.com/sindresorhus/open#app) 了解更多详情。
+
 ## preview.proxy {#preview-proxy}
 
 - **类型：** `Record<string, string | ProxyOptions>`
-- **默认：** [`server.proxy`](#server_proxy)
+- **默认：** [`server.proxy`](./server-options#server-proxy)
 
 为开发服务器配置自定义代理规则。其值的结构为 `{ key: options }` 的对象。如果 key 以 `^` 开头，它将被识别为 `RegExp`，其中 `configure` 选项可用于访问代理实例。
 
@@ -74,10 +76,10 @@ export default defineConfig({
 - **类型：** `boolean | CorsOptions`
 - **默认：** [`server.cors`](#server_proxy)
 
-为开发服务器配置 CORS。此功能默认启用并支持任何来源。可传递一个 [options 对象](https://github.com/expressjs/cors) 来进行配置，或者传递 `false` 来禁用此行为。
+为开发服务器配置 CORS。此功能默认启用并支持任何来源。可传递一个 [options 对象](https://github.com/expressjs/cors#configuration-options) 来进行配置，或者传递 `false` 来禁用此行为。
 
 ## preview.headers {#preview-headers}
 
 - **类型：** `OutgoingHttpHeaders`
 
-指明服务器返回的响应头。
+指明服务器返回的响应头。

config/server-options.md

@@ -61,7 +61,9 @@ export default defineConfig({
 
 - **类型：** `boolean | string`
 
-在开发服务器启动时自动在浏览器中打开应用程序。当此值为字符串时，会被用作 URL 的路径名。若你想指定喜欢的浏览器打开服务器，你可以设置环境变量 `process.env.BROWSER`（例如：`firefox`）。查看 [这个 `open` 包](https://github.com/sindresorhus/open#app) 获取更多细节。
+开发服务器启动时，自动在浏览器中打开应用程序。当该值为字符串时，它将被用作 URL 的路径名。如果你想在你喜欢的某个浏览器打开该开发服务器，你可以设置环境变量 `process.env.BROWSER` （例如 `firefox`）。你还可以设置 `process.env.BROWSER_ARGS` 来传递额外的参数（例如 `--incognito`）。
+
+`BROWSER` 和 `BROWSER_ARGS` 都是特殊的环境变量，你可以将它们放在 `.env` 文件中进行设置，欲了解更多打开浏览器的更多内部细节，请参阅 [`open` 包的源码](https://github.com/sindresorhus/open#app)。
 
 **示例：**
 
@@ -127,7 +129,7 @@ export default defineConfig({
 
 - **类型：** `boolean | CorsOptions`
 
-为开发服务器配置 CORS。默认启用并允许任何源，传递一个 [选项对象](https://github.com/expressjs/cors) 来调整行为或设为 `false` 表示禁用。
+为开发服务器配置 CORS。默认启用并允许任何源，传递一个 [选项对象](https://github.com/expressjs/cors#configuration-options) 来调整行为或设为 `false` 表示禁用。
 
 ## server.headers {#server-headers}
 
@@ -300,7 +302,7 @@ export default defineConfig({
 ## server.fs.deny {#server-fs-deny}
 
 - **类型：** `string[]`
-- **默认：** `['.env', '.env.*', '*.{pem,crt}']`
+- **默认：** `['.env', '.env.*', '*.{crt,pem}']`
 
 用于限制 Vite 开发服务器提供敏感文件的黑名单。
 

config/shared-options.md

@@ -33,11 +33,11 @@
 
 ## define {#define}
 
-- **类型：** `Record<string, string>`
+- **类型：** `Record<string, any>`
 
 定义全局常量替换方式。其中每项在开发环境下会被定义在全局，而在构建时被静态替换。
 
-- 从 `2.0.0-beta.70` 开始，string 值会以原始表达式形式使用，所以如果定义了一个字符串常量，它需要被显式地打引号。（例如使用 `JSON.stringify`）
+- String 值会以原始表达式形式使用，所以如果定义了一个字符串常量，**它需要被显式地打引号。**（例如使用 `JSON.stringify`）
 
 - 为了与 [esbuild 的行为](https://esbuild.github.io/api/#define)保持一致，表达式必须为一个 JSON 对象（null、boolean、number、string、数组或对象），亦或是一个单独的标识符。
 
@@ -171,7 +171,7 @@ Vite 有一个“允许的情景”列表，并且会匹配列表中第一个情
 ## resolve.extensions {#resolve-extensions}
 
 - **类型：** `string[]`
-- **默认：** `['.mjs', '.js', '.ts', '.jsx', '.tsx', '.json']`
+- **默认：** `['.mjs', '.js', '.mts', '.ts', '.jsx', '.tsx', '.json']`
 
 导入时想要省略的扩展名列表。注意，**不** 建议忽略自定义导入类型的扩展名（例如：`.vue`），因为它会影响 IDE 和类型支持。