Las páginas de manual o simplemente páginas de manual son la documentación que está disponible con cada herramienta de línea de comandos o aplicación que se nos presenta en un sistema Linux. Estos tipos de documentación incluyen temas de herramientas de línea de comandos, llamadas al sistema, programas e incluso conceptos abstractos.
Para leer una página de manual simplemente escriba
man <package>
Las páginas de manual suelen ser monótonas (como se desprende de la imagen de arriba), los usuarios generalmente evitan leer la documentación simplemente porque carecen del atractivo de legibilidad para los usuarios. Cuando tomamos notas, solíamos resaltar un punto importante y el encabezado se puede hacer en las páginas de manual mediante el resaltado selectivo de colores del texto. Para hacer que esta documentación sea atractiva para el usuario, simplemente podemos agregar este tipo de efectos visuales a estas páginas de manual.
Las siguientes son algunas formas de ver páginas man coloridas y atractivas:
1. A través de ajustes a .bashrc:
Al realizar cambios en el archivo .bashrc, podemos tener un esquema de color agradable para nuestras páginas man. Podemos especificar el esquema de color individual especificándolos a través de las variables LESS_TERMCAP dentro de nuestro perfil .bashrc. La variable Termcap es de una biblioteca que utiliza Less para acceder al terminal.
Para modificar esos cambios, siga estos pasos:
1. Ábrelo dentro de un editor. Usaremos nano para ello.
sudo nano ~/.bashrc
2. Luego agregaremos la variable de esquema de color listada. Estos códigos de color están de acuerdo con tres valores de rojo (31), verde (32) y amarillo (33). Los colores junto con los códigos de escape con valores de reinicio/normal (0), negrita (1) y subrayado (4) dan un buen formato y coloración a las páginas del manual.
export LESS_TERMCAP_mb=$'\e[01;31m' # begin blinking export LESS_TERMCAP_md=$'\e[01;37m' # begin bold export LESS_TERMCAP_me=$'\e[0m' # end all mode like so, us, mb, md, mr export LESS_TERMCAP_se=$'\e[0m' # end standout-mode export LESS_TERMCAP_so=$'\e[45;93m' # start standout mode export LESS_TERMCAP_ue=$'\e[0m' # end underline export LESS_TERMCAP_us=$'\e[4;93m' # start underlining
Nota: Para tener este efecto de coloración solo en las páginas de manual y no en todos los programas que usan LESS, podemos incluir todo el código anterior en una función de shell que se nombrará como man. Dentro de la llamada a la función, una vez que los valores del código de color estén configurados para nosotros, también llamará al programa real man.
man() {
LESS_TERMCAP_mb=$'\e[01;31m'
LESS_TERMCAP_md=$'\e[01;31m' \
LESS_TERMCAP_me=$'\e[0m' \
LESS_TERMCAP_se=$'\e[0m' \
LESS_TERMCAP_so=$'\e[45;93m' \
LESS_TERMCAP_ue=$'\e[0m' \
LESS_TERMCAP_us=$'\e[4;93m' \
command man "$@"
}
3. Active el archivo con el comando fuente.
source ~/.bashrc
Ahora, al ver la misma página de manual de printf, podemos ver que las opciones selectivas se resaltan y colorean. Esto nos ayuda a identificar las opciones necesarias y las banderas asociadas con el hombre de printf.
El código escrito arriba es una secuencia de colores ANSI que podría entenderse con esta sintaxis:
# Taking a simpler example export LESS_TERMCAP_mb=$'\e[1;32m'
- El $’xxxx’ significa interpretar caracteres con barra invertida como \e o \n
- \e es el carácter de escape (ASCII 27 decimal)
- 1 es «negrita»
- ; delimita colores
- 32 es «verde»
- m es el final de la secuencia de colores
Puede hacer más combinaciones de este tipo haciendo referencia a este artículo de Wikipedia sobre la secuencia de escape ANSI.
2. Uso del buscapersonas MOST:
Comience instalando la terminal más utilizada.
sudo apt install most
Ahora agregue MOST como el buscapersonas predeterminado, agréguelo al perfil .bashrc.
sudo nano ~/.bashrc
Agregue la siguiente línea al perfil
export PAGER="most"
Conclusión:
¡Con estas dos opciones, no solo estamos haciendo que nuestros documentos sean bonitos! Con estas personalizaciones, es más fácil desplazarse por las largas páginas man. La legibilidad mejora significativamente y ahora es difícil perderse una información importante. Ahora, las opciones y los parámetros se resaltan para usted y es mucho más fácil detectarlos.