工具准备

1.首先我们需要准备两个东西，分别是

Git

Node

去官网下载之后安装只需要一路默认就可以了

安装完成之后可以win+r输入cmd，打开命令提示符窗口

分别输入

node-v

npm-v

来确认工具都安装完成

git安装完成之后右键会出现这个

image-20241113124437665

搭建 GiHub 博客

登录 GitHub 账号,点击New repository，新建一个名为 username.github.io（这里的 username 要替换成自己的实际的用户名） 的仓库，如下图

记得库要是公开的，add也要勾上

image-20241113124332516

配置SSH key

在桌面右键打开 Git Bash，输入命令：

1
$ ssh-keygen -t rsa -C "user.email" # user.email 为GitHub 上注册的邮箱

然后直接三个回车即可。接下来查看是否已经有 ssh 密钥。打开用户主目录 C:\Users\username\.ssh，.打开.ssh文件夹

image-20241113124819097

打开id_rsa.pub 密钥，将内容全部复制。其中 id_rsa 是私钥不能泄露，id_rsa.pub 是公钥可以放心告诉他人。

打开 GitHub SSH and GPG keys 页面，新建一个 ssh key：

image-20241113124924045

title是标题名字，可以随便填

下面的key里面要粘贴你复制的id_rsa.pub里面的内容

最后点击 Add SSH key。在 Git Bash 中检测 GitHub 公钥设置是否成功，输入如下命令：

1
$ ssh -T git@github.com

验证是否连接成功，连接成功的话，显示如下：

image-20241113125159450

使用 Hexo 博客框架

Hexo官方文档

Hexo 是什么

Hexo 是一个简单、快速、强大的基于 Github Pages 的博客框架，支持 Markdown 格式，有众多优秀插件和主题。

Hexo 原理

由于 Github Pages 存放的都是静态文件，博客存放的不只是文章内容，还有文章列表、分类、标签、翻页等动态内容，假如每次写完一篇文章都要手动更新博文目录和相关链接信息，相信谁都会疯掉，所以 Hexo 所做的就是将这些 md 文件都放在本地，每次写完文章后调用写好的命令来批量完成相关页面的生成，然后再将有改动的页面提交到 GitHub 。

安装与初始化

在 Git Bash 中输入以下命令：

1
$ npm install -g hexo-cli

安装完成后，在电脑的某个地方新建一个文件夹（名字可以随便取）专门用于存放博客代码，比如我的是 D:\Hexo-git，由于这个文件夹将来存放博客的所有内容和素材，以及所有的博客操作都会在其中完成，所以最好不要随便放。

进入新建的博客目录，输入如下命令：

1
$ hexo init

生成静态文件

在 Git Bash 中输入以下命令：

1
$ hexo g

执行以上命令后，Hexo 就会在 public 文件夹中生成相关的 html 文件，这些文件将来都是要提交到 GitHub 上的 username.github.io 的仓库中去的。

本地预览

在 Git Bash 输入以下命令：

1
$ hexo s

hexo s 是开启本地预览服务，打开浏览器访问 http://localhost:4000 即可看到内容，Ctrl+C 停止本地预览

上传到 GitHub

配置站点配置文件

hexo 有 2 种 _config.yml 文件，一个是根目录下的全局的 _config.yml，一个是各个主体 theme 下的 _config.yml。将前者称为站点配置文件， 后者称为主题配置文件。

打开根目录下站点配置文件 _config.yml，配置有关 deploy 的部分：

1
2
3
4
5
6
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
  type: git
  repo: git@github.com:cn-zhy/cn-zhy.github.io.git #这个是你仓库的SSH 密钥
  branch: master  #根据你仓库主题进行选择

安装插件

在 Git Bash 中输入以下命令：

1
$ npm install hexo-deployer-git --save

如果不输入这个的话，你直接使用 hexo d 部署到 GitHub是会报错的！

部署到 GitHub

在 Git Bash 中输入以下命令：

1
$ hexo d

访问网站

当你完成了以上所有操作就可以登录自己的网站来查看了，网站是:

1
username.github.io  #这里面的username是你的仓库名字