Cómo acortar páginas de manual a explicaciones legibles en Linux y macOS

Cómo acortar páginas de manual a explicaciones legibles en Linux y macOS / Linux

Cuando todo lo demás falla, lea el manual. Línea de comandos Una guía rápida para comenzar con la línea de comandos de Linux Una guía rápida para comenzar con la línea de comandos de Linux Puede hacer muchas cosas increíbles con comandos en Linux y realmente no es difícil de aprender. Lea más usuarios en Linux y Mac saben que pueden escribir “hombre” seguido de un nombre de comando para ver una explicación larga y detallada de ese comando. Estas páginas de manual son útiles pero detalladas. A veces, todo lo que necesita es una explicación breve y concisa de un comando para actualizar su memoria.

Esta es una manera fácil de obtener explicaciones prácticas y concisas de los comandos utilizados en la línea de comandos. Principales sitios web y libros para transformarlo en un héroe de la línea de comandos de Linux Los mejores sitios web y libros para transformarlo en un héroe de la línea de comandos de Linux La línea de comandos de Linux es extremadamente Herramienta poderosa, pero también puede ser intimidante. Utilice estos sitios web y libros para controlarlo. Leer más en Linux y Mac. Es una aplicación de línea de comandos llamada “tldr”, después de la abreviatura de “demasiado largo; no leí”. los tl; dr abreviatura se utiliza para escribir o solicitar una versión abreviada de texto, que es exactamente lo que el tldr comando hace.

Instalar tldr en Ubuntu

los tldr El comando en Ubuntu no está disponible en ningún repositorio, por lo que hay un poco de una manera indirecta de instalarlo. Pero no es dificil.

Primero, necesitamos instalar NodeJS y el Administrador de paquetes de nodos (npm). prensa Ctrl + Alt + T para abrir el terminal y escriba el siguiente comando.

sudo apt install nodejs npm

A continuación, vamos a utilizar npm instalar tldr. Tipo:

sudo npm instalar -g tldr

Debería poder usar tldr ahora, pero puede ver un error que dice, “El fichero o directorio no existe” cuando intentas.

Puede corregir este error creando un enlace simbólico ¿Qué es un enlace simbólico y cuáles son sus usos? [MakeUseOf explica] ¿Qué es un enlace simbólico y cuáles son sus usos? [MakeUseOf explica] Leer más. Escribe el siguiente comando.

sudo ln -s / usr / bin / nodejs / usr / bin / node

Instala tldr en macOS

En macOS, usaremos Homebrew Cómo instalar aplicaciones Mac en la Terminal Usando Homebrew Cómo instalar aplicaciones Mac en la Terminal utilizando Homebrew ¿Sabías que puedes instalar el software Mac en la Terminal? Aquí se explica cómo usar Homebrew para instalar aplicaciones de Mac fácilmente. Lea más, el administrador de paquetes para macOS, para instalar tldr. Homebrew te permite instalar cualquier utilidad de línea de comandos con solo presionar algunas teclas. Agregar Cask a Homebrew te permite instalar aplicaciones de escritorio, como Firefox y GIMP. Actualizar las utilidades de línea de comandos y las aplicaciones de escritorio es fácil con Homebrew y Cask.

Homebrew no está instalado por defecto. Dirígete al sitio web de Homebrew y copia el comando de instalación desde allí. No lo incluimos aquí por si cambia..

Para instalar Homebrew, abre el Terminal desde el Utilidades carpeta en el Aplicaciones carpeta. Haga clic derecho en el indicador de línea de comando y seleccione Pegar para ingresar el comando de instalación de Homebrew que copió. prensa Entrar y siga las instrucciones como se presentan.

Una vez que Homebrew está instalado, escriba el siguiente comando para instalar el tldr mando.

brew install tldr

Ahora, puede usar el comando tldr para obtener explicaciones breves y concisas de los comandos.

Use tldr para saber rápidamente cómo usar un comando

Usaremos el comando ls para ilustrar la diferencia entre usar man y tldr. Las capturas de pantalla son de Linux, pero funcionan de la misma manera en macOS.

Escriba el siguiente comando en el indicador.

man ls

