W.Podemos convertir fácilmente cualquier página de manual de Linux a formato HTML, texto o PDF. Para mostrar páginas de documentación del manual en línea en el terminal en sistemas Linux, macOS, * BSD y similares a Unix, usamos el comando man. Sin embargo, algunas páginas de manual son largas y difíciles de buscar cuando menos o la mayoría de ellas se utilizan como buscapersonas. Por lo tanto, podemos convertirlos a formato HTML y hojearlos en un navegador web como Firefox.
Detalles de las instrucciones | |
---|---|
Nivel de dificultad | Fácil |
Derechos de root | sí |
requisito | man2html y groff |
Horario de verano europeo. Tiempo de leer | 4 minutos |
Diferentes formas de convertir páginas man a HTML en Linux
Podemos utilizar los siguientes enfoques para convertir administradores a formato HTML o PDF:
- man2html: formatea una página de manual en HTML en Linux o Unix
- groff: el troff es un sistema de procesamiento de documentos desarrollado por AT&T para el sistema operativo Unix. En Linux, las nuevas páginas de manual deben estar marcadas con el paquete o comando groff.
Instale Man2html en Linux
Utilice el comando apt / apt-get de la siguiente manera en Debian o Ubuntu Linux:sudo apt install man2html-base
Para CentOS / RHEL / Fedora Linux, use el comando dnf / yum de la siguiente manera:sudo dnf install man2html-core
Instale la utilidad man2html en CentOS / RHEL / Fedora Linux y clónelo
Instale Man2html en FreeBSD Unix
Para convertir las páginas de manual de nroff a HyperText Markup Language, instale man2html con el comando pkg:sudo pkg install man2html
Una nota sobre macOS
Abra la aplicación de terminal e instale Homebrew en macOS para usar el administrador de paquetes Brew. Finalmente, ingrese el siguiente comando de preparación:brew install man2html
Convertir la página de manual a HTML
La sintaxis es bastante simple:man2html /path/to/man.page.gz
Utilice el comando whereis para encontrar la ruta a la página del manual. Por ejemplo, averigüemos la ruta real del comando pwd:whereis pwd
En mi sistema tengo el camino como /usr/share/man/man1/pwd.1.gz, y luego todo lo que necesita hacer es escribir el siguiente comando para la conversión real a HTML:man2html /usr/share/man/man1/pwd.1.gz
Guardemos la página del manual en un archivo HTML llamado pwd.html con save > es el símbolo de redirección de salida. En otras palabras, queremos guardar la salida de man2html en un archivo:man2html /usr/share/man/man1/pwd.1.gz > pwd.html
Mostrar la página de manual guardada como HTML
Ahora todo lo que tiene que hacer es ingresar el siguiente comando de acuerdo con su sistema operativo para abrir este archivo HTML en un navegador web estándar:
## Linux/Unix with Xorg GNOME/KDE desktop type ## xdg-open pwd.html ## macOS user type ## open pwd.html
La página del comando man pwd se convirtió a HTML y se muestra en FF
¿Cómo convierto las páginas man de Linux a HTML usando groff?
Primero instalé groff en mi escritorio de Ubuntu:sudo apt install groff
[sudo] password for vivek: Reading package lists... Done Building dependency tree Reading state information... Done The following additional packages will be installed: psutils The following NEW packages will be installed: groff psutils upgraded, 2 newly installed, to remove and 2 not upgraded. Need to get 4,008 kB of archives. After this operation, 12.4 MB of additional disk space will be used. Do you want to continue? [Y/n] y Get:1 http://archive.ubuntu.com/ubuntu focal/universe amd64 groff amd64 1.22.4-4build1 [3,951 kB] Get:2 http://archive.ubuntu.com/ubuntu focal/universe amd64 psutils amd64 1.17.dfsg-4 [56.2 kB] Fetched 4,008 kB in 2s (1,760 kB/s) Selecting previously unselected package groff. (Reading database ... 343829 files and directories currently installed.) Preparing to unpack .../groff_1.22.4-4build1_amd64.deb ... Unpacking groff (1.22.4-4build1) ... Selecting previously unselected package psutils. Preparing to unpack .../psutils_1.17.dfsg-4_amd64.deb ... Unpacking psutils (1.17.dfsg-4) ... Setting up groff (1.22.4-4build1) ... Setting up psutils (1.17.dfsg-4) ... Processing triggers for install-info (6.7.0.dfsg.2-5) ... Processing triggers for man-db (2.9.1-1) ...
Luego convertí la página de manual a formato HTML usando la siguiente sintaxis:
whereis command zcat /usr/share/man/man$section/command.$section.gz | groff -mandoc -Thtml zcat /usr/share/man/man$section/command.$section.gz | groff -mandoc -Thtml > output.html
Puede usar el comando zcat para leer archivos de texto comprimido gzip y enviar esa salida a groff. Por ejemplo, convierta la página de manual del comando mkpasswd a HTML:
type -a mkpasswd whatis mkpasswd whereis mkpasswd zcat /usr/share/man/man1/mkpasswd.1.gz | groff -mandoc -Thtml > mkpasswd.html ls -l mkpasswd.html file mkpasswd.html xdg-open mkpasswd.html # OR # open mkpasswd.html
Conversión de una página de manual a HTML en Linux y Unix usando la utilidad groff
Resumir
Le mostramos cómo instalar varias utilidades y propósitos de conversión en sistemas Linux, macOS, FreeBSD y tipo Unix. Ingrese el siguiente comando man para leer otras opciones proporcionadas por estos comandos:man man2html
man groff
man zcat
Si tiene alguna pregunta o conoce otros métodos para hacer esto, hágamelo saber en la sección de comentarios a continuación.