Hexo 个人博客配置记录(GitHub Pages + Butterfly 主题 + Waline 评论 + 自动部署)

Hexo 个人博客配置记录(GitHub Pages + Butterfly 主题 + Waline 评论 + 自动部署)


备份备份,收藏栏都块满了,减轻减轻收藏夹压力

原博客链接:https://gannia.top/tokepson.github.io/

由于原先的网页是纯静态的,且写起来很麻烦

因此转移到了Hexo平台

https://gannia.top/

个人博客展示:欢迎各位访问以及友联 (写博文好麻烦不想写了...)


需要注意的是,本博客是部署在github上的因此访问可能有异常(虽然有阿里云服务器可以Nginx "转发"但暂时懒得搞),同时评论服务国内用户也无法直接使用(要不还是搭个吧...好麻烦)

一、项目初始化流程

1. 安装 Hexo(首次)
bash 复制代码
npm install -g hexo-cli
2. 创建博客项目目录
bash 复制代码
hexo init hexo-blog
cd hexo-blog
npm install
3. 本地运行预览
bash 复制代码
hexo s

浏览器打开:http://localhost:4000


二、配置主题(Butterfly)

1. 下载 Butterfly
bash 复制代码
git clone -b master https://github.com/jerryc127/hexo-theme-butterfly.git themes/butterfly
2. 修改配置文件 _config.yml
yml 复制代码
theme: butterfly
3. 安装依赖插件(如有)
bash 复制代码
npm install hexo-generator-searchdb --save

三、配置 Git 部署

1. _config.yml 中增加部署设置
yml 复制代码
deploy:
  type: git
  repo: https://github.com/你的用户名/你的仓库.git
  branch: main
2. 安装部署插件
bash 复制代码
npm install hexo-deployer-git --save

四、文章写作与发布

1. 创建文章
bash 复制代码
hexo new post "文章标题"
  • 创建文件夹
bash 复制代码
hexo new post 文件夹名称

然后编辑 source/_posts/文章标题.md 文件。

博文内容以md格式写在文件内部

2. 设置分类与标签
md 复制代码
---
title: 我的文章
date: 2025-06-17 00:00:00
categories:
  - 技术
  - Hexo
 tags:
  - Butterfly 主题
  - Hexo
---
3. 生成并部署
bash 复制代码
hexo clean
hexo g -d

五、评论系统配置(Waline)

1. 部署 Waline 服务(使用 Vercel)

注 同时还需要去leancloud注册账号并获取Api值(建议国际版,国内版还需要申请域名)

详细可以看这里 Waline, LearnCloud配置教程, Vercel

  • 设置环境变量(如 LEAN\_ID, LEAN\_KEY,LEAN\_KEY 等) 这边需要注意下 必须要设置
2. 修改 Butterfly 主题配置 _config.butterfly.yml
yml 复制代码
comment:
  type: Waline
  serverURL: https://你的-waline.vercel.app
  pageview: true

配置教程链接:
Hexo博客搭建基础教程(三)

Butterfly主题的基础配置

3. 若报错 Not initialized 或 404
  • 确保你设置好 LeanCloud 的应用
  • Waline 后台功能需要 admin 密钥或配置 LC 应用权限

六、自动部署(可选)

1. 使用 GitHub Actions 自动部署 Hexo 到 GitHub Pages

七、可视化管理(可选)

1. 使用 hexo-admin
bash 复制代码
npm install hexo-admin --save

运行:

bash 复制代码
hexo s

然后打开 http://localhost:4000/admin 使用后台管理界面。


八、常用命令小结

命令 功能
hexo new post "标题" 新建文章
hexo new post 文件名 新建文件夹
hexo g 生成静态文件
hexo s 本地启动服务预览
hexo d 部署到远程仓库
hexo g -d 好像也是部署到远程仓库(我用的)
hexo clean 清除缓存和旧文件

九、参考配置工具

  • 本地写作:VSCode + Markdown 插件
  • 实时预览:hexo s
  • 自动化:GitHub Actions
  • 评论:Waline
  • 搜索:hexo-generator-searchdb
  • 主题优化:Butterfly + 自定义配置

如需进一步可视化创作、Web 后台文章管理,可结合 Netlify CMS 或搭建更完整的 CMS 前端。

献丑了:

相关推荐
Albert_Lsk5 小时前
【2025/07/10】GitHub 今日热门项目
人工智能·开源·github·开源协议
一块plus6 小时前
一门原本只是“试试水”的课程,没想到炸出了一群真诚的开发者
javascript·面试·github
GoGeekBaird10 小时前
使用GoHumanLoop拓展AI Agent人机协同边界,这次连接到飞书
人工智能·后端·github
Stuomasi_xiaoxin11 小时前
服务器重装后如何“复活”旧硬盘上的 Anaconda 环境?—— 一次完整的排错与恢复记录
开发语言·python·github
寻月隐君11 小时前
Rust核心利器:枚举(Enum)与模式匹配(Match),告别空指针,写出优雅健壮的代码
后端·rust·github
呼啸长风11 小时前
FastKV的轻量化回归
android·开源·github
qianmoQ12 小时前
GitHub 趋势日报 (2025年07月08日)
github
小和尚同志1 天前
全网影视一网打尽!8.2K Star 的 LibreTV 让你甩开追剧烦恼
开源·github
ai小鬼头1 天前
AIStarter 3.2.0更新!一键离线导入+高速下载,熊哥教你轻松玩转AI工具
人工智能·程序员·github
y东施效颦1 天前
uni-app uni-push 2.0推送图标不展示问题
uni-app·github