Hexo+GithubPages 免费搭建个人博客网站

Hexo+GithubPages 免费搭建个人博客网站

目录

一、前言

我之前开了好几年的云服务器了，实际上使用场景并不是很多，感觉有点浪费。前两个月都给关掉了，现在呢琢磨着弄一个免费的云服务搭建个人博客。暂时先弄 Github 的，Gitee 的那个要身份证，暂时弄不了，等等吧。

需要准备的环境：

windows 的话需要准备 node 环境，可以关注某绿色软件回复：1009 不限速下载软件安装

这里列一下清单

  1. node 环境
  2. 能访问 github 并准备好 github 账号

二、Github 配置

新建同名仓库

这里需要注意的有两点

  1. 仓库名格式： username.github.io
  2. 仓库需要设置 public，不能设置为 private

配置 Pages

在仓库主页点击 Setting

这里的配置按照以下方式配置即可

OK，那么这里需要配置的完成了。

三、安装 Hexo

这里需要注意的是，需要先确认安装好了 node 环境，并配置了环境变量，可以通过 cmd 输入 npm -v 命令确认

halo 官网地址：https://hexo.io/zh-cn/

安装很简单，直接在 cmd 中输入 npm install hexo-cli -g 即可

此时，需要在本地建立一个仓库，这个仓库中的文件将来会同步到 github 上。

建立方式是在 cmd 中输入 hexo init ，需要说明的是，需要在指定目录执行该命令，我这里推荐一个简单的方式。

  1. 进入需要初始化仓库的文件夹下
  2. 左上角输入 cmd
  3. 回车

这样打开的 cmd 窗口自动进入到当前目录了

这样就算是创建好了，可以看到生成了一堆文件

四、配置 hexo-deployer-git

官方地址：https://github.com/hexojs/hexo-deployer-git

安装也很简单，直接在 cmd 中输入 npm install hexo-deployer-git --save

需要注意的是，执行该命令，需要在上面 hexo 初始化的仓库目录下执行，否则是没有用的。

执行完效果如上图

我们需要关注的是生成的_config.yml 文件，这里我们打开这个文件，并对部分配置做修改。

  1. 修改 url

  2. 修改 deploy

  3. 这个配置可改可不改

修改完毕保存后，我们在 cmd 中执行命令 helo d 即可部署我们的项目，稍等几分钟，就能访问到了。

正常到这边就结束了，但是后续多上传几次后就会报错

这个原因可能是被限制了，我们需要配置 token

打开 github 的 settings

权限勾选第一个就行了

接下来我们需要在_config.yml 中加上 token

五、访问

我的路由是：https://zysicyj.github.io/

六、发布文章

官方文档：https://hexo.io/zh-cn/docs/commands

执行hexo -new 可以创建文件

执行上传命令 helo g && hexo d ，然后等几分钟，能看到文件已经同步上去了

七、安装主题

我是用的主题是 bufferfly https://butterfly.js.org/posts/21cfbf15/# 安裝

仓库根目录下拉取代码

修改_config.yml

安装插件

重新生成部署 hexo -g && hexo d

后续的话还有不少可以优化的地方，比如 hexo 主题，分类和标签问题，图片显示问题等等，这个后续再写文章吧
个后续再写文章吧