PDF Geckoの検証方法とサンプルPDF

このサンプルで確認できること

検証用PDFは2ページ構成で、PDFの「見た目」だけでは分からない機能を確認できるように作成しています。個人情報や第三者の著作物は含みません。ビルド時にpdf-libで再生成できるよう、生成スクリプトもリポジトリで管理しています。

確認対象	サンプル内の目印	確認方法
文字選択・コピー	Selectable text	文章をドラッグしてコピーできるか
文字検索	GECKO-SEARCH-2026	PDFビューアの検索で一致するか
リンク	https://pdf-gecko.net/	クリック可能なリンク注釈として残っているか
フォーム	TYPE-HERE	入力可能なフォーム部品として操作できるか
細線・小文字	0.2pt線・6pt文字	画像化後に潰れたり読みにくくなっていないか
高コントラスト細部	Detail marker	JPEG再生成後の輪郭や細部を比較する
ページ順	SECOND-PAGE	結合・保存後の順番を確認する

2026年9月12日の自動実測結果

GitHub ActionsのUbuntu環境でPR版をビルドし、Chromiumを使ってPDF Geckoの画面を実際に操作しました。生成されたPDFは別処理で開き直し、ページ数、検索可能文字、リンク注釈、フォーム部品を再解析しています。

テスト	入力	出力	確認できたこと
文字追加→保存	8,133 bytes / 2ページ	12,773 bytes / 2ページ	追加した「PDF-GECKO-E2E-2026」を文字として再検出。元の検索文字も残った。一方、元PDFのリンク注釈とフォーム部品は0件になった。
同じPDFを2部結合→保存	8,133 bytes × 2	24,081 bytes / 4ページ	4ページになり、検索文字は残った。一方、リンク注釈とフォーム部品は0件になった。
標準圧縮→保存	8,133 bytes / 2ページ	112,724 bytes / 2ページ	解像度1.4、画質0.75。検索文字・リンク注釈・フォーム部品はいずれも残らず、容量は約13.86倍（+1,286%）に増えた。

この結果は「圧縮すれば必ず小さくなる」わけではないことを示します。 今回の入力は8KB程度の軽量な文字・ベクター中心PDFだったため、各ページをJPEG画像へ変換するPDF Geckoの方式では逆に大きくなりました。写真・スキャン中心の大容量PDFでは結果が変わるため、固定の削減率は案内しません。

圧縮を検証する手順

検証用PDFを保存します。
元PDFで「GECKO-SEARCH-2026」を検索し、URLリンクとフォーム入力欄が操作できることを確認します。
PDF圧縮を開き、検証用PDFを読み込みます。
圧縮版を元PDFとは別名で保存します。
圧縮版を開き、ファイルサイズ、見た目、文字検索、リンク、フォームの状態を元PDFと比較します。

PDF Geckoの現在の圧縮実装はページをJPEG画像として再生成するため、圧縮版では文字選択・検索・フォーム・リンクが保持されない設計です。さらに、入力PDFによってはファイルサイズが増えるため、保存後の容量確認までを圧縮作業の一部としてください。

結合・ページ編集を検証する手順

検証用PDFを2部用意するか、別のPDFと一緒にPDF結合へ読み込みます。
ページ一覧で順番を変更し、必要に応じて回転・削除を行います。
保存後にページ数と「SECOND-PAGE」の位置を確認します。
フォームやリンクが必要な用途では、保存後にも同じ機能が残っているかを別途確認します。

ガイドを書くときの判断基準

実装で確認できる仕様と、実際のPDFで確認した結果を分けて記載します。
未確認の挙動を「対応している」と断定しません。
容量削減率や処理時間など、ファイルごとに変わる数値は実測条件なしで掲載しません。
期待と逆の結果も削除せず公開します。
制限事項はユーザーが作業前に判断できる位置へ記載します。
重要書類では元PDFを残し、保存後のPDFを開き直して確認する手順を案内します。

検証用PDFの仕様

ファイル: pdf-gecko-verification-sample.pdf
ページ数: 2ページ
基準サイズ: 2026-09-12の生成結果で8,133 bytes
内容: 選択可能な文字、検索用キーワード、URLリンク、入力フォーム、細線、小さい文字、高コントラスト細部マーカー、ページ順確認用マーカー
用途: PDF Geckoの編集・結合・圧縮・ページ操作の再現確認