Skip to content

Commit

Permalink
i18n(zh-cn): Upgrade to Astro v3 guide for simplified Chinese (#4353)
Browse files Browse the repository at this point in the history 
* i18n(zh-cn): uppercase http methods & some update.

* Update why-astro.mdx

* Update content-collection.mdx

* Update cloudflare.mdx

* Update markdown-content.mdx

* Update styling.mdx

* Update preact.mdx

* Update react.mdx & solid-js.mdx

* Update cli-reference.mdx

* Update adapter & configuration reference

* Update directives reference

* Update integrations reference

* Translate missing-sharp.mdx

* Remove blank line

* Update endpoints

* Update endpoints

* Update view transitions for v3

* upgrade to v3 translated

* Update src/content/docs/zh-cn/guides/styling.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/concepts/why-astro.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/concepts/why-astro.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/concepts/why-astro.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/concepts/why-astro.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/concepts/why-astro.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/concepts/why-astro.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/integrations-guide/preact.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/integrations-guide/preact.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/integrations-guide/preact.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/integrations-guide/react.mdx

* Update src/content/docs/zh-cn/guides/integrations-guide/solid-js.mdx

* Update src/content/docs/zh-cn/guides/integrations-guide/solid-js.mdx

* Update src/content/docs/zh-cn/guides/integrations-guide/react.mdx

* Update from v3-guide

* Update src/content/docs/zh-cn/guides/integrations-guide/react.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/integrations-guide/solid-js.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/reference/directives-reference.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/integrations-guide/preact.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/integrations-guide/react.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/integrations-guide/solid-js.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/reference/configuration-reference.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/reference/configuration-reference.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/reference/integrations-reference.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/reference/integrations-reference.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/reference/integrations-reference.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Update endpoints.mdx

* Update endpoints.mdx

* Update v3.mdx

* Update v3.mdx

* Update src/content/docs/zh-cn/guides/view-transitions.mdx

Co-authored-by: Xiaoyue Lin <36526527+100gle@users.noreply.github.com>

* Update src/content/docs/zh-cn/guides/upgrade-to/v3.mdx

Co-authored-by: Genteure <genteure@gmail.com>

* Apply suggestions from code review

Co-authored-by: Genteure <genteure@gmail.com>

* Update some from upstream

* Update src/content/docs/zh-cn/reference/adapter-reference.mdx

Co-authored-by: Xiaoyue Lin <36526527+100gle@users.noreply.github.com>

---------

Co-authored-by: Genteure <genteure@gmail.com>
Co-authored-by: Xiaoyue Lin <36526527+100gle@users.noreply.github.com>
Co-authored-by: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
  • Loading branch information
@liruifengv @Genteure
@100gle @yanthomasdev
4 people authored Aug 30, 2023
1 parent 0ecb373 commit 44e1d3e
Show file tree
Hide file tree
Showing 47 changed files with 1,653 additions and 455 deletions.
43 changes: 16 additions & 27 deletions src/content/docs/zh-cn/concepts/why-astro.mdx
View file
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

0 comments on commit 44e1d3e

Please sign in to comment.