使用原生PDF引擎v2

最後更新： 2026年6月17日

建立對象：

新發佈引擎 原生PDF引擎v2 是以升級的PDF產生架構為基礎，並包含字型處理、CSS處理和轉譯行為的變更。

因此，使用新發佈引擎產生的PDF輸出可能會與使用現有PDF引擎產生的輸出不同（原生PDF引擎v1）。在文字版面、間距、樣式、影像演算和註腳格式設定等區域中，可能會顯示差異。

例如，原生PDF引擎v2支援OpenType字型，而原生PDF引擎v1主要依賴TrueType字型。類似的彩現增強功能可能會影響所產生PDF的整體外觀。

如需如何在您的環境中啟用原生PDF引擎v2的詳細資訊，請檢視為原生PDF設定新的發佈引擎。

建議新發佈引擎的CSS更新

如果您想要還原使用原生PDF引擎v2時原生PDF引擎v1產生的PDF輸出外觀，您可能需要更新自訂CSS。底下所述的建議CSS變更有助於在啟用新設定後維持輸出一致性。

說明

建議的CSS更新

縮放的影像可能會因為影像演算行為中的變更而呈現不同的外觀。

若要還原影像演算行為，請新增：

image-rendering: pixelated

目錄導線(TOC)對齊方式可能會因為導線的演算行為發生變更而顯示稍有不同。

若要恢復目錄導線對齊，請調整自訂樣式表中目錄導線元素的樣式。所需的CSS變更可能會因您的目錄版面配置和格式而異。

由於字型演算和字元版面配置處理的變更，文字間距和繞線可能會有所不同。

如果您的樣式表使用sans-serif字型系列或顯示間距差異的字型，請新增：

-ro-glyph-layout-mode: quality;

由於預設註腳樣式的變更，註腳參照可能不會再顯示為上標標籤。

若要還原上標樣式的註腳標籤，請新增：

.fn::footnote-marker
{ content: counter(footnote) " ";
vertical-align: super;
font-size: 65%;}

由於底線位置的變更，底線文字與底線之間的間距可能會增加。

若要還原底線位置，請使用text-underline-offset屬性，並視需要調整位移值。例如：

text-decoration: underline;
text-underline-offset: -0.1em;

清單標籤和清單專案文字之間的間距可能會因為清單演算行為的變更而有所不同。

若要恢復間距，請增加清單專案的左內距。例如：

.step {
margin-top: 0.3rem;
margin-bottom: 0.5rem;
padding-left: calc(1.5rem + 1ch);}

標題前的間距可能會因為邊界收合行為的變更而有所不同。

若要恢復間距，請檢閱相鄰元素的邊界，並視需要減少或移除重疊的上邊界和下邊界。例如：

h1.chapter {
margin-top: 0;
}
chaptoc-body { margin-bottom: 0;
}

由CSS產生的核取記號標籤可能會以不同的大小或樣式出現，因為它們會使用不同的遞補字型來呈現。

若要一致地呈現標籤，請使用包含兩個字元的字型系列。例如：

::marker {
font-family: -ro-symbols !important;}

CSS產生的圓形清單標籤可能會因為標籤定位行為的變更而出現部分裁剪或截斷。

若要恢復圓形清單標籤的外觀，請避免使用標籤的絕對定位。如果需要絕對定位，請明確指定適當的top值，以正確定位標籤。

當清單專案使用position: relative等定位樣式時，PDF/UA輸出中的清單專案讀取順序可能會有所不同。

若要讓閱讀順序更密切地遵循來原始檔結構，請套用下列CSS屬性至清單專案：

li {
-ro-paint-reordering: avoid;}

使用原生PDF引擎v2時，下列因應措施可協助解決產生PDF輸出中的已知問題。

套用至資料表內容的text-decoration css屬性沒有在PDF輸出中轉譯。

因應措施：將文字裝飾屬性套用至表格內容中的span元素，而非直接套用至表格元素。
-ro-colorbar-top-left和-ro-colorbar-top-right CSS屬性不會影響PDF輸出中的色彩列。

因應措施：從mergedHTML.json中的使用者樣式表中移除對應的值，或將!important新增至檔案CSS中的屬性值，以便使用者樣式表不會覆寫這些值。
當頁面寬度受限時，色列可能會合併出現，因為色列沒有隨著PDF輸出中的頁面大小縮減。

因應措施：在頁面的不同側邊顯示灰色和彩色列，或是調整色列設定，使它們在較小的頁面寬度上不會重疊。

使用 原生PDF引擎v1 產生的PDF輸出中的下列問題已在 原生PDF引擎v2 中修正：

recommendation-more-help

experience-manager-guides-help-product-guide