Comment

PDFにおけるコメント（comment）は、パーセント記号（%）で始まり行末まで続く構文要素であり、開発者が人間可読なメモを含めたり、ドキュメントの解析に影響を与えることなくPDFコードの一部を無効化したりすることを可能にします。コメントはPDFプロセッサによって無視され、ファイル構造内のドキュメント化メカニズムとして機能します ( 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構文の基礎であり、PDFバージョンを識別するヘッダーを含め、PDFファイル全体に現れます。

コメントは、パーセント文字（%）で始まり、改行文字（キャリッジリターンまたはラインフィード）に遭遇するまで続くPDF構文における字句トークンです。%記号から行末までのすべてはコメントテキストとして扱われ、ドキュメント処理中にPDFパーサーによって無視されます ( 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要素とは異なります。つまり、生のPDFファイルを検査する人間の読者のためだけに存在します。実際のドキュメントを定義するコンテンツストリームやドキュメントオブジェクトとは異なり、コメントは解析中に除去され、レンダリング、構造、機能性に影響を与えません。PDFオブジェクト間で情報を伝達したり、ドキュメントの動作に影響を与えたりするために使用することはできません。

すべてのPDFファイルで最も認識しやすいコメントはヘッダー行（例：%PDF-2.0）です。これは外見上コメントですが、ファイルをPDFとして識別し、そのバージョン番号を宣言するという重要な機能を果たします。

コメントは、PDF構文を直接扱う開発者にとって、いくつかの実用的な理由から貴重なツールです：

ドキュメント化とデバッグ：プログラムでPDFを生成する場合やPDF構造を検査する場合、コメントによって開発者はコードに注釈を付け、複雑なオブジェクトの関係を説明したり、特定の構造が特定の方法で実装された理由についてメモを残したりできます。

バージョン管理とコラボレーション：コメントは、PDF生成アプリケーションの変更をレビューしたり問題をトラブルシューティングしたりする際に、開発チームがPDF生成ロジックを理解するのに役立ちます。

バイナリデータのトラブルシューティング：コメントは、ファイル転送プロトコルがバイナリデータをテキストとして誤解釈して破損させないようにするため、ヘッダーの後に戦略的に配置されることがあります。一部のPDFジェネレーターは、システムにファイルをバイナリとして扱わせるために、ヘッダーの直後に非ASCII文字を含むコメントを追加します。

開発ワークフロー：PDFの生成をテストまたはデバッグする際、開発者はプログラミング言語でコードをコメントアウトするのと同様に、コメントを使用してコードを削除せずにPDF構造の一部を一時的に無効化できます。

PDF仕様では、コメントを明確な解析ルールで定義しています ( 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パーサーが文字列またはストリームの外で%文字に遭遇すると、即座にコメント処理モードに入り、その行の後続のすべての文字を破棄します。処理は次の行の先頭から正常に再開されます。

特殊なケース – PDFヘッダー：すべてのPDFファイルの最初の行は、PDFバージョンを識別するコメントでなければなりません（例：%PDF-2.0）。構文的にはコメントですが、この行は実際にはPDFプロセッサによって解析され、ドキュメントを解釈する際に適用するPDF仕様のバージョンを決定します。

バイナリマーカーコメント：多くのPDFファイルには、ファイル転送システムがファイルをテキストではなくバイナリとして認識するために、先頭近くに高ビット文字を含む2行目のコメント（例：%âãÏÓ）が含まれています。これにより、転送中の潜在的な破損を防ぎます。

制限事項：コメントは複数行にまたがることはできません。コメントが必要な各行は、独自の%文字で始まる必要があります。また、コメントはリテラル文字列内やストリームオブジェクトのバイナリ部分内など、特定のコンテキスト内では使用できません。

• PDF Header – PDFファイルの最初の行で、コメントとして構造化され、ドキュメントをPDFとして識別し、そのバージョンを指定します
• Object – 値、辞書、またはストリームを含むことができるPDFの基本データ構造。PDFドキュメントの基本的な構成要素です
• Stream – stream/endstreamキーワードで囲まれた、コンテンツ、画像、またはその他のデータを表すことができるバイトシーケンス
• Syntax – PDFファイルがどのように構成され、解析されるかを定義する形式的なルールと構造
• Parser – PDF仕様に従ってPDFファイル構造を読み取り、解釈するソフトウェアコンポーネント