Oxygen XML Author 25.0 版釋出

Oxygen XML Author 25.0 版通過将其支援擴充到其他語言（如JSON 和 YAML）并能夠把某些檔案類型（Word、Excel、OpenAPI、HTML、Markdown、和其他）作為DITA 相容的資源進行處理，是以可以從 DITA 映射中引用和使用它們，類似于引用和使用 DITA 主題的方式。

使用 DITA 時的性能得到了改進，因為現在通過内容引用和按需擴充的内容可以更快地打開大型 DITA MAP 圖和主題。DITA MAP 驗證工具會自動驗證引用 Relax NG 模式的主題，并且它還會檢測相關連結是否指向目前地圖中未包含的主題。

DITA 釋出受益于性能改進，您可以在 WebHelp 輸出中生成 Google 結構化資料，并且您現在可以在基于 CSS 的 PDF 輸出中生成符合 PDF/A 标準的 PDF。

Git Client、Batch Documents Converter和Terminology Checker插件得到了很多改進，一個新的指令行腳本可用于驗證檔案或目錄，并且像往常一樣，此版本包括新的 API 入口點、各種錯誤修複、群組件更新。

有以下變化：

1. DITA 創作
2. DITA 映射驗證
3. DITA 出版
4. DITA 問題/答案
5. 作者視覺編輯
6. 附加元件

DITA 創作

DITA Maps Manager 中修改後的 Map 會自動儲存

預設情況下，每當進行修改時，在 DITA Maps Manager 中編輯的本地 DITA 映射都會自動儲存。可以取消選擇 DITA → 映射首選項頁面中的 每次修改後自動儲存本地 DITA 映射選項 以禁用此功能。

使用 DITA 相容資源的改進

添加了各種改進以增強您在使用 DITA 映射中引用并動态釋出的 DITA 相容資源 （Word、Excel、OpenAPI、HTML、Markdown）時的體驗：

• 在 DITA Maps Manager 中插入對 DITA 相容資源的主題引用的可能性。
• 每個引用資源的标題都顯示在 DITA Maps Manager 中。
• 在向 DITA 相容文檔中的内容插入主題引用、交叉引用或内容引用時，插入對話框會顯示目标文檔中 DITA 特定 ID 的清單。
• 利用 Validate and Check for Completeness操作，DITA 映射中引用的 DITA 相容文檔現在在背景轉換為 DITA 主題，并與任何其他 DITA 主題一樣進行驗證。
• 在轉換引用了 DITA 相容文檔的 DITA 映射時，轉換會即時将文檔轉換為正常的 DITA 輸出。

按需展開 DITA MAP和主題參考

如果 在作者偏好頁面中沒有選擇 顯示引用的内容選項，當在作者可視化編輯模式下在主編輯器區域打開 DITA MAP 時， 可以通過點選小展開按需展開對主題或子圖的引用按鈕位于包含此類引用的每個元素上。如果選擇 允許編輯引用的内容選項，也可以直接編輯按需擴充的引用主題和子映射圖。

按需展開内容參考

在 作者可視化編輯模式的主編輯器區域中打開主題時，現在可以通過單擊包含此類引用的每個元素上的小擴充按鈕（在主編輯器區域中）按需擴充内容引用和内容鍵引用. 如果未在 作者首選項頁面 中選擇顯示引用的内容選項，則會啟用此功能 。

輕松通路 DITA 名額報告

DITA Maps Manager的工具欄和 DITA Maps菜單中添加了 一個新的 Generate Metrics Report操作 。它生成一個度量報告，其中包含目前 DITA 映射的有用統計資訊（例如映射/主題的數量、内容重用百分比、元素/單詞/字元的數量、處理指令、外部連結等）。

在主題方案圖中定義條件分析屬性組

現在可以通過在主題方案圖中定義條件分析屬性組來貢獻它們。有關更多詳細資訊和示例，請參閱 在主題方案映射中定義條件分析屬性組。

DITA 可重用元件視圖中的新操作使在圖形中插入圖像變得容易

在 DITA Reusable Components 視圖的上下文菜單中，添加了一個新操作（ Insert as Figure），可以在将圖像插入圖形時節省一些步驟。如果選擇的是圖像并且它将所選圖像插入到 <fig>帶有空 <title>元素的圖形元素 ( ) 中，則它可用。

打開 DITA 映射時的性能改進

為在 DITA MAP 管理器中打開大型 DITA MAP 或在編輯器中打開大型地圖并解決了所有引用的主題，實作了各種速度改進。

在 DITA 映射中啟用内聯插入操作

