taxis genérica para el procesamiento deficheros PDF con el programa es:

pdftk fichero_entrada U

operación [opción] U

output fichero_salida U

[contraseñas] [permisos_usua-rios]

Los ficheros de entrada han de estar enformato PDF. Además, la herramientanecesita ficheros de texto en un formatoespecial para algunas operaciones. pdftkda como salida uno o más ficheros PDFasí como ficheros de texto en algunoscasos especiales.

En las secciones que siguen he dis-puesto unos cuantos ejemplos quedemuestran un poco los usos más intere-santes de pdftk. Estos ejemplos no hacenmás que rayar la superficie de las posibi-lidades de este complejo programa.

Adjuntos en ficheros PDFSe puede añadir un adjunto a un ficheroPDF del mismo modo que puedes aña-dirlo a un correo electrónico. AdobeReader (versión 6 o superior) almacenalos adjuntos en el recipiente. pdftk per-mite a sus usuarios adjuntar ficheros adocumentos PDF y también guardarlos.

Antes de la publicación de Adobe Reader7, era la única manera de que los usua-rios Linux pudieran guardar adjuntos.

Los adjuntos pueden ser usados paraañadir código fuente o extractos debase de datos literarias a ficheros PDF.El siguiente ejemplo muestra cómoenviar un fichero PDF y el código fuen-te acompañante. Para añadir un ficherode código fuente a un documento PDF

80

LINUX USER • PDFTk

80 Número 12 W W W . L I N U X - M A G A Z I N E . E S

Utilidades PDF nativas de Linux,tales como GhostScript, son muyútiles si estás dispuesto a nave-

gar a través de los menús. Pero si estásbuscando algo más rápido, o si lo queprefieres es automatizar alguna tarearecurrente, prueba con pdftk, el juego deherramientas PDF. pdftk es un programade la línea de comandos muy apropiadopara procesar ficheros PDF. Según sucreador, Sid Steward, “Si PDF es papelelectrónico, entonces pdftk es desgrapa-dora electrónica, taladrador, encuaderna-dor y gafas de rayos X electrónica.

Instalación y UsoPuedes descargar la última versión deljuego de herramientas de una de laspáginas web de Sid Steward [1]. El pro-grama GPL se encuentra disponible paraLinux, Mac OS X (Panther), FreeBSD,Solaris y Windows. La instalación resul-tó ser bastante simple sobre las platafor-mas que probamos (Debian y SuSELinux).

Tras completar la instalación puedescorrer pdftk desde la shell. El comandode -help de pdftk ofrece una lista decomandos y opciones con textos deayuda cortos. La tabla 1 lista y explicalas operaciones más importantes. La sin-

Para organizar la montaña de pape-

les que se cruzan cada día en nuestro

mesa necesitamos organizar,recu-

perar, copiar, imprimir, buscar y

clasificar documentos. Una her-

ramienta especial puede ayudar a los

usuarios a interesarse por el trabajo

administrativo electrónico: pdftk, el

juego de herramientas PDF.

POR STEFAN LAGOTZKI

Herramienta Multifuncional para ficheros PDF

PDF A TOPE

01 %FDF-1.2

02 1 0 obj <<

03 /FDF << /Fields [

04 << /V (Dresden)/T (city) >>

05 << /V (Stefan Lagotzki)/T

06 (author)>>

07 ]/F (form.pdf) >>

08 >>

09 endobj

10 trailer

11 <<

12 /Root 1 0 R

13 >>

14 %%EOF

Listado 1: Ejemplo deFichero PDF

080-082_PDFTkL12 16.11.2005 9:46 Uhr Página 80

81

PDFTk • LINUX USER

81Número 12W W W . L I N U X - M A G A Z I N E . E S

usando pdftk, escribe los siguientescomandos:

pdftk fichero.pdf attach_files U

fichero.text output nuevo.pdf

Alternativamente, podrías usar pdfLaTeXy un fichero adjunto para añadir el códi-go fuente al fichero PDF acabado. El des-tinatario usaría luego pdftk para desem-paquetar el fichero código fuente y otrosadjuntos usados en cualquier directorio:

pdftk exejemplo_adjunto.pdf U

unpack_files output Fuente

En este ejemplo, guarda los adjuntos enun directorio llamado Fuente. Añadir elnombre del directorio siempre tiene sen-tido si estás manejando múltiples adjun-tos.

Marcas de Agua y Colorespdftk utiliza un método similar al paque-te LaTeX eso-pic para añadir una marcade agua a un documento. La opciónbackground es la que maneja esto, ade-más de permitir al usuario asignar uncolor a la imagen de fondo PDF.

La imagen que uses como marca deagua deberá ser un fichero PDF. Podríascrear una imagen con una herramientade gráficos vectorial o bien escribir unprograma PostScript. Si la marca de aguano es del mismo tamaño que el docu-mento, pdftk escalará la marca de agua.Asigna a lo que quieres imprimir la pala-bra “DRAFT” en un documento. El pri-mer paso sería crear un PDF con el tama-ño de la página adecuado antes de lla-mar a pdftk como sigue:

