OCRmyPDFローカルデプロイ&使い方チュートリアル 252

小编 ·

OCRmyPDFローカルデプロイ&使い方チュートリアル

OCRmyPDFは、スキャンしたPDFファイルに検索・コピー可能なOCRテキスト層を追加するためのツールで、多言語対応、画像の最適化、傾き補正、ページクリーニング、向きの自動回転などの機能を備えています。以下はOCRmyPDFのローカルデプロイ方法です:

OCRmyPDFローカルデプロイ&使い方チュートリアル

OCRmyPDF は、スキャンしたPDFファイルに検索・コピー可能なOCRテキストレイヤーを追加することを主な目的としたツールで、多言語対応、画像の最適化、傾き補正、ページのクリーニング、自動回転などの機能を備えています。以下にOCRmyPDFのローカルデプロイ方法を説明します。

OCRmyPDFローカルデプロイおよび使用チュートリアル.webp

OCRmyPDFローカルデプロイ方法

OCRmyPDFはさまざまなインストール方法を提供しており、お使いのオペレーティングシステムやニーズに応じて選択できます。

1. システムパッケージマネージャーを使用したインストール

Debian/Ubuntu:

apt install ocrmypdf

Fedora:

dnf install ocrmypdf tesseract-osd

macOS (Homebrew):

brew install ocrmypdf

Windows Subsystem for Linux:

apt install ocrmypdf

2. Python pipを使用したインストール

最新バージョンをインストールしたい場合や、システムパッケージマネージャーが提供するバージョンが古い場合は、pipを使用できます。

pip install ocrmypdf

または、pipxを使用して分離されたPython環境を作成することもできます。

pipx install ocrmypdf

3. Dockerを使用したインストール

Dockerを使用している場合、以下のコマンドでOCRmyPDFのDockerイメージをインストールできます。

docker pull jbarlow83/ocrmypdf

実行時には、入力ファイルと出力ファイルをコンテナにマウントできます。

docker run -v /path/to/input.pdf:/input.pdf -v /path/to/output.pdf:/output.pdf jbarlow83/ocrmypdf /input.pdf /output.pdf

4. ソースコードからのインストール

ソースコードからインストールする場合(例:開発や最新機能のテスト)には、GitHubリポジトリをクローンしてインストールできます。

git clone https://github.com/ocrmypdf/OCRmyPDF.git
cd OCRmyPDF
pip install -e .

依存関係

  • Python 3.10 以上

  • Ghostscript 9.54 以上

  • Tesseract 4.1.1 以上

  • jbig2enc 0.29 以上(オプション、出力ファイルサイズの最適化に使用)

  • pngquant 2.5 以上(オプション、PNG画像の最適化に使用)

  • unpaper 6.1 以上(オプション、画像クリーニングに使用)

注意事項

  • 32ビットサポート:OCRmyPDFは32ビットシステムをサポートしていないため、64ビット版の使用を推奨します。

  • Windowsユーザー:互換性の問題を回避するため、Windows Subsystem for LinuxまたはDockerの使用を推奨します。

  • macOSユーザー:Homebrewでインストールできますが、Tesseractの言語パック(tesseract-langなど)を追加でインストールする必要があります。

インストールの確認

インストールが完了したら、以下のコマンドでOCRmyPDFが正常にインストールされたかを確認できます。

ocrmypdf --version

OCRmyPDF使用チュートリアル

1. OCRテキストレイヤーの追加

コア機能:スキャンしたPDFファイルに検索可能なテキストレイヤーを追加し、ドキュメントの内容をコピー可能・検索可能にします。

コマンド例:

ocrmypdf input.pdf output.pdf

2. 多言語サポート

機能説明:100以上の言語をサポートしており、ユーザーはドキュメントの言語に応じて適切な言語パックを選択し、OCRの精度を向上させることができます。

コマンド例:

ocrmypdf --language chi_sim input.pdf output.pdf  # 簡体字中国語
ocrmypdf --language eng input.pdf output.pdf      # 英語

3. 画像最適化

機能説明:PDF内の画像を最適化し、解像度の調整や画像サイズの圧縮などを行い、画質を保ちながらより小さいファイルを生成します。

コマンド例:

