使用 pages.zz.ac 发布个人主页

昨天在论坛发布 zz.ID 注册之后，已经有朋友 @MrJonah 完成了他的个人页面。

现在给大家简单整理发布流程。

首先注册 zz.ID。如果你还不了解 zz.ID 请先看 https://sb.sb/t/5241/

然后登录 zz.ID 并绑定自己的 passkey。

接着就可以使用 zz.ID 登录 https://git.zz.ac 了。登录后创建个人页面仓库，并推送代码。

发布之前需要设置 DNS 解析。

假如你的域名是 example.zz.ac 你需要添加两条 DNS 记录

example.zz.ac. CNAME pages.zz.ac.
_zz-pages.example.zz.ac. TXT "repo=alice/website"

第一条是把该域名指向 pages.zz.ac 服务器。
第二条是将该域名授权同 https://git.zz.ac/alice/website 这个仓库相关联。

两条记录缺一不可。设置好之后还需要配置 workflow

在你的仓库中创建.forgejo/workflows/pages.yml，内容如下：

name: Deploy with zz.Pages

on:
  push:
    branches:
      - main

jobs:
  deploy:
    runs-on: zz-pages
    steps:
      - uses: https://data.forgejo.org/actions/checkout@v6
      - uses: https://git.zz.ac/zz/pages@main # 这是发布到 zz.Pages 的 action
        with:
          domain: example.zz.ac
          # 指定构建命令
          build-command: |
            npm ci
            npm run build -- --outDir "$ZZ_PAGES_OUTPUT"

注意需要把生成的 web 内容输出到 $ZZ_PAGES_OUTPUT 保存的目录！

然后推送代码，如果 action 能正常运行发布就成功了。

快来试试吧。