Oxygen XML Editor：新版本24.1現(xiàn)已發(fā)布

 

Oxygen XML Editor 24.1版是業(yè)界最先進(jìn)的工具包的增量版本，供各地的技術(shù)作者、開發(fā)人員、合作者和出版商使用。本次發(fā)布的重點(diǎn)是擴(kuò)展版本24.0中添加的新功能和改進(jìn)。

 

此版本包括DITA作者和出版商的生產(chǎn)力改進(jìn)。最近在版本24.0中引入的創(chuàng)新JSON模式設(shè)計(jì)模式得到了很多進(jìn)一步的增強(qiáng)。一些現(xiàn)有的JSON工具也得到了改進(jìn)。附加組件是本次發(fā)布的主要關(guān)注點(diǎn)，許多最受歡迎的附加組件都會(huì)收到大量更新（包括Git客戶端、批處理文檔轉(zhuǎn)換器、OpenAPI文檔生成器、OpenAPI測(cè)試儀等）。還提供了一個(gè)有趣的新智能自動(dòng)完成插件，它通過(guò)提供文本補(bǔ)全來(lái)幫助作者創(chuàng)建內(nèi)容。XSLT和XQuery轉(zhuǎn)換和調(diào)試功能通過(guò)對(duì)Saxon引擎的更新得到了增強(qiáng)，該版本包括各種其他組件更新、錯(cuò)誤修復(fù)和安全增強(qiáng)。

 

以下方面發(fā)生了變化：

 

• DITA創(chuàng)作

移動(dòng)并重命名非DITA資源

DITA映射中引用的非DITA資源可以通過(guò)使用移動(dòng)或重命名上下文菜單操作在DITA映射管理器中直接重命名。您還可以選擇在移動(dòng)/重命名操作期間更新資源的所有引用。

 

打開內(nèi)容擴(kuò)展的DITA映射時(shí)，性能有所提高

當(dāng)打開一個(gè)DITA映射時(shí)，所有引用的主題內(nèi)容都已展開并可編輯，性能得到了提高。現(xiàn)在打開地圖所需的時(shí)間更少了，即使它包含大量引用的主題。

 

• DITA發(fā)布

DITA開放工具包的更新和改進(jìn)

與Oxygen捆綁在一起的DITA開放工具包版本已更新為3.7.0版。許多額外的小錯(cuò)誤修復(fù)也是更新發(fā)布引擎的一部分。

 

現(xiàn)在支持絕對(duì)定位

對(duì)于基于CSS的PDF轉(zhuǎn)換，處理器現(xiàn)在支持內(nèi)聯(lián)元素的絕對(duì)位置。例如，現(xiàn)在可以定義自定義CSS規(guī)則，以在文檔或段落中的某個(gè)絕對(duì)位置顯示圖像。

 

用鏈接替換媒體

對(duì)于基于CSS的PDF轉(zhuǎn)換，通過(guò)使用新的（show.media.as.link）轉(zhuǎn)換參數(shù)，可以使用外部鏈接而不是圖形來(lái)顯示媒體對(duì)象。

 

按字母順序?qū)υ~匯表進(jìn)行排序，并按第一個(gè)字母分組

現(xiàn)在可以按字母順序?qū)υ~匯表?xiàng)l目進(jìn)行排序，并按單詞的第一個(gè)字母進(jìn)行分組。這可以通過(guò)設(shè)置新的排序來(lái)實(shí)現(xiàn)基于CSS的PDF轉(zhuǎn)換，和sort.and.group.glossentries轉(zhuǎn)換參數(shù)為yes。默認(rèn)情況下，它們是根據(jù)文檔順序插入的。

 

• JSON模式設(shè)計(jì)模式

JSON模式設(shè)計(jì)模式拖放支持

現(xiàn)在，您可以使用拖放支持在設(shè)計(jì)模式下設(shè)計(jì)JSON模式。只需將零部件拖放到正確的位置，即可移動(dòng)或重新排序零部件。Oxygen將顯示一個(gè)接頭，以幫助您可視化下降位置，當(dāng)部件不允許在該特定位置時(shí)，Oxygen將以紅色突出顯示接頭。

 

 

