新手上路

Astro 是利用現代技術的靜態網站生成工具。可以從首頁釋出版本貼文來了解 Astro 的用途。此頁面是 Astro 文件與所有相關資源的概要。

在找 Astro 的簡易概要?請看首頁

試用 Astro

試用 Astro 最簡單的方法,就是在機器的新資料夾裡執行 npm init astro。我們製作的 CLI 精靈會協助開啟全新的 Astro 專案。

簡易又迅速 5 步驟就開始使用 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 最新的穩定版本。一但達到 1.0 里程碑,會增加查閱過去文件版本的功能。

獲得最新訊息

推特帳號 @astrodotbuild 是 Astro 團隊撰寫的官方更新消息來源。

我們也會把釋出版本公告貼在 Discord 社群 的 #announcements 頻道。

不是每個 Astro 釋出版本都會有一篇專屬的部落格貼文。然而,還是可以在 Astro 的 Repository 裡的 CHANGELOG.md 檔案,找到每個釋出版本的詳細變動記錄。

還漏了什麼嗎?

如果文件裡有東西沒寫到,或是覺得有些地方很難理解,請開文件的 Issue,附上改進建議,或推文到推特帳號 @astrodotbuild。我們喜愛聽到回饋!

參考

這份新手上路指南一開始是根據 React 的新手上路指南。