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引用本地图片
​
​ image ​
​
​
​
文件规则
​
路径暂时不支持动态配置,但是可以通过自定义文件名规则来实现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] 所有标签组合起来
​