ソフトウェアのバグ (エラー メッセージ、スタック トレース、構成画面、ログ ファイル) を文書化する 20 枚のスクリーンショットを撮ります。各スクリーンショットはフォルダー内にある個別の PNG ファイルであり、キャプチャした順序で名前が付けられます。 20 枚すべてを 1 つの整理されたドキュメントとして開発チームに送信する必要があります。各スクリーンショットはそれぞれのページに正しい順序で表示され、開発者がどの画像がどのステップに対応するのかがわかるようにファイル名が表示されます。
一連のスクリーンショットを Image to PDF ドキュメントに変換すると、それらが 1 つのファイルにパッケージ化され、個別の画像のフォルダーよりも共有、開いたり、スクロールしたりするのが簡単になります。 PDF 形式ではシーケンスが保持され、ページ番号が追加され、各スクリーンショットが最大解像度で表示されます。
変換前のスクリーンショットの準備
変換する前に、スクリーンショットを整理してください。ファイルの名前を変更して、先頭にゼロを付けたシーケンス番号を含めます: step-01-login-error.png、step-02-config-page.png、step-03-stack-trace.png。先頭のゼロにより、アップロード時にファイルが正しく並べ替えられます。これらがないと、step-10.png は step-2.png の前にアルファベット順にソートされます。簡単に一括アップロードできるように、すべてのスクリーンショットを 1 つのフォルダーに配置します。
デスクトップ、タスクバーアイコン、他のウィンドウ、個人情報の不要な部分を含むスクリーンショットを切り取ります。 80% の空白のデスクトップ背景に囲まれたエラー ダイアログのスクリーンショットは、ページ スペースを無駄にしており、プロフェッショナルらしく見えません。関連するコンテンツ領域をトリミングします。 WukongPDF の image-to-PDF ツールは、スクリーンショットをコンテンツの境界に合わせて自動トリミングし、空のデスクトップ領域を自動的に削除します。
スクリーンショットを PDF に変換
すべてのスクリーンショットを image-to-PDF ツールにアップロードします。フォルダー全体を選択するか、個々のファイルを複数選択します。このツールは、アップロードされた順序で画像をサムネイルとして表示します。順序が間違っている場合は、ドラッグして順序を変更します。間違った向きのスクリーンショットを回転させます。ページ レイアウトを選択します。 [ページに合わせる] では、アスペクト比を維持しながら、各スクリーンショットがページ全体に収まるように拡大縮小されます。 [実際のサイズ] では、各スクリーンショットが元のピクセル寸法で配置されます。 [幅に合わせる] は、すべてのスクリーンショットをページの幅に均一に拡大縮小します。
「変換」をクリックします。このツールは、各スクリーンショットを独自のページに含む PDF を生成します。ファイルをダウンロードします。それを開いてスクロールし、各ページの順序、方向、トリミングを確認します。 PDF Batch の変換には、一般的なスクリーンショットのセットでは数秒かかります。
コンテキストの追加: ファイル名、キャプション、ページ番号
生のスクリーンショットの PDF は、個々のファイルのフォルダーよりも優れていますが、それでもコンテキストが不足しています。各ページを識別するためにページ番号を追加します。各スクリーンショットの下に、視聴者が見ている内容を説明するキャプションを追加します。キャプションには、元のファイル名またはより長い説明を使用できます。 「スクリーンショット 3: 間違ったデータベース パスを示す構成ページ」のようなキャプションが表示されます。画像が何を示しているか、何を探すべきかを開発者に伝えます。
編集ツールを使用すると、変換後に各ページにテキスト キャプションを追加できます。各スクリーンショットの下にキャプションを配置します。一貫した書式設定を使用します。すべてのページで同じフォント、サイズ、位置を使用します。キャプションは、文書を画像の山から構造化されたレポートに変換します。ソフトウェアのバグ レポートの場合、番号付きのスクリーンショットと説明的なキャプションの組み合わせが、開発チームが期待する標準形式です。
スクリーンショットに複数のステップを含むプロセスが記載されている場合は、各スクリーンショットの上に簡単な説明または観察を追加します。上記のテキストは、どのようなアクションが取られたかを説明しています。以下のスクリーンショットは結果を示しています。このアクションと結果の組み合わせにより、ドキュメントは自己完結型になります。新しいチームメンバーは、説明を求めずにドキュメントを読んでプロセスを理解できます。
電子メールのファイル サイズの最適化
フル解像度のスクリーンショットを 20 枚使用すると、10 ～ 20 MB の PDF が生成されるため、電子メールの添付ファイルの制限を超える可能性があります。変換後に PDF を圧縮します。ユーザー インターフェイスの PNG スクリーンショットは、広い領域の単色とシャープなエッジが含まれているため、圧縮率が高くなります。 85% ～ 90% の品質で JPEG 圧縮すると、目に見える品質の低下を最小限に抑えながら、ファイル サイズが 40% ～ 60% 削減されます。 PDF Export 圧縮では、画像コンテンツに基づいて適切なアルゴリズムが適用されます。
圧縮された PDF をテストして、スクリーンショットがまだ判読できることを確認します。ファイルを開き、ログ ファイルや設定パネルなどの小さなテキストを含むスクリーンショットを 100% に拡大します。テキストが判読できる場合、圧縮は適切です。テキストがぼやける場合は、圧縮レベルを下げてもう一度試してください。ファイルは送信できるほど小さく、読み取れるほど鮮明である必要があります。
定期的なバグ レポートやドキュメント化タスクの場合は、スクリーンショットを PDF に変換するテンプレートを作成します。テンプレートは、各ページの上部と下部にプレースホルダー テキスト ボックスが配置された空の PDF です。新しいスクリーンショットがある場合は、テンプレートをオーバーレイとして使用して PDF に変換します。プレースホルダー領域はキャプションスペースになります。このテンプレートのアプローチにより、すべてのバグ レポートまたはドキュメント セットにわたって一貫した書式設定が保証され、ドキュメントの作成者に関係なく、キャプションが常に同じフォント、サイズ、位置になります。
最後の品質に関するヒント: スクリーンショット PDF を送信する前に、スクリーンショット内の機密情報が編集または切り取られていることを確認してください。ソフトウェアのスクリーンショットには、ユーザー名、電子メール アドレス、ファイル パス、サーバー名、およびタイトル バー、ステータス バー、ダイアログ ボックスに表示されるその他の詳細がキャプチャされることがよくあります。外部ベンダーに送信されるバグ レポートでは、内部サーバー名やユーザー情報が公開されるべきではありません。 PDF に含める前に、各スクリーンショットを最大解像度で確認してください。
スクリーンショットに複数の言語で利用できるユーザー インターフェイスが記載されている場合は、最初のページのキャプションに言語とソフトウェア バージョンをメモしてください。 2026 年 6 月に英語版ソフトウェアのバージョン 4.2 から作成されたスクリーンショット PDF は、読者に何を見ているのかを正確に伝えます。このコンテキストがないと、スクリーンショットは劣化してしまいます。 2 年前のバグ レポートには、その後再設計された UI が参照されている場合があります。バージョン情報は、スクリーンショットが現在のソフトウェアと異なる理由を読者が理解するのに役立ちます。