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

Question

我在 Github Pages 上使用 Hugo，每当我将我的网站推送到 origin 时，我都会收到以下错误消息:

The page build failed for the master branch with the following error: There was a YAML syntax error on line 2 column 1 in <unknown>: did not find >expected key while parsing a block mapping. For more information, see >https://help.github.com/articles/page-build-failed-invalid-yaml-in-data-file/. For information on troubleshooting Jekyll see: https://help.github.com/articles/troubleshooting-jekyll-builds If you have any questions you can contact us by replying to this email.

我该如何解决这个问题？我听说在根目录下制作一个 .nojekyll 文件有帮助，但我不知道该怎么做

我在网上尝试了一些没有用的解决方案，我在根目录下创建了一个 nojekyll.nojekyll 文件，希望能禁用 Jekyll，如果这是问题所在...

Answer 1

使用.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 阅读更多内容。 ).