安装好 BlowFish 主题后,需要将 \themes\blowfish\config 目录下的 _default 文件夹复制到 \config 中,删除根目录下的 hugo.toml 文件,并修改 \config\_default\hugo.toml 文件,将 theme = "blowfish" 取消注释,以激活主题。

后续的一些自定义设置也全部在 \config\_default 目录下的文件中修改即可。

BlowFish 主题,可配置选项十分丰富,且文档详尽,参考文档可轻松配置出不错的效果,这里简单记录几点:

图片LOGO 设置

将根目录 \congfig\_default\params. 中的 disableTextInHeader 修改为 true 几个取消 header 部分的文字标题。之后在 \assets\img 文件夹中放入 图片LOGO 并修改 language.zh-cn.toml 文件中 logo = "img/logo名称.png" 即可

🔥因不明原因,SVG格式的LOGO在切换明暗模式时会失效,更推荐使用PNG格式的图片

画廊短代码失效

BlowFish 主题提供了两种样式的画廊短代码,允许用户以多样化的形式展示多张图片,效果如本站相册页面

参考文档设置好之后会发现布局异常,在 \assets\css 文件夹中新建 custom.css 文件,并粘贴下述代码,可解决布局异常问题

.max-w-fit {
    max-width: none; /* allow it to take full width */
    width: 100%; /* ensure it takes the full width of its parent */} 

.max-w-prose {
    max-width: 100%; /* allow it to use full width of the container */
    width: 100%; /* ensure it takes full available width */}

首页热力图

首页热力图可参考这篇文章进行设置:

CSS和JS实现博客热力图 | 大大的小蜗牛