You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

如何替换Hugo主题默认首页并自定义路由,将原有首页设置为/blog路径访问

Hugo替换默认首页并迁移原首页到/blog路径实操步骤

1. 部署自定义根首页

在你的Hugo站点根目录下新建layouts/index.html文件,将你写好的custom.html完整代码直接复制到该文件即可。Hugo渲染时会优先读取站点根目录下的布局文件,自动覆盖LoveIt主题自带的首页模板,根域名example.com就会直接展示你自定义的静态页面。
如果你的自定义页面依赖独立的CSS、JS、图片等资源,将对应资源文件放入站点根目录的static文件夹下对应路径,引用时直接使用根路径(如/css/custom.css)即可正常加载。

2. 配置原首页映射到/blog路径

推荐使用虚拟section方案,无需修改主题代码,兼容性最高:

  • 在站点根目录的content文件夹下新建blog文件夹
  • 在blog文件夹内新建_index.md文件,填入以下Front Matter内容:
---
title: 博客
type: home
---

配置完成后,Hugo会调用LoveIt主题默认的首页模板渲染该页面,生成后的访问路径就是example.com/blog,内容和原默认首页完全一致。

3. 生效验证

本地执行hugo server命令启动测试服务,分别访问以下地址验证效果:

  • http://localhost:1313/:展示自定义静态页面
  • http://localhost:1313/blog/:展示原主题默认的博客列表首页

注意:所有自定义修改请勿直接改动LoveIt主题目录内的文件,放在站点根目录的layouts、static等目录下的自定义内容,不会被后续的主题更新操作覆盖。

内容的提问来源于stack exchange,提问作者Blackernel

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.30 00:24:03