在“作者”模式下編輯 DITA 映射時，“樣式”下拉工具欄菜單 中現在可以使用 新的 内聯插入操作CSS 樣式，這樣可以更輕松地插入新的主題引用。啟用此樣式會在地圖文檔中可以插入新主題引用的位置呈現插入小部件。

編輯 DITA Open Toolkit 項目檔案的改進

為了增強在 Author可視化編輯模式下編輯 DITA Open Toolkit Project 配置檔案時的使用者體驗，所有 包含現在都顯示為就地展開，并且每個傳遞物都有一個 可用于單獨釋出 的播放按鈕。

文本編輯模式中的拖放資源改進

當DITA Maps Manager視圖中 的主題引用 被拖放到以文本編輯模式打開的 DITA 主題中時，現在可以正确插入包含對已删除資源的直接或關鍵引用的特定 DITA 元素。

使用新的就地操作設定注釋類型

當 DITA 主題包含一個 <note>元素時，可以使用位于注釋類型圖示旁邊的就地彈出操作來輕松更改注釋類型。

使用新的就地操作為代碼塊設定文法高亮語言

當 DITA 主題包含 <codeblock>元素時，可以使用就地彈出操作輕松更改或設定 @outputclass代碼塊内容的文法高亮語言（屬性）。

Markdown 文檔的 DITA 預覽更寬松

編輯 Markdown 文檔時，DITA 預覽窗格更加寬松，允許以高标題級别開始或标題級别增加超過一個機關（标題級别跳過一個或多個級别）的文檔。

DITA 映射驗證

報告 DITA 映射中未引用目标主題的相關連結

DITA Maps Manager視圖的 驗證和檢查是否完整操作現在報告在關系表中定義的相關連結，該連結的目标主題在DITA地圖中 未在DITA映射中未引用到DITA MAPS中未引用的主題時，未在DITA地圖中引用。

報告基于 Relax NG 的 DITA 主題的驗證錯誤

即使 未選擇 批量驗證引用的 DITA 資源選項 ， 驗證和檢查完整性操作也已改進，可根據基于 Relax NG 的 DITA 主題中的架構報告驗證錯誤。

DITA 出版

在釋出期間将 OpenAPI 文檔動态轉換為 DITA

動态非 DITA 資源到 DITA 轉換器現在包括在釋出過程中将 OpenAPI 文檔（JSON 或 YAML 格式）轉換為 DITA 的選項 。

生成 GOOGLE DATA 谷歌結構化資料

您可以在 DITA WebHelp 響應式輸出中生成 Google 結構化資料。Google 使用結構化資料來更好地了解頁面内容并在 Google 搜尋中顯示特殊的搜尋結果。有關如何執行此操作的詳細資訊，請參閱 如何生成 Google 結構化資料。

提高釋出速度

從與 Java 17 捆綁的 Oxygen 工具包釋出時，或在使用 Java 9 或更高版本的指令行使用 Oxygen 釋出引擎時，DITA 轉換的速度得到了提高。

新内容類型現在支援代碼塊中的文法亮點

<codeblock>現在，當釋出包含 YAML、 PowerShell、 DTD或 CMD（Windows 樣式指令腳本）内容的 DITA 元素時，文法高亮顯示在輸出中 。

預設驗證現在适用于基于 RNG 的主題和地圖

預設情況下，如果基于 RNG 的主題或地圖根據關聯的模式無效，則釋出引擎現在會報告錯誤。

以作者模式釋出 DITA OT 項目檔案的所有可傳遞成果

當 DITA Open Toolkit 項目檔案以 作者模式打開時，項目檔案名旁邊現在有一個 播放按鈕，可用于釋出檔案中指定的所有可傳遞成果。轉換運作時，按鈕會變成 停止按鈕，以防您需要終止程序。

使文檔符合 PDF/A 标準

對于基于 CSS 的 PDF 轉換，新的 pdf.archiving.mode轉換參數可用于使 PDF 文檔可存檔。可能的值為： PDF/A-1a、 PDF/A-1b、 PDF/A-2a、 PDF/A-2b、 PDF/A-2u、 PDF/A-3a、 PDF/A-3b、 PDF/A -3u。

過濾詞彙表以僅顯示 PDF 輸出中的引用條目

對于基于 CSS 的 PDF 輸出，可以将新 filter.unused.glossentries參數設定為 yes以過濾詞彙表以僅在輸出中顯示引用的詞彙表條目。如果參數設定為 no（預設值），則顯示所有詞彙表條目。

圖像屬性 Scale 中的縮放得到改進

使用圖像映射時， @scale在元素上添加屬性 <imagemap>現在可以縮放 WebHelp 和 PDF 輸出中的圖像及其區域。

