1.1.0

发布日期：2026-09-15
主题包：dist/theme-mdocs-1.1.0.zip
适用 Halo：>= 2.25.0

小版本更新：补齐错误页体系，补上归档 / 标签 / 分类列表页与 Markdown 正文缺失的排版，并新增大屏适配。

新增

错误页

• 按状态码定制错误页，模板位于 templates/error/，Halo 按「精确状态码 → 4xx / 5xx 类别 → error.html」的顺序匹配：

  模板	触发	标题
  404.html	404	页面走丢了
  500.html	500	服务出了点问题
  4xx.html	401 / 403 / 405 / 429 等	请求无法完成
  5xx.html	502 / 503 / 504 等	服务出了点问题
  error.html	最终兜底	按状态码自动选择 4xx / 5xx 文案

• 五个页面共用 error-page.html 片段，保留站点页眉页脚、明暗主题与主题色，不会出现样式裸奔。

• 操作区：返回首页、返回上一页、浏览归档、搜索文档（需 PluginSearchWidget）、重新加载（仅 5xx）。

• 优先展示 error.status / error.detail，字段为空时回退到内置文案，不会因为缺字段而报错。

列表页样式

• 归档、标签、作者、普通分类页此前直接沿用浏览器默认样式，现补齐：页面大标题、归档年月分组、文章条目分隔线与悬停态、文章标题与元信息、分类 / 标签标签块、分页导航。
• 所有选择器限定在 .page-wrap 作用域内，首页、文档页、插件页的表现不受影响。

正文排版

• 补齐有序 / 无序列表（含嵌套）、分隔线、图片与图注、定义列表的排版规则。
• 表格沿用原有的横向滚动保护，未做改动。

大屏适配

• >= 1600px：左侧导航 320px、右侧 TOC 280px、插件卡片网格 5 列。
• >= 2200px：左侧导航 360px、右侧 TOC 320px、插件卡片网格 6 列。
• 1600px 以下的表现与 1.0.0 完全一致；首页内容与页脚的定宽由原来的 1080px 放宽到 1280px。

优化

• 文档页、文章页、分类页等 6 处 theme.config.docs.X 改为安全导航 docs?.X，未配置文档设置时不再出现渲染异常。
• 错误页操作区中 <button> 与 <a> 的字体、光标表现保持一致。
• 页脚公安联网备案去掉图标，仅保留备案号文字，与 ICP 备案保持一致的排版。
• 补全开源元信息：theme.yaml 增加仓库地址（https://github.com/KetchupKeeper/theme-mdocs）、Issues 地址（/issues）、作者主页，许可证链接指向仓库内的 LICENSE，主题描述扩充为完整能力清单；README 补充仓库、许可与反馈入口、贡献指引，并修正页脚宽度描述。
• 版本说明改为按版本号拆分：每个版本一个文件，统一放在 docs/versions/ 下（如 docs/versions/1.1.0.md），根目录的 CHANGELOG.md 仅作索引。

修复

• 标签页 /tags 返回 500：tags 是列表而非分页对象，改为直接遍历，并移除无效的分页块。