29

我正在使用 Hugo 静态页面生成器构建个人网站，但是当我这样做时hugo serve，我不再看到一个页面，而只是一个空白页面localhost:1313。

我删除了所有内容并进行了全新安装。但是，雨果仍然提供空白页。

在空白页面中，我看到了我拥有的上一个网站草稿的 Favicon，即使我删除了上一个主题中的所有内容。我在 Chrome 中清除了浏览器并尝试了其他浏览器，但它仍然无法正常工作。

不确定我可以提供什么信息，因为没有错误消息。我怎样才能解决这个问题？

4

5 回答 5

22

问题很可能是主题——它要么丢失，要么被破坏。如果您未能提供一个可用的主题，Hugo 不会附带任何默认/后备主题。

调试指南：

  1. 检查themes文件夹，然后按照快速入门。
  2. 尝试使用另一个更简单的主题。
  3. 这可能只是配置主题的问题，您也可以阅读hugo 主题文档。
于 2017-04-29T09:20:46.093 回答
9

请验证您的 config.toml 文件是否指向正确的主题。

如果遵循快速入门教程，您可能已经忘记运行

echo 'theme = "ananke"' >> config.toml
于 2018-05-09T17:12:21.557 回答
5

在遵循hugo 入门/快速入门指南后，我遇到了同样的问题， 但我没有使用现有主题，而是创建了一个非常基本的主题：

  1. 安装 hugo我选择在 windows 上安装 hugo
  2. 创建新站点hugo new site quickstart
  3. 添加主题
    • 克隆主题（例如ananke-theme）更容易 <-- this is what the quickstart does and what i left out
    • 相反，您可以创建一个主题 ，hugo new theme [your-theme-name]例如在您的站点文件夹中添加一个主题骨架C:\Hugo\Sites\example.com（参见屏幕截图）
  4. 添加一些内容hugo new posts/my-first-post.md
  5. 启动服务器hugo server -D --watch --verbose

Hugo_myFirstTheme_files_folders

创建主题后，文件和文件夹应该在Sites/example.com/themes/your-theme-name/. 由于大多数生成的文件（几乎）是空的，因此您必须在快速入门示例运行之前编辑其中的一些文件。

基于为雨果开发主题， 我编辑了/themes/your-theme-name/layouts/index.html 

<!DOCTYPE html>
<html> <body>    
    {{ range first 10 .Data.Pages }}        
         <h1>{{ .Title }}</h1>
         <div>{{- .Content -}}</div>
    {{ end }}      
</body> </html>

关于雨果的基本信息来自为雨果开发主题

  • Hugo 配置文件（TOML、YAML 或 JSON）位于站点的根目录中
  • Hugo 默认： Markdown inside content/,
    • 内容文件包含元数据 ( frontmatter ) 和文本 (/markdown) --> html to public/,
    • 前端属性示例：date, title, description, categories, tags

  • themes/（或layouts/）下的模板

    • 三种类型的模板：single, list, partials
    • 主题模板下/themes/your-theme-name/然后下/layouts/forindex.html和下/layouts/_default/list.htmland/layouts/_default/single.html

  • HTML 文件将被写入该public/目录。

您可能想阅读hugo 主题文档。

于 2018-08-19T22:51:08.043 回答
3

当我从 Github 克隆我的博客但没有包含主题子模块时，我遇到了同样的问题。包括子模块解决了我的问题：

git clone --recurse-submodules https://github.com/username/your-blog
于 2020-12-26T10:56:44.687 回答
0

这可能是config.tomlHugo 项目目录中的潜在问题。

我最近遇到了一个类似的问题，我在尝试使用 Hugo 创建自定义主题时只看到一个空白页面，而您所要做的就是告诉 Hugo 在哪里可以找到要在浏览器上呈现的初始 HTML 页面。

如果您尝试安装主题或创建自定义主题，请转到config.toml基本目录并指定主题名称，如下所示：

theme = "${theme_name}"

如果您使用默认/自定义主题，主题名称将与项目目录中主题文件夹下的文件夹名称相同。

于 2020-12-29T14:13:46.210 回答