Hexo + Kratos-Rebirth 主题搭建心得 & 我的第一篇博客

  • 1383 字

大家好!这是我用 Hexo 框架搭配 Kratos-Rebirth 主题搭建的个人博客的第一篇文章。

经过两三天的折腾,终于把博客基本弄好了。Hexo 是一个非常优秀的静态博客框架,速度快、配置简单,而且有丰富的主题和插件生态。Kratos-Rebirth 则是一个简洁美观、功能完善的主题,非常适合技术博客使用。

我的搭建心得

在搭建过程中踩了不少坑,这里分享几个新手容易犯的错误,希望能帮到后来的人:

不要直接修改 public 文件夹

刚开始我以为修改 public 文件夹里的 HTML、CSS 文件就能直接改变网站样式,结果每次执行 hexo g 之后,所有修改都被覆盖了,白忙活了好几个小时。

正确做法:所有样式和布局的修改都应该在 source 目录或者主题目录下进行,修改后重新编译生成即可。

主题配置的正确姿势

Kratos-Rebirth 主题支持配置覆盖,个人感觉不应该直接修改主题目录下的 _config.yml 文件

个人做法:在博客根目录创建一个 _config.back.yml 文件,存储原来默认配置信息,然后修改_config.yml文件,把你需要修改的配置项写在这里。这样主题更新时,不会因为刚开始了解配置信息,修改报错导致无法找回原来信息。(默认配置信息给的都挺详细的,建议保留以备不时之需)。

🛠️ 简化开发流程

每次修改主题源码后,都需要执行以下命令才能看到效果:

1
2
3
4
5
6
7
# 在主题目录下编译源码
cd themes/Kratos-Rebirth
npm run build

# 回到博客根目录重新生成并预览
cd ../..
hexo clean && hexo g && hexo s

为了简化操作,我在博客根目录写了一个 run.bat 脚本,一键执行所有命令:

1
2
3
4
5
6
7
@echo off
cd themes/Kratos-Rebirth
call npm run build
cd ../..
call hexo clean
call hexo g
call hexo s

Hexo 常用命令

最后附上 Hexo 的几个常用命令,方便自己以后查阅:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
### 创建新文章
$ hexo new "文章标题"

### 清除之前构建的静态文件
$ hexo clean

### 生成静态文件
$ hexo generate

### 本地预览
$ hexo server

### 部署到远程
$ hexo deploy

博客未来规划

这个博客主要用来记录我的学习历程和技术成长,未来会更新以下内容:

  • 技术文档和教程
  • 学习笔记和心得
  • 项目实战经验
  • 个人生活感悟

希望能通过写博客的方式,把自己学到的知识整理沉淀下来,同时也能帮助到有需要的人。


Hexo官方文档:Hexo官方文档

再次感谢 Hexo 和 Kratos-Rebirth 提供这么优秀的工具和主题。再次附上github地址 Hexo : https://github.com/hexojs/hexoKratos-Rebirth : https://github.com/Candinya/Kratos-Rebirth

第一篇博客就写到这里啦!接下来我会慢慢完善博客的功能和内容,敬请期待!

💖 感谢支持,点击查看收款码
你的鼓励是我持续更新的动力!