hexo 中常见错误及其解决方案

众所周知,hexo new page "Page_Name" 可以方便快捷地在 hexo 中创建新页面,但是当我们通过如下方法将新页面添加到主页面的 menu 中时,

1
2
3
打开 ./MyBlog/themes/pure/_config.yml
添加 menu:
Page_Name: Page_Name

然而,主页的新增页面却会出现 menu.Page_Name 的情况,这时候我们只需要找到 ./MyBlog/_config.yml 配置文件,检查 language: 字段所指向的文件。例如,我是用默认的英文语言,language: 字段指向的文件为空。这时,我们去到 ./MyBlog/themes/pure/languages/* 文件夹下找到所指向的language 配置文件 default.yml,然后按照其他案例对比添加新增页面的指向即可。

自定义 icon-font

利用网站 https://www.iconfont.cn/ 新建自己的 icon 图标项目(方便后续添加新的 icon),然后在网站中添加自己喜欢的图标到项目中(每个图标在添加项目后仍可编辑)。例如我新建的 hexo 项目如下左图所示:

接着,单击页面顶部右 2 的项目设置按钮,做出如上右图所示的项目设置(需要勾选 Base64 )。

最后,我们 download 项目至 ./MyBlog/themes/pure/source/fonts/,打开 iconfont.css 并 copy 其中代码覆盖 ./MyBlog/themes/pure/source/css/style.css 中对应部分代码。同时,覆盖 ./MyBlog/themes/pure/source/fonts/ 下四个文件名为 iconfont 的文件。

这时,我们测试修改 ./MyBlog/themes/pure/_config.yml 中关键字如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
menu_icons:
enable: true # 是否启用导航菜单图标
home: icon-home
archives: icon-archives
categories: icon-folder
tags: icon-tags
publications: icon-papers
repository: icon-code_lib
books: icon-books
movies: icon-movies
travels: icon-plane_departure
links: icon-links
about: icon-aboutme

可以发现,小破站的 menu 图标均已变成我们自己项目中的内容了:

git commit 无法回滚问题

删除 .deploy_git 文件并尝试重新提交(hexo g -d