用GithubPages和Hexo搭建一个个人博客!

可能有些小伙伴由于手头上没有money,也想要有属于自己的个人博客,这时候就可以用上GitHub Pages的托管功能了。使用GithubPages不需要域名,也不需要服务器,博客完完全全就是部署在GitHub的托管服务器上。(当然托管服务器死了你也死,用了的基本都死)

那么,今天我们就来通过GithubPages在GitHub.io上搭建属于自己的个人博客,最著名的静态博客系统就归Hexo莫属了。Hexo嘛,老熟人了,只不过配置起来有点麻烦。

介绍

当然你可能对GithubPages或者Hexo都不了解这些是什么玩意,甚至看之前都不知道这些是干什么的,在文章开始之前,就让我先来介绍一下它们。

GithubPages嘛,看名字,GitHub相比大家都认识,全球最大的的代码开源中心。而GitHub这些为开发者们没钱的人们专门提供了一个托管静态站点的服务,甚至写了网站模板,没错他就是GithubPages。

相对于需要自己买服务器或者去一些托管站点搭建WordPress等动态/静态博客系统往往需要自己处理一切事物,比如https、mysql配置、web服务器配置等繁琐的步骤,在GithubPages上仅需上传文件,修改几行代码即可完成,而且相对其它网站托管站点,自定义度更高更自由

而Hexo嘛,是一个基于Node.js的静态站点生成器,相对于Wordpress这些,他少了一些互动性功能,就比如评论和后台这些的。Hexo因为是静态生成器所以也同样支持万能的Markdown语法,简称MD,维基百科这些的文档全是使用Markdown语法编写出来的。

准备

既然是在GitHub上面的Pages功能搭建个人博客,那GitHub账户的注册必不可少。不然哪家会愿意不注册就给你使用呢……

首先!前往 github.com ,点击右上角的**“Sign up”按钮**

接着会被跳转到GitHub的注册页面,第一步在输入框内输入您的个人邮箱,就比如我就输入me@zhunote.cn为GitHub的注册邮箱,输入完之后点击输入框旁边的“Continue”以确认邮箱,等这个按钮变绿色了就代表这是个有效的邮箱地址。

填入邮箱

接着会让你输入Password,就是你的账户密码,输入完同上一步。

密码确认

接着会让你输入你Github的用户名,在后面的登录操作中,你可以使用邮箱或者用用户名的方式登录,如果你想用用户名登录的话,可以取好记的名字,就比如我就”MengXiCenter“。

用户名确认

接着就会出国内外平台都会耍阴招的地方,他问你是否接收Github的推广和公告邮件,这个随你选择,如果要接收就输入”y”,相反输”n”,同样点击”Continue”

接收推广邮件

如果你以上信息都填写正确了,你的邮箱会收到来自github的邮件,邮件中写明了验证码,然后填入输入框内,你这一步只用填写就行,Github会自动验证

输入验证码

来自github的验证码邮件

如果你看到**”Welcome to Github”的页面**,那就证明你的Github账号已经成功注册惹!那我们就可以进入下一步力。

环境

Hexo是一个静态网站生成器,市面上(包含Github、Gitee等开源平台)大部分,也可以说是所有静态网站生成器都基于Nodejs或Nextjs框架来编写的,Hexo也不例外,所以我们在Github Pages上托管自己的Hexo站点前,需要在本地环境上进行环境准备以及Hexo的配置。这一步我们先安装环境

Git

