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): Upgrade to Astro v3 guide for simplified Chinese #4353

Merged
merged 65 commits into from
Aug 30, 2023
Merged
Show file tree
Hide file tree
Changes from 61 commits
Commits
Show all changes
65 commits
Select commit Hold shift + click to select a range
f25ae4d
i18n(zh-cn): uppercase http methods & some update.
liruifengv Aug 24, 2023
64184b4
Update why-astro.mdx
liruifengv Aug 25, 2023
afe503b
Update content-collection.mdx
liruifengv Aug 25, 2023
8ff47b6
Update cloudflare.mdx
liruifengv Aug 25, 2023
0e67ca3
Update markdown-content.mdx
liruifengv Aug 25, 2023
affd6ce
Update styling.mdx
liruifengv Aug 25, 2023
cec4b74
Merge branch 'v3-upgrade-guide' into v3-zh
liruifengv Aug 25, 2023
4776595
Update preact.mdx
liruifengv Aug 25, 2023
3a3933e
Update react.mdx & solid-js.mdx
liruifengv Aug 25, 2023
5611cec
Update cli-reference.mdx
liruifengv Aug 25, 2023
a033711
Update adapter & configuration reference
liruifengv Aug 25, 2023
a51e03a
Update directives reference
liruifengv Aug 25, 2023
36b6ae1
Update integrations reference
liruifengv Aug 25, 2023
4c61de7
Translate missing-sharp.mdx
liruifengv Aug 25, 2023
3c1f377
Remove blank line
liruifengv Aug 25, 2023
35646d9
Update endpoints
liruifengv Aug 25, 2023
98773d1
Merge branch 'v3-upgrade-guide' into v3-zh
liruifengv Aug 25, 2023
17fb7dd
Merge branch 'v3-upgrade-guide' into v3-zh
liruifengv Aug 26, 2023
1ac5e06
Update endpoints
liruifengv Aug 26, 2023
8b484a8
Update view transitions for v3
liruifengv Aug 26, 2023
abdf305
upgrade to v3 translated
liruifengv Aug 26, 2023
c5e27d8
Update src/content/docs/zh-cn/guides/styling.mdx
liruifengv Aug 28, 2023
9c3199e
Update src/content/docs/zh-cn/concepts/why-astro.mdx
liruifengv Aug 28, 2023
7a787ec
Update src/content/docs/zh-cn/concepts/why-astro.mdx
liruifengv Aug 28, 2023
675bdc9
Update src/content/docs/zh-cn/concepts/why-astro.mdx
liruifengv Aug 28, 2023
5c48107
Update src/content/docs/zh-cn/concepts/why-astro.mdx
liruifengv Aug 28, 2023
6de4f81
Update src/content/docs/zh-cn/concepts/why-astro.mdx
liruifengv Aug 28, 2023
768ac01
Update src/content/docs/zh-cn/concepts/why-astro.mdx
liruifengv Aug 28, 2023
adbf72a
Update src/content/docs/zh-cn/guides/integrations-guide/preact.mdx
liruifengv Aug 28, 2023
e189b28
Update src/content/docs/zh-cn/guides/integrations-guide/preact.mdx
liruifengv Aug 28, 2023
afbcf41
Update src/content/docs/zh-cn/guides/integrations-guide/preact.mdx
liruifengv Aug 28, 2023
4d89a8d
Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx
liruifengv Aug 28, 2023
745c5e2
Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx
liruifengv Aug 28, 2023
938cfd8
Update src/content/docs/zh-cn/guides/integrations-guide/react.mdx
liruifengv Aug 28, 2023
91a2674
Update src/content/docs/zh-cn/guides/integrations-guide/solid-js.mdx
liruifengv Aug 28, 2023
05b5649
Update src/content/docs/zh-cn/guides/integrations-guide/solid-js.mdx
liruifengv Aug 28, 2023
4594ced
Update src/content/docs/zh-cn/guides/integrations-guide/react.mdx
liruifengv Aug 28, 2023
cb9c472
Update from v3-guide
liruifengv Aug 28, 2023
2758ee3
Merge branch 'v3-upgrade-guide' into v3-zh
liruifengv Aug 28, 2023
c4880f1
Update src/content/docs/zh-cn/guides/integrations-guide/react.mdx
liruifengv Aug 28, 2023
9aab440
Update src/content/docs/zh-cn/guides/integrations-guide/solid-js.mdx
liruifengv Aug 28, 2023
bbc16b1
Update src/content/docs/zh-cn/reference/directives-reference.mdx
liruifengv Aug 28, 2023
2b3dab6
Update src/content/docs/zh-cn/guides/integrations-guide/preact.mdx
liruifengv Aug 29, 2023
84321e3
Update src/content/docs/zh-cn/guides/integrations-guide/react.mdx
liruifengv Aug 29, 2023
68afa0a
Update src/content/docs/zh-cn/guides/integrations-guide/solid-js.mdx
liruifengv Aug 29, 2023
46af44f
Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx
liruifengv Aug 29, 2023
78bc0e2
Update src/content/docs/zh-cn/reference/configuration-reference.mdx
liruifengv Aug 29, 2023
a50e3a0
Update src/content/docs/zh-cn/reference/configuration-reference.mdx
liruifengv Aug 29, 2023
11e3ff1
Update src/content/docs/zh-cn/reference/integrations-reference.mdx
liruifengv Aug 29, 2023
a04e5f9
Update src/content/docs/zh-cn/reference/integrations-reference.mdx
liruifengv Aug 29, 2023
9ebac31
Update src/content/docs/zh-cn/reference/integrations-reference.mdx
liruifengv Aug 29, 2023
1ba2369
Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx
liruifengv Aug 29, 2023
895518b
Merge branch 'v3-upgrade-guide' into v3-zh
liruifengv Aug 29, 2023
b221de0
Update endpoints.mdx
liruifengv Aug 29, 2023
be5e91b
Update endpoints.mdx
liruifengv Aug 29, 2023
12e7fc7
Update v3.mdx
liruifengv Aug 29, 2023
66c366e
Update v3.mdx
liruifengv Aug 29, 2023
d417ce3
Update src/content/docs/zh-cn/guides/view-transitions.mdx
liruifengv Aug 29, 2023
527bafc
Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx
liruifengv Aug 29, 2023
037e590
Apply suggestions from code review
liruifengv Aug 29, 2023
39d8f73
Merge branch 'v3-upgrade-guide' into v3-zh
liruifengv Aug 30, 2023
c6d7652
Update some from upstream
liruifengv Aug 30, 2023
57b346f
Merge branch 'v3-upgrade-guide' into v3-zh
liruifengv Aug 30, 2023
35d07ae
Update src/content/docs/zh-cn/reference/adapter-reference.mdx
liruifengv Aug 30, 2023
dfd747e
Merge branch 'v3-upgrade-guide' into v3-zh
yanthomasdev Aug 30, 2023
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
43 changes: 16 additions & 27 deletions src/content/docs/zh-cn/concepts/why-astro.mdx
Original file line number Diff line number Diff line change
@@ -1,18 +1,18 @@
---
title: 为什么是 Astro?
description: Astro 是集多功能于一体的Web框架,用于构建快速、以内容为中心的网站。了解更多。
description: Astro 是集多功能于一体的 Web 框架,用于构建快速、以内容为中心的网站。了解更多。
i18nReady: true
---

