hexo教程：将个人博客部署到GitHubPage过程记录

发表于 | 分类于

下面仅仅是我个人记录一下博客配置好了之后，在更换机器之后如何再次将博文部署到GitHub Page上去。至于如何配置博客，并将其部署到GitHub Page 上去，各位可以参考这篇博客，这篇博客有详细记录。博客地址：在这里 按照博客上的步骤就能配置好个人博客。

安装前提

  • Git Bash : 这个可以去官网下载:https://git-scm.com/downloads
  • 安装 Node.js：这个也可以在官网上下载：https://nodejs.org/en/
    安装完之后，可以打开git bash，输入如下命令，检测是否安装成功：
    1
    2
    git --version
    node --version

安装Hexo

在git bash 命令行输入如下命令：

1
npm install hexo-cli -g

成功安装后，会出现诸如 + hexo-cli@1.1.0 的提示信息。

如果可以打印出来，说明生效了

本地Git客户端配置

本地 Git 客户端配置，主要是为了能够在命令行模式下与远程的 GitHub 通信。

Git配置

打开git bash 命令行，键入以下命令：

1
2
git config --global user.name "你的用户名"
git config --global user.email "你的email"

其中，字符串中的内容替换为你自己的信息，这里为了清晰一致，建议使用 GitHub 账户相同的配置信息。这里的用户名就是你的github账号名，我的是nicehuster,我的邮箱是nicehuster@gmail.com.

创建SSH Key(WIN)

打开安装好的 Git Bash，键入：

1
git gui

回车之后，会启动 Git GUI 软件。在 Git GUI 软件界面，依次点击 Help => Show SSH Key

在出现的 OpenSSH 界面，点击右上角的 Generate Key 以创建 SSH Key。注意，期间会让你输入密码两次，这个密码是本地 Git 与远程 Git 通信时要用到的，要牢牢记住。

创建SSH Key(Mac)

mac 系统开始就已经为我们安装了ssh 如果没有安装没，首先安装；安装好之后，打开终端， 

1
$ ssh-keygen

一路enter下。之后会在当前用户名下面会生成一个.sh文件。打开id_rsa.pub文件 里面就有需要的ssh key。

1
$ vim  ~/.ssh/id_rsa.pub

远程GitHub

配置 SSH Key

打开你的 GitHub 个人主页，点击右上角个人头像，选择 Settings，进入设置页面。在左侧选择 SSH and GPG keys，然后在右侧点击 New SSH key，将刚刚创建的 SSH Key 的公钥文件 id_rsa.pub 中的内容复制到 Key 文本框中。

M

本地Git与远程GitHub通信

上面配置都搞定以后，我们来测试一下 Git 是否可以和我们远程的 Git 仓库通信。命令行键入以下命令：

1
2
$ ssh -T git@github.com
Enter passphrase for key '/c/Users/pcusername/.ssh/id_rsa':

当键入以上命令回车后，会出现让我们输入密码的提示，这个密码就是刚刚我们使用 Open SSH 创建 SSH Key 时所输入的密码。

注意！！！ 输入密码时冒号之后什么也不会显示，所以你只管输入就行，正确无误后按下回车键即可。

如果成功连接，会出现提示信息：

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

发表博文

使用markdown文档编辑器编写个人博文，并将编写好的博文放在\blog\source_posts文件夹下。至于博文的配图可以放在\blog\source\img文件夹下。然后使用如下命令部署到GitHub Page上去。

1
2
hexo g  #如果博文的格式有错误，这里会提示，记得要更正格式，不然无法部署到GitHub上去
hexo d  #这一步会要求你输入密码，和上面的密码是一致的。

上面记录的仅仅是我个人在更换电脑后，如何在其他机器上部署个人博客到GitHub上去。

Github Page无法访问问题

有时博客在windows上存在无法访问的问题，可以自行在cmd窗口ping 一下自己的博客地址:

1
2
(base) NICELIU-MB0:hexo-blog_v2 niceliu-mac$ ping nicehuster.github.io
PING nicehuster.github.io (127.0.0.1): 56 data bytes

访问的是127.0.0.1地址。这是DNS的问题，只需要将DNS修改为：223.5.5.5或者223.6.6.6

公式渲染问题

用MathJax语法写的一些公式，在本地Markdown编译器上渲染是没问题的，到hexo博客上显示出现问题，hexo默认使用hexo-renderer-marked引擎去渲染网页，它会把利用Markdown语法写的文本去转换为相应的html标签。所以我们只需要卸载默认引擎，并安装这个新的渲染引擎即可

1
2
npm uninstall hexo-renderer-marked --save
npm install hexo-renderer-kramed --save

如果上面的方法还没能解决公式渲染的问题，可以参考如下解决方案：

hexo next 主题解决无法显示数学公式