ページラベル（Page labels）

ページラベルは、PDFビューアアプリケーションでユーザーに対してページ番号をどのように表示するかを定義する、PDFのオプション機能です。PDFドキュメントが技術的な操作のために使用する内部的な物理ページ番号（0から開始）とは異なり、ページラベルを使用することで、ドキュメントの論理構造に合わせて、ローマ数字（i、ii、iii）、10進数（1、2、3）、またはカスタムテキストプレフィックス（A-1、Chapter 1など）のような書式付きページ識別子を表示できます。 ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) で規定されているように、ページラベルは純粋に表示上のものであり、基礎となるページツリー構造や内部ページ参照には影響しません。

ページラベルは、PDFドキュメントのカタログ辞書内のPageLabelsエントリを通じて定義されます。このエントリには、ページインデックスをラベル辞書にマッピングする数値ツリーが含まれています。各ラベル辞書は、番号付けスタイル（10進数、ローマ数字、文字）、オプションのプレフィックス文字列、および開始値を指定します。このメカニズムにより、ドキュメントの異なるセクションで異なる番号付けスキームを使用できます。例えば、前付け部分では小文字のローマ数字（i、ii、iii）を使用し、本文では算用数字（1、2、3）を使用し、付録ではプレフィックス付きの文字（A-1、A-2）を使用するといったことが可能です。

ページラベルは、技術的な識別子ではなく説明的でユーザー向けのものである点で、物理ページインデックスとは異なります。物理ページインデックスは、PDFがナビゲーションと構造のために内部的に使用する0ベースの連続した整数であり、一方でページラベルは非連続的、非数値的であり、ドキュメントの規則に従って書式設定できます。明示的なページラベルを持たないドキュメントは、ほとんどのPDFビューアで通常1から始まる単純な連続番号を表示します。

PDF生成または操作を行う開発者にとって、ページラベルを正しく実装することは、ユーザーの期待と出版標準に合致したプロフェッショナルなドキュメントを作成するために不可欠です。ユーザーは表示されるページ番号を使用してドキュメントをナビゲートするため、表示されるページラベルと実際のコンテンツの不一致は、混乱とアクセシビリティの問題を引き起こす可能性があります。これは、異なるセクションが異なる番号付け規則に従う書籍、レポート、法的文書などの複雑なドキュメントで特に重要です。

ページラベルはアクセシビリティにも影響します。スクリーンリーダーや支援技術は、ユーザーがドキュメント内の特定の場所をナビゲートおよび参照するのを支援するために、正確なページラベリングに依存しています。PDF/UA準拠のアクセシブルなドキュメントを実装する際、適切なページラベルは障害を持つユーザーの全体的な使いやすさに貢献します。さらに、ページラベルはドキュメントの相互運用性にも影響します。PDFをマージまたは分割する際に、ページラベルを保持または再計算することで、結果のドキュメントが論理的なページ番号付けを維持することが保証されます。

ページラベルは、ドキュメントカタログのPageLabelsエントリに格納される数値ツリー構造を通じて実装されます。数値ツリーは、ページインデックス（0から開始）を、その時点から次のラベル辞書が現れるまでのページのラベル付け方法を定義するページラベル辞書にマッピングします。

各ページラベル辞書には、以下の主要なエントリを含めることができます：

• Type（オプション）：存在する場合はPageLabelでなければなりません
• S（スタイル）：番号付けスタイルを定義します—10進算用数字の場合はD、小文字ローマ数字の場合はr、大文字ローマ数字の場合はR、小文字英字の場合はa、大文字英字の場合はA、または番号付けなしの場合は省略
• P（プレフィックス）：ページ番号の前に付加されるオプションのテキスト文字列（例：「Chapter 」、「A-」）
• St（開始）：番号付けシーケンスの開始値を指定する整数（デフォルトは1）

例えば、あるドキュメントでは、ページインデックス0（小文字ローマ数字を使用するページi、ii、iii）、ページインデックス3（10進数を使用するページ1、2、3）、ページインデックス10（プレフィックス付きのページA-1、A-2）でページラベル辞書を定義する場合があります。PDFビューアはこれらの辞書を解釈して、ユーザーインターフェイス、ナビゲーションパネル、およびページ番号表示で適切な書式付きページラベルを表示します。

プログラムでPDFを作成または変更する際、開発者は、ページラベル範囲が正しく定義されていること、およびページを追加、削除、または並べ替える操作がPageLabels数値ツリーを適切に更新して、ドキュメント全体で正確なページラベリングを維持することを保証する必要があります。

• ページツリー（Page tree） – ドキュメント内のすべてのページを整理およびインデックス化するPDFの階層構造
• ドキュメントカタログ（Document catalog） – ページラベルを含む主要なドキュメント構造への参照を含むPDFドキュメントのルートオブジェクト
• 数値ツリー（Number tree） – 整数をオブジェクトに効率的にマッピングするためにPDFで使用されるデータ構造で、ページラベルやその他の機能に使用されます
• 物理ページインデックス（Physical page index） – PDFの内部ページツリー構造におけるページの0ベースの連続位置
• PDF/UA – 適切なページラベリングを含む適切な構造要素を必要とする、アクセシブルなPDFドキュメントのISO規格