使用hexo搭建github个人博客网站

搭建步骤：

1>Mac或win电脑一台，本文以mac为例。

2>下载安装Git和Node

3>安装hexo

4>注册登录GitHub,创建一个仓库，库名格式为：GitHub用户名.github.io

5>购买域名，本文以阿里云为例，解析域名。

6>博客主题，标题，界面设置

---

安装Git

下载地址：https://git-scm.com/download/

安装Node

下载地址：http://nodejs.cn/download/

验证是否安装成功：

安装hexo

//安装hexo
&:npm install hexo-cli -g //创建本地博客,“GitHub用户名.github.io”建议和GieHub仓库名一致 hexo init GitHub用户名.github.io 例如： &：hexo init 1170197998.github.io //进入到安装目录 &：cd 1170197998.github.io/ //安装npm &：npm install //启动服务 &；hexo server

 

至此，在浏览器地址栏键入http://localhost:4000/，即可访问本地博客

---

安装hexo-server

npm install hexo-server --save npm install hexo --save

登录GitHub创建一个名字为1170197998.github.io的仓库，

打开本地博客目录1170197998.github.io中的_config.yml，加入仓库地址，如下：

deploy: type: git repo: https://github.com/1170197998/1170197998.github.io.git branch: master

生成的静态文件 (public文件夹)，部署服务

//生成静态文件 &:hexo generate //部署服务 &:hexo deploy

把这个文件夹里面的内容上传到刚刚新建的仓库里面

此时访问1170197998.github.io可以访问博客

---

购买域名，绑定域名，登录阿里云控制台进行域名解析操作如下

查看github空间服务IP：

ping 1170197998.github.io

在source文件下新建一个文件名为CNAME文件，不要有后缀，输入域名，保存关闭

然后执行hexo g,hexo d进行生成和部署。此时在浏览地址栏键入域名就可以打开博客了

博客基本操作

1>切换博客主题

博客的主题都保存在了themes文件夹下，默认landscape主题，想切换别的主题，终端进入到该文件夹下，进行克隆即可，比如克隆next主题：

&:git clone https://github.com/iissnan/hexo-theme-next themes/next

然后到_config.yml中把theme的值由默认的landscape修改为next。

然后执行hexo g,hexo d进行生成和部署命令。此时再登录域名，主题已经切换。

2>设置博客标题、作者

打开_config.yml，对应填写title，auther等参数，修改了url参数对应的值以后，即使在地址栏输入了1170197998.github.io，网页加载完后会变为url的值，然后执行hexo g,hexo d进行生成和部署命令。

---

hexo常用命令

npm install hexo -g #安装 npm update hexo -g #升级 hexo init #初始化 简写 hexo n "我的博客" == hexo new "我的博客" #新建文章 hexo p == hexo publish hexo g == hexo generate#生成 hexo s == hexo server #启动服务预览 hexo d == hexo deploy#部署 服务器 hexo server 会监视文件变动并自动更新，无须重启服务器。 hexo server -s #静态模式 hexo server -p 5000 #更改端口 hexo server -i 192.168.1.1 #自定义 IP hexo clean #清除缓存 网页正常情况下可以忽略此条命令，清除了db_json文件和public文件夹 hexo g #生成静态网页 hexo d #开始部署 监视文件变动 hexo generate #使用 Hexo 生成静态文件快速而且简单 hexo generate --watch #监视文件变动 完成后部署 hexo generate --deploy hexo deploy --generate or: hexo deploy -g hexo server -g 草稿 hexo publish [layout] <title>

 

---

可能会遇到的问题：

1>出现：

FATAL Cannot find module '/Users/xxxxxxx/GitHubBlog/1170197998.github.io/node_modules/hexo-renderer-marked' Error: Cannot find module '/Users/xxxxxxx/GitHubBlog/1170197998.github.io/node_modules/hexo-renderer-marked' at Function.Module._resolveFilename (module.js:485:15) at Function.resolve (internal/module.js:18:19)

 

可能是安装hexo的时候没有执行npm install，执行如下命令：

&：rm -rf node_modules
&：npm install

2>ERROR Deployer not found : github的问题解决办法

先执行：
npm install hexo-deployer-git --save 然后执行： hexo g hexo d 

3>发布博客后设置分类和标签

在文章的顶部tags和categories中这样写所属分类和对应的标签，例如：

tags: [iOS,链式编程和函数式编程] categories: [iOS_Objective-C] 备注：单个分类或者标签不需要用中括号[],多个的时候用[]括起来，英文逗号隔开。

 

4>加入搜索功能

使用的是Local Search, 首先安装hexo-generator-searchdb <要在当前博客目录下>

npm install hexo-generator-searchdb --save

然后在博客目录下的_config.xml里面加入以下字段

search:
  path: search.xml
  field: post format: html limit: 10000

 

同时要把主题目录下的_config.xml文件中的local_search的enable设置为true

local_search:
  enable: true

5>加入百度统计功能

注册登录百度统计，把统计脚本id复制到主题next下的配置文件_config.xml中的baidu_analytics字段后

6>加入评论功能

注册登录网易云跟帖，将yunTieProductKey放到主题next下的配置文件_config.xml中的gentie_productKey字段后