新的調(diào)色板視圖使JSON模式設(shè)計(jì)模式下的模式構(gòu)建變得非常簡(jiǎn)單

新實(shí)現(xiàn)的調(diào)色板視圖旨在提供對(duì)JSON模式組件的快速訪問(wèn)，并提高JSON模式圖生成器的可用性。該調(diào)色板可用于輕松地將各種組件拖放到設(shè)計(jì)模式中構(gòu)建的JSON模式圖中。

 

 

將屬性標(biāo)記為必需或可選的新操作

在JSON模式設(shè)計(jì)模式中添加了新的上下文菜單操作，以便在父對(duì)象中將屬性標(biāo)記為必需或可選。默認(rèn)情況下，JSON模式中不需要定義的屬性。但是，您可以在關(guān)鍵字列表中選擇“必需”的值。

 

在對(duì)象模式和布爾模式之間轉(zhuǎn)換

JSON模式設(shè)計(jì)模式中提供了新的上下文菜單操作，可以將屬性或定義的對(duì)象模式轉(zhuǎn)換為值為True或False的布爾模式，反之亦然。

 

提取定義

在“提取”菜單的“設(shè)計(jì)”模式中，在“提取”菜單定義中添加了新的JSON子模式。該操作允許您將定義提取到全局定義中并引用它。它可用于將屬性的定義提取為全局定義，或全局提取局部定義。

 

進(jìn)入定義

在JSON模式設(shè)計(jì)模式中添加了一個(gè)新的Go to Definition上下文菜單操作，使您能夠快速導(dǎo)航到引用的模式組件。

 

內(nèi)容完成現(xiàn)在支持就地編輯

內(nèi)容完成助手現(xiàn)在可以在JSON模式設(shè)計(jì)模式下進(jìn)行就地編輯。例如，在編輯屬性時(shí)，可以使用Ctrl+Space來(lái)調(diào)用內(nèi)容完成窗口，并根據(jù)所使用的版本，基于定義的JSON模式提供建議。

 

• JSON工具

標(biāo)記JSON模式生成器工具中需要的屬性

使用JSON模式生成器工具時(shí)，現(xiàn)在可以使用一個(gè)選項(xiàng)（Make all properties required）來(lái)指定在生成的模式中需要所有屬性。

 

 

控制XML到JSON轉(zhuǎn)換器中空元素的轉(zhuǎn)換

在XML-to-JSON轉(zhuǎn)換器對(duì)話框中添加了一個(gè)新選項(xiàng)（將空元素轉(zhuǎn)換為類型的結(jié)構(gòu)），允許您選擇在轉(zhuǎn)換期間將空元素轉(zhuǎn)換為的數(shù)據(jù)類型?？赡艿闹凳莖bject、string或array。

 

為JSON模式文檔中的模式引用生成的圖表

如果在使用JSON模式文檔工具時(shí)選擇在生成的文檔中顯示圖表，那么現(xiàn)在還會(huì)為模式文檔中引用的文件中的組件顯示圖表。

 

在JSON模式文檔中添加了圖表的超鏈接

使用JSON模式文檔工具時(shí)，可以選擇為生成的文檔中顯示的圖表包含超鏈接。每個(gè)超鏈接將導(dǎo)航到特定組件。

 

• OpenAPI

OpenAPI測(cè)試工具

一個(gè)新的OpenAPI測(cè)試工具可以幫助您輕松地檢查OpenAPI請(qǐng)求響應(yīng)，并確保它們按預(yù)期工作。它可以用于JSON或YAML格式的OpenAPI 3.0。該工具位于Tools->JSON Tools菜單中。它需要安裝一個(gè)附加組件，但您可以選擇在第一次選擇該工具時(shí)自動(dòng)安裝它。

 

 

OpenAPI文檔生成器

新的OpenAPI文檔生成器工具可幫助您輕松生成HTML格式的OpenAPI組件的完整文檔，包括全面的注釋和交叉引用。文檔以可視化圖表的形式呈現(xiàn)，包含各種部分、超鏈接和過(guò)濾選項(xiàng)。該工具位于Tools->Generate Documentation菜單中。它需要安裝一個(gè)附加組件，但您可以選擇在第一次選擇該工具時(shí)自動(dòng)安裝它。

 

