入门指南

Astro 是一个现代的静态网站生成工具. 你可以从 我们的主页 或者 我们的 release 公告 中了解到 Astro 的全部内容,本页是 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 的入门指南。