这是第一篇文章。可以直接改它,也可以删掉。
这个站点是怎么搭的#
主题 Blowfish 通过 Hugo Modules 引入,主题源码不在本仓库里,只在 go.mod / go.sum 里记录版本:
# config/_default/module.toml
[[imports]]
path = "github.com/nunocoracao/blowfish/v3"本地预览:
hugo server构建静态文件到 public/:
hugo --gc --minify升级主题#
hugo mod get -u github.com/nunocoracao/blowfish/v3注意主题声明的 Hugo 版本范围(见主题仓库的 config.toml 里 [module.hugoVersion])。
超出该范围 Hugo 只会打一条 WARN 然后照常构建,不会失败 —— 但那属于上游没测过的组合,
升级主题时最好把 Hugo 一起调,让两者都落在支持的窗口内。
新建文章#
hugo new content posts/my-post.md常用 front matter#
| 字段 | 作用 |
|---|---|
title | 标题 |
date | 日期 |
draft | true 时本地可见、构建时跳过 |
summary | 列表页摘要与 SEO 描述 |
categories / tags | 分类与标签,对应 config/_default/hugo.toml 里的 taxonomies |
showTableOfContents | 是否显示右侧目录 |
heroStyle | 头图样式:basic / big / background / thumbAndBackground |