Oxygen XML Editor：新版本24.1现已发布

Oxygen XML Editor：新版本24.1现已发布

 

Oxygen XML Editor 24.1版是业界最先进的工具包的增量版本，供各地的技术作者、开发人员、合作者和出版商使用。本次发布的重点是扩展版本24.0中添加的新功能和改进。

 

此版本包括DITA作者和出版商的生产力改进。最近在版本24.0中引入的创新JSON模式设计模式得到了很多进一步的增强。一些现有的JSON工具也得到了改进。附加组件是本次发布的主要关注点，许多最受欢迎的附加组件都会收到大量更新（包括Git客户端、批处理文档转换器、OpenAPI文档生成器、OpenAPI测试仪等）。还提供了一个有趣的新智能自动完成插件，它通过提供文本补全来帮助作者创建内容。XSLT和XQuery转换和调试功能通过对Saxon引擎的更新得到了增强，该版本包括各种其他组件更新、错误修复和安全增强。

 

以下方面发生了变化：

 

• DITA创作

移动并重命名非DITA资源

DITA映射中引用的非DITA资源可以通过使用移动或重命名上下文菜单操作在DITA映射管理器中直接重命名。您还可以选择在移动/重命名操作期间更新资源的所有引用。

 

打开内容扩展的DITA映射时，性能有所提高

当打开一个DITA映射时，所有引用的主题内容都已展开并可编辑，性能得到了提高。现在打开地图所需的时间更少了，即使它包含大量引用的主题。

 

• DITA发布

DITA开放工具包的更新和改进

与Oxygen捆绑在一起的DITA开放工具包版本已更新为3.7.0版。许多额外的小错误修复也是更新发布引擎的一部分。

 

现在支持绝对定位

对于基于CSS的PDF转换，处理器现在支持内联元素的绝对位置。例如，现在可以定义自定义CSS规则，以在文档或段落中的某个绝对位置显示图像。

 

用链接替换媒体

对于基于CSS的PDF转换，通过使用新的（show.media.as.link）转换参数，可以使用外部链接而不是图形来显示媒体对象。

 

按字母顺序对词汇表进行排序，并按第一个字母分组

现在可以按字母顺序对词汇表条目进行排序，并按单词的第一个字母进行分组。这可以通过设置新的排序来实现基于CSS的PDF转换，和sort.and.group.glossentries转换参数为yes。默认情况下，它们是根据文档顺序插入的。

 

• JSON模式设计模式

JSON模式设计模式拖放支持

现在，您可以使用拖放支持在设计模式下设计JSON模式。只需将零部件拖放到正确的位置，即可移动或重新排序零部件。Oxygen将显示一个接头，以帮助您可视化下降位置，当部件不允许在该特定位置时，Oxygen将以红色突出显示接头。

 

 

新的调色板视图使JSON模式设计模式下的模式构建变得非常简单

新实现的调色板视图旨在提供对JSON模式组件的快速访问，并提高JSON模式图生成器的可用性。该调色板可用于轻松地将各种组件拖放到设计模式中构建的JSON模式图中。

 

 

将属性标记为必需或可选的新操作

在JSON模式设计模式中添加了新的上下文菜单操作，以便在父对象中将属性标记为必需或可选。默认情况下，JSON模式中不需要定义的属性。但是，您可以在关键字列表中选择“必需”的值。

 

在对象模式和布尔模式之间转换

JSON模式设计模式中提供了新的上下文菜单操作，可以将属性或定义的对象模式转换为值为True或False的布尔模式，反之亦然。

 

提取定义

在“提取”菜单的“设计”模式中，在“提取”菜单定义中添加了新的JSON子模式。该操作允许您将定义提取到全局定义中并引用它。它可用于将属性的定义提取为全局定义，或全局提取局部定义。

 

进入定义

在JSON模式设计模式中添加了一个新的Go to Definition上下文菜单操作，使您能够快速导航到引用的模式组件。

 

内容完成现在支持就地编辑

内容完成助手现在可以在JSON模式设计模式下进行就地编辑。例如，在编辑属性时，可以使用Ctrl+Space来调用内容完成窗口，并根据所使用的版本，基于定义的JSON模式提供建议。

 

• JSON工具

标记JSON模式生成器工具中需要的属性

使用JSON模式生成器工具时，现在可以使用一个选项（Make all properties required）来指定在生成的模式中需要所有属性。

 

 

控制XML到JSON转换器中空元素的转换

在XML-to-JSON转换器对话框中添加了一个新选项（将空元素转换为类型的结构），允许您选择在转换期间将空元素转换为的数据类型。可能的值是object、string或array。

 

为JSON模式文档中的模式引用生成的图表

