diff --git a/src/content/docs/zh-cn/guides/integrations-guide.mdx b/src/content/docs/zh-cn/guides/integrations-guide.mdx
index b6bd138b5302a..01c128af303b8 100644
--- a/src/content/docs/zh-cn/guides/integrations-guide.mdx
+++ b/src/content/docs/zh-cn/guides/integrations-guide.mdx
@@ -2,6 +2,7 @@
title: 使用集成
i18nReady: true
---
+
import IntegrationsNav from '~/components/IntegrationsNav.astro';
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
@@ -16,13 +17,19 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
- 为你的项目添加新功能,如自动生成网站地图。
- 编写自定义代码,与构建过程、开发服务器等挂钩。
+:::tip[集成目录]
+在我们的 [集成目录](https://astro.build/integrations/) 中浏览或搜索数百个官方和社区集成的完整集成。在这里你找到可以添加到你的 Astro 项目中的包,涵盖了身份验证、分析、性能、SEO、无障碍、UI、开发者工具等场景。
+:::
+
## 官方集成
+以下集成由 Astro 维护。
+
## 自动集成设置
-使用 Astro 的 `astro add` 命令来自动设置集成。
+Astro 包含了一个 `astro add` 命令来自动设置官方集成。许多社区插件也可以使用这个命令添加。请查阅每个集成的文档,以确定是否支持 `astro add`,或者你是否需要[手动安装](#手动安装)。
只需用你的包管理器运行 `astro add` 命令,我们的自动集成向导将更新你的配置文件并安装任何必要的依赖。
@@ -68,12 +75,12 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
如果你在添加集成后看到 `"Cannot find package '[package-name]'` 或其他类似警告,这意味着你的包管理器可能没有安装[对等依赖](https://nodejs.org/en/blog/npm/peer-dependencies/)。要安装这些缺失的包,请运行 `npm install [package-name]`。
:::
-## 使用集成
+## 手动安装
Astro 集成总是添加在 `astro.config.mjs` 文件中的 `integrations` 属性。
有三种常见的方法来导入集成到你的 Astro 项目:
-1. 安装 npm 包集成。
+1. [安装 npm 包集成](#安装-npm-包)。
2. 从项目内部的本地文件导入你自己的集成。
3. 直接在配置文件中内联编写集成。
@@ -97,6 +104,47 @@ Astro 集成总是添加在 `astro.config.mjs` 文件中的 `integrations` 属
查看[集成 API](/zh-cn/reference/integrations-reference/) 参考资料,了解所有不同的集成编写方式。
+#### 安装 NPM 包
+
+使用包管理器安装 NPM 包集成,然后手动更新 `astro.config.mjs`。
+
+例如,安装 `@astrojs/sitemap` 集成:
+
+1. 使用你偏好的包管理器将集成安装到项目依赖中:
+
+
+
+ ```shell
+ npm install @astrojs/sitemap
+ ```
+
+
+ ```shell
+ pnpm install @astrojs/sitemap
+ ```
+
+
+ ```shell
+ yarn add @astrojs/sitemap
+ ```
+
+
+
+2. 将集成导入到你的 `astro.config.mjs` 文件,并将其连同任何配置选项添加到你的 `integrations[]` 数组中:
+
+ ```js title="astro.config.mjs" ins={2} ins="sitemap()"
+ import { defineConfig } from 'astro/config';
+ import sitemap from '@astrojs/sitemap';
+
+ export default defineConfig({
+ // ...
+ integrations: [sitemap()],
+ // ...
+ });
+ ```
+
+ 请注意,不同的集成可能有不同的配置设置。阅读每个集成的文档,并将任何必要的配置选项应用到 `astro.config.mjs` 中你所选择的集成上。
+
### 自定义选项
集成几乎都是以工厂函数的形式编写的,并返回真实的集成对象。这使得你可以通过向工厂函数传递参数和选项定制集成。