Hugo 网站未在 Github 页面中呈现答案

【问题标题】：Hugo website not rendering in Github pagesHugo 网站未在 Github 页面中呈现
【发布时间】：2021-05-30 23:11:06
【问题描述】：

我试图在部署后在 Github 页面上正确地可视化我的投资组合，但没有成功，我对可能出现的问题没有任何想法。

问题：

如果我的 index.html 位于“layouts”文件夹中（因为它最初在主题中），则实时页面要么显示“此站点是开源的。[改进此页面]”，要么显示原始 index.html文件 - 如果我将 index.html 放在根目录中。

事实：

我能够在本地毫无问题地运行该网站，并且呈现了预期的结果。
我已遵循将“/”作为 baseURL 的建议。
我已经尝试将index.html文件放在根目录下（似乎采用的逻辑结构）
检查索引页面，当 index.html 放置在根目录并实时显示（作为原始 html）时，控制台上没有任何错误。
我没有收到任何部署错误（我按照 Github 部署日志中的构建进行操作）。
我可以公开访问 css、js 和 images 文件夹并通过实时 url 查看内容。

我是 Hugo 的新手，我不知道我还能做些什么，任何帮助将不胜感激！我的存储库是： https://github.com/anaritagomes/anaritagomes.github.io

我正在使用 Hugo 的“UILite”主题： https://themes.gohugo.io/hugo-uilite/

【问题讨论】：

您实际上是如何发布网站的？您不能只是将源代码放入 github 存储库并让它工作：您需要渲染页面（运行 hugo 以创建 public 目录），然后将该目录发布到例如您的 gh-pages 分支（您可以手动执行或通过 GitHub Actions 自动执行）。如果你这样做，it seems to work just fine.
参见例如these docs from the Hugo project

标签： frontend github-pages hugo

【解决方案1】：

Hugo 的很多东西都不是为初学者写的，很多人都有同样的问题。

简单来说，当您在计算机上运行 Hugo 时，它会建立一个您可以通过 Hugo 访问的网站（即在 localhost:1313 上）。这有点像当您在 Photoshop 中创建文件时，它会将其另存为 PSD 文件，您可以通过 Photoshop 访问该文件，但如果您想将该文件实际放到互联网上，您可以将其导出为 PNG 文件或 JPG（或随便）。

在 Hugo 中，这个“导出”步骤也必须完成。执行此操作的命令只是“hugo -D”。这将创建一个名为“public”的文件夹，它是您发送到 Github 页面的该文件夹的内容。

【讨论】：

不需要-D，除非您还想发布仍处于草稿状态的内容。