1.2.0

发布日期：2026-10-03
主题包：dist/theme-mdocs-1.2.0.zip
适用 Halo：>= 2.25.0

小版本更新：参考语雀（Yuque）公共页面的版式，为 Docsme、MiniDocs 两个插件页面补齐页面级自定义能力，并修复首页模板编译产物被截断的问题。

新增

插件页面英雄块

参考语雀公共页面的头部区，为两个插件页面各新增一组英雄块设置：

• 新增 启用英雄块 开关，默认关闭；开启后在页面顶部渲染英雄块，并展开下方 5 项子设置，关闭时不输出任何结构。

• 子设置项：

  子设置项	默认值	说明
  英雄块背景图	空	通栏铺满页面顶部，自动叠加半透明遮罩保证文字可读
  英雄块标题	空	与 Logo 同一行显示；留空时回退为当前页面标题
  英雄块 Logo	空	与标题同一行，显示在标题左侧
  英雄块描述	空	标题下方的说明文字
  搜索框占位文字	请输入	回车跳转 /search?keyword=，需安装 PluginSearchWidget 搜索插件

• 未安装 PluginSearchWidget 时不渲染搜索框，英雄块其余部分正常显示。

插件页面描述模块

接着英雄块下方，为两个插件页面各新增一组描述设置：

• 新增 启用描述模块 开关，默认关闭；开启后渲染描述列表，关闭时不输出任何结构。
• 描述内容以 列表形式 配置，array 组件限制 最多 3 条（max: 3），支持拖拽排序、增删；每条包含 标题 与 文本内容 两个字段。
• 文本内容支持换行与简单 HTML（链接、加粗等），默认预置 3 条占位文案（快速上手 / 常用文档 / 了解我们），可直接修改或删除，删空后该模块不再输出。
• 前端按三列排布：960px 以下两列，720px 以下单列。

插件页面显示页眉开关

• 两个插件页面分组各新增 显示页眉 开关，默认开启。
• 关闭后该插件页面顶部不再显示站点页眉，首页、文档页等其他页面不受影响。

仅显示页面模块

• 两个插件页面分组各新增 仅显示页面模块 开关，默认关闭。
• 关闭时页面自上而下渲染：英雄块 → 描述模块 → 页面模块 → 文档列表（Docsme 项目列表 / MiniDocs 知识库列表），与 1.1.0 行为一致。
• 开启后不再渲染文档列表，页面内容由页面模块决定。
• MiniDocs 的知识库阅读器挂载点 #minidocs-viewer-host 已移出该判断条件，?kb= 直达阅读不受影响。

优化

• 两个插件页面沿用首页的公共模块片段 src/partials/home-modules.html（编译内联到各模板），首页与插件页面共用同一份模块实现。
• 条件设置项统一使用 $get(字段 id).value 形式的联动表达式，开关切换后子设置项即时显隐，无需先保存。
• 全部新增设置项均补齐默认值（含 descriptions 数组的 3 条占位文案），重载主题配置后即可直接使用。

修复

• 修复首页模板重构后 templates/index.html 编译产物缺失闭合标签、只剩首行的问题（.homepage-container 未闭合导致后续内容被丢弃）。