从本地计算机推送文件到你Github仓库的工具,大家第一时间就是想到的是Git,Git对于我们在Github Pages托管站点的帮助非常大,也有很多开发者也在用Git来Push最新文件到仓库,直接杜绝了Github网页端的”不能上传这么多的文件“的陋俗(没用错词吧?

对于多系统用户,Git为用户准备了Windows、macos和Linux的三个版本,对于Windows用户仅需动动手指运行exe可执行文件进行一路”Next、Finish”和一些选择即可

对于没有工具的用户,也可以去“腾讯软件管家”下载,与官方下载源对比速度更快且没有修改。

PS:由于电脑迁移的时候安装截图丢了,所以这一步安装图都不会展示,谢谢理解

Node.js

没想到吧?运行在服务器上的amd版本还有电脑版?同样Node.js也为用户提供了三平台版本,也提供给用户自行选择,还是比较良心的.jpg

Windows有zip版和msi版,像我这种懒人肯定也会选msi安装,也是一路点”Next和Finish”就安装完成了(原地起飞

验证环境

安装完成只有也要验证一下Git和Nodejs是否都安装完毕,你可以在**“搜索栏“中检索“cmd”也就是“命令提示符”**,回车打开,依次输入 node -v npm -vgit --version

如果输出是以下内容,那你的环境已经准备完全了,可以开始操作了,如果不是请检查步骤是否执行完成或者去网上寻找教程。

Hexo下载

如果上面步骤你都完成了,那么恭喜你,你已经完成了三分之一???

那么,我们就在一个硬盘里创建一个文件夹(建议创建以便分类),这个文件夹用来通过Nodejs内置npm模块来部署Hexo,后续我们再通过Git把文件Push到你的Pages仓库内。

就像我这样创建一个新文件夹来存放Hexo文件

接着我们在空文件夹里的任意一处单击鼠标右键在右键菜单中选择”Git Bush Here”

在右键菜单中选择”Git Bash Here”

接着Git会弹出一个类似cmd的窗口在这个窗口光标处键入 npm install -g hexo 然后回车确定

这个指令是不是很熟悉?通常在npm、yum等模块中,通常都是以 xxx install -x xxx (替换xxx)的方式来安装或者读取文件或命令。

在Git Bash中键入 npm install -g hexo

然后再在这个命令行中输入 hexo init回车确定,npm会在这个文件夹中下载Hexo源文件,也就是从Github中git下来源文件。

对于无法下载或者无法访问Github的解决办法,这里因法律原因无法提供方法

下载Hexo源文件

如果你下载了Hexo源文件(如上图所示),并且在文件夹里多出了一些文件和文件夹,那么你就下载好了Hexo的源文件了。

配置Hexo

在你的文件夹中,用VSCode、记事本等可以打开yaml文件的编辑器打开 _config 这个文件,并且按下图配置你的Hexo Config配置文件

按照图中的提示填写即可,语言默认en就行

以我的为例,那我这一段的yaml配置文件应该是这样的:

1
2
3
4
5
6
7
8
# Site
title: 哼哼啊啊啊の博客
subtitle: ''
description: ''
keywords:
author: YeShouxianbei
language: en
timezone: ''

因Hexo的开放性后面用户可以自行安装、配置并应用这些主题。

如果你配置好了你的Hexo博客,那你可以本地运行Hexo了,同样我们还在Git Bash Here的命令行内依次分别输入以下指令

1
2
hexo g
hexo s

那么这时候(对于Windows用户)用户管理器会弹出防火墙弹窗提示Nodejs的网络需要授权,这里全都勾选上,然后“允许”,这时候如果Hexo没有报错显示 INFO Hexo is running at http://localhost:4000 . Press Ctrl+C to stop. 那么你的Hexo就成功的在你的本地计算机上运行了。

那么接下来就进入你的浏览器,在搜索框内输入 localhost:4000 回车就可以看到你的本地Hexo博客了~

撰写文章

你的Hexo博客搭建好了,那就可以在本地开始撰写你的第一篇Hexo文章了,在Hexo安装目录中,你会看到一些文件夹,我们在 /source/_posts 文件夹内新建 “文章名称.md” 的文件,通过编辑器打开进行编辑撰写你的文章即可。

Hexo文章使用Markdown语法,自豪地使用Markdown

就比如我的个人介绍文章,应该要这么写:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Home

<p>
<a href="https://mengxiblog.top" target="_blank">
<img alt="Blog" src="https://img.shields.io/badge/Blog-mengxiblog.top-%231D7EA7.svg?logo=wordpress&logoColor=white" />
</a>
<a href="https://github.com/MengXi2021" target="_blank">
<img alt="Github" src="https://img.shields.io/badge/GitHub-MengXi2021-%2312100E.svg?logo=Github&logoColor=white" />
</a>
</p>

- ? Hi, I’m [@MengXi2021](https://mengxiblog.top)
- ? I’m interested in React
- ? I’m currently learning C++ / Python /
- ?️ I’m looking to collaborate on [React](https://github.com/facebook/react)
/ [WordPress](https://github.com/WordPress/WordPress/)


## Info

- ?I was born on December 19, 2010, in Hangzhou.
- I live in Shangcheng District, Hangzhou, People's Republic of China.
- I am a junior high school student in Dinghui Experimental Primary School Affiliated to Zhejiang Normal University.
- I love computer science and have been studying for almost 7 years.

? **Welcome to my blog: <https://mengxiblog.top>**

部署到Github Pages

撰写好文章,就可以向你的Github仓库推送第一版Hexo博客了!首先我们前往github.com去登录我们前面注册的账号,登录过程中Github可能会要求你获取邮箱的验证码。登录完之后应该会显示这样的页面:

Github头像默认使用注册邮箱的Gravatar

我们首先要为Github Pages创建一个独立仓库,那么我们点击左上角绿底白字的 “Create repository” ,也就是“创建新的存储库”的意思,之后我们会在 “Create a new repository” 的页面里进行创建操作

注意,创建新的仓库名称必须为 用户名.github.io ,用户名必须完全一样,就像我这样:

然后我们再点击页面底部的 “Create repository确认新建仓库

我们再记住我们的仓库网址

Github仓库网址

接着我们再打开Hexo的配置文件——_config.yaml

Deployment 字段补充以下信息:

1
2
3
4
5
# Deployment
## Docs: https://hexo.io/docs/one-command-deployment
deploy:
type: git
repo: 你的Github仓库地址+.git

接着我们再以同样的方式打开 “Git Bash Here” 在根目录输入 npm install hexo-deployer-git  --save 来安装Hexo的官方Git到Github仓库的工具,安装好了之后就可以开始Push了,在Git Bash的命令行内输入 hexo clean && hexo g && hexo d

注意第一次Push需要进行Github账号登录操作

登录至Gitbash

登录不久之后你的代码就会Push到你的Github Pages仓库去了,返回以下信息就表示已经Push完成了

1
2
MengXiCenter/MengXiCenter.github.io.git'.
INFO Deploy done: git

那么我们再去GithubPages仓库看看,就可以看到Push上去的代码了,如图所示

Push后的仓库

最后

恭喜,经过1.14514191980小时的辛勤劳动,你托管在GithubPages上的博客就光荣诞生了!

那么现在就去你的 用户名.github.io 看一看吧~

如果不知道怎么进的话,可以以我的 MengXiCenter.github.io 为辅,去试试打开自己的GithubPages站点吧~

如果你觉得这篇文章写得不错可否留个评论或者赞助一下呢?(当然交换友链也不是不可以


用GithubPages和Hexo搭建一个个人博客!
https://www.mengxiblog.top/2022/06/13/install-hexo/
作者
ZhuHongrui
发布于
2022年6月13日
许可协议