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 some integrations-guides #5832

Merged
merged 5 commits into from
Dec 20, 2023
Merged
Show file tree
Hide file tree
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
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ Alpine.js 集成不允许你控制脚本的加载或初始化方式。如果你

## 示例

* [Astro Alpine.js 示例](https://github.com/withastro/astro/tree/latest/examples/framework-alpine) 演示了如何在 Astro 项目中使用 Alpine.js。
* [Astro Alpine.js 示例](https://github.com/withastro/astro/tree/latest/examples/framework-alpine) 演示了如何在 Astro 项目中使用 Alpine.js。

## 故障排除

Expand Down
147 changes: 75 additions & 72 deletions src/content/docs/zh-cn/guides/integrations-guide/cloudflare.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -54,8 +54,8 @@ npm install @astrojs/cloudflare

这个配置选项定义了你的 Astro 项目如何部署到 Cloudflare Pages。

* `advanced` 模式会获取 `dist` 文件夹中的 `_worker.js` 文件。
* `directory` 模式会获取 `functions` 文件夹中的文件,默认只会生成一个 `[[path]].js` 文件。
* `advanced` 模式会获取 `dist` 文件夹中的 `_worker.js` 文件。
* `directory` 模式会获取 `functions` 文件夹中的文件,默认只会生成一个 `[[path]].js` 文件。

切换到 `directory` 模式允许你手动添加额外的文件例如 [Cloudflare Pages 插件](https://developers.cloudflare.com/pages/platform/functions/plugins/)、[Cloudflare Pages 中间件](https://developers.cloudflare.com/pages/platform/functions/middleware/) 甚至使用了 [Cloudflare Pages 函数路由](https://developers.cloudflare.com/pages/platform/functions/routing/) 的自定义函数。

Expand Down Expand Up @@ -93,49 +93,49 @@ export default defineConfig({

这有三个选项可供选择:

* **`"auto"`(默认)**:自动选择生成最少条目的策略。这通常应该够用了,除非你有某些理由要选择其他选项。
* **`include`**:不会被预渲染的页面和端点将会被列为 `include` 条目,并告诉 Cloudflare 将这些路由作为函数调用。而 `exclude` 条目仅用于解决冲突。通常情况下,如果你的网站大多数是静态页面,只有少数动态页面或端点时,这将是最好的策略。


示例:对于 `src/pages/index.astro`(静态),`src/pages/company.astro`(静态),`src/pages/users/faq.astro`(静态),以及 `/src/pages/users/[id].astro` (SSR),将产生以下 `_routes.json`:

```json
{
"version": 1,
"include": [
"/_image", // Astro 的图片端点
"/users/*" // 动态路由
],
"exclude": [
// 排除上述动态通配符路由中后的静态路由
"/users/faq/",
"/users/faq/index.html"
]
}
```

* **`exclude`:** 预渲染的页面将被列为 `exclude` 条目(即告诉 Cloudflare 将这些路由作为静态资源处理)。通常情况下,如果你的网站大多数是动态页面或端点,只有少数静态页面时,这将是最好的策略。

示例:对于前面示例中相同的页面,这将产生以下 `_routes.json`:

```json
{
"version": 1,
"include": [
"/*" // 除了后面的路由外,所有路由都会被作为函数处理
],
"exclude": [
// 所有静态资源
"/",
"/company/",
"/index.html",
"/users/faq/",
"/favicon.png",
"/company/index.html",
"/users/faq/index.html"
]
}
```
* **`"auto"`(默认)**:自动选择生成最少条目的策略。这通常应该够用了,除非你有某些理由要选择其他选项。
* **`include`**:不会被预渲染的页面和端点将会被列为 `include` 条目,并告诉 Cloudflare 将这些路由作为函数调用。而 `exclude` 条目仅用于解决冲突。通常情况下,如果你的网站大多数是静态页面,只有少数动态页面或端点时,这将是最好的策略。


示例:对于 `src/pages/index.astro`(静态),`src/pages/company.astro`(静态),`src/pages/users/faq.astro`(静态),以及 `/src/pages/users/[id].astro` (SSR),将产生以下 `_routes.json`:

```json
{
"version": 1,
"include": [
"/_image", // Astro 的图片端点
"/users/*" // 动态路由
],
"exclude": [
// 排除上述动态通配符路由中后的静态路由
"/users/faq/",
"/users/faq/index.html"
]
}
```

* **`exclude`:** 预渲染的页面将被列为 `exclude` 条目(即告诉 Cloudflare 将这些路由作为静态资源处理)。通常情况下,如果你的网站大多数是动态页面或端点,只有少数静态页面时,这将是最好的策略。

示例:对于前面示例中相同的页面,这将产生以下 `_routes.json`:

```json
{
"version": 1,
"include": [
"/*" // 除了后面的路由外,所有路由都会被作为函数处理
],
"exclude": [
// 所有静态资源
"/",
"/company/",
"/index.html",
"/users/faq/",
"/favicon.png",
"/company/index.html",
"/users/faq/index.html"
]
}
```

### `routes.include`

Expand Down Expand Up @@ -175,8 +175,8 @@ export default defineConfig({

控制适配器使用哪个图像服务。当配置了不兼容的图像服务时,适配器将默认到 `passthrough` 模式。否则,它将使用全局配置的图像服务:

* **`cloudflare`:** 使用 [Cloudflare Image Resizing](https://developers.cloudflare.com/images/image-resizing/) 服务。
* **`passthrough`:** 使用现有的 [`noop`](/zh-cn/guides/images/#配置-no-op-透传服务) 服务。
* **`cloudflare`:** 使用 [Cloudflare Image Resizing](https://developers.cloudflare.com/images/image-resizing/) 服务。
* **`passthrough`:** 使用现有的 [`noop`](/zh-cn/guides/images/#配置-no-op-透传服务) 服务。

### `wasmModuleImports`

Expand Down Expand Up @@ -213,13 +213,13 @@ export default defineConfig({

`type` 属性定义了你的 Astro 项目将部署到哪:

* `pages`:部署到 [Cloudflare Pages](https://pages.cloudflare.com/)
* `workers`:部署到 [Cloudflare Workers](https://workers.cloudflare.com/)
* `pages`:部署到 [Cloudflare Pages](https://pages.cloudflare.com/)
* `workers`:部署到 [Cloudflare Workers](https://workers.cloudflare.com/)

`mode` 属性则定义了你希望运行时在 `astro dev` 中支持什么:

* `off`:使用 `astro dev` 时无法访问运行时。当你需要访问运行时来模拟本地的生产环境时,可以选择[使用 Wrangler 预览](#使用-wrangler-预览)。
* `local`:使用由 miniflare 和 workerd 驱动的本地运行时,它支持 Cloudflare 绑定。只有当你想使用不支持的功能,如 `eval`,或没有本地支持的绑定时,才选择[使用 Wrangler 预览](#使用-wrangler-预览)。
* `off`:使用 `astro dev` 时无法访问运行时。当你需要访问运行时来模拟本地的生产环境时,可以选择[使用 Wrangler 预览](#使用-wrangler-预览)。
* `local`:使用由 miniflare 和 workerd 驱动的本地运行时,它支持 Cloudflare 绑定。只有当你想使用不支持的功能,如 `eval`,或没有本地支持的绑定时,才选择[使用 Wrangler 预览](#使用-wrangler-预览)。

在 `mode: local` 中,你可以访问 `persistTo` 属性,它定义了本地绑定状态保存的位置。这避免了每次重启开发服务器时都刷新绑定。这个值是相对于你执行 `astro dev` 的路径的一个目录。默认情况下它被设置为 `.wrangler/state/v3`,以允许使用 `wrangler` 命令行工具(例如用于迁移)。将这个路径会添加到你的 `.gitignore` 中。

Expand All @@ -229,11 +229,11 @@ Cloudflare 运行时让你能够访问环境变量和 Cloudflare 绑定。你可

目前支持的绑定有:

* 环境变量
* [Cloudflare Workers KV](https://developers.cloudflare.com/kv/)
* [Cloudflare D1](https://developers.cloudflare.com/d1/)
* [Cloudflare R2](https://developers.cloudflare.com/r2/)
* [Cloudflare Durable Objects](https://developers.cloudflare.com/durable-objects/)
* 环境变量
* [Cloudflare Workers KV](https://developers.cloudflare.com/kv/)
* [Cloudflare D1](https://developers.cloudflare.com/d1/)
* [Cloudflare R2](https://developers.cloudflare.com/r2/)
* [Cloudflare Durable Objects](https://developers.cloudflare.com/durable-objects/)

### Config

Expand Down Expand Up @@ -285,8 +285,10 @@ export default defineConfig({

如果你还需要定义 `secrets` 以外的环境变量,你需要在 Astro 项目的根目录下添加一个 `.dev.vars` 文件:

# .dev.vars
DB_PASSWORD=myPassword
```
# .dev.vars
DB_PASSWORD=myPassword
```

如果你想使用 `wrangler` 进行命令行操作,比如 D1 迁移,你还需要在 Astro 项目的根目录下添加一个包含正确内容的 `wrangler.toml` 文件。请查阅[Cloudflare 的文档](https://developers.cloudflare.com/)以获取更多详细信息。

Expand Down Expand Up @@ -340,9 +342,10 @@ class_name = "DO"

如果你还需要定义 `secrets` 以外的环境变量,你需要在 Astro 项目的根目录下添加一个 `.dev.vars` 文件:

# .dev.vars
DB_PASSWORD=myPassword

```
# .dev.vars
DB_PASSWORD=myPassword
```

### 用例

Expand Down Expand Up @@ -464,17 +467,17 @@ export async function GET(context) {

Astro 的 Cloudflare 适配器允许你使用任何 Cloudflare 支持的 Node.js 运行时 API,例如:

* assert
* AsyncLocalStorage
* Buffer
* Crypto
* Diagnostics Channel
* EventEmitter
* path
* process
* Streams
* StringDecoder
* util
* assert
* AsyncLocalStorage
* Buffer
* Crypto
* Diagnostics Channel
* EventEmitter
* path
* process
* Streams
* StringDecoder
* util

如果要使用这些 API,你的页面或端点必须是服务器渲染的(而不是预渲染的),并使用 `import {} from 'node:*'` 导入语法。

Expand Down
10 changes: 5 additions & 5 deletions src/content/docs/zh-cn/guides/integrations-guide/lit.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,8 @@ i18nReady: true

Astro 包含一个用于添加第一方集成的 CLI 工具:`astro add`。这个命令将:

1. (可选) 安装所有必要的依赖和同行依赖
2. (同样可选) 更新你的 `astro.config.*` 文件来应用这个集成
1. (可选) 安装所有必要的依赖和同行依赖
2. (同样可选) 更新你的 `astro.config.*` 文件来应用这个集成

要安装 `@astrojs/lit`,请从项目目录运行以下命令并按照提示操作:

Expand Down Expand Up @@ -66,9 +66,9 @@ npm install lit @webcomponents/template-shadowroot

要在 Astro 中使用你的第一个 Lit 组件,你可以移步我们的 [UI 框架文档][astro-ui-frameworks]。你将会了解到:

* 📦 如何加载框架组件
* 💧 客户端水合选项
* 🤝 混合和嵌套框架的机会
* 📦 如何加载框架组件
* 💧 客户端水合选项
* 🤝 混合和嵌套框架的机会

在 Astro 中编写和导入 Lit 组件的代码如下:

Expand Down
14 changes: 7 additions & 7 deletions src/content/docs/zh-cn/guides/integrations-guide/markdoc.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -181,8 +181,8 @@ export default defineMarkdocConfig({

所有的 Markdown 标题都会渲染 `Heading.astro` 组件,并将以下 `attributes` 作为组件的 props 传递:

* `level: number` 标题级别 1 - 6
* `id: string` 从标题的文本内容生成的 `id`。这对应于 [内容 `render()` 函数生成的 `slug`](/zh-cn/guides/content-collections/#将内容渲染成-html)。
* `level: number` 标题级别 1 - 6
* `id: string` 从标题的文本内容生成的 `id`。这对应于 [内容 `render()` 函数生成的 `slug`](/zh-cn/guides/content-collections/#将内容渲染成-html)。

例如,标题 `### Level 3 heading!` 将会传递 `level: 3` 和 `id: 'level-3-heading'` 作为组件的 props。

Expand Down Expand Up @@ -362,10 +362,10 @@ export default defineMarkdocConfig({
]
```
`schema` 属性 包含了为 Astro 内容集合配置语言服务器的所有信息。它接受以下属性:
* `path`: 配置文件的路径。
* `type`: 配置文件使用的模块类型(`esm` 允许 `import` 语法)。
* `property`: 包含配置对象的导出属性名称。
* `watch`: 告诉服务器监听配置中的更改。
* `path`: 配置文件的路径。
* `type`: 配置文件使用的模块类型(`esm` 允许 `import` 语法)。
* `property`: 包含配置对象的导出属性名称。
* `watch`: 告诉服务器监听配置中的更改。
顶级 `path` 属性告诉服务器内容位于哪里。由于 Markdoc 是特定于内容集合的,因此可以使用 `src/content`。

### 传递 Markdoc 变量
Expand Down Expand Up @@ -489,7 +489,7 @@ Astro Markdoc 集成处理了在 `markdoc.config.js` 文件中不可用的 Markd

## 示例

* [Astro Markdoc 入门模板](https://github.com/withastro/astro/tree/latest/examples/with-markdoc) 展示了如何在你的 Astro 项目中使用 Markdoc 文件。
* [Astro Markdoc 入门模板](https://github.com/withastro/astro/tree/latest/examples/with-markdoc) 展示了如何在你的 Astro 项目中使用 Markdoc 文件。

## 故障排除

Expand Down
18 changes: 9 additions & 9 deletions src/content/docs/zh-cn/guides/integrations-guide/mdx.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -76,10 +76,10 @@ Astro 的 MDX 集成为标准的 MDX 增加了额外的功能,包括 Markdown

你可以通过以下选项配置你的 MDX 的渲染方式:

* [继承自 Markdown 配置的选项](#继承自-markdown-配置的选项)
* [`extendMarkdownConfig`](#extendmarkdownconfig)
* [`recmaPlugins`](#recmaplugins)
* [`优化`](#优化)
* [继承自 Markdown 配置的选项](#继承自-markdown-配置的选项)
* [`extendMarkdownConfig`](#extendmarkdownconfig)
* [`recmaPlugins`](#recmaplugins)
* [`优化`](#优化)

### 继承自 Markdown 配置的选项

Expand Down Expand Up @@ -114,8 +114,8 @@ MDX 不支持以字符串形式传递备注和 rehype 插件。你应该安装

### `extendMarkdownConfig`

* **类型:** `boolean`
* **默认值:** `true`
* **类型:** `boolean`
* **默认值:** `true`

MDX 将默认扩展[你的项目现有的 Markdown 配置](/zh-cn/reference/configuration-reference/#markdown-选项)。要覆盖个别选项,你可以在你的 MDX 配置中进行等价配置。

Expand Down Expand Up @@ -175,7 +175,7 @@ export default defineConfig({

### 优化

* **类型:** `boolean | { customComponentNames?: string[] }`
* **类型:** `boolean | { customComponentNames?: string[] }`

这是一个可选的配置设置,用于优化 MDX 输出,以便通过内部 rehype 插件加快构建和渲染速度。如果你的 MDX 文件较多,并注意到构建速度较慢,这可能会很有用。不过,该选项可能会生成一些未转义的 HTML,因此请确保你网站的交互式部分在启用该选项后仍能正常工作。

Expand All @@ -197,7 +197,7 @@ export default defineConfig({

#### customComponentNames

* **类型:** `string[]`
* **类型:** `string[]`

`optimize` 的一个可选属性,用于防止 MDX 优化器处理[通过组件属性传递给导入的 MDX 内容的任何自定义组件](/zh-cn/guides/markdown-content/#使用导入的-mdx-的自定义组件)。

Expand Down Expand Up @@ -239,7 +239,7 @@ export default defineConfig({

## 例子

* [Astro MDX 启动模板](https://github.com/withastro/astro/tree/latest/examples/with-mdx)显示了如何在你的 Astro 项目中使用 MDX 文件。
* [Astro MDX 启动模板](https://github.com/withastro/astro/tree/latest/examples/with-mdx)显示了如何在你的 Astro 项目中使用 MDX 文件。

## 故障排除

Expand Down
Loading
Loading