起因:比较无聊,习惯了使用typecho、wordpress的这种简单博客程序,想试试有点难度的好玩的hexo博客,并且打算借此几乎了解一下get

一、安装Git和Node

本次教程环境为Windows

安装Git:

前往:Git 官网: https://git-scm.com/ 下载对应版本的安装包(若网络问题导致下载速度慢可选择代下服务)
安装过程一直点击下一步即可,安装进度条跑完后回到桌面,鼠标右键如果有显示这两个git,代表安装成功。
Pasted image 20230402231622.png

安装Node:

前往:Node.js官网:https://nodejs.org/zh-cn/ 下载对应版本的安装包(若网络问题导致下载速度慢可选择代下服务)
安装过程一直点击下一步即可,安装完成后按住WIn+R键,输入:node -v 出现版本号代表安装成功。
Pasted image 20230402232823.png

二、安装Hexo:

Hexo官网:https://hexo.io/zh-cn/index.html

创建文件夹:

安装Hexo之前,现在本地创建一个用于存放hexo文件的文件夹

拉取hexo代码:

在创建的文件夹内右键,点击Git Bash Here会弹出一个对话框,对话框的内容是当前文件的路径地址
Pasted image 20230402233926.png

在hexo的官网下方,复制安装命令逐条执行,代码如下:

1
2
3
4
5
npm install hexo-cli -g
hexo init blog
cd blog
npm install
hexo server

第一行安装过程中非魔法网络可能需要等待一会或者换源
第二行代码运行完毕之后,返回文件夹内可以看到出现一个新的blog文件夹
第三行代码是进入这个新的文件夹内
之后运行第四行代码
最后一行可以改成hexo s直接运行
之后就会返回一个blog地址:
Pasted image 20230403002330.png
http://localhost:4000/这个就是我们本地的blog地址了,复制到浏览器即可打开
Pasted image 20230403002424.png
如果显示这个界面,那么hexo就已经安装成功了!

三、编辑blog文章

创建第一篇文章

进入blog文件夹内,右键选择Git Bash Here,在弹出的对话框内输入hexo new "第一篇文章"即可创建第一篇文章
Pasted image 20230403003005.png
blog文件夹内,选择source进入_posts文件内,就可以看到我们刚刚创建的第一篇文章本地位置
路径:blog\source\_posts

右击第一篇文章,进入编辑, hexo使用的是markdown语法,简单学习易用,先随意编写几个东西跑一下看看。

生成并运行

运行hexo g生成页面,运行hexo s运行博客
Pasted image 20230403005552.png
已经显示了刚刚创建的第一篇博文:
Pasted image 20230403002424.png
目前,hexo博客已经部署完成,只不过只能放在本地自己浏览使用。

四、更改博客样式:

进入hexo主题:https://hexo.io/themes/
选择一款喜欢的主题并安装,这里以Ayer主题做介绍,地址:https://shen-yu.gitee.io/
每个主题基本都有相关的安装教程,可能略有差异。

更换Ayer主题

下载主题:

安装命令:
git clone https://gitee.com/mirrors/ayer.git themes/ayer
进入blog根目录(打开blog文件夹)右键Git Bash Here,将上行代码复制进去回车运行
Pasted image 20230403011616.png
安装完成后可以在blog\themes目录内看到主题文件了。

更换主题:

进入blog文件夹,选择_config文件打开,下滑到最底部,theme后面改成切换的主题名称:
Pasted image 20230403012135.png

hexo g生成网页,hexo s运行博客:
如下图显示,就是更换主题成功了!如果在运行的时候有端口占用报错,关闭之前的git对话框即可。
Pasted image 20230403012558.png

五、修改主题配置

https://shen-yu.gitee.io/2019/ayer/
这里的Ayer主题相关的修改教程就在上方连接内,值得注意的是blog配置文件和主题配置文件不能搞混了,在修改主题配置文件之前建议先备份一次副本,以免修改之后出现错误找不出来。
修改的过程就是对照对照代码改改,目前这一步先跳过

本次使用了 AnZhiYu主题,官方教程:
0:https://anzhiy.cn/posts/61e4.html
1:https://anzhiy.cn/posts/220c.html
2:https://anzhiy.cn/posts/ce04.html
具体安装教程将不再此赘述。

六、 部署到 Github Pages

