🔧 Oxygen 工具使用指南

镭内容出色中心 · 让文档工作更高效

📌 重要说明
本工具已打包为 EXE 可执行文件,通过 Oxygen 外部工具调用即可。

工具总览

工具名称 用途 输出
Where-Used 查询工具
where_used.bat
快速查询当前主题被哪些文件引用 引用列表 + HTML 报告
DITA 关系分析工具
discovery.exe
生成全项目关系图谱、复用统计、影响分析 PNG 图谱 + Excel + HTML 报告

在 Oxygen 中配置外部工具

将下列命令配置为 Oxygen 的外部工具,即可在编辑器中一键调用。

① Where-Used 查询工具

使用场景:您在编辑某个 DITA 主题时,想立即知道它被哪些 Map 或 Topic 引用。

操作步骤:

  1. 在 Oxygen 中打开任意 .dita 或 .md 文件。
  2. 运行配置好的外部工具(或点击工具栏按钮)。
  3. 工具自动扫描项目根目录,并在输出目录生成 where_used_文件名.html。

Oxygen 外部工具命令行:

"D:\tools\XHSC-oxygen\where_used.bat" "${cf}"

※ ${cf} 代表当前文件完整路径,Oxygen 会自动替换。

② DITA 关系分析工具

使用场景:您需要生成整个项目的主题关系图谱、复用率统计或影响分析报告。

操作步骤:

  1. 在 Oxygen 中打开项目中的任意文件(建议为 .ditamap 或项目根目录下的文件)。
  2. 运行配置好的外部工具。
  3. 工具将在当前文件所在目录下生成报告(默认输出到 discovery_reports 文件夹)。

Oxygen 外部工具命令行:

D:\tools\XHSC-oxygen\discovery.exe -d ${cfd}

※ ${cfd} 代表当前文件所在目录,该目录将被视为扫描根目录。

外部工具配置参数参考

设置项 Where-Used 工具 DITA 分析工具
名称 Where-Used 查询 DITA 关系分析
命令行 "D:\tools\XHSC-oxygen\where_used.bat" "${cf}" D:\tools\XHSC-oxygen\discovery.exe -d ${cfd}
输出编码 UTF8 UTF8
错误编码 UTF8 UTF8
工作目录 任意(脚本会自动处理)

常见问题

⚠️ 如果工具没有输出?
- 请确认当前文件路径中不包含特殊字符(如中文、空格)——工具已优化处理,但极端情况仍建议使用英文路径。
- 确认命令行中的工具路径正确,且文件存在。
- 检查 Oxygen 外部工具的输出编码是否设置为 UTF8。
⚠️ 如果生成的报告中文乱码?
请确保 Oxygen 外部工具的输出编码和错误编码均设置为 UTF8,如上述表格所示。

技术支持

如遇问题,请联系内容出色中心技术团队,或查阅内部知识库。

© 2026 镭内容出色中心