Custom Styles
All theme colors are defined as CSS Custom Properties in source/css/_theme.styl. Dark mode works by toggling these variables. You can override them to customize the color scheme without touching the theme source — your customizations survive theme upgrades.
Custom Layout Templates
The theme uses Nunjucks (.njk) as its template engine. When config options aren't enough, you can override template files for deep customization. Hexo's template lookup lets you place files in your blog root to override theme templates — they survive theme upgrades.
Inject Custom Head Code
Many third-party services (site verification, analytics, ads, fonts) require `, , or tags in the page `. The theme supports injecting custom head code without modifying templates.
CDN Configuration
Some theme features rely on third-party JS libraries (MathJax for math rendering, Mermaid for diagrams, DocSearch for search) loaded via CDN. Use the cdn config to specify the CDN source.
Analytics
The theme has built-in config for Baidu Analytics and Google Analytics — no manual script injection needed.
Comments
The theme has built-in comment system integration supporting giscus / Waline / Disqus. Fill in the corresponding fields in the comments block of _config.tranquility.yml and the theme auto-renders the comment component at the bottom of post pages — no template modifications needed.
CI/CD Auto-Deployment
The theme's "Recent Updates" cards fetch external blog RSS at build time — after your blog updates, you need to re-run hexo generate to refresh them. CI/CD automates building and deploying on push or on a schedule, with no manual steps.