自定义样式
主题所有颜色通过 CSS 变量(Custom Properties)定义在 source/css/_theme.styl 中,深色模式即通过切换这些变量实现。你可以通过覆盖这些变量来定制配色,无需修改主题源码,升级主题时自定义样式也不会丢失。
自定义布局模板
主题使用 Nunjucks(.njk)作为模板引擎。当配置项无法满足需求时,你可以通过覆盖模板文件来深度定制页面结构。Hexo 的模板查找机制允许你在博客根目录下放置同名文件来覆盖主题模板,升级主题时不会被覆盖。
注入自定义 Head 代码
很多第三方服务(站点验证、统计、广告、字体)要求在页面 ` 中插入 、 或 ` 标签。本主题支持在不修改模板的前提下注入自定义 Head 代码。
CDN 源配置
主题部分功能依赖第三方 JS 库(MathJax 数学公式渲染、Mermaid 图表、DocSearch 搜索),这些库通过 CDN 加载。你可以通过 cdn 配置项统一指定 CDN 源。
站点统计
主题内置百度统计与 Google Analytics 的接入配置,无需手动注入脚本。
评论系统
主题内置评论系统接入,支持 giscus / Waline / Disqus 三种方案。在 _config.tranquility.yml 的 comments 配置块中填写对应字段,主题会在文章页底部自动渲染评论组件,无需修改任何模板。
CI/CD 自动部署
本主题的「最近更新」卡片在构建时抓取外部博客 RSS,博客更新后需要重新 hexo generate 才会刷新。配合 CI/CD 可以实现推送代码或定时自动构建并部署,无需手动操作。