入门指南

Astro 是一个现代的静态网站生成工具. 你可以从 我们的主页 或者 我们的 release 公告 中了解到 Astro 的全部内容,本页是 Astro 文档和所有相关资源的概述。

尝试一下 Astro

尝试 Astro 的最简单的方法是在新目录下运行 npm init astro。我们的 CLI 工具会帮助你创建启动一个新的 Astro 项目。

想要快速了解学习使用 Astro, 快速入门.

另外,请阅读我们的 安装指南,了解如何使用 Astro 进行安装的全部步骤。

在线游乐场

如果你有兴趣在浏览器中尝试 Astro,你可以使用一个在线代码游乐场。试试我们在 CodeSandbox 上的 “Hello World!“模板。

注意:一些功能(例如:快速刷新)目前在 CodeSandbox 上是受限的。

学习 Astro

各种各样的人来自不同的背景,带来了不同的学习方式,来到 Astro。无论你喜欢的是理论性强的方法还是实践性强的方法,我们希望你会发现本节内容对你有帮助。

  • 如果你喜欢在实践中学习,请从我们的 实例库 开始学习。

  • 如果你喜欢逐步学习概念,请从我们的基本概念和指南开始。

像任何不熟悉的技术一样,Astro 也有一个轻量化的学习曲线。然而我们相信只要有耐心勤于练习你很快就会掌握诀窍的。

学习 .astro 语法

当你开始学习 Astro 时,你会看到许多文件使用.astro文件扩展名。这是Astro 的组件语法:一种特殊的类似 HTML 的文件格式,Astro 用于模板制作。这样设计是为了让任何有 HTML 或 JSX 经验的人更容易上手。

我们在 Astro 组件 上的有用指南向你介绍了 Astro 语法,这也是学习的最好方法。

API 参考文档

当你想了解某个特定的 Astro API 的更多细节时,这部分文档是有用的。例如 配置参考 列出所有可能的配置选项供你使用。 内置组件参考 列出了所有可用的核心组件,如<Markdown /><Code />

其他版本文档

本文档总是展示 Astro 的最新稳定版本。一旦我们达到 V1.0 的里程碑,我们将增加查看版本文件的能力。

了解最新消息

@astrodotbuild Twitter 账户是 Astro 团队的官方更新来源。

我们也在我们的 Discord 社区 的 #announcements 频道中发布 release 公告。

当然并非每个 Astro 的发布都会有自己的 release 公告,你可以在 Astro 仓库的 CHANGELOG.md文件 中找到每个版本的详细更新日志。

勘误与建议

如果你在阅读的过程中发现文档中缺少什么,或者你发现某些部分令人困惑,请 为文档提交问题 ,提出你的改进建议,或者在 @astrodotbuild Twitter 账户上发推文。我们希望听到你的建议!

参考

本入门指南最初是基于 React 的入门指南。