Hexo搭建github博客

hexo官方网站

一.系统环境配置：

要使用Hexo，需要在你的系统中支持Nodejs以及Git，如果还没有，那就开始安装吧！

1.安装 node.js
下载地址 node.js
直接双击下载下来的msi文件，一路下一步就ok了，安装完之后调出命令行或者node命令输入终端，输入node -v看到版本信息就表明安装成功了。如果不会就参考node.js安装

2.安装 git
下载地址 git下载
直接双击下载下来的git安装程序，同node安装，安装完之后右键发现多了两个Git GUI Here 、Git Bash Here，点击后者，然后输入git --version出现版本信息就表明安装成功了。

3.注册 github账号
github 官网 github

二.搭建个人博客

安装 hexo：

• 1.更新镜像
  参考 2018 mac终端更新淘宝npm镜像

• 2. 安装 hexo 命令

  $ sudo cnpm install -g hexo-cli
  

在这里会有 一段时间等待，请稍等

hexo安装成功

• 3. 安装个人博客
  进入到 你本地的博客存放路径

    # 进入本地博客存放目录
    $ cd /github/blog

    # 初始化 个人博客
    $ hexo init #等待一段时间

hexo初始化成功

初始化完成以后，会生成以下目录：

目录结构

#生成静态网页
$ hexo g
# 启动服务器。默认情况下，访问网址为： http://localhost:4000/   
$ hexo s

执行完以后，你就可以去打开 http://localhost:4000/ 看本地版的博客效果了。

---

三.修改主题：

next官网
这里有一些常见的hexo主题，读者可以挑选自己喜欢的安装。

个人比较喜欢 next 这款主题。基本呢就是这个效果个人博客

清除缓存文件 (db.json) 和已生成的静态文件 (public)。

$ hexo clean

下载主题

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

启动主题：

1. 修改Hexo目录下的_config.yml配置文件中的theme属性，将其设置为next

theme : next

2.生成静态页面

$ hexo clean 
# 生成静态页面
$ hexo g

# 启动服务器
$ hexo s

打开 http://localhost:4000/ 查看静态页面.

四.部署到GitHub上：

修改站点根目录下 _config.yml 文件，在最后添加

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: git@github.com:honkerSK/honkerSK.github.io.git  #这里填你自己的github地址
  branch: master

然后在命令行中执行

#注意需要提前安装一个扩展：
$ cnpm install hexo-deployer-git --save

#部署网站, 提交到github
$ hexo d

到此呢，你的博客基本就搭建完毕了。

---

博客外部插件：

这个是个人博客的第三方插件，一个博客搜索插件，一个评论插件。

搜索插件 algolia：

• 1. 注册账号 algolia

• 2. 登陆，进去创建一个索引，如图：

     
     new index

• 3. 创建一个api key，并赋予增删的权限，如图所示：

     
     new api key

  并赋予 add records,delete recourds,list indices,delete index 4个权限，如图所示：

  
  权限
• 4. 然后编辑配置文件，首先是 next 目录下的 _config.yml：

  将 # Algolia Search 下的
  algolia_search:
  enable: true  ---改为true
  

• 5. 然后修改 站点目录下的 _config.yml：
     最后增加：

  #站内搜索：
  algolia:
  applicationID: 'ZMNZVONxxx'   #Application ID 对应的值
  apiKey: 'a3b6cc86714b99e25e614968b07xxxxx'   # 这里填你新建的 api key 对应的值
  indexName: 'bigDataBeginner'  #这里填你  创建的索引名称
  chunkSize: 5000    #这个值不动
  

• 6. 执行命令，将文章列表同步到 algolia：

  $ export HEXO_ALGOLIA_INDEXING_KEY=a3b6cc86714b99e25e614968b073f442   # key值对于你新建 api key的值
  $ hexo algolia
  

  如果报错 执行 hexo clean 后，重试。然后预览。

评论插件 来必力：

• 1. 注册账号来必力

• 2. 登陆，绑定自己博客地址。如图所示：

     
     来必力

• 3. 复制 自己地址对应的id值。如图所示：

     
     复制id
• 4. 编辑 next 目录下的 _config.yml 配置文件：
     修改下面一行：

  livere_uid: "MTAyMC8zMjg2xxxxxx"  ---这里填入你复制的id值
  

  清空缓存，重新生成静态页面预览就看到效果了。

Hexo常用命令：

$ hexo clean 清除本地缓存
$ hexo g # 或者hexo generate，生成静态页面
$ hexo s # 或者hexo server，可以在http://localhost:4000/ 查看
$ hexo new "postName" #新建文章
$ hexo new page "pageName" #新建页面
$ hexo d  # 代码同步到github上

好了，本文到此结束。