为什么雨果服务空白页?

max*_*oku 21 hugo

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

我删除了所有内容并进行了全新安装.但是,Hugo仍在提供空白页面.

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

不知道我能提供什么信息,因为没有错误消息.我怎样才能解决这个问题?

jed*_*diz 16

问题可能是主题 - 它要么缺失要么被打破.如果你没有提供工作,Hugo没有任何默认/后备主题.

调试指南:

  1. 检查themes文件夹,然后按照快速入门进行操作.
  2. 尝试使用另一个更简单的主题.
  3. 它可能只是配置主题的问题,您也可以阅读hugo主题文档.


bha*_*red 8

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

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

echo 'theme = "ananke"' >> config.toml
Run Code Online (Sandbox Code Playgroud)


sur*_*gle 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/. 由于大多数生成的文件(几乎)是空的,因此您必须在快速入门示例工作之前编辑其中的一些文件。

基于为 Hugo 开发一个主题, 我编辑了/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>
Run Code Online (Sandbox Code Playgroud)

为 Hugo 开发主题中获取的有关 Hugo 的基本信息

  • Hugo 配置文件(TOML、YAML 或 JSON)位于您站点的根目录中
  • Hugo 默认: Markdown inside content/,
    • 内容文件包含元数据(frontmatter)和文本(/markdown)--> html 到 public/,
    • 示例 frontmatter 属性: date, title, description, categories, tags
  • themes/(或layouts/)下的模板

    • 三种类型的模板: single, list, partials
    • 主题模板下/themes/your-theme-name/然后下/layouts/forindex.html/layouts/_default/list.html/layouts/_default/single.html
  • HTML 文件将被写入该public/目录。

您可能需要阅读Hugo 主题文档


Sey*_*avi 5

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

git clone --recurse-submodules https://github.com/username/your-blog
Run Code Online (Sandbox Code Playgroud)