異なるソースからの PDF の結合は、ファイルが異なる宛先を指す同じ名前のブックマーク、リンク、またはフォーム フィールドを共有するまでは簡単です。 2 つの PDF にそれぞれ「第 1 章」というラベルの付いたブックマークが含まれている場合、または「TOC」と呼ばれる名前付き宛先の場合、マージ操作でどちらが勝つかを決定する必要があります。 PDF 仕様では衝突に対するデフォルトの解決ルールが提供されていないため、動作はマージ ツールの内部ロジックに完全に依存し、その結果は、リンクが黙って上書きされるものから、完全に機能しないナビゲーションに至るまで多岐にわたります。
名前付き宛先は、PDF ブックマーク、ハイパーリンク、相互参照が特定のページにジャンプして表示するために使用する内部アドレス ラベルです。ページの挿入または削除時に変更されるページ番号とは異なり、名前付き宛先は、結合された文書内のどこで終了するかに関係なく、ターゲット コンテンツに固定されたままになります。これがそれらを価値のあるものにし、マージ中にそれらを脆弱にする理由でもあります。同じオーサリング ツールで作成された 2 つのドキュメントは、多くの場合、同じ自動生成された宛先名を使用します。これらの名前が衝突すると、1 つの宛先のみが残ります。宛先がどのように解決されるかを理解することは、信頼性の高いナビゲーションを備えた結合ドキュメントを作成するための第一歩です。
名前付き宛先とは何ですか?また、結合中にそれらが衝突するのはなぜですか?
名前付き宛先は、「Section2」などのテキスト文字列をマップする PDF オブジェクトです。または「fig_4」を使用して、特定のページ、ズーム レベル、そのページ上の位置に移動します。ブックマークはこれらの宛先を使用して、どこにジャンプするかを判断します。内部ハイパーリンクは、ドキュメント内のセクションを相互参照するために使用されます。 PDF ファイルをマージすると、マージ ツールはすべてのソースのすべてのページを 1 つのページ シーケンスにまとめます。また、宛先の名前空間もマージする必要があります。 2 つのソース ドキュメントが両方とも「Intro」という宛先を定義している場合、マージ ツールは解決できない競合に直面します。2 つの異なるページを両方とも同じ名前のターゲットにすることはできません。
PDF 仕様の ISO 32000 によれば、単一の PDF 内の名前付き宛先は一意の名前を持つ必要があります。仕様では、マージ ツールが衝突を解決する方法は定義されておらず、動作は実装定義のままです。 PDF Association による 2024 年の技術レポートでは、商用およびオープンソースの結合ツールで使用される 5 つの異なる衝突解決戦略が文書化されており、すべての衝突シナリオを同じように処理できるツールは 2 つありません (PDF Association、「PDF 結合における相互運用性の課題」、2024 年)。これは、2 つの異なるツールで同じ 2 つのソース ファイルをマージすると、まったく異なるナビゲーション動作を持つドキュメントが生成される可能性があることを意味します。これは、マージが決定的な操作であると考えている多くのユーザーを驚かせる事実です。
衝突の問題はブックマークを超えて広がります。 PDF ファイルには、ドキュメントの外部 (たとえば、特定のセクションにリンクしている Web ページなど) から参照される名前付きの宛先を含めることができます。マージ操作が名前付き宛先をサイレントに上書きまたは削除すると、その宛先への外部リンクが切断されます。ドキュメントがバージョン間で一貫した参照を維持する必要がある規制された業界では、この種のサイレント破損はコンプライアンスに影響を及ぼす可能性があります。
さまざまなマージ ツールが宛先名の競合を処理する方法
一部のツールでは、後続の各ファイルの宛先が、マージ順序内の以前のファイルにある同じ名前の宛先を上書きする、最終書き込み優先ポリシーを適用します。これにより、最初のファイルのブックマークが最後のファイルのページを暗黙的にポイントする、マージされたドキュメントが生成されます。ブックマークのテキストには 1 つのことしか書かれていないのに、宛先がまったく別の場所に移動してしまうため、特に混乱を招く結果になります。他のツールは、first-write-wins ポリシーを適用し、最初のファイルの宛先を保持し、後続のすべてのファイルからの衝突を破棄します。
3 番目のアプローチは、より洗練されたマージ エンジンで使用され、ファイル名またはユーザー指定のラベルから派生した一意の識別子を各ソース ドキュメントの宛先名の前に付ける方法です。これにより、マージされた出力の一意性が保証されますが、接頭辞付きの名前を使用するように更新されない限り、宛先名を知ることに依存していたドキュメント間の相互参照が壊れることも意味します。一部のエンタープライズ文書管理システムでは、このアプローチを使用し、マージ後のスクリプトを実行して、すべての内部参照を新しい接頭辞付きの名前で更新します。
少数の専門的なツールでサポートされているさらに別のアプローチは、マージ中に衝突を検出し、ユーザーにそれぞれを手動で解決するよう促すことです。これにより、ユーザーは完全に制御できるようになりますが、数百もの名前付き宛先を含むドキュメントを結合する場合は非現実的になります。 1 つの技術マニュアルには、数千の自動生成された宛先名が簡単に含まれる可能性があり、それぞれの衝突を手動で解決するのは現実的ではありません。大きなドキュメントの場合、予測可能なプレフィックス スキームを使用した自動名前変更が唯一の実用的な解決策です。
マージ前に衝突を防ぐ方法
宛先の衝突を回避する最も確実な方法は、マージする前に宛先の名前を変更することです。各ソースドキュメントの宛先が固有のプレフィックスまたは命名規則を使用している場合、ドキュメントが結合された場合でも、2 つの宛先が同じ名前を共有することはありません。一部の PDF エディタでは、ブックマークとそれに関連付けられた宛先の名前を一括変更できます。これは、結合する前に体系的に行う必要があります。各ソースドキュメントに「r1_」などの短いプレフィックスを割り当てます。最初のレポートの場合は「r2_」です。 2 番目の場合は、各ドキュメント内のすべてのブックマークと名前付き宛先の名前を変更して、そのプレフィックスを含めます。
Microsoft Word、Adobe InDesign、LaTeX プロセッサなどのオーサリング ツールから PDF を生成する場合は、自動生成されたブックマーク名ではなく、わかりやすい一意のブックマーク名を使用するようにツールの PDF エクスポート設定を構成します。 Word では、見出しテキストがデフォルトでブックマーク名になります。これは通常、文書全体で十分に一意です。 LaTeX では、hyperref パッケージを使用すると、texorpdfstring コマンドを使用してカスタム PDF ブックマーク 名を設定できるため、結合されたナビゲーション ツリーに表示される内容を完全に制御できます。
サーバー側ライブラリによって生成された PDF レポートなど、プログラムで生成されたドキュメントの場合は、生成時にすべての宛先名に一意のドキュメント ID を含めます。 「sales_fig_2025Q3」という名前の宛先「figure1」という名前の宛先よりも衝突する可能性ははるかに低くなります。わかりやすい名前を使用するという小さな労力により、マージ後のデバッグの労力が大幅に節約されます。
リンクがすでに間違ったページを指している場合のマージを修正する
すでに PDF を結合していて、ブックマークまたは PDF リンク が間違ったページを指していることに気付いた場合、最初のステップは問題の範囲を診断することです。マージされたファイルを開き、ブックマーク パネルを使用してすべてのトップレベルのブックマークをテストします。どのものが間違った場所にジャンプするかに注意してください。通常、失敗のパターンによって、マージ ツールが衝突をどのように処理したかが明らかになります。最初のファイルのすべてのブックマークが正しく機能し、後続のファイルのすべてのブックマークが壊れている場合、ツールは先書き込み優先ポリシーを使用しており、後続のファイルは最初のファイルと宛先の衝突を起こしています。
ツールがサポートしている場合は、「宛先の置換」を使用してください。または「目的地を設定」壊れたブックマークをそれぞれ正しいページとビューに再割り当てする機能。これは、各ブックマークのプロパティ ダイアログを開き、目的のターゲット ページに移動し、現在のビューを新しい保存先として設定する手動プロセスです。壊れたリンクが少数あるドキュメントの場合、これが最も早い修正です。数百ものリンク切れのあるドキュメントの場合は、マージ前のソース ファイルに戻り、一意の接頭辞を付けて宛先の名前を変更し、マージをやり直す必要がある場合があります。
有用な診断手法は、マージの前後にブックマーク リストをテキスト ファイルとしてエクスポートすることです。 2 つのエクスポートを比較すると、どのブックマークが削除されたか、名前が変更されたか、リダイレクトされたかが正確にわかります。これにより、正確な修正リストが得られ、壊れたブックマークが数週間または数か月後に読者から報告されるまで気付かれないという状況を防ぎます。
問題のあるマージ後のブックマーク ツリーの再構築
マージされたドキュメントのブックマーク ツリーがリンクごとに修復できないほど破損している場合は、最初からブックマーク ツリーを再構築するのが最も効率的です。多くの PDF エディタでは、ページ上のテキストを選択し、ブックマークのターゲットとして指定することでブックマークを作成できます。結合されたドキュメントを順番に処理し、セクションおよびサブセクションごとに新しいブックマークを作成します。非常に長い文書の場合は、エディターがテキスト パターンまたは見出しスタイルからのブックマークの自動生成をサポートしているかどうかを確認してください。一部のツールでは、PDF をスキャンして特定のフォントとサイズでフォーマットされたテキストを探し、各インスタンスからブックマークを作成できます。これにより、目次構造を数時間ではなく数分で再構築できます。
WukongPDF は、各ソース ドキュメントの内部名に一意の識別子を自動的にプレフィックスとして付けることで、マージ中の宛先の競合を処理します。そのため、結合するドキュメントの数に関係なく、各元のファイルからのナビゲーションはそのまま残ります。マージされた出力では、各ソース ドキュメントの構造を反映するクリーンなブックマーク階層が維持され、リンクがサイレントに上書きされることはありません。
マージ操作後のナビゲーションのテスト
マージ後、すべてのトップレベルのブックマークと第 2 レベルのブックマークのランダムなサンプルをテストして、正しいページに移動することを確認します。ドキュメント内の相互参照リンク (「12 ページを参照」など) を確認してください。または「付録 B を参照」マージによってページ番号が変更された後も、それらが依然として正しい場所を指していることを確認します。マージされたドキュメントが外部に配布される場合、このテスト手順はオプションではありません。マージ後の簡単なナビゲーション テストにより、エラーがリーダーに届く前にエラーが検出され、ファイルの存続期間中ドキュメントの内部リンクの信頼性が維持されることが保証されます。マージごとに 2 分かけてテストすると、後で何時間も混乱することがなくなります。