Hexo 搭建 Blog 踩坑记录

字数显示undefined

如下图:
异常显示

安装好插件hexo-symbols-count-time后,查看界面,字数显示undefined,可能是因为第一次安装导致,执行如下命令:

1
hexo clean

然后再次查看,显示正常。

正常显示

访客量显示

在NexT主题的配置文件中,修改busuanzi_count配置项,将enable改为true

这样显示的样式是鼠标点击图标时,才显示标题,可以修改NexT主题下layout/_third_party/analytics/busuanzi-counter.swig文件,如下:

1
2
3
4
5
<span class="site-pv" title="{{ __('footer.total_views') }}">
{{ __('footer.total_views') }}
<span class="busuanzi-value" id="busuanzi_value_site_pv">
</span>
</span>

对比源文件,增加了

1
{{ __('footer.total_views') }}

配置项。

常用命令记录

1
2
3
4
5
6
7
8
9
hexo init 初始化项目

hexo s 运行项目

hexo g -d 发布项目

hexo new page "tags" 新增Item

hexo new “file name” 新建文章

大括号陷阱

如下新增配置项,我在 Markdown 格式下,使用 ` 标签,导致配置项被当成JS代码运行,导致错误。

1
{{ __('footer.total_views') }}

建议涉及到代码部分,均使用 Markdown 代码块来表示,防止出现上述描述错误。

报错 YAMLException

1
YAMLException: can not read a block mapping entry; a multiline key may not be an implicit key at line 5, column 1:

查看代码,标签后面少了一个空格,导致报此错误。

1
2
3
4
也就是说每一个 标签:后需要一个空格。
Example :
categories: [技术]
tags:[hexo] #这里缺少一个空格,添加空格,不会报错