FIT2CLOUD
文档 的图标

文档

2,089
795

一个为Halo提供文档 / 知识库能力的插件。 my-docs在 Halo 原有文章与页面模型之外,补充一套独立的文档系统,用来承载产品手册、开发文档、帮助中心这类需要树形目录和连续阅读体验的内容。

1.7.6
tsdaer 发布于
>=2.25.0

新增:本站文章转为文档

  • 在文档库列表、文档库操作菜单和文档管理页增加「导入本站文章」。支持标题搜索、分页和跨页多选,单次最多 100 篇,排除回收站文章。
  • 可导入到已有文档库或新建文档库。复制文章最新已保存内容,保留原文章;新文档默认草稿,可选择立即发布。
  • Markdown 原文保留;富文本自动转换为 Markdown,图片和附件继续引用原地址,复杂组件尽量保留 HTML 并提示检查。
  • 同一篇文章再次导入同一文档库时,按来源标识更新标题和正文,保留文档位置、别名、发布状态、发布时间及自定义代码。来源关联随备份导出和恢复。
  • 展示逐篇导入结果,支持只重试失败文章。

修复与构建校验

  • 修复富文本转换时把标题和编辑器 ID 输出为 {#…} 的问题,避免正文出现编码后的锚点字符串;不删除原 Markdown 或代码中的同类文字。
  • 递增插件版本,避免同版本替换后 Halo Console 合并脚本继续引用旧 JS/CSS,造成页面持续加载及资源 404。
  • 构建时校验安装包中的全部 UI chunk 引用,防止缺失资源的安装包通过验证。

升级说明

  • 适用于 Halo >= 2.25.0。从附件下载 plugin-my-docs-1.7.6.jar,在 Halo Console 插件页升级。
  • 非超级管理员使用导入功能前,需要为角色授予「本站文章导入」权限,该权限依赖文档管理和 Halo 文章查看权限。
  • 旧版本已导入的多余 {#…} 标记不会自动改写:升级后重新导入对应文章到同一库即可更新。重新导入会覆盖文档正文中的手动修改,请先备份需要保留的编辑。
  • 升级后刷新整个 Console 页面;若仍请求旧 chunk,可强制刷新,并检查合并脚本的 CDN/反向代理缓存。

验证

  • 后端 180 项测试、前端 67 项测试通过。
  • 完整构建及安装包 UI 资源引用校验通过。
  • 已在实际站点验证页面加载、文章转换及锚点标记修复符合预期。

Generated from v1.7.6

资源下载

  • plugin-my-docs-1.7.6.jar