我们最近帮一个客户做DITA迁移。

Word转完后打开文件夹一看：80多个文件，全堆在一个目录里。ditamap、dita主题、图片素材，全部混在一起，看着就头疼。

我试着手动整理。拖了几个文件到子文件夹后，心里咯噔一下——完了，引用路径全断了。

80多个文件啊，一个一个改回来，我算了一下：至少数小时。

当时我就在想：Oxygen有没有办法用AI批量搞定？

结果真让我找到了。

今天这个方法，适合正在用Oxygen做DITA转换的朋友。如果还没开始用，可以先收藏，以后用得上。

– 1 –

痛点

如果你用过Oxygen的批量转换功能，把Word操作手册转成DITA，应该见过这个场景。

生成的所有文件：ditamap、dita主题、图片，全部丢在同一个文件夹下。这种存放方式，文件多了根本没法管。如下图：

规范的目录结构应该是这样：

• topics/： 存放所有dita主题文件
• media/： 存放所有图片、图表素材

但问题是：手动移动文件到对应子文件夹后，文档里所有引用路径都会失效。

ditamap指向topic文件的路径断了，topic文件里引用图片的路径也断了。你得一个一个改回来。

如果你只有几个文件，还能忍。几十个文件呢？改到你崩溃。

– 2 –

怎么解决

这次我在Oxygen 28.1里试了个新方法：用AI Positron自动整理目录，同时修正所有引用路径。

整个过程就三步：

第一步：打开ditamap

在Oxygen的ditamap管理器中，打开Word转换完成后生成的ditamap工程文件。

第二步：告诉AI你要什么

打开AI Positron工具，输入一句话：

将当前output目录中的dita文件移至topics子文件夹，图片文件移至media子文件夹。请确保所有指向dita文件与图片的引用路径保持有效无误。

第三步：检查并接受结果

AI会自动完成文件移动和引用修正。你检查一下结果，没问题就接受变更。

操作完的效果：文件分类存放，所有引用路径自动修正，一个都不用改。

– 3 –

我的体会

最厉害的是：AI不仅移动了文件，它还知道哪些地方引用了这些文件，自动帮你把路径改回来。

这才是真正的“智能”，不是傻搬东西。

我之前做DITA项目，迁移文档经常遇到类似问题：文件结构要调整，但引用关系太复杂，手动改怕漏改。现在有了这个方法，以后可以直接让AI来处理。

如果你也在用Oxygen做DITA转换，可以试试这个方法。

要求：

• Oxygen版本：28.1及以上
• 安装了AI Positron插件（Oxygen自带）

遇到类似文件整理问题，直接用自然语言描述需求，让AI帮你处理。

你们做DITA转换时，文件整理这块遇到过最崩溃的事是什么？

• A. 手动整理完，引用路径全断，改到崩溃

• B. 文件多到不想整理，直接摆烂

• C. 找到了自己的土办法，效果一般

• D. 还没开始做结构化，但在关注

评论区聊聊～

摩拿科技是专业的结构化文档和智能内容工具和服务提供商，我们在标准软件（如：Oxygen XML Editor， MxContent）的基础上提供专业服务，协助企业文档结构化转型落地，用数据驱动企业人工智能，欢迎扫码了解：

点击下方卡片关注公众号 ⬇️