升级提示
- 本版本要求 Halo
>= 2.25.0。 - 内容主题设置已完成重构，不再提供 Light、Dark、WeChat、Ant Design 等内置内容主题。
- 浅色与深色模式现在分别通过“自定义 CSS 地址 + 正文容器 class”配置内容样式。
- 如果旧版本正在使用内置内容主题，升级后请前往「文档设置」重新配置自定义 CSS；未配置 CSS 或加载失败时，阅读页会使用基础回退样式。
- 自定义 CSS 地址仅支持 HTTPS 地址或以
/开头的站内绝对路径。 - 升级前建议通过「文档设置」导出当前设置和文档快照，并备份 Halo 数据。
新功能
明暗模式独立渲染配置
- 浅色与深色模式可分别配置：
- 自定义 Markdown CSS 地址
- 正文容器 class
- highlight.js 代码高亮主题
- 优先识别 Halo 当前主题状态。
- Halo 使用
auto或未提供明确主题状态时，自动跟随浏览器的prefers-color-scheme。 - 主题变化后无需重新生成正文 HTML，即可切换内容 CSS、正文 class 和代码主题。
- 增强对常见主题 class、data 属性和本地存储主题状态的兼容。
RaTeX 数学公式渲染
- 新增对
$...$行内公式和$$...$$块级公式的渲染支持。 - 使用 RaTeX WASM + Canvas 在浏览器端渲染公式。
- Canvas 背景保持透明，公式颜色自动跟随正文实际颜色。
- 明暗主题切换后自动重新绘制公式颜色。
- RaTeX 初始化或单个公式渲染失败时，自动回退到 Vditor 数学公式渲染。
- RaTeX、WASM、字体及相关资源均由插件本地提供，无需依赖外部 CDN。
Markdown 渲染增强
新增或完善以下前台渲染选项：
- 代码块行号
- 中英文与数字之间自动空格
- 裸 URL 自动链接
- Markdown 脚注
==文字==Mark 标记- 常见技术术语大小写修正
- 正文顶层段落首行缩进
- Mermaid、Graphviz、ECharts、Markmap 等图表代码块渲染
以上设置仅作用于前台文档阅读页，不会改变后台 Vditor 编辑器的行为。
改进
- 优化文档设置页的渲染配置布局，使用浅色 / 深色标签分别管理对应设置。
- 移除效果不稳定的内置内容主题选择，统一改为自定义 CSS 配置。
- 自定义 CSS 留空或加载失败时保留可读的基础回退样式。
- 优化主题切换过程中的代码主题和公式颜色刷新逻辑。
- 修复快速连续切换明暗主题时，旧的延迟刷新可能覆盖当前公式颜色的问题。
- 调整文档设置页与文档编辑页的自定义代码输入框布局。
- 规范插件 YAML 配置值格式。
- 更新文档设置页截图及相关使用文档。
构建与发布
- 构建流程新增 RaTeX 静态资源处理任务。
- Vditor、RaTeX、WASM 和数学字体资源会随插件 JAR 一并打包。
- 新增静态资源反向代理配置，确保前台渲染资源可正常访问。
- 完善自动发布流程，支持发布至 Halo 应用市场。
兼容性
- Halo：
>= 2.25.0 - Java：21+
- 从
v1.1.0升级时，原有文档库、文档内容、自定义代码、布局配置和代码主题配置均可继续使用。 - 旧的内置内容主题名称不再生效；已有自定义 CSS 地址与正文 class 会继续保留。