由于 YAML 错误，Hugo 无法使用 GitHub Pages 构建

Question

我在 Github 页面上使用 Hugo，每当我将网站推送到源站时，我都会收到此错误消息发送到我的电子邮件：

master 分支的页面构建失败，出现以下错误： <unknown>:did not find >expected key while parsing a block mapping 的第 2 行第 1 列存在 YAML 语法错误。有关详细信息，请参阅 >https://help.github.com/articles/page-build-failed-invalid-yaml-in-data-file/。 有关 Jekyll 故障排除的信息，请参阅： https://help.github.com/articles/troubleshooting-jekyll-builds 如果您有任何问题，可以回复此电子邮件与我们联系。

我该如何解决这个问题？我听说在 root 中制作 .nojekyll 文件会有所帮助，但我不知道该怎么做

我在网上尝试了一些不起作用的解决方案，我在 root 中创建了一个 nojekyll.nojekyll 文件，希望禁用 Jekyll，如果这是问题...

Answer 1

我也遇到了这个问题！我认为最简单的解决方案是：

1. 将您的源代码放入一个分支，例如来源
2. 仅在主分支上部署您的站点。

在此处查看如何使用 github 操作模板为 hugo 进行设置：https://github.com/peaceiris/actions-gh-pages

这是我的 gh-pages.yaml

1. 设置源分支

   name: Publish Site
   on: 
   push:
       branches:
       - source  # default branch
   

2. 设置publish_branch: master，不然不行

   - name: Deploy
       uses: peaceiris/actions-gh-pages@v3
       with:
           deploy_key: ${{ secrets.SSH_DEPLOY_KEY }}
           publish_dir: ./public
           publish_branch: master  # deploying branch  
   

Answer 2

使用.nojekyll 告诉Github 不要使用Jekyll 处理您的文件，因此在您构建站点后，只需将.nojekyll 文件放在gh-page 的根目录或docs 文件夹中。

例如，将 Hugo 生成的所有文件移动到 docs 文件夹中，并在 /docs 中放置一个 .nojekyll 空文件。然后选择 docs 文件夹作为 Github 页面文件的容器，Github 将提供这些文件。

如果你想看一个活生生的例子，我在这个主题 https://github.com/marcanuy/simpleit-hugo-theme 中使用了这种方法并且工作正常，结果网站在 https://marcanuy.github.io/simpleit-hugo-theme/ 使用以下 Make 自动完成的秘诀：

generate-githubpages:
    rm -fr docs && HUGO_ENV=production $(HUGO) --baseURL https://marcanuy.github.io/simpleit-hugo-theme/ --source=exampleSite --themesDir=../.. --config ../config-github-docs.toml && mv exampleSite/public docs && touch docs/.nojekyll
clean:
    rm -fr exampleSite/public/

您可以在Publishing your GitHub Pages site from a /docs folder on your master branch阅读更多内容。