oxygen xml editor 是面向结构化内容的专业工具，关键在于验证结构、重用内容、一键发布；应使用预设模板新建文档，依赖实时校验与 conref/keyref 实现内容重用，并通过预置转换场景导出 pdf/html。
Oxygen XML Editor 不是“装上就能写”的轻量工具，而是面向结构化内容的专业环境。用好它的关键不是记住所有菜单，而是理解三个动作：验证结构、重用内容、一键发布。新手常卡在“不知道从哪开始编辑”，其实只要选对文档类型（比如 DITA 主题或 DocBook 章节），系统就会自动加载对应模板和校验规则。
DITA 或 DocBook 新建文档，别从空白 XML 开始
直接新建一个 .xml 文件容易漏掉必需的命名空间、DOCTYPE 或 schema 关联，导致后续无法验证或转换。正确做法是：
- 点击 File → New → Framework Templates，选择 DITA Topic、DITA Map、DocBook Article 等预设模板
- 模板会自动生成合法根元素、命名空间声明和 xsi:schemaLocation 属性
- 保存时建议用 .dita（非 .xml）后缀，Oxygen 会据此启用 DITA 特有功能，如内容重用视图、地图导航等
边写边验证，错误提示就在行尾
Oxygen 默认开启实时校验，不需要手动运行“Validate”命令。只要文档关联了 XSD、DTD 或 Relax NG 模式，输入错误标签或缺失必填属性，行号右侧立刻出现红色波浪线，悬停即可看到具体报错。
- 常见误操作：在 DITA 主题里直接写
而不是
ApiPost接口调试与文档生成工具下载ApiPost是一个支持团队协作，支持模拟POST、GET、PUT等常见请求，并可直接生成文档的API调试、管理工具，ApiPost是后台接口开发者或前端、接口测试人员的工作必备工具。快速生成、一键导出API文档。感兴趣的朋友快来下载吧。软件说明ApiPost官方版是一款十分出色的接口调试与文档生成工具，ApiPost官方版界面美观大方，功能强劲实用，支持团队协作，支持模拟POST、GET、PUT等常见请求，是后台接口开发者或前端、接口测试人员的工作必备工具。软件特色更方便支持接口调试的同时快速生成、一键
，或漏掉
元素（DITA 严格模式下为必填） - 快速修复：光标停在报错行，按 Ctrl+1（Windows）或 Cmd+1（macOS），Oxygen 会列出可选修复项，比如自动补全缺失元素或修正命名空间前缀
- 若想临时关闭校验，右键编辑区 → Validation → Disable Validation，但不建议长期关闭
内容重用不是高级功能，而是日常操作
DITA 的核心价值在于“一次编写、多处使用”，Oxygen 把这个过程做得像插入链接一样简单：
- 写文档时，把光标放在要插入重用内容的位置，按 Ctrl+Shift+R（Cmd+Shift+R），弹出“Reference Assistant”窗口
- 可搜索本地项目中的其他 DITA 主题、图像、代码块，甚至跨文件的
或 元素 - 插入后生成的是
或 ，不是复制粘贴——修改源内容，所有引用处自动同步 - 想看清当前文件被谁引用？安装 “DITA Reference View” 插件（Oxygen 22.0+），侧边栏即显示全部引用关系
导出 PDF/HTML 只需点一下，但样式要提前配
“Publishing” 面板里一堆按钮看着复杂，其实常用路径就一条：
- 打开你的 DITA Map（.ditamap 文件）→ 点击顶部工具栏的 Configure Transformation Scenarios（齿轮图标）
- 选择预置场景，如 “DITA-OT PDF” 或 “WebHelp Responsive”；首次使用会提示下载 DITA Open Toolkit（自动完成）
- 点击 Apply，几秒后生成结果。PDF 默认用 XSL-FO 渲染，HTML 默认带搜索和响应式布局
- 若要调整字体、页眉页脚或导航栏样式，修改对应 transformation 中的 CSS（HTML）或 XSL-FO（PDF）文件，无需写代码也能通过可视化编辑器调整
