部署你的 Astro 站点至 GitHub Pages

你可以使用 GitHub Pages 直接从 GitHub 上的存储库托管 Astro 网站。

如何部署

你可以使用 GitHub Actions 将 Astro 站点自动构建和部署到 GitHub Pages。为此，你的源代码必须托管在 GitHub 上。

Astro 维护了一个官方的 GitHub Action withastro/action 来帮助你部署项目；你只需很少的配置，就可以完成部署。按照下面的说明可以将你的 Astro 站点部署到 GitHub Pages，如果你需要更多信息，请参阅这个包的 README。

在配置文件设置 site，并在 astro.config.mjs 中根据需要设置 base 选项。
astro.config.mjs
```
import { defineConfig } from 'astro/config'

export default defineConfig({
  site: 'https://astronaut.github.io',
  base: '/my-repo',
})
```
- site 应当为 https://<YOUR_USERNAME>.github.io 或 https://my-custom-domain.com
- base 应当是你的存储库的名称，以正斜杠（/）开头，例如 /my-repo。这是为了告诉 Astro 你的网站的根目录是 /my-repo，而非默认的 /。
注意
如果出现了以下情况，则不要设置 base 参数：
- 你的页面是由根文件夹所提供。
- 你的源码存储库是位于 https://github.com/<USERNAME>/<USERNAME>.github.io。
- 你使用了自定义域名。
警告
如果你以前没有设置 base，并且只是配置此值以便部署到 GitHub，你可能需要根据 base 更新你的内部页面链接。
<a href="/my-repo/about">关于本站</a>

在你的项目中的 .github/workflows/ 目录创建一个新文件 deploy.yml，并粘贴以下 YAML 配置信息。

name: Deploy to GitHub Pages

on:
  # 每次推送到 `main` 分支时触发这个“工作流程”
  # 如果你使用了别的分支名，请按需将 `main` 替换成你的分支名
  push:
    branches: [ main ]
  # 允许你在 GitHub 上的 Actions 标签中手动触发此“工作流程”
  workflow_dispatch:

# 允许 job 克隆 repo 并创建一个 page deployment
permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout your repository using git
        uses: actions/checkout@v3
      - name: Install, build, and upload your site
        uses: withastro/action@v1
        # with:
          # path: . # 存储库中 Astro 项目的根位置。（可选）
          # node-version: 18 # 用于构建站点的特定 Node.js 版本，默认为 18。（可选）
          # package-manager: pnpm@latest # 应使用哪个 Node.js 包管理器来安装依赖项和构建站点。会根据存储库中的 lockfile 自动检测。（可选）

  deploy:
    needs: build
    runs-on: ubuntu-latest
    environment:
      name: github-pages
      url: ${{ steps.deployment.outputs.page_url }}
    steps:
      - name: Deploy to GitHub Pages
        id: deployment
        uses: actions/deploy-pages@v1