ocrmypdf --optimize 3 input.pdf output.pdf  # 最強の最適化

4. 傾き補正とクリーニング

機能説明:OCRを実行する前に、画像の傾き補正(傾きの修正)やクリーニング(汚れやノイズの除去)を行い、OCRの精度を向上させます。

コマンド例:

ocrmypdf --deskew --clean input.pdf output.pdf

5. ページの自動回転

機能説明:ページの方向を自動検出し、すべてのページの方向を揃えて回転させることで、読み取りや処理を容易にします。

コマンド例:

ocrmypdf --rotate-pages input.pdf output.pdf

6. PDF/A形式への変換

機能説明:出力ファイルをPDF/A形式に変換します。これは長期保存に適した国際標準のアーカイブ形式です。

コマンド例:

ocrmypdf --output-type pdfa input.pdf output.pdf

7. 重複ページの削除

機能説明:PDF内の重複ページを自動検出して削除し、ファイルサイズを削減します。

コマンド例:

ocrmypdf --remove-background input.pdf output.pdf

8. 背景除去

機能説明:PDFページの背景を除去し、文字をより鮮明にして読みやすくします。

コマンド例:

ocrmypdf --remove-background input.pdf output.pdf

9. PDF/A形式の生成

機能説明:長期アーカイブや保存に適したPDF/A標準に準拠したファイルを生成します。

コマンド例:

ocrmypdf --output-type pdfa input.pdf output.pdf

10. 既にOCR済みのページのスキップ

機能説明:PDF内の一部のページに既にテキストレイヤーが含まれている場合、それらのページをスキップして重複処理を回避できます。

コマンド例:

ocrmypdf --skip-text input.pdf output.pdf

11. カスタムDPI

機能説明:OCR処理時の画像解像度(DPI)を指定できます。デフォルト値は300 DPIです。

コマンド例:

ocrmypdf --dpi 350 input.pdf output.pdf

12. モノクロ画像への変換

機能説明:カラーまたはグレースケール画像をモノクロ画像に変換し、ファイルサイズを削減します。

コマンド例:

ocrmypdf --output-type pdf --monochrome input.pdf output.pdf

13. ログファイルの生成

機能説明:詳細なログファイルを生成し、デバッグや処理プロセスの記録を容易にします。

コマンド例:

ocrmypdf --log-file output.log input.pdf output.pdf

14. バッチ処理

機能説明:スクリプトやコマンドラインツール(GNU Parallelなど)と組み合わせることで、複数のPDFファイルをバッチ処理できます。

コマンド例:

for file in *.pdf; do
ocrmypdf "$file" "output_$file"
done

15. 複数の入力形式のサポート

のファイル生成 PDF には、TIFF、PNG などが含まれます。

サンプルコマンド:

ocrmypdf input.tiff output.pdf

16. PDFの圧縮

機能説明:OCR処理後、PDFファイルをさらに圧縮してファイルサイズを削減できます。

サンプルコマンド:

ocrmypdf --optimize 3 input.pdf output.pdf

17. PDF/A-2bまたはPDF/A-2uへの変換

機能説明:PDF/A-2bまたはPDF/A-2u規格に準拠したファイルを生成し、さまざまなニーズに対応します。

サンプルコマンド:

ocrmypdf --output-type pdfa-2b input.pdf output.pdf
ocrmypdf --output-type pdfa-2u input.pdf output.pdf

18. Unicode対応

機能説明:Unicode文字をサポートし、多言語ドキュメントの正確な処理を保証します。

サンプルコマンド:

ocrmypdf --language chi_sim --language eng input.pdf output.pdf

19. 出力ファイル名のカスタマイズ

機能説明:出力ファイルの名前をカスタマイズでき、管理や識別が容易になります。

サンプルコマンド:

ocrmypdf input.pdf "output_with_date_$(date +%Y%m%d).pdf"

20. コマンドライン引数のサポート

機能説明:コマンドライン引数を通じて、OCRmyPDFのさまざまな機能を柔軟に構成できます。

サンプルコマンド:

ocrmypdf --help

OCRmyPDFローカルデプロイおよび使用方法:https://ocrmypdf.readthedocs.io/en/latest/installation.html