Hugo平台配置指南
HUGO 官网
The world’s fastest framework for building websites | Hugo (gohugo.io)
安装 HUGO
bash
brew install hugo
准备工作
HUGO 博客部署:这个相信大家都已经会了。不过这里还是推荐一个最佳实践。
推荐使用 hugo-theme-next-starter 生成博客。
博客设置参考:hugo-theme-next
bash
git submodule add https://github.com/hugo-next/hugo-theme-next.git themes/hugo-theme-next
我开发此功能的测试博客:https://hugo.terwer.space
源码:https://github.com/terwer/hugo-blog
HUGO 的 front-matter 规则
Front Matter | Hugo (gohugo.io)
发布配置
基本设置
未完待续
高级个性化设置
发布目录
默认是 content/post,如需修改请遵循 Hugo 官方说明
图床服务与图片存储路径 v1.34.0+
1.
不使用图床,不处理图片
2.
PicGo,使用图床绝对路径
3.
当前平台,此时可设置 图片存储路径 和 图片链接地址
图片存储路径:图片,默认为 static/images,一般情况不建议修改,如果修改请设置为 static/xxx
图片链接地址:文档里面引用的图片路径,本平台与图片存储路径保持一致即可,即 images ,一般情况不建议修改,如果修改请对应。
参考文档:Hugo引用本地图片
文件规则
路径暂时不支持动态配置,但是可以通过自定义文件名规则来实现v1.29.1+。
基本配置
文件规则:[yyyy]/[MM]/[filename].md
其中,可用占位符如下,会动态替换:
[yyyy] 年,例如:2025
[MM] 月,例如:02
[mm]
[dd] 天 ,例如:26
[slug] 别名,例如:test-document-xdfr45f
[filename] 文件名,例如:测试文档
例如:[filename].md、[slug].md、[yyyy]-[mm]-[dd]-[slug].md
链接字符只能为 / - _ . ~ 其他的均会被移除。
分类和标签
对于分类和标签,新增两个变量
[category] 获取第一个分类,没有忽略
[cats] 所有分类组合起来
[tag] 获取第一个标签,没有忽略
[tags] 所有标签组合起来