pdftk ejemplo.pdf background U

borrador.pdf outputborrador1.pdf

La marca de agua se asemeja a un selloen cualquier parte del documento sincontenido. Puedes crear un pequeñofichero EPS con un color de imagen defondo a tu elección. Los comandosPostScript para una página de tamaño A4se parecen a:

%!PS-Adobe-2.0%%BoundingBox: 0 0 595 8420.95 0.95 0.90 setrgbcolor0 0 moveto 595 0 rlineto 0 842 U

rlineto -595 0 rlineto

closepath fillshowpage

Es fácil cambiar el color de la imagen defondo en el código EPS. Puedes entoncesconvertir el fichero EPS a PDF usandoepstopdf y correr luego pdftk para usar elfichero como una imagen de fondo:

pdftk ejemplo.pdf background U

Fondo.pdf output eg_color.pdf

Dividiendo y UniendoFicheros PDFLa operación burst te permite dividir unfichero PDF en sus páginas individuales.Para hacerlo, necesitas suministrar unnombre genérico para las páginas y espe-cificar el formato numérico:

pdftk ejemplo.pdf burst U

output Pagina%03d.pdfpdftk ejemplo.pdf burst U

output ./Paginas/Paigna%03d.pdf

En ambos ejemplos, un número de pági-na de tres dígitos se añadirá a los nom-bres de la página. En el segundo ejem-plo, pdftk almacenará los ficheros PDFen un subdirectorio existente.

La operación cat le dice a pdftk queconcatene múltiples ficheros PDF paracrear un nuevo documento. Puedes usarcomodines para especificar los nombresde ficheros de los ficheros fuente indivi-duales.

pdftk ejemplo.pdf otro.pdf U

adjunto.pdf U

cat output ejemplo_concat.pdfpdftk D=cubierta.pdf U

B=ejemplo.pdf U

cat D B1-4 output U

ejemplo_cubierta.pdf

Tal y como demuestra el segundo ejem-plo, puedes usar cat para reordenardocumentos mediante la unión de laspartes de un fichero PDF con partes deotro fichero PDF para crear un nuevodocumento.

Consulta y Actualización deMeta-InformaciónLa mayoría de los ficheros PDF contie-nen meta-información con detalles delautor, el tema o el software usado paracrear el documento. pdftk te permiteenviar estos datos a una salida estándaro redireccionarlos a un fichero:

pdftk ejemplo.pdf U

dump_data output info.txt

Este comando salva la informacióndesde un documento PDF a un ficherotitulado info.txt. La información incluyeun campo clave y su valor. Antes deenviar o de archivar documentos PDF, amenudo tiene sentido actualizar losmeta-datos. Pdftk te permite hacerlo sintener que recrear o trasladar el ficheroPDF.

Para actualizar la meta-información,crea primero un fichero de texto con losmeta-datos. El fichero debería ser similara algo como lo que sigue (resumido poraquello de la brevedad):

InfoKey: CreadorInfoValue: TeXInfoKey: CorporaciónInfoValue: Ejemplo e Hijos

Operación Explicaciónattach_files Añade ficheros como adjuntos a un documento PDF. Esto permite añadir

un fichero de archivo a un fichero PDF.background Añade una marca de agua a cada página para un documento PDF.

También permite añadir un sello electrónico a espacios vacíos.burst Divide un documento PDF en páginas individuales.cat Concatena un nuevo fichero PDF a partir de ficheros múltiples o páginas

desde documentos PDF distintos.dump_data Salida de información sobre un fichero PDF o salida stándard.dump_data_fields Salidas de información sobre los campos de formularios en un fichero PDF

o salida stándard.fill_form Llena los formularios PDF o datos en forma de enlaces con el documento.unpack_files Desempaqueta los adjuntos de un documento PDF en un directorio.update_info Actualiza la meta-información (por ej. autor, título, tema) en un fichero

PDF.

Tabla 1:Operaciones pdftk

080-082_PDFTkL12 16.11.2005 9:46 Uhr Página 81

rios PDF completados sobre un servidorIntranet o Internet. El usuario completalos campos del formulario en su navega-dor. Luego un script PHP o Perl corrien-do de fondo crea un fichero FDF.Finalmente, pdftk combina ambas par-tes. El fichero PDF completado puede serenviado por correo luego.

Contraseñas y Permisos deUsuario en PDFsLos ficheros PDF pueden estar protegi-dos mediante el permiso de usuario ycontraseñas. pdftk permite establecerpara un fichero PDF tanto las contrase-ñas como los permisos. El siguienteejemplo establece ambas contraseñas:

pdftk fichero.pdf output U

nuevo.pdf owner_pw U

Lie5quai user_pw phupaefu

En este ejemplo las contraseñas fuerongeneradas usando la herramienta pwgen.Deberías usar distintas para las contrase-ñas y permisos.

El propietario de un fichero PDF puedeasignar permisos específicos. La Tabla 2presenta una lista de permisos que pue-den establecerse con pdftk.

