Qué es y cómo se usa la herramienta de terminal TLDR

TLDR es una herramienta de línea de comandos que proporciona resúmenes de los comandos más comunes. Su nombre viene de la abreviatura «Too Long; Didn’t Read» («Demasiado largo; no lo leí»). Es útil para obtener ejemplos rápidos y sencillos de cómo usar un comando sin necesidad de leer toda la documentación oficial o las páginas de manual (man). En otras palabras, una joya para recien llegados al sistema del pingüino.

Cómo instalar TLDR

La instalación varía según el sistema operativo, como ejemplo utilizaremos Arch Linux:

En Arch y derivadas

sudo pacman -S tldr

Cómo usar TLDR

Una vez instalado, simplemente ejecuta:

tldr <comando>

Por ejemplo, si quieres ver ejemplos de uso para tar:

tldr tar

Esto mostrará un resumen con ejemplos prácticos de cómo usar tar.

Otras opciones:

1. Obtener ejemplos de un comando específico

tldr find

🔹 Esto mostrará ejemplos de uso rápido del comando find, útil para buscar archivos en el sistema.

2. Forzar actualización del caché de TLDR

tldr --update

🔹 Descarga la última versión de las páginas de TLDR, asegurando que tienes la documentación más reciente.

3. Mostrar un comando aleatorio

tldr --random

🔹 Si quieres aprender un comando nuevo cada vez que ejecutas este comando.

4. Mostrar páginas en formato detallado (Markdown)

tldr --markdown ls

🔹 Devuelve la salida en formato Markdown, útil si quieres copiarla a un documento o una guía personalizada.

5. Mostrar la página de TLDR en un idioma específico

tldr --language es grep

🔹 Muestra la documentación en español (si está disponible).

Si TLDR no está configurado para un idioma específico, puedes establecerlo con:

export TLDR_LANGUAGE=es

6. Listar comandos populares

tldr --list

🔹 Muestra una lista de todos los comandos disponibles en la base de datos de TLDR.

7. Ver la página de ayuda de TLDR

tldr --help

🔹 Muestra todas las opciones disponibles en TLDR.

8. Usar TLDR con colores desactivados (para terminales que no los soportan)

tldr --no-color curl

🔹 Muestra la salida sin colores, útil en terminales con soporte de color limitado.

9. Mostrar la página de un comando específico en formato JSON

tldr --json mkdir

🔹 Devuelve la información en formato JSON, útil para scripts automatizados.

10. Usar una implementación alternativa de TLDR

Si tldr no está disponible en tu sistema o prefieres otra versión, puedes usar:

  • tealdeer (una alternativa rápida escrita en Rust)cargo install tealdeer tldr --update
  • tldr++ (implementación con búsqueda avanzada)tldr++ ls

Ejemplo de salida de TLDR

Si ejecutas tldr ls, podrías obtener algo así:

ls

- Lista un archivo por línea:
ls -1

- Lista todos los archivos, incluyendo archivos ocultos:
ls -a

- Lista todos los archivos, añadiendo `/` al final de los nombres de directorios:
ls -F

- Lista todos los archivos en formato largo (permisos, propietarios, tamaño y fecha de última modificación):
ls -la

- Lista en formato largo y tamaño legible por humanos (i.e., KiB, MiB, GiB, etc.):
ls -lh

- Lista recursivamente en formato largo y ordena los tamaños de mayor a menor:
ls -lSR

- Lista todos los archivos en formato largo y ordenados por fecha de modificación (archivos más viejos en primer lugar):
ls -ltr

- Lista solamente directorios:
ls -d */

Conclusión:

TLDR es una alternativa a man cuando solo quieres ejemplos rápidos en lugar de documentación extensa. Una excelente alternativa para que los recien llegados al sistema del pingüino pierdan el miedo y animarles al uso de la terminal.

Esto es todo compañeros, espero que les sea útil. Y no se olviden de apoyarnos con un «Me gusta» y con «Tu voto» para calificar el contenido. 


Descubre más desde Tecno y Soft

Suscríbete y recibe las últimas entradas en tu correo electrónico.