如果在使用JSON模式文档工具时选择在生成的文档中显示图表，那么现在还会为模式文档中引用的文件中的组件显示图表。

 

在JSON模式文档中添加了图表的超链接

使用JSON模式文档工具时，可以选择为生成的文档中显示的图表包含超链接。每个超链接将导航到特定组件。

 

• OpenAPI

OpenAPI测试工具

一个新的OpenAPI测试工具可以帮助您轻松地检查OpenAPI请求响应，并确保它们按预期工作。它可以用于JSON或YAML格式的OpenAPI 3.0。该工具位于Tools->JSON Tools菜单中。它需要安装一个附加组件，但您可以选择在第一次选择该工具时自动安装它。

 

 

OpenAPI文档生成器

新的OpenAPI文档生成器工具可帮助您轻松生成HTML格式的OpenAPI组件的完整文档，包括全面的注释和交叉引用。文档以可视化图表的形式呈现，包含各种部分、超链接和过滤选项。该工具位于Tools->Generate Documentation菜单中。它需要安装一个附加组件，但您可以选择在第一次选择该工具时自动安装它。

 

• XSLT/XQuery

XSLT转换和调试

用于XSLT转换和调试的Saxon内置XSLT处理器已更新为10.6版。Saxon 10版本目前被认为是最稳定、最可靠的版本。

 

 

XQuery转换和调试

将用于XQuery转换和调试的Saxon XQuery处理器更新为10.6版。

 

在编译XSLT for Saxon工具中添加了新选项

