在 github 页面上安装 Hugo Academic blogdown 时出错

Question

我一直在尝试使用 blogdown 和学术模板创建个人网站：

blogdown::new_site(theme = "gcushen/hugo-academic")

但是，当我尝试将网站附加到 github 页面时，我收到了错误：

our site is having problems building: The variable {{2\left( {x + 4} on line 58 in content/slides/example-slides.md was not properly closed with }}. For more information, see https://help.github.com/articles/page-build-failed-tag-not-properly-terminated/.

它看起来正确终止了......但无论如何，我试图删除该文件，但是即使删除它也会出现同样的错误。

网站是https://github.com/sebastiz/SebastianZekiCV/

Answer 1

为了通过 github 页面发布用户站点：

1) 存储库的名称必须是 .github.io 在这种情况下，页面将从您的 master 分支（或 gh-pages 分支 - 您的选择）的 HEAD 提供。存储库的根是站点的根。

2) 存储库的名称可以是任何名称。在这种情况下，它将来自 master 分支，但来自 /docs 目录。

无论哪种情况，github 页面都会运行 Jekyll。阻止它的唯一方法是只有“静态”文件 - 例如CSS、html页面、图片等

您可以做的是创建两个存储库 - 一个将是您的源；另一个将是实际提供的页面。您可以使用hugo -d <path> 告诉hugo 在“输出”存储库的克隆根目录中构建其输出。

延伸阅读：

github pages help configuring source

hugo command reference

Answer 2

对于这个问题，建议的理想解决方案是为代码和静态内容创建单独的存储库。但是，可以通过禁用 Jekyll 来解决该错误。

在存储库的根目录下创建一个名为 .nojekyll 的文件。

然后您可以继续从 master 分支的 docs/ 目录中选择 publishDir = "docs" 和服务器。