GitHub Pages自定义域名设置在新提交时被重置

Question

我有一个使用Zola生成的静态网站，我正在使用GitHub Actions来构建我的静态网站并将其发布到存储库的gh-pages分支中。我还配置了我的项目，以便使用gh-pages分支通过GitHub pages进行服务。

我面临的问题是，只要我的GitHub Action构建新版本并将其推送到gh-pages分支，GitHub设置中的自定义域设置就会被重置。

以下是我在GitHub操作中执行的构建和推送到目标分支(gh-pages)分支的步骤：

  - name: Commit and push to target branch
    run: |-
      git config --global user.email "[e-mail]"
      git config --global user.name "workflow-bot"
      git checkout --orphan $TARGET_BRANCH
      rm -rf .github/
      mv public ..
      rm -rf *
      mv ../public/* .
      touch .nojekyll
      touch README.md
      echo 'https://www.bigelectrons.com - SITE GENERATED USING ZOLA' > README.md
      git add .
      git commit -m "generated using zola build"
      git push --set-upstream origin $TARGET_BRANCH --force

你有任何想法这个问题是什么，以及我如何解决它？

- joesan

Answer 1

我刚刚需要在我的gh-pages分支上添加一个CNAME文件。例如，在运行命令中，我需要添加这两行：

touch CNAME
echo 'mydomain.com' > CNAME

- joesan

Answer 2

如果您在GitHub页面上使用Zola，解决方案甚至更简单。 只需在static/文件夹中创建一个带有自定义域名的CNAME文件，它应该就能正常工作。

您可以在Zola官方页面上查看文档：https://www.getzola.org/documentation/deployment/github-pages/#custom-domain

- JesusValera

Answer 3

我知道这与 Zola 无关，但我在使用 Mkdocs 时遇到了相同的错误。

文档说明需要在 docs_dir 目录中创建 CNAME 文件，以便他们的 gh-deploy 脚本可以获取该文件，并将其复制到 gh-pages 分支的正确位置（请参阅此处的文档 here）。

值得一提的是，使用 Github 开发者设置页面设置自定义域名也会执行完全相同的操作，即在 gh-pages 分支的根目录下创建 CNAME 文件。

- Alex