Como pasar las paginas del manual a PDF
Convertir las paginas de manual (man) a pdf
Debido a que es muy difícil recordar la cantidad de opciones y parámetros que los comando en GNU/Linux tienen a nuestra disposición, es común, muchas veces, acudir a las paginas de manual para refrescarlas o para conocer nuevas opciones y por que no hacer un estudio a fondo de estas, para sacarles el máximo provecho.
En caso de que queramos llevar esta documentación en algún dispositivo móvil, editarla como objeto de estudio o simplemente que nos sirva tenerla en algún formato otro formato para tener una consulta amigable, este articulo puede serte útil.
Si bien man nos permite la conversión a distintos formatos, en este caso veremos como pasar cualquier salida de manual al formato PDF.
Importante: Necesitamos tener instalado el paquete ps2pdf aunque casi todas las distribuciones ya lo traen por defecto.
Ver manual
Primero que nada, entendemos que para ver el manual de un comando es necesario entender su sintaxis. Esta responde a…
man [comando]
Para conocer mas sobre las paginas de manual te invito, a leer un articulo dedicado a este tema. Comando man.
Para el contenido de este articulo manipularemos el manual del comando ls, utilizado principalmente para listar contenidos de los directorios. Para solicitar su manual ejecutamos:
man ls
Donde obtendremos la siguiente salida…
… y podremos movernos como habitualmente estamos acostumbrados.
Conversión de formato
Ahora bien, para convertirlo en pdf, usaremos la opción -t que nos brinda el comando man, que llama a su vez al comando groff que es un potente comando para dar formato a documentos (typesetting), desde simples manuales hasta revistas y libros.
Si ejecutamos…
man -t ls
obtendremos la siguiente salida:
Como podrás observar, la salida del comando es totalmente ilegible, pero ya esta en forma PS (postscript).
Redireccionar salida
Para poder obtener el documento en PDF de la salida del man -t ls usaremos el paquetes ps2pdf, donde es necesario indicar el nombre que el documento va a llevar.
Es necesario ejecutar la orden con permisos de superusuario.
sudo man -t ls | ps2pdf – > manls.pdf
man -t ls y convertirlo a formato PDF, almacenando la salida de la combinación de ambos en el archivo de nombre indicado manls.pdf. Este documento se creara donde el cursor de la consola se encuentre posicionado. Si ejecutamos en nuestra consola pwd vas a ver la ruta en la que nos encontramos.
Puedes seguirnos en:
Ayudanos a mantener el sitio con una contribución.
Muchas gracias!
Espero sea de utilidad.
Saludos, Cristian Bellini.
