Hexo博客框架
本项目基于hexo+github结构创建
一、安装步骤
1. 创建新文件夹,并执行命令安装Hexo:
执行如下命令安装Hexo:
sudo npm install -g hexo
初始化hexo
hexo init
生成静态页面
hexo generate(hexo g也可以)
启动本地服务,进行文章预览调试
hexo server
2. 在github上创建仓库,并保存本地
- 注意:建立与你用户名对应的仓库,仓库名必须为【your_user_name.github.io】,固定写法 例如:【mitudegaoyang.github.io】
3. 将Hexo全部内容复制进上一步创建的文件夹中,并提交仓库
4. 配置Github仓库
现在我们需要_config.yml文件,来建立关联
翻到最下面,改成我这样子的
deploy:
type: git
repo: [email protected]:mitudegaoyang/mitudegaoyang.github.io.git
branch: master
然后执行命令:
npm install hexo-deployer-git --save
注意:网上会有很多说法,有的type是github, 还有repository最后面的后缀也不一样, 是github.com.git,我也踩了很多坑,我现在的版本是hexo: 3.1.1,执行命令hexo -vsersion就出来了, 貌似3.0后全部改成我上面这种格式了。
忘了说了,我没用SSH Keys如果你用了SSH Keys的话直接在github里复制SSH的就行了,总共就两种协议,相信你懂的。
5. 执行配置命令:
hexo deploy
然后再浏览器中输入http://mitudegaoyang.github.io/就行了,我的github的账户叫mitudegaoyang,把这个改成你github的账户名就行了
6. 部署步骤
每次部署的步骤,可按以下三步来进行。
hexo clean
hexo generate
hexo deploy
7. 一些常用命令:
hexo new"postName" #新建文章
hexo new page"pageName" #新建页面
hexo generate #生成静态页面至public目录
hexo server #开启预览访问端口(默认端口4000,'ctrl + c'关闭server)
hexo deploy #将.deploy目录部署到GitHub
hexo help # 查看帮助
hexo version #查看Hexo的版本
8. 报错总结:
ERROR Deployer not found: git 或者 ERROR Deployer not found: github
解决方法: npm install hexo-deployer-git --save
如发生报错: ERROR Process failed: layout/.DS_Store , 那么进入主题里面layout和_partial目录下,使用删除命令:
rm-rf.DS_Store
ERROR Plugin load failed: hexo-server
原因:
Besides,utilities are separated into a standalone module.hexo.util is not reachable anymore.
解决方法,执行命令:
sudo npm install hexo-server
执行命令hexo server,
提示:Usage: hexo ....
原因:
我认为是没有生成本地服务
解决方法,执行命令:
npm install hexo-server --save
提示:[email protected] node_modules/hexo-server