如何替换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
相关产品推荐
相关产品推荐

