Merge pull request #969 from vitejs/sync-caa5ad93-1

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

Author: waynzh

.vitepress/theme/composables/sponsor.ts

@@ -64,6 +64,16 @@ const viteSponsors: Pick<Sponsors, 'special' | 'gold'> = {
       img: '/transloadit.svg',
       hasDark: true,
     },
+    {
+      name: 'Huly',
+      url: 'https://huly.io/',
+      img: '/huly.svg',
+    },
+    {
+      name: 'Handsontable',
+      url: 'https://handsontable.com/docs/react-data-grid/?utm_source=vite_docs&utm_medium=sponsorship&utm_campaign=library_sponsorship_2024',
+      img: '/handsontable.svg',
+    },
   ],
 }
 

guide/api-javascript.md

@@ -422,3 +422,30 @@ async function loadConfigFromFile(
 ```
 
 手动通过 esbuild 加载一份 Vite 配置。
+
+## `preprocessCSS`
+
+- **实验性：** [提供反馈](https://github.com/vitejs/vite/discussions/13815)
+
+**类型签名：**
+
+```ts
+async function preprocessCSS(
+  code: string,
+  filename: string,
+  config: ResolvedConfig,
+): Promise<PreprocessCSSResult>
+
+interface PreprocessCSSResult {
+  code: string
+  map?: SourceMapInput
+  modules?: Record<string, string>
+  deps?: Set<string>
+}
+```
+
+预处理 `.css`、`.scss`、`.sass`、`.less`、`.styl` 和 `.stylus` 文件，将它们转化为纯 CSS，这样就可以在浏览器中使用或者被其他工具解析了。这和 [内置的 CSS 预处理器](/guide/features#css-pre-processors) 很像，如果你使用了这个功能，则必须安装相应的预处理器。
+
+使用哪个预处理器是根据 `filename` 的扩展名来推断的。如果 `filename` 以 `.module.{ext}` 结尾，那么它就会被推断为 [CSS module](https://github.com/css-modules/css-modules)，返回的结果会包含一个 `modules` 对象，这个对象将原始的类名映射到转换后的类名。
+
+需要注意的是，预处理不会解析 `url()` 或 `image-set()` 中的 URL。

guide/features.md

@@ -211,7 +211,7 @@ export default defineConfig({
 
 Vite 通过 `postcss-import` 预配置支持了 CSS `@import` 内联，Vite 的路径别名也遵从 CSS `@import`。换句话说，所有 CSS `url()` 引用，即使导入的文件在不同的目录中，也总是自动变基，以确保正确性。
 
-Sass 和 Less 文件也支持 `@import` 别名和 URL 变基（具体请参阅 [CSS Pre-processors](#css-pre-processors)）。
+Sass 和 Less 文件也支持 `@import` 别名和 URL 变基（具体请参阅 [CSS 预处理器](#css-pre-processors)）。
 
 ### PostCSS {#postcss}
 

package.json

@@ -15,10 +15,10 @@
 		"vite": "^5.1.6",
 		"feed": "^4.2.2",
 		"yorkie": "^2.0.0",
-    "@shikijs/vitepress-twoslash": "^1.6.2",
-    "@types/express": "^4.17.21",
-    "vitepress": "1.2.2",
-    "vue": "^3.4.27"
+		"@shikijs/vitepress-twoslash": "^1.6.3",
+		"@types/express": "^4.17.21",
+		"vitepress": "1.2.3",
+		"vue": "^3.4.27"
 	},
 	"scripts": {
 		"dev": "vitepress dev .",