在Compile XSLT Stylesheet for Saxon对话框中添加了一个新选项，允许您为不固定的元素名称设置默认名称空间。它可以用来控制-ns (uri|##any|##html5) Saxon参数，该参数定义了对在路径表达式和样式表中作为名称测试和匹配模式出现的不固定元素名称的处理。

 

用于Saxon 11.2版的Saxon XSLT和XQuery Transformer附加组件

有一个新的Saxon transformer附加组件，它增加了对Saxon transformer 11.2版的支持。这允许您使用Saxon 11.2引擎验证和转换XSLT和XQuery文档。

 

将Saxon 10 XSLT和XQuery Transformer附加组件更新到10.7版

Saxon 10 transformer附加组件更新为10.7版。这允许您使用Saxon 10.7引擎验证和转换XSLT和XQuery文档。

 

• 标记

增加了对下划线内容的支持

标记编辑器现在支持用于给内容加下划线的++abc++语法。

 

• 安全

删除了Apache Log4j依赖项

删除了对Apache Log4j的依赖，以帮助防止安全漏洞。现在使用的是SLF4j API和Logback库。

 

• 附加组件

有多种Oxygen附加组件可以扩展应用程序的功能。许多现有的附加组件都得到了更新和改进，同时还提供了一个新的智能自动完成实验附加组件，可以通过提供文本补全来帮助作者创建内容。

 

智能自动完成插件（实验版）推出

一个新的智能自动完成实验插件可以帮助作者通过提供文本补全来创建内容。一旦安装了附加组件，侧视图将可用，您可以在其中访问其功能。您可以在内置引擎或OpenAI引擎之间进行选择，以生成文本完成建议。内置引擎分析项目中的所有XML、HTML或标记文件，然后在编辑项目中的文本内容时提供完成建议。OpenAI引擎提供了使用OpenAI公司提供的语言模型的能力。该引擎不仅提供文本完成建议，还提供各种可配置操作，可用于在编辑器中转换所选文本，并允许您使用称为微调的过程创建自己的语言模型。一些可用于转换所选文本的操作示例包括语法更正、释义、将内容翻译成其他语言、添加标记、创建有序列表等等。

 

 

改进了附加文档结构

官方Oxygen存储库中的所有附加组件现在都在用户指南（附加组件章节）中进行了分类，以便更容易找到您想要阅读的附加组件类型。

 

添加了快速安装按钮

所有附加组件都有一种新的更简单的安装方法。用户指南主题现在在快速安装部分有一个新的安装按钮，可以简单地将其拖放到Oxygen中的主编辑器中，以启动安装过程。

 

Git客户端改进

Git客户端插件进行了各种改进：

• 历史视图现在包括一个新的修订图，帮助您了解提交如何相互连接。
• 隐藏对话框现在有一列，显示每个隐藏的创建时间。
• 历史视图的上下文菜单中添加了一个新的签出操作。它在特定提交时签出一个分支（以分离头形式或在该提交时创建一个新分支）。
• Git Staging view工具栏经过简化，只显示最常见的操作，而所有操作都可以在新的省略号（三个垂直点）菜单中轻松访问。此菜单还包括一些新操作。例如，您现在可以管理远程存储库（添加、编辑或删除），跟踪当前分支的远程分支，或编辑存储库的配置文件。大多数操作也可以在主菜单栏中添加的新Git菜单中使用。
• 通过优化检查存储库状态的过程，提高了性能。
• 集成了各种错误修复、组件更新和性能增强。

 

 

批处理文档转换器的改进

对Batch Documents Converter附加组件进行了各种改进：

• 现在，您可以将从Atlassian Confluence导出的HTML文档转换为DITA。
• 现在，您可以将一个或多个DocBook文档转换为DITA，并且可以使用名为“从包含多个部分的DocBook文档创建DITA映射”的选项，将所有部分转换为单独的DITA主题，并在新的DITA映射中引用。
• 添加了一个新的preferences页面，为特定类型的转换配置元素之间的映射提供选项。例如，当从Word转换为XHTML、DITA或DocBook时，可以使用Word样式映射选项自定义Word元素和样式到相应HTML元素之间的映射。
• 在将标记文档转换为DITA时，可以更好地处理包含单元格跨度的表。
• 各种小错误修复和转换改进。

 

 

OpenAPI Tester附加组件改进

OpenAPI Tester插件已更新至1.1版，其改进包括：

• 您现在可以使用测试工具来测试以YAML格式以及JSON格式表示的OpenAPI文档。
• 增加了对OpenAPI 3.1.0规范的基本支持（Webhook除外）。
• 景观布局得到改善。
• 各种错误修复和改进。

 

DITA Prolog更新程序附加组件的改进

对DITA Prolog Updater插件进行了各种改进：

• 添加了一个新选项，用于控制从附加选项首选项页面（在全局选项或项目级选项中）存储选项的位置。
• 修复了prolog元素被插入不允许的文档中的问题。

 

XSpec Helper视图附加组件现在捆绑了XSpec 2.2.4

XSpec Helper视图加载项已更新为包含XSpec 2.2.4版。

 

• 其他

用于控制“作者视觉编辑”模式中跟踪更改的初始视图模式的新设置

在Preferences->Editor/Edit Modes/Author/Review Preferences页面中添加了一个新的初始显示模式设置，以控制在Author可视化编辑模式中跟踪更改的初始显示模式。

 

以PDF格式返回搜索结果的新选项

在“首选项->打开/查找资源首选项”页面中添加了一个新的“包含这些二进制文件的内容”选项，如果PDF包含搜索文本，它将以PDF格式返回“打开/查找资源”对话框/视图中的搜索结果。

 

• 组件更新

DITA开放工具包3.7.0版

将与Oxygen捆绑的DITA Open Toolkit版本更新为3.7.0版。

 

macOS 12 (Monterey)

Oxygen已经在macOS 12 (Monterey)上进行了全面测试，目前已得到官方支持。

 

OpenJDK 17.0.2

一些安装工具包将OpenJDK捆绑为Java运行时环境，并将其更新为17.0.2版。

 

Jackson 2.12.6

将第三方Jackson库更新为2.12.6版，以修复安全漏洞。

 

Xerces 2.12.2

将Xerces库更新为2.12.2版。

 

XSpec 2.2.4

将内置XSpec框架更新为2.2.4版。

 

对eXist db 6.0.1版的官方支持

Oxygen已经过测试，正式支持eXist db 6.0.1版。

 

Calabash XProc 1.3.2-100

将Calabash引擎更新为1.3.2-100版。捆绑的Calabash XProc引擎现在与Saxon 10库集成。

 

Eclipse 4.22

更新了Eclipse插件以支持4.2版。

 

• 脚本编写

Oxygen的all Platform发行版与脚本子文件夹捆绑在一起，其中包含用于从命令行界面自动化和运行各种实用程序的脚本。要运行这些脚本，您需要购买脚本许可证。

 

本次发布的主要关注点是对批处理转换器脚本的各种添加和改进。

 

为批处理转换器脚本使用自定义设置文件

使用批处理转换器脚本时，可以使用新参数（-cs converterSettingsFile）指定包含转换设置的文件。这可能是一个错误。包含项目选项的xpr文件或包含全局选项的XML文件。

 

批处理转换器脚本现在可以选择DocBook到DITA的转换

现在可以使用批处理转换器脚本将从DocBook导出的HTML文档转换为DITA。

 

批处理转换器脚本现在可以选择Confluence到DITA转换

现在可以使用批处理转换器脚本将从Atlassian Confluence导出的HTML文档转换为DITA。

 

批处理转换器脚本——其他改进

对Batch Converter脚本的其他改进包括：

• 在将标记文档转换为DITA时，可以更好地处理包含单元格跨度的表格。
• 各种小错误修复和转换改进。