Skip to content

README_ja.md

Latest commit

 

History

History
215 lines (153 loc) · 12.2 KB

README_ja.md

File metadata and controls

215 lines (153 loc) · 12.2 KB
Raw

PDFtoPDFocr バナー

English | Deutsch | Español | 中文 | 日本語 | Русский

PDFtoPDFocr — スキャン画像を検索可能な PDF に変換

Python 3.10+ Version 1.1.4 MIT License Platforms

PDFtoPDFocr は、Tesseract OCR を使ってスキャン PDF や画像ファイルを検索可能な PDF に変換するデスクトップアプリです。複数ファイルの処理、OCR 言語の選択、元ファイルの保持に対応しています。

OCR と PDF の作成にはローカルツールを使います。選択した言語の Tesseract データファイルがない場合、アプリは GitHub からそのファイルをダウンロードできます。アプリはネットワークを遮断するファイアウォールやサンドボックスを提供しません。

この簡潔な入口ページは、詳細版の旧 README README_ja-archive-2026-10-12.md に置き換わりました。アーカイブ版は現在の主張を修正したガイドです。未変更の原文はコミット 3cfce468で確認できます。

機械可読コンテキスト: llms.txt · セキュリティポリシー · サードパーティライセンス一覧

クイックナビゲーション

  1. 画面の概要
  2. アーキテクチャ
  3. ローカルデータフロー
  4. クイックスタート
  5. 機能
  6. 利用例
  7. ツールの比較
  8. アクセシビリティ
  9. 要件
  10. インストール
  11. 使い方
  12. 関連プロジェクト
  13. テスト
  14. サードパーティライセンス
  15. プライバシーとセキュリティ
  16. デスクトップのパッケージ化
  17. LLM コンテキスト
  18. ライセンスと法的注記

画面の概要

スクリーンショットと詳しい画面操作の説明はアーカイブ版ガイドにあります。

アーキテクチャ

ユーザー → デスクトップアプリ → Poppler が PDF ページを画像化 → Tesseract がテキストを認識 → アプリが検索可能な PDF を作成します。選択された OCR 言語のデータがない場合、アプリは GitHub にリクエストできます。

アーキテクチャの詳細

コンポーネントと処理フローの詳細図はアーカイブ版ガイドを参照してください。

ローカルデータフロー

PDF の処理にはローカルツールを使います。ソースコードには、不足している Tesseract 言語データを取得する GitHub リクエストが含まれます。これはアプリの動作を説明するもので、システム全体のネットワーク制限を示すものではありません。セキュリティポリシーの範囲と連絡先は SECURITY.md にあります。

クイックスタート

git clone https://github.com/doc-bricks/PDFtoPDFocr.git
cd PDFtoPDFocr
python -m venv .venv

使用するシェルに合わせて、次のうち 1 つだけ を実行して環境を有効化します。

PowerShell:

.\.venv\Scripts\Activate.ps1

Windows コマンドプロンプト:

.\.venv\Scripts\activate.bat

macOS または Linux:

source .venv/bin/activate

続けて依存パッケージをインストールし、アプリを起動します。

python -m pip install -r requirements.txt
python PDFtoPDFocr_2.py

このリポジトリから作成される Python wheel には配布メタデータのみが含まれ、デスクトップアプリはインストールされません。アプリの実行にはこのソースチェックアウトを使用してください。

Tesseract OCR と Poppler は別途インストールしてください。要件を参照してください。Windows では START.bat も使えます。

機能

  • スキャン PDF と画像をまとめて処理します。
  • OCR 言語を選択できます。不足する Tesseract 言語データは GitHub から取得できます。
  • 元ファイルを保持しながら検索可能な PDF を作成します。
  • アプリからジョブマニフェストをエクスポートできます。

詳しい手順はアーカイブ版の機能ガイドにあります。

利用例

スキャンや画像を検索可能な PDF に変換するデスクトップ作業を想定しています。法務、医療、コンプライアンスの認証を示すものではありません。

ツールの比較

他製品との機能・コンプライアンス比較を検証済み情報として提供していません。各製品の最新ドキュメントと利用条件を確認してください。

アクセシビリティ

キーボードショートカットとアクセシビリティ用メタデータがあります。独立した WCAG 適合監査を受けたとは主張していません。詳しくは画面に関するノートを参照してください。

要件

ソースから実行するには Python 3.10 以降が必要です。Python パッケージの宣言済み最低バージョンは次のとおりです。

パッケージ 最低バージョン
PySide6 6.5.0
pytesseract 0.3.13
Pillow 10.4.0
pdf2image 1.17.0
pikepdf 8.15.1
requests 2.33.1

同じ要件は requirements.txt と pyproject.toml に記載されています。Tesseract OCR と Poppler も PATH 上に置くか、対応するローカルパスで設定してください。Windows は主なパッケージ化対象で、macOS と Linux はソースからの実行対象です。

インストール

リポジトリをクローンし、アクティブな仮想環境に requirements.txt の Python パッケージをインストールします。Tesseract と Poppler は別途導入します。選択した言語データがなければ、実行時に GitHub から取得できます。

使い方

  1. [python PDFtoPDFocr_2.py] を実行します。Windows では START.bat も使えます。
  2. PDF または画像を追加し、OCR 言語を選択します。
  3. OCR を開始し、生成された PDF を確認します。
  4. 必要に応じてアプリからジョブマニフェストをエクスポートします。

テスト

仮想環境を有効にしてから [python -m pip install -r requirements-dev.txt] を実行してください。このファイルには requirements.txt、pytest、ruff が含まれます。テストは [python -m pytest] で実行します。翻訳の整合性は [python manage_translations.py --check] でも確認できます。

関連プロジェクト

プロジェクト 関連する作業
DokuReader ローカルの文書ライブラリと PDF の整理。
UniversalDocsGrabber メール添付のダウンロードと Windows 上での文書整理。
UniversalInvoiceMail 請求書の抽出と DATEV 形式を参考にした CSV エクスポート。

それぞれ独立したプロジェクトです。関連する用途を示すリンクであり、共通の実行環境やデータフローを意味しません。

サードパーティライセンス

THIRD_PARTY_LICENSES.md と THIRD_PARTY_LICENSES.txt に、依存パッケージや同梱ツールのライセンス情報の一部を掲載しています。情報一覧であり、すべての配布形態や用途に対する適合認証ではありません。

プライバシーとセキュリティ

アプリはローカルの OCR・PDF ツールを使います。ソースコードには不足する Tesseract 言語データを取得するリクエストも含まれます。ファイアウォール、サンドボックス、OS 権限境界は提供しません。データの流れは PRIVACY_POLICY.md、報告窓口と対応方針は SECURITY.md を確認してください。

デスクトップのパッケージ化

Windows 向けのローカルビルドは [python build_release.py --clean] または build_exe.bat で準備できます。[--clean] は新しいビルド環境を作成して PyInstaller を実行する前に [dist/]、[build/]、[.build_venv/] を削除します。スクリプトは専用のビルド依存一覧を使います。成果物はローカルに作られ、リリースは公開されません。

LLM コンテキスト

llms.txt はリポジトリのファイルと開発コマンドを示す、短い機械可読インデックスです。

ライセンスと法的注記

プロジェクトは MIT ライセンスで提供されています。§ 521 BGB などの法規が適用されるかは、具体的な法律関係と適用法によります。この文書は一律の免責を定めるものではありません。