Dieciséis años después del siglo XXI, sigo desconcertado de que todavía tengamos que salirnos de nuestro camino si queremos ver una página de manual.
Hay sitios web tentadores con páginas de manual HTML que tienen enlaces, como este , 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 ha instalado a través de Homebrew, etc.
¿Hay una solución a este problema? He mirado y mirado. Este
function manp {
man -t "$1" | open -f -a /Applications/Preview.app/
}
renderiza 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 man para man dice:
PÁGINAS HTML
Man encontrará páginas HTML si viven en directorios llamados ".html", por lo que un nombre válido para una versión HTML de la página de manual de ls(1) sería /usr/share/man/htmlman1/ls.1 .html.
Podría escribir un script para convertir todas las páginas del manual en todas partes de mi sistema a HTML, pero apuesto a que alguien ya lo ha hecho. Y apuesto a que también han resuelto el problema de representar las referencias VER TAMBIÉN como enlaces, lo que aparentemente el comando man no hace.
Instale Bwana , que le permite navegar por las man
páginas en su navegador favorito.
Para citar la página anterior, "Simplemente escriba" hombre: "seguido de la página del manual que está buscando en el campo URL de su navegador. Presione enter y deje que Bwana haga el resto". Tiene enlaces en vivo.
bcat le permite conectarse stdout
a su 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 man
el buscapersonas:
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 de 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 producir HTML de una vez o por adelantado, esta publicación en Unix.se tiene una serie de sugerencias (lamentablemente, una de mis herramientas favoritas, la poderosa pandoc
, no no trabajo para esto...)
daveyost
PedroVP