viernes, 14 de enero de 2011

Convertir los Manuales (man) a PDF

A continuación mostrare un pequeño truco de como convertir los manuales de linux (man) en archivos PDF (Portable Document Format - Formato de Documento Portable).
Primero nos ubicamos en una terminal como usuario normal (no hace falta ser root) y buscamos cual manual (man); por ejemplo
$man chmod

seguidamente te mostrara el man de chmod donde te explica su uso y sintaxis; nos salimos y le damos ahora al siguiente comando:
$man -t chmod

** La opcion -t sifnifica: Formatea la página de manual referenciada por `alias', generalmente una página de manual de tipo shell, usando el formato predeterminado troff o groff y redirige la salida a la impresora llamada ps.  La salida predeterminada de groff generalmente es  PostScript.   man  --help  debería informarle de que procesador está siendo usado con la opción -t.

Una vez realizado el paso anterior nos tienes que mostrar algo como se indica en la imagen:

Como se puede observar, la salida que arroja el comando no se puede entender ya que esta en PS (postscript); pero el mismo lo redireccionamos con ps2pdf (herramienta para convertir archivos PS y EPS a formato PDF); el cual seria de la siguiente manera:
$man -t chmod | ps2pdf - > chmod.pdf

Y listo, fácil y rápido; ya tienes tu archivo  man chmod en archivo PDF.

saludos

Fuentes: