基于GitHub Pages / Hexo / Fluid主题搭建个人博客的刨坑之路

Firstly, welcome to Yao's blog!

这是基于 Hexo 搭建的第一个博客，有关 Hexo 的任何使用和其它问题建议参考 GitHub 或 troubleshooting.

博客搭建流程

主要参考的网络资源

(1) CSDN 上的'史上最全教程'博客 (2) 腾讯云上的 win10 搭建 hexo 的博客

基础软件安装 (win10)

Git Nodejs

# 版本检查，后面可能需要注意npm, node 和 hexo的版本兼容问题。
$ npm -v
# 配置Git账户
$ git config --global user.name ""
$ git config --global user.email ""

GitHub 创建仓库

注意 repository 命名和 github 账号名称保持一致，在 setting > pages 处可查看 url (格式：<用户名>.github.io)。

安装 Hexo (win10)

Hexo 是一个基于 NodeJS 的静态博客网站生成器，首先需要打开 cmd,使用如下命令安装：

$ npm install -g hexo-cli
# 查看hexo版本
$ hexo -v

创建 Hexo 项目并初始化

新建 blog 文件夹，作为根目录, git bash 中执行下列操作：

$ cd blog
$ hexo init
$ npm install

# 生成web
$ hexo g
# 本地启动
$ hexo s

接着，在本地的浏览器中就可访问 http://localhost:4000, 启动 blog 页面。

更换主题

这里使用 Fluid 主题，其它主题可参考hexo 可选主题 具体安装步骤见Fluid，需要修改blog主目录中的文件_config.yml：

# 指定主题
$ theme: fluid
#指定语言
$ language: zh-CN

此外，个性化页面的展示可以修改_config.yml中的title字段，博客的标题可以在主题theme\fluid文件夹下的_config.yml中的blog_title字段，主页正中间的文字可以修改主题theme\fluid文件夹下的_config.yml中的text字段，修改过后 blog 的显示内容就变成了个人信息。

GitHub 远程部署

首先需要本地生成 ssh key,用于连接 github 认证，启动 Git bash

$ ssh-keygen -t rsa -C "github注册邮箱"

将生成的.ssh/id_rsa.pub copy 到 GitHub 的 SSH keys 中，进行通信。

接着，在本地编辑好 blog 之后（同样可修改_config.yml配置文件和source>_post\文件夹下的 md 或 html 文件），配置个人域名和 github 部署(_config.yml):

url: http://name.com
deploy:
  type: git
  repo: https://github.com/name/name.github.io.git
  branch: master # define

最后，执行

$ hexo g # 本地生成
$ npm install hexo-deployer-git --save # 安装Git插件
$ hexo d # 远程部署

远程部署连接 Error 443，Error 404 等

第一次执行部署时报错 443，unable to access,可能原因是本地 proxy 和 github 连接不上的问题, 参考一篇 blog 解决报错。

首先，关闭 vpn，执行

$ git config --global --unset http.proxy

修改_config.fml文件将repo部分替换成ssh地址git@github.com:name/name.github.io.git

接着查询 github ip 地址，在/etc/hosts文件中添加ip github.com, 重新执行hexo d,即可。