Hexo+ButterFly+Gitee搭建个人博客

简介

  • 本博客搭建于Ubuntu Server 20.04 LTS 64bit操作系统, 并且操作的是root用户, 如果非root用户, 需要在一些命令前添加sudo关键词
  • 之所以在Gitee上部署主要是因为GitHub太慢了, 也在GitLab上部署过, 但是缺点就是现在使用它提供的CI/CD流水线需要信用卡来进行身份验证, 并且部署出的网站别人要访问还得先登录GitLab账号, 最后不得以只能在 Gitee 上部署了
  • 另我意外的是Gitee上部署非常容易, 且部署的网站访问速度也很快, 推荐使用这种方式部署

Hexo框架安装

安装前的准备

  • 安装 Git

    sudo apt-get update -y
    sudo apt-get install git
  • 安装 NodeJs 和包管理工具 NPM

    sudo apt-get install nodejs
    sudo apt-get install npm

    注意: nodejs 若版本过低会导致 hexo 安装出错, 因此需要下载高版本的 nodejs

例如: ubuntu 18.04 安装的 nodejs 是 8.x 版本的, 这会影响到 hexo 包的安装, 可以采用以下方法安装较新版本的 nodejs

sudo apt-get install curl
curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -
sudo apt-get install -y nodejs

安装 Hexo

准备工作完成后, 即可用npm来安装 Hexo

npm install -g hexo-cli

安装完成后可以用 hexo -v 命令来查看 hexo 包的版本

接下来创建博客项目文件夹 blog , 我的绝对路径是 /root/blog , 在 root 目录下初始化 blog 文件夹

hexo init blog

执行完命令后, Hexo 将会在指定文件夹中新建所需要的文件. 接下来我们进入 blog 文件夹中执行命令

cd blog
npm install

对于自动生成的文件的介绍, 可以查看官方文档的介绍

测试 Hexo

至此我们已经完成了基本的 Hexo 安装, 可以通过以下命令在本地生成默认的 Hexo 博客, 不过在这之前我们还需要更改一下 /root/blog/_config.yml 文件, 因为版本的问题, 可能导致 hexo g 命令出错

:' 假设当前所在目录为 /root/blog '
vim _config.yml

:' 按 i 进入编辑模式, 找到下图灰色区域的 true
   把它改为 false, 然后按下 Esc 退出编辑模式
   最后按 :wq 保存并退出即可 '

_config.yml文件

然后可以执行以下命令生成并在服务器本地运行默认博客了

hexo g # or hexo generate 
hexo s # or hexo server 

默认运行的地址为 http://localhost:4000 , 如果要在远端查看的话, 就将 localhost 换成你服务器的公网 IP 地址 (注意:需要开放 4000 端口, 可以在防火墙处设置)

可以看到效果如下图所示:
hexo效果图

更换主题为 ButterFly

下载主题 ButterFly

  • git 方式
:' 在 /root/blog下执行克隆命令, 将包下载到 /root/blog/themes 目录下 '
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
  • npm 方式 (hexo 5.0.0 以后版本支持)
:' 默认将 hexo-theme-butterfly 文件放到了 /root/blog/node_modules 下 '
npm -i hexo-theme-butterfly

mv ./node_modules/hexo-theme-butterfly/ ./themes/butterfly

更改博客配置文件

  • 更改 /root/blog 下的配置文件 _config.yml
:' 将文件中的 theme: landscape 改为 butterfly
   注意有空格 '
theme: butterfly 
  • 如果你沒有 pug 以及 stylus 的渲染器,請下載安裝:
npm install hexo-renderer-pug hexo-renderer-stylus --save
  • 最后依次执行以下命令测试即可
:' 注意以下命令需要要 /root/blog 下执行 '
hexo clean
hexo g
hexo s

个性配置

  • butterfly 主题的个性设置可以查看作者的使用教程

添加 Live2D 桌宠 (可选)

  • 具体配置请看这位博主的博客

Gitee 远程部署

  • 在码云上部署主要使用 Gitee Pages (需要先进行身份验证), 注意博客项目的名称 必须和你的用户名一致 , 具体操作可以看这篇博客