Demius 主题功能文档索引

2026/9/13大约 9 分钟

Demius 主题功能文档索引

欢迎使用 Demius 主题！本文档提供了所有功能的详细使用指南。

📚 文档目录

🛠️ 开发与维护

开发维护总览
- 仓库分层与目录职责
- Hugo 渲染链路
- 页面、数据、资源的对应关系
- 主题层与站点层的覆盖规则
- 新增功能时的开发约定
- 长期维护的风险点与重构方向

0.1 配置参考总表

hugo.toml 核心参数索引
首页、侧栏、文章页、页面型功能的配置入口
评论、统计、背景、音乐等模块的关键参数
重复配置模式与后续拆分建议

🎨 内容展示功能

主页大图功能
- Mode1 中间栏大图模式
- Mode2 全屏大图模式
- 打字机效果支持
- 平滑滚动动画
轮播图功能
- 支持文章和图片两种类型
- 水平/垂直双向滚动
- 自动播放和手动控制
- 页面显示控制
文章置顶功能 ⭐ v2.1.1更新
- 简单配置即可置顶文章
- 视觉突出显示
- 支持所有布局引擎
- 多篇置顶管理
- 🎨 可自定义徽章颜色（配置指南）
视频嵌入功能
- 支持B站、抖音、YouTube
- 支持HTML5本地视频
- 响应式播放器
- 懒加载优化
选项卡切换功能
- 多选项卡内容组织
- 平滑切换动画
- 支持Markdown语法
- 响应式布局
相册功能
- 分组相册管理
- 封面列表展示
- 点击查看详情
- Lightbox大图预览
- 精选相册置顶
内容折叠功能
- 折叠任何内容类型
- 三种图标样式
- 默认展开/折叠
- 支持嵌套使用
- 键盘操作支持
时间线功能
- 可视化时间轴
- 五种类型样式
- 六种图标选择
- 进入视口动画
- 响应式设计
音乐播放器功能 ⭐ v1.5.0更新
- 网易云音乐/QQ音乐支持
- 本地文件/在线链接
- 歌单导入和混合播放
- 完整播放控制
- 响应式音乐播放器
- ✅ 控制台日志已清理

9.1 音乐API配置

自定义API端点配置
多API自动切换
支持自建API服务
灵活启用/禁用
故障转移机制

9.2 nsmao API使用

网易云音乐解析
超清母带音质
密钥认证机制
API调用说明
故障排查指南

9.3 Meting API使用

支持歌单功能
网易云/QQ音乐
双API智能切换
无需密钥
基于开源项目

彩色文字功能

预设9种常用颜色
支持十六进制/RGB/RGBA
跟随主题颜色
可与Markdown组合
语义化配色建议

🎨 视觉与布局

背景图系统

4种背景效果模式
模糊、亮度、透明度控制
整站背景图配置
渐进式加载优化

侧栏组件配置

12+ 种侧栏组件
左右侧栏独立配置
灵活排序和开关
组件数量控制

📖 内容组件

系列文章组件

多系列文章管理
自动轮播切换
智能检测当前系列
文章详情页固定显示

🎨 页面定制

分类/标签页面

随机彩色 / 自定义颜色
8种精美渐变色
纯黑日期文字
暗色模式适配

友链页面

透明 / 随机 / 自定义背景
响应式网格布局
点击跳转功能
精美悬停效果

装备页面

分组展示装备
图片、价格、描述
多平台购买链接
集成评论系统

💰 互动功能

打赏按钮功能

微信/支付宝双平台
悬停显示二维码
移动端适配
自定义文字和样式

评论可见内容功能

评论后可见内容
支持Artalk等评论系统
LocalStorage状态记录
自动滚动到评论区

🔧 站点配置

页脚配置功能 ⭐ 新增

运行时间动态显示
网站地图配置
备案信息显示
自定义HTML内容
PJAX兼容支持

侧栏一体化模式 ✨ 全新功能

侧栏组件统一外观
分割卡片 / 一体化切换
优雅分割线设计
完整暗色模式支持
响应式自适应

🚀 快速导航

按功能类型查找

视觉展示

主页大图 - 首页大图欢迎页
轮播图 - 首页内容轮播
背景图系统 - 整站背景配置
相册功能 - 分组相册与图片展示

布局配置

侧栏组件 - 侧边栏组件管理
侧栏一体化模式 - 侧栏统一外观 ✨ 新功能

