Hexo 部署 (简略版)

本文介绍hexo的配置方法

本文是很早以前写的,今天(2018-11-26)翻出来,发现在未归档的文件中,所以整理了之后发出来。

安装git

sudo apt-get install git

安装nodejs

ln -s /your/nodejs/dir/bin/node /usr/local/bin/node
ln -s /your/nodejs/dir/bin/npm /usr/local/bin/npm

安装hexo

1
sudo npm install -g hexo-cli

安装hexo需要使用npm包管理器来安装,安装好后运行hexo命令,控制台提示说找不到该命令,让我郁闷了一哈,后来才发现hexo命令在/your/nodejs/dir/bin/目录下,还是老办法,设置软链接。

1
ln -s /your/nodejs/dir/bin/hexo /usr/local/bin/hexo

建立站点

1
hexo init blog

安装npm支持

1
2
cd blog
npm install

配置github

hexo生成的静态页面是要上传到github上面的,所以需要配置好github,首先需要在github上建立一个仓库,仓库名格式是username.github.io,比如我的就是chxuan.github.io,不要乱取,不然配置不成功。之后编辑站点配置文件在末尾加入。

1
2
3
4
deploy:
type: git
repo: https://github.com/chxuan/chxuan.github.io.git
branch: master

repo行需要替换成你自己的仓库路径,保存之后运行如下命令。

1
2
npm install hexo-deployer-git --save
hexo deploy(可以缩写成d)

至此hexo已经关联好了github,在浏览器输入http://username.github.io/

加载图片

1
post_asset_folder: true

如果出现ERROR Deployer not found: git

有两种可能:

  • 在升级hexo到3之后,部署就不是github了,是git。即在_config.yml中:

    1
    2
    deploy:
    type: git

然后

1
npm install hexo-deployer-git --save

这样就安装好了

  • 还有一种神奇的可能,是因为你加入了新的插件,也就是在_config.yml中,写了:
1
2
Plugins:
- hexo-locol-image

或者其他的插件。这时候也会出现ERROR Deployer not found: git的问题。

原因是,插件的加载本来是自动的,也就是不用写插件。但是如果你要新加入一个插件,就需要把所有的插件都加入进去。也就是,如果去定义 plugins ,就必須把所有使用到的 plugin 加進去。

参考:

https://github.com/hexojs/hexo/issues/1848

https://github.com/hexojs/site/issues/262