Sourcehut 页面

在Sourcehut Pages上部署静态 Zola 网站非常简单。

您需要.build.yml在 Zola 项目的根文件夹中创建一个清单文件，并将您的更改推送到 Sourcehut git/hg 存储库。要创建您的文件，您可以从模板.build.yml开始或使用以下示例：

image: alpine/edge
packages:
  - hut
  - zola
oauth: pages.sr.ht/PAGES:RW
environment:
  site: your_username.srht.site
sources:
  - https://git.sr.ht/~your_username/my-website
tasks:
  - build: |
      cd my-website
      zola build
  - package: |
      cd my-website
      tar -C public -cvz . > ../site.tar.gz
  - upload: |
      hut pages publish -d $site site.tar.gz

此清单将克隆您的源代码、构建网站并将生成的静态文件上传到您在 中指定的域site。为了发布网站，构建清单使用hut，一个负责自动生成身份验证令牌的命令行工具，因此您无需执行任何其他操作。

site从这个模板中，您需要使用将托管您的网站的域 自定义变量，并sources指向您的 Sourcehut git/hg 公共 URL（在本例中my-website是存储库的名称）。

然后提交并推送您的更改：

$ git push
Enumerating objects: 5, done.
...
remote: Build started:
remote: https://builds.sr.ht/~your_username/job/430625 [.build.yml]
To git.sr.ht:~your_username/www
   fbe9afa..59ae556  master -> master

构建作业将自动触发。请注意，Sourcehut 会返回构建页面的直接链接，您可以在其中检查进度和成功状态。

默认情况下，您可以使用 Sourcehut Pages 的子域来托管您的静态网站 - your_username.srht.site. 如果您想使用自定义域（例如“blog.mydomain.org”），您需要配置一个 DNS 记录以指向 Sourcehut 服务器。Sourcehut上提供了有关如何执行此操作的说明。