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

 

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

 

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

 

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

 

• DITA創(chuàng)作

移動并重命名非DITA資源

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

 

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

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

 

• DITA發(fā)布

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

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

 

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

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

 

用鏈接替換媒體

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

 

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

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

 

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

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

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

 

 

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

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

 

 

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

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

 

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

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

 

提取定義

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

 

進(jìn)入定義

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

 

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

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

 

• JSON工具

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

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

 

 

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

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

 

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

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

 

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

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

 

• OpenAPI

OpenAPI測試工具

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

 

 

OpenAPI文檔生成器

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

 

• 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工具中添加了新選項

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

 

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

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

 

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

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

 

• 標(biāo)記

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

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

 

• 安全

刪除了Apache Log4j依賴項

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

 

• 附加組件

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

 

智能自動完成插件（實驗版）推出

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

 

 

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

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

 

添加了快速安裝按鈕

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

 

Git客戶端改進(jìn)

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

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

 

 

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

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

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

 

 

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

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

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

 

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

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

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

 

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

XSpec Helper視圖加載項已更新為包含XSpec 2.2.4版。

 

• 其他

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

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

 

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

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

 

• 組件更新

DITA開放工具包3.7.0版

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

 

macOS 12 (Monterey)

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

 

OpenJDK 17.0.2

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

 

Jackson 2.12.6

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

 

Xerces 2.12.2

將Xerces庫更新為2.12.2版。

 

XSpec 2.2.4

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

 

對eXist db 6.0.1版的官方支持

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

 

Calabash XProc 1.3.2-100

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

 

Eclipse 4.22

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

 

• 腳本編寫

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

 

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

 

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

使用批處理轉(zhuǎn)換器腳本時，可以使用新參數(shù)（-cs converterSettingsFile）指定包含轉(zhuǎn)換設(shè)置的文件。這可能是一個錯誤。包含項目選項的xpr文件或包含全局選項的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)

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

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