Excelente tip para convertir páginas MAN a PDF
Cuantas veces nos hemos encontrado en una situación donde teniendo que hacer uso de algún comando desconocemos las opciones o la sintaxis del mismo, muchas seguro. Es en ese momento donde acudimos al uso de la opción «–help» para ver si nuestra consola nos devuelve una información más detallada del mismo.
En caso de que esta no sea suficiente siempre nos queda el recurso de acudir a los famosos manuales incluidos en nuestro flamante linux (man pages), pero y ¿si queremos llevar con nosotros esta valiosa información para leerla en la playa por ejemplo, o en clase de informática?
Pués para permitir una consulta un poco más amigable del comando man o para aquellos que como anteriormente mencioné quieran esta información disponible en PDF (para imprimir por ejemplo), les dejo este tutorial sencillo de como realizar la conversión.
NOTA: Necesitamos tener instalado el paquete ps2pdf aunque casi todas las distribuciones ya lo traen por defecto.
1- Para ver el manual de un comando tecleariamos en consola lo siguiente:
[raregazz@localhost ~]$ man netstat
Y esto es lo que nos arrojaría por consola.
En la pantalla nos aparecerán formateadas las páginas del manual correspendientes al comando ‘netstat’.
Ahora bien, para convertirlo en pdf, usaremos la opción -t de man
que llama a su vez al comando groff
que es un poderoso comando para dar formato a documentos (typesetting), desde simples manuales hasta revistas y libros.
[raregazz@localhost ~]$ man -t netstat
Si lo hiciste en tu equipo, podrás observar que la salida del comando es totalmente ilegible, pero ya esta en forma PS (postscript), entonces la salida de este comando la redireccionamos al comando ps2pdf.
[raregazz@localhost ~]$ man -t netstat | ps2pdf – > netstat.pdf
A ver así:
man -t netstat | ps2pdf - > netstat.pdf
¡Bien!
Con ayuda de http://www.ascii.cl/htmlcodes.htm
Se usa lo que dice la línea que dice al final «minus sign – hyphen». Es decir en vez de poner el guión se pone et (ampersand), almohadilla, 45, punto y coma.
¡Gracias!
El guión (el segundo, solito) es medio y corto. Así, el comando correcto es (a no ser que se convierta el segundo guión corto en largo):
man -t netstat | ps2pdf – > netstat.pdf
Con permiso …
*** Alternativa a man comando > fichero.txt para «mdoc warning: Empty input line» (dónde man pages) ***
Si ejecutas en el terminal …
man un_comando_cualquiera p.e.
man ls … puedes leer mucha información sobre dicho comando, al acceder a la página del manual (man page) correspondiente.
Para volcar a un fichero de texto los datos basta con ejecutar …
man un_comando_cualquiera > archivo_de_texto.txt p.e.
man ls > man_ls.txt la extensión «.txt» no es necesaria pero creo que ayuda a reconocer fácilmente un archivo de texto, distinguiéndolo de los demás (este apellido es habitual entre los ficheros de texto).
Pero a veces nos encontramos con mensaje(s) del tipo:
mdoc warning: Empty input line #un_número p.e. a mí con el live USB de Linux Mint 15 (Olivia) MATE me pasa con:
man tar > man_tar.txt
En realidad el fichero de texto se crea, y aparentemente bien. Pero si queremos una alternativa que no ofrezca errores podemos ejecutar …
cp /usr/share/man/man1/tar.1.gz /home/mint/Desktop/ gzip -d /home/mint/Desktop/tar.1.gz Obtendremos el fichero tar.1 , que ya podemos abrir para leer su contenido. Tiene lo mismo que man_tar.txt pero con códigos sobre cómo mostrar la información. Es decir, para leer es mejor man_tar.txt .
Con todo esto, ya sabemos en qué carpeta o directorio están localizados los ficheros de las man pages en Linux Mint MATE:
/usr/share/man/
***********
Fuente: http://www.lawebdelprogramador.com/foros/Linux/1451789-Alternativa_a_man_comando_fichero.txt_para_mdoc_warning_Empty_input_line_donde_man_pages.html
Hola!!
me parece muy buena la aportación… sabes si además desde consola hay algún comando para dar poner el pdf en modo apaisado?
Gracias
Carmen Domínguez
Sinceramente no he utilizado nunca una función similar bajo consola, pero puedes echarle un vistazo a este proyecto http://pdfread.sourceforge.net/
Aunque principalmente es para convertir PDF a formatos de lectores de libros electrónicos tiene una opción de rotación de documentos. No se si te servirá…
Usage: pdfread [options] input-document
Options:
-h, –help show this help message and exit
-p PROFILE one of: reb1200, prs500-l, eb1150, reb1200-p, prs500,
reb1100
-o OUTPUT the output filename
-t TITLE generated ebook title (default: «Unknown»)
-a AUTHOR generated ebook author (default: «Unknown»)
-c CATEGORY generated ebook category (default: «General»)
-f FORMAT one of: imp2, imp1, html, rb, lrf
-i FORMAT one of: pdf, imglist, djvu, tiff
-m MODE one of: portrait, landscape-half, landscape
-u ARGS command line arguments for unpaper
-d DIR the temporary directory where images are generated
–first-page=PAGE first page to convert
–last-page=PAGE last page to convert
–optimize optimize generated PNG images
–crop-percent=N% whitespace cropping percentage (default: 2.0%)
–edge-level=L edge enhancement level from 1-9 (default: 5)
–dpi=DPI the DPI at which to perform dilation (default: 300)
–colors=N downsample the output image to N grayscale colors
–mono downsample the output image to monochrome
–rotate=DIRECTION one of: none, right, left <———-ESTA SERÍA LA OPCIÓN
–count=N consider that the document has N pages
–hres=HRES the maximum usable horizontal resolution
–vres=VRES the maximum usable vertical resolution
–overlap=OVERLAP screen overlap between pages (in pixels)
–no-crop disable the cropping stage
–no-dilate disable the dilation stage
–no-enhance disable the edge enhancement stage
–no-toc disable the generation of Table of Contents
–list-profiles show the various profiles and their settings
UN SALUDO Y MUCHAS GRACIAS POR PASAR
Gran tip!
Saludos.
Gracias compañero, como le dije a Carlos trataré de seguir posteando tips de este estilo.
Un saludo y gracias por pasarte. 😉
Holap:
Excelente… leer los manuales desde la consola es un fastidio… xD
Gracias por la infoo…
Saludooos 😛
Hola Carlos, y bienvenido.
Gracias por tu comentario.
Decirte que yo personalmente y en ciertas ocasiones me encuentro más cómodo realizando algunas tareas en consola que de forma gráfica, pero eso no quita que mucha gente (por no decir la mayoría) prefieran el modo gráfico por todas las ventajas que en él encuentran (más intuitivo, amigable, etc).
El motivo de esta entrada es facilitar a esa gente la utilización de la documentación que linux nos proporciona pero de una manera más asequible quizás.
En la medida de lo posible iré realizando más «tips» para conseguir hacer más amigable a estas personas el trabajo con este S.O.
Un saludo y muchas gracias.