¿Cómo hago para que las páginas man se abran en un navegador web?

39

¿Cómo puedo abrir las páginas de manual (desde el mancomando) en un navegador web para facilitar la navegación?

browser manpage kiri
fuente
linux.die.net/man - de esa manera tienes casi todo lo que puedas soñar. Hay scripts para transformar manuales en HTML, pero a menos que los transforme todos, los enlaces no funcionarán como se esperaba. También la legibilidad es excepcional en una consola también. ¿Quizás quisiste decir una mejor navegación?
Alexis Wilke
2
@kevin Prefiero usar un navegador web (estoy más familiarizado con él) y descubrí que gmanno respondería después de abrir una página
kiri
entendido. Gman puede usar un navegador, pero veo su punto. Además, carece de la capacidad de navegación. Acabo de publicar eso cuando agregó a su pregunta. ;-) también puedes echar un vistazo al paquete dwww.
Kevin Bowen
1
Puede que esta no sea su solución, pero en knoqueror, puede escribir man: <su comando >> para acceder a las páginas man en un navegador. Esto requerirá que instales las librerías kde.
crafter
Hay otra alternativa a linux.die.net para ver páginas de manual preprocesadas y embellecidas en línea: man7.org/linux/man-pages/index.html
Murphy

Respuestas:

52

Usando el programa man

Mirando la página del hombre, 

man man

Existe la -Hopción, o su equivalente, --htmlque generará el HTML para el manual y los abrirá en el navegador.

Esta opción hará que groff produzca salida HTML y mostrará esa salida en un navegador web. La elección del navegador está determinada por el argumento del navegador opcional si se proporciona uno, por la variable de entorno $ BROWSER, o por un valor predeterminado de tiempo de compilación si eso no está establecido (generalmente Lynx). Esta opción implica -t, y solo funcionará con GNU troff.

Entonces, para abrir cualquier página de manual en el navegador, simplemente use:

man -Hfirefox <command>

o 

man --html=firefox <command>

Los dos son iguales.

Se puede utilizar firefox, google-chrome, chromium-browsero cualquier otro en lugar de la firefoxpalabra.

Seleccione un navegador predeterminado de forma permanente

Antes de llamar al mancomando, use el siguiente comando:

export BROWSER=firefox

De esta forma, puede usar man -Ho man --htmlsin especificar el navegador cada vez.

man -H ls

También puede agregar el exportcomando anterior a su ~/.bashrcpara que no tenga que escribirlo cada vez que abra una nueva terminal e intente usarman -H

Solucionar problemas

Si tienes un error diciendo algo como esto:

man: command exited with status 3: /usr/bin/zsoelim | /usr/lib/man-db/manconv -f UTF-8:ISO-8859-1 -t UTF-8//IGNORE | preconv -e UTF-8 | tbl | groff -mandoc -Thtml

Necesitará instalar el groffpaquete.

sudo apt-get install groff

Usando Yelp

Si una elección de navegador no es relevante, puede usar el yelpcomando que ofrece navegación a través de las páginas man

yelp man:<command>
# example: yelp man:ls

Usando el repositorio Ubuntu Manpage

También puede visitar http://manpages.ubuntu.com/ y consultar casi todas las páginas man allí. Todas las versiones de las páginas man para todas las versiones de Ubuntu están disponibles allí. También presenta una funcionalidad de búsqueda.

Por supuesto, la desventaja de usar el sitio web es que no puedes acceder a él sin estar conectado a Internet.

Dan
fuente
Puede usar el comando xdg-open que también abriría el sistema defalt
exussum
y necesitarías groff instalado
exussum
@ user1281385 Iba a mencionarlo, pero tiene algunos problemas. Por ejemplo, mi valor predeterminado es Firefox. Si trato de usarlo, y ya tengo Firefox abierto, me muestra el error que dice Firefox is already running, but is not responding. To open a new window, you must first close the existing Firefox process, or restart your system.que mencioné la instalacióngroff
Dan
¡manpages.ubuntu.com parece útil!
Pisu
+1 ¡Gracias! Había escrito un guión completo para hacer esto hace un tiempo. ¡Esto es mucho más fácil!
Joe
13

manen realidad puede hacer mucho de esto por sí solo. Solo necesita instalar groffy luego puede usar la Hbandera.

sudo apt-get install groff
man -Hfirefox bash
Oli
fuente
6

man2html

Para buscar páginas de manual

Instalé el man2htmlpaquete y luego navegué http://localhost/cgi-bin/man/man2htmlpara ver las páginas de manual. Estas páginas se pueden ver sin conexión, enlazan con otras páginas de manual y cuentan con una función de búsqueda.
Fuente

Para abrir directamente una página (desde la línea de comando)

Hice este script aquí (no es corto), solo navega directamente a la página web (desde man2html) para una determinada página de manual. Puede abrir varias páginas de manual especificadas como argumentos de línea de comando. Guarde el script en algún lugar y dele permisos de ejecución ( chmod +x script.sh). Ejecútelo como ~/script.sh(suponiendo que esté guardado en el ~directorio) con páginas para abrir como argumentos. Para abrir algo como init(8), use ~/script "8 init".

dwww

Para buscar páginas de manual

Instale el dwwwpaquete y navegue http://localhost/dwww/man/1para buscar las páginas. Estas páginas se pueden ver sin conexión, enlazan con otras páginas de manual y cuentan con una función de búsqueda.

Para abrir directamente una página (desde la línea de comando)

Hice este script aquí (no es corto), solo navega directamente a la página web (desde dwww) para una determinada página de manual. Puede abrir varias páginas de manual especificadas como argumentos de línea de comando. Guarde el script en algún lugar y dele permisos de ejecución ( chmod +x script.sh). Ejecútelo como ~/script.sh page(suponiendo que esté guardado en el ~directorio) con páginas para abrir como argumentos. Para abrir algo como init(8), use ~/script init/8. Sin pcregrep, debe escribir /8todo el tiempo, con él, simplemente escriba el nombre de la página.

kiri
fuente