docs(cn): resolve all conflicts

Author: ShenQingchuan

.vitepress/config.ts

@@ -5,8 +5,6 @@ const ogImage = 'https://vitejs.dev/og-image.png'
 const ogTitle = 'Vite'
 const ogUrl = 'https://vitejs.dev'
 
-<<<<<<< HEAD
-=======
 // netlify envs
 const deployURL = process.env.DEPLOY_PRIME_URL || ''
 const commitRef = process.env.COMMIT_REF?.slice(0, 8) || 'dev'
@@ -62,7 +60,6 @@ const versionLinks = ((): DefaultTheme.NavItemWithLink[] => {
   }
 })()
 
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
 export default defineConfig({
   title: 'Vite 官方中文文档',
   description: '下一代前端工具链',

.vitepress/rewrite-title/index.js

@@ -1,6 +1,8 @@
-const path = require('path')
-const fsp = require('fs').promises
-const matterService = require('../utils/frontmatter-service')
+import path from 'node:path'
+import fsp from 'node:fs/promises'
+import matterService from '../utils/frontmatter-service.js'
+import { fileURLToPath } from 'node:url'
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const workspacePath = path.resolve(__dirname, '..', '..')
 
 const h1MdRegExp = /^#\s+(.+)\s+(\{#([\w-]+)\})$/
@@ -41,4 +43,4 @@ const ergodicDirectory = async (dirPath) => {
   }
 }
 
-module.exports = () => ergodicDirectory(workspacePath)
+export default () => ergodicDirectory(workspacePath)

.vitepress/theme/index.ts

@@ -5,14 +5,11 @@ import './styles/vars.css'
 import HomeSponsors from './components/HomeSponsors.vue'
 import AsideSponsors from './components/AsideSponsors.vue'
 import SvgImage from './components/SvgImage.vue'
-<<<<<<< HEAD
 import WwAds from './components/WwAds.vue'
 import './custom.css'
-=======
 // temporary fix for vitepress not including component css when only
 // imported in a single page
 import './components/BlogIndex.vue'
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
 
 export default {
   extends: DefaultTheme,

.vitepress/utils/frontmatter-service.js

@@ -1,6 +1,7 @@
-const fs = require('fs')
-const matter = require('gray-matter')
-const { extend, isEmpty: _isEmpty } = require('lodash')
+import fs from 'node:fs'
+import matter from 'gray-matter'
+import _ from 'lodash'
+
 // gray-matter is a dep for vitepress,
 // no need to specify that in package.json
 
@@ -21,7 +22,7 @@ class FrontMatterService {
   }
 
   isEmpty() {
-    return _isEmpty(this.matter.data)
+    return _._isEmpty(this.matter.data)
   }
 
   /** @param{(data: string) => void} callback */
@@ -48,7 +49,7 @@ class FrontMatterService {
 
   /** @param {Record<string, any>} src */
   extend(src) {
-    extend(this.matter.data, src)
+    _.extend(this.matter.data, src)
     return this
   }
 
@@ -63,4 +64,4 @@ class FrontMatterService {
   }
 }
 
-module.exports = new FrontMatterService()
+export default new FrontMatterService()

config/server-options.md

@@ -248,15 +248,10 @@ async function createServer() {
     server: { middlewareMode: true },
     appType: 'custom', // 不引入 Vite 默认的 HTML 处理中间件
   })
-<<<<<<< HEAD
   // 将 vite 的 connect 实例作中间件使用
-  app.use(vite.middlewares)
-=======
-  // Use vite's connect instance as middleware
   app.use((req, res, next) => {
     vite.middlewares.handle(req, res, next)
   })
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
 
   app.use('*', async (req, res) => {
     // 由于 `appType` 的值是 `'custom'`，因此应在此处提供响应。

config/shared-options.md

@@ -11,26 +11,15 @@
 
 ## base {#base}
 
-<<<<<<< HEAD
 - **类型：** `string`
 - **默认：** `/`
-=======
-- **Type:** `string`
-- **Default:** `/`
-- **Related:** [`server.origin`](/config/server-options.md#server-origin)
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
+- **相关：** [`server.origin`](/config/server-options.md#server-origin)
 
 开发或生产环境服务的公共基础路径。合法的值包括以下几种：
 
-<<<<<<< HEAD
 - 绝对 URL 路径名，例如 `/foo/`
-- 完整的 URL，例如 `https://foo.com/`
+- 完整的 URL，例如 `https://foo.com/`（原始的部分在开发环境中不会被使用）
 - 空字符串或 `./`（用于嵌入形式的开发）
-=======
-- Absolute URL pathname, e.g. `/foo/`
-- Full URL, e.g. `https://foo.com/` (The origin part won't be used in development)
-- Empty string or `./` (for embedded deployment)
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
 
 更多信息详见 [公共基础路径](/guide/build#public-base-path)。
 
@@ -176,29 +165,7 @@ Vite 有一个“允许的情景”列表，并且会匹配列表中第一个情
 
 ## css.modules {#css-modules}
 
-<<<<<<< HEAD
 - **类型：**
-```ts
-interface CSSModulesOptions {
-  scopeBehaviour?: 'global' | 'local'
-  globalModulePaths?: RegExp[]
-  generateScopedName?:
-    | string
-    | ((name: string, filename: string, css: string) => string)
-  hashPrefix?: string
-  /**
-   * 默认：null
-   */
-  localsConvention?:
-    | 'camelCase'
-    | 'camelCaseOnly'
-    | 'dashes'
-    | 'dashesOnly'
-    | null
-}
-```
-=======
-- **Type:**
   ```ts
   interface CSSModulesOptions {
     getJSON?: (
@@ -228,7 +195,6 @@ interface CSSModulesOptions {
         ) => string)
   }
   ```
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
 
 配置 CSS modules 的行为。选项将被传递给 [postcss-modules](https://github.com/css-modules/postcss-modules)。
 

guide/api-javascript.md

@@ -38,14 +38,11 @@ const __dirname = fileURLToPath(new URL('.', import.meta.url))
 当在同一个 Node.js 进程中使用 `createServer` 和 `build` 时，两个函数都依赖于 `process.env.NODE_ENV` 才可正常工作，而这个环境变量又依赖于 `mode` 配置项。为了避免行为冲突，请在使用这两个 API 时为 `process.env.NODE_ENV` 或者 `mode` 配置项、字段设置参数值 `development`，或者你也可以生成另一个子进程，分别运行这两个 API。
 :::
 
-<<<<<<< HEAD
-## `InlineConfig` {#inlineconfig}
-=======
-::: tip NOTE
-When using [middleware mode](/config/server-options.html#server-middlewaremode) combined with [proxy config for WebSocket](/config/server-options.html#server-proxy), the parent http server should be provided in `middlewareMode` to bind the proxy correctly.
+::: tip 注意
+当使用 [中间件模式](/config/server-options.md#server-middlewaremode) 与 [WebSocket 代理配置](/config/server-options.md#server-proxy) 时，父 http 服务器应该在 `middlewareMode` 中提供，以正确绑定代理。
 
 <details>
-<summary>Example</summary>
+<summary>示例</summary>
 
 ```ts
 import http from 'http'
@@ -55,9 +52,9 @@ const parentServer = http.createServer() // or express, koa, etc.
 
 const vite = await createServer({
   server: {
-    // Enable middleware mode
+    // 开启中间件模式
     middlewareMode: {
-      // Provide the parent http server for proxy WebSocket
+      // 提供父 http 服务器以代理 WebSocket
       server: parentServer,
     },
   },
@@ -78,8 +75,7 @@ server.use((req, res, next) => {
 </details>
 :::
 
-## `InlineConfig`
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
+## `InlineConfig` {#inlineconfig}
 
 `InlineConfig` 接口扩展了 `UserConfig` 并添加了以下属性：
 

guide/build.md

@@ -216,13 +216,8 @@ dist/my-lib.umd.cjs 0.30 kB / gzip: 0.16 kB
 如果 `package.json` 不包含 `"type": "module"`，Vite 会生成不同的文件后缀名以兼容 Node.js。`.js` 会变为 `.mjs` 而 `.cjs` 会变为 `.js` 。
 :::
 
-<<<<<<< HEAD
 ::: tip 环境变量
-在库模式下，所有 `import.meta.env.*` 用法在构建生产时都会被静态替换。但是，`process.env.*` 的用法不会被替换，所以你的库的使用者可以动态地更改它。如果不想允许他们这样做，你可以使用 `define: { 'process.env.NODE_ENV': '"production"' }` 例如静态替换它们。
-=======
-::: tip Environment Variables
-In library mode, all [`import.meta.env.*`](./env-and-mode.md) usage are statically replaced when building for production. However, `process.env.*` usage are not, so that consumers of your library can dynamically change it. If this is undesirable, you can use `define: { 'process.env.NODE_ENV': '"production"' }` for example to statically replace them, or use [`esm-env`](https://github.com/benmccann/esm-env) for better compatibility with bundlers and runtimes.
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
+在库模式中，所有 [`import.meta.env.*`](./env-and-mode.md) 的使用都会在构建生产版本时被静态替换。但是，`process.env.*` 的使用不会，这样你的库的使用者就可以动态地改变它。如果这是不可取的，你可以使用 `define: { 'process.env.NODE_ENV': '"production"' }` 来静态替换它们，或者使用 [`esm-env`](https://github.com/benmccann/esm-env) 来更好地兼容打包工具和运行时。
 :::
 
 ::: warning 进阶用法

guide/dep-pre-bundling.md

@@ -60,11 +60,7 @@ export default defineConfig({
 
 `include` 和 `exclude` 都可以用来处理这个问题。如果依赖项很大（包含很多内部模块）或者是 CommonJS，那么你应该包含它；如果依赖项很小，并且已经是有效的 ESM，则可以排除它，让浏览器直接加载它。
 
-<<<<<<< HEAD
-你也可以使用 [`optimizeDeps.esbuildOptions` 选项](/config/dep-optimization-options.md#optimizedeps-esbuildoptions) 来进一步自定义 esbuild。例如，添加一个 esbuild 插件来处理依赖项中的特殊文件。
-=======
-You can further customize esbuild too with the [`optimizeDeps.esbuildOptions` option](/config/dep-optimization-options.md#optimizedeps-esbuildoptions). For example, adding an esbuild plugin to handle special files in dependencies or changing the [build `target`](https://esbuild.github.io/api/#target).
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
+你可以通过 [`optimizeDeps.esbuildOptions` 选项](/config/dep-optimization-options.md#optimizedeps-esbuildoptions) 进一步自定义 esbuild。例如，添加一个 esbuild 插件来处理依赖项中的特殊文件，或者更改 [build `target`](https://esbuild.github.io/api/#target)。
 
 ## 缓存 {#caching}
 

guide/env-and-mode.md

@@ -107,13 +107,9 @@ Vite 还支持在 HTML 文件中替换环境变量。`import.meta.env` 中的任
 
 如果环境变量在 `import.meta.env` 中不存在，比如不存在的 `%NON_EXISTENT%`，则会将被忽略而不被替换，这与 JS 中的 `import.meta.env.NON_EXISTENT` 不同，JS 中会被替换为 `undefined`。
 
-<<<<<<< HEAD
-## 模式 {#modes}
-=======
-Given that Vite is used by many frameworks, it is intentionally unopinionated about complex replacements like conditionals. Vite can be extended using [an existing userland plugin](https://github.com/vitejs/awesome-vite#transformers) or a custom plugin that implements the [`transformIndexHtml` hook](./api-plugin#transformindexhtml).
+正因为 Vite 被许多框架使用，它在复杂的替换（如条件替换）上故意不持任何意见。Vite 可以使用 [现有的用户插件](https://github.com/vitejs/awesome-vite#transformers) 或者一个实现了 [`transformIndexHtml` 钩子](./api-plugin#transformindexhtml) 的自定义插件来扩展。
 
-## Modes
->>>>>>> 8b72e23084a5bf4f2af26c9cef6ed2e89e20d001
+## 模式 {#modes}
 
 默认情况下，开发服务器 (`dev` 命令) 运行在 `development` (开发) 模式，而 `build` 命令则运行在 `production` (生产) 模式。