记录Blowfish主题美化过程
· ☕ 9 min read
起笔
这篇文章来记录一下美化博客的代码。一样是记录性质,免得自己忘,又要翻GitHub上的提交记录。顺便,回想起刚搭博客的时候四处碰壁,彼时也没有生成类AI工具,有需求只能在Google上搜索,或者是去GitHub偷代码(。)能搜到的美化魔改博文我都看了个遍。现在写代码的门槛降低不少,官方文档做得也很清晰,这篇文章希望抛砖引玉吧。
这篇文章来记录一下美化博客的代码。一样是记录性质,免得自己忘,又要翻GitHub上的提交记录。顺便,回想起刚搭博客的时候四处碰壁,彼时也没有生成类AI工具,有需求只能在Google上搜索,或者是去GitHub偷代码(。)能搜到的美化魔改博文我都看了个遍。现在写代码的门槛降低不少,官方文档做得也很清晰,这篇文章希望抛砖引玉吧。
昨晚我走在路上的时候突然想到,随着时间推移,我喜欢的作品一定会变得越来越多,而我的藏书阁里目前仅使用了Tags和Categories的树状分类法,就算是个自留地,日后在博客内指名寻找某个作品一定是耗时的。如何解决这个问题,最佳方案就是为博客添加搜索功能。
实际上,我正在尝试将喜欢的内容直接呈现在博客上,没错这里指的就是我的藏书阁。然而作为小白,虽然我有能力像markdown一样使用html语法写完一篇文章,但在hugo博客里嵌入视频这种事…如果直接在.md文件里用html标签,第一有安全隐患,第二完全没有效果。不仅是<video>
标签,还是<iframe>
标签,我试过的代码在本地预览通通不行,反而在码字软件Typora里跑得很畅快…(摊手。
错误提示:
Error: Error building site: failed to render pages: render of "taxonomy" failed
解决方案:
原因是 Front matter categories 的类型是数组,所以在文章中,需要写成(YAML 格式为例)
categories: [Meta]
# 或者
categories:
- Meta
# 而不是
categories: Meta
在主题文件 /themes/Mogege/assets/css/_common/home.scss
内添加 toc 样式:
给自家男孩子搭博客的时候我向他推荐了Mogeko二次开发的Mogege主题(基于Leavelt主题,现已被作者弃坑)。虽然Mogege主题也被弃坑了,但是简洁好用,去掉了很多实用性不高的功能,而且配置文件有部分汉化,相当适合小白。
但另一方面,当时Mogege的作者正在使用Gitalk。虽然现在由于安全问题已经改用Utterances了,但依旧没有在Mogege主题中显现出来,这就直接导致了config.toml
中开箱即用的评论系统只有Gitalk,而Disqus
和Utterances
虽然在html文件中有所体现,但都没有出现在主题配置文件中,更可怜的Disqus
连自己的html都没有…实际上LeaveIt的作者似乎没有为主题添加评论功能。
给博客换主题的时候发现MemE主题和Zzo主题的评论配置文件有出入,不能直接套用现有的MemE主题Waline配置。所以我灵机一动:要不我自己搞吧。
以MemE,Zzo和stack三个主题为例,看一下不同主题的评论配置有什么不同:
看中Zzo主题的搜索、代码样式和目录,英文字体也很好看,狠下心来从简洁风格的MemE跳槽而来。步骤十分傻白甜:没有git submodule
,直接把仓库文件下载到本地的博客根目录,然后替换配置文件并做基础改动。Hugo server -D
本地预览毫无问题,怎么就,怎么就构建失败了呢?
搭建自己的静态博客这件事,对我本人来说还没有什么真实感。不过既然都已经为了建站捣鼓了域名和服务器,那多一个blog(个人网站)也是完全可以预料到的事,更何况不是部署在服务器内的动态博客,而是只需要一台普通电脑就能搞定的静态博客。