Hexo 框架下利用 github 搭建博客 (win 11)

2022-11-01
作者 rippleQAQ
~3.18K 字

1. 一、前置条件
2. 二、创建博客文件夹
1. 2.1. 1.初始化博客文件夹
3. 三、将hexo部署到github

想要一个博客吗？那我们开始吧！

参考文章：hexo史上最全搭建教程

一、前置条件

1.一个github账号

注册一个github账号非常简单，这里可参照https://cloud.tencent.com/developer/article/1487508

2.安装git

Git是目前世界上最先进的分布式版本控制系统，可以有效、高速的处理从很小到非常大的项目版本管理。也就是用来管理你的hexo博客文章，上传到GitHub的工具。

windows需要到官网 https://gitforwindows.org/ 下载

安装好后，可以在控制行命令（win+R输入cmd打开）中用一下代码查看版本，以检测是否安装成功。

1	git --version

若出现类似

1	git version 2.38.0.windows.1

则成功安装
有gitbash的话就可以用gitbash代替命令行了

3.安装nodejs和npm工具

Hexo是基于nodeJS编写的，所以自然要安装一下nodeJs和里面的npm工具。

windows下直接去官网 https://nodejs.org/en/download/ 上选择LTS版本下载就行了

安装完后打开命令行，依次输入

1 2	node -v npm -v

检查是否安装成功，若依次出现

1 2	v18.12.0 8.19.2

版本号则成功

4. 安装hexo

前面git和nodejs安装好后，就可以安装hexo了，你可以先创建一个文件夹blog，然后cd到这个文件夹下（或者在这个文件夹下直接右键git bash打开）。

输入命令

1	npm install -g hexo-cli

进行安装

用

hexo -v

查看版本确认是否成功安装

出现类似

INFO  Validating config
hexo: 5.4.2
hexo-cli: 4.3.0
os: win32 10.0.22621
node: 18.12.0
v8: 10.2.154.15-node.12
uv: 1.43.0
zlib: 1.2.11
brotli: 1.0.9
ares: 1.18.1
modules: 108
nghttp2: 1.47.0
napi: 8
llhttp: 6.0.10
openssl: 3.0.5+quic
cldr: 41.0
icu: 71.1
tz: 2022b
unicode: 14.0
ngtcp2: 0.8.1
nghttp3: 0.7.0

则成功

至此，所有工具安装完毕，开始你的博客搭建之旅吧

二、创建博客文件夹

1.初始化博客文件夹

在上一步建立的文件夹blog中右键打开gitbash(cd到文件夹下也行)，输入

1	hexo init myblog

其中myblog是博客文件夹的名字，你可以修改为任意你喜欢的名字，下面所有的myblog也同样修改

然后

1 2	cd myblog //进入这个myblog文件夹 npm install

建完后myblog文件夹下应有：
node_modules: 依赖包
public：存放生成的页面
scaffolds：生成文章的一些模板
source：用来存放你的文章
themes：主题
_config.yml: 博客的配置文件

此时打开hexo服务，浏览器输入localhost:4000应该就能看见你的博客了

1 2	hexo g hexo server

使用ctrl+c关闭服务

三、将hexo部署到github

1.建立一个github库

登录你的github账号，点击右上角头像后选择your repositories,再点右上角的New新建一个库

这个库请注意，它的名字（Repository name一栏中）必须是：
your_github_name.github.io
即:你的github用户名后加.github.io
例如：我的用户名是rippleQAQ，那这个仓库名就是rippleQAQ.github.io

然后点下方的create repository就行了

2.生成SSH添加到GitHub

进入gitbash
你可以使用

1 2	git config user.name git config user.email

查看你的用户名和注册邮箱

然后在gitbash中运行

1 2	git config --global user.name "yourname" git config --global user.email "youremail"

注意：这里的yourname与youremail请替换成上面你自已的用户名与邮箱

然后创建SSH

1	ssh-keygen -t rsa -C "youremail"

接着一直按回车就行了，同理youremail是你的邮箱
到最后会有一张奇怪的图片The key’s randomart image is:

这个时候它会告诉你已经生成了.ssh的文件夹。在你的电脑中找到这个文件夹(.ssh)。

ssh是一个秘钥，文件夹里的id_rsa私钥，不能给别人看，id_rsa.pub是公钥，可以给别人看。把这个公钥放在GitHub上，这样链接GitHub时，它会根据公钥匹配私钥，相互匹配时，才能够顺利的通过git上传文件到GitHub上。

在github中点击右上角头像，进入settings，在左侧找到SSH and GPG keys一栏进入，点击New SSH key按钮
title可以随便取，Key一栏中把id_rsa.pub的内容复制进去
win 11好像默认会用Microsoft Publisher打开，但Publisher打不开。
我们右键用记事本打开就行了。
将id_rsa.pub中所有内容复制粘贴到Key一栏中后点Add SSH Key就行了

在gitbash中，查看是否成功

1	ssh -T git@github.com

若出现就行了

1	Hi rippleQAQ! You've successfully authenticated, but GitHub does not provide shell access.

当然这里rippleQAQ换为你的用户名

3.进行hexo部署

离你的博客就差一步了，加油！

打开站点配置文件_config.yml，翻到最后，修改为

deploy:
  type: git
  repo: git@github.com:yourname/yourname.github.io.git
  branch: master

YourgithubName请改为你的用户名，如rippleQAQ/rippleQAQ.github.io.git

如果不行试试把.git删掉?两种好像都行

需要先安装deploy-git，才能用命令部署到GitHub

1	npm install hexo-deployer-git --save

完成后依次输入（注意要在myblog这个文件夹下）

1
2
3

hexo clean
hexo g
hexo d

hexo clean清除了你之前生成的东西
hexo generate （hexo g）生成静态文章
hexo deploy （hexo d）部署文章

注意deploy时可能要你输入username和password

如果最后出现INFO Deploy done: git
恭喜你！开始你的博客之旅吧！
你可以在 http://yourname.github.io 看见你的博客了！！

ripple