Convertidor online gratuito de POD a PDF

Un lector, sistema de archivo o flujo de trabajo de documentos puede aceptar PDF, pero no el formato de código fuente POD de Perl. Convertir POD a PDF produce un archivo de diseño fijo que se puede imprimir, compartir, archivar o visualizar sin herramientas de documentación de Perl.

Qué es el formato POD

POD significa Plain Old Documentation, el lenguaje de marcado ligero de Perl para documentar programas y módulos. Aparece en archivos independientes .pod y en secciones de documentación integradas en módulos .pm y scripts .pl.

Las directivas como =head1, =head2, =over, =item y =cut definen encabezados, listas y el límite entre la documentación y el código Perl. Las distribuciones de Perl, los paquetes de CPAN, los repositorios de código fuente, los manuales de Perl y los flujos de trabajo de documentación de Unix utilizan habitualmente POD. POD describe la estructura del documento en lugar de las páginas exactas, por lo que su apariencia depende del renderizador.

Qué es el formato PDF

PDF es un formato orientado a páginas que almacena las dimensiones de las páginas, la posición del texto, las fuentes, las imágenes, los enlaces y los gráficos vectoriales. Normalmente conserva la paginación y el diseño en distintos sistemas operativos y visores de PDF, por lo que resulta adecuado para imprimir, compartir, archivar y utilizar en sistemas de gestión documental.

PDF es un formato de distribución, no una fuente editable ideal. Conserva el archivo original .pod, .pm o .pl para realizar cambios en el futuro.

Cómo convertir POD a PDF

Usar 101convert.com

1. Abre el convertidor de POD a PDF en 101convert.com.
2. Sube el archivo fuente .pod o selecciona un archivo de código fuente Perl compatible que contenga documentación POD.
3. Elige PDF como formato de salida e inicia la conversión.
4. Descarga el PDF generado y comprueba sus encabezados, listas, bloques de código, enlaces, caracteres y saltos de página.

Esta opción no requiere instalar Perl ni LaTeX y está disponible de forma gratuita en 101convert.com. No subas código fuente confidencial ni documentación privada a menos que las condiciones de gestión y conservación del servicio sean aceptables.

Convertir localmente con HTML

pod2html se incluye con muchas instalaciones de Perl. En Windows, Strawberry Perl proporciona Perl y las utilidades POD más utilizadas.

1. Abre un terminal en el directorio que contiene el código fuente.
2. Genera HTML a partir de un archivo POD independiente:

pod2html --outfile=manual.html manual.pod

El mismo comando puede procesar un módulo o script que contenga POD:

pod2html --outfile=manual.html Module.pm

Solo se renderizan las secciones POD; el código Perl situado fuera de esas secciones no se ejecuta ni se formatea como documentación.

3. Abre manual.html en Chrome, Chromium, Microsoft Edge o Firefox.
4. Elige Print → Save as PDF, selecciona el tamaño del papel y los márgenes, y guarda el resultado como manual.pdf.
5. Revisa los encabezados, pies de página, escala, gráficos de fondo, enlaces, sangría del código y saltos de página antes de distribuir el archivo.

Para obtener una salida repetible basada en el navegador, Chromium puede imprimir el HTML sin abrir un cuadro de diálogo:

chromium --headless --disable-gpu --print-to-pdf=manual.pdf file:///absolute/path/manual.html

Sustituye chromium por el nombre del ejecutable instalado. Utiliza una URL absoluta file://; las rutas relativas pueden fallar en el modo headless.

Convertir localmente con LaTeX

pod2latex crea un documento LaTeX que una distribución de LaTeX, como TeX Live o MiKTeX, puede compilar en PDF. Es posible que la utilidad deba instalarse por separado de Perl.

1. Genera LaTeX a partir del código fuente POD:

pod2latex -out manual.tex manual.pod

2. Compila el archivo generado:

pdflatex manual.tex

Ejecuta pdflatex de nuevo cuando el documento contenga una tabla de contenido o referencias cruzadas. Este método puede ofrecer una tipografía y una paginación de documentos largos más uniformes que la impresión desde el navegador, pero su salida depende de los paquetes y las fuentes de LaTeX instalados.

Controlar el diseño y la codificación

Para la salida HTML, añade una hoja de estilos:

pod2html --css=manual.css --title="Manual" --outfile=manual.html manual.pod

El CSS de impresión puede establecer los márgenes de página y evitar que los bloques de código se dividan:

@page { margin: 20mm; } pre { break-inside: avoid; }

La configuración de impresión del navegador sigue controlando el tamaño del papel, la escala, los encabezados, los pies de página y la representación del fondo. Mantén disponibles las hojas de estilos locales y las imágenes referenciadas al abrir el HTML.

Declara la codificación del código fuente cuando haya caracteres no ASCII:

=encoding utf8

Coloca la declaración cerca del principio del documento POD. El navegador o motor de LaTeX seleccionado también debe utilizar una fuente que contenga los glifos necesarios.

Limitaciones de calidad y compatibilidad

Los distintos renderizadores de POD pueden colocar los encabezados, las listas, el código literal, los enlaces y las tablas de manera diferente. Es posible que pod2html y pod2latex no reproduzcan exactamente la salida del terminal, el estilo de las páginas de manual de Unix, el comportamiento de formateadores personalizados, el HTML sin formato, las directivas específicas de un formateador ni las extensiones POD no estándar.

Comprueba las listas anidadas, el código con sangría, los caracteres escapados, los símbolos Unicode, los hipervínculos, las imágenes, las tablas y los saltos de página. Los enlaces a archivos locales, módulos instalados o páginas de manual generadas pueden dejar de funcionar después de la conversión. Los bloques de código muy largos aún pueden dividirse entre varias páginas aunque se especifique break-inside: avoid. Los glifos ausentes suelen aparecer como cuadros vacíos y requieren una fuente compatible con Unicode. Conserva el código fuente POD como documento editable principal.