GitHub + Hexo 博客搭建

Eric

Blog

发布于：2018年10月14日

此文介绍了搭建 Hexo 博客的全过程。然而在安装前，您必须检查电脑中是否已安装下列应用程序

必备应用

• Node.js
  • 首先下载最新的 LTS（长期支持版）的 Node.js，除了安装路径自选外，其它选项全部默认，一路点击 Next 即可。最后安装好之后，cmd 输入 node -v，如果出现版本号，那么就安装成功了。
• Git
  • 除了安装路径自选外，有一步我们要确保勾选 Git Bash Here，取消 Git GUI Here 的选项，其余选项默认，一路点击 Next，安装完后就可以直接在鼠标右键菜单选项里打开 Git Bash 了。可以在 Git Bash 输入 git --version 验证是否安装成功
• yarn
  • 点此 下载 yarn 的安装包，安装即可。（在安装 yarn 之前请先确保您已经安装过 Node.js）除了安装路径自选外，其余安装选项默认即可。可以在 Git Bash 输入 yarn -v 验证是否安装成功

本教程假定你已经安装上述必备程序。这里我还想说一句，很多教程是用 npm 包管理器来安装依赖的，我这里则是用的 yarn，yarn 和 npm 相比有很多优势，更多详情和 npm 命令之间的差异建议自行去网上搜索。

Hexo 安装及建站过程

1. 全局安装 Hexo（在 cmd 输入）

1

yarn global add hexo-cli

2. 配置环境变量

桌面上的「此电脑」图标，鼠标右键，「属性」，「高级系统设置」，「环境变量」，在「系统变量」一栏的「Path」，点击「编辑」，「新建」，把路径 C:\Users\<用户名>\AppData\Local\Yarn\bin 写进去（此处路径取决于你电脑的用户名），保存即可。

3. 找个目录建立站点（在你认为合适的目录下鼠标右键，点击 Git Bash Here，下面的 your_blog_name 是自定义的，随你喜好设定），然后输入命令：

1
2
3
4

hexo init your_blog_name
cd your_blog_name
yarn
yarn add hexo-deployer-git

完成上述操作后接下来就该部署到 GitHub Pages 上了。

GitHub Pages 必备条件

• 拥有一个 GitHub 账号
  • 如果还没有账号的自行 点击这里 注册
    创建一个名为 your_username.github.io 的 repository（此处的your_username指的是你的 GitHub 用户名）

配置 SSH 密钥

配置 GitHub 的 SSH 密钥可以让本地 Git 项目与远程的 GitHub 建立联系，让我们在本地写了代码之后直接通过git操作就可以实现本地代码库与 GitHub 代码库同步。操作如下：

检查本地上是否已有 SSH 密钥

打开 Git Bash，并运行：

1

cd ~/.ssh

• 如果是 No such file or directory 的就是还没没有 SSH 密钥，如下

1
2
3

Innovation@DESKTOP-0URF3TU MINGW64 /d/repositories
$ cd ~/.ssh
bash: cd: /c/Users/Innovation/.ssh: No such file or directory

• 如果是成功切换了目录的就是已有 SSH 密钥的，如下

1
2
3
4
5

Innovation@DESKTOP-0URF3TU MINGW64 /d/repositories
$ cd ~/.ssh

Innovation@DESKTOP-0URF3TU MINGW64 ~/.ssh
$

还没有 SSH 密钥看这里

1. 首先打开 Git Bash，输入下列命令

1
2

git config --global user.name "your_username"
git config --global user.email "your_email"

• 上面命令中的 your_username 和 your_email 以你是实际 GitHub 用户名和注册时填写的邮箱地址即可。

2. 创建一对新的 SSH 密钥，输入以下命令

1

ssh-keygen -t rsa -C "your_email"

• 上面的 your_email 以你的邮箱地址替换即可

3. 按回车确认key保存的路径

1
2

Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/Innovation/.ssh/id_rsa):

此处直接回车即可

4. 输入密码

此处建议不要设置密码，直接回车，不然每次你本地文件发生变化要部署到 GitHub 仓库的时候都要繁琐的输入密码

1
2

Created directory '/c/Users/Innovation/.ssh'.
Enter passphrase (empty for no passphrase):

5. 确认密码

设置了密码的就输入密码再回车，没设置密码的回车键确认即可

1

Enter same passphrase again:

6. 输入完成之后，屏幕大致会显示如下信息：

1
2
3
4

Your identification has been saved in /c/Users/you/.ssh/id_rsa.
Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub.
The key fingerprint is:
01:0f:f4:3b:ca:85:d6:17:a1:7d:f0:68:9d:f0:a2:db your_email@example.com

已有 SSH 密钥看这里

1. 在 Git Bash 里显示你的 SSH 密钥

1

cat ~/.ssh/id_rsa.pub

2. 鼠标复制返回的内容

3. 接着：

• 登陆 GitHub，进入你的 Settings
• 点击左栏的 SSH and GPG Keys 选项
  • 选择 New SSH Key，在 Key 文本框里直接粘贴刚才复制的内容
  • Title 文本框可以不填，点击 Add SSH Key 就好了

测试 GitHub 的身份验证

1. 输入下面的命令，看看设置是否成功，git@github.com 的部分不要修改：

1

ssh -T git@github.com

2. 如果大致是下面的反馈：

1
2
3

The authenticity of host 'github.com (207.97.227.239)' can't be established.
RSA key fingerprint is 16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48.
Are you sure you want to continue connecting (yes/no)?

输入 yes 即可

然后反馈如下，那么就验证成功了

1

Hi ericclose! You've successfully authenticated, but GitHub does not provide shell access.

修改 blog 的配置文件

打开你一开始创建的 blog 文件夹，用文本编辑器（推荐 vscode 或者是 Notepad++ 这类带语法高亮的编辑器）打开刚文件夹下的 _config.yml 文件，然后修改最后一块代码：

1
2
3
4

deploy:
  type: git
  repository: git@github.com:your_username/your_username.github.io.git
  branch: master

把上面的 your_username 改成你 GitHub 的用户名就完成了所有配置。

生成 public 文件夹并部署到你的 GitHub Pages

在你 blog 根目录下鼠标右键，点击 Git Bash Here，输入

1
2

hexo g
hexo d

• 上面的 g 代表的是 generate（生成），d 代表的是 deploy（部署）
  命令可以简写成一行 hexo g -d

完成

进入你的 GitHub Pages 看看效果了，链接是 https://your_username.github.io （your_username 用你的用户名替代即可）

默认的 Hexo 主题是 landscape，最初只有一篇文章，效果图如下：

GitHub Pages

hexo