diff options
Diffstat (limited to 'docs/src/pages/zh-CN/getting-started.md')
-rw-r--r-- | docs/src/pages/zh-CN/getting-started.md | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/docs/src/pages/zh-CN/getting-started.md b/docs/src/pages/zh-CN/getting-started.md new file mode 100644 index 000000000..c5f5dbe25 --- /dev/null +++ b/docs/src/pages/zh-CN/getting-started.md @@ -0,0 +1,62 @@ +--- +layout: ~/layouts/MainLayout.astro +title: 入门指南 +lang: zh-CN +--- + +Astro 是一个现代的静态网站生成工具. 你可以从 [我们的主页](https://astro.build/) 或者 [我们的 release 公告](https://astro.build/blog/introducing-astro) 中了解到 Astro 的全部内容,本页是 Astro 文档和所有相关资源的概述。 + +想快速了解一下什么是 Astro ? [浏览我们的主页](https://astro.build) + +## 尝试一下 Astro + +尝试 Astro 的最简单的方法是在新目录下运行 `npm init astro`。我们的 CLI 工具会帮助你创建启动一个新的 Astro 项目。 + +想要快速了解学习使用Astro, [快速入门](quick-start). + +另外,请阅读我们的 [安装指南](/installation),了解如何使用 Astro 进行安装的全部步骤。 + +### 在线游乐场 + +如果你有兴趣在浏览器中尝试 Astro,你可以使用一个在线代码游乐场。试试我们在 [CodeSandbox](https://codesandbox.io/s/astro-template-hugb3) 上的 "Hello World!"模板。 + +注意:一些功能(例如:快速刷新)目前在 CodeSandbox 上是受限的。 + +## 学习 Astro + +各种各样的人来自不同的背景,带来了不同的学习方式,来到 Astro。无论你喜欢的是理论性强的方法还是实践性强的方法,我们希望你会发现本节内容对你有帮助。 + +- 如果你喜欢在**实践中**学习,请从我们的 [实例库](https://github.com/snowpackjs/astro/tree/main/examples) 开始学习。 + +- 如果你喜欢**逐步学习概念**,请从我们的[基本概念和指南](/core-concepts/project-structure)开始。 + +像任何不熟悉的技术一样,Astro 也有一个轻量化的学习曲线。然而我们相信只要有耐心勤于练习你很快就会掌握诀窍的。 + +### 学习 `.astro` 语法 + +当你开始学习 Astro 时,你会看到许多文件使用`.astro`文件扩展名。这是**Astro的组件语法**:一种特殊的类似HTML 的文件格式,Astro 用于模板制作。这样设计是为了让任何有 HTML 或 JSX 经验的人更容易上手。 + +我们在 [Astro组件](/corecepts/astro-components) 上的有用指南向你介绍了 Astro 语法,这也是学习的最好方法。 +### API 参考文档 + +当你想了解某个特定的 Astro API 的更多细节时,这部分文档是有用的。例如 [配置参考](/reference/configuration-reference) 列出所有可能的配置选项供你使用。 [内置组件参考](/reference/builtin-components) 列出了所有可用的核心组件,如`<Markdown />`和`<Prism />`。 + +### 其他版本文档 + +本文档总是展示 Astro 的最新稳定版本。一旦我们达到 V1.0 的里程碑,我们将增加查看版本文件的能力。 + +## 了解最新消息 + +[@astrodotbuild](https://twitter.com/astrodotbuild) Twitter 账户是 Astro 团队的官方更新来源。 + +我们也在我们的 [Discord社区](https://astro.build/chat) 的 #announcements 频道中发布 release 公告。 + +当然并非每个 Astro 的发布都会有自己的 release 公告,你可以在 Astro 仓库的 [`CHANGELOG.md`文件](https://github.com/snowpackjs/astro/blob/main/packages/astro/CHANGELOG.md) 中找到每个版本的详细更新日志。 + +## 勘误与建议 + +如果你在阅读的过程中发现文档中缺少什么,或者你发现某些部分令人困惑,请 [为文档提交问题](https://github.com/snowpackjs/astro/issues/new/choose) ,提出你的改进建议,或者在 [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter账户上发推文。我们希望听到你的建议! + +## 参考 + +本入门指南最初是基于 [React](https://reactjs.org/) 的入门指南。 |