¿Cuál es la manera fácil de convertir todas las páginas de manual a html?

Navega tus respuestas
1

Dieciséis años en el siglo XXI, me siento desconcertado por el hecho de que todavía tenemos que salir de nuestro camino si queremos ver una página de manual

  • representado en una fuente proporcional (es decir, no Courier o similar)
  • con enlaces a otras páginas de referencia

Hay sitios web tentadores con páginas man de HTML que tienen enlaces, como esto , pero No he encontrado un sitio con páginas actualizadas para la versión actual de macOS. Y, por supuesto, un sitio web no mostrará páginas de manual para el software que haya instalado a través de Homebrew, etc.

¿Hay una solución a este problema? He mirado y mirado. Esto 

function manp {
  man -t "$1" | open -f -a /Applications/Preview.app/
}

muestra una página y la muestra en Vista previa (después de esperar a que un intérprete de PostScript la convierta a PDF), pero no obtiene enlaces en vivo.

La página de manual para hombre dice:

  

PÁGINAS HTML

     

Man encontrará páginas HTML si viven en directorios con el nombre que se espera que sea ".html", por lo tanto, un nombre válido para una versión HTML de la página del manual de ls (1) sería / usr / share / man / htmlman1 / ls.1.html.

Podría escribir un script para convertir todas las páginas man en cualquier parte de mi sistema a HTML, pero apuesto a que alguien ya lo ha hecho. Y apuesto a que también resolvieron el problema de hacer que SEE TAMBIÉN las referencias sean enlaces, lo que aparentemente no tiene el comando man.

    
pregunta daveyost 15.12.2016 - 03:16

2 respuestas

2

Instala Bwana que te permite navegar por las páginas man en tu navegador favorito.

Para citar la página de arriba "Simplemente escribe" man: "seguido de la página de manual que estás buscando en el campo de URL de tu navegador. Pulsa Intro y deja que Bwana haga el resto". Tiene enlaces en vivo.

    
respondido por el Tony Williams 15.12.2016 - 05:39
1

bcat te permite canalizar stdout a tu navegador predeterminado. Una alternativa a su función de vista previa sería: 

bman () 
{ 
    : Display man page in default browser
    man $* | col -b | bcat
}

... o simplemente configure el buscapersonas de man : 

export MANPAGER='col -b | bcat'
man grep

bcat funciona con cualquier comando que escriba en stdout : 

pbpaste  | bcat
make test | bcat
tail -n 1000 -f /var/log/messages | bcat

... etc.

Es una gema rubí, por lo que la instalación es tan fácil como: 

gem install bcat

Si la conversión "sobre la marcha" no es suficiente y desea generar HTML de una vez, o por adelantado, esta publicación en Unix.se tiene varias sugerencias (por desgracia, una de mis herramientas favoritas, el poderoso pandoc , no funcionará para esto ...)

    
respondido por el John N 15.12.2016 - 09:22

Lea otras preguntas en las etiquetas

¿Tendré consecuencias o problemas si instalo XQuartz? La llave USB se comporta como un CD