hexo 常见问题

安装

主题安装

1

npm i hexo-theme-<themename>

发布

上传git失败

1

ERROR Deployer not found: git

解决办法：

这是因为没有安装hexo-deployer-git插件,在站点目录下输入下面的命令安装插件就好了。执行下面这行命令

1

npm install hexo-deployer-git --save

command not found

这个命令是随同NodeJS一起安装的包管理工具，重新在输入命令安装hexo：命令： npm install hexo-cli -g

图片链接乱码

使用 hexo 写博客时，在文章里面插入图片，最后 hexo g 的时候总会在图片前面插一个.io
update link as:–>/.io//06/01/vim/1561905818946.png

A：是 hexo-asset-image 这个插件的 bug,hexo 版本 3.0 以上获取网站 url 的方式与 3.0 以下有些不同。照着文章修改 hexo.js 的 index.js 就行，或者直接卸载 hexo-asset-image

1

hexo uninstall hexo-asset-image

提交主题到官网收录

参考：https://blog.csdn.net/smileyan9/article/details/124368376

5.2.1 提交方法
hexo.io 官网的源码地址是：https://github.com/hexojs/site 为了提交自己的主题，需要更新这个源码，但是很明显我们没有权限直接修改。所以

Fork https://github.com/hexojs/site 到自己的仓库。

修改 Fork 过来的 site ，编辑其中的 source/_data/themes.yml 文件 ，在后面添加自己的主题信息：

这个猫咪照片是百度上找的，主要目的也是为了吸引别人注意。

git add/commit/push 到自己fork的仓库中，然后提交 pull request。可以理解为合并的请求，提交以后会进入一个自动的审核过程，并且也有提示自己需要关注的问题。

等待有权限的 hexo-site 管理人员看到，然后进行合并操作。可能需要一些时间（我总共等待不超过两天）。

最后就可以在 hexo 主题网站上搜索自己的主题名字，看看是否能查到了。

hexo自定义主页

无文件时

自定义文件时

1

source/index.md

参考：

GitHub - Yue-plus/hexo-theme-arknights: 明日方舟罗德岛阵营的 Hexo 主题，支持数学公式、Valine&Gitalk&Waline评论系统、Mermaid图表