Merge pull request #797 from vitejs/sync-f9180423-1

docs(en): merge docs-cn/sync-docs into docs-cn/dev @ f918042

Author: waynzh

.vitepress/theme/components/HomeSponsors.vue

@@ -46,7 +46,10 @@ const { data } = useSponsor()
   text-align: center;
   font-weight: 600;
   white-space: nowrap;
-  transition: color 0.25s, border-color 0.25s, background-color 0.25s;
+  transition:
+    color 0.25s,
+    border-color 0.25s,
+    background-color 0.25s;
   /* .VPButton.medium */
   border-radius: 20px;
   padding: 0 20px;

config/build-options.md

@@ -34,7 +34,7 @@ import 'vite/modulepreload-polyfill'
 
 每个动态导入要预加载的块列表将由 Vite 计算。默认情况下，在载入这些依赖时，会使用一个包含 `base` 的绝对路径。如果 `base` 是相对路径（`''` 或者 './'），解析时则会使用 `import.meta.url`，以避免出现依赖于最终部署基路径的绝对路径。
 
-目前有一个实验性功能支持使用 `resolveDependencies` 函数对依赖项列表及其路径进行细粒度控制。它期望接收一个 `ResolveModulePreloadDependenciesFn` 类型的函数:
+目前有一个实验性功能支持使用 `resolveDependencies` 函数对依赖项列表及其路径进行细粒度控制。可以在这里 [提供反馈](https://github.com/vitejs/vite/discussions/13841)。它期望接收一个 `ResolveModulePreloadDependenciesFn` 类型的函数:
 
 ```ts
 type ResolveModulePreloadDependenciesFn = (
@@ -218,7 +218,7 @@ npm add -D terser
 
 ## build.copyPublicDir {#build-copypublicdir}
 
-- **实验性特性**
+- **实验性：** [提供反馈](https://github.com/vitejs/vite/discussions/13807)
 - **类型：** `boolean`
 - **默认：** `true`
 

config/dep-optimization-options.md

@@ -64,7 +64,7 @@ export default defineConfig({
 
 ## optimizeDeps.disabled {#optimizedeps-disabled}
 
-- **实验性**
+- **实验性：** [提供反馈](https://github.com/vitejs/vite/discussions/13839)
 - **类型：** `boolean | 'build' | 'dev'`
 - **默认：** `'build'`
 

config/shared-options.md

@@ -260,23 +260,23 @@ export default defineConfig({
 
 ## css.devSourcemap {#css-devsourcemap}
 
-- **实验性**
+- **实验性：** [提供反馈](https://github.com/vitejs/vite/discussions/13845)
 - **类型：** `boolean`
 - **默认：** `false`
 
 在开发过程中是否启用 sourcemap。
 
 ## css.transformer
 
-- **实验性**
+- **实验性：** [提供反馈](https://github.com/vitejs/vite/discussions/13835)
 - **类型：** `'postcss' | 'lightningcss'`
 - **默认：** `'postcss'`
 
 该选项用于选择用于 CSS 处理的引擎。详细信息请查看 [Lightning CSS](../guide/features.md#lightning-css)。
 
 ## css.lightningcss
 
-- **实验性**
+- **实验性：** [提供反馈](https://github.com/vitejs/vite/discussions/13835)
 - **类型：**
 
 ```js

config/ssr-options.md

@@ -23,7 +23,8 @@ SSR 服务器的构建目标。
 
 ## ssr.format
 
-- **实验性**
+- **实验性：** [CJS 的支持将在 Vite 5 中移除](https://github.com/vitejs/vite/discussions/13816)
+- **弃用** 在 Vite 5 将只支持 ESM 输出
 - **类型：** `'esm' | 'cjs'`
 - **默认：** `esm`
 

guide/build.md

@@ -223,7 +223,7 @@ dist/my-lib.umd.cjs 0.30 KiB / gzip: 0.16 KiB
 ## 进阶基础路径选项 {#advanced-base-options}
 
 ::: warning
-该功能是实验性的，这个 API 可能在未来后续版本中发生变更而不遵循语义化版本号。请在使用它时注意维护 Vite 的版本。
+该功能是实验性的，可以在这里 [提供反馈](https://github.com/vitejs/vite/discussions/13834)。
 :::
 
 对更高级的使用场景，被部署的资源和公共文件可能想要分为不同的路径，例如使用不同缓存策略的场景。

guide/features.md

@@ -268,7 +268,7 @@ npm add -D lightningcss
 
 要配置 CSS Modules，需要使用 [`css.lightningcss.cssModules`](https://lightningcss.dev/css-modules.html) 而不是 [`css.modules`](../config/shared-options.md#css-modules)（后者是用于配置 PostCSS 处理 CSS Modules 的方式）。
 
-默认情况下，Vite 使用 esbuild 来压缩 CSS。通过 [`build.cssMinify: 'lightningcss'`](../config/build-options.md#css-minify) 进行配置，也可以将 Lightning CSS 用作 CSS 最小化压缩。
+默认情况下，Vite 使用 esbuild 来压缩 CSS。通过 [`build.cssMinify: 'lightningcss'`](../config/build-options.md#build-cssminify) 进行配置，也可以将 Lightning CSS 用作 CSS 最小化压缩。
 
 ::: tip NOTE
 在使用 Lightning CSS 时，不支持 [CSS 预处理器](#css-pre-processors)。

guide/index.md

@@ -36,6 +36,8 @@ Vite 还提供了强大的扩展性，可通过其 [插件 API](./api-plugin) 
 |  [preact](https://vite.new/preact)  |  [preact-ts](https://vite.new/preact-ts)  |
 |     [lit](https://vite.new/lit)     |     [lit-ts](https://vite.new/lit-ts)     |
 |  [svelte](https://vite.new/svelte)  |  [svelte-ts](https://vite.new/svelte-ts)  |
+|   [solid](https://vite.new/solid)   |   [solid-ts](https://vite.new/solid-ts)   |
+|    [qwik](https://vite.new/qwik)    |    [qwik-ts](https://vite.new/qwik-ts)    |
 
 ## 搭建第一个 Vite 项目 {#scaffolding-your-first-vite-project}
 
@@ -79,7 +81,7 @@ yarn create vite my-vue-app --template vue
 pnpm create vite my-vue-app --template vue
 ```
 
-查看 [create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite) 以获取每个模板的更多细节：`vanilla`，`vanilla-ts`, `vue`, `vue-ts`，`react`，`react-ts`，`react-swc`，`react-swc-ts`，`preact`，`preact-ts`，`lit`，`lit-ts`，`svelte`，`svelte-ts`。
+查看 [create-vite](https://github.com/vitejs/vite/tree/main/packages/create-vite) 以获取每个模板的更多细节：`vanilla`，`vanilla-ts`, `vue`, `vue-ts`，`react`，`react-ts`，`react-swc`，`react-swc-ts`，`preact`，`preact-ts`，`lit`，`lit-ts`，`svelte`，`svelte-ts`，`solid`，`solid-ts`，`qwik`，`qwik-ts`。
 
 ## 社区模板 {#community-templates}
 

guide/ssr.md

@@ -270,3 +270,7 @@ CLI 命令 `$ vite dev` 和 `$ vite preview` 也可以用于 SSR 应用：你可
 ## SSR 格式 {#ssr-format}
 
 默认情况下，Vite 生成的 SSR 打包产物是 ESM 格式。实验性地支持配置 `ssr.format` ，但不推荐这样做。未来围绕 SSR 的开发工作将基于 ESM 格式，并且为了向下兼容，commonjs 仍然可用。如果你的 SSR 项目不能使用 ESM，你可以通过 [Vite v2 外部启发式方法](https://v2.vitejs.dev/guide/ssr.html#ssr-externals) 设置 `legacy.buildSsrCjsExternalHeuristics: true` 生成 CJS 格式的产物。
+
+:::warning 安全注意事项
+实验性的 `legacy.buildSsrCjsExternalHeuristics` 和 `ssr.format: 'cjs'` 将在 Vite 5 中移除。可以在 [此讨论](https://github.com/vitejs/vite/discussions/13816) 中找到更多信息，并提供反馈意见。
+:::

guide/static-deploy.md

@@ -330,20 +330,8 @@ $ npx wrangler pages publish dist
 
 默认情况下，推送到该指定分支的任何新的 commit 都会自动触发一个新的部署。[Auto-Deploy](https://render.com/docs/deploys#toggling-auto-deploy-for-a-service) 可以在项目设置中部署。
 
-你也可以为你的项目添加一个 [自定义域名](https://render.com/docs/custom-domains)。
+还可以为在项目添加一个 [自定义域名](https://render.com/docs/custom-domains)。
 
-## 腾讯云 Webify
+## Flightcontrol
 
-[腾讯云 Webify](https://webify.cloudbase.net/) 支持从 Git 仓库直接部署您的 Vite 应用。
-
-进入 [Webify 新建应用页面](https://console.cloud.tencent.com/webify/new)，根据选择您代码仓库所在的 Git 平台（GitHub、GitLab 或者 Gitee 码云），完成授权流程后，便可导入仓库。
-
-应用配置如下：
-
-- 构建命令填入 `npm run build`
-- 输出目录填入 `dist`，
-- 安装命令填入 `npm install`
-
-![Webify 配置](../images/webify-configuration.png)
-
-应用创建之后，等待构建、部署完毕，便可以通过应用的默认域名（`.app.tcloudbase.com`）来访问应用。如 https://my-vite-vue-app-4gi9tn1478d8ee71-1255679239.ap-shanghai.app.tcloudbase.com/
+使用 [Flightcontrol](https://www.flightcontrol.dev/?ref=docs-vite) 部署静态站点，可以按照 [说明](https://www.flightcontrol.dev/docs/reference/examples/vite?ref=docs-vite) 进行操作。