OCRmyPDF: Tutorial de despliegue local y uso 251

小编 ·

OCRmyPDF: Tutorial de despliegue local y uso

OCRmyPDF es una herramienta diseñada principalmente para añadir una capa de texto OCR buscable y copiable a archivos PDF escaneados. Compatible con múltiples idiomas, optimiza imágenes, corrige inclinaciones, limpia páginas y rota automáticamente la orientación. A continuación se explica cómo desplegar OCRmyPDF localmente:

OCRmyPDF: Tutorial de despliegue local y uso

OCRmyPDF es una herramienta diseñada principalmente para añadir una capa de texto OCR buscable y copiable a archivos PDF escaneados. Soporta múltiples idiomas, puede optimizar imágenes, corregir la inclinación, limpiar páginas y rotar automáticamente la orientación, entre otras funciones. A continuación se muestra el método de despliegue local de OCRmyPDF:

Tutorial de despliegue local y uso de OCRmyPDF.webp

Método de despliegue local de OCRmyPDF

OCRmyPDF ofrece varios métodos de instalación, dependiendo de tu sistema operativo y tus necesidades.

1. Instalación mediante el gestor de paquetes del sistema

Debian/Ubuntu:

apt install ocrmypdf

Fedora:

dnf install ocrmypdf tesseract-osd

macOS (Homebrew):

brew install ocrmypdf

Windows Subsystem for Linux:

apt install ocrmypdf

2. Instalación usando Python pip

Si necesitas instalar la versión más reciente o la versión proporcionada por el gestor de paquetes del sistema es demasiado antigua, puedes usar pip:

pip install ocrmypdf

O bien, usa pipx para crear un entorno Python aislado:

pipx install ocrmypdf

3. Instalación usando Docker

Si utilizas Docker, puedes instalar la imagen Docker de OCRmyPDF con el siguiente comando:

docker pull jbarlow83/ocrmypdf

Al ejecutar, puedes montar los archivos de entrada y salida en el contenedor:

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

4. Instalación desde el código fuente

Si necesitas instalar desde el código fuente (por ejemplo, para desarrollar o probar las funciones más recientes), puedes clonar el repositorio de GitHub e instalarlo:

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

Dependencias

  • Python 3.10 o superior

  • Ghostscript 9.54 o superior

  • Tesseract 4.1.1 o superior

  • jbig2enc 0.29 o superior (opcional, para optimizar el tamaño del archivo de salida)

  • pngquant 2.5 o superior (opcional, para optimizar imágenes PNG)

  • unpaper 6.1 o superior (opcional, para limpiar imágenes)

Puntos a tener en cuenta

  • Soporte de 32 bits: OCRmyPDF no soporta sistemas de 32 bits, se recomienda usar la versión de 64 bits.

  • Usuarios de Windows: se recomienda usar Windows Subsystem for Linux o Docker para evitar problemas de compatibilidad.

  • Usuarios de macOS: pueden instalarlo mediante Homebrew, pero necesitan instalar adicionalmente los paquetes de idioma de Tesseract (como tesseract-lang).

Verificación de la instalación

Una vez completada la instalación, puedes verificar si OCRmyPDF se instaló correctamente con el siguiente comando:

ocrmypdf --version

Tutorial de uso de OCRmyPDF

1. Añadir capa de texto OCR

Función principal: añade una capa de texto buscable a los archivos PDF escaneados, permitiendo que el contenido del documento sea copiable y buscable.

Comando de ejemplo:

ocrmypdf input.pdf output.pdf

2. Soporte multilingüe

Descripción de la función: soporta más de 100 idiomas. Los usuarios pueden seleccionar el paquete de idioma adecuado según el idioma del documento para mejorar la precisión del OCR.

Comando de ejemplo:

ocrmypdf --language chi_sim input.pdf output.pdf  # Chino simplificado
ocrmypdf --language eng input.pdf output.pdf      # Inglés

3. Optimización de imágenes

