Hexo+Github Pages 实现个人博客的小白教程 ——上篇

最近有朋友在使用Hexo做自己博客，前几日我弄过Hexo的安装教程

不过上次的是部署到了一台自己的VPS上

这篇将上次的文章修改增加了一点以部署带 Github Pages

读前注意

本文章并不包含Hexo的使用教程（请见Hexo+Github Pages 实现个人博客的小白教程 ——下篇）

本人的部署平台为Github

本文要求您有一定的自我学习能力，毕竟这只是我的经验记录，若你怕麻烦抱歉本文章不适合您

最后温馨提示本文完整仔细阅读可能需要5min左右，若您想对照实操可能需要半个小时！！！动手前请确保您有此需求！！！

一、安装`Node.js`

1、官网下载Windows版本

https://nodejs.org/zh-cn/

推荐选用 LTS长期支持版本

2、安装好后shift+右键打开Powershell并检查是否安装

二、安装`Git`并配置

1、官网下载并安装

https://git-scm.com/

国内下载速度慢的化可以搜索镜像源~

推荐清华大学镜像源

2、配置

①打开`Git Bash`右键

②配置

GitHub的注册并不会提供教程，请自行百度~

# 将此处的"yourname"替换成自己Github的用户名
git config --global user.name "yourname"

# 将此处的"youremail"替换成自己GitHub的邮箱
git config --global user.email "youremail"

③输入以下代码检查是否有`SSH Key`

cd ~/.ssh

此图说明当前客户端不存在SSH Key，则需按照如下步骤创建SSH Key

1 2	# 将此处的"youremail"替换成自己Github的邮箱 ssh-keygen -t rsa -C "youremail"

我为了方便直接不设置密码了（这里输入密码是不会回显如果键入密码后不显示是特性哦并不是没输入进去）

④接下来查看刚刚创建的SSH Key 并将其记录下来等下后面的步骤会用到

1	cat ~/.ssh/id_rsa.pub

全选后右键选择Copy复制知道一个位置临时保存等下还会用

三、安装`Hexo`

1、全局安装

1	npm install -g hexo-cli

(上图的意思是以管理员方式打开 Git Bash 并不是 “从列表中删除哦~”

后面鸽子测试不用管理员权限也是可以的如果遇到权限问题可以试试用管理员模式

此处我们的目录为演示方便创建在了桌面Blog文件夹

Git Bash切换到目录

在当前目录初始化Hexo

1	hexo init blog

**注:**这里鸽子打错了一般在一个文件夹下直接输入hexo init即可，这里鸽子加了一个blog意味着在当前的目录下新建一个 blog 文件夹，并在这个文件夹下初始化

3、安装`Git`插件及其其他插件

首先在blog文件下打开 Git Bash，在输入npm install进行包的安装。

而后在Git Bash中键入如下指令安装Git插件

1	npm install hexo-deployer-git --save

而后在Git bash里输入hexo s 然后在浏览器中打开localhost:4000即可以看到搭建完成的Hexo

四、GitHub设置

此处不提供Github的注册教程请自行百度~

1、在`Github`上创建对应的仓库，

注意此处 {Username}.github.io

{Username}应与你的GitHub名称一致如上所示本人为 XGLJY 所以我的仓库名为 XGLJY.github.io

然后注意点选下面的 Add a README file

最后点击下面的绿色摁键创建仓库

稍等片刻进入这个仓库便可以看到 README.md 已经显示在下面 (别问为啥换了一个账号问就是小号被封了呜呜呜，创建到被封一共20分钟呜呜呜，在此处接了朋友的GayHub ,朋友的主页➡️点我点我)

然后我们打开{YourName}.github.io ({YourName}替换成你自己的)就会发现GitHub Pages 已经自动创建好（若没有稍稍等一下同步需要时间）

下面是打开的图

2、并将你的SSH Key添加至你的GitHub账户

在Git的设置中我们生成了SSH Key 现在我们将其添加进你的Github账号首先点击账号设置（如图

添加完SSH Key的截图

然后我们回到{YourName}.github.io这个仓库的首页

点击绿色的Code并在弹出的框中选择SSH的链接复制备用

五、Hexo简单使用

首先打开位于站点根目录下的_config.yml文件

此文件为站点的配置文件我们需要配置下一键部署（Deployment）的配置

此配置项一般在配置文件的最下面

接下来就要对此项进行配置，首先介绍一下需要配置的参数以及介绍

注意切记注意Yaml语法的缩进以及冒号后面的空格

参数	介绍
`type`	此处为一条指令部署类型一般为`git`
`repo`	远程仓库的地址，鉴于本鸽子添加了我的SSH公钥至`Github`仓库可以以使用SSH地址以使用免密登录！举个例`git@github.com:UserName/UserName.github.io.git`
`branch`	分支，此处注意`Github`的默认分支不再是`master`已经改为了`main`
`message`	此为`git`提交到`Github`的附加信息！

下面这个例子，便是我需要填写的需要按照你的站点更改对应的

deploy:
  type: git
  repo: git@github.com:RFTyitoti/RFTyitoti.github.io.git
  branch: main
  message: "Update!!!"

编辑完毕后保存退出

在根目录右键打开Git Bash 输入如下指令创建本地静态文件并运行本地服务器

#创建本地静态文件
hexo g
#运行本地服务器
hexo s

（不贴图了 hexo 安装的时候有图

检查不存在问题后使用hexo d部署至GitHub

首次链接可能会出现这个输入yes就行

之后等待提交完毕就可以在 {YourName}.github.io 看到你Hexo的初始页面了

至此本文章结束较为详细的使用请看下篇文章！

一、安装Node.js

1、官网下载Windows版本

2、安装好后shift+右键打开Powershell并检查是否安装

二、安装Git并配置

1、官网下载并安装

2、配置

①打开Git Bash右键

②配置

③输入以下代码检查是否有SSH Key

④接下来查看刚刚创建的SSH Key 并将其记录下来 等下后面的步骤会用到

三、安装Hexo