博客搭建方法

准备工作

  • 注册 GitHub 账号；
  • 安装 Node.js；
  • 安装 Git 客户端；

搭建博客

1. 创建仓库

在 GitHub 中创建一个名为“用户名.github.io”的仓库，例如你的 GitHub 用户名为 test，那么该仓库名即为 “test.github.io”。创建成功后，默认会在这个仓库里生成一些示例页面，以后博客所有代码都是放在这个仓库里。

PS：

  1. 注册的邮箱一定要验证，否则不会成功；
  2. 仓库名字必须是：username.github.io，其中 username 是你的用户名；
  3. 仓库创建成功不会立即生效，可能需要过一段时间，大概10-30分钟，或者更久；

2. 绑定域名

不绑定域名可以使用默认的地址，也就是仓库名称来访问搭建的博客。

  1. 注册好域名后，在域名配置中，添加一个 CNAME 类型记录，主机记录可以填写“blog”，而后将仓库名填写到“记录值”项中。
  2. 然后在 GitHub 项目根目录新建一个名为“CNAME”的文件，无后缀名，里面填写你的域名，例如上面的“blog.xxx.cn”。

3. 配置 SSH key

用 Git bash 执行命令： $ cd ~/ .ssh ，如果提示“No such file or directory”，说明是第一次使用，没有 SSH key；配置方法如下：

  1. 粘贴下面的命令，并将邮件部分替换成你的 GitHub 注册邮箱：

    $ ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

    回车确认后会提示：

    Generating public/private rsa key pair.

  2. 当提示输入要保存密钥的文件时，直接回车确认，表示接受默认的文件位置：

    Enter a file in which to save the key (/c/Users/you/.ssh/id_rsa):[Press enter]

  3. 提示输入密码和再次确认密码都直接回车使用空密码即可：

    Enter passphrase (empty for no passphrase): [Type a passphrase]

    Enter same passphrase again: [Type passphrase again]

  4. 最终会出现一个像很多泡泡的图案，说明以及生成完毕；

  5. 打开用户目录，找到 .ssh 文件夹，用编辑器打开其中的 id_rsa.pub 文件，复制里面的所有内容；

  6. 打开你的 GitHub 主页，进入个人设置，找到 “SSH and GPG keys” 选项，选择“New SSH key”，“Title”项中可以填写这个 key 所在的设备，在“Key”项中，把刚才复制的内容粘贴进去，然后确认添加并保存；

  7. 在 Git bash 中输入命令：

    $ ssh -t git@github.com

    提示：

    Are you sure you want to continue connecting (yes/no)?

    输入 yes ，然后提示：

    Hi username! You’ve successfully authenticated, but GitHub does not provide shell access.

    username 是你的 GitHub 用户名，后面的意思就是成功通过身份验证；

  8. 初始化 Git 的个人信息，分别输入并回车确认：

    $ git config --global user.name "username" username 是你的 GitHub 用户名，非昵称；

    $ git config --global user.email "email" email 是你的 GitHub 注册邮箱。

4. 安装

在 Git bash 中使用 npm 工具来全局安装 HEXO，命令如下：

$ npm install hexo -g

安装完成后，可以使用 -version 命令查看 HEXO 版本。