Hexo+Next在Github上搭建博客教程

Hexo+Next在Github上搭建博客教程

---

摘要：本文是一篇介绍如何在windows系统下搭建独立博客的教程，主要使用Hexo和Next主题在github上搭建。

---

前言

为什么要写博客？这里推荐一篇知乎专栏文章。 你为什么要写博客 陈素封

如果一件事情你不能讲清楚，十有八九你还没有完全理解。

很多时候总是眼高手低，以为自己都会了，但是如果让你写出来，讲出来，才发现根本没办法解释清楚。既然写就要对得起写本身，写出来的东西应该是自己思考后的东西，不是去记录流水账，更不是发牢骚和抱怨，要追求写的质量。

博客搭建教程

工具准备

1. 注册github账号
2. 安装node.js和Git

安装Hexo

有关Hexo的具体使用，详见官网

安装方式使用Git Bash，输入下面命令即可安装Hexo工具

npm install -g hexo-cli

安装完Hexo后，自己选择合适的磁盘位置，执行右键Git bash Here,然后执行下面的命令，Hexo将会在制定的文件夹中新建所需要的文件。

hexo init <folder>
cd <folder>
npm install

这里的 是文件夹的名字，可以自定义，博客的文件资源都会存储在这个文件夹中。

执行完命令后，在文件夹下的_config.yml文件是网站的配置文件，后续需要对此文件进行修改以完成网站的配置。

在这一步我们就可以将网站在本地跑起来，只需要执行下面的命令：

hexo server

然后使用浏览器打开http://localhost:4000就可以在本地查看效果。Hexo默认主题使用的是landspace, 这里推荐使用Next主题，或者如果自己喜欢其他主题也可以自己更换。

安装Next主题

有关Next的详细使用方法可以去 官网 查看。这里只做简单的说明。

在Hexo站点目录下使用右键Git Bash Here, 然后执行下面命令

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

安装完之后启用主题，打开站点目录下面的配置文件_config.yml。 找到 theme 字段，并将其值更改为 next

这里说明一下，在 Hexo 中有两份主要的配置文件，其名称都是 _config.yml。 其中，一份位于站点根目录下，主要包含 Hexo 本身的配置；另一份位于主题目录下，这份配置由主题作者提供，主要用于配置主题相关的选项。

Next主题有很多个性化配置，具体去官网查看更加方便。

如果想使用其他主题，可以去这里寻找：Hexo 主题

将博客部署到Github上

首先需要在github上新建一个 username.github.io 的repository，username为你的github用户名。

这里我们使用ssh连接方式和github进行连接。首先在git命令行中对git进行全局配置

git config --global user.name "你的用户名"
git config --global user.email "你的邮箱地址"

检查是否生成过key

cd ~/.ssh

如果没有生成过，使用下面命令生成

ssh-keygen -t rsa -C "邮箱地址"

这里如果不想设置密码可以直接回车，密码为空。然后在C盘用户文件夹中会发现一个隐藏文件夹，文件夹名字为 .ssh ，然后在github网站setting中找到添加SSh key 的菜单 ,将id_rsa.pub 的内容全部复制到key的编辑框中，保存。

回到git命令行，输入

ssh  -T git@github.com

这里会要求你输入SSH key密码，如果刚才生成SSH key时未输入密码，密码就为空；然后看到信息：
Hi 用户名! You’ve successfully authenticated；说明配置成功；

使用git部署网站需要安装hexo-deployer-git

npm install hexo-deployer-git --save

然后对网站配置文件，即站点目录文件下的_config.yml 文件中的deploy字段设置：

deploy:
  type: git
  repo: <repository url>
  branch: [branch]

repository url 可以直接在github上使用Clone or download 按钮中进行复制。配置完成后使用下面命令即可将网站配置到github上。

hexo deploy

如果想要使用自定义的域名，需要在/thems/next/source 文件夹下新建CNAME 文件，主义没有后缀名，直接将自己的域名写入。然后在域名服务解析中添加CNAME解析记录即可。