到目前为止,我们的本地博客就成功搭建了,但是现在我们只能通过本地连接查看博客,我们要做的是让其他人也能够访问我们的博客,这就需要我们将博客部署到 Github Pages 上

登录/注册github

注册或登录 Github 账户:点击此处访问 Github 官网,点击 注册或登录

创建仓库

创建项目代码库:点击 New repository 开始创建,步骤及注意事项见图(选择第一个):

Pasted image 20230405015925.png

创建仓库:
Pasted image 20230405020114.png

仓库名称填:你的用户名.github.io
勾选Public,公开仓库别人才能看见你的博客
勾选Add a README file,创建自述文件

配置SSH密钥

配置 SSH 密钥:只有配置好 SSH 密钥后,我们才可以通过 git 操作实现本地代码库与 Github 代码库同步,在你第一次新建的文件夹里面(如:我的文件夹为:F\QiQi_Blog) Git Bash Here 输入以下命令

1
2
ssh-keygen -t rsa -C "your email@example.com"
//引号里面填写你的邮箱地址,比如我的是2268025923@qq.com

之后会出现:

1
2
3
Generating public/private rsa key pair.
Enter file in which to save the key (/c/Users/you/.ssh/id_rsa):
//到这里可以直接回车将密钥按默认文件进行存储

然后会出现:

1
2
3
Enter passphrase (empty for no passphrase):
//这里是要你输入密码,其实不需要输什么密码,直接回车就行
Enter same passphrase again:

接下来屏幕会显示:

1
2
3
4
5
6
Your identification has been saved in /c/Users/you/.ssh/id_rsa.
Your public key has been saved in /c/Users/you/.ssh/id_rsa.pub.
The key fingerprint is:
这里是各种字母数字组成的字符串,结尾是你的邮箱
The key's randomart image is:
这里也是各种字母数字符号组成的字符串

运行以下命令,将公钥的内容复制到系统粘贴板上:

1
clip < ~/.ssh/id_rsa.pub

在 GitHub 账户中添加你的公钥

登陆 GitHub,进入 Settings
Pasted image 20230405020951.png
点击 SSH and GPG Keys
Pasted image 20230405021239.png

如图操作,填写完之后点击Add SSH key:
Pasted image 20230405021402.png

测试连接

直接在桌面右键 点击 Git Bash Here,输入以下命令输入以下命令:注意:git@github.com不要做任何更改!

1
ssh -T git@github.com

之后显示:
Pasted image 20230405021648.png
输入 yes 后会显示:
Pasted image 20230405021724.png
此时表示设置正确,测试成功。

配置 Git 个人信息

Git 会根据用户的名字和邮箱来记录提交,GitHub 也是用这些信息来做权限的处理,输入以下命令进行个人信息的设置,把名称和邮箱替换成你自己的,名字可以不是 GitHub 的昵称,但为了方便记忆,建议与 GitHub 一致

1
2
git config --global user.name "此处填你的用户名"
git config --global user.email "此处填你的邮箱"

到此为止 SSH Key 配置成功,本机已成功连接到 Github

接下来将本地的Hexo文件更新到Github的库中

复制SSH

登录 Github 打开刚刚创建的项目

鼠标移到 Code 按钮,点击按钮复制,或者直接把 SSH 全部复制
Pasted image 20230405022251.png

修改文件

打开本地 Hexo 文件夹,右键用记事本(或者 Notepad++、Vs Code 等)打开该文件夹下的 _config.yml 文件

滑到最下面,按下图修改 _config.yml 文件并保存
Pasted image 20230405022441.png

按照图片里面内容修改自己文件,106填写在Github辅助的ssh,107行看一下自己创建仓库的分支,大部分是main 。

上传文件

在 Hexo 文件夹下分别执行以下命令:

1
2
hexo g
hexo d

执行完之后会让你输入你的 Github 的账号和密码,如果此时报以下错误,说明你的 deployer 没有安装成功

1
ERROR Deployer not found: git

需要执行以下命令再安装一次:

1
npm install hexo-deployer-git --save

安装后执行:

1
hexo g -d

之后博客就会部署到 Github 上了

到这里本地文件就上传到GitHub托管了,通过刚才创建仓库的名称访问:你的用户名.github.io 就可以访问你的线上博客了。
后续博客新增内容,在本地编写,通过下方代码就可以将最新文件同步到github。

1
hexo g -d

本篇文章到此已经结束:
参考了以下相关内容: