8. Anexo II: Instalación y Uso de la Aplicación1. Instalación de ActivePerl

Lo primero que necesitamos para la ejecución de nuestro programa es instalar Perl en

nuestro sistema. En nuestro caso, se ha instalado una distribución ActivePerl 5.8.8 para la

arquitectura MsWin32-x86 multi hilo, sobre un sistema operativo Windows Vista y un

procesador Intel Core2 Duo. Otras versiones de Perl no funcionan con este procesador,

aunque por norma general no debería haber ningún problema, y podemos encontrar

instaladores para casi cualquier sistema operativo y arquitectura, a saber, Linux, Mac OS X,

Solaris 8+, etc.

Podemos encontrar estas distribuciones directamente en la página de Active Perl:

http://www.activestate.com/activeperl/downloads/

Para el sistema operativo Windows, nos descargaremos el archivo ActivePerl-5.8.9.820-

MSWin32-x86-290470.msi que hemos utilizado en nuestro caso (en la página anterior

podemos encontrar versiones más recientes), y haremos doble click sobre él. Otra

alternativa es introducir en la línea de comando:

msiexec /i ActivePerl-5.8.9.826-MSWin32-x86-274739.msi

Sólo resta seguir los pasos de la instalación y ya tendremos Perl disponible en nuestro

sistema.

2. Instalación de Librería PDF::API2

Podemos descargarnos esta librearía de la siguiente dirección:

http://search.cpan.org/~areibens/PDF-API2-0.73/lib/PDF/API2.pm

La instalación de esta librería es algo más compleja que instalar ActivePerl, al menos bajo

un sistema operativo Windows.

Una vez hemos descargado el archivo de la página anterior, que debería ser del tipo tar.gz,

lo descomprimimos en una carpeta dentro de la de instalación de Perl (nos ayudará además

a recordar que librerías tenemos instaladas), por ejemplo /Perl/PDF-API2-0.73.

Una vez dentro de esta carpeta, hemos de seguir los siguientes tres pasos en la línea de

comando:

>perl makefile.pl

>make

>make install

En windows nos encontramos el problema de que no disponemos de un archivo make, por

lo que necesitamos descargarnos alguno similar, que podemos encontrar en la siguiente

dirección:

64

http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/Nmake15.exe

Nmake15.exe es un archivo que podemos descomprimir para obtener el archivo

nmake.exe, que es lo que utilizaremos en lugar de make. Una vez terminados estos tres

pasos ya tenemos la librería PDF::Api2 a nuestra disposición.

Con el objetivo de complicar lo mínimo posible la instalación, se ha optado por el uso de

esta única librería.

3. Uso del programa

Se ha incluido con la documentación el programa que se ha desarrolado en Perl, llamado

PDFIEEE.pl, que es un script que podemos ejecutar con Perl, sin importar el sistema

operativo.

Sólo necesitamos copiar este archivo a la carpeta donde hemos instalado Perl, y ejecutarlo

de la siguiente forma:

>Perl PDFIEEE.pdf nombrearchivo.pdf, donde nombrearchivo.pdf es, obviamente, el

archivo PDF que queremos analizar. Según el sistema operativo podría sernecesario

coincidencia de mayúsculas y minúsculas.

La ejecución de este modo nos dará una salida por pantalla (salida estándar, concretamente,

que podemos direccionar a un archivo, etc) de los errores y avisos que se encuentren acerca

del archivo PDF.

Existe una opción disponible, -d, para generar un archivo de depuración, que nos ofrece

información completa del archivo, incluyendo las características que sí cumplen con los

requerimientos del IEEE. La ejecución sería de esta forma:

>Perl PDFIEEE.pdf nombrearchivo.pdf -d

Se muestran ejemplos de este archivo en la siguiente sección, ya que los utilizaremos para

saber si el programa nos devuelve información correcta o no. El archivo generado se

llamará igual que el archivo PDF, al que se le añade la extensión .txt.

Veamos un ejemplo de funcionamiento del programa:

65

Para los errores y avisos se ha seguido una codificación por si se desea un posterior

procesamiento. Cada aviso y error lleva un código de dos letras, que indican el tipo de error

o aviso, y dos números, para diferenciarlo de los demás. La codificación es la siguiente:

VE01 Error por versión incorrecta de PDF.

EC01 Error por archivo Encriptado.

LZ01 Aviso por archivo no preparado para vista rápida en Web.

BO01 Error por hallarse marcadores de páginas.

FC01 Error de Colección de archivos adjuntos detectados.

FT00 Aviso de Archivo probablemente escaneado.

FT01 Error de fuente no incrustada.

FT02 Error de codificación incorrecta de fuente sin entrada ToUnicode.

FT03 Aviso de codificación incorrecta de fuente con entrada ToUnicode.

FT04 Aviso de Fuente tipo Opentype.

LI01 Enlace hallado en página.

LI02 Enlace a archivo adjunto detectado en página.

Así, el programa escribirá una línea por cada error o aviso, que tendrá la siguiente

estructura:

Tipo Código. [Page:Número de página ]Descripción, como hemos podido ver en la

imagen anterior. Sólo se mostrará Page:Número de página si el error o aviso dependen de

una página y no del documento completo.

66