Hexo + Github搭建个人博客

前言

B站看到的教学，建议直接看原视频学习。
https://www.bilibili.com/video/BV1mU4y1j72n?p=3

1 小知识

1.1 何为Hexo

Hexo 是一个快速、简洁且高效的博客框架。Hexo 使用 Markdown（或其他渲染引擎）解析文章，在几秒内，即可利用靓丽的主题生成静态网页。

1.2 什么是Github Pages

GitHub Pages 是由 GitHub 官方提供的一种免费的静态站点托管服务，让我们可以在 GitHub 仓库里托管和发布自己的静态网站页面。

2. 搭建博客步骤

2.1 准备阶段

1. Node.js:
   https://nodejs.org/en/
   选择左边的版本下载

2. GIt：
   https://git-scm.com/download/win

3. 注册一个Github账号
   https://github.com/

4. 找个地方创建一个名为blog的文件夹

打开命令窗口

2.2检验Node.js及npm是否安装成功

输入

node -v

后，出现Node.js版本号即安装成功，如下图：

同理，输入

npm -v

检验Node.js下的npm工具是否安装成功，显示版本号即成功。

2.3 检验Git是否安装成功

输入

git--version

返回版本号即安装成功

2.4 安装Hexo

输入

npm install hexo-cli -g

没有出现error即安装成功

2.5 搭建仓库

打开Github登录，如果打不开网页那就多试试，因为Github是国外网站，会有网络波动。
在页面上点击左边的绿色按钮Create repository。

出现这个页面，在Repository name中填写
[你的Github账号的用户名].github.io，如果不知道自己的用户名，点击右上角用户头像旁小三角，即可看到自己的用户名。

Description一栏中填的是简介，可填可不填。
勾选Add a README file，让创建的仓库不为空。
最后点击最下方的“Creat repository”绿色按钮就创建成功啦。

2.6 生成SSH keys

打开此电脑，任意进入一个文件夹，在文件夹空白处右击鼠标，再点击
"Git Bash Here"会弹出一个git窗口。

在git窗口中输入

ssh

检验是否有ssh工具

再输入

ssh-keygen -t rsa -C "你Github的邮件地址"

注：Git窗口中的复制粘贴快捷键和Windows中的不同，建议复制后在Git窗口中右键Paste粘贴。

输入完这个指令后等Git窗口不再运作时按回车，共按三次。
这样就在C:\Users\Administrator中生成了一个.ssh文件。

找到并打开.ssh文件夹，用记事本的形式打开"id_rsa.pub"文件，直接Ctrl + A 全选再 Ctrl + C 复制。

复制后打开Github点击右上角头像旁边的小三角，再点击Settings。

在Settings界面中找到并点击"SSH and GPG keys"。

然后点击绿色按钮"New SSH key"进入到这个界面。

Title一栏中可以随便写，只是帮助用户标识SSH密钥。
在Key一栏中粘贴刚刚复制的SSH，然后点击"Add SSH key"即可。

检测ssh是否绑定成功：在Git窗口中，输入

ssh -T git@github.com

在弹出的提示中输入yes，最后弹出

即绑定成功。

2.7 本地生成博客内容

在创建好的blog文件中，右击空白处点击"Git Bash Here"打开git窗口。

输入指令

hexo init

运行成功后你就会发现blog文件夹中多了许多东西。

如果出现下图中的报错

多试几次就好，因为github是国外的网站，不稳定。

再输入

hexo s

复制弹出的网址打开，就可以预览我们的博客页面啦。（PS：Ctrl + C可关闭这个网站，如果打不开网页的话看看是不是自己不小心把网页关闭了）

2.8修改配置文件发布博客到互联网

打开blog文件夹中的"_config.yml"文件，滑到最下方找到deploy:并修改

deploy: 
  type: git
  repo: https://github.com/你的用户名/你的用户名.github.io.git
  branch: main

在blog文件夹中右键打开"Git Bash Here"，在Git窗口输入

npm install hexo-deployer-git --save

成功后再次输入指令

hexo d

这里可能会报错，如果报错是连接错误的话多试几次就好。
然后你就可以通过访问到自己的博客啦。
网址：https://你的用户名.github.io/

可能出现的问题：
会弹出窗口让你确认用户名，按照要求输入即可。
确认用户名会再次弹出窗口，这时我们先到Github中点击右上方头像旁边的小三角再选中“Settings”进入到设置页面。在设置界面找到"Developer settings"。

进入到下个页面中，先点"Personal access tokens"后再点击"Creat new token"创建新令牌。

然后进入到新界面。

Note一栏是填令牌名称。
Expiration是令牌期限。
下面勾选的选项是令牌权限，建议全选。
选好后点击最下方的"Generate token"即可。

带绿色对勾的就是令牌，建议把令牌保存下来，因为你再次打开就看不到令牌了。
直接把令牌粘贴到弹出的窗口中即可。

到此结束。