GitHub pages + Hexo 搭建个人博客

折腾自己的一个网站，既可以从中学到一些东西，也可以从中获得成就感，看到自己的成果展示在网页上，付出绝对值得；还有更重要的是更容易养成写博客的习惯，同时，写的时候会更加认真，这都算是自己建站的意外收获吧

现成的网站当然很是方便，但是一方面定制化程度低，另一方面，容易得到的东西就更加不会珍惜，写的博客可能不会用心。当然，这个还是主要看个人的。

• 本文博客地址

一、前言

介绍自己的环境，这个还是很重要的，计算机领域更新迭代飞速，可能一两年之后，有些方法就不适用了；在搭建本网站的时候，在网上看了很多方法，有些方法就已经失效了。

（一）本人使用过的平台

• CSDN：目前主流的中文博客平台，文章也比较容易被搜索到，但是广告太多，而且个人认为文章的质量良莠不齐；
• WordPress：使用过一段时间，但是维护的成本过大，包括时间成本和金钱成本；

（二）环境

Ubuntu 20.04
git version 2.25.1
node v14.6.0

二、准备工作

• 搭建网站需要 git 和 node，没有的需要安装一下，可以参考下面的文章，也可以自己找合适的方法：

  • Git：

    • Git 官网下载地址
    • 简单的使用方法， 推荐地址， 廖雪峰官网

  • Node：

    • Node 官网下载地址
    • Linux 环境可以使用下面的方法安装 Node，可以控制 Node 版本，修改 Node 更新源，地址

• 另外，需要注册 GitHub，如果没有的话，直接注册一个：GitHub 地址

三、搭建博客

1）本地博客

• 先在本地合适的位置创建一个文件夹，这个文件夹是本地博客的地址，存放本地博客，所以选好位置，后面尽量不要变动

2）安装并配置 Hexo

1. 安装：

   npm install hexo-cli -g
   npm install hexo-deployer-git --save
   

2. 进入刚才新建的文件夹，初始化 hexo

   hexo init
   

3. 查看本地博客效果

   hexo g
   hexo s 
   # 正常的话，就会显示：
   #  INFO Hexo is running at http://0.0.0.0:4000/. Press Ctrl+C to stop.
   

   • 网页效果

     

3）配置 GitHub

1. 创建 GitHub 仓库

   • 注意：创建项目的 Repository name 一定要是下面的格式：usrname.github.io

     

2. 配置 SSH 秘钥

   • 如果是 windows 系统，打开 Git bash；如果是 Linux 系统，直接使用终端

   • 输入命令： $ ssh-keygen -t rsa -C “your email@example.com” 【引号中的邮箱地址是注册 GitHub 的的预留邮箱地址】

   • 一直回车，直到成功生成秘钥；生成的秘钥的地址可以在刚才弹出的内容中找到，默认是 id_rsa.pub；

   • 打开 id_rsa.pub，将其中的内容全部复制，在 如下图的位置，添加 SSH 秘钥

     

   • 测试：主要测试本地是不是与 GitHub 上能不能通过 SSH 连接

     ssh -T git@github.com
     # 之后会有一个询问，输入 yes，会显示授权成功
     # Hi code-wd! You've successfully authenticated, but GitHub does not provide shell access.
     

4）修改 Hexo 配置文件

• 这一步的目的只要是建立 Hexo 与 GitHub 项目之间的联系

• 在本地博客文件夹中，可以找到 _config.yml文件，打开，翻到最后，配置 deploy 下的信息【注意：下面的配置信息中，所有的冒号后面都必须有一个空格，这个是语法的规定】

  • type: 固定是 git

  • repo: 如下图所示，直接复制即可

    

  • branch: 查看自己项目默认的分支，如上图中，左边中间，我的项目是 master，也有可能是 main；

5) 推送到远程仓库

# 执行下面的命令
npm install --save hexo-deployer-git
hexo g -d

• 之后就可以访问你的个人博客了，使用地址：https://你的用户名.github.io，其他人也可以通过这个访问你的博客【查看你的远程仓库，如果远程仓库已经多出来文件，但是网页还不能显示，就等一会】

• 以上就是搭建博客的过程，要想写博客，直接在 /source/_post 文件夹下新建 .md 文件即可，之后执行 hexo g -d 即可推送到远程仓库，这样稍微等一下就可以自己网站上看到了