DITA 源管理
ditamap / topics / keydefs / ditaval 分层仓库一目了然,点击源文件即在阅读器中打开,渲染视图与 XML 源码双模式。
以 DITA XML 源文件 为唯一输入的用户手册服务平台:
ditamap 组装、keyref 变量注入、conref 内容复用、props/ditaval 条件过滤,
一次编写即可为哈弗全系车型多配置精准发布。
基于 DITA 主题标题与全文索引,输入后按 Enter 直达主题
ditamap / topics / keydefs / ditaval 分层仓库一目了然,点击源文件即在阅读器中打开,渲染视图与 XML 源码双模式。
哈弗 H2 使用说明书(钥匙 → 燃油加注)三级目录逐级展开,概念 / 任务 / 参考三类主题分色标识,资料内部链接跳转。
切换 H2 / H1 变量定义,正文中的车型名、钥匙类型等术语实时替换——同一套源文件,两个车型手册。
应用高配 / 中配过滤规则,config="high" 的 PEPS、天窗章节随配置实时显隐,无需维护两份文档。
基于哈弗 H1/H2 双车型实证:通用层、变量层、条件层三层复用架构与逐段比对数据,复用率 72–83%。
按过程状态与有效性自动发布:PDF、Web、iOS / Android 应用与打印版,支持中英文一键切换与离线同步。
conref 内容引用安全警告等完全一致的内容集中存放于 common/ 仓库,各车型通过 conref 引用。法规更新时修改一处,全系手册下次发布自动同步。
keyref 变量注入车型名、钥匙类型等术语差异抽取为 keydef 变量,骨架内容引用 keyref 占位,发布时按车型注入——上方工作区可实时演示。
props + ditaval 条件过滤PEPS、天窗等配置相关章节标记 config="high",发布时按 ditaval 规则自动包含 / 排除,高低配共用一套源文件。
| 比对项目(H1 vs H2) | 取样字数 | 差异说明 | 可复用比例 |
|---|---|---|---|
| 燃油加注全流程 | 约 280 字 | H2 多固定支架描述 | 96% |
| 车窗升降操作 | 约 200 字 | H2 多「一键上升」 | 97% |
| 儿童锁说明 | 约 150 字 | 「开启」vs「停用」措辞 | 100% |
| 安全警告合集 | 约 600 字 | 仅车型名替换 | 100% |
| 天窗操作(共性部分) | 约 300 字 | H2 独有初始化 / 过热保护 | 66% |
| 钥匙介绍 | 约 400 字 | H2 独有 PEPS | 75% |
综合加权估算:全文档可复用率稳定在 72% ~ 83% 之间——这正是 DITA 三层复用架构的收益区间。
同一份 DITA 源,按主地图与 ditaval 组合批量产出:
· h1_user_guide.ditamap + 高配规则 → 哈弗 H1 高配手册
· h2_user_guide.ditamap + 高配规则 → 哈弗 H2 高配手册
· h2_user_guide.ditamap + 中配规则 → 哈弗 H2 中配手册(PEPS / 天窗自动过滤)
源文件托管于 Git 仓库,与写管用平台集成:按过程状态与有效性信息自动发布;离线模式下本地访问,联网后自动同步更新;中英文内容一键切换,无需重启工具。