• XSLT/XQuery

XSLT轉(zhuǎn)換和調(diào)試

用于XSLT轉(zhuǎn)換和調(diào)試的Saxon內(nèi)置XSLT處理器已更新為10.6版。Saxon 10版本目前被認(rèn)為是最穩(wěn)定、最可靠的版本。

 

 

XQuery轉(zhuǎn)換和調(diào)試

將用于XQuery轉(zhuǎn)換和調(diào)試的Saxon XQuery處理器更新為10.6版。

 

在編譯XSLT for Saxon工具中添加了新選項(xiàng)

在Compile XSLT Stylesheet for Saxon對(duì)話框中添加了一個(gè)新選項(xiàng)，允許您為不固定的元素名稱設(shè)置默認(rèn)名稱空間。它可以用來(lái)控制-ns (uri|##any|##html5) Saxon參數(shù)，該參數(shù)定義了對(duì)在路徑表達(dá)式和樣式表中作為名稱測(cè)試和匹配模式出現(xiàn)的不固定元素名稱的處理。

 

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

有一個(gè)新的Saxon transformer附加組件，它增加了對(duì)Saxon transformer 11.2版的支持。這允許您使用Saxon 11.2引擎驗(yàn)證和轉(zhuǎn)換XSLT和XQuery文檔。

 

將Saxon 10 XSLT和XQuery Transformer附加組件更新到10.7版

Saxon 10 transformer附加組件更新為10.7版。這允許您使用Saxon 10.7引擎驗(yàn)證和轉(zhuǎn)換XSLT和XQuery文檔。

 

• 標(biāo)記

增加了對(duì)下劃線內(nèi)容的支持

標(biāo)記編輯器現(xiàn)在支持用于給內(nèi)容加下劃線的++abc++語(yǔ)法。

 

• 安全

刪除了Apache Log4j依賴項(xiàng)

刪除了對(duì)Apache Log4j的依賴，以幫助防止安全漏洞?，F(xiàn)在使用的是SLF4j API和Logback庫(kù)。

 

• 附加組件

有多種Oxygen附加組件可以擴(kuò)展應(yīng)用程序的功能。許多現(xiàn)有的附加組件都得到了更新和改進(jìn)，同時(shí)還提供了一個(gè)新的智能自動(dòng)完成實(shí)驗(yàn)附加組件，可以通過(guò)提供文本補(bǔ)全來(lái)幫助作者創(chuàng)建內(nèi)容。

 

智能自動(dòng)完成插件（實(shí)驗(yàn)版）推出

一個(gè)新的智能自動(dòng)完成實(shí)驗(yàn)插件可以幫助作者通過(guò)提供文本補(bǔ)全來(lái)創(chuàng)建內(nèi)容。一旦安裝了附加組件，側(cè)視圖將可用，您可以在其中訪問(wèn)其功能。您可以在內(nèi)置引擎或OpenAI引擎之間進(jìn)行選擇，以生成文本完成建議。內(nèi)置引擎分析項(xiàng)目中的所有XML、HTML或標(biāo)記文件，然后在編輯項(xiàng)目中的文本內(nèi)容時(shí)提供完成建議。OpenAI引擎提供了使用OpenAI公司提供的語(yǔ)言模型的能力。該引擎不僅提供文本完成建議，還提供各種可配置操作，可用于在編輯器中轉(zhuǎn)換所選文本，并允許您使用稱為微調(diào)的過(guò)程創(chuàng)建自己的語(yǔ)言模型。一些可用于轉(zhuǎn)換所選文本的操作示例包括語(yǔ)法更正、釋義、將內(nèi)容翻譯成其他語(yǔ)言、添加標(biāo)記、創(chuàng)建有序列表等等。

 

 

改進(jìn)了附加文檔結(jié)構(gòu)

官方Oxygen存儲(chǔ)庫(kù)中的所有附加組件現(xiàn)在都在用戶指南（附加組件章節(jié)）中進(jìn)行了分類，以便更容易找到您想要閱讀的附加組件類型。

 

添加了快速安裝按鈕

所有附加組件都有一種新的更簡(jiǎn)單的安裝方法。用戶指南主題現(xiàn)在在快速安裝部分有一個(gè)新的安裝按鈕，可以簡(jiǎn)單地將其拖放到Oxygen中的主編輯器中，以啟動(dòng)安裝過(guò)程。

 

Git客戶端改進(jìn)

Git客戶端插件進(jìn)行了各種改進(jìn)：

• 歷史視圖現(xiàn)在包括一個(gè)新的修訂圖，幫助您了解提交如何相互連接。
• 隱藏對(duì)話框現(xiàn)在有一列，顯示每個(gè)隱藏的創(chuàng)建時(shí)間。
• 歷史視圖的上下文菜單中添加了一個(gè)新的簽出操作。它在特定提交時(shí)簽出一個(gè)分支（以分離頭形式或在該提交時(shí)創(chuàng)建一個(gè)新分支）。
• Git Staging view工具欄經(jīng)過(guò)簡(jiǎn)化，只顯示最常見的操作，而所有操作都可以在新的省略號(hào)（三個(gè)垂直點(diǎn)）菜單中輕松訪問(wèn)。此菜單還包括一些新操作。例如，您現(xiàn)在可以管理遠(yuǎn)程存儲(chǔ)庫(kù)（添加、編輯或刪除），跟蹤當(dāng)前分支的遠(yuǎn)程分支，或編輯存儲(chǔ)庫(kù)的配置文件。大多數(shù)操作也可以在主菜單欄中添加的新Git菜單中使用。
• 通過(guò)優(yōu)化檢查存儲(chǔ)庫(kù)狀態(tài)的過(guò)程，提高了性能。
• 集成了各種錯(cuò)誤修復(fù)、組件更新和性能增強(qiáng)。

 

 

批處理文檔轉(zhuǎn)換器的改進(jìn)

對(duì)Batch Documents Converter附加組件進(jìn)行了各種改進(jìn)：

• 現(xiàn)在，您可以將從Atlassian Confluence導(dǎo)出的HTML文檔轉(zhuǎn)換為DITA。
• 現(xiàn)在，您可以將一個(gè)或多個(gè)DocBook文檔轉(zhuǎn)換為DITA，并且可以使用名為“從包含多個(gè)部分的DocBook文檔創(chuàng)建DITA映射”的選項(xiàng)，將所有部分轉(zhuǎn)換為單獨(dú)的DITA主題，并在新的DITA映射中引用。
• 添加了一個(gè)新的preferences頁(yè)面，為特定類型的轉(zhuǎn)換配置元素之間的映射提供選項(xiàng)。例如，當(dāng)從Word轉(zhuǎn)換為XHTML、DITA或DocBook時(shí)，可以使用Word樣式映射選項(xiàng)自定義Word元素和樣式到相應(yīng)HTML元素之間的映射。
• 在將標(biāo)記文檔轉(zhuǎn)換為DITA時(shí)，可以更好地處理包含單元格跨度的表。
• 各種小錯(cuò)誤修復(fù)和轉(zhuǎn)換改進(jìn)。

 

 

OpenAPI Tester附加組件改進(jìn)

OpenAPI Tester插件已更新至1.1版，其改進(jìn)包括：

• 您現(xiàn)在可以使用測(cè)試工具來(lái)測(cè)試以YAML格式以及JSON格式表示的OpenAPI文檔。
• 增加了對(duì)OpenAPI 3.1.0規(guī)范的基本支持（Webhook除外）。
• 景觀布局得到改善。
• 各種錯(cuò)誤修復(fù)和改進(jìn)。

 

DITA Prolog更新程序附加組件的改進(jìn)

對(duì)DITA Prolog Updater插件進(jìn)行了各種改進(jìn)：

• 添加了一個(gè)新選項(xiàng)，用于控制從附加選項(xiàng)首選項(xiàng)頁(yè)面（在全局選項(xiàng)或項(xiàng)目級(jí)選項(xiàng)中）存儲(chǔ)選項(xiàng)的位置。
• 修復(fù)了prolog元素被插入不允許的文檔中的問(wèn)題。

 

XSpec Helper視圖附加組件現(xiàn)在捆綁了XSpec 2.2.4

XSpec Helper視圖加載項(xiàng)已更新為包含XSpec 2.2.4版。

 

• 其他

用于控制“作者視覺編輯”模式中跟蹤更改的初始視圖模式的新設(shè)置

在Preferences->Editor/Edit Modes/Author/Review Preferences頁(yè)面中添加了一個(gè)新的初始顯示模式設(shè)置，以控制在Author可視化編輯模式中跟蹤更改的初始顯示模式。

 

以PDF格式返回搜索結(jié)果的新選項(xiàng)

在“首選項(xiàng)->打開/查找資源首選項(xiàng)”頁(yè)面中添加了一個(gè)新的“包含這些二進(jìn)制文件的內(nèi)容”選項(xiàng)，如果PDF包含搜索文本，它將以PDF格式返回“打開/查找資源”對(duì)話框/視圖中的搜索結(jié)果。

 

• 組件更新

DITA開放工具包3.7.0版

將與Oxygen捆綁的DITA Open Toolkit版本更新為3.7.0版。

 

macOS 12 (Monterey)

Oxygen已經(jīng)在macOS 12 (Monterey)上進(jìn)行了全面測(cè)試，目前已得到官方支持。

 

OpenJDK 17.0.2

一些安裝工具包將OpenJDK捆綁為Java運(yùn)行時(shí)環(huán)境，并將其更新為17.0.2版。

 

Jackson 2.12.6

將第三方Jackson庫(kù)更新為2.12.6版，以修復(fù)安全漏洞。

 

Xerces 2.12.2

將Xerces庫(kù)更新為2.12.2版。

 

XSpec 2.2.4

將內(nèi)置XSpec框架更新為2.2.4版。

 

對(duì)eXist db 6.0.1版的官方支持

Oxygen已經(jīng)過(guò)測(cè)試，正式支持eXist db 6.0.1版。

 

Calabash XProc 1.3.2-100

將Calabash引擎更新為1.3.2-100版。捆綁的Calabash XProc引擎現(xiàn)在與Saxon 10庫(kù)集成。

 

Eclipse 4.22

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

 

• 腳本編寫

Oxygen的all Platform發(fā)行版與腳本子文件夾捆綁在一起，其中包含用于從命令行界面自動(dòng)化和運(yùn)行各種實(shí)用程序的腳本。要運(yùn)行這些腳本，您需要購(gòu)買腳本許可證。

 

本次發(fā)布的主要關(guān)注點(diǎn)是對(duì)批處理轉(zhuǎn)換器腳本的各種添加和改進(jìn)。

 

為批處理轉(zhuǎn)換器腳本使用自定義設(shè)置文件

使用批處理轉(zhuǎn)換器腳本時(shí)，可以使用新參數(shù)（-cs converterSettingsFile）指定包含轉(zhuǎn)換設(shè)置的文件。這可能是一個(gè)錯(cuò)誤。包含項(xiàng)目選項(xiàng)的xpr文件或包含全局選項(xiàng)的XML文件。

 

批處理轉(zhuǎn)換器腳本現(xiàn)在可以選擇DocBook到DITA的轉(zhuǎn)換

現(xiàn)在可以使用批處理轉(zhuǎn)換器腳本將從DocBook導(dǎo)出的HTML文檔轉(zhuǎn)換為DITA。

 

批處理轉(zhuǎn)換器腳本現(xiàn)在可以選擇Confluence到DITA轉(zhuǎn)換

現(xiàn)在可以使用批處理轉(zhuǎn)換器腳本將從Atlassian Confluence導(dǎo)出的HTML文檔轉(zhuǎn)換為DITA。

 

批處理轉(zhuǎn)換器腳本——其他改進(jìn)

對(duì)Batch Converter腳本的其他改進(jìn)包括：

• 在將標(biāo)記文檔轉(zhuǎn)換為DITA時(shí)，可以更好地處理包含單元格跨度的表格。
• 各種小錯(cuò)誤修復(fù)和轉(zhuǎn)換改進(jìn)。