From 7619964f61fe98c95dee347711da30428bc3bd2d Mon Sep 17 00:00:00 2001 From: liruifengv Date: Thu, 22 Aug 2024 00:15:26 +0800 Subject: [PATCH] i18n(zh-cn): update some docs from 4.14 (#9142) * i18n(zh-cn): update some docs from 4.14 * i18n(zh-cn): update `vercel.mdx` --------- Co-authored-by: Yan <61414485+yanthomasdev@users.noreply.github.com> --- .../docs/zh-cn/guides/integrations-guide/cloudflare.mdx | 2 +- .../docs/zh-cn/guides/integrations-guide/netlify.mdx | 1 - .../docs/zh-cn/guides/integrations-guide/vercel.mdx | 7 ++++++- src/content/docs/zh-cn/guides/middleware.mdx | 3 ++- src/content/docs/zh-cn/guides/typescript.mdx | 2 +- src/content/docs/zh-cn/install-and-setup.mdx | 7 ------- 6 files changed, 10 insertions(+), 12 deletions(-) diff --git a/src/content/docs/zh-cn/guides/integrations-guide/cloudflare.mdx b/src/content/docs/zh-cn/guides/integrations-guide/cloudflare.mdx index 45994c33a9a5a..0faebbd5dbd33 100644 --- a/src/content/docs/zh-cn/guides/integrations-guide/cloudflare.mdx +++ b/src/content/docs/zh-cn/guides/integrations-guide/cloudflare.mdx @@ -288,7 +288,7 @@ const myVariable = env.MY_VARIABLE; 你可以使用 `Runtime` 来为 `runtime` 对象添加类型： ```ts title="src/env.d.ts" -/// +/// type Runtime = import('@astrojs/cloudflare').Runtime; diff --git a/src/content/docs/zh-cn/guides/integrations-guide/netlify.mdx b/src/content/docs/zh-cn/guides/integrations-guide/netlify.mdx index 8173a42fc1eb0..7b2f9c364e50a 100644 --- a/src/content/docs/zh-cn/guides/integrations-guide/netlify.mdx +++ b/src/content/docs/zh-cn/guides/integrations-guide/netlify.mdx @@ -111,7 +111,6 @@ const { ```ts title="src/env.d.ts" /// -/// type NetlifyLocals = import('@astrojs/netlify').NetlifyLocals diff --git a/src/content/docs/zh-cn/guides/integrations-guide/vercel.mdx b/src/content/docs/zh-cn/guides/integrations-guide/vercel.mdx index c61514e778166..99458c35cd9eb 100644 --- a/src/content/docs/zh-cn/guides/integrations-guide/vercel.mdx +++ b/src/content/docs/zh-cn/guides/integrations-guide/vercel.mdx @@ -376,6 +376,12 @@ export default defineConfig({ ### 函数打包配置 +:::caution[已废弃] +`functionPerRoute` 选项已被弃用，并将在 Astro 5 中完全删除。此外，此选项与一些 Astro 功能不兼容，例如 i18n 域和请求重写。 + +如果你当前已启用 `functionPerRoute: true`，我们建议尽快删除此配置选项。 +::: + Vercel 适配器默认将所有路由组合成一个函数。 你也可以使用 `functionPerRoute` 选项将构建拆分为每个路由一个函数。这样可以减少每个函数的大小，这意味着你不太可能超过单个函数的大小限制。并且，代码启动更快。 @@ -419,7 +425,6 @@ export default defineConfig({ ```ts /// -/// type EdgeLocals = import('@astrojs/vercel').EdgeLocals diff --git a/src/content/docs/zh-cn/guides/middleware.mdx b/src/content/docs/zh-cn/guides/middleware.mdx index 0e213caff1b6b..3c6e9e734a707 100644 --- a/src/content/docs/zh-cn/guides/middleware.mdx +++ b/src/content/docs/zh-cn/guides/middleware.mdx @@ -141,7 +141,8 @@ export const onRequest = (context, next) => { 要给 `Astro.locals` 内的信息定义类型，也就是在 `.astro` 文件和中间件代码中能提供自动补全，在 `env.d.ts` 文件中声明一个全局命名空间： ```ts title="src/env.d.ts" -/// +/// + declare namespace App { interface Locals { user: { diff --git a/src/content/docs/zh-cn/guides/typescript.mdx b/src/content/docs/zh-cn/guides/typescript.mdx index 2a8d79c2c1b49..b49e939094060 100644 --- a/src/content/docs/zh-cn/guides/typescript.mdx +++ b/src/content/docs/zh-cn/guides/typescript.mdx @@ -32,7 +32,7 @@ Astro 中包含三个可扩展的 `tsconfig.json` 模板：`base`、`strict` 和 此外，我们的模板在 `src` 文件夹中包含一个名为 `env.d.ts` 的文件，它为你的项目提供 [Vite 的客户端类型](https://cn.vitejs.dev/guide/features.html#client-types)： ```typescript title="env.d.ts" -/// +/// ``` ### TypeScript 编辑器插件 diff --git a/src/content/docs/zh-cn/install-and-setup.mdx b/src/content/docs/zh-cn/install-and-setup.mdx index 6a42ed095927c..78f60b25d4dd1 100644 --- a/src/content/docs/zh-cn/install-and-setup.mdx +++ b/src/content/docs/zh-cn/install-and-setup.mdx @@ -392,12 +392,6 @@ Astro 将在一个单独的文件夹（默认为 `dist/`）中构建你的网站 } ``` - 最后，创建 `src/env.d.ts`，让 TypeScript 知道 Astro 项目中可用的环境类型： - - ```ts title="src/env.d.ts" - /// - ``` - 阅读 Astro 的 [TypeScript 设置指南](/zh-cn/guides/typescript/#设置) 以获取更多信息。 7. 接下来 @@ -411,7 +405,6 @@ Astro 将在一个单独的文件夹（默认为 `dist/`）中构建你的网站 - src/ - pages/ - index.astro - - env.d.ts - astro.config.mjs - package-lock.json 或 `yarn.lock`、`pnpm-lock.yaml` 等。 - package.json