Hexo + GitHub Pages搭建个人博客网站详细流程

前言
我们通过Hexo + GitHub Pages搭建个人博客，让人不用购买域名和服务器就可以拥有个人页面。尝试了下，并分享给大家。
个人页面：https://www.sinulin.com/

目录

一、准备工作
二、开始搭建博客
三、将hexo部署到Github上
四、修改主题
五、设置个性化域名

一、准备工作
须知（You should know）

---

Q:什么是 Hexo

A:Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

Q:Hexo安装前提

A:安装 Hexo 相当简单。然而在安装前，您必须检查电脑中是否已安装下列应用程序：

i.Node.js

ii.Git

Q:什么是gitHub 和 GitHub Pages

A:gitHub是一个面向开源及私有软件项目的托管平台，因为只支持git 作为唯一的版本库格式进行托管，故名gitHub。

GitHub Pages是一种静态站点托管服务，旨在直接从GitHub存储库托管您的个人，组织或项目页面。

---

1.安装 Node.js

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

测试安装：命令行使用node -v ，查看显示版本号即成功。

2.安装 Git

• Windows：下载并安装 git.
• Mac：使用 Homebrew, MacPorts ：brew install git;或下载 安装程序 安装。
• Linux (Ubuntu, Debian)：sudo apt-get install git-core
• Linux (Fedora, Red Hat, CentOS)：sudo yum install git-core

Windows 用户，也可以参考这个页面，收录了存储于百度云的下载地址。

3.安装 Hexo

所有必备的应用程序安装完成后，即可使用 npm 安装 Hexo。

npm install -g hexo-cli

Q:如何卸载Hexo？

A:3.0.0版本执行npm uninstall hexo-cli -g ，之前版本执行npm uninstall hexo -g 。

4.注册Github账号

注册Github账号后，通过Github 里面的 GitHub Pages 得到 个人页面。

地址: https://github.com/

注册Github的时候一定要选择一个合适的名字,Github Pages的Repository名字是特定的，比如我Github账号是SinuLin，那么我Github Pages Repository名字就是SinuLin.github.io。

5.购买一个域名（可选）

你可以使用自己的域名来自定义Github Pages的访问。

二、开始搭建博客

1.开启GitHub Pages服务

官方：https://pages.github.com/

i.新建仓库

搭建我们的个人博客需要一个唯一的域名，我们可以申请购买一个域名来使用，也可以通过Github Pages获得一个免费使用的域名，这需要我们在Github上新建一个仓库，如下：

新仓库的名字，一定要是UserName+github.io的形式。

最后我们得到的博客网站的链接就会是：https://UserName.github.io的形式。 

ii.选择主题创建，创建基础模板

点击Create Repository之后，随后选择Setting进入设置，找到Github Pages如下：

点击Choose a theme,跳转到选择主题的页面。

这里选择一个主题，成功后，我们就可以使用https://UserName.github.io，访问自己的博客网站了。

2.本地生成博客页面

上述的步骤我们使用Github page，得到一个可以外部范围域名的默认博客页。

接着我们使用Hexo在本地生成漂亮的静态页面，并同步到github上。

i.安装依赖

切换到安装的指定文件夹中，安装依赖文件，命令如下：

npm install hexo-deployer-git —save

ii.新建一个网站

$ hexo init [folder]

新建一个网站。如果没有设置 folder ，Hexo 默认在目前的文件夹建立网站。

iii.生成静态文件

$ hexo generate
可简写 $ hexo g

iv.启动本地服务器

$ hexo server
可简写 $ hexo s

启动服务器。默认情况下，访问网址为： http://localhost:4000/。

三、将hexo部署到Github上

修改配置文件blog/_config.yml，修改deploy项的内容（在文件末尾）。

注：可以使用SSH，也可以使用https

输入下面的命令将hexo博客部署到github中：

hexo clean     # 清空静态页面
hexo generate  # 生成静态页面
hexo deploy    # 上传到仓库 

现在，我们再次访问链接：https://userName.github.io，发现这里的界面和本地的一样，个人博客搭建完成。

四、修改主题

1.选择并下载主题

我们可以更换主题，选择你喜欢的。

https://hexo.io/themes/

在这里我们可以挑选你喜欢的主题。

2.下载对应主题，并放在主题文件thems下

3.修改博客配置文件，更换主题配置

修改博客根目录(不是主题)下的_config.yml文件，搜索theme字段，并将其值修改为主题名字,如diaspora。

输入下面的命令将hexo博客部署到github中：

hexo clean     # 清空静态页面
hexo generate  # 生成静态页面
hexo deploy    # 上传到仓库 

现在，我们再次访问链接：https://userName.github.io，发现这里的界面和本地的一样，个人博客搭建完成。

注：

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

五、设置个性化域名

1.注册解析域名

我们可以设置自己域名，大家可以在阿里或者腾讯上面注册一个域名。

解析域名并指向我们之前的博客网站https://UserName.github.io

1

将域名和刚创建的网站代码仓库相关联

方法一：

Setting进入设置，找到Github Pages，输入Custom domain(自定义域名)，这时会在项目里创建了一个CNAME文件，里面就是你自定义跳转域名。

方法二（建议使用）：

直接在本地项目建立CNAME，同理README.md也在本地建立，这样每次都可以同步上去，不容易丢失。

特别是README.md，如果没在在本地，直接在Github上面创建，每次我们上传同步博客，就会把这个覆盖掉。把这个文件放到source里面，同时配置设置忽略，因为执行命令hexo g之后，会把source文件里的.md格式的文件渲染为html文件并放到public下面；

修改Hexo根目录下的_config.yml文件，将skip_render参数的值设置为README.md

more:例如创建about页面（关于我），以及使用Gitalk 评论插件，还有更多闪亮点，就不一一说明了，宝藏等待你去发掘。