El siguiente ejemplo crea primero unfichero PDF que solamente puede impri-mirse. La segunda línea crea un ficheroPDF que además de imprimirse puedeser también copiado.

pdftk ejemplo.pdf output U

nuevo.pdf owner_pw U

Lie5quai user_pw phupaefu U

allow printingpdftk ejemplo.pdf output U

nuevo.pdf owner_pw U

Lie5quai user_pw phupaefu U

allow printing CopyContents

Los ficheros PDF pueden ser encriptadoscon diferentes niveles de encriptación.Para encriptar un fichero con pdftk hay

que añadir como opción finalencrypt_40bit o encrypt_128bit. Tambiénpuedes necesitar sustituir una contrase-ña por un fichero PDF protegido concontraseña. Si estás procesando múlti-ples ficheros, puedes imponer variablesa los nombres de ficheros y luego asignaruna contraseña a cada fichero. En elejemplo siguiente, solamente el fichero Atiene protegida la contraseña:

pdftk A=nuevo.pdf U

B=eg_color.pdf input_pw U

A=Lie5quai cat output U

egl_pw.pdf user_pw Abraxas

Como en el ejemplo anterior no te permi-te concatenar el fichero PDF pornuevo.pdf, necesitas sustituir la contra-seña del propietario.

ConclusionesSi estás buscando una herramienta sim-ple, rápida y eficiente para editar fiche-ros PDF desde la línea de comandos,prueba con el Toolkit PDF. pdftk es unaherramienta de manipulación PDF versá-til y multifuncional sin el peso de unGUI. Si quieres hurgar profundamente enla manipulación de ficheros PDF, échaleun vistazo al libro de Sid Steward sobreHacks de PDF [2].

pdftk está escrito en C++ y basado enla librería iText [3], escrita en Java. El pro-grama completo fue compilado y linkadocon herramientas libres como el GNUCompiler Collection [4]. Esto hace a pdftkfácilmente portable y extensible. La websi-te de pdftk tiene enlaces a portes.

El trabajo de desarrollo sobre el pro-grama pdftk aún continua. Su autor, SidSteward responderá a todas las cuestio-nes sobre pdftk y correos sobre progra-mación PDF en el grupo de noticiascomp.text.pdf y en su propio foro PDF[1]. �

No necesita contener toda la informaciónque un fichero PDF puede almacenar.

Los campos que ya contienen valoresno se tocan en la actualización si elfichero de texto no lo especifica. Puedesincluso añadir nuevos campos clave(Corporación en nuestro ejemplo) y asig-narles valores. La siguiente llamadaactualiza la información:

pdftk ejemplo.pdf U

update_info info.txt U

output eg_meta.pdf

Los ficheros de entrada y salida no tie-nen permitido usar el mismo nombre. Enotras palabras, necesitas renombrarmanualmente el fichero de salida o usarun script de la shell para hacerlo.

Cumplimentado deFormularios PDFLos ficheros PDF pueden contener for-mularios con campos de formularioconocidos. Adobe desarrolló el formatoFDF, que es propietario pero abierto,para datos en formulario PDF. El Listado1 muestra un ejemplo de un fichero FDFresumido.

En el Listado 2 , T es el título, y V es elvalor del campo del formulario. Ahorapuedes unir el fichero PDF con el FDF ydecidir si los datos del formulario perma-necerán editables o estarán unidos inde-leblemente con el documento:

pdftk form.pdf fill_form U

eg.fdf output edit.pdfpdftk form.pdf fill_form U

eg.fdf output end.pdf flatten

El primer ejemplo ofrece los resultadoseditables. Sin embargo, la opción flattenen el segundo fichero indica que los cam-pos del formulario deberían estar unidosindeleblemente con el fichero PDF.

Las características del formulario tepermiten usar pdftk para crear formula-

LINUX USER • PDFTk

82 Número 12 W W W . L I N U X - M A G A Z I N E . E S

[1] Sid Steward: pdftk; Versión 1.12 (Nov.2004):http://www.accesspdf.com/pdftk/

[2] Sid Steward, PDF Hacks, O’Reilly,2004.

[3] Bruno Lowagie, Paulo Soares: iText-Library; Version 1.1 (Nov. 2004): http://itext.sourceforge.net

[4] GNU Compiler Collection, Version3.4.3 (Nov. 2004):http://gcc.gnu.org

RECURSOS

Opción ExplicaciónPrinting El documento puede ser impreso en la mejor calidad.DegradedPrinting El documento a imprimir será de calidad limitada.ModifyContents El documento que contiene puede ser modificado.Assembly El documento PDF puede ser concatenado con otros documentos PDF.CopyContents Texto e imágenes pueden ser copiadas desde el fichero.ModifyAnnotations Comentarios y anotaciones pueden cambiarse.FillIn Formularios en el fichero PDF pueden ser completados.AllFeatures El usuario tiene todos los privilegios especificados.

Tabla 2: Permisos PDF

080-082_PDFTkL12 16.11.2005 9:46 Uhr Página 82