Alternatives To Man Pages

Las páginas de manual (abreviadas como man), son una documentación de software que se encuentra en todos los sistemas operativos tipo Unix. Algunas páginas de manual son cortas; algunas son completas. Una página de manual consta de varias secciones como NOMBRE, SINOPSIS, CONFIGURACIÓN, DESCRIPCIÓN, OPCIONES, ESTADO DE SALIDA, VALOR DE VUELTA, ERRORES, AMBIENTE, ARCHIVOS, VERSIONES, CONFORMIDAD, NOTAS, ERRORES, EJEMPLO, AUTORES y VER TAMBIÉN. A veces, me resulta muy lento cuando quería aprender un ejemplo práctico de un comando Unix dado. Por lo tanto, empecé a buscar algunas buenas alternativas a las páginas de man que se centran en la mayoría de los ejemplos, omitiendo todas las demás partes de texto completo. Afortunadamente, hay algunas alternativas muy buenas por ahí.

En este tutorial, hablaremos de 3 buenas alternativas a las páginas de manual para sistemas operativos tipo Unix.

Bropages

Bropages son como páginas de man, pero sólo ejemplos. Como dice su lema, se salta toda la parte de texto y sólo le da los ejemplos concisos para los programas de línea de comandos.

Bropages se pueden instalar fácilmente usando gem. Por lo tanto, necesita Ruby 1.8.7+ instalado en su máquina para que esto funcione. Para instalar Ruby on Rails en CentOS y Ubuntu, consulte la siguiente guía.

Después de instalar gem, todo lo que tienes que hacer para instalar bro es:

gem install bropages

Uso

El uso es increíblemente fácil. Para obtener los ejemplos de cómo utilizar cualquier comando en Unix,  find, simplemente escriba:

bro find

Es así de simple. Verá un puñado de ejemplos de comando de búsqueda comisariados por la comunidad.

 

Pulse ENTER para ver todos los ejemplos. Para salir, simplemente escriba q.

La cosa buena es que puede votar positivo o negativo o los ejemplos. Puede ver cómo enviar sus votos a un ejemplo concreto debajo del comando de ejemplo respectivo. Como se ve en la captura de pantalla anterior, podemos subir al primer comando introduciendo el siguiente:

bro thanks

Se le pedirá que ingrese su ID de correo electrónico. Ingrese un Email válido para recibir el código de verificación. Y, copie/pegue el código de verificación en el mensaje y pulse ENTER para enviar su voto. Los ejemplos más altos se mostrarán en la parte superior.

Bropages.org requires an email address verification to do this
What's your email address?
sk@senthilkumar.com
Great! We're sending an email to sk@senthilkumar.com
Please enter the verification code: apHelH13ocC7OxTyB7Mo9p
Great! You're verified! FYI, your email and code are stored locally in ~/.bro
You just gave thanks to an entry for find!
You rock!

Para votar positivo el segundo comando, escriba:

bro thanks 2

Del mismo modo, para votar negativo el primer comando, ejecute:

bro ...no

Para bajar el segundo comando:

bro ...no 2

También puede enviar su propio ejemplo para encontrar el comando usando:

bro add find

 

Genial, ¿no? Simplemente instale las páginas bro y haga su línea de comandos más fácil.

¿No le gustan las páginas bro? No hay problema. Aquí hay dos alternativas más.

Cheat

Cheat es otra alternativa útil a las páginas man para aprender comandos de Unix. Le permite crear y ver hojas de cheats interactivas en la línea de comandos.

La forma recomendada para Cheat es usar pip. Pip se puede instalar utilizando cualquiera de los siguientes métodos dependiendo de la distribución que utilice.

En Arch Linux y sus derivados, ejecute el siguiente comando para instalar pip:

 

sudo pacman -S python-pip

En DebianUbuntuLinux Mint:

sudo apt-get install python-pip
sudo -H pip install –upgrade pip
sudo -H pip install setuptools

En RHELFedoraCentOS:

sudo yum install python-pip

O,

sudo dnf install python-pip

En SUSE/openSUSE:

sudo zypper install python-pip

Una vez instalado pip, instale Cheat usando pip:

sudo pip install cheat

Uso

El uso de Cheat es trivial. Para ver la hoja de cheats de cualquier comando, find:

cheat find

Se le presentará la lista de ejemplos disponibles de comando find:

 ¿Ve? Cheat muestra muchos ejemplos de comandos de búsqueda en un formato legible por humanos. No es necesario utilizar las páginas de manual o Google para saber cómo utilizar el comando find. Para ver la lista de todas las fichas disponibles, ejecute:

 

cheat -l

Para ver la sección de ayuda:

cheat -h

 

TLDR

TLDR es una colección de páginas de manual simplificadas y dirigidas por la comunidad. A diferencia de las páginas de manual, las páginas TLDR sólo se centran en ejemplos prácticos.

TLDR se puede instalar usando npm. Por lo tanto, necesita NodeJS instalado en su máquina para que esto funcione.

Para instalar NodeJS en Linux, consulte la siguiente guía.

Cómo instalar Node.js en Linux
Después de instalar npm, ejecute el siguiente comando para instalar TLDR.

sudo npm install -g tldr

 

Los clientes TLDR también están disponibles para Android. Instale cualquiera de las siguientes aplicaciones de Google Play Sore y accede a las páginas TLDR desde sus dispositivos Android.

tldr-viewer
tldroid
Hay muchos clientes TLDR disponibles. Puedes verlos todos aquí.

Uso

Para mostrar la documentación de cualquier comando, find,:

tldr find

Verá la lista de ejemplos disponibles del comando find.

Como se ve en la captura de pantalla anterior, TLDR sólo muestra los ejemplos concisos. Ninguna descripción extensa, ningún detalle del autor, ninguna explicación de interruptores y argumentos. Sólo muestra la descripción de comandos de búsqueda y ejemplos de uso. Si hubiera visto las páginas de man del comando find, sería bombardeado con muchos detalles completos.

Para ver la lista de todos los comandos de la caché, ejecute:

 

tldr --list-all

Para ver ayuda:

tldr -h

 

Entrada original

(Visitada 1 veces, 1 visitas hoy )