为什么又回来折腾博客#
第一篇文章里说过,几年前用纯 HTML 做了几篇网页交了课堂作业,后来接触了 WordPress、Hugo、Hexo 这些工具,写过一阵子,热度散去后网站就荒废了。
最近重新开始折腾——想着反正也在做 MonoGame 移植这种值得记录的事情,不如把博客重新搭起来。
选型:Hugo + Blowfish#
这次选了 Hugo + Blowfish 主题:
- Hugo:Go 写的静态站点生成器,单二进制,构建快,内容用 Markdown 写,天然适合技术博客
- Blowfish:基于 Tailwind 的 Hugo 主题,中文支持好(
zh-cn语言配置开箱即用),首页/文章/系列/标签一应俱全
搭建过程#
1. 初始化站点#
hugo new site temp_hugo2. 安装主题(子模块方式)#
git submodule add https://gitcode.com/gh_mirrors/bl/blowfish.git themes/blowfish3. 配置#
Hugo 的 config/_default/ 下按语言拆分配置:
config/_default/
├── hugo.toml # 站点全局(主题/baseURL/默认语言)
├── languages.zh-cn.toml # 中文站点信息(标题/作者/描述)
├── menus.zh-cn.toml # 菜单(主菜单/页脚菜单)
├── markup.toml # Markdown 渲染配置
└── module.toml4. 备案信息#
在国内部署,备案是绕不开的。用 Blowfish 的 footer 自定义,在 layouts/partials/footer.html 里添加了备案信息:
- 浙ICP备(工信部备案)
- 浙公网安备(公安联网备案)
- 萌ICP备(萌 ICP 备,一个梗,懂的都懂)
5. 构建与发布#
hugo # 构建 → public/把 public/ 的内容同步到网页仓库(funbocchi.top)推送即可。
内容规划#
博客目前的定位:
- MonoGame 鸿蒙移植系列:partial 机制、文件结构纪律、路线图等(会持续更新)
- 折腾记录:局域网联机、博客搭建这类日常折腾
踩坑记录#
- Hugo 建议用 extended 版(含 SCSS 编译支持),
apt install hugo装的是旧版,Blowfish 这类主题会静默失败 - 主题用子模块方式安装,clone 后记得
git submodule update --init --recursive - 备案的 ICP 号要放在 footer 里,同时
baseURL要配置成备案的域名