Astro 是**集多功能于一体的Web框架**,用于构建**快速、以内容为中心的网站**。
Astro 是**集多功能于一体的 Web 框架**,用于构建**快速、以内容为中心的网站**。

为什么选择 Astro 而不是其他的Web框架?以下的五个核心设计原则有助于解释我们为什么要构建 Astro,它需要解决的问题以及为什么 Astro 可能是您的项目或团队的最佳选择
为什么选择 Astro 而不是其他的 Web 框架?以下的五个核心设计原则有助于解释我们为什么要构建 Astro,它需要解决的问题以及为什么 Astro 可能是你的项目或团队的最佳选择

#### Astro是...
#### Astro 是...
1. [ **以内容为中心** ](#以内容为中心):Astro 专为内容丰富的网站而设计。
2. [ **服务器优先** ](#服务器优先):网站在服务器上渲染 HTML 时运行速度更快。
3. [ **默认快速** ](#默认快速):在 Astro 中构建缓慢的网站是不可能的。
4. [ **易于使用** ](#易于使用):您不需要成为专家即可使用 Astro 构建某些内容。
4. [ **易于使用** ](#易于使用):你不需要成为专家即可使用 Astro 构建某些内容。
5. [ **功能齐全且灵活** ](#功能齐全且灵活):超100多种 Astro 集成可供选择。

## 以内容为中心
Expand All @@ -23,26 +23,20 @@ Astro 是**集多功能于一体的Web框架**,用于构建**快速、以内
这是了解 Astro 最重要的区别之一。 Astro 对内容的独特关注让 Astro 能够做出权衡并提供无与伦比的性能特性,而这些特性对于更多以应用程序为中心的 Web 框架来说是没有意义的。

:::tip
如果您的项目属于第二个“应用”阵营,Astro可能不是您项目的正确选择... **没关系!** 查看[Next.js](https://nextjs.org/)以获得比 Astro 更专注于应用程序的替代方案。
如果你的项目属于第二个“应用”阵营,Astro 可能不是你项目的正确选择... **没关系!** 查看 [Next.js](https://nextjs.org/) 以获得比 Astro 更专注于应用程序的替代方案。
:::




## 服务器优先
**Astro 尽可能利用服务器渲染而不是客户端渲染。** 这与传统服务器端框架(PHP、WordPress、Laravel、Ruby on Rails等)使用的方法相同,您不需要学习第二种服务端语言。 Astro 仍然使用 HTML、CSS和JavaScript(或TypeScript)。
**Astro 尽可能利用服务器渲染而不是客户端渲染。** 这与传统服务器端框架(PHP、WordPress、Laravel、Ruby on Rails等)使用的方法相同,你不需要学习第二种服务端语言。 Astro 仍然使用 HTML、CSS和JavaScript(或TypeScript)。

这种方法与其他现代 JavaScript Web框架 形成鲜明对比,如 Next.JS、SvelteKit、Nuxt、Remix 等。这些框架需要整个网站的客户端和服务器端渲染,以解决性能问题,这种方法被称为**单页应用程序(SPA),** 与 Astro 的**多页应用程序(MPA)** 方式形成鲜明对比。
这种方法与其他现代 JavaScript Web 框架 形成鲜明对比,如 Next.JS、SvelteKit、Nuxt、Remix 等。这些框架需要整个网站的客户端和服务器端渲染,以解决性能问题,这种方法被称为**单页应用程序(SPA),** 与 Astro 的**多页应用程序(MPA)** 方式形成鲜明对比。

SPA模式有它的优势。然而,这些都是以牺牲额外的复杂性和性能权衡为代价,这些权衡会损坏页面性能——包括[可交互时间(TTI)](https://web.dev/interactive/) 等关键指标——这对于以内容为中心的网站没有多大意义,因为这些网站的首次加载性能至关重要。

📚 [进一步了解 **Astro MPA** 架构的独特之处](/zh-cn/concepts/mpa-vs-spa/)




## 默认快速
良好的性能很重要,对于以内容为中心的网站尤其至关重要。事实证明,糟糕的表现会让您失去参与度、转化率和金钱。列如:
良好的性能很重要,对于以内容为中心的网站尤其至关重要。事实证明,糟糕的表现会让你失去参与度、转化率和金钱。列如:
- 每快 100ms → 转化率增加 1% ([Mobify](https://web.dev/why-speed-matters/), 收入 +$380,000/年)
- 每快 50% → 销售额增加 12% ([AutoAnything](https://www.digitalcommerce360.com/2010/08/19/web-accelerator-revs-conversion-and-sales-autoanything/))
- 每快 20% → 转换率增加 10% ([Furniture Village](https://www.thinkwithgoogle.com/intl/en-gb/marketing-strategies/app-and-mobile/furniture-village-and-greenlight-slash-page-load-times-boosting-user-experience/))
Expand All @@ -56,26 +50,21 @@ Astro 的魔力在于它如何将上述两个值(内容焦点于服务器优

与使用最受欢迎的 React Web框架 构建相同的网站进行比较,Astro 网站的[加载速度快40%,JavaScript减少90%](https://twitter.com/t3dotgg/status/1437195415439360003) 。请对我们的结论半信半疑:观看 Astro 的现场直播 让 Ryan Carniato(Solid.js和Marko的创造者) [无言以对](https://youtu.be/2ZEMb_H-LYE?t=8163)。



## 易于使用
**Astro的目标是让每位Web开发人员都可以访问。** Astro 被设计成熟悉和平易近人的感觉,无论技能水平或过去的Web开发经验如何
**Astro 的目标是让每位 Web 开发者都易于理解。** Astro 被设计成熟悉和平易近人的感觉,无论技能水平或过去的 Web 开发经验如何

我们首先确保您可以使用您已经了解的任何喜欢的 UI 组件语言。在 Astro 项目中创建新的 UI 组件时使用 React、Preact、Svelte、Vue、Solid、Lit 和其他一些组件都是被支持的。
我们首先确保你可以使用你已经了解的任何喜欢的 UI 组件语言。在 Astro 项目中创建新的 UI 组件时使用 React、Preact、Svelte、Vue、Solid、Lit 和其他一些组件都是被支持的。

我们为了 Astro 也能有一个很好的内置组件语言,我们创建了自己 `.astro` UI语言。它很大程度上深受 HTML 的影响:任何有效的 HTML 部分都已经是有效的 Astro 组件,它还结合了我们从其他组件中借用的一些功能,如:React 的 JSX 表达式和(像 Svelte 和 Vue 一样的)默认 CSS 作用域。这种与 HTML 的相似性也使得使用渐进式增强和通用可访问性模式变得更加容易,而无需任何开销。

Astro 的设计比其他UI框架和语言更简单,其中一个重要原因是 Astro 被设计为在服务器上渲染而不是浏览器,这意味着您无需担心:React Hooks、stale closures(React)、refs(Vue)、observables(Svelte)、atoms、selectors、reactions or derivations。服务器上没有响应式,因此这些复杂性都消失了。

我们最喜欢的谚语之一是:**选择加入复杂性。** 我们设计 Astro 是为了尽可能多地从开发人员体验中消除“所需的复杂性”,尤其是您首次加入时。您可以在 Astro中使用 HTML和CSS构建“Hello World”示例网站。然后当您需要构建更强大的功能时,您可以随时获得新功能和API。


Astro 的设计比其他UI框架和语言更简单,其中一个重要原因是 Astro 被设计为在服务器上渲染而不是浏览器,这意味着你无需担心:hooks (React)、stale closures (还是 React)、refs (Vue)、observables (Svelte)、atoms、selectors、reactions、或 derivations。服务器上没有响应式,因此这些复杂性都消失了。

我们最喜欢的说法之一是:**复杂性是可选的。** 我们设计 Astro 是为了尽可能多地从开发人员体验中消除“必须的复杂性”,尤其是你首次加入时。你可以在 Astro 中使用 HTML 和 CSS 构建 “Hello World” 示例网站。然后当你需要构建更强大的功能时,你可以随时获得新功能和 API。

## 功能齐全且灵活

**Astro 是集多功能于一体的 Web 框架,提供了构建网站所需的一切** Astro 包括组件语法、基于文件的路由、静态资源处理、构建处理、捆绑、优化、数据获取等。您可以在不超过 Astro 核心功能集 的情况下构建出色的网站
**Astro 是集多功能于一体的 Web 框架,提供了构建网站所需的一切** Astro 包括组件语法、基于文件的路由、静态资源处理、构建处理、捆绑、优化、数据获取等。你只使用 Astro 核心功能集就可构建出色的网站

如果您需要更多的控制,你可以通过 [React](https://www.npmjs.com/package/@astrojs/react), [Svelte](https://www.npmjs.com/package/@astrojs/svelte), [Vue](https://www.npmjs.com/package/@astrojs/vue), [Tailwind CSS](https://www.npmjs.com/package/@astrojs/tailwind), [MDX](https://www.npmjs.com/package/@astrojs/mdx), [image optimizations](https://www.npmjs.com/package/@astrojs/image)等[100多个集成](https://astro.build/integrations/)。 扩展 Astro 只需要一个命令 [即可连接您喜欢的CMS](/zh-cn/guides/cms/) 或 [部署到您喜欢的服务器](/zh-cn/guides/deploy/)
如果你需要更多的控制,你可以通过 [React](https://www.npmjs.com/package/@astrojs/react), [Svelte](https://www.npmjs.com/package/@astrojs/svelte), [Vue](https://www.npmjs.com/package/@astrojs/vue), [Tailwind CSS](https://www.npmjs.com/package/@astrojs/tailwind), [MDX](https://www.npmjs.com/package/@astrojs/mdx) 等[100多个集成](https://astro.build/integrations/)。 扩展 Astro 只需要一个命令 [即可连接你喜欢的 CMS](/zh-cn/guides/cms/) 或 [部署到你喜欢的托管平台](/zh-cn/guides/deploy/)

Astro 与 UI 无关,这意味着您可以自带 UI 框架(BYOF)。React、Preact、Solid 、Svelte、Vue 和 Lit 都在 Astro 中得到官方支持。您甚至可以在同一页面上混合和匹配不同的框架,使未来的迁移更容易,并防止项目锁定到单个框架。
Astro 与 UI 无关,这意味着你可以自带 UI 框架(BYOF)。React、Preact、Solid 、Svelte、Vue 和 Lit 都在 Astro 中得到官方支持。你甚至可以在同一页面上混合和匹配不同的框架,使未来的迁移更容易,并防止项目锁定到单个框架。
Loading