Hugo on Nullshow的技术博客

【开发日志】我的技术博客网站

Wed, 24 Sep 2025 09:01:30 +0200

目录

概览

项目目标：从零开始开发一个个人博客网站，用来记录和分享我在学习、开发中的笔记、历程和感悟，也是 portfolio 的一部分
技术栈：GitHub Page + Hugo，在Stack theme基础上进行轻量定制修改
开始时间：2025-09-14
当前状态：进行中
学习资源：Hugo官方文档、stack主题文档、B站及网上各位大佬的教程
仓库链接：GitHub

时间线——阶段一

2025-09-14

目标：
- 创建网站并完成自动部署
- 添加基础版 看板娘
遇到的问题：
- 中英语切换时找不到网页
- icon小图标在网站标签不显示
解决方法：
- 在VS Code中使用Github copilot，帮我写了转换语言的js文件
- 用在别人网页中成功显示的小图标进行测试，排除了图片本身的问题；后来因为处理别的模块，没有在意icon小图标，一段时间后自动显示出来了
思考/收获：
- 需要边开发边系统学习web programming，才能“知其然，知其所以然”，而不是百分之百依赖AI
- Github Pages的部署很快，但是在网页显示没有那么及时；如果检查了仓库已经推送上去了，如果此时效果还未显示，不要着急，等一等

2025-09-16

目标：
- 左边侧栏添加 更新日志
- 上传第一篇博客（中文版）
- 修改字体
- 使用自定义鼠标
遇到的问题：
- 自定义鼠标不显示
解决方法：
- 查看了教程博客的评论区，发现可能是图片的问题。使用了教程博主的图片素材测试，发现确实如此
思考/收获：
- 遇到问题可以看文章或者视频的评论区，常有启发和收获，因为我遇到过的问题也许别人早就遇到并解决了

2025-09-18

目标：做完一系列基础美化
遇到的问题：
- 不知道如何能使每个语言、代码都显示对应的字体
- 自动部署时遇到 语法报错 失败
解决方法：
- 使用Copilot生成代码建议解决了字体问题
- 语法报错是和缩进有关的，用VS Code它会自动按照它认为对的格式，但其实是错的。换成 记事本 解决
思考/收获：
- 前端的语言和缩进也是有关系的，以后需要用 记事本 或者其他编辑器操作，尽量不用VS Code避免类似情况发生

2025-09-19

目标：
- 继续做基础美化
- 调整 背景颜色 图标和文本
- 添加 动态背景
- 添加 文章浏览量 统计
遇到的问题：
- 调整背景颜色时先遇到了两个图标同时显示的问题，解决后发现 文本格式 没有和左侧菜单栏的其他项目文本对齐
备注：

尝试解决了很久没有成功，先放一放，等学一段时间前端后再回过头来尝试解决

2025-09-20

目标：
- 继续做基础美化
- 添加 主页加载动画
- 添加 网站底部动画
- 添加 博客发表热力图
遇到的问题：
- 网站底部出现不是博客内容的文字
- 想为头像下的小图标增加动画效果，但是没有实现效果
解决方法：
- 利用AI排查出是custom.html的注释问题，我想当然地使用了C++的注释，但是被浏览器当做文本处理
备注：
- 小图标 的动画效果在学完一些前端后再尝试解决（9-23已解决）
思考/收获：
- 每种语言的注释格式看来相差挺大的，需要小心严格遵循对应的语法

2025-09-22

目标：
- 继续做基础美化
遇到的问题：
- 链接页面的卡片图片无法统一大小
备注：
- 尝试解决后仍然失败，先用调整每张图片的方法暂时处理，等学完一些前端后再继续尝试统一处理

2025-09-23

目标：
- 添加RSS，实现根据语言订阅不同版本
- 虚拟人物widget2D改为 moc3 版本
- 添加 网站底部动画
- 添加 博客发表热力图
遇到的问题：

遇到的问题：
- 虚拟人物无法加载
解决方法：
- 通过浏览器 开发者工具 debug，获取error信息后结合AI排查出model存放地址的文件夹后少写\
思考/收获：
- 在写文件地址时要小心核对
- 使用开发者工具debug很有用

2025-09-24

目标：
- 引入新的虚拟人物模型，并将所有模型参数配置成自己喜欢的样式
遇到的问题：
- 新的虚拟人物无法加载
- 通过CDN工具 jsDelivr 加载时发现它不加载新推送的文件
解决方法：
- 通过浏览器 开发者工具 的报错信息发现，新模型加载失败是因为该模型过大导致，所以决定放弃使用这个新模型
- 询问AI得知，jsDelivr 出于稳定性的考虑，一旦tag（缓存）建立，就不会自动更新，即使删除并重建tag。如果版本号一致，那么它只会加载老版本的快照。最后采用了精准加载的方法处理，因为不想在仓库留下一堆无用的文件和tag
思考/收获：
- 第一次意识到文件大小在网络传输时的重要性。就像我在玩Brotato这样Roguelike的后面几关时注意到大量游戏资源的管理是游戏开发的一个重点一样，每一个编程方向虽有其共性，但也有其特别需要关注的点，这些点需要在实战中慢慢体会

2025-09-29

目标：
- 网页底部添加 运行时间、文章篇数 统计等信息
遇到的问题：
- 中文显示乱码
解决方法：
- 听从AI的建议用VS Code打开文件检查，发现在UTF-8下是乱码。修改后正常显示
思考/收获：
- 发现用VS 2022打开并没有出现乱码，但是VS Code可以显示这一问题
- 只是在使用完VS Code，一点击保存，它又会擅自更改格式，导致hugo无法编译

阶段小结一

目前进展：
- 完成个人技术博客的初步开发，包括自动部署和一定程度的美化
收获：
- 了解静态网站生成器的基本原理（配置 → 模板 → 渲染）
- 初步掌握GitHub Pages 部署流程
- 这一阶段没有学习过任何前端的内容，所以所有开发都是参考了网上大佬们的教程、以及在AI的帮助下完成的。在这一过程中学会了 如何向AI更精准地提问，让它来帮助我解决问题的能力
下一步计划：
- 系统学习前端，并尝试解决阶段一未解决的问题
- 阅读/ 理解 魔改部分 代码
- 按照 TODO list 持续更新本站