Hexo搭建教程

一、环境准备

注册一个gitHub账号

安装homebrew：使用它可以安装Mac没有预装但你会需要的东西

安装 node.js：安装的node.js中已经包含了npm

检验node和npm是否安装成功：进入到终端输入指令：node -v npm -v

二、Hexo安装

安装
1. 使用npm安装：npm install -g hexo-cli
2. 版本检查： hexo -v
在本地建站
1. 在终端切换（cd）一个你想指定的目录下，执行下面这个命令: hexo init blog
2. 在新建好的blog文件夹下安装 hexo配置：npm install
3. 开启服务器：hexo server
4. 本地访问检查：http://localhost:4000/
可能出现的问题：服务器启动失败：可能是node版本过低，可尝试更新！

三、Github库关联与代码托管

在GitHub新建远程仓库
hexo本地关联配置

打开刚刚新建的blog文件夹，进入到_config.yml文件夹下，可以用sublime打开或者其他工具
更改添加以下内容（注意此处要在冒号的后面加上空格）
文件生成与发布

生成静文件
hexo generate

部署网站
hexo deploy

注意：这里可能会遇到部署不成功的情况并报错：ERROR Deployer not found: git

解决方案：因为没安装hexo-deployer-git插件，在站点目录下输入下面的插件安装就好了：npm install hexo-deployer-git –save；安装好后尝试重新部署 hexo d即可

四、首次打开404问题解决

针对“hexo上传博客后，网页始终显示404，无法刷新网页问题：需要按照GitHub的要求修改相关设置，主要有一下两点”

1.Configuring a publishing source for your GitHub Pages site

2.确保仓库名称与用户名称一致，详见（三.1中的描述）；如果不一致需要在github仓库的settings—–>Options——>Repository name 做修改!(注意修改后本地的hexo配置仓库路径也要修改成新的)

"rename"

五、主题修改

参考链接：https://hexo.io/themes/
其实就是拿到你喜欢主题的链接，然后到blog目录中的themes文件夹下执行命令下载主题： git clone 链接地址
来到_config.yml中更改想用主题的名字（在themes中选择填写）

六、常用命名

//清除缓存文件 (db.json) 和已生成的静态文件 (public)。在某些情况（尤其是更换主题后），如果发现您对站点的更改无论如何也不生效，您可能需要运行该命令。
hexo clean

//生成静态文件
hexo generate

//部署网站
hexo deploy

//新建文章
hexo new “文章名”

//查看帮助
hexo help

//查看Hexo的版本
hexo version