Latinoamérica
de.novatoanovato@gmail.com

Como pasar las paginas del manual a PDF

Dedicado al nuevo usuario de software libre

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

Lo que hace esta sentencia es pasar un argumento al comando ps2pdf, que en este caso es la salida obtenida por el comando previo: 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.
Como vemos nos encontramos el la carpeta del usuario, por ende, el documento se creara allí. Vemos..
Si vamos al directorio del usuario, encontraremos el documento manls.pdf ya creado…
Y ya tendremos el manual del comando ls en formato pdf.

Puedes seguirnos en:

Ayudanos a mantener el sitio con una contribución.
Muchas gracias!

Espero sea de utilidad.
Saludos, Cristian Bellini.

 

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *