El comando man bash produce mucha salida. Lo que deseo sería buscar los resultados o imprimirlos en papel. Entonces, ¿hay una manera de convertir una página de manual a un documento html y / o pdf?
Preferiría el trabajo de respuesta no solo para man bash , sino para cualquier página de manual.
Sé que la salida de man bash se ha publicado en Internet, pero generalmente estas publicaciones no son actuales.
Sí, hay numerosas herramientas para convertir páginas de manual a HTML y PDF.
Convertir una página de manual a HTML, PDF y texto proporciona instrucciones detalladas para macOS:
cat /usr/share/man/man1/osascript.1 | groff -mandoc -Thtml >man_osascript.html
Si el archivo termina en .gz , sustituya lo siguiente.
gunzip --to-stdout /usr/share/man/man8/cupsfilter.8.gz | groff -mandoc -Thtml >man_cupsfilter.html
Para convertir de HTML a PDF:
cupsfilter man_osascript.html > man_osascript.pdf
Para otras cadenas de herramientas, vea estas preguntas relacionadas:
Otro enfoque es utilizar la popular herramienta pandoc . Esta herramienta puede convertir páginas de manual a una amplia gama de formatos.
x-man-page
Terminal.app de macOS ofrece un esquema de URL x-man-page para imprimir bonitas páginas de manual. Intente abrir el siguiente enlace para ver la página de manual de ls :
x-man-page://ls
Aquí hay una función que agregué a mi archivo .bash_profile para crear un PDF de cada BSD comando Revisaría la página de manual para:
manp ()
{
docDir="$HOME/Documents/BSD Commands"
[[ ! -d $docDir ]] && mkdir -p "$docDir"
if [[ ! -f $docDir/$1.pdf ]]; then
man -t "$1" | pstopdf -i -o "$docDir/$1.pdf"
open "$docDir/$1.pdf"
else
open "$docDir/$1.pdf"
fi
}
Entonces, en Terminal , escribe, por ejemplo, manp bash en lugar de man bash se crea un PDF , si aún no lo ha hecho, y luego lo abre la aplicación registrada para manejar documentos PDF . El predeterminado es Vista previa , sin embargo, en mi sistema está configurado para usar Skim , ya que su funcionalidad de búsqueda es mejor que Vista previa y, de hecho, encontrará la cadena de búsqueda cuando Vista previa simplemente no.
Tenga en cuenta que la primera vez que se use la función , se enumerarán algunas fuentes en la salida en Terminal , sin embargo, esta es una enumeración de las fuentes una sola vez.
Como nota adicional, escriba solo el nombre de comando en Terminal y luego haga clic con el botón derecho y seleccione Abrir hombre Página , la muestra en una ventana Terminal completamente desplazable y con capacidad de búsqueda, que es mucho mejor que escribir, por ejemplo man bash .
man -t yourcommand | open -fa "Preview"
donde yourcommand es la página en la que desea la página de manual.
$ man -t tmutil | open -fa "Preview"
Lea otras preguntas en las etiquetas terminal bash command-line pdf html