Descripción de la función: optimiza las imágenes del PDF, incluyendo el ajuste de la resolución y la compresión del tamaño de las imágenes, generando archivos más pequeños manteniendo la calidad de imagen.

Comando de ejemplo:

ocrmypdf --optimize 3 input.pdf output.pdf  # Optimización máxima

4. Corrección de inclinación y limpieza

Descripción de la función: antes de realizar el OCR, corrige la inclinación de las imágenes y las limpia (eliminando manchas, ruido, etc.), mejorando la precisión del OCR.

Comando de ejemplo:

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

5. Rotación automática de páginas

Descripción de la función: detecta automáticamente la orientación de las páginas y las rota, asegurando que todas las páginas tengan la misma orientación para facilitar la lectura y el procesamiento.

Comando de ejemplo:

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

6. Conversión al formato PDF/A

Descripción de la función: convierte el archivo de salida al formato PDF/A, un formato estándar internacional de archivo adecuado para el almacenamiento a largo plazo.

Comando de ejemplo:

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

7. Eliminación de páginas duplicadas

Descripción de la función: detecta y elimina automáticamente las páginas duplicadas en el PDF, reduciendo el tamaño del archivo.

Comando de ejemplo:

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

8. Eliminación del fondo

Descripción de la función: elimina el fondo de las páginas del PDF, haciendo que el texto sea más claro y fácil de leer.

Comando de ejemplo:

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

9. Generación de formato PDF/A

Descripción de la función: genera archivos que cumplen con el estándar PDF/A, adecuados para el archivado y almacenamiento a largo plazo.

Comando de ejemplo:

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

10. Omitir páginas ya procesadas con OCR

Descripción de la función: si algunas páginas del PDF ya contienen una capa de texto, pueden omitirse para evitar procesamientos duplicados.

Comando de ejemplo:

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

11. DPI personalizado

Descripción de la función: permite especificar la resolución de imagen (DPI) al procesar el OCR. El valor predeterminado es 300 DPI.

Comando de ejemplo:

ocrmypdf --dpi 350 input.pdf output.pdf

12. Conversión a imagen monocromática

Descripción de la función: convierte imágenes en color o en escala de grises a imágenes monocromáticas, reduciendo el tamaño del archivo.

Comando de ejemplo:

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

13. Generación de archivo de registro

Descripción de la función: genera un archivo de registro detallado para facilitar la depuración y el registro del proceso de procesamiento.

Comando de ejemplo:

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

14. Procesamiento por lotes

Descripción de la función: combinado con scripts o herramientas de línea de comandos (como GNU Parallel), permite procesar múltiples archivos PDF por lotes.

Comando de ejemplo:

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

15. Soporte de múltiples formatos de entrada

del archivo para generar PDF, incluyendo TIFF, PNG, etc.

Comando de ejemplo:

ocrmypdf input.tiff output.pdf

16. Comprimir PDF

Descripción de la función: después del procesamiento OCR, se puede comprimir aún más el archivo PDF para reducir su tamaño.

Comando de ejemplo:

ocrmypdf --optimize 3 input.pdf output.pdf

17. Convertir a PDF/A-2b o PDF/A-2u

Descripción de la función: genera archivos que cumplen con los estándares PDF/A-2b o PDF/A-2u, adecuados para diferentes necesidades.

Comando de ejemplo:

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

18. Soporte para Unicode

Descripción de la función: admite caracteres Unicode, garantizando el procesamiento correcto de documentos en varios idiomas.

Comando de ejemplo:

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

19. Personalizar el nombre del archivo de salida

Descripción de la función: permite personalizar el nombre del archivo de salida para facilitar su gestión e identificación.

Comando de ejemplo:

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

20. Soporte para argumentos de línea de comandos

Descripción de la función: mediante argumentos de línea de comandos, se pueden configurar de forma flexible las diversas funciones de OCRmyPDF.

Comando de ejemplo:

ocrmypdf --help

Tutorial de implementación local y uso de OCRmyPDF:https://ocrmypdf.readthedocs.io/en/latest/installation.html