[ci] yarn format
This commit is contained in:
FredKSchott
GitHub Actions
parent
2bd178d4f9
commit
08b442dcf5
5 changed files with 22 additions and 18 deletions
|
|
@ -4,6 +4,6 @@ title: 模板样例
|
|||
lang: zh-CN
|
||||
---
|
||||
|
||||
如果你喜欢通过实例来学习，请查看我们在GitHub上的[模板样例](https://github.com/snowpackjs/astro/tree/main/examples)
|
||||
如果你喜欢通过实例来学习，请查看我们在 GitHub 上的[模板样例](https://github.com/snowpackjs/astro/tree/main/examples)
|
||||
|
||||
<!-- Once we merge astro-docs back into the main repo, we can actually fetch the list of examples at build-time by scanning the examples/ directory! -->
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ Astro 是一个现代的静态网站生成工具. 你可以从 [我们的主页]
|
|||
|
||||
尝试 Astro 的最简单的方法是在新目录下运行 `npm init astro`。我们的 CLI 工具会帮助你创建启动一个新的 Astro 项目。
|
||||
|
||||
想要快速了解学习使用Astro， [快速入门](quick-start).
|
||||
想要快速了解学习使用 Astro， [快速入门](quick-start).
|
||||
|
||||
另外，请阅读我们的 [安装指南](/installation)，了解如何使用 Astro 进行安装的全部步骤。
|
||||
|
||||
|
|
@ -34,12 +34,13 @@ Astro 是一个现代的静态网站生成工具. 你可以从 [我们的主页]
|
|||
|
||||
### 学习 `.astro` 语法
|
||||
|
||||
当你开始学习 Astro 时，你会看到许多文件使用`.astro`文件扩展名。这是**Astro的组件语法**：一种特殊的类似HTML 的文件格式，Astro 用于模板制作。这样设计是为了让任何有 HTML 或 JSX 经验的人更容易上手。
|
||||
当你开始学习 Astro 时，你会看到许多文件使用`.astro`文件扩展名。这是**Astro 的组件语法**：一种特殊的类似 HTML 的文件格式，Astro 用于模板制作。这样设计是为了让任何有 HTML 或 JSX 经验的人更容易上手。
|
||||
|
||||
我们在 [Astro 组件](/corecepts/astro-components) 上的有用指南向你介绍了 Astro 语法，这也是学习的最好方法。
|
||||
|
||||
我们在 [Astro组件](/corecepts/astro-components) 上的有用指南向你介绍了 Astro 语法，这也是学习的最好方法。
|
||||
### API 参考文档
|
||||
|
||||
当你想了解某个特定的 Astro API 的更多细节时，这部分文档是有用的。例如 [配置参考](/reference/configuration-reference) 列出所有可能的配置选项供你使用。 [内置组件参考](/reference/builtin-components) 列出了所有可用的核心组件，如`<Markdown />`和`<Prism />`。
|
||||
当你想了解某个特定的 Astro API 的更多细节时，这部分文档是有用的。例如 [配置参考](/reference/configuration-reference) 列出所有可能的配置选项供你使用。 [内置组件参考](/reference/builtin-components) 列出了所有可用的核心组件，如`<Markdown />`和`<Prism />`。
|
||||
|
||||
### 其他版本文档
|
||||
|
||||
|
|
@ -49,13 +50,13 @@ Astro 是一个现代的静态网站生成工具. 你可以从 [我们的主页]
|
|||
|
||||
[@astrodotbuild](https://twitter.com/astrodotbuild) Twitter 账户是 Astro 团队的官方更新来源。
|
||||
|
||||
我们也在我们的 [Discord社区](https://astro.build/chat) 的 #announcements 频道中发布 release 公告。
|
||||
我们也在我们的 [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账户上发推文。我们希望听到你的建议!
|
||||
如果你在阅读的过程中发现文档中缺少什么，或者你发现某些部分令人困惑，请 [为文档提交问题](https://github.com/snowpackjs/astro/issues/new/choose) ，提出你的改进建议，或者在 [@astrodotbuild](https://twitter.com/astrodotbuild) Twitter 账户上发推文。我们希望听到你的建议!
|
||||
|
||||
## 参考
|
||||
|
||||
|
|
|
|||
|
|
@ -51,7 +51,7 @@ npm init astro my-astro-project -- --template [GITHUB_USER]/[REPO_NAME]/path/to/
|
|||
npm install
|
||||
```
|
||||
|
||||
你现在可以[开发](#start-astro)你的 Astro 项目。一旦你完成了 Astro 项目的开发，你就可以[构建](#build-astro)你的项目。然后Astro会把你的应用程序打包，并准备好静态文件，让你[部署](/guides/deploy)到你最喜欢的托管服务商。
|
||||
你现在可以[开发](#start-astro)你的 Astro 项目。一旦你完成了 Astro 项目的开发，你就可以[构建](#build-astro)你的项目。然后 Astro 会把你的应用程序打包，并准备好静态文件，让你[部署](/guides/deploy)到你最喜欢的托管服务商。
|
||||
|
||||
## 手动安装
|
||||
|
||||
|
|
@ -71,9 +71,10 @@ cd my-astro-project
|
|||
# 初始化项目并生成的默认的 package.json
|
||||
npm init --yes
|
||||
```
|
||||
|
||||
Astro 被设计为与整个 npm 软件包生态系统一起工作。这是由项目根目录下的 `package.json` 管理的。
|
||||
|
||||
如果你不熟悉 `package.json` 文件，我们强烈建议你在[npm文档](https://docs.npmjs.com/creating-a-package-json-file)上快速阅读它。
|
||||
如果你不熟悉 `package.json` 文件，我们强烈建议你在[npm 文档](https://docs.npmjs.com/creating-a-package-json-file)上快速阅读它。
|
||||
|
||||
### 安裝 Astro
|
||||
|
||||
|
|
@ -95,7 +96,8 @@ npm install astro
|
|||
},
|
||||
}
|
||||
```
|
||||
[`start`](#start-astro) 命令在 `http://localhost:3000` 上启动Astro开发服务器。一旦你的项目准备好了。
|
||||
|
||||
[`start`](#start-astro) 命令在 `http://localhost:3000` 上启动 Astro 开发服务器。一旦你的项目准备好了。
|
||||
|
||||
[`build`](#build-astro)命令将你的项目输出到 `dist/` 目录。[在部署指南中阅读更多关于部署 Astro 的内容。](/guides/deploy)
|
||||
|
||||
|
|
@ -134,7 +136,7 @@ console.log('See me in the Terminal')
|
|||
|
||||
以上是 Astro 组件语法的一个例子，同時包含 HTML 和 JSX。
|
||||
|
||||
你可以在 `src/pages` 目录下创建更多的页面，Astro将使用该文件名在你的网站上创建新的页面。例如，通过在 `src/pages/about.astro` 创建一个新的文件（重复使用以前的片段），Astro 将生成一个新的页面，URL为：`http://localhost/about` 。
|
||||
你可以在 `src/pages` 目录下创建更多的页面，Astro 将使用该文件名在你的网站上创建新的页面。例如，通过在 `src/pages/about.astro` 创建一个新的文件（重复使用以前的片段），Astro 将生成一个新的页面，URL 为：`http://localhost/about` 。
|
||||
|
||||
## [启动 Astro](#start-astro)
|
||||
|
||||
|
|
|
|||
|
|
@ -28,7 +28,7 @@ npm run build
|
|||
|
||||
## 启动项目
|
||||
|
||||
工程目录下终端输入以下命令：
|
||||
工程目录下终端输入以下命令：
|
||||
|
||||
```bash
|
||||
npm start
|
||||
|
|
@ -41,7 +41,7 @@ Astro 会开启预览服务器，地址为 [http://localhost:3000](http://localh
|
|||
|
||||
## 打包项目
|
||||
|
||||
工程目录下终端输入以下命令：
|
||||
工程目录下终端输入以下命令：
|
||||
|
||||
```bash
|
||||
npm run build
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ Astro 是一個現代的靜態網站生成工具. 你可以從 [我們的主頁]
|
|||
|
||||
嘗試 Astro 的最簡單的方法是在新目錄下運行 『npm init astro』。 我們的 CLI 工具會説明你創建啟動一個新的 Astro 專案。
|
||||
|
||||
想要快速了解學習使用Astro， [快速入門指南]（quick-start）.
|
||||
想要快速了解學習使用 Astro， [快速入門指南]（quick-start）.
|
||||
|
||||
另外，請閱讀我們的 [安裝指南]（/installation），瞭解如何使用 Astro 進行安裝的全部步驟。
|
||||
|
||||
|
|
@ -34,9 +34,10 @@ Astro 是一個現代的靜態網站生成工具. 你可以從 [我們的主頁]
|
|||
|
||||
### 學習 '.astro' 語法
|
||||
|
||||
當你開始學習 Astro 時，你會看到許多檔使用『.astro』檔擴展名。 這是**Astro的元件語法**：一種特殊的類似HTML 的檔格式，Astro 用於範本製作。 這樣設計是為了讓任何有 HTML 或 JSX 經驗的人更容易上手。
|
||||
當你開始學習 Astro 時，你會看到許多檔使用『.astro』檔擴展名。 這是**Astro 的元件語法**：一種特殊的類似 HTML 的檔格式，Astro 用於範本製作。 這樣設計是為了讓任何有 HTML 或 JSX 經驗的人更容易上手。
|
||||
|
||||
我們在 [Astro 元件]（/corecepts/astro-components） 上的有用指南向你介紹了 Astro 語法，這也是學習的最好方法。
|
||||
|
||||
我們在 [Astro元件]（/corecepts/astro-components） 上的有用指南向你介紹了 Astro 語法，這也是學習的最好方法。
|
||||
### API 參考文檔
|
||||
|
||||
當你想了解某個特定的 Astro API 的更多細節時，這部分文檔是有用的。 例如 [配置參考]（/reference/configuration-reference） 列出所有可能的配置選項供你使用。 [內置元件參考] （/reference/builtin-components） 列出了所有可用的核心元件，如『<Markdown />』和『<Prism />』。
|
||||
|
|
@ -49,13 +50,13 @@ Astro 是一個現代的靜態網站生成工具. 你可以從 [我們的主頁]
|
|||
|
||||
[@astrodotbuild] (https://twitter.com/astrodotbuild) Twitter 帳戶是 Astro 團隊的官方更新來源。
|
||||
|
||||
我們也在我們的 [Discord社區]（https://astro.build/chat） 的 #announcements 頻道中發佈 release 公告。
|
||||
我們也在我們的 [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帳戶上發推文。 我們希望聽到你的建議！
|
||||
如果你在閱讀的過程中發現文檔中缺少什麼，或者你發現某些部分令人困惑，請 [為文檔提交問題]（https://github.com/snowpackjs/astro/issues/new/choose） ，提出你的改進建議，或者在 [@astrodotbuild]（https://twitter.com/astrodotbuild） Twitter 帳戶上發推文。 我們希望聽到你的建議！
|
||||
|
||||
## 參考
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue