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:

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
Asistente de guiones▸
Apps AI
Noticias AI 