Tutoriales

Cómo convertir páginas Man a HTML en Linux y Unix

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
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:

  1. man2html: formatea una página de manual en HTML en Linux o Unix
  2. 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
0 upgraded, 2 newly installed, 0 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.



Publicaciones relacionadas

Deja una respuesta

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

Botón volver arriba