¿Qué es una página de manual ?
Una página man (abreviatura de página manual) es la forma tradicional de documentación de software en un sistema operativo tipo Unix como Ubuntu. Para la gran mayoría de comandos y programas, hay una página de manual que enumera sus opciones y explica su uso.
¿Cómo puedo encontrar y ver páginas de manual?
Desconectado en una terminal
Las páginas man se instalan automáticamente en su sistema junto con los comandos que describen. Para ver y buscar páginas de manual, está el comando man
:
man mv
muestra la página de manual de mv
while
man -k mv
busca nombres y descripciones cortas de todas las páginas man instaladas para la cadena mv
. Las expresiones regulares extendidas POSIX están permitidas y es una búsqueda , por lo que también encontrará, por ejemplo , git-mv
y semver
, si desea buscar exactamente, mv
use ^mv$
en su lugar.
Vea ¿Cuál es la diferencia entre `man` y` man (#) `? para leer sobre las secciones de la página man. Para más información lea man
la página del manual. ;)
¿Cómo puedo influir en cómo se muestra una página de manual?
El programa predeterminado para mostrar páginas man es less
. Este llamado buscapersonas proporciona una útil función de búsqueda, solo ingrese /
seguido del término de búsqueda, por ej.
/--version
y presione Enter. Esto marcará cada hallazgo y se desplazará al primero. Presione Npara ir al siguiente hallazgo y ⇧ Shift+ Npara ir al anterior (consulte ¿Cómo puedo buscar dentro de una página de manual? ). Para obtener una lista de comandos H, presione , para salir, less
presione Q.
Además less
hay otros buscapersonas disponibles pg
, most
y w3m
solo para enumerar tres. Recomiendo most
: viene con un colorido muy útil de palabras clave que hace que una página de manual sea mucho más fácil de leer y navegar, compruébelo usted mismo:
Para ver una página de manual en un localizador diferente al predeterminado, use la -P
opción, por ejemplo:
man -P most mv
Si desea cambiar las páginas de manual del buscapersonas predeterminado , tiene dos opciones:
change the default pager solely of man
export MANPAGER=most
Para que el cambio sea persistente, agregue este comando a su ~/.bashrc
archivo.
cambiar el localizador predeterminado de todo su sistema
sudo update-alternatives --config pager
Los fanáticos pueden incluso usar (ab) vim
como MANPAGER
, vea este artículo escrito por muru .
Las páginas man se muestran en la fuente especificada en la configuración del emulador de terminal. Si trabaja regularmente con el terminal, es posible que desee cambiar esta fuente; Solo puedo recomendar Hack, un tipo de letra diseñado para el código fuente , mira la captura de pantalla de arriba por su belleza.
Fuera de línea a través de GUI
Una manera agradable y fácil de mostrar páginas de manual con una GUI simple es el yelp
programa preinstalado . Para iniciar una página de manual con yelp
execute yelp man:PROGRAM
o gnome-help man:PROGRAM
, por ejemplo:
yelp man:mv
También puede ver páginas de manual con su navegador preferido , consulte ¿Cómo hago que las páginas de manual se abran en un navegador web? , por ejemplo, man mv
en firefox
:
man -Hfirefox mv
Por último, pero no menos importante, puede convertir páginas de manual a PDF y verlas con su visor de PDF preferido, consulte: ¿Hay alguna manera de imprimir información / páginas de manual a PDF?
En línea
Puede ver las páginas de manual de los programas disponibles a través de los repositorios de cada versión de Ubuntu actualmente compatible con la URL abreviada manpg.es/PROGRAM
, por ejemplo, http://manpg.es/mv . Esto abre mv
la página de manual de la última versión de Ubuntu, puede elegir una versión diferente en la barra superior. Para buscar páginas de manual, puede utilizar, por ejemplo, http://manpages.ubuntu.com/cgi-bin/search.py?q=mv .
Como se explicó anteriormente man
, solo puede mostrar páginas de manual del software instalado en el sistema. Para ver páginas de manual de http://manpages.ubuntu.com usando un localizador de terminales, hay dman
disponible en el bikeshed
paquete.
Otras fuentes
Cuando lees documentación de otras fuentes en línea, es una buena idea vigilar la versión del programa. La mayoría de los programas tienen una --version
opción que muestra la versión del programa en cuestión, p. Ej.
$ mv --version
mv (GNU coreutils) 8.25
Hay muchos sitios web que se dedicaron a hacer que las páginas de manual estén fácilmente disponibles, solo voy a presentar los dos que más me gustan:
- man7.org viene con resaltado de sintaxis útil, pero presenta solo la última versión lanzada del programa
- manpag.es aloja las páginas man de los lanzamientos de Ubuntu hace mucho tiempo EOL
Fuente no vinculada: https://wiki.ubuntuusers.de/man/