hexo + github 搭建个人专属博客

Question

一直以来想搭建属于自己的博客，终于前段时间集中精力与时间去做了这件事情。

什么是 hexo？

Hexo 是一个快速，简洁且高效的博客框架，并且免费。

安装软件环境

安装 node.js

访问 node.js 官网 ，根据自己计算机的操作系统选择相应的安装版本。然后再选择 stable 版本点击下载。双击下载的安装包，点击安装。注意：windows 系统平台安装 node.js 的过程中，需要勾选添加到 path 选项，以便能在 cmd 中直接调用 node 和 npm。
打开 cmd 命令框或者终端，分别输入 node -v 和 npm -v，能够查看到版本信息，即表示安装完成。

安装 git

访问 git 官网 ,下载与自己计算机系统平台相对应的安装版本。双击下载的安装包，点击安装。注意：windows 系统平台安装 git 过程中，同样需要选择安装到 path 下。
打开 cmd 命令或者终端，输入 git –version，能够查看到版本信息，即表示安装成功。

安装 hexo

首先在你想要存放站点配置文件和博客文章的路径下创建一个文件夹。以 windows 系统为例，在 D 盘路径下创建 hexo 文件夹。mac os 系统
打开 cmd 命令框，输入 D：，然后输入命令:cd hexo。将工作路径切换至 D:\hexo 路径下。
在命令行中输入命令:npm install hexo-cli -g 等待安装完成
然后在命令行中输入 npm install hexo –save 等待安装完成
最后在命令行中输入 hexo -v，能够查看到 hexo 版本信息，即表示安装完成。

注册 github 帐号

进入 github 官网，输入帐号名、登录密码、自己邮箱，点击 sign in 注册 github 帐号。
打开邮箱自己刚才填写的邮箱，点开 Github 发送给你的注册确认链接，确认注册，结束注册流程
登录 github 后，点击 New repository，创建代码库。
进入代码库创建页面，在 Repository name 下填写 yourname.github.io。然后点击保存。注意 yourname 表示你的 github 帐号名。

初始化 Hexo

输入如下命令初始化、开启 hexo 服务

hexo init
hexo g
hexo server

部署

配置 Git 个人信息

设置 Git 的 user name 和 email：

git config --global user.name "yourusername"
git config --global user.email "youre-mail@example.com"

生成密钥

ssh-keygen -t rsa -C "youre-mail@example.com"

将生成的公钥贴至 github 上

通过 cd 命令进入 C:\Users\Administrator.ssh；有两个文件：id_rsa 为私钥、id_rsa.pub 为公钥。主要将公钥贴到 github 上，私钥是要自己保存的。
登陆 github，进入 setting-SSH and GPG keys 页面，新建一个 new ssh key，将 id_rsa.pub 里的内容贴进去。
使用如下命令测试是否连接 github 成功。

ssh -T git@github.com

配置 Deployment

在_config.yml 文件中，找到 deploy，然后按照如下修改：

deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git
  branch: master

注意：yourname 代表你的 github 帐号名

主题推荐

博主目前用的是 next 主题 ，下载地址推荐去 github 上下载，链接 请点 。安装好 next 主题后，打开根目录下的_config.yml，此文件也可以被称为站点配置文件，通过编辑 theme 字段，将其更换为 next。注意配置 yml 文件时，字段与数值之间必须有空格。不然会报错！如果需要对主题进行个性化配置，请打开 myblog/themes/next/下的_config.yml 文件，此文件被称为主题配置文件。具体的配置过程这里就不做详细介绍了。毕竟个人喜欢不同。

另外一个比较值得推荐主题为 yilia ，有兴趣可以点击该链接进入 github 下载。

写文章与博客发表

博客文章全是使用 markdown 语言语法写的，如果不清楚， 请点击 。mac 平台推荐使用 Sublime 文本编辑器，windows 平台推荐使用 nodepad++进行写作，最后文件保存为 example.md 格式。博客文章放置到

/myblog/source/_posts 路径下

通过使用如下命令进行发表

hexo clean    
hexo g
hexp d

当然发表文章前，最好可以使用如下命令在本地预览一下效果

hexo g
hexo sever

其他一些 tips

mac 用户请在配置开始前开启 root 用户权限，因为后续配置需要 root 权限。博主前面没开启 root 权限，使用普通用户权限生成了 ssh 公钥。但后面配置需要开 root 权限后，用 ssh 一直连接 github 失败，最后竟然是坑爹的 root 用户与普通用户的公钥私钥均不一致。最后博主又把 root 用户下的公钥贴到 github 上才解决。