Skip to content

Commit d67f635

Browse files
authored
Update vercel.mdx from withastro#11497
1 parent 1ecf51b commit d67f635

File tree

1 file changed

+18
-27
lines changed
  • src/content/docs/zh-cn/guides/integrations-guide

1 file changed

+18
-27
lines changed

src/content/docs/zh-cn/guides/integrations-guide/vercel.mdx

+18-27
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
type: integration
33
title: '@astrojs/vercel'
4-
description: 学习如何使用 @astrojs/vercel 服务端渲染适配器来部署你的 Astro 项目。
4+
description: 学习如何使用 @astrojs/vercel 适配器来部署你的 Astro 项目。
55
sidebar:
66
label: Vercel
77
githubIntegrationURL: 'https://github.com/withastro/astro/tree/main/packages/integrations/vercel/'
@@ -13,21 +13,21 @@ import Since from '~/components/Since.astro';
1313
import ReadMore from '~/components/ReadMore.astro'
1414
import { Steps } from '@astrojs/starlight/components';
1515

16-
此适配器允许 Astro 将你的[按需渲染的路由](/zh-cn/guides/on-demand-rendering/) 部署到[Vercel](https://www.vercel.com/)
16+
此适配器允许 Astro 将你的 [按需渲染路由及其功能](/zh-cn/guides/on-demand-rendering/) 部署到 [Vercel](https://www.vercel.com/),包括 [服务器群岛](/zh-cn/guides/server-islands/)[actions](/zh-cn/guides/actions/) 以及 [sessions](/zh-cn/guides/sessions/)
1717

18-
如果你使用 Astro 作为静态站点生成器,只有当你使用额外的 Vercel 服务时(例如 [Vercel 网络分析](https://vercel.com/docs/analytics)[Vercel 图像优化](https://vercel.com/docs/image-optimization)),你才需要这个适配器。否则,你不需要适配器来部署你的 `静态` 站点
18+
如果你使用 Astro 作为静态站点生成器,只有当你使用额外的 Vercel 服务时(例如 [Vercel 网络分析](https://vercel.com/docs/analytics)[Vercel 图像优化](https://vercel.com/docs/image-optimization)),你才需要这个适配器。否则,你不需要适配器来部署你的静态站点
1919

2020
在我们的 [Vercel 部署指南](/zh-cn/guides/deploy/vercel/) 中学习和部署你的 Astro 站点。
2121

22-
## 为什么选择 Astro Vercel
22+
## 为什么选择 Astro Vercel
2323

2424
[Vercel](https://www.vercel.com/) 是一个部署平台,它允许你通过直接连接到 GitHub 仓库来托管你的站点。这个适配器增强了 Astro 的构建过程,为通过 Vercel 进行部署做好了准备。
2525

2626
## 安装
2727

2828
Astro 包含了一个 `astro add` 命令,用于自动设置官方集成。如果你愿意,也可以[手动安装集成](#手动安装)
2929

30-
在 Astro 项目中使用以下 `asrto add` 命令添加 Vercel 适配器,以启用 SSR。这将安装 `@astrojs/vercel` 并一步到位地对你的 `astro.config.mjs` 文件进行相应的更改。
30+
在 Astro 项目中使用以下 `asrto add` 命令添加 Vercel 适配器,以启用按需渲染。这将安装 `@astrojs/vercel` 并一步到位地对你的 `astro.config.mjs` 文件进行相应的更改。
3131

3232
<PackageManagerTabs>
3333
<Fragment slot="npm">
@@ -47,6 +47,8 @@ Astro 包含了一个 `astro add` 命令,用于自动设置官方集成。如
4747
</Fragment>
4848
</PackageManagerTabs>
4949

50+
现在,你可以启用 [对每个页面的按需渲染](/zh-cn/guides/on-demand-rendering/#启用按需渲染),或者将你的构建输出配置设置为 `output: 'server'` 从而 [默认对所有页面都进行服务器端渲染](/zh-cn/guides/on-demand-rendering/#server-模式)
51+
5052
### 手动安装
5153

5254
首先,使用适合你的包管理器,将 `@astrojs/vercel` 适配器添加到你项目的依赖项中:
@@ -69,15 +71,14 @@ Astro 包含了一个 `astro add` 命令,用于自动设置官方集成。如
6971
</Fragment>
7072
</PackageManagerTabs>
7173

72-
然后,将适配器和你想要的[按需渲染模式](/zh-cn/guides/on-demand-rendering/)添加到你的 `astro.config.*` 文件中:
74+
然后,将适配器添加到 `astro.config.*` 文件中:
7375

74-
```js title="astro.config.mjs" ins={2, 6-7}
76+
```js title="astro.config.mjs" ins={2, 6}
7577
import { defineConfig } from 'astro/config';
7678
import vercel from '@astrojs/vercel';
7779

7880
export default defineConfig({
7981
// ...
80-
output: 'server',
8182
adapter: vercel(),
8283
});
8384
```
@@ -107,13 +108,12 @@ vercel deploy --prebuilt
107108

108109
对于 `@vercel/[email protected]` 及更高版本,请使用 Vercel 的 Analytics 组件来启用 [Vercel Web Analytics](https://vercel.com/docs/concepts/analytics)
109110

110-
```js title="astro.config.mjs" ins={8-10}
111+
```js title="astro.config.mjs" ins={7-9}
111112
import { defineConfig } from 'astro/config';
112113
import vercel from '@astrojs/vercel';
113114

114115
export default defineConfig({
115116
// ...
116-
output: 'server',
117117
adapter: vercel({
118118
webAnalytics: {
119119
enabled: true,
@@ -199,13 +199,12 @@ import astroLogo from '../assets/logo.png';
199199

200200
它也可以设置为任意值,以使用自定义图像服务而不是 Astro 的内置图像服务。
201201

202-
```js title="astro.config.mjs" ins={8-9}
202+
```js title="astro.config.mjs" ins={7-8}
203203
import { defineConfig } from 'astro/config';
204204
import vercel from '@astrojs/vercel';
205205

206206
export default defineConfig({
207207
// ...
208-
output: 'server',
209208
adapter: vercel({
210209
imageService: true,
211210
devImageService: 'sharp',
@@ -224,13 +223,12 @@ export default defineConfig({
224223

225224
要启用此功能,在你的 `astro.config.mjs` 中的 Vercel 适配器配置里将 `isr` 设置为 true:
226225

227-
```js title="astro.config.mjs" ins={8}
226+
```js title="astro.config.mjs" ins={7}
228227
import { defineConfig } from 'astro/config';
229228
import vercel from '@astrojs/vercel';
230229

231230
export default defineConfig({
232231
// ...
233-
output: 'server',
234232
adapter: vercel({
235233
isr: true,
236234
}),
@@ -247,13 +245,12 @@ export default defineConfig({
247245

248246
你可以通过配置秒为单位的 `expiration` 值来改变缓存路由的时间长度:
249247

250-
```js title="astro.config.mjs" {8-11}
248+
```js title="astro.config.mjs" {7-10}
251249
import { defineConfig } from 'astro/config';
252250
import vercel from '@astrojs/vercel';
253251

254252
export default defineConfig({
255253
// ...
256-
output: 'server',
257254
adapter: vercel({
258255
isr: {
259256
// 在首次请求时缓存所有页面,并保存 1 天
@@ -267,12 +264,11 @@ export default defineConfig({
267264

268265
要实现 Vercel 的[草稿模式](https://vercel.com/docs/build-output-api/v3/features#draft-mode)[按需增量式静态再生 (ISR)](https://vercel.com/docs/build-output-api/v3/features#on-demand-incremental-static-regeneration-isr),你可以创建一个绕过令牌,并将其连同任何要从缓存中排除的路由一起提供给 `isr` 配置:
269266

270-
```js title="astro.config.mjs" {7-16}
267+
```js title="astro.config.mjs" {6-15}
271268
import { defineConfig } from 'astro/config';
272269
import vercel from '@astrojs/vercel';
273270

274271
export default defineConfig({
275-
output: "server",
276272
adapter: vercel({
277273
isr: {
278274
// 你创建的一个私密随机字符串。
@@ -295,13 +291,12 @@ export default defineConfig({
295291

296292
使用此属性来强制将文件与你的函数打包在一起。当你发现缺失文件时,这很有帮助。
297293

298-
```js title="astro.config.mjs" ins={8}
294+
```js title="astro.config.mjs" ins={7}
299295
import { defineConfig } from 'astro/config';
300296
import vercel from '@astrojs/vercel';
301297

302298
export default defineConfig({
303299
// ...
304-
output: 'server',
305300
adapter: vercel({
306301
includeFiles: ['./my-data.json'],
307302
}),
@@ -315,13 +310,12 @@ export default defineConfig({
315310

316311
使用此属性来从打包过程中排除任何会被包含的文件。
317312

318-
```js title="astro.config.mjs" ins={8}
313+
```js title="astro.config.mjs" ins={7}
319314
import { defineConfig } from 'astro/config';
320315
import vercel from '@astrojs/vercel';
321316

322317
export default defineConfig({
323318
// ...
324-
output: 'server',
325319
adapter: vercel({
326320
excludeFiles: ['./src/some_big_file.jpg'],
327321
}),
@@ -335,13 +329,12 @@ export default defineConfig({
335329

336330
使用这个属性来延长或限制无服务器函数运行的最长持续时间(以秒为单位),直到超时。请参阅 [Vercel 文档](https://vercel.com/docs/functions/serverless-functions/runtimes#maxduration) 获取你的账号计划的默认和最大时限。
337331

338-
```js title="astro.config.mjs" ins={8}
332+
```js title="astro.config.mjs" ins={7}
339333
import { defineConfig } from 'astro/config';
340334
import vercel from '@astrojs/vercel';
341335

342336
export default defineConfig({
343337
// ...
344-
output: "server",
345338
adapter: vercel({
346339
maxDuration: 60
347340
}),
@@ -356,13 +349,12 @@ export default defineConfig({
356349

357350
使用此属性启用 [Vercel Skew protection](https://vercel.com/docs/deployments/skew-protection)(适用于 Vercel Pro 和企业账户)。
358351

359-
```js title="astro.config.mjs" ins={8}
352+
```js title="astro.config.mjs" ins={7}
360353
import { defineConfig } from 'astro/config';
361354
import vercel from '@astrojs/vercel';
362355

363356
export default defineConfig({
364357
// ...
365-
output: "server",
366358
adapter: vercel({
367359
skewProtection: true
368360
}),
@@ -383,7 +375,6 @@ import vercel from '@astrojs/vercel';
383375

384376
export default defineConfig({
385377
// ...
386-
output: 'server',
387378
adapter: vercel({
388379
edgeMiddleware: true,
389380
}),

0 commit comments

Comments
 (0)