DITA 問題/答案

在 DITA 主題中插入意圖問題的新操作

在各種菜單中（在 DITA菜單中的插入子 菜單、上下文菜單和工具欄上的下拉菜單中）提供了 一個名為“ 插入意圖問題”的新操作，它可用于插入 DITA 意圖問題（在序言中部分）。該操作插入一個問題（可能由使用者提出），其答案可在目前主題中找到。

新的問題和答案 DITA 主題類型

您現在可以建立一個名為 Questions and Answers (Relax NG)的新 DITA 主題類型。它對于建立包含多個問題/答案組的常見問題文檔很有用。此類文檔在釋出過程中用于建立 Google 結構化内容中繼資料。

作者視覺編輯

改進了作者模式下的智能編輯

作者模式下 的智能編輯機制 得到了改進，是以當您開始在不允許文本的位置輸入時，

Oxygen 将搜尋接受文本的最接近的适用上下文。

展開 xi:include 按需引用

可以取消選擇“作者首選項”頁面 中 的“顯示引用的内容”選項， 以便通過單擊位于主編輯器區域中包含此類引用的每個元素旁邊的小擴充按鈕來按需擴充xi:includes .

支援“list-style-type”CSS 屬性的自定義值

Author 可視化編輯模式現在為清單項的 CSS 中定義的list-style-type CSS 屬性 呈現自定義字元串值 。

附加元件

Oxygen 提供了多種附加元件，可擴充應用程式的功能。

附加元件的語義版本控制

在 XML 描述符檔案中為插件定義的版本現在可以具有通常的 MAJOR.MINOR.PATCH形式或 語義版本形式（ MAJOR.MINOR.PATCH-PRE_RELEASED_VERSION），使開發人員更容易建立插件為預釋出版本建構。

Git 用戶端改進

對Git 用戶端插件 進行了一些改進 ：

• 在Git 用戶端首選項頁面中添加了一個新的在送出前驗證每個檔案選項。選擇此選項可在每次送出之前自動驗證每個檔案。
• 在Git 用戶端首選項頁面中添加了一個新的Validate all files from the project's "Main Files" 檔案夾，然後再推送選項。選擇此選項可在推送操作過程之前自動驗證位于Main Files 檔案夾中的檔案。
• 內建的 JGit 庫更新到 6.3 版本，帶來了對ssh-agent轉發的支援。

有關 Git 用戶端中添加的更新的完整清單，請參閱 https://github.com/oxygenxml/oxygen-git-plugin/releases。

批處理文檔轉換器改進

對批處理文檔轉換器插件 進行了各種改進 ：

• 您現在可以将使用并符合 OpenAPI 規範（版本 2.0、3.0 或 3.1）的 JSON 或 YAML 檔案轉換為 DITA 文檔，并且可以選擇從 OpenAPI 文檔建立 DITA 映射選項來訓示轉換器拆分将文檔分成在 DITA 映射中引用的單獨主題。
• Word 到 DITA 或 HTML 轉換的改進：通過從基本樣式繼承自定義樣式的樣式配置，改進了 Word 樣式映射配置。Word 文檔中嵌入的 SVG 圖像将保留為 SVG。由圖像和表格書簽生成的 ID 現在可以更好地處理以找到正确的位置。通過使用标題中的文本，改進了主題和部分的 ID 生成。在将 Word 轉換為 DITA 或 HTML 時，通過在轉換過程中保留标題行資訊來改進表的處理。
• 對于 HTML 到 DITA 的轉換：@outputclass通過在 DITA 結果中添加适當的屬性，改進了從 HTML 轉換對象元素。在轉換對話框中添加了一個選項，允許您決定是否<div>忽略元素。
• 對于 Markdown 到 DITA 的轉換，添加了對 Markdown 縮寫的支援。
• 對于 HTML 到 XHTML 的轉換，<pre>阻止了元素的格式化。

術語檢查器改進

術語檢查器附加元件中添加了各種改進：

• XPath 上下文- 您可以為特定定義的規則定義簡單的 XPath 表達式以比對或跳過特定元素。
• 詞性标記- 掃描術語問題時，僅當術語的詞性與定義規則中指定的詞性比對時才會出現問題（僅适用于英語）。
• 階段- 在術語配置檔案中，您可以設定檢測到錯誤術語的階段（編輯/驗證/始終）。檢查檔案時還實作了性能改進。
• 加載其他附加元件提供的術語 - 任何 Oxygen 附加元件（插件）現在都可以貢獻術語檔案以供術語檢查器使用。如果啟用了貢獻者插件，則将加載和使用貢獻的術語檔案。