Verá una larga y detallada explicación del comando ls que continúa en las páginas. Use las teclas de flecha y las teclas Page Up y Page Down para navegar a través de la página del manual del comando ls.

Ahora, escriba el siguiente comando.

tldr ls

Verá una descripción mucho más breve de los usos más comunes del comando ls. Tenga en cuenta que no tiene que desplazarse por los resultados, al menos mucho. Hicimos nuestra ventana de Terminal un poco más alta para mostrar todos los resultados a la vez.

Usa la versión web de tldr

Si no desea instalar tldr, o si tiene problemas para hacerlo, hay una gran versión web de tldr utilidad en https://tldr.ostera.io/. Incluyen una breve explicación sobre cómo usar el sitio. Esto también es útil si ya está en un navegador y desea buscar rápidamente un comando sin abrir una ventana de Terminal.

Por ejemplo, escriba “ls” en el cuadro de búsqueda en la parte superior de la página. Los resultados se muestran inmediatamente. Puede encontrar esto incluso más fácil de leer que los resultados del comando tldr en la línea de comandos.

Incluso proporcionan una Editar esta página en Github enlace en la parte inferior de la página para cada comando en caso de que vea algún error.

También puede crear o editar comandos en el sitio web de páginas TLDR..

¿Necesita una copia fuera de línea? Descargue una versión en PDF de las páginas tldr, para su uso posterior. Incluso puedes instalar un tldr aplicación en su dispositivo Android [Ya no está disponible] o iOS.

Las páginas de manual siguen siendo útiles

los tldr El comando es útil para aprender lo básico sobre un comando. Pero hay parámetros de comando omitidos que pueden ser útiles. Entonces, si no ves lo que estás buscando en el tldr página para un comando, compruebe el hombre página, si el comando tiene uno.

Por ejemplo, el tldr página para el ls comando deja fuera los siguientes parámetros útiles. Los parámetros distinguen entre mayúsculas y minúsculas.

  • -R: Lista de subdirectorios recursivamente.
  • -X: Ordenar alfabéticamente por las extensiones de archivo.
  • -re: Listar solo los directorios, no sus contenidos..

Otro ejemplo es el rm comando, que elimina archivos y directorios. Con un determinado parámetro, se puede usar para borrar todo el contenido de un directorio específico. Tenga cuidado con este comando ya que puede terminar eliminando archivos críticos del sistema si se usa incorrectamente.

  • -YO: Preguntar una vez antes de eliminar más de tres archivos, o al eliminar archivos de forma recursiva. Este parámetro es menos intrusivo que -yo, sin dejar de protegerlo contra la eliminación accidental de archivos que no desea eliminar.
  • -re: Eliminar directorios vacíos.

Mientras que la tldr página para el rm comando hace una lista de -r parámetro para eliminar recursivamente un directorio y todos sus subdirectorios, no explica que rm no elimina directorios no vacíos por defecto. Debes usar -r o -R para eliminar recursivamente los directorios no vacíos.

Ahorre tiempo con el comando tldr

los tldr el comando llega al punto con explicaciones breves y ejemplos prácticos de los comandos del shell bash. Incluso puede encontrar explicaciones concisas para algunos comandos incorporados que ya no están disponibles como hombre entradas, como la discos compactos mando.

Puede encontrar todos los comandos incorporados disponibles en el shell bash escribiendo el siguiente comando en la línea de comandos.

man bash-builtins

También es posible que desee probar Fish Shell. 7 razones por las que debería instalar The Fish Shell. 7 razones por las que debería instalar The Fish Shell. ¿No le gusta cómo funciona su terminal Linux? ¿Por qué no instalar un nuevo shell? Una de estas conchas es el pez, que introduce características que deberían haberse convertido en algo común, pero no lo hizo. Vamos a ver. Leer más, que tiene características adicionales como sugerencias automáticas, colores VGA y un lenguaje de scripting inspirado en lenguajes de programación modernos como Python y Ruby.

¿Encuentras las explicaciones en tldr más fáciles de entender? ¿O prefiere las explicaciones completas y detalladas en las páginas del manual? Comparte tus pensamientos y experiencias con nosotros en los comentarios a continuación..

Explorar más sobre: ​​Linux, Linux Bash Shell.