tealdeer, es una implementación de tldr en Rust. tldr es una herramienta que proporciona resúmenes cortos y concisos de los comandos de Unix y sus usos. Tealdeer es una versión mejorada y más rápida de tldr que se ejecuta en Rust.

tealdeer, ayuda a los comandos Linux modo resumen

Algunas de las características de Tealdeer incluyen una biblioteca de resúmenes más grande, una experiencia de usuario más rápida y una línea de comandos más intuitiva. Tealdeer también ofrece la opción de descargar resúmenes adicionales para que puedas acceder a ellos sin conexión a Internet.

tldr frente a man

tldr y man son dos herramientas diferentes que tienen diferentes objetivos y enfoques. Ambas son útiles y se complementan entre sí.

Las ventajas de tldr frente a man incluyen:

• Resúmenes cortos y concisos: tldr proporciona resúmenes concisos y fáciles de leer de los comandos de Unix y sus usos, lo que significa que puedes obtener una idea rápida de cómo utilizar un comando sin tener que leer una documentación completa.
• Interfaz intuitiva: tldr utiliza una interfaz de línea de comandos sencilla y fácil de usar, lo que significa que puedes obtener información sobre un comando con pocos clics y sin tener que navegar por diferentes menús.
• Resúmenes más fáciles de entender: tldr utiliza un lenguaje simple y fácil de entender para proporcionar sus resúmenes, lo que significa que puedes aprender a utilizar un comando más rápidamente.

Sin embargo, también es importante mencionar las ventajas de man frente a tldr. Por ejemplo, man proporciona información completa y detallada sobre los comandos de Unix y sus usos, lo que significa que puedes aprender a utilizar un comando en profundidad. Además, man es una herramienta estándar de Unix y está disponible en la mayoría de los sistemas Unix, lo que significa que puedes acceder a la documentación en cualquier sistema que utilices.

En general, tldr es una herramienta útil para obtener una idea rápida de cómo utilizar un comando, mientras que man es una herramienta esencial para aprender a utilizar un comando en profundidad.

Para que te hagas una idea del uso de tldr, te muestro la información que muestra para tar,

  $ tldr tar

  Herramienta para archivos.
  A veces combinada con un método de compresión, como gzip o bzip2.
  Más información: <https://www.gnu.org/software/tar>.

  Crear un archivo a partir de otros archivos:

      tar cf archivo_destino.tar archivo1 archivo2 archivo3

  Crear un archivo comprimido con gzip:

      tar czf archivo_destino.tar.gz archivo1 archivo2 archivo3

  Extraer un archivo (comprimido) en el directorio actual:

      tar xf archivo.tar[.gz|.bz2|.xz]

  Extraer un archivo en un directorio:

      tar xf archivo.tar -C directorio

  Crear un archivo comprimido usando el sufijo para determinar el programa de compresión:

      tar caf archivo_destino.tar.xz archivo1 archivo2 archivo3

  Mostrar el contenido de un archivo tar:

      tar tvf archivo.tar

  Extraer archivos que coinciden con un patrón:

      tar xf archivo.tar --wildcards "*.html"

¿Con que objetivo fue implementado tealdeer?

Los objetivos de Tealdeer son:

• Mejorar la experiencia de usuario: Tealdeer busca mejorar la experiencia de usuario proporcionando una interfaz de línea de comandos intuitiva y rápida para acceder a la información sobre los comandos de Unix.
• Ofrecer una biblioteca de resúmenes más grande: Tealdeer busca ofrecer una biblioteca de resúmenes más grande que la de tldr para proporcionar más información sobre los comandos de Unix.
• Proporcionar resúmenes más precisos: Tealdeer busca proporcionar resúmenes más precisos y actualizados de los comandos de Unix y sus usos.
• Ofrecer la opción de descargar resúmenes adicionales: Tealdeer busca ofrecer la opción de descargar resúmenes adicionales para que los usuarios puedan acceder a ellos sin conexión a Internet.
• Mejorar la velocidad: Tealdeer busca ser más rápido que tldr en la generación y búsqueda de resúmenes.

En general, Tealdeer busca mejorar la experiencia de los usuarios de tldr proporcionando una herramienta más completa, más rápida y más precisa para acceder a la información sobre los comandos de Unix.

¿como instalar tealdeer en Ubuntu?

Para instalar tealdeer en Ubuntu, tienes que utilizar la herramienta cargo. Para instalar cargo, simplemente ejecuta las siguientes instrucciones,

sudo apt update
sudo apt install rustc cargo

Una vez instalado cargo, simplemente tienes que ejecutar la siguiente instrucción,

cargo install tealdeer

¿como instalar tealdeer en Manjaro?

Instalar tealdeer en Manjaro es tan sencillo como utilizando tu herramienta preferida de gestión de los repositorios AUR, en mi caso es yay o paru, simplemente ejecutar,

paru -S tealdeer

Autocompletado

tldr viene con función de autocompletado. Dependiendo de como hayas instalado esta herramienta se habrá copiado la configuración de autocompletado para que la puedas utilizar.

Configuración

Para conocer donde está o donde poner la configuración de tealdeer, ejecuta el comando,

tldr --show-paths

Y si quieres generar de forma automática una configuración predefinida, sejecuta,

tldr --seed-config

O también puedes utilizar una configuración como la que te muestro a continuación,

[display]
compact = false
use_pager = true

[style.command_name]
foreground = "red"

[style.example_text]
foreground = "green"

[style.example_code]
foreground = "blue"

[style.example_variable]
foreground = "blue"
underline = true

[updates]
auto_update = true

Uso y funcionamiento

Para mostrarte el uso y funcionamiento de esta herramienta, que mejor que la propia herramienta,

  Display simple help pages for command-line tools from the tldr-pages project.
  More information: <https://tldr.sh>.

  Print the tldr page for a specific command (hint: this is how you got here!):

      tldr command

  Print the tldr page for a specific subcommand:

      tldr command-subcommand

  Print the tldr page for a command for a specific [p]latform:

      tldr -p android|linux|osx|sunos|windows command

  [u]pdate the local cache of tldr pages:

      tldr -u

Recuerda actualizar la herramienta de vez en cuando para tener la información mas actualizada de cada comando que ejecutas.

El vídeo

Lo mismo que te he contado hasta el momento, pero en un vídeo,

---

Más información,

• GitHub