Hugo:常见错误排查

这里主要归集在使用过程中遇到的错误以及解决方法,供参考。

安装主题后,推送到云端出现gitmodules错误

在站点根目录下新建.gitmodules如下配置(以stack主题为例)

[submodule "themes/hugo-theme-stack"]
	path = themes/hugo-theme-stack
	url = https://github.com/CaiJimmy/hugo-theme-stack/

文章不显示

这里也有几种可能性。

  1. markdown文件里设置了draft: true。软件会判定为草稿不构建。
  2. hugo server的实时更新功能只对已有文件修改有效,创建新文件不会渲染。重启server就可以了
  3. 主题设置有误。例如

    params:
    mainSections:
    	- post
    

​ 这样默认主页是渲染你放在content\post文件夹里面的文件,这时如果你新建文章新建到posts文件夹里面当然不会显示了

没有搜索栏

这不是一个BUG,Hugo本来就不支持搜索。

可以通过Algolia添加搜索功能,也有部分主题自带搜索功能,例如本博客使用的stack

关于stack添加搜索,请参照:Hugo:Stack主题

亦可参考:给hugo添加搜索功能 | 搜百谷 (sobaigu.com)

以及:Add Search to a Hugo site with Lunr.js and Node.js · Code with Hugo

分类不匹配

这也是在使用中发现的。stack主题是可以自定义分类的描述的。但是实际使用中出了问题,产生了一个新的空白的分类,对不上。

解决方案:需要将目录名称对应为实际网站打开的链接categories\分类实际名称中的名称新建文件夹。

主要是在分类名称中有特殊字符时出现。