ネイティブ PDF エンジン v2の操作

最終更新日： 2026年6月17日

作成対象：

{"id":"b69b2659-1057-424e-8fc5-ed9e016dc554"}

新しい公開エンジン ネイティブ 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値を明示的に指定します。

PDF/UA出力のリスト項目の読み上げ順序は、リスト項目でposition: relativeなどの配置スタイルが使用されている場合に異なる場合があります。

読み上げ順序をソース文書構造に近づけるために、次のCSS プロパティをリスト項目に適用します：

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

既知の問題の回避策

次の回避策は、Native PDF engine v2を使用する場合に生成されたPDF出力の既知の問題に対処するのに役立ちます。

テーブルコンテンツに適用されたtext-decoration個のcss プロパティは、PDF出力ではレンダリングされません。

回避策: テキスト装飾プロパティをテーブル要素に直接適用するのではなく、テーブルコンテンツ内のspan要素に適用します。
-ro-colorbar-top-leftおよび-ro-colorbar-top-rightのCSS プロパティは、PDF出力のカラーバーには影響しません。

回避策：対応する値をmergedHTML.jsonのユーザースタイルシートから削除するか、ドキュメント CSSのプロパティ値に!importantを追加して、ユーザースタイルシートで上書きしないようにします。
PDF出力ではカラーバーがページサイズに合わせて縮小されないため、ページ幅が制約されている場合、カラーバーが結合されて表示される場合があります。

回避策: ページの異なる側面に灰色と色付きのバーを表示するか、カラーバーの設定を調整して、ページ幅が小さいときに重ならないようにします。

新しい公開エンジンの修正済みの問題

Native PDF Engine v1を使用して生成されたPDF出力の次の問題は、Native PDF Engine v2で修正されています。

特定のコンテンツに対してPDFのネイティブ出力を生成する場合、複数のページにまたがるコンテンツ全体が含まれる中間HTMLにもかかわらず、PDFでは最初のページのみがレンダリングされます。（GUIDES-28270）
アクセシビリティ設定が有効になっているNative PDF出力のコンテンツの読み取り順序が正しくありません。フッターのページ番号は、最後ではなくメインコンテンツの前に読み取られます。（GUIDES-27790）
ネイティブPDF出力のカラーバーは、ページ全体の幅に広がらず、ページサイズをカスタマイズすると重なり合い、一部のカラーボックスが非表示になります。（GUIDES-15505）
CSS:is()pseudo-class セレクターはネイティブ PDF出力で尊重されないため、ブラウザーのレンダリングと比較してスタイルの違いが生じます。（GUIDES-11328）

recommendation-more-help

experience-manager-guides-help-product-guide