Hexo Butterfly 主题：我如何把博客主题安装变成一次内容站搭建训练
我最早折腾 Hexo 主题时，关注点很简单：把页面变好看。
下载主题、复制配置、启动预览，只要页面能显示，就觉得安装完成了。
后来我维护博客时间长了，才发现主题安装不是一次美化动作，而是一次内容站搭建训练。
它会逼我理解静态站点的结构：Hexo 负责生成内容，主题负责展示方式，配置文件负责把内容、页面、导航、评论、搜索和统计连接起来。
如果只是复制别人配置，短期能跑，长期会很难维护。
我会先理解三个层次
安装 Butterfly 之前，我会先把事情拆成三个层次。
第一层是 Hexo 本身。
它负责读取文章、生成页面、启动本地预览和构建静态文件。
第二层是主题包。
Butterfly 提供布局、样式、页面组件和很多可选能力。
第三层是配置。
真正决定站点长什么样、有哪些入口、开哪些功能的，是站点配置和主题配置。
这三个层次分清楚，后面排查问题会轻很多。
我的安装路线
我会先进入 Hexo 项目目录，再安装主题：
然后在 Hexo 站点配置里启用主题：
接着把主题默认配置复制成站点级配置，例如：
这样做的好处是，主题升级时可以尽量减少对主题源文件的直接修改。
我更愿意把自己的改动放在站点层，而不是直接改主题内部文件。
我会如何验证
安装后我不会急着继续加功能。
我会先跑一遍：
本地页面能打开以后，再看几件事：
- 首页是否正常渲染。
- 文章页是否正常显示。
- 分类、标签、归档是否可访问。
- 导航链接是否指向正确页面。
- 图片、代码块、标题层级是否正常。
主题配置的坑往往不是安装时报错，而是页面能打开，但某些入口、资源或插件在后面慢慢暴露问题。
我会怎样改配置
我不会一口气打开所有功能。
我的顺序是先让文章阅读体验稳定，再补导航、搜索、评论、统计、社交链接和其他增强功能。
每打开一个功能，我会本地预览一次。
如果出现问题，就知道问题大概率来自刚刚改的那一段配置。
这比一次性复制完整配置更容易排查。
我的边界
主题不是博客的核心资产。
博客真正重要的是内容结构、长期更新、搜索入口和读者能不能顺利读完文章。
所以我会把 Butterfly 当成一个成熟外观和交互基础，而不是把大量时间花在无限微调主题上。
我现在更关心的是：主题能不能稳定承载文章，能不能方便我持续写作，能不能在未来迁移或升级时不把自己锁死。
如果一个主题配置让我越来越不敢升级，它就开始偏离我的目标了。
安装主题这件事看起来很小，但它能训练一个重要习惯：任何工具都要分清源代码、配置和内容资产。
分清之后，博客才不是一次性搭建的页面，而是一个可以长期维护的内容系统。
Loading...
