前言

记录基于Hexo使用Butterfly主题搭建个人博客记录


博客记录

博客搭建

主题使用的是Butterfly 版本:4.3.1

hexo版本:6.2.0

NodeJs版本:16.16.0

静态资源挂在GitHub上,通过自己购买的域名访问。

环境准备

1、安装NodeJs

因为 Hexo 是基于 NodeJs 的,所以需要安装 NodeJs

NodeJs官网 下载长期支持版,然后打开安装程序,安装选项全部默认。

安装好了后在cmd输入 node -v ,如果显示的是版本号就是安装成功了。

2、安装Git

Git官网 下载,全装选项全部默认。

安装好了后在cmd输入 git --version ,如果显示的是版本号就是安装成功了。

3、创建或登录GitHub账号

因为我们需要把Hexo站点托管到GitHub上,所以我们需要一个GitHub账号。

打开GitHub官网,正常注册登录,流程略过。

安装Hexo

首先新建一个存放Hexo博客的空文件夹。

在新建的文件夹下打开cmd,输入 npm install hexo-cli -g 安装Hexo。

更换npm镜像源:

// 全局设置taobao镜像源
npm config set registry http://registry.npmmirror.org
// 全局设置npm官方镜像源(默认)
npm config set registry http://www.npmjs.org

hexo指令:

// 安装hexo
npm install hexo-cli -g
// 检查hexo版本
hexo -v
// 初始化文件夹
hexo init blog
// 安装npm
npm install
// 生成静态网页
hexo g
// 运行本地服务
hexo s
// 发布
hexo d

上传到GitHub

首先需要先新建一个仓库,名字推荐 username.github.io ,选择public公开储存库。

然后需要将Hexo博客连接到GitHub上,

在任意未知右键点击 git bash

git config --global user.name "GitHub账号的名字"
git config --global user.email "GitHub账号的邮箱"
// 生成SSH Key
ssh-keygen -t rsa -C "GitHub账号的邮箱"
// 输出SSH Key
cat ~/.ssh/id_rsa.pub

将输出的SSH Key全部复制,点击GitHub右上角头像,点击Settings

点击SSH and GPG keys

点击New SSH key,起个名字再把刚刚复制的SSH Key粘贴到下面,点击添加。

打开博客根文件下的 _config.yml 文件,修改这一行:

deploy:
type: git
repository: //储存库的链接
branch: master

保存好了后在cmd上输入npm install hexo-deployer-git --save安装GitHub推送插件,之后就hexo g生成静态网页再输入hexo d上传到GitHub就可以了。

上传完成后打开GitHub存储库,在Settings里找到Pages,将Branch下的分支设置成我们之前保存的分支(master)

之后在打开Pages里的地址查看页面是否生成就好了。

如果需要将博客挂在自己的域名下,在博客根目录 -> source 文件下,新建一个文件名为 CNAME 的文件(没有后缀名),打开文件后直接输入域名保存就好了。


博客主题设置

使用的主题为 Butterfly

在博客的根目录打开cmd输入npm i hexo-theme-butterfly,之后进入 博客根目录 -> themes -> Butterfly ,将目录下的 _config.yml 文件复制到博客的根目录下并重命名为 _config.Butterfly.yml,之后再进行主题的配置直接在这个配置文件里面改就可以了。

打开根目录下的 _config.yml 找到 theme 修改主题为 Butterfly

# Extensions
## Plugins: https://hexo.io/plugins/
## Themes: https://hexo.io/themes/
theme: Butterfly