Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

i18n(zh-cn): Update guides/integrations-guide.mdx #5925

Merged
merged 2 commits into from
Dec 24, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
54 changes: 51 additions & 3 deletions src/content/docs/zh-cn/guides/integrations-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,7 @@
title: 使用集成
i18nReady: true
---

import IntegrationsNav from '~/components/IntegrationsNav.astro';
import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'

Expand All @@ -16,13 +17,19 @@ import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro'
- 为你的项目添加新功能,如自动生成网站地图。
- 编写自定义代码,与构建过程、开发服务器等挂钩。

:::tip[集成目录]
在我们的 [集成目录](https://astro.build/integrations/) 中浏览或搜索数百个官方和社区集成的完整集成。在这里你找到可以添加到你的 Astro 项目中的包,涵盖了身份验证、分析、性能、SEO、无障碍、UI、开发者工具等场景。
:::

## 官方集成

以下集成由 Astro 维护。

<IntegrationsNav />

## 自动集成设置

使用 Astro `astro add` 命令来自动设置集成
Astro 包含了一个 `astro add` 命令来自动设置官方集成。许多社区插件也可以使用这个命令添加。请查阅每个集成的文档,以确定是否支持 `astro add`,或者你是否需要[手动安装](#手动安装)

只需用你的包管理器运行 `astro add` 命令,我们的自动集成向导将更新你的配置文件并安装任何必要的依赖。

Expand Down Expand Up @@ -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. 直接在配置文件中内联编写集成。

Expand All @@ -97,6 +104,47 @@ Astro 集成总是添加在 `astro.config.mjs` 文件中的 `integrations` 属

查看[集成 API](/zh-cn/reference/integrations-reference/) 参考资料,了解所有不同的集成编写方式。

#### 安装 NPM 包

使用包管理器安装 NPM 包集成,然后手动更新 `astro.config.mjs`。

例如,安装 `@astrojs/sitemap` 集成:

1. 使用你偏好的包管理器将集成安装到项目依赖中:

<PackageManagerTabs>
<Fragment slot="npm">
```shell
npm install @astrojs/sitemap
```
</Fragment>
<Fragment slot="pnpm">
```shell
pnpm install @astrojs/sitemap
```
</Fragment>
<Fragment slot="yarn">
```shell
yarn add @astrojs/sitemap
```
</Fragment>
</PackageManagerTabs>

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` 中你所选择的集成上。

### 自定义选项

集成几乎都是以工厂函数的形式编写的,并返回真实的集成对象。这使得你可以通过向工厂函数传递参数和选项定制集成。
Expand Down