内容管理

文章置顶 - 重点文章置顶
系列文章 - 系列内容组织

页面定制

分类/标签页 - 分类标签页面配置
友链页面 - 友链页面配置
装备页面 - 装备展示页面

富媒体支持

视频嵌入 - 视频内容嵌入
选项卡切换 - 选项卡内容组织
相册功能 - 照片分组展示
内容折叠 - 折叠内容组织
时间线功能 - 时间轴可视化
音乐播放器 - 音乐内容播放
彩色文字 - 文字颜色装饰

用户互动

打赏按钮 - 支持作者创作

📖 使用建议

新手必读

如果您是第一次使用 Demius 主题，建议按以下顺序阅读：

基础配置
- 了解 hugo.toml 配置文件结构
- 掌握基本的 Hugo Front Matter 语法
视觉配置（推荐优先配置）
- ✅ 主页大图 - 打造震撼首页
- ✅ 背景图系统 - 配置整站背景
- ✅ 侧栏组件 - 自定义侧边栏布局
核心功能（推荐优先启用）
- ✅ 文章置顶 - 突出重要内容（徽章颜色配置）
- ✅ 系列文章 - 组织相关内容
- ✅ 视频嵌入 - 丰富内容形式
- ✅ 选项卡切换 - 内容分组展示
页面定制（根据需求配置）
- ⭕ 分类/标签页 - 自定义列表页面
- ⭕ 友链页面 - 配置友情链接
- ⭕ 装备页面 - 展示个人装备
可选功能（根据需求启用）
- ⭕ 轮播图 - 首页内容展示
- ⭕ 打赏按钮 - 获得读者支持

进阶使用

当您熟悉基础功能后，可以：

样式定制
- 每个功能都提供了样式定制章节
- 可以根据自己的品牌风格调整
性能优化
- 参考各文档的性能优化建议
- 合理控制功能数量和内容量
最佳实践
- 学习每个功能的最佳实践
- 避免常见错误

🔧 配置文件说明

所有功能都在 hugo.toml 中配置，主要配置项：

[params]
  # 视频支持
  [params.video]
    enable = true
  
  # 轮播图
  [params.carousel]
    enable = true
    # ...更多配置
  
  # 打赏按钮
  [params.reward]
    enable = true
    # ...更多配置
  
  # 侧栏配置
  [params.aside]
    right = ["series-posts", ...]
    
    # 系列文章
    [params.aside.seriesPosts]
      enable = true
      # ...更多配置

详细配置请查看各功能的使用指南。

📝 文章 Front Matter

某些功能需要在文章的 Front Matter 中配置：

置顶文章

---
title: "文章标题"
pinned: true  # ← 设置置顶
---

视频嵌入

---
title: "文章标题"
---

文章内容...

{{< bilibili bvid="BV1xx411c7mD" >}}

🎯 功能对比

功能	位置	配置难度	推荐指数
主页大图	首页全屏	⭐⭐ 中等	⭐⭐⭐⭐⭐
背景图系统	全局	⭐⭐ 中等	⭐⭐⭐⭐⭐
侧栏组件	左右侧栏	⭐⭐ 中等	⭐⭐⭐⭐⭐
文章置顶	文章列表	⭐ 简单	⭐⭐⭐⭐⭐
系列文章	右侧栏	⭐⭐ 中等	⭐⭐⭐⭐⭐
分类/标签页	列表页	⭐ 简单	⭐⭐⭐⭐
友链页面	独立页	⭐⭐ 中等	⭐⭐⭐⭐
装备页面	独立页	⭐⭐ 中等	⭐⭐⭐
视频嵌入	文章内容	⭐ 简单	⭐⭐⭐⭐
选项卡切换	文章内容	⭐ 简单	⭐⭐⭐⭐⭐
内容折叠	文章内容	⭐ 简单	⭐⭐⭐⭐⭐
时间线	文章内容	⭐ 简单	⭐⭐⭐⭐
音乐播放器	文章内容	⭐ 简单	⭐⭐⭐⭐⭐
彩色文字	文章内容	⭐ 简单	⭐⭐⭐⭐⭐
相册功能	独立页	⭐⭐ 中等	⭐⭐⭐⭐
轮播图	首页顶部	⭐⭐⭐ 复杂	⭐⭐⭐
打赏按钮	文章底部	⭐⭐ 中等	⭐⭐⭐